kai/writer-work-flow
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
144 Commits 1 Branch 0 Tags
5c02792e5f72ae8717e27df98fe1dee6cf18d1dc
Commit Graph

26 Commits

Author SHA1 Message Date
Yaojia Wang
e1a24a2c2c fix(backend): API 文本输入加 max_length + 请求体大小中间件（CR-H9） 2026-07-08 10:53:44 +02:00
Yaojia Wang
c69e613c97 docs: 登记 WFW-9 M1 AI 反问澄清——契约 C-Clarify + PROGRESS 台账 
memory/contracts.md 立 C-Clarify（POST .../refine/clarify + ClarifyDecision，非流式结构化，
analyst，只读，既有 refine 未改，无迁移）；PROGRESS 加 WFW-9 M1 行(✅)，标注 M2/M3 待办。
 2026-07-08 08:49:58 +02:00
Yaojia Wang
fb5caa3d89 docs: 登记 WFW-8 整章再沟通/重写——契约 C-Rewrite + PROGRESS 台账 
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)。
 2026-07-08 07:17:11 +02:00
Yaojia Wang
4977c760d8 docs: PROGRESS 标记 WFW-5/6/7 完成——写作工作台重构全 8 项交付 
WFW-5 内容感知书名 / WFW-6 上下文速查抽屉 / WFW-7 genre采集 均 ✅(commit 3dd7d28)；
门禁基线更新为 vitest 629 / coverage 95.43%。
 2026-07-07 20:45:24 +02:00
Yaojia Wang
351fbc99e8 docs: PROGRESS 登记「写作工作台重构(writing-first)」——WFW-0~4 已交付、WFW-5~7 待办 
新增进行中章节：8 点反馈背景 + 已拍板决策(延迟落库/纯前端预设/内置优先/多候选) +
任务台账（WFW-0 进来即写、WFW-1 润色再沟通、WFW-2 续写、WFW-3 内联工具箱+金手指、
WFW-4 三槽 ✅；WFW-5 内容感知书名、WFW-6 侧栏IA收敛、WFW-7 genre采集 ⬜）。
 2026-07-07 20:16:18 +02:00
Yaojia Wang
3d2a8b8cee feat(web): 角色关系图谱（灵感⑥缩减版/D4） 
设定库人物 tab 新增 React Flow 关系图谱，仅用现有角色读端点数据
（CharacterRelationView={name,kind,note}）：边按 name-join、kind 作中文
标签、节点按 role 上色，无 closeness/阵营（数据不存在，不硬造）。

- lib/characters/graphLayout.ts：纯逻辑（role→分组配色关键词映射 / 节点
  去空重名 / kind→标签+DEFAULT_RELATION_LABEL / 悬空边跳过并计数 / 自指
  跳过 / 互指无向去重 / @dagrejs/dagre 一次性确定性初始坐标、中心→左上、
  不可变更新）+22 单测。
- components/characters/RelationshipGraph.tsx：'use client'，经 CodexPage
  dynamic(ssr:false) 挂载；显式容器高度 + import RF CSS + prefers-reduced-
  motion 关 fitView 动画 + 纸感 CSS 变量配色 + 悬空计数提示。
- 依赖：@xyflow/react@^12.11.2 + @dagrejs/dagre@^3.0.0。

无后端契约变更/迁移/gen:api。门禁：lint/typecheck 干净、vitest 565、
coverage lib 95.4%(graphLayout 97.6%)、build OK。
 2026-07-06 17:38:58 +02:00
Yaojia Wang
7babb4854b feat(web): 角色群像按定位配比生成（role_mix 缩减版） 
- 契约: CharacterGenerateRequest 加 role_mix{定位:数量}，model_validator 归一
  count=各值之和（每项≥1、总和≤12），缺省退回单一 role+count
- @llm: build_character_gen_context/run_character_gen 加 role_mix 参并注入配比块
  （确定性、无时间戳，守 assemble 纯函数）；router 穿参
- character-gen.md 加"按配比严格分配 role"纪律 + regen prompt_hashes 金标准
- 前端: sanitizeRoleMix/roleMixTotal + buildCharacterGenerateRequest 第4参 +
  useCharacterGen 穿参 + RoleMixEditor + CharacterGenerator 单一/配比双模
 2026-07-06 17:24:16 +02:00
