InkOS：十个 Agent 协同的 AI 长篇写作流水线，从草稿到审计定点修复

开源 AI 写作框架 InkOS，GitHub 上已有 9.5k Star、1.8k Fork。项目 2026 年 3 月立项，到 v1.8.0 正式版落地只用了 5 个月。

InkOS 是什么

InkOS 是一个基于 TypeScript 开发的 AI Agent 创作系统，核心定位是把「AI 写小说变成工业化流水线」。

它不是一个对话式写作工具，而是一个多智能体协作框架，覆盖创意构思、大纲规划、章节起草、质量审计到修订迭代的全流程。系统统一在 Pi Agent Harness 架构之上，提供命令行 CLI、TUI（终端用户界面）、Studio Web 工作台等多种交互方式，还发布了 OpenClaw Skill，可被任意兼容 Agent 直接调用。

核心亮点

十个 Agent 协作

InkOS 的核心是一条分工明确的多智能体流水线，不是单一生成模型：

流水线模拟出版流程：规划 → 起草 → 审计 → 修订。审计不通过就自动进入修订循环，定点修复（Spot-Fix）而非推倒重写，避免引入新的 AI 痕迹。

七个「真相文件」

每本书维护 7 个核心真相文件，作为唯一事实来源：

• 世界状态（world_state.md）：当前时间、地点、势力格局、大环境设定
• 角色矩阵（character_matrix.md）：每个角色的详细设定、人际关系、当前状态、成长弧线
• 资源账本（resource_ledger.md）：主角有多少钱、什么装备、消耗了什么道具、物品从哪来
• 伏笔钩子（hook_board.md）：所有伏笔，记录起始章节、类型、状态、预期回收时间
• 章节摘要（chapter_summaries.md）：每一章的关键事件、出场人物、状态变化
• 支线进度（subplot_board.md）：A/B/C 线进度追踪，防止支线遗忘或混乱
• 情感弧线（emotional_arcs.md）：按角色追踪情绪状态、触发事件、弧线方向

写手每写完一章，系统自动更新这些文件。审计员审稿时严格对照，确保角色不会「记起」从未见过的事，物品不会凭空出现，伏笔不会无声丢失。

33 维度连续性审计

审计员（Auditor）对每一章草稿做全链路质量审查，覆盖 33 个维度：

• 角色一致性：角色 OOC、信息边界（谁知道什么事）、情感轨迹
• 时间线逻辑：时间顺序、时差、年龄跨度
• 战力/数值：主角战斗力、装备属性、消耗/获取平衡
• 伏笔管理：钩子回收、新钩子设置、伏笔关联性
• 叙事质量：节奏控制、视角统一、人称一致、场景转换
• AI 痕迹检测：高频重复词、句式单调、「总结升华」式结尾、段落等长等

审计不通过会自动触发修订循环，由修订员做定点修复而非整章重写。审计结果生成完整 Markdown 报告，方便人工审阅。

内置去 AI 味机制

在「源头」和「终端」两个层面处理 AI 痕迹：

• 写手 Agent Prompt 层：内置词汇疲劳词表、禁用句式列表、风格化写作规则，从源头减少 AI 生成痕迹
• 审计维度：专门的 AI 痕迹检测维度，识别「LLM 味」表达
• 反检测改写：inkos revise --mode anti-detect 对已有章节做专门的反检测改写循环
• 文风仿写：inkos style analyze 从真人小说片段提取「统计指纹」（句长分布、词频特征、修辞模式），inkos style import 注入到书籍中，后续章节自动模仿该文风

模型自由 + 多模型路由

不绑死任何一家 AI 提供商：

• OpenAI / GPT 系列
• Anthropic / Claude 系列
• Google Gemini
• Moonshot / 智谱 / 豆包 等国内厂商
• 任何兼容 OpenAI 格式的 API

统一 Pi Agent Harness + 15 个专业 Skill 包

v1.8.0 把 Agent 和管线统一到了 Pi Agent Harness 执行底座上。Studio Chat、TUI、外部 Agent、长篇写作、短篇、剧本、分镜、互动影游、Play 模式、翻译共享同一套工具循环、结构化 action/result、Skill 绑定、检索与运行观测。

