重构/抽取带引用功能的输入框 #464

Merged

k88936 merged 13 commits from refactor/extract-dep-from-ref-inputer into master 2026-09-22 19:05:31 +08:00

Conversation 1 Commits 13 Files Changed 39

+2652 -1292

13 Commits

Author	SHA1	Message	Date
k88936	9ae9ed362a	Merge remote-tracking branch 'refs/remotes/origin/master' into refactor/extract-dep-from-ref-inputer ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-22 18:51:27 +08:00
k88936	1ecb92c53d	Merge branch 'master' into refactor/extract-dep-from-ref-inputer	2026-09-22 17:57:51 +08:00
k88936	c42e087a30	Merge remote-tracking branch 'origin/master' into refactor/extract-dep-from-ref-inputer ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-22 17:41:24 +08:00
k88936	d5fb34209a	重构：候选懒加载改为菜单回调，match 收成纯函数 ... - ReferenceProvider 新增可选 onMenuQueryChange(query)：输入区在 useEffect 里回调（菜单关闭时收到 null），作为懒加载的唯一入口 - ProviderMentionMenu 不再让 provider 在渲染期产生副作用：match 只负责过滤已就绪的数据，契约里写明它必须是纯函数 - useSkillReferenceProvider 把目录读取从 match 搬进 onMenuQueryChange，第一次敲出 $ 才读；失败仍放开重试（下一次菜单查询变化时重试）并保留 console.warn - referenceSourceProviders 用例改为经菜单回调驱动，并显式断言 match 不触发任何 Tauri invoke、菜单关闭（null）也不触发 - 同步 ADR、决策记录与功能说明里 provider 契约的那段描述	2026-09-22 17:24:24 +08:00
k88936	aa973ea34d	同类问题：另外两个宿主的引用 provider 也按内容签名记忆 ... - PlanningChatView 的 chatProjectAssets 由工作台壳每次渲染重新 .filter() 派生、DirectProjectComposer 的 assets 由 manifest 订阅每次渲染重新派生，两处的 [assets] 依赖同样从不命中缓存 - 两处改用 assetsSignature(...) 做依赖，provider 身份不再随宿主渲染抖动（流式回复时每帧都换），输入区不再每帧重注册 Lexical 更新监听	2026-09-22 17:12:02 +08:00
k88936	fbfc7e5e62	修复：候选菜单的 key 改用引用身份，同名素材不再撞 key ... - 导出 resourceReferences 的 chatReferenceKey（只认稳定身份、不含显示名的身份键），并加注释说明它为什么不能省 - ReferenceMentionOption 由 super(chatReferenceMentionToken(...)) 改为 super(chatReferenceKey(...))：characters/hero.png 与 enemies/hero.png 都展开成 @hero，拿显示 token 当 key 会让 React 撞 key、复用错 DOM，键盘高亮与选中落到另一条候选上 - referenceSourceProviders 用例补一批同名素材：断言两条候选的显示 token 相同、身份键不同	2026-09-22 17:06:08 +08:00
k88936	3fdde6f51d	修复：并发导入附件时仍然守住 8 个上限 ... - useDirectProjectChatController 增加 attachmentsPendingCountRef：已放行但还没落成正文芯片的条数先在预算里占住名额，放行的部分在 finally 还回去 - 原来的预算只减草稿里已有的附件芯片数，两次并发导入会各自按同一份快照放行，最终插进正文的芯片可以超过 MAX_CHAT_COMPOSER_ATTACHMENTS（回归自「待发附件列表」被删掉的那次重构） - 新增 tests/chatComposerAttachmentCap.test.tsx：两次并发各带 5 个文件，断言放行 5 + 3，并补 jsdom 缺失的 Blob.arrayBuffer	2026-09-22 16:59:36 +08:00
k88936	39ac337569	诊断：Skill 目录读取失败不再静默 ... - skillReferenceProvider 的 loadSkillCatalog 失败分支补 console.warn('[skill-reference] …')，带上是哪一次重试、错在哪，排障时不再只能看到「敲 $ 没反应」 - referenceSourceProviders 用例断言这条日志（并用 vi.restoreAllMocks 收尾），把「失败可重试」与「失败留痕」两件事一起钉住	2026-09-22 16:56:31 +08:00
k88936	28bacfc125	画布生成面板的引用 provider 按素材内容签名记忆 ... - ResourceCanvasAssetGenerationPanelView 的 referenceProviders 改依赖 assetsSignature(referenceAssets)：referenceAssets 由 .filter() 派生、每次渲染都是新数组，原来的 [referenceAssets] 依赖永远命中不了缓存 - 注释写明「provider 身份一变，输入区就重新注册 Lexical 更新监听」，避免以后又改回数组依赖	2026-09-22 16:55:39 +08:00
k88936	a6a938d5cc	文档：新增引用输入区重构与宿主注入的实施计划 ... - 记录一句话交付、五条验收判据、六个提交切分与验证方式 - 追加执行状态：六项已落地内容、顺带清理、验证结果（全绿门禁与定向用例）与未完成项（CSS 类名重命名、真机手感、粘贴解析）	2026-09-22 16:07:06 +08:00
k88936	e6b6a0aeca	文档：记录引用候选由宿主注入的决策、术语与功能说明 ... - 新增 ADR《引用候选由宿主注入》：注入式 provider、面板外移、附件并入正文的理由、备选与影响 - decision-log 增加 2026-09-22 条目：注入 / 分离 / 附件 / 显示口径四项决策、未纳入项、验证方式，并记录顺带清理 activeVersionId - 功能说明《AGC聊天素材引用》同步：Provider 注入、ResourceReferencePicker 自持数据、$ Skill 只出现在注入该 provider 的宿主、附件进入正文与上限口径、显示名注入 - CONTEXT.md 补引用来源 / provider / 选择器 / 附件芯片等术语与关系 - docs/README.md 登记新 ADR	2026-09-22 16:06:40 +08:00
k88936	1fbce7ffc5	清理工作台壳到聊天壳已经传不过去的 activeVersionId ... - ProjectChatComponentProps 删除 activeVersionId：它只在策划输入盒的 @ 面板里生效，而策划输入盒的 @ 触发钮早就不渲染，参数从壳传进聊天后无人消费 - WorkspaceLauncher 不再把这个参数透传给 ProjectChat；工作台壳自己那份 activeVersionId 保留，仍供 ProjectDevelopmentView 的游戏运行版本使用 - App 的 AppProps 与解构同步删除该参数 - styles.css 里那条「ResourceReferenceInput 收到 showTriggerButton={!directCodex}」的注释改成当前口径：@ 触发钮在控制排的 .project-chat-reference-trigger，输入区不注入 ResourceReferencePickerAction	2026-09-22 16:05:08 +08:00
k88936	7e009a4c94	引用输入区改为宿主注入引用来源，素材选择器与输入区分离 ... - 新增 features/project-workspace/reference-source（types + 资源/Skill/附件/运行画面区域四个 provider 工厂），输入区按 providers 顺序取第一个非空回答，不再判断引用种类 - ResourceReferenceInput 删除 assets / versions / activeVersionId / skills / showTriggerButton / openPicker，改为 providers / inputActions / submitSuppressed / containerRef 四个通用接缝 - 新增 ResourceReferencePicker 与 ResourceReferencePickerAction：面板自己拿数据（素材、版本、缩略图预览 invoke）并自管筛选态，由宿主渲染，确认后只经 insertReferences 交回输入区 - 四个宿主改为按需注入 provider 并各自渲染选择器：DirectProject 注入资源+Skill+附件+运行区域，策划输入盒 / 画布生成面板 / 资源卡快速编辑只注入资源+两个静默 provider，非 DirectProject 宿主不再出现 $ Skill 候选 - 附件并入 ChatReference，编辑器收敛为单一 ResourceReferenceNode（删除 AttachmentReferenceNode），附件 chip 的 DOM 契约（data-attachment-reference / data-attachment-status / title / 移除按钮 aria-label）逐字保留 - 附件改为导入成功即以芯片进入正文、失败与异常一律不插入；控制器删除待发附件状态与 removeAttachment，ComposerPendingAttachments 与其提交时拼接一并删除，单次上限按草稿中的附件芯片数计算，导入进行中禁止发送 - directCodexContentToPromptText 的引用 token 前后各留一个空白（不重复），显示名反查改由调用方注入 resourceLabelResolver(assets)，并补 TODO：后续改为按组件渲染引用 - 队列 chip 文案、快速编辑出站提示词、润色回填的引用恢复统一走 joinMentionText 的同一份 token 口径 - 新增 tests/referenceSourceProviders.test.ts 规则矩阵单测（触发符、候选过滤与截断、toReference、refresh、mentionToken、Skill 目录懒加载与失败重试），既有输入区/聊天用例迁移为注入 provider - styles.css 删除随面板外移与待发附件列表一起失效的规则	2026-09-22 16:01:54 +08:00