Changelog

v1.3.4

Bug Fixes

依赖版本钉死：固定 @mariozechner/pi-ai / pi-agent-core 到 0.67.1，降低 npm 镜像滞后导致全局安装失败的概率
服务探测与模型列表提速：GET /models 回到快路径，knownModels 服务不再走慢 probe；/models 不可用时会返回服务自己的 knownModels
服务验证更可靠：/models 返回 401/403 时直接短路；服务详情页保存前先走 /test 验 key，页面加载时也会用 /test 校验真实连接状态
完整模型列表返回：服务测试接口不再默认裁成 50 个模型

Improvements

agent 通用文件工具面恢复：edit 回归正常工具面，并新增 write 工具用于创建/覆盖写文件，路径仍限制在 books/ 下
sub_agent 最小控制面扩展：新增 writer.chapterWordCount、reviser.mode、exporter.format、exporter.approvedOnly
修订入口统一：book-mode 下整章修订收敛到 sub_agent(reviser)，减少模型在 revise_chapter 与 sub_agent 之间摇摆

v1.3.3

Bug Fixes

聊天建书标题显式化：agent 建书现在要求显式传入 title，initBook / book.json 直接吃结构化标题，不再允许空标题初始化
真实 EPUB 导出统一：CLI、Studio 下载、共享交互层与 agent exporter 统一复用同一套真实 EPUB 实现，不再出现一条真 EPUB、一条假 HTML、一条未实现的分裂状态
高风险写作动作收口：book-mode agent 对改设定、改名、局部修文、章节重写/精修优先使用 deterministic 工具，不再默认退回脆弱的通用 edit

Improvements

TUI 普通聊天对齐 agent/session：TUI 的普通输入改走本地 agent session 形式，保留少量本地控制命令 fast-path，进一步向 Studio 的交互模型靠拢
写作控制面更清晰：agent prompt 明确区分重操作子代理与高风险 deterministic 写作工具，减少“模型理解了，但工具接不住”这类断层

v1.3.2

Bug Fixes

恢复 architect foundation 输出预算：重新固定 maxTokens: 16384，降低本地模型与 LM Studio 在建书阶段因输出截断导致 foundation 缺段的概率
恢复旧的 OpenAI-compatible 兼容路径：provider=openai + 自定义兼容 baseUrl 不再被错误送入更激进的 custom fetch 路径，Google/Gemma 一类旧兼容场景回归
自定义 Anthropic-compatible 原生 transport：service=custom 且 provider=anthropic 也改走原生请求链，不再强绑 SDK
Windows Studio 启动修复：inkos studio 在 Windows 下不再因绝对路径 loader 被当成非法 ESM URL 而崩溃
Bootstrap 项目回退到 env 配置：空目录 auto-init 后的 Studio 项目，在未配置服务时会回退到全局 .inkos/.env，book create 不再先死在缺 key
统一服务路由真相：config-loader、service-resolver、Studio 服务探测、doctor 统一从同一份 service-presets 读取 provider/api/chatBaseUrl/modelsBaseUrl，减少同一服务在不同链路上各猜一遍的问题

改进

空目录直接启动：inkos / inkos studio 现在会自动初始化最小项目骨架并启动 Studio，不再要求显式先跑 init
Studio 自动探测 transport：服务测试会自动尝试候选模型、chat/responses 与流式开关组合，尽量自动匹配可用配置
doctor 增强：不再只死盯当前单一模型/单一组合，支持多 model、多协议、多流式探测
建书聊天 fresh session：再次进入“创建书籍”时会清空旧对话，不再沿用上一次建书聊天记录
聊天模型选择器搜索：Studio model picker 支持搜索过滤
侧栏刷新更克制：读操作不再触发无意义 sidebar 刷新，只在写操作后刷新
服务保存流程更真实：保存 API Key 后会走真实 /test 探测，而不是只靠 /models

v1.3.1

Bug Fixes

MiniMax baseUrl 修正：从 api.minimax.chat 更正为 api.minimaxi.com（当前 OpenAI 兼容端点）
多服务 baseUrl 隔离：agent 对话中选择非默认服务时，不再泄漏默认服务的 baseUrl（如 moonshot URL 被错误用于 minimax 请求）
resolveServiceModel 始终使用 preset：不再直接使用 pi-ai 内置 model 对象（可能指向国际端点或错误的 API 格式），始终用 preset 的 baseUrl 和 api 格式构造 model
agent 建书后侧边栏刷新：通过 agent 对话建书后，侧边栏书籍列表自动刷新（之前只有 POST /books/create 才广播 book:created）
pnpm dev 并行启动：加 --parallel，解决 core tsc --watch 阻塞 studio 启动的问题