Yaojia Wang
72b3c81146 feat(review): 人物塑造 advisory 审（第五审，仅建议不阻断验收） 
写→审链新增第五审「人物塑造」（灵感③/D2）：advisory 单维——仅建议、不阻断
验收（不进 conflicts、不碰 assert_conflicts_resolved、不入 REVIEW_RESERVED_NAMES）；
只做人物塑造、不做氛围。

- SPEC characterization_spec（analyst，reads=("characters",)，writes=()）+
  prompts/characterization.md（只读、显式忽略文本长度与辞藻华丽度、引用逐字片段+置信度）
- schema CharacterizationReview{issues[...]}（全字段默认值守解析韧性）+ 注册 catalog
- 计数三处 22→23 + regen prompt_hashes.json（仅加一条）
- DB chapter_reviews 加 characterization JSONB nullable 列（迁移 f6a7b8c9d0e1）
- 接线：graph REVIEW_SPECS 追加 · chain ReviewRecordRepo · collect(extract/record) ·
  review_repo(Protocol/Sql/_to_view/ReviewView) · sse(event/factory/section) · normalize 自动纳入
- 契约 ReviewHistoryItem 加 characterization（gen:api 已重生成）
- 前端 sse/history/useReviewStream + CharacterizationPanel（只展示无裁决 UI、置信度降序+低置信折叠）+ ReviewReport 挂面板
- 测试 test_characterization_does_not_block_accept + 计数/golden + collect/normalize + 前端 reducer/normalize/parse

守不变量 #2/#3/#9；依赖 ⑧（motive/appearance 作客观锚点）。
 2026-07-06 17:08:38 +02:00
Yaojia Wang
02d19019f6 feat(web): AI 立项方案生成+预填（种子门控 + 按字段接受） 
向导阶段（project 未建）一键推演结构化书级蓝图预填立项向导。

- 新 SPEC project_plan_spec（analyst 档，纯预览 reads/writes=()）+ schema
  ProjectPlanResult（书名候选 + 时空背景/叙事结构/故事核心/结局设计/基调，
  全字段默认值守解析韧性）+ 注册 SCHEMA_CATALOG；计数三处 21→22 + regen golden。
- 端点 POST /skills/project-plan/generate（不带 project 前缀，绕开 toolbox 404）：
  请求体序列化向导草稿为 project_context，复用 build_brief_context + run_generator；
  种子门控（缺 genre/logline→422）；请求 schema 加 max_length 上界。
- run_generator/_build_request 的 project_id 放宽 uuid.UUID|None（向导无 project）。
- 前端 wizard.ts 加 mapPlanResultToWizardForm（错配字段折进 premise 不静默丢）+
  applyPlanPatch（仅回填空字段、保护已编辑）+ useProjectPlan hook + PlanAssistant。
 2026-07-06 16:26:08 +02:00
Yaojia Wang
dd80b6815d fix: address ui review follow-ups 2026-06-29 12:06:04 +02:00
Yaojia Wang
90a66437d7 feat: improve app ui and project metadata 2026-06-28 07:31:20 +02:00
Yaojia Wang
3bd464d400 docs: 登记 QA-CR 全项目 code review 整改批（21 项任务表） 2026-06-27 06:35:55 +02:00
Yaojia Wang
0021426f09 docs(prompt-mgmt): 方案A 协同回写 + 补声明 structlog 依赖 
- memory/contracts.md：立 C6-ext（load_prompt/SPECS/SCHEMA_CATALOG/
  REVIEW_RESERVED_NAMES/SpecResolver + 打包契约）+ 变更日志一笔
- memory/decisions.md：方案A 决策（运行时值金标准/尾换行方案B/守卫前移/
  schema 留 Python/同一实例）
- memory/gotchas.md：spec.name 连字符命名 / 改稿须重生成金标准 /
  .gitattributes 完整嵌套路径 / wheel artifacts 带 .md / structlog 补声明 /
  SpecResolver 零 DB + 精确匹配
- PROGRESS.md：已封板「Prompt 管理重构 + 全量重写」波次
- ARCHITECTURE.md §5.1：补 prompt 外置 + SPECS/SCHEMA_CATALOG/SpecResolver，
  内置 agent 计数 8→21
- packages/{llm_gateway,core}/pyproject.toml：补声明 structlog>=24.1
  （原直接 import 未声明，靠 apps/api 传递；裸装 import ww_agents 会缺）
 2026-06-24 08:25:26 +02:00
