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

33 Commits

Author SHA1 Message Date
Yaojia Wang
e9c5502c2d feat(frontend): 底栏瘦身 + 或让 AI 动作行 + 动词范围提示 + 题材去弹窗（UX P1-1/P1-4/P1-5） 2026-07-10 18:00:42 +02:00
Yaojia Wang
9f6cbb5598 refactor(frontend): 右栏去术语——本章参考/AI 写这章会参考/写完后检查，删重复去审稿（UX P1-3） 2026-07-10 18:00:36 +02:00
Yaojia Wang
59d7c75737 feat(frontend): 统一「采用」动词族——替换整章/加到章末/替换这段，弃「回填」（UX P1-2） 2026-07-10 18:00:28 +02:00
Yaojia Wang
ceae24740a feat(frontend): 正文上方常驻 AI 输入条 + 对话记录正名 + 润色提示 + HITL 微文案 
回答用户原话「我怎么和 AI 对话」（docs/design/ux-exploration.md §4 P0-1/2/4/5）。

P0-2 把折叠的「本章写作指令[可选]」原地提升为正文正上方常驻输入条：标题
「告诉 AI 这章想怎么写」、去「可选」徽标、空章默认展开、「AI 写作诉求」→
「你的写作要求」、邀请式 placeholder；发送键即「写本章」（streaming 时切
「停」），复用 composeDirective + 文风/剧情 chips + 流式打字机，不改成聊天气泡。
P0-1 底栏「AI 对话」→「对话记录」（只读日志正名），抽屉标题/aria/空态同改。
P0-4「润色选段」常驻可点，无选区点击弹 toast 提示（去 hover-only title）。
P0-5 输入条旁常驻 HITL 微文案 +「?这是什么」可再发现弹层（非一次性 coach）。
 2026-07-10 17:43:59 +02:00
Yaojia Wang
1185069572 feat(frontend): 润色/整章重写面板内联对话气泡流（就地可见） 
用户反馈：不想每次开「AI 对话」抽屉才看得到对话，要在对话时就地内联可见。
RefinePanel/ChapterRewritePanel 内联渲染 role=log 滚动气泡流（本章 refine/rewrite
+ 其 clarify 往复 ∪ 本轮进行中气泡：流式 token 逐字进气泡、缓冲的 clarify Q&A
亦实时可见），输入框置底像聊天。pending→persisted 无重影（进行中气泡结束即清、
已落库去重）；fail-soft（历史加载失败仍显示本轮实时气泡，不阻塞回炉/重写）；
气泡「再接受/回填」复用既有 DRAFT-only HITL 回调（drift-safe，正文仍只在验收才变）；
clarify gating/abort/停/接受悉数保留。Workbench 改传 conversation + onReaccept。
AiConversationDrawer 保留原样（底栏仍可开，跨章/项目级全量历史浏览）。
 2026-07-10 16:32:10 +02:00
Yaojia Wang
5af45f5034 refactor(frontend): 抽出可复用 ConversationThread + inlineConversation 纯助手 
把 AiConversationDrawer 内联的气泡渲染（Bubble/readOptions/ACCEPT_LABEL）提取为
共享的 ConversationThread 组件，抽屉改为复用之（外观不变，DRY）。新增纯助手
lib/workbench/inlineConversation.ts：mergeInlineThreads（已落库留痕 ∪ 进行中气泡，
按 id 去重 + 复用 groupByThread 定序）、toPendingView（合成未落库气泡，meta._pending/
_streaming UI 标记）、isPendingView/isStreamingView/readSegment，配 9 单测（RED→GREEN）。
为内联对话视图铺路；抽屉行为完全不变。
 2026-07-10 16:31:53 +02:00
Yaojia Wang
33a9b7656c feat(frontend): 五类交互接入 AI 对话留痕 + Workbench 抽屉入口（AC-3） 
- RefinePanel/ChapterRewritePanel：结束后 append [author(意见/答复), ai(产出)]；
  clarify buffer-until-concluded——澄清 Q&A（原意见→反问→答复）缓冲，随最终产出批
  一起落库同 thread；纯放弃不记。refine ai 行 meta 存 version_no+原选段（每版重锚）。
- ContinuePanel：ai-only（续写无作者输入），每候选一条 ai 气泡 meta{candidate_index}。
- GeneratorRunner：成功后 append [author(字段摘要, meta{tool_key,input_fields}),
  ai(渲染预览, meta{tool_key,output_kind})]；空产物不记。lib/toolbox/aiSummary.ts 纯助手+单测。
