InkOS

自动化小说写作 CLI Agent

Agent 写小说。写、审、改，全程接管。

为什么需要 InkOS？

用 AI 写小说不是简单的"提示词 + 复制粘贴"。长篇小说很快就会崩：角色记忆混乱、物品凭空出现、同样的形容词每段都在重复、伏笔悄无声息地断掉。InkOS 把这些当工程问题来解决。

三大真相文件 — 追踪世界的真实状态，而非 LLM 的幻觉
反信息泄漏 — 确保角色只知道他们亲眼见证过的事
资源衰减 — 物资会消耗、物品会损坏，没有无限背包
词汇疲劳检测 — 在读者发现之前就捕捉过度使用的词语
自动修订 — 在人工审核之前修复数值错误和连续性断裂

工作原理

InkOS 为每一章运行多智能体管线：

智能体	职责
雷达 Radar	扫描平台趋势和读者偏好，指导故事方向（可插拔，可跳过）
建筑师 Architect	规划章节结构：大纲、场景节拍、节奏控制
写手 Writer	根据大纲 + 当前世界状态生成正文
连续性审计员 Auditor	对照三大真相文件验证草稿
修订者 Reviser	修复审计发现的问题 — 关键问题自动修复，其他标记给人工审核

如果审计不通过，管线自动进入"修订 → 再审计"循环，直到所有关键问题清零。

三大真相文件

每本书维护三个文件作为唯一事实来源：

文件	用途
`current_state.md`	世界状态：角色位置、关系网络、已知信息、情感弧线
`particle_ledger.md`	资源账本：物品、金钱、物资数量及衰减追踪
`pending_hooks.md`	未闭合伏笔：铺垫、对读者的承诺、未解决冲突

连续性审计员对照这三个文件检查每一章草稿。如果角色"记起"了从未亲眼见过的事，或者拿出了两章前已经丢失的武器，审计员会捕捉到。

内置创作规则体系

写手 agent 内置了一套从大量网文创作实践中提炼的规则体系，覆盖 6 个维度：

人物塑造铁律 — 角色行为由"过往经历 + 当前利益 + 性格底色"共同驱动；配角必须有独立动机
叙事技法 — Show don't tell、五感代入法、每章结尾必须设置钩子、信息分层植入
逻辑自洽 — 三连反问自检、信息越界检查、关系改变必须事件驱动
语言约束 — 句式多样化、高疲劳词限制、情绪用细节传达
禁忌清单 — 禁止机械降神、反派降智、主角圣母、特定句式和标点
数值验算铁律 — 每次数值变动必须从账本取值验算，同质资源有衰减公式

每本书还有自己的 style_guide.md（文风指南）和 story_bible.md（世界观设定），由建筑师 agent 在创建书籍时生成。

三种使用模式

InkOS 提供三种交互方式，底层共享同一组原子操作：

1. 完整管线（一键式）

inkos write next 吞天魔帝          # 写草稿 → 审计 → 自动修订，一步到位
inkos write next 吞天魔帝 --count 5 # 连续写 5 章

2. 原子命令（可组合，适合外部 Agent 调用）

inkos draft 吞天魔帝 --context "本章重点写师徒矛盾" --json
inkos audit 吞天魔帝 31 --json
inkos revise 吞天魔帝 31 --json

每个命令独立执行单一操作，--json 输出结构化数据。可被 OpenClaw 等自主智能体通过 exec 调用，也可用于脚本编排。

3. 自然语言 Agent 模式（LLM 自主编排）

inkos agent "帮我写一本都市修仙，主角是个程序员"
inkos agent "写下一章，重点写师徒矛盾"
inkos agent "先扫描市场趋势，然后根据结果创建一本新书"

内置 9 个工具（write_draft、audit_chapter、revise_chapter、scan_market、create_book、get_book_status、read_truth_files、list_books、write_full_pipeline），LLM 通过 tool-use 自主决定调用顺序。

快速开始

安装

npm i -g @actalk/inkos

配置

inkos init              # 初始化项目，生成 .env 模板
# 编辑 .env，填入你的 API Key（支持所有 OpenAI 兼容接口）

使用

inkos book create --title "吞天魔帝" --genre xuanhuan  # 创建新书
inkos write next 吞天魔帝      # 写下一章（完整管线）
inkos status                   # 查看状态
inkos review list 吞天魔帝     # 审阅草稿
inkos export 吞天魔帝          # 导出全书
inkos up                       # 守护进程模式