Yaojia Wang
9627845abc docs(chain): 补 PROGRESS 台账 — Chain Workflow 交付/交叉评审/CRITICAL修复/合并汇总 + 出口 + 剩余下一步 2026-06-23 18:40:20 +02:00
Yaojia Wang
29349dc7ee feat(api): C2 多章链 服务+端点+schema+checkpointer 接线 
承 C1 链图（build_chain_graph），落地多章工作流链的 apps/api 壳：
- 3 端点 routers/chain.py：POST .../chains/{key}/run→202 ChainRunAccepted；
  POST .../chains/runs/{job_id}/resume→202；GET /jobs/{id} 复用。校验：
  count 1..50→422、未知 chain_key→404、resume 非 awaiting→409、无凭据→503。
- schemas/chain.py：ChainRunRequest/ChainRunAccepted/ChainResumeRequest
  （ConflictDecision 复用 schemas/projects）。
- services/chain_runner.py：run_chain_job 仿 run_job 壳自建独立 session 驱动链图
  （set_running→ainvoke→据 __interrupt__ 置 awaiting_input/done/failed）；
  build_accept_op 在 apps/api 装配验收事务闭包注入图节点（守 #3/#4）；
  token 不入 result/日志。
- services/chain_deps.py：get_checkpointer_factory（运行时 AsyncPostgresSaver
  上下文 / 测试 MemorySaver）。
- 零迁移（设计 §7）：复用 jobs，新增 status="awaiting_input" + JobRepo.set_awaiting，
  awaiting 章经 result.awaiting_chapter；新错误码 ErrorCode.CONFLICT(409)。
- project_deps：build_chain_gateway/get_chain_gateway（按请求 tier writer/analyst/light
  分派——单档网关恒返该档会错路由 review/digest）+ get_digest_gateway_builder。

单测 apps/api/tests/test_chain.py 12 用例（mock 网关 + MemorySaver + fake session/
accept_op，无 DB/无网络/无真 LLM）：run/resume→202、未知 key 404、count 越界 422、
resume 非 awaiting 409、run_chain_job 无冲突→done、冲突→awaiting→resume→done、
错误脱敏、accept_op 冲突缺判→CONFLICT_UNRESOLVED。

门禁绿：ruff/format 干净 · mypy 193 Success · alembic 无漂移 · pytest 600 passed。
守不变量 #1/#3/#4/#5/#9。唯一新增 DDL（langgraph 检查点表）= C3 迁移。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 17:12:53 +02:00
Yaojia Wang
f43ccd293f feat(toolbox): T6 创作工具箱通用生成器框架 — 8 新生成器 + 声明驱动落地页 + P2 收尾 
通用执行路径驱动全部生成器（"加生成器=加一份声明"）：
- @llm: ww_agents +7 输出 schema + 7 spec（book-title/blurb/name/golden-finger/
  glossary/opening/fine-outline，只声明 tier）+ build_outline_chapter_context
- @backend: ww_skills GeneratorTool 描述符 + TOOLBOX(11) + get_tool；3 通用端点
  GET /skills/toolbox · POST .../skills/{tool_key}/generate(预览不写库,仅记账) ·
  POST .../ingest(复用 continuity 409 + partition_writes 白名单)；纯 context 派发
- @frontend: 工具箱落地页 RSC + 声明驱动 GeneratorRunner + lib/toolbox 纯函数
  + LeftNav「工具箱」+ ⌘K nav-toolbox/action-gen-*；legacy 3 跳现页
- @qa: tests/test_t6_toolbox_e2e.py 5 用例真 pg + mock 网关零 token，无端点 bug
- P2 收尾: 限流→decisions.md 记延后(单用户原型)；noopener/Committable 早已修

守不变量 #2(只声明 tier)/#3(预览不写库,入库经验收 gate)/#9(缓存前缀)。无 DB 迁移。
门禁绿: 后端 ruff/format/mypy 195/alembic 无漂移/pytest 583；前端 lint/tsc/vitest 279/build。
spec 回写 PRODUCT_SPEC §7 + ARCHITECTURE §7.2 端点表。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 20:37:55 +02:00
Yaojia Wang
cc0aabdd9a feat(ux): T4-b 前端 — 本章指令框 + 风格快捷预设传入 draft 生成 
新 lib/workbench/directive.ts (STYLE_PRESETS + composeDirective 纯函数+测)；useDraftStream.start 加 directive 参数（非空时 POST JSON body）；Workbench 加「本章指令」textarea + 风格预设 chips，写本章时 composeDirective 传入。TDD: directive 测。前端门禁绿。docs(progress): 记 Tier4 完成。
 2026-06-20 18:27:47 +02:00
