功能：引用输入区支持粘贴解析 @显示名 / $名称 #473

Merged

k88936 merged 17 commits from feat/smart-paste into master 2026-09-23 18:51:24 +08:00

Conversation 5 Commits 17 Files Changed 15

+1254 -101

17 Commits

Author	SHA1	Message	Date
k88936	c0e233fe6c	Merge remote-tracking branch 'origin/master' into feat/smart-paste	2026-09-23 18:50:15 +08:00
k88936	136e1ebceb	Remove redundant fuzzy_lookup methods from test ReferenceProviders for cleanup	2026-09-23 18:49:07 +08:00
k88936	58c59b750e	Merge remote-tracking branch 'origin/master' into feat/smart-paste ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-23 17:52:49 +08:00
k88936	cba98be35f	Merge remote-tracking branch 'origin/master' into feat/smart-paste	2026-09-23 13:23:10 +08:00
k88936	28a6fd97f8	修复：润色回写与粘贴共用同一条落点兜底，认不出的引用落文本而不是消失 ... ResourceReferenceInput 新增 mentionTokenOrText：provider 的 mentionToken，答不出来（契约被破坏）时退 contentPartText 的通用文本形态；粘贴插入、润色回写的候选扫描、整根替换的落点共用这一条 润色回写的候选不再跳过「答不出 token 的 part」：这类 part 在回包里没被提到时作为末尾孤儿补回来，而不是在翻译阶段直接消失 applyContentToRoot（初始草稿与润色回写共用）解析不出引用时落文本，不再是整条吃掉 新增两处输入区用例：provider 只答得出引用答不出 token 时润色回写仍保住引用；初始草稿里已解析不出的引用落成 @resourceId 文本。两处去掉兜底即变红 同步 AGC 聊天素材引用功能说明、引用粘贴解析实施计划与决策记录（落点兜底一条，含初始草稿行为变化的记录）	2026-09-23 13:11:17 +08:00
k88936	f138f648e7	修复：粘贴插入解析不出引用时落下文本形态，不再什么都不插 ... resourceReferences.ts 抽出 contentPartToken：part → 正文 token 的逐字投影，不补白、不裁剪（补白只在 joinMentionText 拼整段文本时加）；directCodexContentToPromptText 与新导出 contentPartText 都走这一份 contentPartText 就是单个非文本 part 的文本形态：资源落 @resourceId、Skill 落 $名称、附件落 @附件名、运行区域落 @标签，文本 part 返回 null $insertContentAtSelection 的兜底链改成 provider 的 mentionToken 之外再接 contentPartText，解析不出引用也一定有一段正常文本落到光标处，删掉「两条都答不出来就什么都不插」这条违背「粘贴内容逐字保留」的分支 新增单测覆盖四类 part 的文本形态与文本 part 返回 null；新增输入区集成用例（provider 的 toReference 与 mentionToken 都答不出来时粘贴仍按 @resourceId 落下），去掉兜底即变红 同步 AGC 聊天素材引用功能说明的粘贴解析小节，并在实施计划补记本轮评审的收口	2026-09-23 13:06:43 +08:00
k88936	c9bb5a93f0	文档：说明引用名归一化可能撞名，以及碰撞目前只在解析侧兜住 ... normalizeMentionName 的注释补上「归一化不保证名字唯一」：`hero v2` 与 `hero-v2` 折成同一个 token，候选菜单侧不做冲突检测、会显示同一个标签，碰撞由 buildContentFromPastedText 的「同名多候选一律按文本保留」兜住 同步 AGC 聊天素材引用功能说明的引用名空白不变量小节，写明这是已知残留	2026-09-23 11:55:53 +08:00
k88936	3391ecf7d4	加固：粘贴接管改为「真的插进正文之后」才生效，插入为空时放行默认粘贴 ... ResourceReferenceInput 的 PASTE_COMMAND 处理器原先先 preventDefault 再去插入：插入为空时这段文字既不进我们的插入、又被挡掉了默认导入。现在先做插入，只有插入确实发生了才 preventDefault 并返回 true，否则返回 false 交给 Lexical 的默认粘贴 $insertContentAtSelection 改为返回「插进去没有」：选区取不到、或每个 part 都没落下内容时返回 false 编辑器已在一次更新里时 editor.update 会把回调排队，这时按原口径先接管（ranSync 标记区分「回调已同步跑完」与「回调被排队」），避免误判成插入为空而放行默认粘贴造成双份插入 同步 AGC 聊天素材引用功能说明的粘贴解析小节	2026-09-23 11:55:40 +08:00
k88936	3f9c698a67	修复：粘贴解析跳过只有触发符的退化 token，不再错认正文里的裸 @ ... buildContentFromPastedText 组装候选时跳过 token 长度小于等于 1 的条目（引用名为空时 token 就是裸 `@` / `$`）：边界规则会让它在正文里匹配到任何一处触发符，认下来等于把无关文字错认成一条引用 函数注释的保守规则从两条补成三条，写明空名字按「宁可不成 chip」的同一口径跳过 新增用例：空名字引用的 token 是 `@` 时不认领正文里的裸 `@`、其余 token 照常解析；去掉该跳过分支后用例变红 同步 AGC 聊天素材引用功能说明的粘贴解析小节	2026-09-23 11:54:09 +08:00
k88936	4e90465c45	修复：素材显示名在词干为空时回退 asset.id，不再产生空引用名 ... resourceDisplayName 在文件名去掉扩展名后为空（`.env` / `.gitignore` 这类整名就是扩展名的文件）时回退 asset.id，回退值同样过 normalizeMentionName；空名字会让 token 退化成只有触发符的裸 `@`，候选菜单里是空芯片、粘贴解析还会认领正文里任何一处裸 `@` normalizeMentionName 的注释改为「只做归一化、不做兜底」，把兜底的落点写明在名字的来源侧 新增用例：`.env` 与 `config/.gitignore` 的显示名回退 asset.id、引用标签不再为空；把该回退去掉后用例变红 同步决策记录（校正「不做 resourceId 兜底」一条）、AGC 聊天素材引用功能说明与引用粘贴解析实施计划	2026-09-23 11:53:14 +08:00
k88936	44148542f1	Merge remote-tracking branch 'origin/master' into feat/smart-paste ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-09-23 11:04:46 +08:00
k88936	5e36b61534	修复：引用名内部空白统一折成 -，粘贴解析不再多插一枚芯片 ... resourceReferences.ts 新增共享 normalizeMentionName：内部空白折 `-`、裁掉首尾，token 层幂等再折一次 素材显示名（resourceDisplayName）、Skill 名（目录读入与 toReference / mentionToken）、附件名（导入映射与 toReference / mentionToken）统一过这一份口径 resourceDisplayName 去掉 `|| asset.id` 兜底：引用名假定非空，不再回退 resourceId 前缀重叠 bug 由此收口：`@hero` 不再命中 `@hero-v2`（后一个字符不是空白），粘贴只剩正确的那一枚芯片 新增用例：素材 / Skill / 附件三类归一化口径、前缀重叠回归、Skill 目录名带空白、附件名带空白；把 normalizeMentionName 变异成恒等函数后新增用例全红 顺带修掉 referenceSourceProviders 用例里重命名遗留的 provider.match 断言与 skill provider 注释里的 match 同步 CONTEXT.md 术语、功能说明、实施计划与决策记录	2026-09-23 10:40:21 +08:00
k88936	072bf691d9	修复：粘贴解析注释里的 provider 成员名与实际 API 对齐 ... buildContentFromPastedText 的注释仍写着重命名前的 ReferenceProvider.candidates，改成 lookup 顺带写明候选来自调用方传入的引用清单，避免把「谁去查候选」误记进这个纯函数	2026-09-22 19:56:21 +08:00
k88936	14f11e77a2	修复：粘贴解析出的引用若解析不出来，退化成 token 文本而不是整条丢掉 ... $insertContentAtSelection 的引用分支补 else：referenceFromPart 返回 null 时插入该 part 的 token 文本 此前上游 buildContentFromPastedText 已把 token 摘走，插入端再丢一次就会让这段内容静默消失 新增用例：provider 认得出 token 但插入时已解析不出引用，断言正文保持 `看 @hero 一眼`、不产生芯片 变异验证：去掉该兜底后同一用例变红（正文变成 `看 一眼`），恢复即绿	2026-09-22 19:54:36 +08:00
k88936	9e50947d02	重构：引用输入区的选区兜底收敛成一个 helper ... 抽出 $selectionOrRootEnd()：选区缺失或指向已被重建掉的节点时统一回落到草稿末尾 insertReferences / insertText / $insertContentAtSelection 三处重复的兜底判断改为调用它 行为不变：插件插入与粘贴插入仍走同一套「插到草稿末尾」的策略，只是不再各写一份	2026-09-22 19:53:42 +08:00
k88936	ec1f207021	重构：引用 provider 的 match / candidates 改名为 fuzzyLookup / lookup，删除 onPasteText ... match(query) 改名 fuzzyLookup(query)：名字写明它是包含匹配 + 截断的模糊菜单查询 candidates() 改名 lookup()：名字写明它是精确查找用的就绪全量候选，不模糊不截断 删除 onPasteText 补读钩子：粘贴只用此刻就绪的候选，不等待、不补读，也不为解析提前读盘 输入区与资源 / Skill provider 同步改名，粘贴接管路径改读 lookup() provider 用例与粘贴集成用例同步：Skill 冷启动改为「保持字面，敲过 `$` 后可解析」 补 jsdom 缺的 Range.getBoundingClientRect 与 ResizeObserver 桩（候选菜单测量用，真实浏览器都有） 同步 ADR 修订、实施计划、功能说明与决策记录	2026-09-22 19:50:42 +08:00
k88936	6950e08506	功能：引用输入区支持粘贴解析 @显示名 / $名称 ... 新增 buildContentFromPastedText：粘贴文本按显示口径反解析，同名多候选与未命中 token 一律按文本保留 ReferenceProvider 增加可选 candidates 与 onPasteText：候选枚举保持纯函数，Skill 目录冷启动时补读一次 资源与 Skill provider 落地新缝，静默 provider（附件 / 运行画面区域）不参与粘贴解析 输入区在 CRITICAL 优先级接管 PASTE_COMMAND，仅解析出引用时插入并打 PASTE_TAG，一次 Ctrl+Z 整体回退 补充粘贴解析规则矩阵、provider 候选枚举与补读、输入区粘贴集成用例 同步 ADR 修订、实施计划、术语表、功能说明与决策记录	2026-09-22 19:06:19 +08:00