docs: add v0.6 changelog to README

This commit is contained in:
Ma
2026-03-26 16:55:07 +08:00
parent 55fcc352de
commit 037fc4962d
2 changed files with 38 additions and 0 deletions
+19
View File
@@ -360,6 +360,25 @@ inkos agent "Create a progression fantasy about a mage who can only use one spel
`[id]` is auto-detected when the project has only one book. All commands support `--json` for structured output. `draft` / `write next` / `plan chapter` / `compose chapter` accept `--context` for steering, and `--words` overrides the target chapter size. `book create` supports `--brief <file>` to pass a creative brief — the Architect builds from your ideas instead of generating from scratch. `plan chapter` / `compose chapter` do not require a live LLM, so you can inspect governed inputs before finishing API setup.
## Changelog
### v0.6
**Structured State + Hook Governance + Length Governance**
Addresses three systemic long-form writing problems: **context bloat after 20+ chapters causing slowdowns and 400 errors** (Settler full injection → JSON delta + selective retrieval), **hooks only accumulate, never resolve, ~0% payoff rate** (Planner scheduling + Settler blind spot fix + audit debt tracking), **word count deviation 50%+ and normalizer destroying chapters** (LengthSpec + safety net).
- Pipeline upgraded to 10 agents: adds Planner, Composer, Observer, Reflector, Normalizer
- Truth files moved to `story/state/*.json` (Zod validated); Settler outputs JSON delta instead of full markdown; legacy books auto-migrate
- SQLite temporal memory database on Node 22+ for relevance-based retrieval
- Planner generates `hookAgenda` to schedule hook advancement and payoff; Settler working set expanded to cover dormant debt
- New `mention` semantics prevents fake hook advancement; `analyzeHookHealth` audits hook debt; `evaluateHookAdmission` blocks duplicate hooks
- Length governance: `LengthSpec` + Normalizer single-pass correction with safety net against destructive normalization
- User `INKOS_LLM_MAX_TOKENS` acts as global cap; reserved keys in `llm.extra` auto-stripped
- Cross-chapter repetition detection, dialogue-driven guidance, English variance brief, multi-character scene resistance
- Chapter summary dedup, ESM node:sqlite fix, consolidate full-width parenthesis support
- Bilingual CLI output and logging
## Roadmap
- [ ] `packages/studio` Web UI for review and editing (Vite + React + Hono)
+19
View File
@@ -354,6 +354,25 @@ inkos agent "先扫描市场趋势,然后根据结果创建一本新书"
`[id]` 参数在项目只有一本书时可省略,自动检测。所有命令支持 `--json` 输出结构化数据。`draft` / `write next` / `plan chapter` / `compose chapter` 支持 `--context` 传入创作指导,`--words` 覆盖每章目标字数。`book create` 支持 `--brief <file>` 传入创作简报(你的脑洞/设定文档),Architect 会基于此生成设定而非凭空创作。`plan chapter` / `compose chapter` 不要求在线 LLM,可在配置 API Key 之前先检查输入治理结果。
## 更新日志
### v0.6
**结构化状态 + 伏笔治理 + 字数治理**
重点解决三个长篇写作的系统性问题:**20+ 章后上下文膨胀导致写作变慢甚至 400 报错**(Settler 全量注入 → JSON delta + 选择性检索)、**伏笔只加不收、回收率接近 0%**(Planner 排班 + Settler 盲区修补 + 审计追债)、**字数偏差 50%+ 且 normalizer 可能毁章**(LengthSpec + 安全网)。
- 管线升级为 10-agent:新增 Planner、Composer、Observer、Reflector、Normalizer
- 真相文件迁移到 `story/state/*.json`(Zod 校验),Settler 输出 JSON delta 而非全量 markdown,旧书自动迁移
- Node 22+ 启用 SQLite 时序记忆数据库,按相关性检索历史事实
- Planner 生成 `hookAgenda` 排班伏笔推进与回收,Settler working set 扩展覆盖 dormant debt
- hookOps 新增 `mention` 语义防止假推进,`analyzeHookHealth` 审计伏笔债务,`evaluateHookAdmission` 拦截重复伏笔
- 字数治理:`LengthSpec` + Normalizer 单 pass 修正,安全网防止归一化毁章
- 用户 `INKOS_LLM_MAX_TOKENS` 作为全局上限生效,`llm.extra` 保留键自动过滤
- 跨章重复检测、对话驱动引导、English variance brief、多角色场景阻力要求
- 章节摘要去重、ESM node:sqlite 修复、consolidate 全角括号兼容
- 双语 CLI 输出和日志
## 路线图
- [ ] `packages/studio` Web UI 审阅编辑界面(Vite + React + Hono)