1061 Commits

Author	SHA1	Message	Date
kdletters	ba45ca7048	修复 AGC 发布入口在 DirectProject 下的反馈与确认 ... - 发布动作即时回显权限检查与构建打包状态 - DirectProject 对话渲染项目权限确认卡片并回传确认与取消 - 权限拒绝、取消和查询失败统一回显到项目对话 - 新增发布反馈回归用例并记录排障口径	2026-09-23 12:59:17 +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
kdletters	f502829fde	发布灰度默认关闭：修掉客户端“看得到点不动”与后台看不到 key (#482) ... ## 解决什么 你反馈的两个现象都是真问题，这个 PR 一次修掉： 1. **没开灰度也能看到发布按钮**：发布开关此前是「无 gate 行 = 默认开放」，所以没配灰度时后端把 `gameDistributionPublishEnabled` 判成 true，客户端就渲染了发布入口。 2. **按钮点了没反应**：发布动作的提示原先只写 `workspaceStatus`，而普通项目走 `DirectProjectChatView` 时并不渲染工作台状态行，于是「先打开一个项目再发布」「构建失败…」这类信息全都看不见。 3. **后台看不到 key**：预设项此前在未合并的另一个 PR 里，而且后台只列「已创建」的 gate 行。 ## 改成什么 - `is_game_distribution_publish_enabled_for_user` 要求 gate 行存在且 `enabled=true`：**灰度默认关闭**，未登录/无行/`enabled=false` 一律不开放；只有白名单 / 灰度比例 / 用户标签命中才开放。作者写入与新版本激活都按这条判据。 - 新增与作者无关的总开关 `is_game_distribution_publish_open`：管理员审核激活新版本只看「灰度是否开启」，不会因为审核员不在作者白名单里而被挡住（这是合入后立刻发现的回归，已修 + 有用例）。 - AGC 新增 `announcePublishMessage`：发布相关提示同时写工作台状态与 DirectProject 对话，点「发布到游戏广场」不会再像没反应。 - 后台「灰度发布配置」新增「可配置开关」列表：`game-distribution:publish` 等预设即使还没创建行也会显示，点「配置」按默认关闭填表，运营开启后填白名单/比例即可放量。 ## 验证 - `npm run check:game-distribution-media-e2e`（真实 Phaser 构建产物）现在覆盖：灰度关闭 → 作者拿不到入口 + 写入口 503 → 开启灰度 → 真实封面/截图直传 → 创建游戏/版本/上传/送审 → 管理员审核通过 → 网关 index.html 与 bundle 200 → nosniff；全流程通过。 - 后端：`cargo test -p api-server game_distribution` 19 passed（含新增 `game_distribution_publish_open_ignores_author_allowlist_for_activation`）、`frontend_runtime_config` 6 passed。 - 前端：admin 灰度页 10 用例（含「未创建的预设开关可见并可一键配置」）、AGC 聊天头 3 用例、网页发布页 15 用例；三端 typecheck、`check:encoding`、`check:doc-index`、`check:rustfmt`、全量 `npm test`（400 文件 / 4441 用例）与 `check:repository-ci -- origin/master HEAD` 全绿。 ## 上线注意 灰度默认关闭是**刻意**的：合入后到运营在后台把 `game-distribution:publish` 配置并开启之前，作者看不到发布入口、写入口 503；已公开游戏、目录、详情、发行网关、安全下架不受影响。 Reviewed-on: http://192.168.35.82/git/GenarrativeAI/Genarrative/pulls/482 Co-authored-by: kdletters <kdletters@qq.com> Co-committed-by: kdletters <kdletters@qq.com>	2026-09-22 21:38:03 +08:00
k88936	185649323e	优化 DirectProject 旧消息重解析导致的会话区卡顿 ... 为 ChatMarkdownMessage 加 memo，旧消息文本不变时不再重新解析 Markdown 与语法高亮 流式期间跳过语法高亮，定稿后再补，避免每个 chunk 重跑一遍 highlight.js 为 AgentReasoning 加 memo，内容未变的思考块整块跳过重渲染 把 AgentReasoning 折叠态预览的 Markdown AST 解析收进 useMemo	2026-09-22 20:04:52 +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
suzmii	c2d756a772	Merge branch 'master' into feat/agc-run-preview-tip	2026-09-22 17:28:39 +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
kdletters	e5460280ce	发布入口接入灰度开关 ... - 后端：GET /api/runtime/frontend-config 新增 gameDistributionPublishEnabled，复用 `game-distribution:publish` 判据（未配置或 enabled=false 时对已登录作者默认开放，显式收紧后只放行白名单/灰度命中用户，匿名恒为 false），前端入口与写入口共用同一事实源。 - 后端用例：新增 frontend_runtime_config_game_distribution_publish_is_scoped_to_authenticated_gate，覆盖默认开放、enabled=true 无白名单、白名单命中、deny 名单、enabled=false 回退与 rolloutPercent=100。 - 网页：平台壳按灰度隐藏「发布游戏 / 发布新版本」入口；/games/publish 直接访问时渲染「发布功能正在灰度中」并提供重新检查；读取失败按放行处理，由后端写入口把关并返回可读文案。 - AGC：新增 readGamePublishAvailability（同一运行时配置字段），只有命中才把发布回调交给 DirectProject 聊天头；字段缺失或读取失败按不开放处理。 - 文档：玩法链路、后端数据契约与实施计划记录灰度口径、入口行为与验证命令。	2026-09-22 17:12:04 +08:00
k88936	aa973ea34d	同类问题：另外两个宿主的引用 provider 也按内容签名记忆 ... - PlanningChatView 的 chatProjectAssets 由工作台壳每次渲染重新 .filter() 派生、DirectProjectComposer 的 assets 由 manifest 订阅每次渲染重新派生，两处的 [assets] 依赖同样从不命中缓存 - 两处改用 assetsSignature(...) 做依赖，provider 身份不再随宿主渲染抖动（流式回复时每帧都换），输入区不再每帧重注册 Lexical 更新监听	2026-09-22 17:12:02 +08:00
suzmii	f7250f5dd1	合并 master（bba4f0eb2）：DirectProject 聊天三态与快照文档并入运行页入口收口 ... - 只冲突两份共享记忆的尾部追加（pitfalls / decision-log）：保留双方新增条目，直接合并非取舍 - App.tsx / styles.css 自动合并通过；本分支的运行页入口收口与 onRunNotice 通道未受影响	2026-09-22 17:08:03 +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
kdletters	d047b16b91	合并 master：DirectProject 回合三态与 AGC release 每日调度 ... - 合并 origin/master 11 个提交（DirectProject 回合三态与投影 memo、宿主崩掉后的回合收口、权限拒绝后的忙态、策划对话布局修复、AGC release 每日调度）。 - 本次自动合并无冲突；游戏分发发布入口（App 的 requestGamePublish、DirectProjectChatView 透传、聊天头「发布到游戏广场」按钮）在新聊天状态机下保持接线。 - 验证：root / AGC / admin-web 三端 typecheck、全量 vitest、游戏分发 Rust 测试、encoding、doc-index、rustfmt 与 SpacetimeDB schema guard。	2026-09-22 16:54:38 +08:00
kdletters	f1b282f3cd	合并 master 并接入 DirectProject 新聊天架构 ... - 合并 origin/master（304 个提交：DirectProject 聊天容器重构、Project Supervisor 退役、策划附件导入、CI 隔离编译缓存等）。 - 接受 master 对 ProjectSupervisorView / SupervisorChatOnlyView 的退役与预览快捷测试收敛；发布入口改由 DirectProject 聊天头承载。 - DirectProjectChatHeader 新增「发布到游戏广场」入口（无回调不渲染、回合忙态禁用），DirectProjectChatView 透传 onRequestGamePublish。 - App.tsx 继续由工作台壳持有试玩包导出与 GameDistributionPublishPanel，沿用 project.export_package 权限确认队列；check-config 把该命令从 native-only 清单移回 App invoke。 - 后台游戏审核 API / 类型 / 路由测试与 master 新增的 AGC 模板管理按双方保留合并，并修掉拼接造成的接口与用例闭合缺陷。 - 修正 master 自带的 viteProxyConfig 断言：/api/creation-entry 属退役路由，测试改为断言不进入代理。 - 记录合并踩坑：语法结构内部的冲突不能简单按「双方保留」拼接，必须按某一侧骨架重建并跑 tsc 与单文件测试。 - 验证：全量 vitest 393 文件 / 4374 用例通过，root / AGC / admin-web 三端 typecheck，cargo check 与游戏分发 Rust 测试，encoding、doc-index、rustfmt、SpacetimeDB schema guard。	2026-09-22 16:45:29 +08:00
lhk229	3775e05970	修复策划对话布局与流式显示 (#460) ... 恢复固定消息区域和工作区状态条样式，修正窄屏单列布局 限制长阶段提示、澄清卡片和文件导入结果高度，保证输入区可达 补齐实时正文和思考的滚动跟随，保留用户上滚意图 移除读取策划历史时补造的发送时间 补充布局与显示回归测试，同步技术方案和共享排障约定 Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/460	2026-09-22 16:25:51 +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
k88936	a35956f3ec	宿主崩掉不再留下永远开着的回合：本地命令失败按身份兜底收口 ... - directThreadChat 新增 commandClosedTurnUserItemId 与 stopDirectThreadTurn：本地命令返回即这一轮在宿主那边收场，只放掉「是否在跑」、不写终态时间 - 同身份迟到的 turn.started 不再把这一轮拉回运行态；迟到的 turn.completed 例外放行，仍要拿它补上真正的结束时间 - 身份不同的回合不动：「正在跑的是另一轮」这种拒绝不能顺手抹掉别人的回合 - useDirectThreadChatSubscription 暴露 stopCommandTurn；controller 在真失败分支按本轮身份调用，主动终止与 another-turn-running 不走这条 - 新增用例：reducer 两条（不复活 / 不碰别人的回合）、appSurface 一条（失败后不再显示「陶泥儿正在处理」、输入盒回到发送态）；变异去掉兜底收口后该用例变红 - decision-log 记录本次决策，以及仍未做的宿主侧根因（Rust 侧 drop 守卫补终态事件）	2026-09-22 15:34:48 +08:00
k88936	cab31613f2	权限被拒不再抹掉下一轮的忙态：出队统一交给 finally ... - startTurn 的权限被拒分支不再自己 endTurnCommand + dispatchNextQueuedTurn，改为标记 queueAdvance 交给 finally 收口 - finally 固定顺序：刷新清单 → endTurnCommand() → 出队，保证清忙态早于出队，不再清掉下一轮刚设上的忙态与 pendingUserItemId - 模块注释把这条顺序写成契约，并说明权限被拒这种「本轮从未发出但要继续出队」的走法 - 新增 appSurface 用例：权限被拒 + 后面排着消息时，被出队那一轮在飞期间输入区仍是终止态；改前该用例红	2026-09-22 15:20:38 +08:00
k88936	c8a8b0b0b8	DirectProject 聊天投影补 memo，让下游 memo 不再空转 ... - DirectProjectChatView 的 directTurns 改用 useMemo 缓存，判据为 directEntries / localMessages / directTurnRunning / pendingUserItemId - 注释写明不缓存时每次渲染都是新数组引用，useDirectProjectTurnStatus 里以 turns 为判据的 useMemo 永远命中不了，读者会误以为 turnStatus 引用稳定	2026-09-22 14:56:50 +08:00
k88936	417137baf8	把 DirectProject 聊天状态与数据流的说明写进代码注释 ... - useDirectProjectChatController 模块注释补三层地图、三份原始输入、一次发送的时序（含空窗步骤）与状态变量归属 - DirectChatTurnState 注明三态各自能断言什么、判据的四个输入及来路、state 真值表、两个易读错的点与「finished 拿不到终态时间」的已知边界 - DirectThreadChatState.turnRunning 注明它只是原生真相，不等于界面上的「这一轮在跑吗」 - DirectProjectTurnUsage 注释写清两类「finished 却拿不到终态时间」的回合、覆盖范围与修法口径，说明不再甩给任何文档 - decision-log 的未修边界条目改为指向上述代码位置，避免同一套说明在代码与文档里各留一份	2026-09-22 14:20:27 +08:00
k88936	cfcd3cd604	DirectProject 空窗期不再谎报本轮结束：三态接入渲染 ... - DirectProjectTurnUsage 渲染判据改为 state !== 'finished'，awaiting-start 不再显示「本轮结束于 … 耗时 0.0秒」 - DirectProjectTurn 的过程折叠判据同样改为 state !== 'finished'；流式正文与工具卡片仍按 state === 'running' - 组件注释写明「否定式读 !== 'finished'、肯定式读 === 'running'」这条分工，并标出仍由 A 负责的另一半兜底与覆盖范围 - 新增 tests/directProjectTurn.test.tsx：awaiting-start / running 不显示终态文案且不折叠、finished 有终态时显示结束时间与耗时 - appSurface chat-composer 新增窗口期用例：invoke 挂起且无任何原生事件时不出现「本轮结束于」 - decision-log 追加本条决策、保守卡片口径的理由、未修边界与变异验证结论	2026-09-22 14:07:07 +08:00
k88936	860dcb1bf5	DirectProject 聊天状态显式化：回合三态与「在跑吗」唯一派生入口 ... - DirectChatTurn 的 active 布尔改为三态 state（running / awaiting-start / finished），三态判定收在投影里、用身份而不是时间戳 - buildDirectChatTurns 新增 pendingUserItemId 入参；controller 的 beginTurnCommand / endTurnCommand 与 turnBusy 同生共死地维护它 - 新增 useDirectProjectTurnStatus 作为「在跑吗」的唯一派生入口：nativeRunning / commandInFlight / displayBusy / latestTurnState - DirectProjectChatView 不再手拼 busy：header 与 composer 读 displayBusy，「正在处理」卡片读 nativeRunning - DirectProjectConversation 的 running 入参改名 nativeRunning，语义写在类型注释里 - DirectProjectTurn 改读 turn.state；渲染条件保持不变，awaiting-start 仍按已结束渲染（空窗缺陷另开改动） - directTurnPresentation 的起点优先级与三态判定由嵌套三元改为逐级 if 覆盖 - 新增 directProjectTurnStatus 用例 4 条；directTurnPresentation 补三态用例 4 条并改按 state 断言 - ADR 补「活动回合唯一判据约束的是原生回合」澄清与代码指针 - decision-log 记录本次重构决策、未修的窗口期缺陷与验证证据	2026-09-22 14:06:20 +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	5315b233c8	预览激活回接「运行」入口，聊天 @ 清单打开选择器时按需重读 ... - App.tsx 新增 activateRunningPreview，运行入口先问 Rust 要活体预览（activate_local_game_preview），命中就只切客户端运行视图 - App.tsx 的 executeRunLocal 命中活体预览时经 DirectProject 聊天的 announce 播报「已切换到客户端运行视图」，不再重复调用 start_local_game_preview；stopped / 非本项目 / 权限位要求确认一律回落到重新启动 - check-config.mjs 从 native-only 白名单移除 activate_local_game_preview 并同步注释（该门禁要求 App invoke 与白名单互斥） - DirectProjectComposer 新增 onReferencePickerOpen，工具条按钮与附件菜单两处选择器入口打开前先刷新清单 - DirectProjectChatView 用 useDirectProjectManifest 的 refresh 重读聊天自己那份 @ 清单，不新增壳到聊天的清单推送通道 - 新增 tests/previewActivation.test.tsx，钉住切视图不重启 / stopped 回落重启 / 权限确认回落重启三条路径 - decision-log 记录本轮两处回归的背景、决策、取舍与验证方式	2026-09-21 23:09:43 +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
suzmii	cc8c03a40d	运行游戏不再往聊天写"运行通过"提示 ... - 删掉 AGC 播放/运行本地游戏成功后的聊天提示：它每次播放都会堆在对话底部遮挡运行画面，成功与否由客户端运行视图本身体现，失败仍照原样回报 - appSurface 三处用例改为断言 start_local_game_preview 真被调用且聊天里不再出现该提示 - 补排障记录：本地 node_modules 内置 Codex 原生包过旧会让 AGC build script panic，需在仓库根目录 npm ci	2026-09-21 19:08:43 +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
k88936	ec408bfafd	删除 DirectProject 聊天 IPC 的死参数 prompt ... Rust 侧删掉 chat_with_game_creator_direct_codex 的 prompt 入参：回合输入只由 canonical userItem 派生，该参数从未被读取 DirectProjectTurnInput 去掉 prompt 字段，提交与排队派发不再计算 @显示名 投影文本 界面断言改读 userItem.content，并删掉退役的附件 sidecar 用例与只断言「不存在」的终止用例 同步实施计划与附件路径映射两份技术方案里的 Direct 消息契约 共享记忆补记该死参数的口径与成因	2026-09-21 14:27:23 +08:00
k88936	ab52805d3c	收口DirectProject输入区canonical content唯一事实源 ... 删除输入区 text/references 双轨草稿状态 Direct 与 Planning 改为从 Lexical content 读取 润色保留 chip 并保护附件 canonical content 增加 legacy content DTO 单向翻译与附件回归测试 补充 DirectProject composer canonical content 实施计划	2026-09-21 14:11:18 +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	ba3bd59f24	恢复策划 Agent 实时事件订阅（876529e66 误删） ... - apps/ai-game-creator-shell/src/App.tsx 重新订阅 `design-agent-update`：本轮正文与工具提示回到 transient reply，`reasoningText` 回到 `planningV2Reasoning`，`view` 回到 applyDesignAgentViewAfterTransient；Rust 侧一直照旧发射这些事件，前端却不再监听 - 补回 designAgentEventSubscriptionReadyRef 的建/解函数与 designAgentEventSubscriptionResolveRef，让 `executeDesignAgentTurn` 等待监听器挂好再发起回合，开局事件不丢 - 新增 designAgentReasoningTurnRef：回合结束（designAgentTurnRef 清空）后仍认本轮 reasoning，最后一条思考不会被视图落盘前的空隙吃掉；切项目时随 resetChatState 清空	2026-09-21 12:21:51 +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