kai/writer-work-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 登记 WFW-8 整章再沟通/重写——契约 C-Rewrite + PROGRESS 台账

Browse Source 
memory/contracts.md 立 C-Rewrite（POST .../rewrite + RewriteStreamRequest，SSE，只读，
守 #3/#7/#9，无迁移）；PROGRESS 加 WFW-8 行(✅) + 门禁基线更新(前端 vitest 636/cov 95.36%，
后端 mypy 224/pytest 含 test_rewrite_node)。
This commit is contained in:
Yaojia Wang
2026-07-08 07:17:11 +02:00
parent 542c2abac9
commit fb5caa3d89
2 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
PROGRESS.md
View File

@@ -47,7 +47,7 @@
> **背景**：[2026-07-07] 用户对写作体验提 8 点反馈，产品主张升级为 **writing-first 工作台**——进来即写、所有工具/AI 动作从编辑器内按需调用并回填正文、元数据由内容渐进生成。多 agent 工作流（扎根代码→Web+GitHub 调研→三方设计→四镜头对抗评审→定稿）产出 DEV_PLAN（`scratchpad/writing-first-workspace-DEVPLAN.md`，**ephemeral 未入库**；灵感/取舍见 `memory/selectable-write-prompts.md`）。 > **背景**：[2026-07-07] 用户对写作体验提 8 点反馈，产品主张升级为 **writing-first 工作台**——进来即写、所有工具/AI 动作从编辑器内按需调用并回填正文、元数据由内容渐进生成。多 agent 工作流（扎根代码→Web+GitHub 调研→三方设计→四镜头对抗评审→定稿）产出 DEV_PLAN（`scratchpad/writing-first-workspace-DEVPLAN.md`，**ephemeral 未入库**；灵感/取舍见 `memory/selectable-write-prompts.md`）。
> **已拍板决策**：进来即写=**延迟落库**（首次击键才建占位项目 + 列表过滤空稿）；可选提示词 MVP=**纯前端** directive→volatile（不改 `DraftStreamRequest` 契约、不动 `write_craft.md` 字节 → 金标准零回归）；预设 MVP=先只上内置；续写=多候选卡点选插入。 > **已拍板决策**：进来即写=**延迟落库**（首次击键才建占位项目 + 列表过滤空稿）；可选提示词 MVP=**纯前端** directive→volatile（不改 `DraftStreamRequest` 契约、不动 `write_craft.md` 字节 → 金标准零回归）；预设 MVP=先只上内置；续写=多候选卡点选插入。
> **纪律**：全程 TDD 小步提交，回填全守 HITL（AI 绝不 auto-replace，点选/接受才落草稿）；`/refine` 只读不写库（不变量 #3）。**前端门禁全绿**：vitest **629** / lint / tsc / build / coverage **95.43%**。**WFW-0~7 全部交付**（WFW-5/6/7 由多 agent 并行构建各自新文件、主线统一集成，见 commit `3dd7d28`）。**未 push、未开 PR**（等用户示意）。 > **纪律**：全程 TDD 小步提交，回填全守 HITL（AI 绝不 auto-replace，点选/接受才落草稿）；`/refine`、`/rewrite` 只读不写库（不变量 #3）。**门禁全绿**：前端 vitest **636** / lint / tsc / build / coverage **95.36%**；后端 ruff / mypy **224** / pytest（含 `test_rewrite_node`）/ alembic 无漂移。**WFW-0~8 全部交付**（WFW-5/6/7 多 agent 并行 → commit `3dd7d28`；WFW-8 整章重写跨栈 → `6ed9c89`+`542c2ab`，契约 C-Rewrite 见 `memory/contracts.md`）。**未 push、未开 PR**（等用户示意）。
| 任务 | 状态 | 负责 | 依赖 | 反馈# | 备注 | | 任务 | 状态 | 负责 | 依赖 | 反馈# | 备注 |
|---|---|---|---|---|---| |---|---|---|---|---|---|
@@ -59,6 +59,7 @@
| WFW-5 内容感知书名 | ✅ | @frontend | — | #6 | `3dd7d28` 纯前端零后端 MVP：`buildManuscriptExcerpt`(首尾摘录+硬上界) + GeneratorRunner「用当前正文」按钮把摘录填 brief，book-title 据正文反推。**后续更佳版**：后端富化 book-title.md + `with_manuscript` 策略(未做) | | WFW-5 内容感知书名 | ✅ | @frontend | — | #6 | `3dd7d28` 纯前端零后端 MVP：`buildManuscriptExcerpt`(首尾摘录+硬上界) + GeneratorRunner「用当前正文」按钮把摘录填 brief，book-title 据正文反推。**后续更佳版**：后端富化 book-title.md + `with_manuscript` 策略(未做) |
| WFW-6 侧栏 IA 收敛（ContextDrawer） | ✅ | @frontend | — | #7 | `3dd7d28` 加法式 ContextDrawer 右侧速查抽屉 + 底栏「速查」按钮；设定库/大纲**完整只读速查**，伏笔/规则/文风**摘要+跳全宽页**(后续可补真实数据)。`CONTEXT_DRAWER_ENABLED` 一键回滚、旧侧栏/全宽页路由全保留 | | WFW-6 侧栏 IA 收敛（ContextDrawer） | ✅ | @frontend | — | #7 | `3dd7d28` 加法式 ContextDrawer 右侧速查抽屉 + 底栏「速查」按钮；设定库/大纲**完整只读速查**，伏笔/规则/文风**摘要+跳全宽页**(后续可补真实数据)。`CONTEXT_DRAWER_ENABLED` 一键回滚、旧侧栏/全宽页路由全保留 |
| WFW-7 首次 AI 写作前极轻 genre 采集 + 无大纲降级 | ✅ | @frontend | WFW-0 | — | `3dd7d28` 无题材首次写章前弹 GenrePicker(临时并入本次 directive 不落库) + chapters 空时「尚无大纲，将按设定自由生成」提示，杜绝无题材 slop | | WFW-7 首次 AI 写作前极轻 genre 采集 + 无大纲降级 | ✅ | @frontend | WFW-0 | — | `3dd7d28` 无题材首次写章前弹 GenrePicker(临时并入本次 directive 不落库) + chapters 空时「尚无大纲，将按设定自由生成」提示，杜绝无题材 slop |
| WFW-8 整章级「再沟通/重写」（对话式迭代） | ✅ | @backend·@llm·@frontend | — | 新#1 | `6ed9c89`(后端)+`542c2ab`(前端)。后端 SSE `POST .../rewrite`（`rewrite.md` 教条 + `rewrite_node` + `RewriteStreamRequest`，复用 assemble 记忆注入，只读不写库、工具非写节点、守 #3/#7/#9）；前端 `useChapterRewrite`(版本栈)+`ChapterRewritePanel`+底栏「整章重写」：给意见→流式重写整章→多轮迭代→接受某版才替换正文(HITL)。契约 C-Rewrite。用户反馈「整章不满意要跟 AI 交流」 |
--- ---

