|
|
@@ -27,7 +27,7 @@ Agent 写小说。写、审、改，全程接管。
|
|
|
|
|
|
用 AI 写小说不是简单的"提示词 + 复制粘贴"。长篇小说很快就会崩：角色记忆混乱、物品凭空出现、同样的形容词每段都在重复、伏笔悄无声息地断掉。InkOS 把这些当工程问题来解决。
|
|
|
|
|
|
-- **三大真相文件** — 追踪世界的真实状态，而非 LLM 的幻觉
|
|
|
+- **长期记忆** — 追踪世界的真实状态，而非 LLM 的幻觉
|
|
|
- **反信息泄漏** — 确保角色只知道他们亲眼见证过的事
|
|
|
- **资源衰减** — 物资会消耗、物品会损坏，没有无限背包
|
|
|
- **词汇疲劳检测** — 在读者发现之前就捕捉过度使用的词语
|
|
|
@@ -35,23 +35,23 @@ Agent 写小说。写、审、改，全程接管。
|
|
|
|
|
|
## 工作原理
|
|
|
|
|
|
-InkOS 为每一章运行多智能体管线：
|
|
|
+每一章由五个 Agent 接力完成：
|
|
|
|
|
|
<p align="center">
|
|
|
<img src="assets/screenshot-pipeline.png" width="800" alt="管线流程图">
|
|
|
</p>
|
|
|
|
|
|
-| 智能体 | 职责 |
|
|
|
-|--------|------|
|
|
|
+| Agent | 职责 |
|
|
|
+|-------|------|
|
|
|
| **雷达 Radar** | 扫描平台趋势和读者偏好，指导故事方向（可插拔，可跳过） |
|
|
|
| **建筑师 Architect** | 规划章节结构：大纲、场景节拍、节奏控制 |
|
|
|
| **写手 Writer** | 根据大纲 + 当前世界状态生成正文 |
|
|
|
-| **连续性审计员 Auditor** | 对照三大真相文件验证草稿 |
|
|
|
+| **连续性审计员 Auditor** | 对照长期记忆验证草稿 |
|
|
|
| **修订者 Reviser** | 修复审计发现的问题 — 关键问题自动修复，其他标记给人工审核 |
|
|
|
|
|
|
如果审计不通过，管线自动进入"修订 → 再审计"循环，直到所有关键问题清零。
|
|
|
|
|
|
-### 三大真相文件
|
|
|
+### 长期记忆
|
|
|
|
|
|
每本书维护三个文件作为唯一事实来源：
|
|
|
|
|
|
@@ -64,12 +64,85 @@ InkOS 为每一章运行多智能体管线：
|
|
|
连续性审计员对照这三个文件检查每一章草稿。如果角色"记起"了从未亲眼见过的事，或者拿出了两章前已经丢失的武器，审计员会捕捉到。
|
|
|
|
|
|
<p align="center">
|
|
|
- <img src="assets/screenshot-state.png" width="800" alt="三大真相文件快照">
|
|
|
+ <img src="assets/screenshot-state.png" width="800" alt="长期记忆快照">
|
|
|
</p>
|
|
|
|
|
|
+### 三层规则架构
|
|
|
+
|
|
|
+InkOS 采用三层规则合并机制，让通用规则、题材规范、单本书定制层层叠加：
|
|
|
+
|
|
|
+```
|
|
|
+通用规则（~25 条，代码内置）
|
|
|
+ ↓ 合并
|
|
|
+题材规范（genres/*.md，按题材定制）
|
|
|
+ ↓ 合并
|
|
|
+单本书规则（books/{id}/story/book_rules.md，逐本定制）
|
|
|
+ ↓ 注入 prompt
|
|
|
+LLM
|
|
|
+```
|
|
|
+
|
|
|
+**通用层** — 人物塑造、叙事技法、逻辑自洽、语言约束、去AI味铁律（共 ~25 条），适用于所有题材。
|
|
|
+
|
|
|
+**题材层** — 内置 5 个题材 profile（玄幻、仙侠、都市、恐怖、通用），每个 profile 定义：
|
|
|
+- 章节类型（战斗章/氛围章/商战章…）
|
|
|
+- 高疲劳词列表 + AI 标记词检测
|
|
|
+- 数值系统 / 战力体系 / 年代考据开关
|
|
|
+- 节奏规则、爽点类型
|
|
|
+- 审计维度启用列表
|
|
|
+- 题材禁忌、语言铁律（带 ✗→✓ 示例）、叙事指导
|
|
|
+
|
|
|
+**书籍层** — 主角人设锁定、题材锁定、数值上限、自定义禁令等，由建筑师 agent 在创建书籍时生成，也可手动编辑。
|
|
|
+
|
|
|
+```bash
|
|
|
+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 味。
|
|
|
+
|
|
|
### 内置创作规则体系
|
|
|
|
|
|
-写手 agent 内置了一套从大量网文创作实践中提炼的规则体系，覆盖 6 个维度：
|
|
|
+通用层覆盖 6 个维度：
|
|
|
|
|
|
- **人物塑造铁律** — 角色行为由"过往经历 + 当前利益 + 性格底色"共同驱动；配角必须有独立动机
|
|
|
- **叙事技法** — Show don't tell、五感代入法、每章结尾必须设置钩子、信息分层植入
|
|
|
@@ -78,7 +151,7 @@ InkOS 为每一章运行多智能体管线：
|
|
|
- **禁忌清单** — 禁止机械降神、反派降智、主角圣母、特定句式和标点
|
|
|
- **数值验算铁律** — 每次数值变动必须从账本取值验算，同质资源有衰减公式
|
|
|
|
|
|
-每本书还有自己的 `style_guide.md`（文风指南）和 `story_bible.md`（世界观设定），由建筑师 agent 在创建书籍时生成。
|
|
|
+每本书还有自己的 `book_rules.md`（写作规则）和 `story_bible.md`（世界观设定），由建筑师 agent 在创建书籍时生成。
|
|
|
|
|
|
## 三种使用模式
|
|
|
|
|
|
@@ -99,9 +172,9 @@ inkos audit 吞天魔帝 31 --json
|
|
|
inkos revise 吞天魔帝 31 --json
|
|
|
```
|
|
|
|
|
|
-每个命令独立执行单一操作，`--json` 输出结构化数据。可被 OpenClaw 等自主智能体通过 `exec` 调用，也可用于脚本编排。
|
|
|
+每个命令独立执行单一操作，`--json` 输出结构化数据。可被 OpenClaw 等 AI Agent 通过 `exec` 调用，也可用于脚本编排。
|
|
|
|
|
|
-### 3. 自然语言 Agent 模式（LLM 自主编排）
|
|
|
+### 3. 自然语言 Agent 模式
|
|
|
|
|
|
```bash
|
|
|
inkos agent "帮我写一本都市修仙，主角是个程序员"
|
|
|
@@ -109,7 +182,7 @@ 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 自主决定调用顺序。
|
|
|
+内置 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 决定调用顺序。
|
|
|
|
|
|
## 快速开始
|
|
|
|
|
|
@@ -159,6 +232,10 @@ inkos up # 守护进程模式
|
|
|
| `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` | 启动/停止守护进程 |
|
|
|
@@ -203,7 +280,7 @@ inkos up # 守护进程模式
|
|
|
|
|
|
### 守护进程模式
|
|
|
|
|
|
-`inkos up` 启动自主循环，按计划写章。管线对非关键问题全自动运行，当审计员标记无法自动修复的问题时暂停等待人工审核。
|
|
|
+`inkos up` 启动后台循环，按计划写章。管线对非关键问题全自动运行，当审计员标记无法自动修复的问题时暂停等待人工审核。
|
|
|
|
|
|
### 通知推送
|
|
|
|
|
|
@@ -211,22 +288,23 @@ inkos up # 守护进程模式
|
|
|
|
|
|
### 外部 Agent 集成
|
|
|
|
|
|
-原子命令 + `--json` 输出让 InkOS 可以被 OpenClaw 等自主智能体调用。OpenClaw 通过 `exec` 工具执行 `inkos draft`/`audit`/`revise`，读取 JSON 结果决定下一步操作。
|
|
|
+原子命令 + `--json` 输出让 InkOS 可以被 OpenClaw 等 AI Agent 调用。OpenClaw 通过 `exec` 工具执行 `inkos draft`/`audit`/`revise`，读取 JSON 结果决定下一步操作。
|
|
|
|
|
|
## 项目结构
|
|
|
|
|
|
```
|
|
|
inkos/
|
|
|
├── packages/
|
|
|
-│ ├── core/ # 智能体运行时、管线、状态管理
|
|
|
+│ ├── core/ # Agent 运行时、管线、状态管理
|
|
|
│ │ ├── 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...
|
|
|
+│ │ ├── 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/ # 网页审阅编辑界面
|
|
|
```
|
|
|
|
|
|
@@ -234,10 +312,14 @@ TypeScript 单仓库，pnpm workspaces 管理。
|
|
|
|
|
|
## 路线图
|
|
|
|
|
|
-- [x] 完整智能体管线（雷达 → 建筑师 → 写手 → 审计 → 修订）
|
|
|
-- [x] 三大真相文件 + 连续性审计
|
|
|
-- [x] 内置创作规则体系
|
|
|
-- [x] CLI 全套命令（15 条）
|
|
|
+- [x] 完整管线（雷达 → 建筑师 → 写手 → 审计 → 修订）
|
|
|
+- [x] 长期记忆 + 连续性审计
|
|
|
+- [x] 内置创作规则体系（~25 条通用规则 + 去AI味铁律）
|
|
|
+- [x] 三层规则架构（通用 → 题材 → 单本书）
|
|
|
+- [x] 5 个内置题材 profile（玄幻、仙侠、都市、恐怖、通用）
|
|
|
+- [x] 19 维度连续性审计（按题材自动启用）
|
|
|
+- [x] 题材管理 CLI（genre list/show/create/copy）
|
|
|
+- [x] CLI 全套命令
|
|
|
- [x] 状态快照 + 章节重写
|
|
|
- [x] 守护进程模式
|
|
|
- [x] 通知推送（Telegram / 飞书 / 企微）
|
majx_mac
