Bläddra i källkod

docs: update READMEs to v1, add v1.1.0 changelog, add WeChat group QR

- Replace v0.6 update section with v1 update (Studio + pipeline overhaul) in all three READMEs
- Add WeChat group QR code to Chinese README (before Quick Start)
- Add v1.1.0 changelog entry (Foundation Reviewer, Hook Seed Excerpt, Review Reject rollback, etc.)
Ma 7 månader sedan
förälder
incheckning
d57157a735
5 ändrade filer med 73 tillägg och 47 borttagningar
  1. 29 0
      CHANGELOG.md
  2. 13 16
      README.en.md
  3. 13 16
      README.ja.md
  4. 18 15
      README.md
  5. BIN
      assets/wechat-group.jpg

+ 29 - 0
CHANGELOG.md

@@ -21,6 +21,35 @@
 
 
 ---
 ---
 
 
+## 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
 ## v1.0.2
 
 
 ### Bug Fixes
 ### Bug Fixes

+ 13 - 16
README.en.md

@@ -102,22 +102,19 @@ 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
+### v1 Update
+
+**InkOS Studio + Writing Pipeline Overhaul**
+
+- **InkOS Studio** (v1.0): `inkos studio` launches a local web workbench (Vite + React + Hono). Book management, chapter review & editing, real-time writing progress, market radar, analytics, AI detection, style analysis, genre management, daemon control, truth file editing — everything the CLI does, now visual
+- **Foundation Reviewer** (v1.1): independent review agent at book creation, 5-dimension scoring (canon DNA, new narrative space, core conflict, opening pacing, pacing viability), auto-reject below 80
+- **Hook Seed Excerpt** (v1.1): when resolving hooks, Composer extracts original seed scene excerpts into Writer context so payoff scenes are grounded in concrete narrative
+- **Review Reject Rollback** (v1.1): `inkos review reject` rolls back state to the pre-chapter snapshot, discards downstream chapters and memory index
+- **State Validation Recovery** (v1.1): auto-retries settler on state validation failure, degrades gracefully if still failing, `inkos write repair-state` for manual recovery
+- **Bilingual Import** (v1.1.1): `import chapters` and `fanfic init` support bilingual prompts, auto-detect continuation vs series mode
+- **Chapter Number Anchoring** (v1.1): chapter progress anchored to contiguous durable files only — narrative numbers no longer pollute progress
+- Audit drift isolation, title collapse repair, hook budget hints, chapter ending trail, mood/pacing monotony detection
+- Bilingual AI-tells and sensitive word lists, custom HTTP headers (`INKOS_LLM_HEADERS`)
 
 
 ### Write Your First Book
 ### Write Your First Book
 
 

+ 13 - 16
README.ja.md

@@ -102,22 +102,19 @@ inkos config show-models        # 現在のルーティングを表示
 
 
 明示的なオーバーライドがないエージェントはグローバルモデルにフォールバックします。
 明示的なオーバーライドがないエージェントはグローバルモデルにフォールバックします。
 
 
-### v0.6 アップデート
-
-**構造化ステート + フック管理 + 文字数管理**
-
-長編執筆における3つのシステム的問題に対処:**20章超でのコンテキスト肥大化によるスローダウンと400エラー**(Settler全量注入 → JSONデルタ + 選択的取得)、**フックが蓄積するだけで解決せず、回収率がほぼ0%**(Plannerスケジューリング + Settler盲点修正 + 監査デット追跡)、**文字数乖離50%超とNormalizerによる章破壊**(LengthSpec + セーフティネット)。
-
-- パイプラインが10エージェントにアップグレード:Planner、Composer、Observer、Reflector、Normalizerを追加
-- 真実ファイルが `story/state/*.json` に移行(Zodバリデーション済み);SettlerはフルMarkdownではなくJSONデルタを出力;既存書籍は自動マイグレーション
-- Node 22+ でSQLite時系列メモリデータベースを使用した関連性ベースの取得
-- Plannerが `hookAgenda` を生成してフックの進行と回収をスケジューリング;Settlerのワーキングセットを拡張して休眠中のデットもカバー
-- 新しい `mention` セマンティクスで偽のフック進行を防止;`analyzeHookHealth` がフックデットを監査;`evaluateHookAdmission` が重複フックをブロック
-- 文字数管理:`LengthSpec` + Normalizerの1パス補正とセーフティネットで破壊的正規化を防止
-- ユーザー設定の `INKOS_LLM_MAX_TOKENS` がグローバルキャップとして機能;`llm.extra` の予約キーは自動除去
-- クロスチャプター反復検出、対話駆動ガイダンス、英語バリアンスブリーフ、マルチキャラクターシーン耐性
-- チャプターサマリーの重複排除、ESM node:sqlite修正、全角括弧サポートの統合
-- バイリンガルCLI出力とログ
+### v1 アップデート
+
+**InkOS Studio + 執筆パイプライン全面アップグレード**
+
+- **InkOS Studio**(v1.0):`inkos studio` でローカルWebワークベンチを起動(Vite + React + Hono)。書籍管理、章レビュー・編集、リアルタイム執筆進捗、マーケットレーダー、データ分析、AI検出、文体分析、ジャンル管理、デーモン制御、真実ファイル編集——CLIの全機能をビジュアル化
+- **Foundation Reviewer**(v1.1):書籍作成時に独立した審査Agent、5次元100点制スコアリング、80点未満は自動却下して再生成
+- **Hook Seed Excerpt**(v1.1):伏線回収時、Composerが原始シーンの原文抜粋をWriter コンテキストに注入、具体的な素材に基づいて回収シーンを執筆
+- **Review Reject ロールバック**(v1.1):`inkos review reject` が却下章の前のスナップショットまでstateをロールバック、下流の章とメモリインデックスを破棄
+- **State Validation Recovery**(v1.1):stateバリデーション失敗時にsettlerを自動リトライ、それでも失敗時は正常降格で保存、`inkos write repair-state` で手動修復
+- **バイリンガルインポート**(v1.1.1):`import chapters` と `fanfic init` がバイリンガルプロンプトに対応、続編/シリーズモードを自動検出
+- **章番号アンカリング**(v1.1):章の進捗は連続した永続ファイルのみを権威ソースとし、叙述テキスト内の数字が進捗を汚染しない
+- 監査ドリフト隔離、タイトル崩壊修復、Hook予算ヒント、章末サマリー、ムード/ペース単調検出
+- AI-tells・センシティブワードのバイリンガル対応、カスタムHTTPヘッダー(`INKOS_LLM_HEADERS`)
 
 
 ### 最初の本を書く
 ### 最初の本を書く
 
 