2
memory/contracts.md
View File

@@ -367,3 +367,5 @@
- [2026-06-18] @llm 改 C1：`Gateway.run()` 现消费 `LlmRequest.output_schema`——`OpenAICompatAdapter.complete` 在 schema 非空时经 **instructor**(`create_with_completion(response_model=...)`) 取已校验 Pydantic 实例并填 `LlmResponse.parsed`；无 schema 时 `parsed is None`、纯文本路径不变；记账仍 **1 条 usage_ledger**/调用（usage 从 raw completion 提取）。`ProviderResult` 新增 `parsed` 字段。结构化路径经可注入 `StructuredClient` Protocol 注 fake（测试不联网）。→ 影响 T2.2（续审节点可直接 `gateway.run(req).parsed`）、未来所有结构化输出 Agent。 - [2026-06-18] @llm 改 C1：`Gateway.run()` 现消费 `LlmRequest.output_schema`——`OpenAICompatAdapter.complete` 在 schema 非空时经 **instructor**(`create_with_completion(response_model=...)`) 取已校验 Pydantic 实例并填 `LlmResponse.parsed`；无 schema 时 `parsed is None`、纯文本路径不变；记账仍 **1 条 usage_ledger**/调用（usage 从 raw completion 提取）。`ProviderResult` 新增 `parsed` 字段。结构化路径经可注入 `StructuredClient` Protocol 注 fake（测试不联网）。→ 影响 T2.2（续审节点可直接 `gateway.run(req).parsed`）、未来所有结构化输出 Agent。
- [2026-07-06] @frontend 前端依赖新增（灵感⑥ 关系图谱缩减版 / D4，**无后端契约变更、无 gen:api、无迁移**）：`apps/web/package.json` 加 `@xyflow/react@^12.11.2`（React Flow，MIT，peer react>=17 兼容 R19）+ `@dagrejs/dagre@^3.0.0`（一次性初始布局，自带 TS 类型）。`pnpm install` 后 `pnpm-workspace.yaml` 被 pnpm 自动追加 `minimumReleaseAgeExclude`（@xyflow/react/@xyflow/system 供应链豁免）+ `pnpm-lock.yaml` 更新。新增 `lib/characters/graphLayout.ts`（纯逻辑：角色+relations→节点/边+dagre 布局，仅用现有 `CharacterCardView.relations={name,kind,note}`——**边按 name-join、kind 作中文标签、节点按 role 上色，无 closeness/阵营**，悬空边跳过并计数）+ `components/characters/RelationshipGraph.tsx`（`'use client'`，经 CodexPage `dynamic(ssr:false)` 加载，显式容器高度 + import RF CSS + prefers-reduced-motion 关 fitView 动画 + 纸感配色）。消费方：无（叶子特性，挂在设定库人物 tab）。 - [2026-07-06] @frontend 前端依赖新增（灵感⑥ 关系图谱缩减版 / D4，**无后端契约变更、无 gen:api、无迁移**）：`apps/web/package.json` 加 `@xyflow/react@^12.11.2`（React Flow，MIT，peer react>=17 兼容 R19）+ `@dagrejs/dagre@^3.0.0`（一次性初始布局，自带 TS 类型）。`pnpm install` 后 `pnpm-workspace.yaml` 被 pnpm 自动追加 `minimumReleaseAgeExclude`（@xyflow/react/@xyflow/system 供应链豁免）+ `pnpm-lock.yaml` 更新。新增 `lib/characters/graphLayout.ts`（纯逻辑：角色+relations→节点/边+dagre 布局，仅用现有 `CharacterCardView.relations={name,kind,note}`——**边按 name-join、kind 作中文标签、节点按 role 上色，无 closeness/阵营**，悬空边跳过并计数）+ `components/characters/RelationshipGraph.tsx`（`'use client'`，经 CodexPage `dynamic(ssr:false)` 加载，显式容器高度 + import RF CSS + prefers-reduced-motion 关 fitView 动画 + 纸感配色）。消费方：无（叶子特性，挂在设定库人物 tab）。
- [2026-07-07] @backend/@llm/@frontend 立 C-Rewrite（WFW-8 整章再沟通/重写）：新增 **`POST /projects/{project_id}/chapters/{chapter_no}/rewrite`**（SSE，text/event-stream，复用 token/done/error 帧契约）← `RewriteStreamRequest{feedback:str(1..4000), prior_draft:str(1..200000)}` → 流式重写整章一版。实现：`prompts/rewrite.md` 教条（非 SPEC，仿 write_craft 经 `load_prompt` 读盘，`test_prompt_loader` doctrine 排除集加 `rewrite`）+ `orchestrator/rewrite_node.py`（`build_rewrite_request` 纯函数 system=[rewrite教条,stable_core] cache 前缀 / input=近况+当前草稿+作者意见 断点后，守不变量 #9；`stream_chapter_rewrite`）+ 端点复用 `assemble()` 记忆注入 + `normalize_deltas`。**只读不写库**（HITL：新版停前端，接受才落，不变量 #3）、**工具非写节点**（不破坏 章=f(outline,state) 纯函数，不变量 #7）、项目不存在触网关前 404。**无 DDL/无迁移**。门禁绿：ruff/mypy(224)/pytest(+test_rewrite_node 5 例)/alembic 无漂移。→ 影响 @frontend（已 `pnpm gen:api`；`useChapterRewrite` SSE hook + `ChapterRewritePanel` 版本栈 + Workbench「整章重写」入口）。