需要多智能体自动写小说、审计和修订并设置人工审核门时，用…

适用场景：用 InkOS 多智能体 CLI 自主完成小说创作、审计和修订，并在可配置检查点进行人工审核。

适用场景

解决思路

1. 安装 InkOS：npm install -g @actalk/inkos，或直接运行 npx @actalk/inkos --version。
2. 创建小说项目：inkos book create --title "吞天魔帝" --genre xuanhuan。
3. 写下一章：inkos write next 吞天魔帝。
4. 审计指定章节：inkos audit 吞天魔帝 --chapter 3。
5. 启动完整守护进程进行连续生产：inkos daemon start。
6. 了解项目目录结构：story/ 下包含 outline.md、book_rules.md、chapter_summaries.md、subplot_board.md、emotional_arcs.md、character_matrix.md、parent_canon.md（仅番外）、style_profile.json、style_guide.md、chapters/ch001.md 等。
7. 书籍管理：inkos book create --title "Title" --genre xuanhuan，体裁可选 xuanhuan | xianxia | dushi | horror | general；inkos book list；inkos book status 吞天魔帝。
8. 写作流水线：inkos write next 吞天魔帝；inkos write chapter 吞天魔帝 5；inkos audit 吞天魔帝 --chapter 3；inkos revise 吞天魔帝 --chapter 3；inkos revise 吞天魔帝 --chapter 3 --mode spot-fix（默认）；inkos revise 吞天魔帝 --chapter 3 --mode rewrite（谨慎使用）；inkos revise 吞天魔帝 --chapter 3 --mode polish（不做结构改动）。
9. 体裁系统：inkos genre list；inkos genre show xuanhuan；inkos genre copy xuanhuan 复制到项目自定义；inkos genre create wuxia --name 武侠 从零创建新体裁。
10. 风格匹配：inkos style analyze reference.txt 分析风格指纹；inkos style import reference.txt 吞天魔帝 导入风格到书；inkos style import reference.txt 吞天魔帝 --name "某作者"。
11. 番外/前传/续传/IF 分支：inkos book create --title "烈焰前传" --genre xuanhuan；inkos import canon 烈焰前传 --from 吞天魔帝 导入正传 canon 约束；inkos write next 烈焰前传，Writer 会自动读取 canon 约束。
12. AIGC 检测：inkos detect 吞天魔帝 --chapter 3；inkos detect 吞天魔帝 --all；inkos detect --stats 查看检测历史统计。
13. 守护进程控制：inkos daemon start（默认 15 分钟/周期）；inkos daemon stop；inkos daemon status。
14. 全局配置：编辑 ~/.inkos/config.json，配置 llm.provider、llm.model、llm.apiKey、llm.temperature；daemon.intervalMinutes、daemon.dailyChapterLimit、daemon.parallelBooks；webhook.url、webhook.secret、webhook.events；aigcDetection.provider、aigcDetection.apiKey、aigcDetection.endpoint。
15. 每本书规则：编辑 story/book_rules.md，定义「禁忌」、高疲劳词、「additionalAuditDimensions」、「写手特别指令」。
16. 智能体架构执行顺序：ArchitectAgent 生成 outline.md、book_rules.md；WriterAgent 写 ch00N.md，读取 outline、summaries、arcs、matrix、style_guide、canon；ValidatorAgent 跑 11 条确定性规则，零 LLM 成本，发现错误立即触发 spot-fix；AuditorAgent 跑 33 个 LLM 维度，temperature=0；ReviserAgent 支持 spot-fix | rewrite | polish | anti-detect。
17. 写后验证器规则（确定性，无 LLM）：禁止 `不是……而是……` 结构；禁止 `——` 字符；过渡词密度 仿佛/忽然/竟然 ≤1 per 3000 chars；高疲劳词按书列表每章 ≤1；禁止元叙事；禁止报告术语；禁止作者说教；禁止「全场震惊」类集体反应；禁止连续「了」≥4 个句子；段落长度 ≥2 段超过 300 字符；书特定禁令来自 book_rules.md。
18. 审计维度（共 33 个，LLM 评估）：Dims 1–23 核心叙事质量（情节、角色、节奏、伏笔）；Dim 24–26 支线停滞、弧线平坦、节奏单调（所有 5 个体裁）；Dim 27 敏感内容；Dim 28–31 番外特定（canon 冲突、未来信息泄露、世界规则一致性、伏笔隔离）；Dim 32 读者期望管理；Dim 33 大纲偏离检测。
19. TypeScript 代码集成：导入 BookManager、WriterAgent、ValidatorAgent；用 BookManager.createBook 创建书；用 WriterAgent.writeNext 写下一章；用 ValidatorAgent.validate 做确定性验证；若 validationResult.hasErrors，用 ReviserAgent({ mode: 'spot-fix' }) 修订并输出修复违规数。
20. Express Webhook 处理器：使用 express.raw({ type: 'application/json' })；从 x-inkos-signature 取签名；用 HMAC-SHA256 和 INKOS_WEBHOOK_SECRET 校验 sha256=${expected}；解析事件；处理 chapter-complete（触发人工审核）、audit-failed、pipeline-error；返回 res.status(200).json({ received: true })。
21. 自定义体裁定义：创建 GenreConfig，设置 id、name、chapterTypes、forbiddenPatterns、fatiguedWords、languageRules（含 bad/good 示例）、auditDimensions。
22. 风格导入流水线：用 StyleAnalyzer 的 analyze 分析参考文本，获取 avgSentenceLength、ttr、rhetoricalDensity、paragraphLengthDist、punctuationStyle；用 importToBook 导入，生成 style_profile.json 和 style_guide.md，可传 authorName。
23. 审计-修订循环：AuditorAgent 在 temperature=0 下运行；发现关键问题后 ReviserAgent 做 spot-fix；比较 AI marker 数量；若 marker 增加则丢弃修订保留原文，否则接受修订；然后重新审计（temp=0）。关键设置：默认修订模式为 spot-fix；rewrite 模式会引入约 6 倍更多 AI markers；polish 模式边界锁定：不增删段落、不改名、不加新情节。
24. 番外 Canon 约束：当检测到 parent_canon.md 时自动激活 4 个额外审计维度；该文件由 inkos import canon 自动生成，包含正传世界规则、关键事件时间线、角色快照（分歧点时状态）、伏笔状态（正传专属，番外禁止回收）。
25. 故障排除：Validator 每章触发时检查 book_rules.md 疲劳词列表并移除不常用词；审计结果不一致时确认 auditor temperature 锁定为 0，并确保代理 LLM API 尊重 temperature: 0；修订引入更多 AI markers 时，InkOS v0.4 会自动检测并丢弃，若反复发生则显式从 rewrite 切换为 spot-fix；番外审计错误标记事件时验证 parent_canon.md 的分歧点时间戳（分歧点前事件 canon 锁定，之后可自由发挥）；Daemon 因重复失败停止书时，检查 daemon status，修复大纲歧义或 book_rules.md 矛盾后运行 inkos daemon resume 书名；风格指南未应用时重新运行 inkos style import，检查 style_guide.md 是否缺失或为空，并确保参考文本 ≥5000 字符以保证可靠指纹。

适用边界 · 注意事项

• 无法安装 @actalk/inkos 或环境不满足 Node.js ≥ 20.0.0 时。
• 没有配置 LLM API（如 OpenAI）或 AIGC 检测服务（如 GPTZero）密钥，无法完整运行需要 LLM/检测的流水线。
• 仅需传统人工写作或不希望自动生成/审计文本的场景。