+ 18 - 15
README.md

@@ -24,6 +24,12 @@ AI Agent 自主写小说——写、审、改,全程接管。覆盖玄幻、
 
 
 **Native English novel writing now supported!** Set `--lang en` to write in English. See [English README](README.en.md) for details.
 **Native English novel writing now supported!** Set `--lang en` to write in English. See [English README](README.en.md) for details.
 
 
+## 交流群
+
+<p align="center">
+  <img src="assets/wechat-group.jpg" width="300" alt="微信交流群">
+</p>
+
 ## 快速开始
 ## 快速开始
 
 
 ### 安装
 ### 安装
@@ -98,22 +104,19 @@ inkos config show-models        # 查看当前路由
 
 
 未单独配置的 Agent 自动使用全局模型。
 未单独配置的 Agent 自动使用全局模型。
 
 
-### v0.6 更新
-
-**结构化状态 + 伏笔治理 + 字数治理**
+### v1 更新
 
 
-重点解决三个长篇写作的系统性问题:**20+ 章后上下文膨胀导致写作变慢甚至 400 报错**(Settler 全量注入 → JSON delta + 选择性检索)、**伏笔只加不收、回收率接近 0%**(Planner 排班 + Settler 盲区修补 + 审计追债)、**字数偏差 50%+ 且 normalizer 可能毁章**(LengthSpec + 安全网)。
+**InkOS Studio + 写作管线全面升级**
 
 
-- 管线升级为 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 输出和日志
+- **InkOS Studio**(v1.0):`inkos studio` 启动本地 Web 工作台(Vite + React + Hono)。书籍管理、章节审阅编辑、实时写作进度、市场雷达、数据分析、AI 检测、文风分析、题材管理、守护进程控制、真相文件编辑——CLI 能做的,Studio 全部可视化
+- **Foundation Reviewer**(v1.1):建书时新增独立审核 Agent,5 维度百分制打分,不达 80 分自动驳回重新生成
+- **Hook Seed Excerpt**(v1.1):伏笔回收时提取原始种子场景原文片段注入上下文,Writer 基于具体素材写回收场景
+- **Review Reject 回滚**(v1.1):`inkos review reject` 回滚 state 到被拒章节之前的快照,防止坏草稿污染后续生成
+- **State Validation Recovery**(v1.1):state 校验失败自动重试 settler,仍失败则降级保存,支持 `inkos write repair-state` 手动修复
+- **双语导入**(v1.1.1):`import chapters` 和 `fanfic init` 支持双语 prompt,续写/系列模式自动适配语言
+- **章节号锚定**(v1.1):章节进度唯一权威来源为连续章节文件,叙事文本中的数字不再被误解析
+- Audit drift 隔离、标题坍缩修复、Hook 预算提示、章节结尾摘要、情绪/节奏单调检测
+- AI-tells 和敏感词双语支持、自定义 HTTP Headers(`INKOS_LLM_HEADERS`)
 
 
 ### 写第一本书
 ### 写第一本书
 
 
@@ -393,7 +396,7 @@ pnpm test         # 运行测试
 pnpm typecheck    # 类型检查
 pnpm typecheck    # 类型检查
 ```
 ```
 
 
-## 📈 Star History
+## Star History
 
 
 <a href="https://www.star-history.com/#Narcooo/inkos&type=date&legend=top-left">
 <a href="https://www.star-history.com/#Narcooo/inkos&type=date&legend=top-left">
  <picture>
  <picture>

BIN
assets/wechat-group.jpg