- InlineToolbox→GeneratorRunner 透传 append+本章号；ToolboxPage 用 silent 直投项目级(chapter_no=null)。
- Workbench：挂 useAiConversation 单实例 + AiConversationDrawer + 底栏「AI 对话」入口（flag 灰度），
  三个 DRAFT-only 再接受回调（替换整章/插入正文/回填选段），成功关抽屉+toast、漂移不盲替换。
 2026-07-09 17:27:14 +02:00
Yaojia Wang
ddf7fa061a feat(frontend): AI 对话核心——视图模型 + 数据/追加 hook + 抽屉（AC-3） 
- lib/workbench/aiConversation.ts：纯视图模型（kind 标签/徽标、bubbleSide、
  按 thread 归组 (created_at,seq) 定序、按作用域分区、接受动作映射）+ 单测。
- lib/workbench/useAiConversation.ts：Workbench 级懒加载 + 批量 append（乐观插入 +
  正位对账 / 失败回滚），fail-soft 绝不 throw 进生成/HITL；silent 直投供工具箱页。
  renderHook 测试覆盖懒加载去重、对账、回滚、silent、项目切换复位。
- components/workbench/AiConversationDrawer.tsx：本章对话 + 项目级生成两段的气泡抽屉，
  克隆 ContextDrawer 的 a11y（role=dialog/log、Esc、focus trap、还原焦点）；
  ai 气泡挂 DRAFT-only 再接受按钮（替换整章/插入正文/回填选段），不绕开验收事务。
- lib/api/types.ts：re-export AiMessage* 码生成名。
 2026-07-09 17:11:09 +02:00
Yaojia Wang
ea9a9d9953 fix(frontend): 澄清反问块加 role=status 向读屏播报（WFW-9 M3，WCAG 4.1.3） 2026-07-08 12:05:54 +02:00
Yaojia Wang
8e29b33a11 feat(frontend): 整章重写接入 AI 反问澄清——useRewriteClarify + ChapterRewritePanel 门控（WFW-9 M2） 2026-07-08 12:00:17 +02:00
Yaojia Wang
6e2b478ca9 fix(frontend): Drawer 焦点还原提取 useRestoreFocus + 回归测试 + DRY（CR-H11） 2026-07-08 11:10:23 +02:00
Yaojia Wang
e30c933c76 feat(frontend): 润色再沟通接入 AI 反问澄清——选项芯片 + 折答案回炉（WFW-9 M1） 
RefinePanel「再沟通」升级为对话式：意见含糊/极短(门控 <10 字，或点「帮我理清方向」)时先调
clarify 预检端点让 AI 反问，渲染 ChoiceChips 选项芯片(+自由输入兜底)；作者选/答后
foldClarifications 把答案折进 instruction，再走既有 refine 回炉(零迁移)。清晰意见直接回炉、
不交往返税；预检失败=放行(useClarify 视 error/异常为 needClarification=false，不阻塞润色)。
新增：lib/workbench/clarify.ts(VM 类型+foldClarifications+needsClarifyGate 纯逻辑) +
useClarify(SSE 外调映射 snake→VM) + ChoiceChips.tsx；gen:api 重生成客户端。
门禁绿：tsc/lint/vitest 654(+clarify/useClarify 18 例)/build/coverage 95.36%。
 2026-07-08 08:47:28 +02:00
Yaojia Wang
542c2abac9 feat(frontend): 整章「再沟通/重写」面板——给意见流式重写整章，版本栈迭代，接受替换正文 
WFW-8 整章级再沟通（前端）。底栏新增「整章重写」→ ChapterRewritePanel：
- 作者给意见 → useChapterRewrite 消费 POST .../rewrite 的 SSE 流（复用 lib/stream/sse
  帧解析），流式 live 展示新一版；
- 每轮完成压入版本栈，「再改一版」以最新版为 prior_draft + 新意见迭代（多轮对话式）；
- 接受某版才「替换整章正文」落草稿（HITL，AI 绝不静默覆盖）；停/错误/网络异常均归一处理。
四张 AI 结果卡（润色/续写/工具箱/整章重写）互斥。gen:api 重生成 TS 客户端。
门禁绿：tsc/lint/vitest 636（+7 useChapterRewrite）/build/coverage 95.36%。
 2026-07-08 07:12:04 +02:00
Yaojia Wang
3dd7d2861f feat(frontend): 写作工作台补齐三项——内容感知书名 / 上下文速查抽屉 / genre采集 
写作工作台重构剩余 3 项（多 agent 并行构建各自新文件，主线统一集成）：

- WFW-5 内容感知书名（#6）：buildManuscriptExcerpt 取正文首尾摘录（硬上界控 token）；
  GeneratorRunner 加 manuscriptText，有 brief 字段时出现「用当前正文」按钮把摘录填入
  brief，让 book-title 等据正文反推。纯前端零后端；HITL——只填表单，生成仍需作者触发。