Yaojia Wang
6e5d0e88f6 feat(ux): R3 验收前清单 — AcceptPanel「本次将更新」预览 
新 lib/review/accept-preview.ts (buildAcceptPreview)：据现有 client state 列验收前预期项——晋升版次/提炼摘要/写回裁决/伏笔到期扫描/伏笔建议待登记。仅列后端 accept 事务确实做的事（核对 projects.py accept 端点），不声称改人物 latest_state，带「以验收回执为准」免责。
AcceptPanel 加 foreshadowCount prop + 未阻断时渲染清单；ReviewReport 传 foreshadow.length。
TDD: 4 测。前端门禁绿: lint/tsc/vitest 205/build。
 2026-06-20 16:00:51 +02:00
Yaojia Wang
d81583d5d1 feat(ux): R1+R2 审稿裁决人体学 — 冲突卡内联片段 + 分组/排序/跳下一条/主次按钮 
R1: 新 lib/review/snippet.ts 从 where 解析段号取终稿命中段预览，ConflictCard 渲染引用块。
R2: 新 lib/review/grouping.ts 按 type 分组+严重度排序（仅改显示顺序，保留原始 index 守 conflict_index 不变量），组计数徽标、跳到下一条未裁决（环回）、采纳改法主按钮/忽略手改次级。
TDD: snippet 8 测 + grouping 10 测。前端门禁绿: lint/tsc/vitest 201/build。
 2026-06-20 15:53:45 +02:00
Yaojia Wang
7a1a498683 docs(progress): 记 B0 可控版 + F1 控件完成（注入透明 override） 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 12:03:11 +02:00
Yaojia Wang
e8cccf7389 feat: T6.1 创作工具箱通用生成器框架地基 — 脑洞生成器 + run_generator 
- schemas: Idea/IdeaListResult（脑洞生成器结构化产出，纯预览不入库）
- specs: brainstorm_spec（light 档，reads=[projects] writes=[]）
- orchestrator: build_brief_context（brief_only 策略）+ 通用 run_generator
  （据 spec.output_schema 校验 parsed，不绑定具体类型，任一声明式生成器共用）
- 新增 13 测；两包 ruff/format/mypy 干净、252 passed 无回归

P1 第一波（@llm）：证实「加生成器=加一份声明」。@backend T6.2/T6.3 待续。
 2026-06-20 11:31:59 +02:00
Yaojia Wang
b18310bcb7 feat(ux): F3 流式进度感 + F4 友好错误文案（纯前端） 
F4：新 lib/errors/messages.ts —— friendlyError(code, fallback) 把错误码映射为
中文文案 + 可选「去设置提供商」动作；覆盖后端 ErrorCode + 前端 NETWORK/
STREAM_FAILED；未知码回退原 message。写作页与审稿页错误块改用之，不再暴露
raw error code。+4 vitest。

F3：写作页工具条字数计数器流式时显示「生成中… N 字」+ 朱砂脉冲
（motion-safe:animate-pulse，尊重 prefers-reduced-motion），停后回「字数 N」。
纯 text.length，无后端改动。

前端门禁绿：lint/typecheck/vitest 171/build。无契约变更。
 2026-06-20 11:02:27 +02:00
Yaojia Wang
8058cfb11a feat(ux): B0 注入透明读端点 + F1 写作页右栏真面板 
兑现「看到的=写章用的」信任牌（不变量 #6），替换写作页右栏过时假占位
（「M1 暂未接 / M2 开放」）。

后端：
- GET /projects/{id}/chapters/{no}/injection → InjectionResponse（selected
  实体 + 入选理由 + recent_n）；调既有 assemble() 回放确定性 SelectionTrace，
  无 LLM / 无 commit / 无 DDL；项目不存在→404，无大纲→selected:[]。
- 新 schemas/injection.py；tests/test_injection.py(3 测)。

前端：
- gen:api 纳入端点；纯逻辑 lib/workbench/injection.ts（理由/类型→中文徽标
  + 4 vitest）+ useInjection 读 hook。
- ChapterAssistant 改 client 组件：列出选中实体 + 理由徽标 + 空/载/错三态，
  四审段指向审稿页；Workbench 传 projectId/chapterNo。

门禁：后端 ruff/format/mypy 159/alembic 无漂移/pytest 454；
前端 lint/typecheck/vitest 167/build。

B0 可控版（PUT override pin/排除/recent_n + selection 加参 + draft 同读
override + 持久化）+ F1 可控控件待后续。
 2026-06-20 10:57:03 +02:00
