494 Commits

Author	SHA1	Message	Date
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
lhk229	1e186369c9	客户端埋点设置 (#446) ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/446 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-23 00:09:12 +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
k88936	1ecb92c53d	Merge branch 'master' into refactor/extract-dep-from-ref-inputer	2026-09-22 17:57:51 +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	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	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	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
suzmii	6dde321bd1	修 review 发现：运行反馈全面退出对话区，并补齐顶栏与守卫细节 ... - executeRunLocal 的三条失败路径（缺 Tauri / 缺项目 / 启动预览报错）也改走 onRunNotice 失败色提示，对话区不再出现过程行；随之删除已无调用方的 announceProjectChatMessage 与不再有意义的 announceToChat 参数 - RunNoticeToast 的失败提示延长到 6 秒（成功仍 2.6 秒），避免错误一闪而过 - 版本入口在 UI 编辑器壳里不渲染；版本名改由一层 span 承载省略号，长版本名不再被硬裁 - 视图拿不到 onNotice 时把「在浏览器打开失败」写进 console，不再静默吞掉 - check-native-shells 增加「运行页视图里 openUrl( 只有一个调用点」的判据，堵住自动开浏览器的口子 - 新增外壳级接线用例 runNoticeShellWiring；previewActivation 补「启动失败走失败色提示且不写对话区」；runNoticeToast 补失败时长；样式守卫补省略号 - decision-log 收敛到最终口径（成功与失败都出对话区、失败留 6 秒、编辑器不挂版本入口）	2026-09-22 13:51:30 +08:00
suzmii	0a8debef56	合并 master：运行页入口收口并入 DirectProject 重构 ... - 保留 master 的 DirectProject / ProjectChat 重构与测试重组：原 appSurface 的 project-commands / project-preview / supervisor-runtime 三个 suite 已被 master 删除，接受删除并把相关断言重写到 tests/previewActivation.test.tsx 等新用例 - 本分支改动重放到 master 结构：运行与预览成功的反馈改走 onRunNotice toast（带 tone），对话区不再写过程提示 - 运行页顶栏统一：预览地址改成「在浏览器打开」按钮，版本入口搬进同一动作区复用同一套按钮皮，状态行与预览地址小字退役 - 生成任务入口、面板与锚点不在运行页渲染，placement 里的 run 档一并删除 - 手工合并 App.tsx / WorkspaceLauncher.tsx / model.ts / check-config.mjs / decision-log / pitfalls，并把两条决策记录与一条排障记录补进 master 版本文档	2026-09-22 12:50:19 +08:00
suzmii	5a87c5f965	运行页顶栏收口：预览地址改按钮，版本入口并入顶栏同一套样式 ... - 删除运行区域上方的状态行与预览地址小字，运行画面回到两行栅格 - 预览地址改成顶栏动作区里的「在浏览器打开」按钮（opener 插件 openUrl），只在有活预览时渲染 - 版本入口搬进同一个顶栏动作区，外观复用该容器的基础按钮样式，去掉自带的边框、底色与 hover - 打开失败走 onNotice 的失败色 toast：onRunNotice 通道改成带 tone 的对象，四处调用点同步 - 补顶栏入口正向守卫，删掉状态行的旧样式用例并新增顶栏与浏览器打开的用例	2026-09-22 11:51:51 +08:00
suzmii	8e6ee50ad8	运行页收口：状态行同在画面外，生成任务不进运行页 ... - 运行区域上方新增状态行，预览地址小字与版本入口同排：两者都在游戏画面之外，版本入口不再绝对定位压在画面上 - 小字单行省略并用 title 给出完整地址，状态行高度恒定 30px，没有版本入口时也不塌 - 运行页不再渲染生成任务入口、面板与锚点；[data-generation-tasks-placement='run'] 那一档坐标与 placement 里的 run 一并删除 - 按新口径改写两侧用例，新增运行区域状态行的声明级守卫用例 - 记录决策到 shared-memory/decision-log.md	2026-09-22 10:29:53 +08:00
suzmii	e6083050a8	运行/预览提示退出对话区，改 toast 与运行区域小字 ... - 删除播放、/preview、/open-preview 与生成后自动启动预览写进对话区的成功提示，对话区只保留对话内容 - 新增 onRunNotice 通道，工作台壳用 RunNoticeToast 弹 2.6 秒浮层，同一句连续触发会重新计时 - 运行表现层在预览框上方常驻小字「已载入客户端运行视图：URL」，没有活预览时不占位 - 更新 appSurface 四处用例，新增 onRunNotice、小字与 RunNoticeToast 用例 - 同步 check-config 与 check-native-shells 的字符串判据，并记录决策到 shared-memory	2026-09-22 10:00:38 +08:00
k88936	19e1883f71	合并 origin/master：策划附件导入接入策划聊天入口 ... - 保留 DirectProject 独立聊天容器与 Supervisor 退役结果，不为冲突恢复运行时兼容分支 - 策划工作区文件导入接入 PlanningChatView 输入盒，导入期间暂缓发送、阶段批准、澄清与重试 - 工作台壳按项目记录导入进行态，导入未完成时不切换游戏运行态并提示等待 - 首页策划附件导入结果落到工作台 fileImportNotice 提示条，可单独关闭 - 设计态输入盒样式选择器由 project-supervisor-* 收敛为 project-chat-* - 策划导入回归用例适配退役后的 harness 与 chatProps 命名	2026-09-22 02:24:47 +08:00
k88936	a11cdf13d7	画布生成面板重开草稿与重试身份收敛到 canonical content ... 生成面板 state、重开草稿、重试身份与提交载荷统一为一份 content[] 重试身份改用 directCodexContentKey 内容指纹比对并删除 referenceIdsMatch directCodexContentToLegacyContentDto 只在任务落账的出站边界派生 账本回到草稿的反向翻译收敛为 legacyContentDtoToContent 单一实现 token 扫描从 ResourceReferenceInput 提到 resourceReferences 并两处共用 无法解析的资源引用合成 unknown 占位而不再静默丢弃 出站提示词规范化收敛为 resourceCanvasAssetGenerationPromptText 供两处共用 directCodexContentToPromptText 去掉 trim，空白只在整条 content 上判定 同步决策记录与 canonical content 里程碑落地结果	2026-09-21 22:56:32 +08:00
lhk229	085181c795	修复策划附件导入工作区并解除资源清单耦合 ... 新增策划工作区文件导入命令，支持同名另存并保留文件字节 首页和聊天框附件直接导入策划工作区，脱离游戏资源清单与回合附件 导入期间暂缓发送、阶段操作和游戏制作切换，保留逐文件失败提示 补充导入、刷新与切换回归测试，同步技术方案和共享约定	2026-09-21 22:49:21 +08:00
k88936	8968762274	合并 origin/master：DirectProject 输入校验取回空白片段回归用例 ... - validation.rs 保留本分支的 content_has_meaningful_input 与 Skill/附件独立上限，空输入报错取回 master 的用户可见文案“聊天内容不能为空” - wire.rs 取回 master 新增的 text_projection / user_input_rejects / valid_references / nonempty_text 四条回归用例，测试导入合并两侧 - resourceReferenceInput.test.tsx 取 master 的注释口径：草稿 text 投影会 trim，提交用的 content 保留 chip 后的分隔空格 - pitfalls.md 与《AGC聊天素材引用》改为「任意非文本 part 均算有效内容」，与四类引用的实际校验对齐 - 本地私有改动的 .env 不进入本次合并	2026-09-21 21:42:41 +08:00
k88936	295d4af384	润色回写按token原位恢复引用与附件 ... 统一引用与附件的润色扫描口径，token 存活时原位换回真 part token 被改写时剩余 part 补在末尾，附件不再丢出 canonical content 删除无调用方的 EMPTY_CHAT_COMPOSER_DRAFT 补充润色原位恢复与末尾补位两条回归用例	2026-09-21 21:22:04 +08:00
k88936	6981648796	合并 origin/master：Supervisor 永久退役，项目对话收敛为 DirectProject 与 Design Agent ... - 解决 refactor/split-direct-project 与 origin/master 在 App.tsx、立项策划聊天视图、Direct composer/引用输入区、styles.css、Rust direct user item 与 appSurface 用例上的冲突，按「Supervisor 永久退役」口径保留 DirectProject 独立聊天容器与 Design Agent 两条产品路径 - 采纳 master 的策划 Agent V1/V2 退役：删除 GDD 审批卡、策划输入卡、planningLane、planningSessionV2、planningSessionContract、规划展示适配与 Rust planning_*_v2 命令、模块、契约及对应用例，不保留兼容别名或双跑路径 - 把 master「折叠思考显示单行预览」的目的落到当前结构：新增共享表现 chat/components/AgentReasoning/AgentReasoning.tsx（折叠态单行纯文本预览 + 箭头、展开态安全 Markdown），DirectProject 回合与策划回合共用，删掉两处写死的 pre 折叠实现 - 把 master「策划入口可选模型 / 推理档」的目的接到当前策划输入盒：复用 ConversationModelSelect 与 ComposerReasoningEffortSelect，配置写回仍走客户端配置通道 - App.tsx 删除只服务退役 Supervisor / 策划 V2 的 state、ref、effect、回调与死参数，并删除两条读路径都退役后的 workspaceProjectKind；openWorkspace 的工程类型入参保留为未使用契约 - Rust 侧保留本分支 canonical→wire 投影、无审计 Direct 回合与 direct user item 严格校验，并入 master 的 prepare_new_web_project_at 前置复核 - 更新 ADR 与 shared-memory 决策记录：策划当前只有 Design Agent、两条路径的共享表现清单，以及本次合并的口径、代价与验证证据 - 验证：AGC 与仓库 typecheck、check:encoding、check:doc-index、git diff --check、改动文件 eslint 0 error；AGC vitest 168 个文件中除 5 个 jsdom localStorage 环境失败文件与本分支既有 resourceTagStatsRefresh 失败外全绿，appSurface 198 passed / 13 skipped；Rust 定向用例 direct_codex_user_item、skill_pack、sessions 全过（整套分片在本容器受 /sbin -> usr/bin 触发沙箱预检失败，与本合并无关）	2026-09-21 21:09:34 +08:00
lhk229	f71361c292	修复客户端图标素材生成丢失用户描述 (#450) ... 删除图标生成的固定提示词包装、默认美术说明和两次截断 按服务端单条描述语义校验非空及200个Unicode字符，超限拒绝并保留原文 保留内部换行，直接以单条iconDescriptions提交用户描述 更新前端、原生入口和实际HTTP请求回归测试 同步工具说明、生成契约及项目排障文档 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/450 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-21 19:12:35 +08:00
kdletters	34b1ad5d5c	新增 Godot 模板并补按模板建项的 Godot 分流 ... - 新增 4 个仓库内手写 Godot 4.7 模板源：godot-empty-2d、godot-empty-3d、godot-hello-world、godot-platformer-2d，entry 统一为 project.godot，各自带 meta.json 与 960×540 封面 - template_library.rs：复制模板后按 project.godot 识别 Godot 模板，改写工程显示名后走既有 Godot 导入并写入 godotProjectRoot，不再落到 Web 占位入口 - manifest.rs：新增 apply_godot_project_display_name，只改 [application] 段的 config/name 一行，其余字节逐字保留 - manifest.rs：放宽 Godot 工作区发现，一层子目录多命中按目录名排序取第一个，project.godot 允许是符号链接 / reparse point / 硬链接 - commands.rs：同步 Godot 导入错误文案，去掉「普通文件」限定 - RuntimeConfigDialog.tsx：内置插件行去掉手动启动 / 停止按钮，启动由前端自动启动承担、停止走该行启用开关 - import_tests.rs 与 tests/project.rs：补显示名改写、多命中确定性、链接标记与错误文案的定向回归 - 同步更新 PRD、模板包组织指南、模板库与模板建项技术方案、AGC Godot 编辑器插件接入方案、实施计划与共享决策记录	2026-09-21 17:25:34 +08:00
k88936	4698527025	完成DirectProject composer canonical content收口 ... 输入区草稿只保留 Lexical content 数组 Direct 与 Planning 提交边界直接读取 canonical content 润色保留引用解析并保护附件节点 通过单向 DTO 适配 legacy text 引用与附件消费	2026-09-21 14:37:49 +08:00
kdletters	02a7abeb3f	新增后台 AGC 模板管理与模板库内容寻址落库 ... - 后台新增「模板管理」页：按权限查看并编辑模板名称/简介/标签/封面，支持上架与下架；路由、侧栏、tab 权限、API 客户端与 DTO 同步接入 - api-server 新增 /admin/api/agc-templates 读取与更新路由，复用现有后台鉴权与 tab 权限校验，权限不足按既有失败关闭口径拒绝 - module-assets 收敛模板库纯规则（active/inactive 投影、索引 schema 与重复项校验、ZIP 大小与摘要核对），platform-oss 承担对象存储读写、不可变对象复用与发布互斥锁 - shared-contracts 补后台模板 DTO；spacetime-module 账号存储适配保持既有 schema 不变 - AGC 壳内置模板索引与建项读取改为内容寻址对象，补模板安装、越界归档、索引不匹配等用例 - 模板库发布脚本支持定向发布与上架/下架合并、内容地址复用与锁语义，CLI 守卫用例同步；jenkins 两条客户端打包管线统一触发邮件通知 Job 并传递首装包链接 - 内置 5 个 Cocos 官方模板载荷与索引 fixture（内容地址对象，共 90 个文件） - 补「后台模板管理」里程碑与实施计划，更新模板库技术方案、开发运维文档与共享记忆 - 验证：admin-web 39 项用例与 typecheck、发布脚本 25 项用例、api-server 与 AGC 壳编译、模板库定向 Rust 用例（AGC 壳 18 项、module-assets/platform-oss 16 项、后台权限 1 项）、check:encoding / check:doc-index / check:production-ops / rustfmt 全部通过	2026-09-21 13:56:20 +08:00
suzmii	562e1ba586	「生成任务」侧栏读秒改为 100ms 粒度：与对话侧共用同一份时钟 ... - ResourceCanvasAssetGenerationTasksPanelView：删掉面板自带的 1000ms interval 与 nowMillis 状态；两条任务行的「已耗时」下沉为叶子组件（AssetGenerationElapsedLabel / ResourceEditElapsedLabel），各自订阅共享 hook useLiveNow（LIVE_TIMER_TICK_MS = 100）。 - 为什么不是面板级时钟：面板上通常同时挂着多条任务，100ms 的 tick 落在面板上等于每 0.1 秒重建整个侧栏；useLiveNow 的注释明确要求调用方是叶子节点。终态行不订阅，已耗时定格在账本给的结束时间上。 - 行为：不足一分钟的耗时本来就显示到 0.1 秒（formatElapsedDuration），现在每 100ms 真的更新一次，不再是「带小数却 1 秒跳一格」。 - 用例：新增「读秒按 100ms 刷新（0.0 → 0.1 → 0.5 秒）」「终态行不再走表，定格在结束时间」「秒表只订在运行中的那一行上（setInterval 只被调用一次）」；把 LIVE_TIMER_TICK_MS 临时改回 1000 时第一条用例即红，粒度确实被钉住。	2026-09-21 12:48:21 +08:00
suzmii	b4ce6877c8	修掉「拖动占位卡仍触发点击」的真因：点击抑制的计时起点必须在松手那一刻 ... - useResourceCanvasGenerationPlaceholders：抑制状态在越过拖动阈值时只登记、不起计时器，改到 pointerup 才起 0ms 计时（deferDragClickSuppressionCleanup）；pointercancel 与切项目走 clearDragClickSuppression 立刻收干净。 - 原实现（越过阈值时就起 0ms 计时器）在真实鼠标下不成立：一次拖动里 pointermove 横跨多轮宏任务，计时器早在松手前就把抑制清掉，收尾那次 click 照样生效——jsdom 同步发 move/up 看不见这一档，所以上一版用例是假绿。 - 用例补上真实时序：拖动过程中显式让时钟走一轮宏任务再松手；宿主用例还补上浏览器在 pointerup 之后补发的 lostpointercapture，并断言它不能把这次拖动的抑制一起清掉。 - 敏感性已双向验证：把计时器搬回「越过阈值那一刻」、以及让 lostpointercapture 清抑制，两条用例都会红；改用例前的同步版本对两种错法都会绿（所以上一版没抓住）。 - 注释写明计时起点为什么是松手那一刻，并与资源卡链路的 deferSkippedResourceCardClickCleanup 对齐口径。	2026-09-21 12:34:47 +08:00
suzmii	7b57cba14d	补齐「图集（生成图标素材）为什么没有 @」的当面说明与依据 ... - 生成浮层：不给 @ 选择器的入口新增一段说明行（`data-resource-canvas-generation-reference-free`），讲清「该入口走平台图集通道，参考只有一张权威规范图（图标规范），不支持另挑参考图」——验收现场那条「生成图标素材没法 @」读起来像漏了按钮，原因其实在通道上。 - 样式：说明行允许折行、沿用次要文字色；与既有的「参考图 n/5」计数行区分开。 - 用例：图集入口断言说明行在场；逐条入口断言「说明行」与「@ 选择器」严格互补；原「不呈现参考选择」的判据从按词匹配改成按计数元素/计数值匹配（说明行本身会提到「参考图」三个字）。 - 文档：入口矩阵补「图集为什么没有 @」一条，写明图集走 `icon-spritesheets` 通道、提交体只有 referenceId + iconDescriptions（无 referenceImageSrcs）、结果绑定硬校验参考恰好一张，以及「平台 OpenAPI 该请求 schema 有 referenceImageSrcs 字段，放开属于产品 + 平台口径变更」。	2026-09-21 12:23:32 +08:00
k88936	317c8557f4	修复输入区受控回写用滞后渲染的 props 清空用户草稿 ... - apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx 的受控同步由 useLayoutEffect 承担：宿主对草稿的回显晚于编辑器提交，被动 effect 可能在上一次渲染的 props 上延迟执行，读到旧 value 加新编辑器状态后重建整份草稿，把刚输入的内容清掉并形成来回清空 - 补注释说明该 effect 必须与本次提交同帧执行，以及直接改成 content 单事实源前的行为约束	2026-09-21 11:59:17 +08:00
suzmii	beebcca4de	修复 AGC 画布四项验收问题：锚点让位标题栏、浮层不再撞画布边缘、拖动不再触发点击、图标规范参考口径对齐 ... - 生成任务锚点新增「资源总览」档：资源总览页仍贴画布顶边内缩 0.85rem，资源栏目画布页让开顶部钉住的整宽栏目标题栏（42px + 0.5rem），两档切换走 margin-top 过渡（减动效下关掉）。 - 生成浮层的顶边与可用高度改为按占位卡的真实屏幕位置算（卡下沿到安全底边），不再假设卡片贴在安全带上沿——占位落到下半屏时浮层底边不再越过画布下沿被切掉。 - 生成浮层新增水平收口：按「浮层左右各留 12px」把锚点收进画布可视范围，卡片靠边时浮层不再有一半落到画布之外；宽度口径与面板 CSS 同源（min(560px, 100% - 24px)）。 - 新增画布卡片手势的共享判据 resourceCanvasGestureExceededDragThreshold（阈值仍取 RESOURCE_CANVAS_DRAG_THRESHOLD）：资源卡与生成占位卡共用同一份「拖动还是点击」判断。 - 生成占位卡修掉拖动收尾误触点击：越过阈值才算拖动、登记一次性点击抑制（consumeDragClick）由宿主消费，「拖动中」样式也从越过阈值那一刻起才亮。 - 生成占位卡的删除按钮起手手势不再被当成「点卡片」：按起手点判定，松手落回卡片时不触发开合生成浮层。 - 图标规范面板的参考选择注释按现行判据改写（只有图集 icon-spritesheet 不接受用户参考），入口矩阵文档同步补「参考图（@ 引用）」口径并修掉「本地 IPC 没有参考图入参」的旧说法。 - 补齐回归用例：手势模型判据、占位卡拖动/点击与阈值、宿主级「拖完不弹浮层且普通点击仍开合」、浮层顶边与水平收口、锚点分档与跨文件标题栏高度守卫、逐条生成入口的 @ 与判据一致、图标规范面板的 @ 与提交带引用。 - 共享记忆 pitfalls.md 记录两条排障口径：卡类手势必须只有一份阈值与点击抑制判据；画布浮层几何只能按真实屏幕位置算、分页锚点必须让开钉死的标题栏。	2026-09-21 11:58:13 +08:00
k88936	0224ef7b9d	删除 Project Supervisor 聊天遗留的 pendingCommand 死链 ... - 删除 App.tsx 里 pendingCommand 状态、确认/取消处理与 21 个 execute* 分发分支 - 删除随该链路一起不可达的 21 个 execute* 实现与 requireChatProjectForUserAction - 删除只服务该链路的 PendingCommand 类型、pendingCommandPresentation.ts 与 resolvePendingCommandProjectPath - PlanningChatView 去掉 pendingCommand 面板相关 props、渲染分支与导入 - rememberCommand.test.ts 只保留现役 helper（path/remember/needsInitializedChatProject/agent 卡片）的用例	2026-09-21 11:15:02 +08:00
suzmii	5467ed6d7b	自查修正：拖到对话落点逐值比较、替换面板锚进画布容器并与任务面板互斥 ... - 拖动落点改逐值比较 sameResourceCardReferenceDrop（条数 + 对话栏矩形四值），指针在对话栏上移动不再每帧 setState、不再每帧重渲染工作台。 - 替换面板从 stage 顶层移进画布容器 .game-resource-book-manager（本身 position: relative），top 3.2rem 排在任务开关下方；相对 stage 写死的偏移会在工具条换行时压上去，与刚修的任务开关是同一类隐患。 - 打开替换会话时收起「生成任务」面板：画布右上角同一时刻只留一块浮层（任务照旧在账本里推进）。 - 面板上方补一行「替换源素材：<显示名>」：非模态之后画布上的源素材光环会被空白点击清掉，源身份得在面板这一侧留一份可读说法。 - 测试：替换用例新增「面板锚在画布容器里、写明源素材、并与任务面板互斥」（20 passed）、落点模型新增逐值比较用例（6 passed）。 - 文档：decision-log 新增本批自查条目、待办文档补登记、验收用例 C9 注脚改为 nonModal 形态。	2026-09-21 06:21:19 +08:00
suzmii	7148ff9eaf	验收修正：任务锚点改挂画布那一格，展开后开关让位 ... - 重叠：右上角锚点不再用 position: absolute + 写死的 top（工具条是 stage 第一行、高度随按钮换行变化），改为 stage 网格里与工作面同一个单元格的条目：grid-row 按 placement 分档 + grid-column 1 + justify-self end + align-self start + margin；同格的三处容器也显式钉住第 1 列，避免画布被自动列放置挤进隐式第二列。 - 并排：开关只在完全收起时渲染（收起动画期间也不画），展开态画布右上角只留面板，收起走面板头部 × 或点画布外部。 - 测试：面板用例新增「展开时开关让位」、计数用例拆成收起查开关 / 展开查面板；样式用例改判网格条目坐标与窄屏 justify-self: stretch；dismiss 用例改走面板 × 收起、收起后开关回来能再打开。 - 文档：PRD 3.10 与更新时间、decision-log 新增 2026-09-21 验收修正条目、待办文档补登记该修正。	2026-09-21 04:33:26 +08:00
suzmii	b20d980ba7	替换点选判据的注释口径跟上新流程 ... - resolveResourceReplacementPick 的注释里「点选态」「点选替换」改为「画布点选」「面板里的当前替换目标」，与退役掉的按钮 / 提示条口径一致；只改注释，行为不变。	2026-09-21 03:53:07 +08:00
suzmii	de502e9bc3	替换面板改为非模态浮层，支持在画布上点选替换目标 ... - 共享选择组件新增 opt-in nonModal：不铺遮罩、不做焦点陷阱、限高 + 内部滚动，Esc 在 document 阶段截断后取消，关掉即卸载；网页端美术画布不传，弹窗行为逐字不变。 - 新增 initialSelectionRevision：面板开着时宿主换了目标才重同步当前选择，面板里的搜索词与分类筛选不被重置。 - AGC 侧把候选面板锚到画布右上角（任务开关下方），壳样式放共享样式表、宿主只负责锚定；面板开着时画布照常可点，点中合法候选落成面板当前选择，写入仍只由「确认」发起。 - 退役旧的「点选替换」按钮、画布提示条与 resourceReplacementPickMode：同一个功能不留两条 UI 路径；合法性判据仍复用 resolveResourceReplacementPick，写入仍是同一个 confirm 函数。 - 确认时用画布点选结果兜底，避免点完当帧按确认误报「请选择一个替换素材」。 - 测试：替换用例 4 条点选路径改写为非模态 + 面板点选（含四类非法目标在面板内报因、Esc 只收面板），新增「画布点选不清掉面板搜索/分类」；共享组件用例新增 nonModal 形态与浮层壳声明级契约。 - 文档：PRD 5.3 / 7.8 第 8 条改写、验收用例 S15a 改写、decision-log 新增 2026-09-21 条目、待办文档登记三项并勾掉对应需求。	2026-09-21 03:48:40 +08:00
suzmii	9639a080c6	资源卡拖到对话栏实现批量 @ 引用 ... - 新增落点模型 resourceCardReferenceDropModel：对话栏矩形量取（0 x 0 判成没有落点，避免画布内拖动被误判）、命中判据、引用构造与落点提示文案。 - 引用构造与工具条「引用」按钮逐字一致（只认已登记 manifest 素材、source 为 resource-card、kind/分类/标签取自资源投影），一条都构造不出来时用提示条说明原因。 - 拖动中指针落到对话栏上即从排版切到引用：卡片不再跟指针走，改铺虚线落点浮层并提示「松手即可 @ 引用 N 项素材」；拖回画布内松手仍是原来的排版语义。 - 批量范围与拖动位移同一个集合（多选整批、单选只引用按住的那张）；新增批量事件 RESOURCE_REFERENCE_INSERT_MANY_EVENT，App 侧一次插入整批并只聚焦一次，空批次不派发。 - 对话栏挂 ref（不 document.querySelector）、落点浮层按对话栏当时的屏幕矩形铺在根节点上，不改对话栏自身的定位与排版。 - 测试：新增落点模型用例 5 条与画布集成用例 4 条（单卡/多选/拖回画布/pointercancel），resourceReferenceInput 新增批量事件与一次插入整批 chip 两条，共 39 条定向全绿。 - 文档：功能说明新增「拖拽引用」一节与完成清单条目、PRD 更新时间、decision-log 新增 2026-09-21 条目。	2026-09-21 03:37:43 +08:00
suzmii	d56b5ff15a	AGC「生成任务」侧栏移到画布右上角：开关常驻、面板贴着它展开 ... - 新增右上角锚点 game-resource-generation-tasks-anchor，挂在 game-workbench-stage 内；资源栏目画布与 UI 编辑器用画布顶边那一档，运行表现层下移让开右上角的版本入口。 - 开关改由 ResourceCanvasAssetGenerationTasksPanelView 自己渲染（保留 data-resource-generation-task-toggle 与计数属性、可访问名唯一），收起态只剩这一枚开关；工具条上两处重复入口与宿主那份 resourceAssetGenerationInFlightCount 一并删除。 - 面板自己不再定位，改由 max-height 封顶 + 内部滚动；进场 / 退场动画位移方向跟着锚点翻到正 X。 - 开关沿用原工具条那枚次级胶囊外观，颜色 / 圆角 / 字重 / 阴影继续全部走平台 token。 - 测试：面板用例新增「折叠只剩右上角开关」「开关计数与面板头部同源」「锚点按工作面分档」；样式用例改为锚点坐标 / 运行档下移 / 面板不再自定位 / 开关走 token；dismiss 用例改为右上角入口且工具条不再有生成任务按钮。 - 文档：PRD 3.10 与更新时间、decision-log 新增 2026-09-21 条目、画布验收待办登记第四批并勾掉该条。	2026-09-21 03:25:53 +08:00
kdletters	485ed50b26	AGC 七项交付效率优化并升级捆绑 Codex 到 0.155.1 (#439) ... ## 背景 净月潭案例（2026-09-19 21:53 → 09-20 01:26，3 小时 33 分）的问题不是模型慢，而是环境未就绪、验收靠模型自述、预算只约束单个工具入口、工具调用被 SDK 全局串行闸门卡住。本 PR 落地确认后的七项交付效率合同，并把捆绑 Codex 升到当前 npm latest。 ## 结果 - 新建 Web 游戏在正式生成前由宿主自动预检：捆绑 Node/npm、真实 Vite 构建、受限浏览器桌面/移动截图；失败不启动生成或付费素材。 - 首个副作用前冻结交付合同，宿主保存权威证据与预算；证据齐全后先封口、排空并取得执行器完整退出证明，再产出交付报告，模型回复不再当作验收。 - 原生 shell、内置浏览器与托管命令、第三方 MCP 共用同一执行许可和累计执行时间；`validation.maxRuns` 改为执行/返修批次语义，另设 `maxTurnSeconds` 墙钟上限。 - 所有工具可并发：移除 SDK 全局串行的 `apply_patch`/`update_plan` 注册，改由宿主 `agc_apply_patch`（官方 parser + 当前回合写许可 + 受控进程树 + 短项目事务）和 `agc_update_plan` 提供等价能力；真实请求目录里已无串行注册，长 MCP 与补丁/计划实测在同一响应内重叠。 - 付费提交与本地写入绑定原回合原租约：容量与同动作锁等待可取消，封口、取消或预算耗尽后零新增提交；已越过提交边界的请求保留 operation ID 走 GET 对账，不自动重放。 - 新增请求与工具分段计时、有界并行批读和首轮上下文预取，未知耗时不补零。 - 捆绑 Codex 0.147.0 → 0.155.1：固定版本收敛到 `build_support/codex_bundle.rs` 单一声明，vendor 解析源码按 `rust-v0.155.1` 逐字节重取并更新 UPSTREAM 证据，适配 0.155 统一 exec（`exec_command`/`write_stdin`）；macOS 侧车最小系统版本仍为 15.0。 ## 验证 - 生产 CLI → 捆绑 Codex 0.155.1 → 本地 Responses/MCP 夹具 9/9：补丁、完成收尾、批次、只读/可写 MCP 并发、原生命令并发、原生资源并发、统一 exec 会话、期限终止（真实重叠 775 / 764 / 999 ms）。 - 真实模型目录 2/2；vendor 上游库 111 项；宿主定向与回归 106 项；真实 Windows 进程与取消 21 项；Node 侧门禁 52 项。 - 发行载荷：artifact-only 重建 NSIS，解包验证侧车清单 `codex-cli 0.155.1`、6 个组件哈希、打包后 `bin/codex.exe --version`、Node 运行时 2130 文件与双端 PNG、`--environment-check` ready。 - `check-config`、TypeScript、编码（4991 文件）、文档索引、`git diff --check`、`cargo fmt --check` 全部通过。 ## 未覆盖 - 真实陶泥儿登录态 Provider 生成尚未执行（本机 `--llm-status` 返回 `authentication-required`）。 - macOS 侧车只在本机做静态 Mach-O 与清单解析，未在 macOS 上跑 `check-macos-bundle.mjs`。 - 全仓库聚合套件在本机仍因负载敏感的后台 mock-provider 用例而红，与本次改动无关：改动前的旧二进制同样失败，换单线程后相关用例 3/3 通过。 --------- Co-authored-by: kdletters <61648117+kdletters@users.noreply.github.com> Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/439	2026-09-21 02:29:29 +08:00
suzmii	1655a2eab4	Merge pull request '画布验收遗留问题与后续需求' (#419) from fix/agc-acceptance-followup into master	2026-09-21 02:02:19 +08:00