- WFW-6 上下文速查抽屉（#7）：ContextDrawer 视口无关右侧 slide-over，设定库/大纲完整
  只读速查 + 伏笔/规则/文风摘要跳链；底栏「速查」按钮触发。加法式、CONTEXT_DRAWER_ENABLED
  一键回滚、旧侧栏/全宽页路由全保留。
- WFW-7 genre 采集 + 无大纲降级：项目无题材时首次写章前弹 GenrePicker 采集（临时并入
  本次 directive 不落库）；chapters 为空时编辑器显式提示「尚无大纲，将按设定自由生成」。

各项 TDD：manuscriptExcerpt/useGenreGate/contextDrawer/useContextDrawer 共 32 新单测。
门禁全绿：vitest 629 / tsc / lint / build / coverage 95.43%。
 2026-07-07 20:44:09 +02:00
Yaojia Wang
44b0b8a7f0 feat(frontend): AI写作三槽——文风 / 剧情需求 / 自定义要求，写章前按需组合 
Phase 2（写作工作台重构）：把写章指令升级为三槽——文风预设 + 新增剧情需求预设
（打脸反转/章末钩子/高潮/转折/扮猪吃虎，源自 plan §4.2 分类法，tianyayu6/oh-story MIT）
+ 自定义自由文本。三者经 composeDirective 合并为单条 directive→volatile（MVP 纯前端、
零契约、不动 write_craft.md 字节，金标准零回归）。DirectivePanel 拆成文风/剧情两组 chips。
 2026-07-07 19:51:19 +02:00
Yaojia Wang
04f4785292 feat(frontend): 编辑器内联工具箱——就地调生成器(含金手指)，结果一键插入正文 
Phase 1（写作工作台重构）：编辑器「工具箱」按钮打开内联面板，不离开写作界面即可调用
全部生成器（含金手指——后端 golden-finger 早已齐全，此处首次露出）。复用 GeneratorRunner，
为其加可选 onInsertText：文本类产物（开篇/简介/续写/扩写等）点「插入正文」直接追加到章末，
可入库类仍走既有 ingest。useToolboxTools 客户端拉描述符（已单测）。润色/续写/工具箱三卡互斥。
 2026-07-07 19:48:13 +02:00
Yaojia Wang
9195cf36f3 feat(frontend): 编辑器内「续写」——读本章前文生成多候选，点选插入正文 
Phase 1（写作工作台重构）：编辑器「续写」按钮复用 continue 生成器（with_prior_chapter
自动读该章已写正文承接），每次产出一条候选并累加成多候选（useContinue，已单测），
「再来一个」可多生成几版；作者点某条「插入正文」才追加到章末（HITL，不静默写入）。
续写前 flush 自动保存，确保读到最新草稿。润色/续写结果卡互斥不并占。
 2026-07-07 19:41:57 +02:00
Yaojia Wang
2f0b84191a feat(frontend): 编辑器内「润色 / 再沟通」——选段回炉 + 追加意见迭代出版本栈，接受回填 
Phase 1（写作工作台重构）：编辑器选中一段即可「润色选段」，复用同步 /refine 回炉
（只读、不写库，守不变量 #3）；不满意可「再沟通」——以上一版产出为输入 + 作者新意见
再改一版，形成版本栈（useRefine，已单测）。接受回填按内容重锚落回草稿，原文已变则
提示重选、绝不盲替换（applyRefinement，已单测）。Editor 上报选区，结果以内联卡片展示。
 2026-07-07 18:26:47 +02:00
Yaojia Wang
69030eacc3 fix(web): 写作台流式/保存 live region + 图标按钮换 lucide 无障碍 + 三栏改 xl 断点 + 手稿字号统一 2026-06-30 08:56:23 +02:00
Yaojia Wang
4afbbe0fe7 fix(web): 注入面板保存失败不再清空已加载实体并支持重试 2026-06-29 16:52:43 +02:00
Yaojia Wang
90a66437d7 feat: improve app ui and project metadata 2026-06-28 07:31:20 +02:00
Yaojia Wang
29265fa0fd feat(web): 审稿改稿闭环——一键采纳/AI改写/正文高亮定位编辑/伏笔确认/草稿自动保存/章节目录 
- 冲突「采纳改法」：有补丁瞬时改入终稿并选中；无补丁但可定位则采纳时调 AI（refiner）重写该段套入；定位不到提示手改
- 正文改为行内高亮叠层编辑器（与页面同底色、随内容增高、无滚动条），点冲突卡/锚点整页滚到并选中+闪烁
- 仅对可在正文定位的冲突显示「跳转」/锚点；locate 支持从 where 引号抽原文，杜绝定位失败刷屏
- 伏笔建议卡：新埋一键登记（预填表单）/ 疑似回收一键标记 CLOSED（复用现有端点）
- 审稿页草稿自动保存（防抖 PUT /draft），与「验收本章」解耦，刷新不丢
- 写作路由带章号 ?chapter=N + 验收成功面板/大纲页「写下一章」入口；写作目录从大纲列出全部章节

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:28:29 +02:00
Yaojia Wang
c51623836f fix+feat(ux): 已存草稿显示已保存(Q6) + AI 推理动画指示器(A) 
- Q6 bug: useAutosave 加 initialSavedText，进页种入已存草稿时初始即「已保存」，修「加载已存草稿却显示尚未保存」的误导。
- A: 新 ThinkingIndicator（三点波动，motion-safe 尊重 reduced-motion）接入审稿进行中/验收中/回炉中三处静态文案，长等待看得见在工作。
 2026-06-21 18:05:55 +02:00
