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

89 Commits

Author SHA1 Message Date
Yaojia Wang
9bc0e1f2e6 fix(ui): 修复主题切换按钮的水合不一致（夜读模式刷新报错） 
- 首帧 mode 用默认值（与服务端一致）→ 消除 SSR/客户端 aria-label/图标不一致
- 图标改由 CSS 按 <html data-theme> 显隐（两个图标始终在 DOM）→ 无首帧闪烁、无结构差异
- 挂载后 useEffect 以 localStorage 校正 mode → label 恢复正确文案
- 去掉会锁死服务端陈旧 label 的 suppressHydrationWarning
 2026-07-12 19:02:27 +02:00
Yaojia Wang
40cc3fc9e3 style(ui): 收窄宽屏留白——作品库加宽到 max-w-7xl + xl 四列，写作正文 720→768px 
- PageContainer wide 档 max-w-6xl→max-w-7xl；作品库改用 wide 档
- 作品库卡片网格 lg 三列基础上加 xl:grid-cols-4，宽屏铺满少留白
- 写作台正文测量 720→768px（约 42 中文字/行，仍舒适），收窄两侧空档
 2026-07-12 18:39:01 +02:00
Yaojia Wang
b810a3fa3c feat(foreshadow): 写作台本章伏笔主动提醒（前端） 
- 新增 chapterForeshadow 纯分类：按当前章分 可回收/待回收/已逾期（启用闲置的 isWindowApproaching）
- useChapterForeshadow hook（复用 GET /foreshadow，切章仅重分类不重拉）
- 右栏「本章参考」+ ContextDrawer 伏笔页新增「本章伏笔」实时清单，
  分色展示 + 跳看板链接 + 空态；标注『按已验收进度』
 2026-07-12 17:53:00 +02:00
Yaojia Wang
9aa0cddeaf feat(review): 审稿选章可用——列章端点 + 选章下拉全章可见 + 默认最近章 
- 后端新增 GET /projects/{id}/chapters（列真实存在的章 + has_draft/accepted/reviewed_at），TDD 10 测
- gen:api 重生成 TS 客户端（ChapterListItem）
- 选章下拉去掉 hidden（手机/窄屏也可切章）；选项以真实章为准 + 大纲结构，
  无草稿章置灰（仅当前章例外），覆盖『写过但不在大纲』的章
- 无 ?chapter 时默认落到最近一个有草稿的章，而非硬编码第 1 章
 2026-07-12 17:52:40 +02:00
Yaojia Wang
ac40f48e05 feat(help): 新增应用内帮助页 /help（功能介绍 + 新手上手） 
- 暖深色英雄 + 快速上手三步 + 三个核心理念 + 功能一览(写作/资料库/审阅/工具全局)
  + 顺手小技巧 + 常见问题，全部用设计系统组件与语义 token
- 内容对齐 PRODUCT_SPEC：立项→设定→大纲→写章→四审→验收、四审四维、多提供商网关、单一真相源
- 顶栏新增「帮助」入口（FileQuestion → /help）
 2026-07-11 18:40:35 +02:00
Yaojia Wang
f4bea7f26d feat(ui): 弹层进出场过渡 + 首屏暖深色英雄（P2-6/P4-6） 
- useMountTransition hook（延迟卸载播放退场，尊重 reduced-motion）+ vitest
- Drawer 淡入+滑入进出场；focus/scroll-lock 仍由 open 驱动、focus 键 shouldRender 防丢首焦
- Toast 入场 toast-in 动画（motion-safe）
- P4-6 首屏零作品用 callout 暖深色编辑部英雄（对标 cta-band-dark，不干扰工作库）
  新增 callout/on-callout/on-callout-soft 双主题成对 token
 2026-07-11 14:04:14 +02:00
Yaojia Wang
355a2d11cd feat(ui): Checkbox/Radio 原子件 + 3 处原生控件采用（P2-5） 
- checkboxClass/radioClass（accent-cinnabar + 统一焦点环）+ 同名测试
- Checkbox/Radio 原子件：无 label 只渲染受控原生 input 便于就地替换
- 采用：ChainStarter 链类型单选、GeneratorRunner 入库勾选、CharacterCardItem 角色勾选
 2026-07-11 14:04:01 +02:00
Yaojia Wang
45025c36bf feat(ui): P4 无障碍与打磨收尾 
- P4-1 对比度：muted-soft 提到 WCAG AA 小字(≥4.5:1)于两主题各面
- P4-3 ConflictCard 原文/建议加 Minus/Plus 图标 + sr-only 标签（不靠颜色）
- P4-4 动效：3 处 chevron transition-transform 加 motion-safe 门控
- P4-5 命令面板 ⌘K 键帽提示 + 键盘操作读数 + 空态引导 + mono 快捷键
- P2-8 SegmentedControl 升级 radiogroup（role=radio/aria-checked + 方向键 roving）
 2026-07-11 08:12:36 +02:00