改进

MiniMax knownModels：MiniMax 不支持 GET /models，改为硬编码 7 个模型（M2.7/M2.5/M2.1 及其 highspeed 版本 + M2）
测试连接不再发消息：移除 chat completion 测试，只通过 /models + fallback 验证，秒回
custom 服务 URL 自动补 /v1：https://example.com、https://example.com/、https://example.com/v1 三种写法等价
agent 系统提示词：禁止 emoji、结构化内容用列表/表格、章节索引管理指引

测试

新增回归测试：service-presets（MiniMax baseUrl + knownModels）、service-resolver（preset 覆盖 pi-ai）、normalizeBaseUrl

v1.3.0

Release Focus

Studio 2.0 正式发布。inkos 现在默认直接启动 Studio，本地 Web 工作台成为主入口；TUI 保留为 inkos tui。

新功能

Studio 2.0 默认入口：inkos 直接启动 Studio，首页、服务商管理、写作工作台统一为新的主交互入口
自定义 OpenAI-compatible 服务：Studio 现支持自定义 baseUrl、协议类型（chat / responses）与流式开关，兼容更多中转站和聚合网关
配置来源切换：Studio 新增 .env 与 Studio 配置的显式切换，不再只能被目录里的 INKOS_LLM_* 被动覆盖
原生 custom transport：对 custom 服务新增原生 fetch 请求链，减少对 SDK 路径的单点依赖，提升兼容性

改进

服务测试更真实：服务页测试不再只测 /models，还会执行最小生成探测，避免“测试连接通过但聊天失败”的假阳性
服务保存流程优化：保存成功后自动返回服务商管理页，顶部首页和返回入口更醒目
密钥回填：服务详情页会重新加载已保存的 key，避免重新打开后误以为 key 丢失
错误可见性增强：Studio 聊天不再用 Acknowledged. 掩盖空回复，会直接显示真实上游错误

Bug Fixes

修复 llm.services + defaultModel + secrets 与运行时加载契约不一致的问题
修复 custom:* 服务在测试连接、模型列表与 /api/v1/agent 之间链路不一致的问题
修复 inkos 启动 Studio 时因未设置默认模型而直接抛出 llm.model 校验错误
修复自定义服务非流式 / SSE 返回被误当作普通 JSON 解析的问题

v1.2.0

Release Focus

统一交互内核——TUI、Studio、inkos interact、OpenClaw Skill 共享同一套自然语言理解和执行运行时。

新功能

共享交互运行时（packages/core/src/interaction/）：自然语言路由器（15+ intent）、会话管理、编辑事务控制器、事件追踪、阶段遥测
Ink TUI 仪表盘：inkos 直接进入全屏 Ink + React 仪表盘，对话式创作，slash 命令 Tab 补全，主题动效（writing/auditing/revising/planning 各有独立动画），i18n 中英双语
Studio 助手面板：右侧 AI 助手接入共享交互内核，自然语言操作书籍（写章、改名、审计、导出），SSE 实时状态推送，执行阶段图标
对话式建书：通过 Studio 助手自然语言对话逐步构思书籍概念、设定、目标章数，草稿就绪后一键创建
全书实体改名：把林烬改成张三 / /rename 林烬 => 张三，全量扫描章节 + 真相文件一次替换
单章文本替换：/replace 5 旧文本 => 新文本，精确修补指定章节
inkos interact --json：共享交互 JSON 入口，返回 request / response / session / events，供 OpenClaw 和外部 Agent 直接调用
Thinking 模型温度夹制（PR #174）：kimi-k2.5 等 thinking 模型自动 temperature=1，兼容 per-call 温度调参，每模型只 warn 一次

改进

Studio ChatBar 去重：executeCommand() 提取公共逻辑，消除 handleSubmit/handleQuickCommand 80 行重复
Studio ChatBar SSE effect 用 loadingRef 替代 stale closure
Studio 下拉菜单 z-index 修复：移除 paper-sheet 的 transform（消除 stacking context），菜单打开时 card 提升 z-50
Studio agent 响应修复：使用 result.responseText 而非 session.messages.at(-1)
TUI 主题扩展：语义色（成功/错误/活跃/空闲）+ 角色色（用户/助手/系统）
TUI 状态徽标：✓ 完成 / ✗ 失败 / ✎ 写作 / ◇ 规划 / ◈ 等待决策
TUI i18n 修复：stageLabels 移入 TuiCopy，消除 hardcoded 状态字符串
Studio 死代码清理（PR #176）：移除未使用的 shadcn 组件、dotenv、shadcn、tw-animate-css、class-variance-authority，-2800 行

