核心用法
InkOS 是一款面向长篇虚构写作的 CLI 智能体工具，采用九阶段多智能体流水线（Radar→Planner→Composer→Architect→Writer→Observer→Reflector→Normalizer→Auditor→Reviser）实现章节级全自动创作。用户通过 inkos book create 初始化书籍，以 inkos write next 触发完整写作流程，或拆解为 draft/audit/revise 三阶段进行精细控制。支持中英文原生输出，内置 10 种英文类型（LitRPG、Progression Fantasy、Isekai 等）与 5 种中文网文类型（玄幻、仙侠、都市等），并可通过 inkos style analyze/import 实现风格迁移。特色功能包括：现有文本导入并逆向重建一致性状态（truth files）、同人小说四模式创作（canon/au/ooc/cp）、AI生成内容检测（11条确定性规则）、EPUB/TXT/Markdown 导出及 InkOS Studio 可视化工作台。
显著优点
1. 工业级一致性保障：7 类 truth 文件（世界状态、角色矩阵、情感弧线等）以 JSON Schema 强校验持久化，配合 SQLite 时序记忆库，解决长文本角色崩坏与设定漂移问题。
2. 双阶段温控写作：创作期（temp 0.7）与结算期（temp 0.3）分离，确保叙事流畅同时严格维护状态机，hook 操作采用 upsert/mention/resolve/defer 语义，避免伏笔遗漏。
3. 33 维质量审计：覆盖节奏、对话、世界观、大纲贴合度等维度，含 hook 健康分析（陈旧债务、爆发检测），自动进入修订循环直至关键问题清零。
4. 多模型路由与成本优化：支持按智能体分配不同模型（如 Writer 用 Claude、Auditor 用 GPT-4o），用户可接入任意 OpenAI 兼容端点。
5. 零侵入安全设计：无 install 钩子、无遥测、仅本地文件 IO、API Key 通过环境变量注入，AGPL-3.0 全开源可审计。
潜在缺点与局限性
- 成本门槛：完整流水线单次章节调用 8-12 次 LLM，长篇章节费用累积显著；33 维审计与自动修订进一步推高 token 消耗。
- 创意天花板：高度依赖提示工程与状态机约束，可能抑制突发奇想的「神来之笔」；复杂多线叙事仍需人工介入 steering（通过
--context或update_current_focus）。 - 中文生态适配：虽支持中文类型，但 genre 疲劳词库、市场雷达趋势分析仍以英文网文平台（RoyalRoad 等）为主。
- 学习曲线：truth files 架构、hook 语义、多智能体协作概念对纯写作背景用户存在认知负担。
适合人群
- 日更压力大的网文作者，需批量生成保底草稿后人工润色
- 跨语言写作尝试者（英文类型小说试水）
- 拥有半成品稿件需恢复续写的「填坑」作者
- 同人创作者需严格维持原作设定一致性
- 技术向写作者愿意用 JSON/YAML 级精度控制叙事
常规风险
1. API Key 泄露：inkos.json 存储密钥，需加入 .gitignore；避免在 shell 中直接粘贴 --api-key。
2. 自定义端点信任：--provider custom 将密钥转发至任意 URL，仅应指向自有或已审计代理。
3. 内容合规：AIGC 检测功能仅用于自我审查，无法替代平台审核；生成内容可能含版权敏感元素（同人模式）。
4. 过度依赖自动化：自动修订循环可能掩盖叙事深层问题，建议保留人工终审环节。