Yaojia Wang
5674158707 feat(ui): 工作台精修 + 拆分（P3-3..7） 
- Workbench.tsx 937→467 行，抽出 AiToolbar/WorkbenchToolbar/MobileContextBar
- P3-3 AI 工具条分组留白 + 眉题 + 主 CTA 凸显
- P3-4 专注写作模式（useFocusMode hook+vitest，隐藏侧栏加宽正文）+ 左双栏面色区分
- P3-5 右栏本章参考小标题去衬线(font-sans) + 空态引导(无标题保 h2→h3 大纲)
- P3-6 底栏信息/操作/状态三区 + TOC 当前章高亮；TOC 状态点因无每章状态数据跳过
- P3-7 展示层流式跟随滚动（不触碰 SSE 逻辑，尊重 reduced-motion）
- AppShell 加可选 hideNav（加法式，默认 false）
 2026-07-11 08:04:56 +02:00
Yaojia Wang
67e30a6863 feat(ui): P3 页面级应用（作品库卡片/空态/加载/设置/次级页） 
- 作品库卡片重设计：书脊封面字块 + 衬线书名 + 一句话故事(缺失给占位) +
  元信息行(题材徽章/StatusDot 待审/mono 时间)，Card tone=card 浮起消塌陷
- EmptyState 中性化 + inline/card/bare 变体 + eyebrow（向后兼容）
- loading 骨架化（Skeleton 拼作品库结构，motion-safe）
- 设置页拆分 ProvidersSettings 489→198 + 5 个子组件，凭据点用 StatusDot
- 次级页(向导/模板/codex/大纲)排版字阶与圆角 token 收敛
 2026-07-11 07:36:32 +02:00
Yaojia Wang
d3e9ae972f feat(ui): 新增 PageContainer 统一页容器（P3-1）+ 作品库采用 2026-07-11 07:26:54 +02:00
Yaojia Wang
83ba47ab8f feat(ui): 共享组件补齐——Card 面色分层 + Button link/lg + 4 原子件 
- Card 新增 tone(panel/card/soft)/flat/interactive；cardClass 兼容旧字符串签名
- Button 新增 link(coral 文字链) 变体与 lg 尺寸
- 新增原子件 Eyebrow(统一眉题) / StatusDot(状态点·读屏可见) /
  Skeleton(motion-safe 占位) / Meter(进度条·progressbar)
- PageHeader/SectionHeader 用 display/title 字阶 + Eyebrow 眉题
 2026-07-11 07:24:08 +02:00
Yaojia Wang
b9f9134748 feat(ui): 补齐分层设计 token 并迁移共享变体（对标 Claude DESIGN.md） 
- 面色阶 surface-soft/card/strong + 文字 5 级 body-strong/body/muted-soft
- 边框 line-soft、coral 状态 cinnabar-active/disabled（按压变深 + 奶油化禁用）
- 圆角刻度 xs..xl/full：按钮 rounded-md、卡片 rounded-lg、徽章 pill
- 排版档 display/title/caption/eyebrow/prose（衬线负字距）
- 动效 token duration-fast/base + ease-standard，transitionUi 常量统一过渡
- 焦点环统一 cinnabar/35；双主题成对定义
 2026-07-11 07:16:00 +02:00
Yaojia Wang
dbece64d4d feat(frontend): 「目录」列可折叠、记忆折叠状态（UX P2-2） 
useChapterListCollapse 用 localStorage 记忆折叠态（SSR 首帧恒展开避免 hydration 不一致）；收起降为带展开按钮的窄轨、让宽给正文，展开时标题旁加收起按钮；三栏栅格据折叠态切列宽，章节列表/高亮/切章导航全保留。
 2026-07-10 18:14:49 +02:00
Yaojia Wang
3c87b01379 feat(frontend): 左栏 10 项按写作/资料库/审阅/更多分组（UX P2-1） 
navSections(projectId?) 纯函数把平铺项目项归为四组，NavItems 复用「本作」小标题模式逐组渲染；链接/路由/激活键不变，工具箱收进「更多」不丢入口。
 2026-07-10 18:14:41 +02:00
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
61a6931bb1 refactor(frontend): 删顶部「AI 工具条」，--chrome 归位 4rem（写作台 UX P0-3） 
顶栏「AI 工具条」5 项全是重复左栏的导航链接，且让「写本章」同时是导航
Link 与生成动作两种相反含义。删掉后导航只归左栏，同时消灭最严重的三重复
+ 假「AI」标签 + 「写本章」双重含义，并省下 48px（--chrome 7rem→4rem）。
死代码 AiToolbar/AiToolbarMoreMenu/ai-tools 全仓仅 AppShell 引用，一并移除。
 2026-07-10 17:43:46 +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
125908ed83 fix(web): ReviewReport flashMark 定时器卸载清理，防泄漏 
flashMark 的 setTimeout 句柄入 ref + 卸载 useEffect 清理，重复触发先清旧定时器；提 FLASH_DURATION_MS 常量。闪烁行为不变。
 2026-07-08 13:27:32 +02:00