Bug Fixes

Studio ChatBar 助手回复丢失：session 历史覆盖导致 response 被静默丢弃
Studio BookMenu 下拉被下层 card 遮挡：fadeIn 动画的 transform 创建 stacking context
Studio GenreManager 用 window.confirm 替换为 ConfirmDialog
Studio BookDetail Nav toTruth 类型断言 hack 修复
Studio ChapterReader/Dashboard approve/reject 缺失错误处理
ChatBar curly quote 编码导致 esbuild 解析失败

v1.1.1

Release Focus

回退到稳定的 v6 + bugfix 主线，替换掉不稳定的 v8 最新版本

Bug Fixes

#151 — Architect section 解析支持 book-rules / Book Rules / 全角冒号等标题漂移，不再因 book_rules 区块轻微变形而创建失败
#152 — State validator 改为 fail-closed：空响应直接报错，并恢复多行 JSON 平衡提取，避免 passed 字段丢失时被误判
#154 — 后写规则增加正文章节号指称检测，拦截 第33章 / Chapter 33 一类叙述
#155 — repair-state 支持对最新 state-degraded 章节进行同章重算，不再报 delta chapter N goes backwards

Improvements

ai-tells / sensitive-words 增加中英双语规则路径，英文书修订链不再混入中文 issue
import / continuation / series 的 prompt 与语言传递补齐，foundation reviewer 结果能更稳定回灌
reviser 修订链重新接入 hookDebtBlock，局部修订时能看到 hook 债务证据

v1.1.0

写作管线全面升级。通过 Meta-Harness 方法论驱动的多轮 autoresearch 实验，从零模式质量从 75 分提升至 92 分，同人模式从 39 分提升至 82+ 分。

新功能

Foundation Reviewer：建书时新增独立审核 Agent，5 维度百分制打分（原作 DNA 保留、新叙事空间、核心冲突、开篇节奏、节奏可行性），不达 80 分自动驳回并将审核意见反馈给 Architect 重新生成
新时空要求：同人模式（canon/au/ooc/cp）必须设计原创分岔点，不允许复述原作剧情
Hook Seed Excerpt：伏笔回收时，Composer 从 chapter_summaries 提取原始种子场景的原文片段注入 Writer 上下文，替代了复杂的 lifecycle pressure 系统
Review Reject 回滚：inkos review reject 回滚 state 到被拒章节之前的快照，丢弃下游章节和记忆索引
State Validation Recovery：state 校验失败自动重试 settler，仍失败则降级保存，支持 inkos write repair-state 手动修复
Audit Drift 隔离：审计纠偏写入独立的 audit_drift.md，不再追加到 current_state.md
标题坍缩修复：检测近期标题主题聚集，从正文提取新关键词重生标题
Hook 预算提示：活跃伏笔 ≥10 时显示预算警告，引导优先回收旧债
章节结尾摘要：提取最近 3 章结尾句注入上下文，防止结构性重复
情绪/节奏检测：mood 单调和标题聚集检测，序列级 warning 不计入修订 blockingCount
同人风格提取：fanfic init 和 import chapters 自动生成 style_guide.md + style_profile.json
Governed 路径补全：续写/同人的 parent_canon.md 和 fanfic_canon.md 通过 Governed 路径注入 Writer
自定义 HTTP Headers：INKOS_LLM_HEADERS 环境变量注入自定义 HTTP 头

Bug Fixes

章节号污染修复：叙事文本中的数字不再被误解析为章节进度
hook 排序修复：mustAdvance 从降序修正为升序（选最久未推进的）
Outline 匹配修复：支持章节范围格式，防止 Chapter 1 误匹配 Chapter 10
approve 不覆盖快照、style 提取 graceful degrade、Studio 热加载 LLM 配置、主题持久化

v1.0.2

Bug Fixes

#127 — 修复 Studio Web 创建书籍时的误报失败：后台仍在异步创建时，前端延长等待窗口，不再过早提示 Book not found
段落碎片检测忽略纯对话行，减少误报

v1.0.0

InkOS Studio + 稳定性加固。从 CLI 工具升级为 CLI + Web 工作台。

