InkOS - Autonomous Novel Writing Agent — InkOS - 自主小说写作代理

InkOS - 自主小说写作代理 InkOS 是一个用于自主小说写作的 CLI 工具，采用 LLM 代理技术。它通过一个多代理管道（Radar → Planner → Composer → Architect → Writer → Observer → Reflector → Normalizer → Auditor → Reviser）来生成、审计和修订小说内容，无需人工干预。该管道分为三个阶段： 第 1 阶段（创作写作，temp 0.7）：Planner 生成章节意图，包括 hook议程，Composer 选择相关上下文，Writer 生成文章，包括长度控制、首屏 hook、语义密度、hook-ledger 支付和移动段落节奏指导。 第 2 阶段（状态结算，temp 0.3）：Observer 过度提取 9 类事实，Reflector 输出 JSON delta（非完整 markdown），代码层应用 Zod 模式验证和不可变状态更新。Hook 操作使用 upsert/mention/resolve/defer 语义。 第 3 阶段（质量循环）：Normalizer 调整章节长度，Auditor 运行 33 维度检查，包括 hook 健康分析，Reviser 自动修复关键问题。自我纠正循环运行，直到所有关键问题清除。 真实文件以 schema 验证的 JSON 格式（story/state/*.json）持久化，并以 markdown 投影提供人类可读性。SQLite 时态内存数据库（story/memory.db）在 Node 22+ 上启用相关性检索。 何时使用 InkOS 英语小说写作：原生英语支持，10 个流派配置文件（LitRPG、Progression Fantasy、Isekai 等）。 设置 --lang en 中文网络小说写作：5 个内置中文流派（xuanhuan、xianxia、urban、horror、other） 同人小说：从源材料创建同人小说，4 种模式（canon、au、ooc、cp） 批量章节生成：生成多个章节，保持一致的质量 导入和继续：从文本文件导入现有章节，反向工程真实文件，并继续写作 风格模仿：分析和采用参考文本的写作风格 衍生写作：在保持父级正典的情况下写作前传/续集/衍生作品 质量审计：检测 AI 生成内容并执行 33 维度质量检查 流派探索：探索趋势并创建自定义流派规则 分析：跟踪每本书的字数、审计通过率和问题分布 初始设置 首次设置 # 初始化项目目录（创建配置结构） inkos init my-writing-project # 配置您的 LLM 提供商（OpenAI、Anthropic 或任何 OpenAI 兼容 API） # 更喜欢 --api-key-env，因此密钥永远不会出现在 shell 历史记录中： export OPENAI_API_KEY=sk-xxx inkos config set-global --provider openai --base-url https://api.openai.com/v1 --api-key-env OPENAI_API_KEY --model gpt-4o # 对于兼容/代理端点，请使用 --provider custom 并仅指向可信端点： # inkos config set-global --provider custom --base-url https://your-trusted-proxy.com/v1 --api-key-env OPENAI_API_KEY --model gpt-4o 多模型路由（可选） # 为不同代理分配不同的模型 - 平衡质量和成本 inkos config set-model writer claude-sonnet-4-20250514 --provider anthropic --base-url https://api.anthropic.com --api-key-env ANTHROPIC_API_KEY inkos config set-model auditor gpt-4o --provider openai inkos config show-models 没有显式覆盖的代理将回退到全局模型。 查看系统状态 # 检查安装和配置 inkos doctor # 查看当前配置 inkos status 常见工作流程 工作流 1：创建新小说 初始化并创建书籍： inkos book create --title "我的小说标题" --genre xuanhuan --chapter-words 3000 # 或使用创意简报（您的世界构建文档/想法）： inkos book create --title "我的小说标题" --genre xuanhuan --chapter-words 3000 --brief my-ideas.md 流派：xuanhuan（修炼）、xianxia（仙侠）、urban（都市）、horror、other 返回书籍 ID 以进行所有后续操作 生成初始章节（例如 5 章）： inkos write next book-id --count 5 --words 3000 --context "年轻主角发现力量" write next 命令运行完整管道：草稿 → 审计 → 修订 --context 为 Architect 和 Writer 代理提供指导 返回 JSON 格式的章节详细信息和质量指标 查看和批准章节： inkos review list book-id inkos review approve-all book-id 导出书籍（支持 txt、md、epub）： inkos export book-id inkos export book-id --format epub 工作流 2：继续写作现有小说 列出您的书籍： inkos book list 从最后一章继续： inkos write next book-id --count 3 --words 2500 --context "主角面临关键选择" InkOS 维护 7 个真实文件（世界状态、角色矩阵、情感弧线等）以保持一致性 如果只有一个书籍存在，请省略 book-id 以进行自动检测 查看和批准： inkos review approve-all 工作流 2.5：共享自然语言控制（推荐用于 OpenClaw） 当 InkOS 由 OpenClaw 或其他外部代理驱动时，建议使用共享交互执行器而不是拼接许多