Skip to content

zh CLI Reference

Huang Anping edited this page Jun 2, 2026 · 1 revision

CLI 参考

所有命令在 mosaic-ts/ 下通过 pnpm dev <command>(开发期)或 pnpm build && mosaic <command>(构建后)运行。命令注册于 mosaic-ts/src/cli/index.ts,各自实现于 mosaic-ts/src/cli/commands/

输出默认中文报告;CLI 选项保持英文。--lang zh|en|bilingual 可在支持处切换报告语言,--fake-llm 是推荐的零成本通道。

核心 / 管道

命令 用途
bridge-ping spawn Python sidecar 并验证 tools.list / config.get
tool-call <name> [argsJson] 调用单个 sidecar 工具。
tool-loop 运行 tool-report 循环。

日循环

pnpm dev daily-cycle --cohort cohort_default --fake-llm

选项:--cohort <name>--date <YYYY-MM-DD>--fake-llm--llm-provider <name>--model <name>--base-url <url>--out <path>。跑全部 25 agents,CIO 写出 portfolio_actions(落库 recommendations 表)。

评分 / Darwinian

pnpm dev scorecard --cohort cohort_default --since 2024-01-01
pnpm dev darwinian --cohort cohort_default
  • scorecard 选项:--cohort <name>--since <date>(YYYY-MM-DD)、--out <path>scorecard 是单一视图命令(无子命令)。
  • darwinian 选项:--cohort <name>--date <YYYY-MM-DD>--compute--out <path>

forward-return 回填是 scorecard.score_pending RPC(BridgeApi.scorecardScorePending),由程序/日常流水线调用 —— 目前不是独立 CLI 子命令。见评分与纸上交易

Autoresearch(提示词自进化)

pnpm dev autoresearch trigger --cohort crisis_2008 --fake-llm --eval-days 5
pnpm dev autoresearch log --cohort crisis_2008

子命令:triggerevaluatelogbranchesreverttrigger 选项含 --cohort--agent--max <n>--dry-run--fake-llm--eval-days <n>--llm-provider/--model/--base-url

Prompt 运维

pnpm dev prompts init-private-repo ~/private-mosaic-prompts
pnpm dev prompts audit-versions --status keep
pnpm dev prompts verify-release --version-id 123
pnpm dev prompts gc-worktrees --repo-target all --max-age-hours 24
  • init-private-repo 创建 sparse private prompt repo。--seed-baseline 仅用于迁移,会制造大面积 override shadowing。
  • audit-versions 只打印 metadata: id、hash、repo id、状态、指标和分支,不展示 prompt 正文。
  • verify-release 检查 pinned release tuple(code_commit_hashprompt_repo_idprompt_commit_hashprompt_sha256),在 commit 上重算 prompt SHA,并运行工具兼容性 gate。
  • release 前还要在 private operator 环境运行 pnpm prompt:drift -- --base-ref origin/main 或 scheduled drift check。
  • gc-worktrees 清理项目 repo / private prompt repo 的 data/worktrees 下过期托管 worktree。
  • private prompt repo 必须配置 private remote、最小权限访问,并启用加密备份或静态加密存储。

PRISM(多周期训练)

pnpm dev prism list
pnpm dev prism train --cohort crisis_2008 --fake-llm

子命令:listtrainstatuscomparetrain 选项:--cohort/--all--start/--end--dry-run--fake-llm--max-concurrent <n>--max-mutations <n>、LLM 选项。

JANUS(跨 cohort 元权重)

pnpm dev janus run
pnpm dev janus weights

子命令:runweightsregimehistory。选项:--date <date>--window <n>--days <n>

MiroFish(反身性模拟)

pnpm dev mirofish generate --swarm --seed 7      # 生成情景
pnpm dev mirofish train --path-aware             # 前向训练;--path-aware = 回撤惩罚评分
pnpm dev mirofish history

子命令:generatetrainhistory

  • generate:--days <n>--seed <n>--print--reflexive--swarm--engine <name>
  • train:--days--seed--agents <list>--dry-run--fake-llm--reflexive--engine <name>--swarm--scorer <name>--path-aware、LLM 选项。

回测

pnpm dev backtest --cohort cohort_default

选项:--cohort--prompt-commit-hash <hash>--fake-llm、LLM 选项、--veto-threshold <num>--initial-cash <amount>--benchmark <ticker>--force-refill--log-every <n>--out <path>。另有 backtest-fill 做缓存填充阶段。

--out 写指标 JSON。完整 ATLAS 同构产物(summary.json / portfolio_trajectory.csv / equity_curve.png)由 backtest.run_historical RPC 在传入 results_dir 时产出(见桥 RPC);尚未做成 backtest CLI 标志。

纸上交易

pnpm dev paper account
pnpm dev paper buy ...

子命令:registerloginlogoutaccountbuysellpositionstradessuggest。见评分与纸上交易

数据 ingest(vendored qlib 采集器)

pnpm dev data incremental --kind stock|etf [--end YYYY-MM-DD]
pnpm dev data validate --kind stock|etf [--gap-threshold 0.01]

长耗时(分钟级)—— 当作 cron 跑,不要与延迟敏感的 RPC 并行。见数据层

TUI

pnpm dev dashboard --cohort cohort_default [--user <name>]

TUI

日常运维

系统是半自动的。典型的收盘后 cron 流水线:

cd mosaic-ts
pnpm dev daily-cycle --cohort cohort_default     # 25 agents → CIO 组合(recommendations 表)
# forward_return 回填:调用 scorecard.score_pending RPC(T+5 后成熟)
pnpm dev darwinian --cohort cohort_default
pnpm dev janus run
pnpm dev dashboard                               # 看一屏

scorecard.score_pending 回填目前是 RPC 而非 CLI 子命令;经桥调用(BridgeApi.scorecardScorePending(cohort, today))。

Clone this wiki locally