InkOS Studio

inkos studio 启动本地 Web 工作台（Vite + React + Hono，默认端口 4567）
书籍管理：创建、删除、导出（TXT/MD/EPUB）、配置
章节审阅与编辑：批准/拒绝、行内编辑、多模式修订（polish/spot-fix/rewrite/anti-detect）
实时写作进度：SSE 推送生成状态
市场雷达：AI 驱动的平台/题材趋势分析
数据分析：字数统计、审计通过率、章节排名、token 用量
AI 检测：扫描章节 AI 生成痕迹
文风分析与导入：分析参考文本、注入写作风格
题材管理：创建/自定义题材（疲劳词、节奏规则、审计维度）
守护进程控制：启停后台写作、查看事件日志
真相文件编辑器：按书查看和编辑知识库
配置编辑器：LLM 提供商、模型路由、通知

Bug Fixes

unknown hook 在 resolve/defer 时不再抛异常，改为跳过
Studio 创建书后等待完成再路由跳转
Studio 异步创建失败时错误暴露给用户
validator false positive：只在硬矛盾时 fail，减少误报

Chore

清理 studio 合并带入的无关文件（.playwright-cli/、.superpowers/、推广文档）
untrack docs/ 和 autoresearch/，加入 .gitignore
SKILL.md 升级到 v2.2.0，新增 Studio workflow section
三语 README 更新 Studio 发布公告和路线图

v0.6.3

Bug Fixes

#113/#109 — StateValidator JSON 解析从贪婪正则改为平衡括号解析器，LLM 追加 markdown 不再导致解析失败
#114 — status 命令章节数改为数实际文件，不再受 poisoned runtime state 影响
#110 — book creation 改为原子操作（临时目录 → rename），失败不留半成品
#92/#93 — agent 执行层硬限制：write_draft 校验顺序写入、revise_chapter 校验目标章存在、write_truth_file 拦截进度篡改、import_chapters 要求 ≥2 章
#90 — 段落形态检测移到落盘前（覆盖 normalize + auto revise 后的最终内容）
#94 — 标题去重：writer prompt 加约束 + post-write validator 检测 + 自动改名

Improvements

#111 — SKILL.md 补齐 13 个缺失命令（eval, consolidate, write rewrite, book update/delete, plan/compose, studio, fanfic show/refresh, genre create/copy）
#95 — doctor 命令新增版本迁移检测（识别 pre-v0.6 旧格式书籍）
#103 — 补充 rewrite 端到端回归测试（rewrite 2 → next 应为 3）
新增 inkos eval 命令 — 结构化质量评估报告
SKILL.md 版本升级到 2.1.0

v0.6.2

Bug Fixes

