作者: · 发布:

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

9.5K Star!万字小说不”崩”!这个开源 AI 写作框架绝了!

被很多技术博主称为「AI 写长篇不崩的秘密武器」。更狠的是,从 2026 年 3 月立项到 v1.8.0 正式版,只用了 5 个月就迭代出了一套相当成熟的生产系统。

InkOS 是什么?

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

9.5K Star!万字小说不”崩”!这个开源 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

颜资源站长
颜资源站长 已发布 1017 篇文章

资深互联网从业者,专注AI工具研究与实战应用。长期跟踪ChatGPT、Claude、Stable Diffusion等前沿AI技术,擅长将复杂的技术概念转化为通俗易懂的教程。运营颜资源小站,致力于为中文用户提供高质量的AI教程、开源项目推荐和数字资源整理。