模型负责「理解和提议」，InkOS 负责「确认、上下文、状态、原子落盘」——模型随便切，创作中枢稳定。

v1.8.0 内置了 15 个标准 SKILL.md 专业能力包：

每个 Skill 不是简单 prompt 模板，而是带参考资料、执行步骤和质量门控的完整能力包。也可以把外部 Skill 文件夹（含 SKILL.md）直接导入 Studio，从 ~/.agents/skills/ 等标准路径自动发现。

快速上手

安装

npm i -g @actalk/inkos

配置模型（两种方式任选）

方式一：全局配置（推荐，只需一次）

inkos config set-global \
  --provider openai \
  --base-url https://api.openai.com/v1 \
  --api-key sk-xxxxxxxxxx \
  --model gpt-4o

配置保存在 ~/.inkos/.env，所有项目共享，之后新建项目不用再配。

方式二：项目级 .env

inkos init my-novel     # 初始化项目
# 编辑 my-novel/.env

# 必填
INKOS_LLM_PROVIDER=           # openai / anthropic / custom
INKOS_LLM_BASE_URL=           # API 地址（支持中转站）
INKOS_LLM_API_KEY=            # API Key
INKOS_LLM_MODEL=              # 模型名
# 可选
INKOS_LLM_TEMPERATURE=0.7     # 温度
INKOS_LLM_MAX_TOKENS=8192     # 最大输出 token
INKOS_LLM_THINKING_BUDGET=0   # Anthropic 扩展思考预算
INKOS_DEFAULT_LANGUAGE=zh     # zh 或 en

写第一本书（3 步成章）

# 1. 创建书籍
inkos book create --title "吞天魔帝" --genre xuanhuan

# 2. 写下一章（完整管线：草稿 → 审计 → 修订）
inkos write next

# 3. 查看状态 & 审阅
inkos status                     # 查看项目状态
inkos review list                # 列出所有草稿
inkos review approve-all         # 批量通过
inkos audit last                 # 查看最近一章的审计报告
inkos export                     # 导出全书 Markdown
inkos export --format epub       # 导出 EPUB（手机/Kindle 阅读）

常用命令速查

# 写作管线
inkos write next                   # 写下一章（完整管线）
inkos write next --count 5         # 连续写多章（v1.8.0 作为后台任务，可取消/恢复）
inkos draft [chapter]              # 只写草稿（跳过审计修订）
inkos audit [chapter] [n]          # 对特定章节做审计
inkos revise [chapter] [n]         # 对特定章节做修订

# TUI 交互入口（v1.8.0 新增明确入口）
inkos tui /new                     # 新建书籍
inkos tui /short                   # 短篇创作
inkos tui /play                    # 互动影游
inkos tui /cover                   # 封面生成
inkos tui /write                   # 写作模式
inkos tui /model                   # 切换模型
inkos tui /confirm                 # 确认操作
inkos tui /cancel                  # 取消操作

# 审阅与导出
inkos review list                  # 列出所有草稿
inkos review approve-all           # 批量通过
inkos audit last                   # 查看最近一章的审计报告
inkos export                       # 导出全书 Markdown
inkos export --format epub         # 导出 EPUB

# 风格与检测
inkos style analyze ref.txt        # 分析参考文本文风
inkos style import ref.txt book    # 将文风注入到书籍
inkos detect book --all            # 全书 AI 痕迹检测
inkos detect --stats               # 检测统计

# 其他
inkos agent                        # 自然语言对话模式
inkos import chapters              # 导入已有章节，逆向工程真相文件
inkos up                           # 守护进程模式（后台自动写章）
inkos genre list                   # 查看所有可用题材
inkos config show-models           # 查看多模型路由
inkos doctor                       # 系统自检
inkos status                       # 查看项目状态

写在最后

InkOS 没有指望用更强的模型解决所有问题，而是用工程化方式弥补模型的天生缺陷。「写小说」本质上是长期状态管理 + 多轮质量迭代，不是单次 Prompt 生成。InkOS 把它做成了可审计、可续写、可导入、可仿写、可接 Skill 扩展的工程化系统。写剧本、分镜、互动影游、翻译也共用同一套工作台。

数据全部存在本地（不强制上云），模型提供商不锁定（多模型路由随意配）。

GitHub：https://github.com/Narcooo/inkos