伏笔崩溃 (#99/#101/#104) — duplicate active hook family 不再崩溃，改为自动吸收合并；新增 hook 仲裁机制降低重复频率
本地 LLM (#100) — 本地/self-hosted OpenAI-compatible 端点（Ollama 等）不再要求 API key
0 字章节 (#105) — truth rebuild 不再覆盖最终章节内容
章号错误 (#108/#98) — poisoned manifest 在 bootstrap 时自动归一化到真实进度
坏章节写入 (#88) — state validator 空响应直接报错，章节文件保存移到校验通过之后
Provider 400 (#91) — streaming provider fallback 错误提示优化

Improvements

段落质量 (#90) — 新增短段落检测和段落密度漂移 warning
Agent 工具约束 (#92/#93) — agent 工具描述加强边界约束，system prompt 新增禁止性规则
Windows 兼容：tar 命令加 --force-local
README 描述更新，OpenClaw 链接指向 skill 页面

v0.6.1

修复 emphasized hook id 标准化
修复 poisoned runtime state 恢复

v0.6

结构化状态 + 伏笔治理 + 字数治理。

重点解决三个长篇写作的系统性问题：20+ 章后上下文膨胀导致写作变慢甚至 400 报错、伏笔只加不收、回收率接近 0%、字数偏差 50%+ 且 normalizer 可能毁章。

架构

管线升级为 10-agent：新增 Planner、Composer、Observer、Reflector、Normalizer
真相文件迁移到 story/state/*.json（Zod 校验），Settler 输出 JSON delta 而非全量 markdown，旧书自动迁移
Node 22+ 启用 SQLite 时序记忆数据库（story/memory.db），按相关性检索历史事实
createRequire 修复 ESM 下 node:sqlite 加载

伏笔治理

Planner 生成 hookAgenda（mustAdvance / eligibleResolve / staleDebt），排班伏笔推进与回收
Settler working set 扩展为 selected ∪ recent ∪ agenda ∪ dormant debt，堵住检索盲区
hookOps 新增 mention 语义——"只是被提到"不再更新 lastAdvancedChapter，防止假推进
analyzeHookHealth：active 超上限 / 连续无推进 / stale 未处置 / 新开不回收 → 审计 warning
evaluateHookAdmission：重复 hook 家族自动拦截，防止伏笔膨胀

字数治理

LengthSpec（target / softMin-softMax / hardMin-hardMax）+ countingMode（zh_chars / en_words）
审计前 + 修订后各一次归一化机会，不暴力截断
安全网：归一化结果 <25% 原文直接拒绝，stripCommonWrappers 删超 50% 回退原文

质量

跨章重复检测（中文 6 字 ngram / 英文 3 词短语）
对话驱动引导（互动场景优先对话交锋）
English variance brief（反重复短语/开头/结尾注入）
多角色场景阻力要求（至少一轮带阻力的直接交锋）

Bug 修复

用户 INKOS_LLM_MAX_TOKENS 作为全局上限生效（#87）
stripReservedKeys 防止 llm.extra 覆盖 max_tokens / temperature
章节摘要去重：append 前去重 + bootstrap 加载时去重 + JSON 自动修复
consolidate 正则支持全角括号卷边界格式
双语 CLI 输出和日志
Runtime state 中毒恢复

v0.5.0

英文原生写作 + 系统稳定性修复。

英文小说写作

10 个英文题材（LitRPG、Progression Fantasy、Isekai、Romantasy、Sci-Fi、Cozy Fantasy、Tower Climber、Dungeon Core、System Apocalypse、Cultivation）
--lang en 贯穿全管道：Architect 生成英文设定、Writer 英文创作、Settler 英文 truth files、Auditor 英文审计、Reviser 英文修订
英文写后验证器：AI-tell 词检测（delve/tapestry/testament 等）、段落长度、疲劳词
章节标题自动切换：Chapter X: vs 第X章
EPUB 导出 lang 标签适配

系统稳定性

原子写入锁：acquireBookLock 从 stat+write 改为 open("wx") 排他创建，消除竞态
调度器防重入：上一轮写作/雷达未完成时跳过新 tick
修订一致性：revision 链使用 finalContent 而非原始内容，spot-fix 不再丢失
Agent override 客户端隔离：不同 API key 的 agent 不再共用连接
Daemon pid 清理：启动失败时自动删除残留 pid 文件
Studio 启动修复：构建后的 JS 用 node 而非 tsx 启动
Import resume 计数修正：--resume-from 正确报告实际处理数

CLI 增强

inkos book delete <id>：删除书籍及全部数据（--force 跳过确认）
inkos status --chapters：显示每章状态和 failed 章节的 critical issues
审计 JSON 解析容错（#51）
write_truth_file agent 工具（#53）
审计漂移纠偏自动注入状态卡（#52）

v0.4.6

日志系统 + 流式兼容性 + 本地模型容错 + CLI 增强。

结构化日志

新增 Logger 模块：ANSI 颜色输出（INFO=cyan, WARN=yellow, ERROR=red），JSON Lines 文件日志
inkos up 自动写入 inkos.log，守护进程重启后可追溯
write next、draft、up 支持 -q, --quiet 静默模式
LLM 流式心跳：模型思考期间每 30 秒汇报进度（已接收字符数、中文字数）
管线内 17 处 process.stderr.write 替换为结构化 logger

流式兼容性

Stream 自动降级：streaming 失败时自动用 sync 重试，中转站不支持 SSE 也能用
流中断部分内容恢复：已接收 ≥500 字符时返回截断内容而非报错（#21）
错误诊断增强：400/401/403/429/Connection error 附带 baseUrl、model 上下文和排查建议
inkos doctor 失败时给出针对性 hints（检查 baseUrl、试 stream:false、检查 API Key）

Bug 修复

rewrite 快照恢复：particle_ledger.md 从必需改为可选，非数值题材不再报错（#37）
rewrite 第 1 章：initBook 末尾生成 snapshot-0，chapter 1 可正确恢复（#34）
本地小模型空章节：parseCreativeOutput 增加 3 级 fallback（markdown heading → 正文标签 → 最长散文块），Qwen/Ollama 不再返回空内容（#13）

CLI 增强

book create --brief <file>：传入创作简报，Architect 基于你的脑洞生成设定（#43）
write rewrite 第 1 章时正确恢复到 snapshot-0（之前跳过恢复）

v0.4 (v0.4.0 – v0.4.5)

续写 + 番外写作 + 文风仿写 + 多 Provider 路由 + 写后验证器 + 审计闭环加固。

续写已有作品

把已有的小说（单文件或章节目录）导入 InkOS，系统自动拆章、逆向工程生成全套真相文件（世界状态、伏笔、角色矩阵等），之后直接 write next 续写。

inkos import chapters 我的小说 --from 已有章节/        # 从目录导入
inkos import chapters 我的小说 --from 全书.txt          # 从单文件导入（自动按"第X章"拆分）
inkos import chapters 我的小说 --from 全书.txt --split "Chapter\\s+\\d+"  # 自定义分章正则
inkos write next 我的小说                               # 无缝续写

单文件模式自动按 第X章 分章，也支持 --split <regex> 自定义。导入中断可用 --resume-from <n> 断点续导。

番外写作（Spinoff）

基于已有书创建前传、后传、外传或 if 线。番外和正传共享世界观和角色，但有独立剧情线。

inkos import canon 烈焰前传 --from 吞天魔帝   # 导入正传正典到番外
inkos write next 烈焰前传                     # 写手自动读取正典约束

导入后生成 story/parent_canon.md，包含正传的世界规则、角色快照（含信息边界）、关键事件时间线、伏笔状态。写手在动笔前参照正典，审计员自动激活 4 个番外专属维度：

维度	审查内容
正传事件冲突	番外事件是否与正典约束表矛盾
未来信息泄露	角色是否引用了分歧点之后才揭示的信息
世界规则跨书一致性	番外是否违反正传世界规则（力量体系、地理、阵营）
番外伏笔隔离	番外是否越权回收正传伏笔

检测到 parent_canon.md 自动激活，无需额外配置。

文风仿写

喂入真人小说片段，系统提取统计指纹 + 生成风格指南，后续每章自动注入写手 prompt。

inkos style analyze 参考小说.txt                     # 分析：句长、TTR、修辞特征
inkos style import 参考小说.txt 吞天魔帝 --name 某作者  # 导入文风到书

产出两个文件：

style_profile.json — 统计指纹（句长分布、段落长度、词汇多样性、修辞密度）
style_guide.md — LLM 生成的定性风格指南（节奏、语气、用词偏好、禁忌）

写手每章读取风格指南，审计员在文风维度对照检查。

写后验证器

11 条确定性规则，零 LLM 成本，每章写完立刻触发：

规则	说明
禁止句式	「不是……而是……」
禁止破折号	「——」
转折词密度	仿佛/忽然/竟然等，每 3000 字 ≤ 1 次
高疲劳词	题材疲劳词单章每词 ≤ 1 次
元叙事	编剧旁白式表述
报告术语	分析框架术语不入正文
作者说教	显然/不言而喻等
集体反应	「全场震惊」类套话
连续了字	≥ 6 句连续含「了」
段落过长	≥ 2 个段落超 300 字
本书禁忌	book_rules.md 中的禁令

验证器发现 error 级违规时，自动触发 spot-fix 模式定点修复，不等 LLM 审计。

审计-修订闭环加固

实测发现 rewrite 模式引入 6 倍 AI 标记词，现在：

自动修订模式从 rewrite 改为 spot-fix（只改问题句，不碰其余正文）
修订后对比 AI 标记数，如果修订反而增多 AI 痕迹，丢弃修订保留原文
再审温度锁 0（消除审计随机性，同一章不再出现 0-6 个 critical 的波动）
polish 模式加固边界（禁止增删段落、改人名、加新情节）

多 Provider 路由

不同 agent 可以走不同 API 提供商——不只是换模型名，是完全不同的 API 地址和 Key。例如写手用便宜模型高速出稿，审计员用强模型精审：

inkos config set-model writer gpt-4o-mini                                    # 简单模型覆盖
inkos config set-model auditor gemini-2.5-flash \
  --base-url https://generativelanguage.googleapis.com/v1beta/openai \
  --provider openai \
  --api-key-env GEMINI_API_KEY                                                # 走 Gemini API
inkos config set-model reviser claude-sonnet-4-20250514 \
  --base-url https://api.anthropic.com \
  --provider anthropic \
  --api-key-env ANTHROPIC_API_KEY                                             # 走 Anthropic API
inkos config show-models                                                      # 查看路由全景

每个 agent 独立配置 --base-url、--provider、--api-key-env、--no-stream。未覆盖的 agent 使用项目默认模型。

数据分析

inkos analytics 吞天魔帝          # 审计通过率、高频问题类别、问题最多的章节
inkos analytics 吞天魔帝 --json   # 结构化输出

其他 v0.4 变更

审计维度从 26 扩展到 33（+4 番外维度 + dim 27 敏感词 + dim 32 读者期待管理 + dim 33 大纲偏离检测）
审计员联网搜索：年代考据题材可联网核实真实事件/人物/地理（原生搜索能力）
调度器重写：AI 节奏（默认 15 分钟一轮）、并行书处理、立即重试、每日上限
修订者新增 spot-fix 模式（定点修复）
book_rules.md 的 additionalAuditDimensions 支持中文名称匹配
全部 5 个题材激活 dim 24-26（支线停滞/弧线平坦/节奏单调）
inkos export 支持 --format md、--output <path>、--approved-only
写后验证器「连续了字」阈值从 4 句上调至 6 句（减少中文叙事误报）
安全加固：init/book create/import chapters 防覆盖检查、config set 类型推断 + key 校验、update 防降级、doctor 项目外可测 API、状态显示一致性、genre show 拒绝无效 ID

v0.3

创作规则三层分离 + 跨章记忆 + AIGC 检测 + Webhook。

跨章记忆与写作质量

Writer 每章自动生成摘要、更新支线/情感/角色矩阵，全部追加到真相文件。后续章节加载全量上下文，长线伏笔不再丢失。

真相文件	用途
`chapter_summaries.md`	各章摘要：出场人物、关键事件、状态变化、伏笔动态
`subplot_board.md`	支线进度板：A/B/C 线状态追踪
`emotional_arcs.md`	情感弧线：按角色追踪情绪、触发事件、弧线方向
`character_matrix.md`	角色交互矩阵：相遇记录、信息边界

AIGC 检测

功能	说明
AI 痕迹审计	纯规则检测（不走 LLM）：段落等长、套话密度、公式化转折、列表式结构，自动合并到审计结果
AIGC 检测 API	外部 API 集成（GPTZero / Originality / 自定义端点），`inkos detect` 命令
文风指纹学习	从参考文本提取 StyleProfile（句长、TTR、修辞特征），注入 Writer prompt
反检测改写	ReviserAgent `anti-detect` 模式，检测→改写→重检测循环
检测反馈闭环	`detection_history.json` 记录每次检测/改写结果，`inkos detect --stats` 查看统计

inkos style analyze reference.txt         # 分析参考文本文风
inkos style import reference.txt 吞天魔帝  # 导入文风到书
inkos detect 吞天魔帝 --all               # 全书 AIGC 检测
inkos detect --stats                      # 检测统计

Webhook + 智能调度

管线事件 POST JSON 到配置 URL（HMAC-SHA256 签名），支持事件过滤（chapter-complete、audit-failed、pipeline-error 等）。守护进程增加质量门控：审计失败自动重试（调高 temperature）、连续失败暂停书籍。

题材自定义

内置 5 个题材，每个题材带一套完整的创作规则：章节类型、禁忌清单、疲劳词、语言铁律、审计维度。

题材	自带规则
玄幻	数值系统、战力体系、同质吞噬衰减公式、打脸/升级/收益兑现节奏
仙侠	修炼/悟道节奏、法宝体系、天道规则
都市	年代考据、商战/社交驱动、法律术语年代匹配、无数值系统
恐怖	氛围递进、恐惧层级、克制叙事、无战力审计
通用	最小化兜底

创建书时指定题材，对应规则自动生效：

inkos book create --title "吞天魔帝" --genre xuanhuan

题材规则可以查看、复制到项目中修改、或从零创建：

inkos genre list                      # 查看所有题材
inkos genre show xuanhuan             # 查看玄幻的完整规则
inkos genre copy xuanhuan             # 复制到项目中，随意改
inkos genre create wuxia --name 武侠   # 从零创建新题材

复制到项目后，增删禁忌、调整疲劳词、修改节奏规则、自定义语言铁律——改完下次写章自动生效。

每个题材有专属语言铁律（带 ✗→✓ 示例），写手和审计员同时执行：

玄幻：✗ "火元从12缕增加到24缕" → ✓ "手臂比先前有力了，握拳时指骨发紧"
都市：✗ "迅速分析了当前的债务状况" → ✓ "把那叠皱巴巴的白条翻了三遍"
恐怖：✗ "感到一阵恐惧" → ✓ "后颈的汗毛一根根立起来"

单本书规则

每本书有独立的 book_rules.md，建筑师 agent 创建书时自动生成，也可以随时手改。写在这里的规则注入每一章的 prompt：

protagonist:
  name: 林烬
  personalityLock: ["强势冷静", "能忍能杀", "有脑子不是疯狗"]
  behavioralConstraints: ["不圣母不留手", "对盟友有温度但不煽情"]
numericalSystemOverrides:
  hardCap: 840000000
  resourceTypes: ["微粒", "血脉浓度", "灵石"]
prohibitions:
  - 主角关键时刻心软
  - 无意义后宫暧昧拖剧情
  - 配角戏份喧宾夺主
fatigueWordsOverride: ["瞳孔骤缩", "不可置信"]   # 覆盖题材默认

主角人设锁定、数值上限、自定义禁令、疲劳词覆盖——每本书的规则独立调整，不影响题材模板。

33 维度审计

审计细化为 33 个维度，按题材自动启用对应的子集：

OOC检查、时间线、设定冲突、战力崩坏、数值检查、伏笔、节奏、文风、信息越界、词汇疲劳、利益链断裂、年代考据、配角降智、配角工具人化、爽点虚化、台词失真、流水账、知识库污染、视角一致性、段落等长、套话密度、公式化转折、列表式结构、支线停滞、弧线平坦、节奏单调、敏感词检查、正传事件冲突、未来信息泄露、世界规则跨书一致性、番外伏笔隔离、读者期待管理、大纲偏离检测

dim 20-23（AI 痕迹）+ dim 27（敏感词）由纯规则引擎检测，不消耗 LLM 调用。dim 28-31（番外维度）检测到 parent_canon.md 自动激活。dim 32（读者期待管理）、dim 33（大纲偏离检测）始终开启。

去 AI 味

5 条通用规则 + 每个题材的专属语言规则，控制 AI 标记词密度和叙述习惯：

AI 标记词限频：仿佛/忽然/竟然/不禁/宛如/猛地，每 3000 字 ≤ 1 次
叙述者不替读者下结论，只写动作
禁止分析报告式语言（"核心动机""信息落差"不入正文）
同一意象渲染不超过两轮
方法论术语不入正文

词汇疲劳审计 + AI 痕迹审计（dim 20-23）双重检测。文风指纹注入进一步降低 AI 文本特征。

其他 v0.3 变更

支持 OpenAI + Anthropic 原生 + 所有 OpenAI 兼容接口
修订者支持 polish / rewrite / rework / anti-detect / spot-fix 五种模式
无数值系统的题材不生成资源账本
所有命令支持 --json 结构化输出，OpenClaw / 外部 Agent 可直接解析
book-id 自动检测：项目只有一本书时省略 book-id
inkos update 一键更新、inkos init 支持当前目录初始化
API 错误附带中文诊断提示，inkos doctor 含 API 连通性测试

CHANGELOG.md 34 KB Permalink Cronologia Originale

Changelog

v1.3.4

Bug Fixes

Improvements

v1.3.3

Bug Fixes

Improvements

v1.3.2

Bug Fixes

改进

v1.3.1

Bug Fixes

改进

测试

v1.3.0

Release Focus

新功能

改进

Bug Fixes

v1.2.0

Release Focus

新功能

改进

Bug Fixes

v1.1.1

Release Focus

Bug Fixes

Improvements

v1.1.0

新功能

Bug Fixes

v1.0.2

Bug Fixes

v1.0.0

InkOS Studio

Bug Fixes

Chore

v0.6.3

Bug Fixes

Improvements

v0.6.2

Bug Fixes

Improvements

v0.6.1

v0.6

架构

伏笔治理

字数治理

质量

Bug 修复

v0.5.0

英文小说写作

系统稳定性

CLI 增强

v0.4.6

结构化日志

流式兼容性

Bug 修复

CLI 增强

v0.4 (v0.4.0 – v0.4.5)

续写已有作品

番外写作（Spinoff）

文风仿写

写后验证器

审计-修订闭环加固

多 Provider 路由

数据分析

其他 v0.4 变更

v0.3

跨章记忆与写作质量

AIGC 检测

Webhook + 智能调度

题材自定义

单本书规则

33 维度审计

去 AI 味

其他 v0.3 变更

CHANGELOG.md 34 KB

Permalink Cronologia Originale