最近 GitHub 上一个叫 InkOS 的项目。截至目前,它已经收获了 9.5k Star、1.8k Fork。

被很多技术博主称为「AI 写长篇不崩的秘密武器」。更狠的是,从 2026 年 3 月立项到 v1.8.0 正式版,只用了 5 个月就迭代出了一套相当成熟的生产系统。
InkOS 是什么?
InkOS 是一个基于 TypeScript 开发的 AI Agent 创作系统,核心定位是”把 AI 写小说变成工业化流水线”。

它不只是一个对话式的写作工具,而是一个完整的多智能体协作框架,覆盖从创意构思、大纲规划、章节起草、质量审计到修订迭代的全流程。
引入了统一的 Pi Agent Harness 架构。除了命令行 CLI,还提供 TUI(终端用户界面)、Studio Web 工作台等多种交互方式,甚至发布了 OpenClaw Skill,可以被任何兼容 Agent 直接调用。
核心亮点
1、十个 Agent 协作
InkOS 的核心是一条分工明确的多智能体流水线,而不是单一的生成模型:
| Agent | 角色 | 职责 |
|---|---|---|
| 雷达 | 选题策划 | 扫描趋势,捕捉流行元素与题材热点 |
| 规划师 | 总编剧 | 制定核心创作意图,确立书籍总体走向 |
| 建筑师 | 大纲师 | 规划章节结构,编排上下文逻辑 |
| 编译器 | 上下文整合 | 编译上下文,整合各类信息输入 |
| 写手 | 主笔 | 执行正文生成,内置去 AI 味规则 |
| 观察者 | 事实提取 | 提取 9 类关键事实,作为审核依据 |
| 反射器 | 策略调整 | 输出 3 个 Delta,动态调整生成策略 |
| 控字员 | 字数控制 | 精准控制章节字数 |
| 审计员 | 初审 | 从 33 个维度做质量审查 |
| 连续性审计员 | 终审 | 专门检查角色记忆、伏笔、时间线等 |
这套流水线模拟了真实的出版流程:规划→起草→审计→修订。审计不通过就自动进入修订循环,定点修复(Spot-Fix)而非推倒重写,避免引入新的 AI 痕迹。
2、七个”真相文件”
系统会给每一本书维护 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):按角色追踪情绪状态、触发事件、弧线方向
每当写手写完一章,系统会自动更新这些文件。审计员审稿时严格对照,确保角色不会”记起”从未见过的事,物品不会凭空出现,伏笔不会悄无声息地丢失。
3、33 维度连续性审计
审计员(Auditor)会从 33 个维度 对每一章草稿进行全链路质量审查,覆盖:
- • 角色一致性:角色 OOC、信息边界(谁知道什么事)、情感轨迹
- • 时间线逻辑:时间顺序、时差、年龄跨度
- • 战力/数值:主角战斗力、装备属性、消耗/获取平衡
- • 伏笔管理:钩子回收、新钩子设置、伏笔关联性
- • 叙事质量:节奏控制、视角统一、人称一致、场景转换
- • AI 痕迹检测:高频重复词、句式单调、”总结升华”式结尾、段落等长等
一旦审计不通过,系统会自动触发修订循环,由修订员做定点修复而非整章重写。审计结果会生成完整的 Markdown 报告,方便人工审阅。
4、内置去 AI 味机制
InkOS 在源头和终端两个层面都做了去 AI 味处理:
- • 写手 Agent Prompt 层:内置词汇疲劳词表、禁用句式列表、风格化写作规则,从源头减少 AI 生成痕迹
- • 审计维度:专门的 AI 痕迹检测维度,识别”LLM 味”表达
- • 反检测改写:
inkos revise --mode anti-detect可对已有章节做专门的反检测改写循环 - • 文风仿写:
inkos style analyze从真人小说片段提取”统计指纹”(句长分布、词频特征、修辞模式),inkos style import注入到书籍中,后续章节自动模仿该文风
5、模型自由 + 多模型路由
InkOS 不绑死任何一家 AI 提供商,支持:
- • OpenAI / GPT 系列
- • Anthropic / Claude 系列
- • Google Gemini
- • Moonshot / 智谱 / 豆包 等国内厂商
- • 任何兼容 OpenAI 格式的API
6、统一 Pi Agent Harness + 15 个专业 Skill 包
InkOS 把之前散落在各处的 Agent 和管线,统一收敛到了一套叫 Pi Agent Harness 的执行底座上。
Studio Chat、TUI、外部 Agent、长篇写作、短篇、剧本、分镜、互动影游、Play 模式、翻译……所有创作入口都共享同一套 工具循环、结构化 action/result、Skill 绑定、检索与运行观测。
简单说:模型负责”理解和提议”,InkOS 负责”确认、上下文、状态、原子落盘”。这样模型随便切,InkOS 的”创作中枢”稳如老狗。
配合这套架构,v1.8.0 一次性内置了 15 个标准 SKILL.md 专业能力包:
| Skill | 用途 |
|---|---|
| 长篇写作 / 审稿 | 长篇小说全流程 |
| 商业短篇 | 独立短篇完整产出 |
| 剧本 / 分镜 | 影视化内容生产 |
| 互动影游 / Play | 分支剧情游戏模式 |
| 翻译 / 拆稿 / 导入 | 跨语言 + 逆向工程 |
| 市场研究 | 题材趋势扫描 |
| 封面生成 | 一键出封面提示词 |
| 语义去 AI 味 | 专门的反检测改写 |
每个 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 # 查看项目状态
写在最后
在 AI 写作工具泛滥的今天,InkOS 给了我们一个很好的思路——不是靠更强的模型解决所有问题,而是用工程化的方式弥补模型的天生缺陷。
“写小说”这件事,本质上是长期状态管理 + 多轮质量迭代,而不是单次 Prompt 生成。InkOS 把它做成了一个可以审计、可以续写、可以导入、可以仿写、还可以接 Skill 扩展的工程化系统。
而且它不只是写小说——剧本、分镜、互动影游、翻译,同一套工作台全能搞定。
更难得的是,它对用户的态度很友好:所有数据都存在本地(不强制上云)、不绑死任何一家模型提供商(多模型路由随便配)。
毕竟,有个靠谱的「AI 编辑部」帮你盯着每一个角色、每一件物品、每一条伏笔,总比半夜爬起来翻自己三个月前写的设定强。
GitHub:https://github.com/Narcooo/inkos





评论(0)