Yaojia Wang
10c0d4bead fix(ux): 修水合告警(扩展注入) + 正文编辑器嵌套滚动条/不铺满 
- layout: html/body 加 suppressHydrationWarning（浏览器扩展水合前注入 class/attr，非本应用 bug）
- Editor: textarea 高度自适应内容 + overflow-hidden，消除内部嵌套滚动条、正文随内容铺满写作区，外层单一滚动条统管
 2026-06-21 17:57:53 +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
8779530806 feat(ux): T4-a 全局 AI 工具条 — 项目页顶部常驻写本章/审稿/大纲/设定库/工具箱 
新 lib/nav/ai-tools.ts (aiToolItems) + components/AiToolbar.tsx 服务端组件；AppShell 顶栏下渲染（仅项目页），用 --chrome CSS 变量统一 chrome 高度，6 个固定高度页改用 calc(100vh-var(--chrome,4rem)) 适配。TDD: ai-tools 测。前端门禁绿: lint/tsc/vitest/build。
 2026-06-20 18:19:46 +02:00
Yaojia Wang
6449c3103a feat(ux): F1 注入面板可控版 — 📌置顶/✕排除/近N章步进器 + 已排除恢复 
- injection.ts 加 override 纯函数（currentOverride/withPinToggled/withExcluded/withRestored/withRecentN/isPinned，钳 1..20）+ author_pin 徽标
- useInjection 加 saving 态 + togglePin/exclude/restore/setRecentN，PUT 后以服务端确定结果为准（不变量 #6）；写失败可读文案、不改本地态（天然回滚）
- ChapterAssistant：每实体置顶/排除按钮 + 「近 N 章」步进器 + 「已排除」恢复区
- 13 新 vitest（override 纯函数）；前端门禁绿（lint/tsc/vitest 183/build）

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 12:01:09 +02:00
Yaojia Wang
9b893a6c61 feat(ux): M1/M2 移动端可用 — 导航汉堡抽屉 + 写作工具条不溢出 
M1 左导航响应式抽屉：抽出 lib/nav/items.ts（条目数据+激活判定，纯逻辑+vitest）
共用于桌面静态侧栏（hidden lg:block）与移动汉堡抽屉。新增通用 Drawer（遮罩/
Esc 关闭/打开聚焦，复用 CommandPalette a11y 模式）+ NavDrawer + NavItems；
LeftNav 改 <lg 隐藏，AppShell 顶栏加汉堡（aria-label 打开导航）。

M2 写作工具条不溢出 + 移动端可达章节/助手：Toolbar 改 flex-wrap，390px 不再
横切「尚未保存」；ChapterList/ChapterAssistant 抽出 *Content，Workbench 经
左/右 Drawer 在 <lg 触达目录/助手。

实景 390px 复验（browse）：汉堡显示/静态导航隐藏/抽屉开合聚焦+Esc、工具条
两行不溢出、助手抽屉真注入面板。门禁：lint/typecheck 干净 · vitest 177 · build OK。
 2026-06-20 11:26:14 +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
b523b4fd21 feat: M1 — 立项→写章草稿(SSE)→自动保存；连一家 provider 
- 薄自建 LLM 网关：OpenAI 兼容适配器(DeepSeek) + instructor 结构化输出 + usage_ledger 记账 + 档位路由
- 记忆服务 assemble：确定性选择(显式+主角+近况) + 渲染卡 + 缓存断点(中性文本)
- LangGraph 写章节点 + Postgres checkpointer + SSE 归一(token/done/error)
- API：立项 + 写章 draft(SSE) + PUT 自动保存 + 提供商凭据(Fernet 加密/测试连接)
- 前端：AppShell + 作品库 + 5 步立项向导 + 写作工作台(流式打字机+自动保存) + 设置页
- M1 E2E：真实 DB + mock 网关零 token 走通闭环
 2026-06-18 11:38:28 +02:00