命令参考

命令	说明
`inkos init`	初始化项目
`inkos book create`	创建新书（生成世界观 + 卷纲 + 文风指南）
`inkos book list`	列出所有书籍
`inkos write next <id>`	完整管线写下一章
`inkos write rewrite <id> <n>`	重写第 N 章（恢复状态快照）
`inkos draft <id>`	只写草稿（不审不改）
`inkos audit <id> [n]`	审计指定章节
`inkos revise <id> [n]`	修订指定章节
`inkos agent <instruction>`	自然语言 Agent 模式
`inkos review list/approve/reject`	审阅草稿
`inkos review approve-all <id>`	批量通过
`inkos status`	项目状态
`inkos export <id>`	导出书籍为 txt/md
`inkos radar scan`	扫描平台趋势
`inkos config set/show`	查看/更新配置
`inkos doctor`	诊断配置问题
`inkos up / down`	启动/停止守护进程

所有命令支持 --json 输出结构化数据，draft/write next/book create 支持 --context 传入创作指导。

实测数据

用 InkOS 全自动跑了一本玄幻题材的《吞天魔帝》：

指标	数据
已完成章节	31 章
总字数	452,191 字
平均章字数	~14,500 字
审计通过率	100%
资源追踪项	48 个
活跃伏笔	20 条
已回收伏笔	10 条

核心特性

状态快照 + 章节重写

每章自动创建状态快照。使用 inkos write rewrite <id> <n> 可以回滚并重新生成任意章节 — 世界状态、资源账本、伏笔钩子全部恢复到该章写入前的状态。

写入锁

基于文件的锁机制防止对同一本书的并发写入。

写前自检 + 写后结算

写手 agent 在动笔前必须输出自检表（上下文范围、当前资源、待回收伏笔、冲突概述、风险扫描），写完后输出结算表（资源变动、伏笔变动）。审计员对照结算表和正文内容做交叉验证。

可插拔雷达

雷达数据源通过 RadarSource 接口实现可插拔。内置番茄小说和起点中文网两个数据源，也可以传入自定义数据源或直接跳过雷达。用户自己提供题材时，agent 模式会自动跳过市场扫描。

守护进程模式

inkos up 启动自主循环，按计划写章。管线对非关键问题全自动运行，当审计员标记无法自动修复的问题时暂停等待人工审核。

通知推送

支持 Telegram、飞书、企业微信。守护进程模式下，写完一章或审计不通过都会推通知到手机。

外部 Agent 集成

原子命令 + --json 输出让 InkOS 可以被 OpenClaw 等自主智能体调用。OpenClaw 通过 exec 工具执行 inkos draft/audit/revise，读取 JSON 结果决定下一步操作。

项目结构

inkos/
├── packages/
│   ├── core/              # 智能体运行时、管线、状态管理
│   │   ├── agents/        # architect, writer, continuity, reviser, radar
│   │   ├── pipeline/      # runner (原子操作 + 完整管线), agent (tool-use 编排), scheduler
│   │   ├── state/         # 基于文件的状态管理器
│   │   ├── llm/           # OpenAI 兼容接口 (流式)
│   │   ├── notify/        # Telegram, 飞书, 企业微信
│   │   └── models/        # Zod schema 校验
│   └── cli/               # Commander.js 命令行 (15 条命令)
│       └── commands/      # init, book, write, draft, audit, revise, agent, review, status, export...
└── (规划中) studio/        # 网页审阅编辑界面

TypeScript 单仓库，pnpm workspaces 管理。

路线图

完整智能体管线（雷达 → 建筑师 → 写手 → 审计 → 修订）
三大真相文件 + 连续性审计
内置创作规则体系
CLI 全套命令（15 条）
状态快照 + 章节重写
守护进程模式
通知推送（Telegram / 飞书 / 企微）
原子命令 + JSON 输出（draft / audit / revise）
自然语言 Agent 模式（tool-use 编排）
可插拔雷达（RadarSource 接口）
外部 Agent 集成（OpenClaw 等）
packages/studio Web UI 审阅编辑界面
多模型路由（不同 agent 用不同模型）
自定义 agent 插件系统
平台格式导出（起点、番茄等）

参与贡献

欢迎贡献代码。提 issue 或 PR。

pnpm install
pnpm dev          # 监听模式
pnpm test         # 运行测试
pnpm typecheck    # 类型检查

许可证

MIT

README.md 10 KB История Исходник