cli.md

CLI 参考

入口：

uv run python -m novel_architect <command> [options]

如果包已安装，也可以：

novel-architect <command> [options]

项目与状态

命令	用途
init	初始化新小说项目骨架。
status	输出项目健康状态、当前章节、gate 风险。
validate	校验指定章节流水线产物。
rebuild	从 src/ + manuscript/ 重建全部派生状态。
rebuild-index	只重建章节索引。
resume	从断点恢复指定章节流水线。

示例：

uv run python -m novel_architect init --project projects/demo --title 演示 --genre 都市重生 --platform 番茄 --premise "..." --core-hook "..." --protagonist 陆辰
uv run python -m novel_architect status --project projects/demo
uv run python -m novel_architect rebuild --project projects/demo

章节流水线

命令	用途	关键产物
prepare	生成下一章写作任务。	editorial/chXXXX/writing_task.json
review	运行 signal、verdict、gate、repair。	signals/、gate.json、repair.json
commit	gate 通过后推进状态并重建账本。	data/ 派生状态

示例：

uv run python -m novel_architect prepare --project projects/demo --query "本章要承接上一章钩子，给出一次可见反制"
uv run python -m novel_architect review --project projects/demo --chapter 1
uv run python -m novel_architect commit --project projects/demo --chapter 1

review 返回非 0 通常表示 gate 未通过，不一定是程序异常。

Market Pack 与开书

命令	用途
market-open	导出开书市场策划 prompt/input。
market-save	保存 Agent 生成的 market pack JSON。
market-status	查看 market pack 状态。
export-title-review-prompt	导出书名审校 prompt。
export-intro-review-prompt	导出简介审校 prompt。

示例：

uv run python -m novel_architect market-open --project projects/demo --platform 番茄 --genre-hint 都市重生 --seed-idea "..."
uv run python -m novel_architect market-save --project projects/demo --file market_pack.json
uv run python -m novel_architect market-status --project projects/demo

Beat Competition

命令	用途
beat-candidates	导出三方案章法竞赛 prompt/input。
beat-select	保存 Agent 选择/生成的 beat selection。
apply-beat-selection	将选中方案应用到 brief/writing_task。

示例：

uv run python -m novel_architect beat-candidates --project projects/demo --chapter 1
uv run python -m novel_architect beat-select --project projects/demo --chapter 1 --file beat_selection.json
uv run python -m novel_architect apply-beat-selection --project projects/demo --chapter 1

Model Signals

命令	用途
export-signal-prompts	导出 12 个 signal 的模型审校 prompt。
save-model-signal	保存指定 signal 的模型评估 JSON。

示例：

uv run python -m novel_architect export-signal-prompts --project projects/demo --chapter 1
uv run python -m novel_architect save-model-signal --project projects/demo --chapter 1 --signal reader_pull --file reader_pull.json

保存 model signals 后必须重新 review，让 final merged signals 和 gate 更新。

First 3 / First 10

命令	用途
first3-review	导出前三章专项审校 prompt/input。
save-first3-review	保存 first3 verdict。
first-10-retention	导出/生成前十章留存计划。
save-first10-plan	保存前十章留存计划。

save-first3-review 的 verdict 必须包含匹配的 review_input_hash 和 8 个合格评分，否则返回非 0 并阻断第 4 章以后。

Diagnostics

命令	用途
batch-review	批量章节复核。
volume-review	卷级体检。
benchmark	长跑结构健康检查。
learn	从样本章节做拆书建模。

示例：

uv run python -m novel_architect batch-review --project projects/demo --start 1 --end 10
uv run python -m novel_architect volume-review --project projects/demo --volume 1
uv run python -m novel_architect benchmark --project projects/demo
uv run python -m novel_architect learn --sample-dir samples/book-a

Feedback

命令	用途
save-feedback	保存平台/读者反馈。
feedback-diagnose	导出反馈诊断 prompt/input。
feedback-summary	汇总反馈。

Legacy / External Prompt

命令	用途
gen-prompt	生成给外部写作模型/Claude Code 的独立提示词。

普通续写不要用 gen-prompt 替代 prepare → beat → writing_task → review → commit 主流程。gen-prompt 也受 first3 gate 和 volumes.json 规划范围约束。

Repository Verification Commands

这些命令不是小说项目流水线的一部分，但用于仓库开发、CI 和开源发布前验证：

uv sync --group dev
uv run python -m novel_architect --version
uv run python -m novel_architect --help
bash scripts/format.sh
bash scripts/lint.sh
bash scripts/test.sh
python -m compileall -q skill/novel-architect/src tests
python tools/final_merge_probe.py .
bash scripts/release.sh

GitHub Actions CI 应覆盖这些检查，并确认 release bundle 只包含 skill/novel-architect/ runtime 文件。

如果 workflow 文件、release 检查、runtime artifact 或项目 schema 变化，本页和 项目文件结构参考 都需要同步。