Yaojia Wang
765dbdfbd4 feat: M4 文风 + M5 生成/多provider/Skill + Kimi Code 订阅接入 + 本地联调修复 
M4（文风）: style-auditor 双轨（提取指纹/漂移第四审）+ jobs 长任务框架(zombie reaper) + 回炉 refine + GET /style read-back。
M5（生成+扩展）: worldbuilder/character-gen（入库 continuity 409 gate + partition_writes 白名单 + schema→JSONB 形变）；
  网关多 provider 回退链/熔断/能力降级（Anthropic/Gemini 适配器）；Skill registry + 表权限沙箱 + 规则；
  前端 角色生成器/世界观/Codex/规则页/技能库/⌘K 命令面板。
K1（Kimi Code 订阅接入）: OAuth device-flow（kimi-code）+ 静态 Console key（kimi-code-key）两路径；
  coding 端点 KimiCLI 伪造头（实测 UA allow-list 门禁，缺则 403）+ JSON 模式结构化（thinking ⊥ tool_choice）。
本地联调修复: CORS 中间件；assemble 注入 premise+「写第N章」指令（修空 prompt 400）；
  GET /outline·/draft read-back + 大纲/工作台/审稿页重载；写页 client/server 常量边界 + notFound 健壮化；
  字数 toLocaleString locale 水合；审稿页终稿从已存草稿 seed（修 accept 422）。
门禁: backend ruff/mypy(157)/alembic 无漂移/pytest 451 · frontend lint/tsc/vitest/build。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 10:39:58 +02:00
Yaojia Wang
5fb7bfb1de feat: M3 — 伏笔账本 + 节奏引擎 + 大纲（含并发记账 bugfix） 
- 伏笔账本：纯函数状态机(OPEN/PARTIAL/CLOSED/OVERDUE) + ForeshadowLedger repo；验收后到期扫描(BackgroundTask 自建 session 置 OVERDUE)；登记/状态变更端点
- 节奏 + 三审齐：foreshadow-analyst + pace-checker 并入 LangGraph 并行审(REVIEW_SPECS)，collect 分列落 chapter_reviews(conflicts/foreshadow_sug/pace)，review SSE 加 foreshadow/pace 事件
- 大纲：outliner Agent 产 OutlineResult(含 foreshadow_windows)，POST /outline 逐章 upsert outline 表；GET /foreshadow?status= 看板
- 前端：伏笔四泳道看板(OVERDUE 琥珀) + 大纲编辑器(窗口徽标) + 节奏节拍图(▁▃▅) + 审稿页消费 foreshadow/pace SSE
- bugfix(T3.8)：并行三审共用请求 session 记账触发 'Session is already flushing' → foreshadow/pace 静默丢失；SqlAlchemyLedgerSink.record 改 add-only(靠端点/事务 commit)，加并发回归测试
- M3 E2E：真实 DB + mock 网关零 token 走通 埋设→进展→验收后扫描 OVERDUE→看板 + 大纲含窗口 + 三审齐 SSE/留痕；E2E 暴露并钉住上述 bug
- 门禁绿：mypy 111 / pytest 228(0 xfailed) / alembic 无漂移；前端 gen:api/lint/tsc/vitest 69/build
 2026-06-18 14:21:17 +02:00
Yaojia Wang
68f194a043 feat: M2 — 写→审(一致性)→裁决→验收(事务)；未决冲突禁验收 
- 续审 Agent 声明(AgentSpec) + 结构化输出契约(ContinuityReview/Conflict 五类)
- LangGraph 并行审子图(可扩四审) + collect 落 chapter_reviews 留痕 + review SSE(section/conflict)
- 验收-side Repository：章节 accepted 版本晋升 + digest append-only + 审稿留痕/裁决
- API：review(SSE) + reviews 历史 + accept(单原子事务：晋升 version + 终稿 digest + 裁决留痕)
- 冲突 gate：未决裁决拦截(CONFLICT_UNRESOLVED)；digest 从终稿提炼(不变量#4)
- 前端：审稿报告页 + 冲突就地标注 + 裁决(采纳/忽略/手改) + 未决禁验收 + 「本次将更新」清单
- M2 E2E：真实 DB + 多档位 mock 网关零 token 走通 写→审→裁决→验收→摘要入库
- 多 agent 协同台账(PROGRESS.md) + 共享记忆(memory/contracts·decisions·gotchas)
 2026-06-18 11:38:28 +02:00