CLI 参数与默认值
由 scripts/dev/sync_docs.py 从 Click 注册表生成。命令用途、副作用与操作场景分别见 CLI 参考 和 副作用清单。
cne audit
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--run-id |
— |
运行 ID;可重复指定,合并运行证据并审计一次。 |
--full |
False |
整个湖的健康快照(当前状态 + 新鲜度),而不是某一次 run 的文件。 |
--research-start |
— |
严格校验从这一天开始的研究窗口(需要 --full)。 |
--quality-only |
False |
配合 --full:只按质量 error 判门禁;调度新鲜度请另外用 status 检查。 |
--research-end |
— |
研究窗口终点(默认取最新的 daily_bars;需要 --research-start)。 |
--universe-profile |
— |
--full 检查哪个 universe profile 的历史有效性(见 cne profile list);默认 legacy_all_a。 |
--research-universe |
— |
— |
cne backfill
| 参数 |
默认值 |
说明 |
dataset |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--profile |
default |
daily_bars 可选 delisted:只回填已确认退市名录,沿用独立发现证据。 |
--plan |
False |
只输出来源、范围和抓取方式;衍生品另给请求预算。不取数、不写湖。 |
--exchange |
— |
仅衍生品:限定交易所,可重复。INE 归入 SHF 路由;2018 期货另取 INE 日文件。 |
--source |
— |
本次回填改用的来源,不修改配置。支持 margin_trading(exchange 或 eastmoney)、financial_statement_items(tdx_fin:只补湖中缺少的科目)和 option_bars(tushare:沪深 ETF 期权)。 |
--refetch |
False |
忽略完成收据和 checkpoint,重新获取整个范围(sector_bars、futures_bars、option_bars、fund_flow、financial_statement_items、share_structure、shareholder_counts、top_holders);熔断仍然生效。不加时回填从断点续跑。 |
--start |
— |
回填区间起点(YYYY-MM-DD),包括 daily_bars、minute_bars、衍生品日线、日期/报告期推进及 sector_bars。sector_bars 默认往前 400 天;超过来源历史深度的范围保留为缺口,可取范围照常交付并提供补数指引。 |
--end |
— |
回填区间终点(YYYY-MM-DD,默认今天),与 --start 配合限定历史窗口。 |
--outstanding |
False |
只修复被容忍缺口欠下的那些 key,范围和窗口都取自欠账台账,不看 --symbols/--start/--end。补上的 key 会销账,仍然缺的继续欠着。 |
--symbols |
— |
限定范围的标的列表,逗号分隔:用于 intraday、trading_status、corporate_actions 的限定回填,以及 financial_statement_items、daily_bars、share_structure 的限定修复。trading_status 的 checkpoint 与覆盖证据会记下确切范围;daily_bars 会把这个显式范围写进 backfill 元数据。 |
--workers |
1 |
仅 margin_trading 的日期推进并发数。每个请求仍然走配置里共享的源限流器;其它数据集必须为 1。 |
cne check
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--full |
False |
立即重跑全湖审计(读每个历史分区,大湖可能要数小时);默认读最近一次的审计结果。 |
--pack |
— |
按研究包给出窗口、缺口和下一步。可重复。指定后,缺数据或历史 ST 未覆盖会使退出码变差。 |
cne config create
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--force |
False |
覆盖已有的配置文件。 |
--data-root |
— |
设置 [data].root(默认 ./data/cnequity,解析为绝对路径)。 |
cne config diff
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne config path
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne config show
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--defaults |
False |
列出每一项设置及其内置默认值和说明。 |
cne config upgrade
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dry-run |
False |
只列出要加的步骤和调度组,不写任何文件。 |
--minimize |
False |
把完整配置改写为继承内置默认值,只保留不同的设置;列出行为会改变的每一项设置。 |
cne config validate
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne contract diff
| 参数 |
默认值 |
说明 |
old_contract |
— |
位置参数 |
new_contract |
— |
位置参数 |
--old |
— |
基线契约文件路径。 |
--new |
— |
候选契约文件路径。 |
--from |
— |
--old 的别名。 |
--to |
— |
--new 的别名。 |
--json |
False |
输出机器可读的 JSON。 |
--allow-breaking |
False |
即使发现破坏性变更也返回退出码 0。 |
cne contract show
| 参数 |
默认值 |
说明 |
dataset |
— |
位置参数 |
--dataset |
— |
数据集名(也可以直接作为参数传)。不给则输出完整契约。 |
--out, --output, --path |
- |
把 JSON 写到这个路径而不是标准输出;'-' 表示打印。 |
--json |
False |
输出机器可读的 JSON(默认)。 |
cne contract validate
| 参数 |
默认值 |
说明 |
contract_path |
— |
位置参数 |
--path |
— |
契约 JSON 路径(也可以直接作为参数传)。 |
--json |
False |
输出机器可读的 JSON。 |
--against-registry |
False |
要求文件里的契约与当前的 DATASETS / SCHEMAS / PRIMARY_KEYS 完全一致。 |
cne decision-data cash-rights
| 参数 |
默认值 |
说明 |
--start |
2016-01-01 |
— |
--end |
— |
默认今天;配置了 [research] holdout_start 时默认其前一天。 |
--output-dir |
— |
— |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne decision-data payment-gaps
| 参数 |
默认值 |
说明 |
--start |
2016-01-01 |
— |
--end |
— |
默认今天;配置了 [research] holdout_start 时默认其前一天。 |
--output-dir |
— |
— |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne decision-data stock-terms
| 参数 |
默认值 |
说明 |
--start |
2016-01-01 |
— |
--end |
— |
默认今天;配置了 [research] holdout_start 时默认其前一天。 |
--output-dir |
— |
— |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne delisted status
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--since |
2016-01-01 |
湖窗口起点。 |
--sample |
15 |
打印多少行明细。 |
cne derive
| 参数 |
默认值 |
说明 |
name |
adj_factors |
位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--full |
False |
重写 adj_factors / industry_index / option_greeks / minute_bars_15m|30m|60m 的全部分区(默认只补增量)。 |
--start |
— |
industry_index / trading_status / option_greeks / minute_bars_15m|30m|60m:只派生这个日期(YYYY-MM-DD)及之后的。 |
--end |
— |
industry_index / trading_status / option_greeks / minute_bars_15m|30m|60m:只派生这个日期(YYYY-MM-DD)及之前的。 |
--apply |
False |
adj_factor_source:写入逐证券来源覆盖并重算这些证券的因子(默认只报告)。 |
cne doctor
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--json |
False |
输出机器可读的 JSON。 |
cne import shfe-archive
| 参数 |
默认值 |
说明 |
archive |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dataset |
— |
必填;年度包包含哪类日线。 |
--year |
— |
必填;它覆盖的交易年份。 |
--accept-partial-fields |
False |
接受年度包缺少只有日文件才有的字段;已有的完整日线不会被覆盖。必填。 |
--url |
— |
可选:它在上期所网站的原始 HTTPS 地址。 |
--downloaded-at |
— |
可选:下载时间,带时区的 ISO 8601。 |
--start |
— |
在 --year 之内:导入的第一天。 |
--end |
— |
在 --year 之内:导入的最后一天。 |
--apply |
False |
运行;不加只打印计划。 |
cne init
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--profile |
quick |
建多大。demo = 用真实数据源抓几只票,sample = 同样的形状但离线且确定 —— 两者都不是一个市场。quick = 全市场标的、最近 3 年;full = 全市场标的、从 2016-01-01 起(通常需要更多分页)。以后可以用 cne backfill daily_bars 补深。 |
--symbols |
600519.SH,000001.SZ,000858.SZ,300750.SZ,601318.SH |
demo/sample:要抓的标的,逗号分隔(有意保持很少)。 |
--days |
30 |
demo/sample:daily_bars 大致抓最近多少个交易日。 |
--data-root |
data/cnequity-demo; sample: data/cnequity-sample |
demo/sample:独立的湖根目录(不要拿去跑全市场 init)。 |
--config-out |
configs/cnequity.demo.toml; sample: configs/cnequity.sample.toml |
demo/sample:把那份小配置写到哪,供后续 cne query 使用。 |
--force |
False |
demo/sample:允许覆盖内容不同的已有 --config-out;默认拒绝并保留原文件。 |
--intraday |
False |
demo/sample:同一批标的额外抓 1 分钟线(最多 5 个交易日)并打印一个交易日,让 bar_time 的口径看得见。 |
--research |
False |
demo/sample:额外用 Sina 派生 hfq 复权因子,并打印未复权 / 复权收益对照(较慢;需要访问 Sina)。 |
--layout-only |
False |
只建目录、manifest 和 DuckDB 视图,跳过 init 各阶段。 |
--trade-date |
— |
init 各阶段的 as-of 交易日(YYYY-MM-DD);默认今天。 |
--resume |
False |
续跑最近一次没跑完的 init run(重试失败批次 + 补缺失阶段)。 |
--run-id |
— |
续跑指定的 init run_id(隐含 --resume)。 |
--keep-going |
False |
某个阶段失败后继续往下跑,而不是停下来。 |
--since |
— |
显式指定历史起点(YYYY-MM-DD);覆盖 --profile。 |
--quiet |
False |
只留 warning 及以上,不打逐批进度。 |
--pack |
— |
研究包:market 行情、fundamentals 基本面、universe 历史 ST。不改变这次初始化下载的内容。决定结束后要保持更新的调度组,以及 cne check --pack 的结论。可重复。不写则沿用已保存的选择,第一次是 market。 |
--schedule |
False |
初始化成功结束后,为所选研究包安装定时日更和收尾补抓。不含公告和资讯。 |
--json |
False |
结束时输出完整的机器可读结果,而不是摘要;完整结果也总会存到日志目录。 |
--no-preflight |
False |
跳过开跑前最多 8 秒的网络预检(通达信、交易所、东财)。也可设环境变量 CNE_SKIP_PREFLIGHT=1。 |
cne mcp
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--live |
False |
湖里没有的数据就按需向源头取,并且不落盘。只支持标的查找和未复权日线;其它工具宁可拒绝,也不会在没有复权、universe 和 PIT 的情况下作答。 |
--http |
False |
改用 Streamable HTTP,在 /mcp 上监听。给只接远程 URL 的客户端(如 ChatGPT)配合隧道使用。 |
--host |
127.0.0.1 |
--http 的监听地址。非回环地址必须配 --token。 |
--port |
8788 |
--http 的端口。 |
--token |
— |
--http:每个请求都要带这个令牌(Bearer 头、/mcp/<令牌> 路径或 ?token=)。经隧道公开时必须设置。 |
cne migrate
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
运行欠下的迁移,并把每个结果记入 meta/state/lake.json。 |
--only |
— |
逗号分隔的迁移 id;即使已记录也重新运行。默认:这个湖还欠的全部迁移。 |
--json |
False |
输出机器可读的 JSON。 |
cne profile list
| 参数 |
默认值 |
说明 |
--include-compatibility, --official-only |
True |
列表里包含历史遗留的 universe 别名。 |
cne profile show
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--symbol |
— |
把 profile 绑定到具体标的,并附带 concrete_scope_hash。 |
cne query
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--sql |
SELECT COUNT(*) AS n FROM daily_bars |
只读 DuckDB SQL;每个数据集是一个视图,名称同 cne status --datasets。 |
--dataset |
— |
按需抓取的数据集名 |
--symbol |
— |
按需抓取的标的代码 |
--refresh |
False |
抓取前先刷新按需缓存(需要同时给 --dataset 和 --symbol)。 |
cne repair adj-factors
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
应用可确定的因子修正并保留旧版本;未解决项只作提示。 |
--refresh-sources |
False |
联网补取独立因子证据;默认仅使用本地缓存。 |
--symbols |
— |
逗号分隔的证券代码;默认分批检查历史问题。 |
--start |
— |
待修事件起点(YYYY-MM-DD);累计影响延续到其后。 |
--end |
— |
待修事件终点(YYYY-MM-DD);累计影响延续到其后。 |
--max-symbols |
100 |
每批最多检查的证券数;应用后保存历史进度。 |
--plan |
— |
应用指定预览的计划标识;输入变化时要求重新预览。 |
cne repair bar-amounts
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
— |
必填;窗口起点(YYYY-MM-DD)。 |
--end |
— |
必填;窗口终点(YYYY-MM-DD)。 |
--symbols |
— |
逗号分隔的证券代码。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair bar-turnover
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
— |
必填;窗口起点(YYYY-MM-DD)。 |
--end |
— |
必填;窗口终点(YYYY-MM-DD)。 |
--symbols |
— |
逗号分隔的证券代码。 |
--peer-review |
False |
用交易所历史价格、通达信和东财复查价格冲突;只有证据一致时才整行替换。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair bse-tip-turnover
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--symbols |
— |
必填;逗号分隔的证券代码。 |
--date |
— |
必填;交易日(YYYY-MM-DD)。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair corporate-action-gaps
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
向 Baostock 补取并发布新版本;默认只离线输出计划。 |
cne repair delisted-actions
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--source |
— |
必填;baostock 用于已退市的沪深证券;ths 用于已退市的北交所证券。 |
--symbols |
— |
逗号分隔的证券代码。 |
--start |
— |
窗口起点(YYYY-MM-DD)。 |
--end |
— |
窗口终点(YYYY-MM-DD)。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair ex-dates
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--ex-dates |
— |
必填;逗号分隔的除权日,YYYY-MM-DD。 |
--symbols |
— |
逗号分隔的证券代码。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair financial-originals
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--symbols |
— |
股票代码,逗号分隔。 |
--all-stocks |
False |
使用湖中股票目录;与 --symbols 二选一。 |
--after |
— |
接续上一批 next_cursor(YEAR:SYMBOL);失败项可不带游标重试。 |
--quarter |
Q4 |
报告期;Q2 为半年报,Q4 为年报,利润和现金流只恢复年初至期末累计数。 |
--start-year |
2016 |
— |
--end-year |
2024 |
— |
--max-reports |
16 |
— |
--reparse |
False |
重新解析已有原文报告;内容未变的行保留原始观测时间。 |
--refresh-sources |
False |
从巨潮取完整公告查询和原始定期报告;默认回放已归档来源。 |
--apply |
False |
追加可核实的原文当期数,保留既有版本及真实采集时间。 |
cne repair fund-no-print
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
保存基金竞价日线覆盖证据并结清对应欠账;不生成日线或停牌行。 |
--refresh-sources |
False |
向沪深交易所取历史基金报表;默认离线回放已留存报表。 |
--max-sessions |
32 |
每批最多核对的欠账交易日。 |
cne repair fund-volume
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
核验后替换整行并发布新版本,保留旧版。 |
--refresh-sources |
False |
归档官方历史 K 线及必要的独立金额证据;默认离线回放。 |
--max-symbols |
16 |
— |
cne repair index-history
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--index-symbol |
399001.SZ |
选择已核验的历史成分目录。 |
--apply |
False |
替换已核验区间的完整成分历史,保留官方带日期权重及旧版本。 |
--refresh-sources |
False |
补采目录中未归档的官方历史附件;默认离线回放。 |
cne repair index-snapshots
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--indices |
— |
指数代码,逗号分隔;默认沪深300、科创50、深证成指、创业板指。 |
--apply |
False |
按文件实际日期替换完整指数快照,保留旧版本。 |
--refresh-sources |
False |
取官方成分和权重文件;默认离线回放。 |
cne repair layout
| 参数 |
默认值 |
说明 |
dataset |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
写入并发布新版本;默认只输出计划。 |
cne repair payment-dates
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--symbols |
— |
必填;逗号分隔的证券代码。 |
--start |
— |
必填;窗口起点(YYYY-MM-DD)。 |
--end |
— |
必填;窗口终点(YYYY-MM-DD)。 |
--issuer-notices-only |
False |
只用发行人实施公告(已审清单、巨潮、北交所);匹配不到的事件保留为缺口,不请求 Baostock。 |
--apply |
False |
运行;不加只打印计划。 |
cne repair repartition
| 参数 |
默认值 |
说明 |
dataset |
— |
位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--all |
False |
所有布局需要改写的数据集。 |
--apply |
False |
改写并换上分区;默认只预览。 |
cne repair status-traded
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
— |
必填;成交状态补缺起点(YYYY-MM-DD)。 |
--end |
— |
必填;成交状态补缺终点(YYYY-MM-DD)。 |
--apply |
False |
核验后发布新版本;默认只输出计划。 |
cne repair stock-listing-dates
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
发布官方 IPO 日历证实的股票上市日期;保留旧版本。 |
--refresh-sources |
False |
联网取巨潮 IPO 日历;默认回放已归档来源。 |
--max-sessions |
32 |
— |
--event-date |
— |
额外回放指定日的官方上市事件,可重复;不要求证券已有日线。 |
cne repair valuation-outage
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
— |
必填;窗口起点(YYYY-MM-DD)。 |
--end |
— |
必填;窗口终点(YYYY-MM-DD)。 |
--apply |
False |
运行;不加只打印计划。 |
cne run clean
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dry-run |
False |
只打印预览,不询问是否删除。 |
--orphan-retention-days |
7 |
预览超过这个天数的孤儿 staging,并列出同样超龄的运行锁文件供确认删除。 |
--snapshot-retention-days |
14 |
列出超过这个天数的 meta/source_snapshots run_id 目录供确认删除(每个数据集 / 来源最新的一份始终保留)。 |
--force |
False |
把未完成或未合并的 staging 也列入预览;它们不会被询问删除。 |
--keep-revision-generations |
5 |
确认删除时,每个数据集保留最近这么多代,并保留当前版本和 hold。0 表示不处理版本。 |
--log-retention-days |
30 |
列出超过这个天数的 logs/cne-*.log 供确认删除;0 跳过。 |
--reconcile-runs |
False |
清理前,把卡在 'running'(worker 崩溃)的 run 标成 failed。 |
--reconcile-after-seconds |
— |
只对静默超过这么多秒的 run 做上面的对账(默认取 [orchestrator].batch_stale_seconds)。 |
cne run compact
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--run-id |
— |
只发布这一次 run;默认处理所有待发布的 run。 |
cne run daily
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--groups |
— |
把 --stale-only 限定在这些 daily 调度组内(逗号或空格分隔)。 |
--group |
— |
调度组:core、capital、signals、fundamentals、macro_risk、research、intraday、ticks |
--all-groups |
False |
只跑全部调度组,不含事件流。给已经单独调度 cne run events 的旧定时任务保留;不带参数的 cne run daily 已经包含全部调度组和事件流。 |
--core-only |
False |
只跑 [[job.daily.waves]] 核心骨架(旧版不带参数时的行为)。 |
--no-events |
False |
不带参数运行时不跑事件流(公告、监管事件、资讯)。 |
--trade-date |
— |
as-of 交易日 YYYY-MM-DD(默认今天)。周末 / 节假日补跑时用。 |
--backfill |
False |
用 backfill 语义跑:跳过交易日门禁和每个 step 自己的增量窗口,改为抓配置里 backfill scope 指定的窗口。用于补跑调度漏掉的某一天;日常调度从不带这个参数。 |
--repair-gaps |
False |
在 daily / stale 跑之前,先修复已验证、且有诚实来源的历史缺口。 |
--quiet |
False |
只留 warning 及以上,不打逐步进度。 |
--stale-only |
False |
只重抓仍然落后于最后交易日的数据集。挂在主 pipeline 几小时之后跑:snapshot 类数据集一旦因源端中断丢掉当天窗口,第二天就补不回来了。 |
--snapshots-only |
False |
配合 --stale-only:只重抓 snapshot 类数据集;历史类留给下一次日更按日期补。 |
--pack |
— |
只跑这些研究包对应的日更调度组,不跑事件流。不写则仍跑全部调度组和事件流。可重复。 |
cne run events
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--group |
— |
[job.events.groups] 里的某一个组(默认按顺序跑全部)。 |
--trade-date |
— |
as-of 自然日 YYYY-MM-DD(默认今天),含周末与节假日。 |
--quiet |
False |
只留 warning 及以上,不打逐步进度。 |
cne run maintain
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--groups |
— |
新鲜度门禁判失败的调度组(空格或逗号分隔)。默认:定时日更实际运行的组。 |
--notify |
False |
有问题时同时弹出桌面通知(macOS)。 |
cne run retry
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--run-id |
— |
重试指定的一次 run。 |
--failed-groups |
False |
重试每个 daily 调度组最近一次失败的 run。 |
cne schedule install
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--pack |
— |
只更新这些研究包的调度组,不含事件流。可重复。默认保留当前选择(首次安装为全部调度组)。 |
--no-stale |
False |
不在 [job.stale].run_at 之后重试缺失的快照。 |
--events-group |
— |
另按自己的间隔运行这个事件流组(公告、资讯)。 |
--events-every |
60 |
配合 --events-group:两次运行之间的分钟数。 |
--events, --no-events |
— |
运行配置里的 [[job.events.schedules]](或关闭)。默认保留现有设置;配置定义了计划且尚无设置时开启。 |
--yes, -y |
False |
不询问确认直接安装。 |
cne schedule remove
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--yes, -y |
False |
不询问确认直接移除。 |
cne schedule status
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--json |
False |
输出机器可读的 JSON。 |
cne serve
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--host |
127.0.0.1 |
回环地址会同时监听 127.0.0.1 和 localhost。非回环地址必须配 --token。 |
--port |
8787 |
— |
--token |
— |
要求这个 bearer token(或 ?token=)。--host 不是回环地址时必须设置。 |
--read-only |
False |
只浏览。不注册操作页和存储清理的写入口。 |
--allow-remote-ops |
False |
非回环地址上也可以从面板发起取数。默认远程只能浏览和做存储清理;令牌在网址里,局域网又是明文。 |
cne snapshot create
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--research |
False |
包含价格、因子、身份、状态、日历及研究覆盖证据;缺少依赖时报错。 |
--dataset |
— |
必填;要包含的数据集(可重复)。快照永远是显式指定的,不会是整个湖。 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot delete
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
--yes |
False |
不询问确认,直接删除。 |
cne snapshot delta apply
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
target |
— |
必填;位置参数 |
--dry-run |
False |
只校验前置条件,不改动 TARGET。 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
增量包放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot delta create
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--from |
— |
基线湖根目录。目标根目录会与它逐字节比对。 |
--to |
— |
目标湖根目录;默认取配置里当前生效的根目录。 |
--from-revision |
— |
用目标里已提交的 revision 作为基线前置条件。 |
--dataset |
— |
要包含的数据集(可重复)。不给则自动发现两个根目录里都有的数据集。 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
增量包放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot delta verify
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
增量包放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot export
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
destination |
— |
位置参数 |
--compression |
auto |
归档编码;auto 优先 tar.zst,不行则退回 tar.gz。 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot import
| 参数 |
默认值 |
说明 |
archive |
— |
必填;位置参数 |
--name |
— |
导入后的快照名;默认取归档文件名。 |
--overwrite |
False |
仅在归档校验通过之后,才替换已存在的同名快照。 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot restore
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
target |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
cne snapshot verify
| 参数 |
默认值 |
说明 |
name |
— |
必填;位置参数 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--snapshot-root |
— |
快照放在哪;默认是数据根目录下的 meta/snapshots。 |
cne sources limits
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne sources policy
| 参数 |
默认值 |
说明 |
source |
— |
位置参数 |
--profile |
— |
— |
--redistribution |
False |
— |
cne sources probe
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--vantage |
CNE_SOURCE_VANTAGE, else [source_health].vantage, else local |
这次探测是从哪儿跑的 —— 'cn'、'overseas',或你自己用的任何标签。有几个源拒绝非大陆出口,所以没有这个标签的结果没法解读。 |
--only |
— |
要探测的 key,逗号分隔;高成本/已受挑战的端点仅在显式列出时探测。 |
--stale-only |
False |
复用 12 小时内已校验的采集证据,只主动探测缺少新证据的端点。 |
--list |
False |
离线列出探测源名称,不需要配置。 |
--out |
— |
JSON 报告写到哪。默认写到湖内的 meta/source_health/.json,cne serve 也从那里读。 |
cne sources resilience
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--out |
— |
— |
--enforce |
False |
核心数据集没有独立备份时退出 1。 |
--with-availability |
False |
把实测的探测可用率接到每个故障域上(会读湖)。 |
--window-days |
30 |
— |
cne sources slo
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--window-days |
30 |
— |
--minimum-observations |
10 |
— |
--enforce |
False |
关键源的 SLO 未达标时退出 1。 |
cne sources substitutes
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--vantage |
CNE_SOURCE_VANTAGE, else [source_health].vantage, else local |
读哪个出口位置(vantage)的报告。 |
--probe, --no-probe |
False |
现在实测,而不是读已存的报告。请求和 sources probe 相同。 |
--json |
False |
输出机器可读的 JSON。 |
cne stats rebuild
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dataset |
— |
只重算这些数据集(可重复)。其它数据集的行保持不变。 |
--if-stale |
False |
除非统计建好之后又跑过采集,否则什么都不做。可以安全地挂定时器。 |
--json |
False |
以 JSON 打印结果。 |
cne stats show
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dataset |
— |
某一个数据集的逐分区明细。 |
--by-source |
False |
改为按 source / data_version 分组。 |
--json |
False |
输出机器可读的 JSON。 |
cne status
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--run |
— |
要看的 run id,或 'latest'(默认)。包含各数据集 stage 的结果。 |
--datasets |
False |
逐数据集的新鲜度:覆盖区间、水位,以及相对最后交易日是否陈旧。 |
--all-columns |
False |
配合 --datasets:打印数据集清单的全部列,而不只是新鲜度。 |
--hide-empty |
False |
配合 --datasets:只列有数据或已陈旧的数据集,还没有数据的折成一行。 |
--groups |
— |
配合 --datasets:只对这些调度组拥有的数据集判失败(空格或逗号分隔)。其它组的数据集照常列出、照常报为调度缺口,但不会让门禁失败。截面检查同样受它约束——daily_bars 归哪个组,它的覆盖率就归谁判。未跑完的 init 不属于任何调度组,始终判失败。 |
--scope, --no-scope |
True |
配合 --datasets:是否做最新交易日的标的截面校验。它要读 daily_bars 的 tip 分区、instruments 和 trading_status,比单纯看水位贵;--no-scope 让这条命令回到纯元数据。 |
--gate |
False |
按所选范围和新鲜度执行门禁;默认只报告。 |
--core-only |
False |
配合 --datasets --gate:只有核心档数据集会让门槛失败,其余照常列出。cne check 使用此项。 |
--json |
False |
与 --datasets 一起用:把表格以 JSON 输出到 stdout(freshness 为小写);之后的检查信息输出到 stderr。退出码不变。 |
cne storage apply
cne storage catalog-retention
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--apply |
False |
让湖目录过期旧快照,并删除超过宽限期的文件;不加时只报告。 |
cne storage explain
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
object_id |
— |
必填;位置参数 |
cne storage hold
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
object_id |
— |
必填;位置参数 |
--reason |
— |
必填 |
cne storage import
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--manifest |
— |
必填 |
cne storage inspect
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--keep |
— |
每个数据集保留的代数;默认取 [storage.retention].keep_generations。 |
cne storage merge-files
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
datasets |
— |
位置参数 |
--min-files |
— |
合并文件数不少于这个值的分区(默认 4)。 |
--apply |
False |
发布合并结果;不加这个参数时只报告会合并哪些分区。 |
cne storage plan
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--keep |
— |
每个数据集保留的代数;默认取 [storage.retention].keep_generations。 |
--phase |
— |
— |
cne storage raw-external
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dataset |
— |
必填 |
--source |
— |
必填 |
--root |
— |
必填 |
--format |
pdf |
— |
cne storage refresh
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
cne storage release
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
object_ids |
— |
必填;位置参数 |
--note |
— |
必填;为何不再需要这项保护。 |
cne storage sync-catalog
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--create |
False |
湖目录不存在时先创建;首次运行会复制全部数据集。 |
cne storage verify-catalog
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--dataset |
— |
只核对这个数据集的修订。 |
cne ths-official backfill
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
2016-01-01 |
起始报告期。 |
--end |
2024-12-31 |
结束报告期。 |
--chunk-size |
200 |
每个 staging 批次放多少只证券。 |
--workers |
4 |
并发请求数。 |
--symbols |
— |
用逗号分隔的标的列表代替整个市场,定向重试失败证券;收尾 JSON 会在 failed_symbols 里列出仍未补齐的证券。 |
cne ths-official capture
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--what |
all |
抓取哪一种对端快照。 |
--days |
45 |
K 线窗口,按自然日算。 |
--sample |
400 |
K 线抽样多少只证券。 |
cne ths-official repair-bars
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
2005-01-01 |
— |
--end |
2015-12-31 |
— |
--apply |
False |
真正写入。不加它只报告差异,不改任何东西。 |
--adjudicator |
— |
来自独立源的 (symbol, trade_date, close) parquet。 |
--diff-out |
— |
把有争议的行写到这里。 |
--workers |
4 |
— |
cne ths-official resource-sectors
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--start |
2022-01-04 |
服务起点。 |
--end |
— |
默认今天。 |
--apply |
False |
真正写入。不加它只抓取并报告,不改任何东西。 |
--workers |
4 |
— |
cne verify
| 参数 |
默认值 |
说明 |
--config |
configs/cnequity.toml, else ~/.config/cnequity/config.toml |
配置文件路径。 |
--derivatives |
False |
只读验收衍生品研究窗口;需 --dataset、--start、--end。 |
--industry |
False |
只读检查 industry_members 按分类体系、层级、快照日的完整性;可用 --start/--end 缩小范围。 |
--bars |
False |
改为检查「证券 × 交易日」,含窗口内一行都没有的证券。需要 --start。 |
--runs |
False |
改为检查连续交易日的运行证据,不补任何缺口。 |
--dataset |
— |
只校验这些数据集(逗号分隔);默认校验注册表里的全部。 |
--repair |
False |
把能补的缺口跑一遍回填,按数据集从新到旧。 |
--kind |
— |
只看这些缺口类型:empty,stale,interior,shallow。 |
--start |
— |
配合 --bars/--derivatives:覆盖窗口起点(含)。 |
--end |
— |
覆盖窗口终点;--bars 默认上一个完整交易日,--derivatives 必填。 |
--days |
— |
配合 --runs:要求连续多少个交易日(默认 20)。 |
--as-of |
— |
配合 --runs:截止日期 YYYY-MM-DD(含)。 |
--enforce |
False |
配合 --runs:连续天数门禁没过就退出 1。 |