Jelajahi Sumber

docs: move v0.6 changelog before quick start

Ma 7 bulan lalu
induk
melakukan
70d60d649e
2 mengubah file dengan 34 tambahan dan 38 penghapusan
  1. 17 19
      README.en.md
  2. 17 19
      README.md

+ 17 - 19
README.en.md

@@ -100,6 +100,23 @@ inkos config show-models        # View current routing
 
 
 Agents without explicit overrides fall back to the global model.
 Agents without explicit overrides fall back to the global model.
 
 
+### v0.6 Update
+
+**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
+
 ### Write Your First Book
 ### Write Your First Book
 
 
 English is the default for English genre profiles. Pick a genre and go:
 English is the default for English genre profiles. Pick a genre and go:
@@ -360,25 +377,6 @@ 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.
 `[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
 ## Roadmap
 
 
 - [ ] `packages/studio` Web UI for review and editing (Vite + React + Hono)
 - [ ] `packages/studio` Web UI for review and editing (Vite + React + Hono)

+ 17 - 19
README.md

@@ -96,6 +96,23 @@ inkos config show-models        # 查看当前路由
 
 
 未单独配置的 Agent 自动使用全局模型。
 未单独配置的 Agent 自动使用全局模型。
 
 
+### 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 输出和日志
+
 ### 写第一本书
 ### 写第一本书
 
 
 ```bash
 ```bash
@@ -354,25 +371,6 @@ 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 之前先检查输入治理结果。
 `[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)
 - [ ] `packages/studio` Web UI 审阅编辑界面(Vite + React + Hono)