Главная Обзор Помощь
Вход
nonvioce
/
inkos
1
0
Ответвить 0
Файлы Задачи 0 Запросы на слияние 0 Вики
Дерево: 1f03c3eff4
Ветки Метки
inkos
/
README.md

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

InkOS Logo

InkOS

自动化小说写作 CLI Agent

Node.js pnpm TypeScript

中文 | English

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

为什么需要 InkOS？

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

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

工作原理

每一章由五个 Agent 接力完成：

管线流程图

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

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

长期记忆

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

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

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

长期记忆快照

三层规则架构

InkOS 采用三层规则合并机制，让通用规则、题材规范、单本书定制层层叠加：

通用规则（~25 条，代码内置）
  ↓ 合并
题材规范（genres/*.md，按题材定制）
  ↓ 合并
单本书规则（books/{id}/story/book_rules.md，逐本定制）
  ↓ 注入 prompt
LLM

通用层 — 人物塑造、叙事技法、逻辑自洽、语言约束、去AI味铁律（共 ~25 条），适用于所有题材。

题材层 — 内置 5 个题材 profile（玄幻、仙侠、都市、恐怖、通用），每个 profile 定义：

  • 章节类型（战斗章/氛围章/商战章…）
  • 高疲劳词列表 + AI 标记词检测
  • 数值系统 / 战力体系 / 年代考据开关
  • 节奏规则、爽点类型
  • 审计维度启用列表
  • 题材禁忌、语言铁律（带 ✗→✓ 示例）、叙事指导

书籍层 — 主角人设锁定、题材锁定、数值上限、自定义禁令等，由建筑师 agent 在创建书籍时生成，也可手动编辑。

inkos genre list                    # 查看所有可用题材
inkos genre show xuanhuan           # 查看玄幻 profile 详情
inkos genre create wuxia --name 武侠  # 创建自定义题材
inkos genre copy xuanhuan           # 复制内置 profile 到项目中定制

19 维度连续性审计

审计员对每章草稿进行 19 个维度的检查，维度按题材自动启用：

维度 说明 条件
OOC 检查 角色行为是否符合人设 始终
时间线检查 时间线是否连贯 始终
设定冲突 是否与已建立设定矛盾 始终
战力崩坏 战力是否前后一致 powerScaling=true
数值检查 资源/数值是否正确结算 numericalSystem=true
伏笔检查 伏笔是否遗忘或矛盾 始终
节奏检查 节奏是否符合题材预期 始终
文风检查 文风是否一致 始终
信息越界 角色是否知道不该知道的事 始终
词汇疲劳 高疲劳词 + AI 标记词密度 始终
利益链断裂 利益关系是否逻辑完整 始终
年代考据 年代细节是否准确 eraResearch=true
配角降智 配角是否被降智 始终
配角工具人化 配角是否沦为工具人 始终
爽点虚化 爽点是否落地 始终
台词失真 对话是否符合角色身份 始终
流水账 是否平铺直叙无起伏 始终
知识库污染 是否把设定资料原样搬进正文 始终
视角一致性 视角切换是否有过渡 始终

玄幻/仙侠启用全部 19 维度（含数值和战力），都市启用 17 维度（含年代考据，无数值/战力），恐怖启用 15 维度（无数值/战力/利益链）。

去 AI 味铁律

写手 agent 内置 5 条强制去 AI 味规则：

  • 叙述者不替读者下结论 — 行为传达意图，不直说
  • 禁止分析报告式语言 — "核心动机""信息边界"等推理术语禁入正文
  • AI 标记词限频 — 仿佛/忽然/竟然/不禁等每 3000 字不超过 1 次
  • 意象渲染限两轮 — 同一意象第三次出现必须切入新信息
  • 方法论术语隔离 — 六步走心理分析的术语只在内部推理用，不入正文

每个题材还有专属语言铁律（带 ✗→✓ 对比示例），从源头限制 AI 味。

内置创作规则体系

通用层覆盖 6 个维度：

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

每本书还有自己的 book_rules.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 等 AI Agent 通过 exec 调用，也可用于脚本编排。

3. 自然语言 Agent 模式

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 genre list 列出所有题材 profile
inkos genre show <id> 查看题材 profile 详情
inkos genre create <id> 创建自定义题材
inkos genre copy <id> 复制内置 profile 到项目定制
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 等 AI Agent 调用。OpenClaw 通过 exec 工具执行 inkos draft/audit/revise，读取 JSON 结果决定下一步操作。

项目结构

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

TypeScript 单仓库，pnpm workspaces 管理。

路线图

  • 完整管线（雷达 → 建筑师 → 写手 → 审计 → 修订）
  • 长期记忆 + 连续性审计
  • 内置创作规则体系（~25 条通用规则 + 去AI味铁律）
  • 三层规则架构（通用 → 题材 → 单本书）
  • 5 个内置题材 profile（玄幻、仙侠、都市、恐怖、通用）
  • 19 维度连续性审计（按题材自动启用）
  • 题材管理 CLI（genre list/show/create/copy）
  • CLI 全套命令
  • 状态快照 + 章节重写
  • 守护进程模式
  • 通知推送（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