Narcooo / inkos

自动化小说写作 CLI Agent 中文 | English --- Agent 写小说。写、审、改，全程接管。 快速开始 安装 通过 OpenClaw 使用 🦞 InkOS 已发布为 OpenClaw Skill，可被任何兼容 Agent（Claude Code、OpenClaw 等）直接调用： 通过 npm 安装或克隆本项目时， 已包含在内，🦞 可直接读取——无需额外从 ClawHub 安装。 安装后，Claw 可通过 调用 InkOS 的所有原子命令（ / / / ）， 输出结构化数据供 Claw 解析决策。也可以在 ClawHub 搜索 在线查看。 配置 **方式一：全局配置（推荐，只需一次）** 配置保存在 ，所有项目共享。之后新建项目不用再配。 **方式二：项目级 ** 项目 会覆盖全局配置。不需要覆盖时可以不写。 **方式三：多模型路由（可选）** 给不同 Agent 分配不同模型，按需平衡质量与成本： 未单独配置的 Agent 自动使用全局模型。 写第一本书 --- 为什么需要 InkOS？ 用 AI 写小说不是简单的"提示词 + 复制粘贴"。长篇小说很快就会崩：角色记忆混乱、物品凭空出现、同样的形容词每段都在重复、伏笔悄无声息地断掉。InkOS 把这些当工程问题来解决。 • **长期记忆** — 追踪世界的真实状态，而非 LLM 的幻觉 • **反信息泄漏** — 确保角色只知道他们亲眼见证过的事 • **资源衰减** — 物资会消耗、物品会损坏，没有无限背包 • **词汇疲劳检测** — 在读者发现之前就捕捉过度使用的词语 • **自动修订** — 在人工审核之前修复数值错误和连续性断裂 工作原理 每一章由五个 Agent 接力完成： | Agent | 职责 | |-------|------| | **雷达 Radar** | 扫描平台趋势和读者偏好，指导故事方向（可插拔，可跳过） | | **建筑师 Architect** | 规划章节结构：大纲、场景节拍、节奏控制 | | **写手 Writer** | 根据大纲 + 当前世界状态生成正文 | | **连续性审计员 Auditor** | 对照长期记忆验证草稿 | | **修订者 Reviser** | 修复审计发现的问题 — 关键问题自动修复，其他标记给人工审核 | 如果审计不通过，管线自动进入"修订 → 再审计"循环，直到所有关键问题清零。 长期记忆 每本书维护 7 个真相文件作为唯一事实来源： | 文件 | 用途 | |------|------| | | 世界状态：角色位置、关系网络、已知信息、情感弧线 | | | 资源账本：物品、金钱、物资数量及衰减追踪 | | | 未闭合伏笔：铺垫、对读者的承诺、未解决冲突 | | | 各章摘要：出场人物、关键事件、状态变化、伏笔动态 | | | 支线进度板：A/B/C 线状态、停滞检测 | | | 情感弧线：按角色追踪情绪变化和成长 | | | 角色交互矩阵：相遇记录、信息边界 | 连续性审计员对照这些文件检查每一章草稿。如果角色"记起"了从未亲眼见过的事，或者拿出了两章前已经丢失的武器，审计员会捕捉到。旧书无新真相文件时自动兼容。 创作规则体系 写手 agent 内置 ~25 条通用创作规则（人物塑造、叙事技法、逻辑自洽、语言约束、去 AI 味），适用于所有题材。 在此基础上，每个题材有专属规则（禁忌、语言铁律、节奏、审计维度），每本书有独立的 （主角人设、数值上限、自定义禁令）和 （世界观设定），由建筑师 agent 创建书籍时自动生成。 详见 CHANGELOG。 三种使用模式 InkOS 提供三种交互方式，底层共享同一组原子操作： • 完整管线（一键式） • 原子命令（可组合，适合外部 Agent 调用） 每个命令独立执行单一操作， 输出结构化数据。可被外部 AI Agent 通过 调用，也可用于脚本编排。 • 自然语言 Agent 模式 内置 13 个工具（write_draft、audit_chapter、revise_chapter、scan_market、create_book、get_book_status、read_truth_files、list_books、write_full_pipeline、web_fetch、import_style、import_canon、import_chapters），LLM 通过 tool-use 决定调用顺序。 命令参考 | 命令 | 说明 | |------|------| | | 初始化项目（省略 name 在当前目录初始化） | | | 创建新书（ 、 、 、 、 传入创作简报） | | | 修改书设置（ 、 、 ） | | | 列出所有书籍 | | | 查看、复制、创建题材 | | | 完整管线写下一章（ 覆盖字数， 连写， 静默模式） | | | 重写第 N 章（恢复状态快照， 跳过确认， 覆盖字数） | | | 只写草稿（ 覆盖字数， 静默模式） | | | 审计指定章节 | | | 修订指定章节 | | | 自然语言 Agent 模式 | | | 审阅草稿 | | | 批量通过 | | | 项目状态 | | | 导出书籍（ 、 、 ） | | | 扫描平台趋势 | | | 设置全局 LLM 配置（~/.inkos/.env） | | | 查看全局配置 | | | 查看/更新项目配置 | | | 为指定 agent 设置模型覆盖（ 、 、 支持多 Provider 路由） | | | 移除 agent 模型覆盖（回退到默认） | | | 查看当前模型路由 | | | 诊断配置问题（含 API 连通性测试 + 提供商兼容性提示） | | | AIGC 检测（ 全部章节， 统计） | | | 分析参考文本提取文风指纹 | | | 导入文风指纹到指定书 | | | 导入正传正典到番外书 | | | 导入已有章节续写（ 、 ） | | / | 书籍数据分析（审计通过率、高频问题、章节排名、token 用量） | | | 更新到最新版本 | | | 启动/停止守护进程（ 静默模式，自动写入 ） | 参数在项目只有一本书时可省略，自动检测。所有命令支持 输出结构化数据。 / 支持 传入创作指导， 覆盖每章字数。 支持 传入创作简报（你的脑洞/设定文档），Architect 会基于此生成设定而非凭空创作。 实测数据 用 InkOS 全自动跑了一本玄幻题材的《吞天魔帝》： | 指标 | 数据 | |------|------| | 已完成章节 | 31 章 | | 总字数 | 452,191 字 | | 平均章字数 | ~14,500 字 | | 审计通过率 | 100% | | 资源追踪项 | 48 个 | | 活跃伏笔 | 20 条 | | 已回收伏笔 | 10 条 | 核心特性 状态快照 + 章节重写 每章自动创建状态快照。使用 可以回滚并重新生成任意章节 — 世界状态、资源账本、伏笔钩子全部恢复到该章写入前的状态。 写入锁 基于文件的锁机制防止对同一本书的并发写入。 写前自检 + 写后结算 写手 agent 在动笔前必须输出自检表（上下文范围、当前资源、待回收伏笔、冲突概述、风险扫描），写完后输出结算表（资源变动、伏笔变动）。审计员对照结算表和正文内容做交叉验证。 可插拔雷达 雷达数据源通过 接口实现可插拔。内置番茄小说和起点中文网两个数据源，也可以传入自定义数据源或直接跳过雷达。用户自己提供题材时，agent 模式会自动跳过市场扫描。 守护进程模式 启动后台循环，按计划写章。管线对非关键问题全自动运行，当审计员标记无法自动修复的问题时暂停等待人工审核。所有日志自动写入项目根目录 （JSON Lines 格式）， 静默模式关闭 stderr 只保留文件日志。 通知推送 支持 Telegram、飞书、企业微信、Webhook。守护进程模式下，写完一章或审计不通过都会推通知到手机。Webhook 支持 HMAC-SHA256 签名和事件过滤。 外部 Agent 集成 原子命令 + 输出让 InkOS 可以被外部 AI Agent（如 OpenClaw、Claude Code 等）调用。Agent 通过 执行 / / ，读取 JSON 结果决定下一步操作。 项目结构 TypeScript 单仓库，pnpm workspaces 管理。 路线图 • [x] 完整管线（雷达 → 建筑师 → 写手 → 审计 → 修订） • [x] 长期记忆 + 连续性审计 • [x] 内置创作规则体系 • [x] CLI 全套命令（20 条） • [x] 状态快照 + 章节重写 • [x] 守护进程模式 • [x] 通知推送（Telegram / 飞书 / 企微） • [x] 原子命令 + JSON 输出（draft / audit / revise） • [x] 自然语言 Agent 模式（tool-use 编排） • [x] 可插拔雷达（RadarSource 接口） • [x] 外部 Agent 集成（OpenClaw 等） • [x] 题材自定义 + 单本书规则（genre CLI + book_rules.md） • [x] 33 维度连续性审计（含 AI 痕迹检测 + 番外维度 + 大纲偏离检测） • [x] 去 AI 味铁律 + 文风指纹注入 • [x] 多 LLM provider（OpenAI + Anthropic + 兼容接口） • [x] AIGC 检测 + 反检测改写管线 • [x] Webhook 通知 + 智能调度（质量门控） • [x] 跨章节连贯性（章节摘要 + 支线/情感/角色矩阵） • [x] 番外写作（正典导入 + 4 维度审计 + 信息边界管控） • [x] 文风仿写（统计指纹 + LLM 风格指南 + 写手注入） • [x] 写后验证器（11 条硬规则 + 自动 spot-fix） • [x] 审计-修订闭环加固（AI 标记守卫 + 温度锁） • [x] 续写已有作品（import chapters + 自动逆向真相文件 + 断点续导） • [x] 多 Provider 路由（不同 agent 走不同 API 地址和 Key， ） • [x] 数据分析（ ：审计通过率、高频问题、章节排名、token 用量统计） • [x] EPUB 导出（ ，手机/Kindle 阅读） • [x] 结构化日志系统（ANSI 颜色、JSON Lines 文件日志、静默模式、LLM 流式心跳） • [x] Stream 自动降级（中转站不支持 SSE 时自动回退 sync，兼容智谱/Gemini 等） • [x] 本地小模型兼容（fallback 解析 + 流中断部分内容恢复） • [x] 创作简报（ 传入你的脑洞，基于此生成设定） • [ ] Web UI 审阅编辑界面（Vite + React + Hono） • [ ] 局部干预（重写半章 + 级联更新后续 truth 文件） • [ ] 英文小说全面适配（English genre profiles, prompts, audit rules, post-write validator） • [ ] 自定义 agent 插件系统 • [ ] 平台格式导出（起点、番茄等） 参与贡献 欢迎贡献代码。提 issue 或 PR。 许可证 MIT