Yaojia Wang
47d5558e4a feat(web): NavDrawer 补 aria-controls + ForeshadowCard 语义化 dl/dt/dd（a11y） 
NavDrawer 汉堡按钮补 aria-controls 指向抽屉面板（Drawer 新增可选 id prop，默认 nav-drawer）；ForeshadowCard 的 <dl> 裸 <div> 行改真 <dt>/<dd> 结构，可视文案不变，importance 用 sr-only 标签。行为不变。
 2026-07-08 13:27:32 +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
5c02792e5f fix(frontend): RefineView 取消在途 refine——AbortController 防段切换竞态（CR-H12） 2026-07-08 11:08:21 +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
8389572cbb feat(frontend): 进来即写——落地页「直接开始写」直达空白编辑器，敲字后延迟落库 
Phase 0（写作工作台重构）：新增 /write 草稿编辑器入口，只有敲入实质正文并停顿后
才懒建占位「未命名草稿」项目并种入首章草稿（useDeferredDraft，双重幂等闸 + 草稿落库
非致命降级），随即 replace 换入完整工作台；空进空出不落库，杜绝孤儿草稿。
落地页 CTA 改为「直接开始写」为主、「先立项」（立项向导）为辅。
 2026-07-07 18:18: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
821ace5989 feat(web): 立项新增 基调/结局/视角 三字段（书级常量入 stable_core 缓存前缀） 
灵感计划 §3④ + §4 D 枚举决策：
- projects 表加 tone/ending_type/narrative_pov（Text nullable、无 CHECK，同 genre/structure；
  迁移 e5f6a7b8c9d0 nullable 免 backfill）。
- ProjectCreateRequest/ProjectResponse + domain ProjectCreate/ProjectView 全链路透传（snake_case）。
- 完整 stable_core 链路：ProjectSpecView + SqlProjectSpecRepo.spec + _build_spec_section 渲染进
  「作品蓝本」块——书级常量随书稳定，字节稳定守缓存前缀不变量 #9，绝不入 volatile。
- 前端 wizard.ts 三字段 + 预设数组 TONES/ENDING_TYPES/NARRATIVE_POVS + ProjectWizard 控件与确认页回显。
- 契约变更已 pnpm gen:api + memory/contracts.md 登记。
 2026-07-06 15:59:49 +02:00
Yaojia Wang
acde715515 feat(character): appearance/motive 全栈穿线 + motive/traits 口径重切 
打通 appearance/motive 从生成→schema→契约→落库→前端整条穿线
（DB 列早在初始迁移、此前一直 NULL，无新迁移），并原子重切人物
内驱口径。

- @llm: CharacterCard/character-gen.md 加 appearance/motive（给默认值守
  解析韧性），重切——动机唯一落 motive、traits 只留核心/表层/阴影三层、
  arc 引用 motive；regen prompt_hashes.json 金标准。
- @backend: CharacterCardView + CharacterWriteRepo/SqlCharacterWriteRepo
  （create + update backfill 分支）+ CharacterWriteFields + 路由双向形变
  与 _existing_characters 带上两字段。
- @frontend: pnpm gen:api 重生成 TS 客户端；CharacterCardItem 展示/编辑
  两字段。
- 测试: schema 默认值/解析、动机不双写重切回归、card_to_view 双向、
  ingest 透传、list 暴露、SqlCharacterWriteRepo create/backfill 真 pg 集成。
 2026-07-06 14:36:11 +02:00
Yaojia Wang
6854dac98f feat(web): 命令面板 combobox+可见入口 + sticky 导航壳 + 焦点环统一 + 抽屉锁滚动/关闭按钮 + 主题首帧修复 + 设置徽标/datalist 2026-06-30 08:56:23 +02:00
Yaojia Wang
164e98887e fix(web): 链相位语义色/失败可重试 + 模板填入中文标签/删除可撤销/工具卡文案 + 模板库 PageHeader 2026-06-30 08:56:23 +02:00
Yaojia Wang
6bb3559e25 fix(web): 规则删除按操作隔离 busy(deletingId/adding) + 全空规则页折叠为单一引导 2026-06-30 08:56:23 +02:00
Yaojia Wang
9d67f237a2 feat(web): 生成器 ThinkingIndicator/空结果态/数量校验 + 文风页 PageHeader + Codex 分段控件 + RefineView role 修正 2026-06-30 08:56:23 +02:00
Yaojia Wang
68606b84dc fix(web): 大纲生成只替换目标卷+重排确认+窗口徽标用lucide + 伏笔看板中文化/单一登记入口/Field表单 2026-06-30 08:56:23 +02:00
Yaojia Wang
f0f925b195 fix(web): 审稿面板去重标题/去英文 slug + 伏笔待登记数实时递减 + 移动端决策栏 + 对比度修复 2026-06-30 08:56:23 +02:00