3548 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
suzmii	87fbf92c58	合并 origin/master 到资源工作台 V3 分支：解 4 处冲突并保留两侧行为 ... - WorkspaceLauncher.tsx：保留本分支清单快照 CAS 拒收提示（manifestMergeNotice 提示条、data-manifest-merge-* 观察点、recoverRejectedManifestSnapshot「重新读取清单」）与 activeVersionId/onActiveVersionChange 版本口径，并入 master 的策划/游戏运行态切换（onMakeGame + switchToGameRuntime、suppressInitialGameTurn 抑制首轮、supervisor key 带 agentRuntimeMode、onSwitchToGameRuntime），planningStartMode 统一取 master 的派生值（上下文 startMode 为 planning 且未切到 game 运行时） - ProjectSupervisorView.tsx：props 同时保留本分支 versions/activeVersionId 与 master 的 designView/onDesignApprove/onDesignClarify/onDesignRetry，DesignAgentSurface 审批链路与本分支资源引用输入区并存；directCodex 输入区保留本分支 @ 引用按钮 + 模型选择 + 发送按钮控制条，发送按钮禁用条件并入 master 的 designView 审批待定口径，模型选择沿用 master 的「对话中可切换」口径 - styles.css：本分支追加的资源画布/输入区样式块与 master 追加的 .design-agent-reasoning 样式块都保留，并补上本分支最后一条规则的收尾大括号 - view/project-development/index.tsx：保留本分支的 image-editor 引用（ImageCanvasProjectAssetPickerDialog、ImageCanvasQuickEditPanelView、ImageCanvasSelectedLayerToolbarView、useImageCanvasFloatingOptionDismiss），去掉 master 对已退役 features/asset-canvas 的 import（本分支已由 resource-canvas 取代），保留 master 的 DesignWorkspacePanel 与 planningStartMode 策划工作台分支 - tests/workspaceLauncherManifestMerge.test.tsx：补 master 新引入的 get_design_agent_runtime_mode mock（返回 null，与 master 各套件同口径），拒收提示断言不变 - tests/appSurface/design-agent.suite.ts：审批待定禁用输入的断言改用本分支 Lexical 输入区的禁用口径（容器 data-disabled + editor.setEditable(false)），断言意图不变 - 验证：npm run typecheck 通过；apps/ai-game-creator-shell typecheck 通过；apps/ai-game-creator-shell/tests 96 个测试文件 1380 通过 4 跳过 0 失败；全仓 vitest 297 通过 2 失败（scripts 下两例为 Windows 权限语义导致的既有失败，相关文件与实现均未参与本次合并）；npm run check:encoding 与 git diff --check 通过	2026-09-12 17:31:51 +08:00
suzmii	2d40f02286	合并资源工作台分支：素材类型可由用户变更与角标显示资源类型并入 ... - 把 v3 顶端 ace31a5f1（快速编辑 @ 引用素材 + @ 面板标签筛选）合入本分支，与本分支 1079f6c91（用户可变更素材类型、角标改显示资源类型）并存 - 冲突零：index.tsx 两侧改动落点不同（快速编辑 promptInputSlot 接线 vs 角标取值点），projectResourceLiveIntegration 与验收文档自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + projectResourceLiveIntegration 共 45 tests 全绿；check:encoding 4409 文件通过；git diff --check 干净	2026-09-12 16:57:28 +08:00
suzmii	1079f6c91b	资源工作台可变更素材类型：面板加类型选择器、卡片角标改显示资源类型 ... - ResourceClassificationPanel.tsx：加素材类型（功能分类）选择器，与标签同一次保存、同一条写入路径；选项 = GAME_CREATION_APP_ASSET_CATEGORIES × resourceReferenceCategoryLabel，不新造第二套中文译名 - ResourceClassificationPanel.tsx：选择器读显示口径（与画布栏目 projectResourceAssetCategory 同源，选中项就是卡片所在栏目）；写回分两路——没碰过类型控件回传 gameCreationAppAssetPersistedCategory 的落盘原值，主动选过才写用户选的值（categoryChoice ?? persisted），保证「只改标签」不漂移分类 - index.tsx：资源卡右上角角标由「文件/媒体类型」改为「资源类型」，取 categoryLabels[resource.category]（栏目与筛选共用的同一份文案），角标恒等于该卡所在栏目；projectResourceTypeLabel 仍服务资源管理面板小字与总览摞分列，不再用于角标 - tests/resourceClassificationPanel.test.tsx：新增「变更素材类型」6 条用例（选择器 6 项与中文口径、选择器显示显示口径自愈值、主动选值写入载荷、只改标签回传落盘原值对照、显式待归类写入 unclassified、连续两次各带当次选择且不关窗），并按新增控件更新既有按钮序与「分类不再由面板编辑」两条断言 - tests/projectResourceLiveIntegration.test.tsx：新增真宿主跟随链用例（角标显示资源类型并与栏目同名、改类型后卡片进目标栏目且角标跟着变、原栏目不再有它），配套状态化宿主 fixture、分类写入与 get_local_game_manifest 两条命令桩、切栏目与读角标助手 - tests/appSurface/project-development.suite.ts：原 data-resource-type 媒体类型断言改为资源类型（角色与对象 / 待归类 / 音频），并说明卡面正文走媒体分支、角标走资源类型这两个独立轴 - docs：PRD §5.3 由「分类没有用户手动设置入口」改为当前两口径分叉（选择器读显示口径、写回按是否主动选过分流）与「显式待归类被读时自愈覆盖」盲区 - docs：AGC 资源工作台 V3 端到端验收 S5 的「前端交互不能改分类」改写为可改分类，补判据（角标读 .game-resource-card-type-badge）与盲区说明；实施计划写入命令一节的面板名与职责同步为「编辑素材标签（标签 + 素材类型）」 - docs：decision-log 新增条目记录本次决策（Rust 无需改动、画布跟随链无需额外迁移代码、待归类盲区、四条变异验证结果与一条不可构造的变异） - 说明：Rust、manifest 字段构成与 SpacetimeDB 均不改；写入命令 update_local_project_resource_classification 早已接受任意合法 category	2026-09-12 16:54:24 +08:00
suzmii	ace31a5f19	合并资源工作台分支：快速编辑 @ 引用素材与标签面板不关窗两套行为并存 ... - 把 v3 顶端 46788edbb（「编辑素材标签」保存后不关窗）合入本分支，与 35d3a92af（快速编辑支持 @ 引用素材、@ 面板补标签筛选）并存 - 冲突零：index.tsx 两侧改动落在不同位置（keepClassificationPanelOpen 与 quickEditReferences/promptInputSlot 接线），自动合并 - 验证：npm run typecheck exit 0；resourceClassificationPanel + resourceVersionReplacement + resourceReferenceInput + projectResourceLiveIntegration 共 4 files / 73 tests 全绿	2026-09-12 16:51:56 +08:00
suzmii	35d3a92afd	快速编辑提示词支持 @ 引用素材，@ 面板补标签筛选 ... - 快速编辑面板提示词换成与聊天同一个 `ResourceReferenceInput`，`@` 候选、插入动作与引用模型全部复用聊天那一套 - 共享 composer / 快速编辑面板新增 `promptInputSlot` 注入位，宿主控件替换默认 textarea，不传时 DOM 与行为逐字不变 - `ResourceReferenceInput` 新增 `showPolishAction`：快速编辑的润色仍由 ResourcePromptPolishSlot 承担，面板里不再出现第二个润色入口 - `ResourceReferenceInput` 的多行输入区把 Enter 留给换行，只有单行输入区才用 Enter 提交 - `@` 面板的搜索与筛选改用共享 `PlatformResourceFilterBar`，搜索 + 功能分类 + 标签三者在面板内叠加生效 - 新增 `resourceReferenceMatchesTagSelection` / `resourceReferenceTagLibrary`，标签口径（多标签 AND、计数与排序）落在共享标签库，两个页签各持一份 - 宿主新增 `quickEditReferences` 与 `applyResourceQuickEditDraft`，派生请求的 prompt 就是输入区回填的那份文本（`@显示名`），不引入第二种引用格式 - `useImageCanvasFloatingOptionDismiss` 新增 `isInsideExtraOverlay`：宿主 portal 到 body 的 `@` 选择器与候选菜单不再被判成点外部而收起快速编辑面板 - 资源画布快速编辑提示词输入区补样式（铺满 composer 一整行、高度上限），`@` 面板去掉手写搜索行样式 - 用例：新增标签库口径、标签筛选（多标签叠加 + 关键字 + 功能分类）、两页签独立标签、聊天与快速编辑草稿一致性、快速编辑内 `@` 出选择器且派生 payload 断言；扩展 AGC 资源工作台 V3 端到端验收用例	2026-09-12 16:44:55 +08:00
lhk229	3f69ce8bb7	Merge pull request '重构策划agent，接入新工作流+harness' (#322) from design_agent_refactor into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/322	2026-09-12 16:10:07 +08:00
suzmii	46788edbb8	修复「编辑素材标签」保存后关窗：点「添加」成功后面板保持打开，可连续添加 ... - 定位关窗来源：面板的 saveResourceClassification 只调 onSaved、从不调 onClose；真正卸载面板的是宿主 index.tsx 的 setResourceClassificationAssetId(null)（在 reloadManifestAfterAssetCommand 里，由 handleResourceClassificationSaved 触发） - 在宿主层给 reloadManifestAfterAssetCommand 加 keepClassificationPanelOpen 开关：默认仍然收起，删除素材 / 版本替换 / 重命名的既有行为不变，只有标签保存显式传 true - 标签保存后不再清 resourceClassificationAssetId：面板保持打开，新标签已落成 pill、输入框已清空，用户可以接着加下一个标签 - 关闭面板仍只走头部 ×；标签 pill 内的「删除标签」按钮与删除素材流程都不受影响 - 面板用例：添加后不得调用 onClose、面板仍在、新标签出现在已有标签列表、输入框清空；连续两次「添加」各自写盘且第二次带上累计标签、category 仍原样回传落盘值 - 工台用例（resourceVersionReplacement.test.tsx）补真宿主链路：经工具条「编辑标签」打开面板 → 添加 → 断言写入载荷与面板仍在 → 再添加一次 → 两次写入各自发生且面板依然打开（只测面板组件看不出宿主把面板卸载了）	2026-09-12 15:59:44 +08:00
lhk229	2e87a1403a	自动隔离损坏的策划会话并修复 CI ... 会话读取损坏时自动备份并允许项目继续打开 登记会话重置命令并补齐 Native shell 配置检查	2026-09-12 07:48:07 +00:00
lhk229	f505d2792f	允许损坏策划会话降级打开项目 ... 会话读取失败时保留工作台与产物访问能力 新增策划会话备份重置命令，不删除工作区产物	2026-09-12 07:33:49 +00:00
suzmii	dc243b0d57	资源工作台「替换素材」候选窗接上预览管线，补齐候选排序、禁用态可读性与删除素材入口 ... - 「替换素材」候选卡缩略图接入资源卡同一条预览管线：新增 ResourcePreviewMedia，复用同一份预览身份、同一条队列与 LRU 缓存，不再只渲染类型占位图标 - 预览 hook 暴露 sweepVisiblePreviews：弹窗内容挂在 portal 下、不在资源画本 observer 的 root 子树内，改为在「弹窗打开」与「候选区滚动」两个几何变化点显式按同一套视口几何判据兜底放行，不新增第二条加载通路 - 候选排序抽出纯函数 sortResourceReplacementCandidates：可替换（无硬门禁失败）的排最前，其余按后端原名次跟随且仍渲染但禁用；判据与弹窗禁用状态同源，不会出现「排最前却点不动」 - 抽出纯函数 projectResourcesByManifestAssetId，让弹窗素材映射与候选缩略图共用同一份资源投影口径 - 共享选择弹窗的禁用态不再整卡压透明度：变灰只压在缩略图与名称上，「分类不同」这类禁用原因保持全对比度可读（网页端美术画布不传禁用原因，视觉逐字不变） - 资源卡选中工具条末位新增「删除素材」，前置共享工具条同一套分隔线与前面的非破坏性动作隔开，只在 manifestAssetId 存在时才渲染 - 删除流程抽成 useResourceAssetDeleteFlow（读引用信息 → ResourceAssetDeleteDialog 二次确认 → delete_local_project_asset 的 deleteReferencedVersions 三分支），工具条与面板共用同一份实现，没有第二套删除 - 「编辑素材标签」面板底部只留右下角一个「添加」：点它把输入框内容（含未按回车的尾巴）落成 pill 并按现有写入路径保存，分类仍原样回传落盘原值；删除素材/取消/保存标签三个按钮移除，关闭仍走头部 × - 标签 pill 内的删除标签按钮保持不变 - 更新与补充用例：候选排序、排序与禁用同源、候选缩略图真链路与滚动兜底放行、工具条删除入口位置与 IPC 载荷、连带删除分支、面板无删除入口与「添加」语义、禁用态可读性类名契约、工具条动作清单	2026-09-12 15:30:38 +08:00
lhk229	74fad546ff	增加 Responses 槽位安全保险丝 ... 拒绝超出 4096 的 output_index，避免异常上游输入触发巨额扩容 补充安全边界测试且不限制正常输出内容	2026-09-12 07:17:16 +00:00
lhk229	16a6cdaf79	修复策划审批回调跨项目污染 ... 为审批响应增加项目路径与请求身份校验 防止旧项目回调覆盖当前会话并清理新项目状态	2026-09-12 07:11:40 +00:00
suzmii	33a85a67b8	Merge remote-tracking branch 'origin/master' into fix/agc-manifest-revision-cas	2026-09-12 14:44:15 +08:00
lhk229	832f1e8b59	修复策划项目重开运行态恢复 ... 持久化策划项目 design 运行模式并在重开时恢复 design/game 工作台。 补充旧策划会话兼容判断、前端夹具和恢复回归测试。	2026-09-12 06:41:49 +00:00
suzmii	c76ecd07ab	修正合并带入的 rustfmt 漂移与换行符，恢复 Repository checks ... - cargo fmt 三个由 feat/agc-resource-replace 带入且从未跑过 CI 的 Rust 文件：version_resource_replacement.rs、manifest/version_binding_rewrite_tests.rs、tests/version_resource_replacement.rs - 四个文件统一为 LF，修掉 rustfmt 报的 Incorrect newline style：shared-contracts/game_creation_app.rs、view/project-development/index.tsx、decision-log.md、技术方案文档 - 本地按 CI 链复跑：encoding / npm-workspaces / spacetime-schema / production-ops / preview-deployer / maintenance-page / rustfmt / eslint / typecheck 全部 exit 0 - check:git-hooks 仍红，但红在已知 Windows EBUSY 抖动（rmdir 临时 repo 被占用），Linux CI 不受影响	2026-09-12 14:36:23 +08:00
suzmii	281e6ccf48	Merge branch 'master' into design_agent_refactor	2026-09-12 14:25:29 +08:00
lhk229	013c756b9e	Merge pull request 'CI 偶发失败修复：独立 crate 的 crates.io 预热缺口与两条用例自身缺陷' (#328) from fix/ci-flaky-and-crates-io-fetch into master ... Reviewed-on: https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/328 Reviewed-by: 孔令弘 <ink29535@proton.me>	2026-09-12 14:23:46 +08:00
suzmii	e4ee6c2be8	合并 feat/agc-resource-replace：把「替换素材」接进资源工作台 ... - 解冲突 project/manifest.rs：保留版本写入公共体 write_manifest_locked_with_version_guard（版本只追加 + 绑定改写放行），并把 schema 校验并入该公共体，两侧语义都不丢 - 解冲突 shared-contracts：取当前分支的读显示口径 game_creation_app_asset_effective_category（含与 TS 交叉钉住的 EFFECTIVE_CATEGORY_CONTRACT 矩阵），同步改写 version_resource_replacement 对旧函数名的调用 - 解冲突 index.tsx：两处均为纯 import 追加，两侧都保留 - 解冲突 decision-log 与技术方案文档：两侧条目都是追加，全部保留 - 随之进入本分支：版本绑定改写窄放行通道、直接替换命令与其兼容性判据、资源卡工具条「替换素材」入口	2026-09-12 14:19:03 +08:00
lhk229	e602d3b420	Merge branch 'master' into fix/ci-flaky-and-crates-io-fetch	2026-09-12 13:56:23 +08:00
suzmii	3015370286	补 C7 版本切换「重载当前预览」验收测试 ... - resourceVersionSwitch 新增用例：运行模块内切换版本必须既上报宿主又触发 onPlay 重载预览 - 覆盖验收用例 S16 的「并重载当前预览」条款（此前版本入口只测了记录层与高亮，重载没有守卫） - 变异验证：摘掉 selectActiveVersion 里的 onPlay 调用后，该用例以 expected "spy" to be called at least once 失败 - 定向验证：resourceVersionSwitch 4 passed	2026-09-12 13:34:32 +08:00
suzmii	028b20a590	修复清单快照误判：CAS 判据面收窄为「资源 + 版本」，预览起停不再触发用户可见拒收 ... - projectResourceLiveUpdateModel 新增 manifestCasFingerprint，按 { assets, versions } 判定同版本号冲突 - 同 revision 且判据面一致时，仅非 CAS 账目状态（preview 运行地址/端口、任务进度、项目名）变化改为 accepted 并让内容落地，revision 不推不退 - 判据面变化仍判 revision-conflict，保留「改了被保护内容却没推 revision」的可观测信号，不吞真实缺陷 - 新增回归用例：同 revision 仅预览状态变化必须被接受；同 revision 资产变化必须仍被拒收 - 变异验证：把判据改回整份 JSON 指纹后，新用例以 expected 'revision-conflict' to be 'accepted' 失败 - 定向验证：projectResourceLiveUpdateModel 17 passed、workspaceLauncherManifestMerge 5 passed、appSurface 413 passed、npm run typecheck exit 0、npm run check:encoding 4399 files passed、git diff --check 干净 - 同步 decision-log 与 pitfalls 记录 CAS 判据面契约与本次取证	2026-09-12 13:30:18 +08:00
lhk229	a4373d7494	修正策划资源文档引用路径 ... 将阶段 Skill 和系统模块中的旧附件名称统一为资源逻辑路径。 修正模板、范例、系统总纲及模块配套文件引用。	2026-09-12 05:28:26 +00:00
lhk229	34616e1631	修复 CI 调试工作区测试 ... 格式化 design runtime 调试命令 为 debug fixture 测试显式开启并清理 debug 环境变量	2026-09-12 05:21:21 +00:00
lhk229	226cfbc8a1	Merge branch 'master' into design_agent_refactor	2026-09-12 13:10:41 +08:00
lhk229	8853e3b48e	完善策划调试入口与顾问态切换 ... 统一策划 Debug 日志、快速推进按钮和快速推进命令的开关。 将做成游戏入口放到顾问阶段条末尾并接入正常运行时切换。 登记策划产物资产并补充工作区调试入口测试与技术文档。	2026-09-12 05:06:48 +00:00
suzmii	38cd688d71	Merge remote-tracking branch 'origin/master' into fix/agc-all-resources-zoom	2026-09-12 12:25:36 +08:00
suzmii	349c9d80ce	修复「所有资源」页面缩放读取错误视口 ... 展开态缩放、滚轮、平移和卡片拖动改读 all 专用内存视口 ref 避免复用普通栏目页视口导致按钮按下后倍率被旧状态覆盖 补充所有资源连续缩放 appSurface 回归断言，并同步更新项目决策与踩坑记录	2026-09-12 12:25:27 +08:00
k88936	e50d678411	Merge pull request '修复[dev]下agc启动时长时间白屏' (#333) from boot-time-diagnosis into master ... Reviewed-on: #333	2026-09-12 11:19:25 +08:00
k88936	727794bc95	Merge branch 'master' into boot-time-diagnosis	2026-09-12 10:58:33 +08:00
k88936	cc9b95ddef	优化调试配置：提升SHA-256计算性能，避免调试构建阻塞	2026-09-12 10:54:51 +08:00
lhk229	22c4807612	删除策划对话栏未接通的文件浏览死接线 ... DesignAgentSurface 移除从未消费的 files 与预览 props ProjectSupervisorView 同步移除死 props 声明与透传 App 移除 designWorkspaceFiles 等状态与 refreshDesignWorkspace，每轮策划事件不再多打一次 list_design_workspace	2026-09-12 09:44:09 +08:00
suzmii	3f7e41e466	「所有资源」展开态改回平铺画布：不再为每个栏目渲染标题栏 ... 展开态真实栏目不再渲染栏目标题栏，整个场景只留 all 那一条钉在视口上、带「资源总览」收起入口的标题栏 原因是分带只为有可见资源的栏目生成，空栏目拿不到标题栏矩形后全部回落到世界原点叠成一摞（空项目必现，现场是 7 条） ResourceBookSceneCategoryPlan 新增 titlebar 字段，渲染层按它决定是否产出标题栏节点 分带去掉标题栏横带的高度预留与矩形换算，删除 RESOURCE_BOOK_ALL_BAND_TITLE_HEIGHT 与 resourceBookAllTitlebarRects 拖动写回口径不变（resourceBookAllBandLocalPoint 一行未改），零 CSS 变更 resourceBookLayout.test 与 appSurface 两条「所有资源」用例加反向守卫；变异验证改回旧行为时两条同时红（got 7） decision-log 与 pitfalls 记这次倒因为「缺一路坐标输入时不要静默回落到原点」	2026-09-12 09:38:03 +08:00
suzmii	5b62d1e4ef	修复资源登记把任意图片写成 ui 类型 ... 停用本地导入图片的 ui 默认 kind：agent_local_project_file_type 的图片扩展名分支改写 canonical image（派生 unclassified，落「待归类」），并注明不许把 ui 当图片默认值及其不可恢复原因——读时自愈只在落盘 category 为 unclassified 时触发，kind 本身写错时自愈只会把错值放大成 ui-interaction 账户素材导入改用平台真实类型：新增 imported_platform_asset_kind，账户素材库记录自带的 assetKind 不再被常量 ui 顶掉，缺失才退回中性 image 平台素材导入改用响应里的 assetKind：网页项目画布与平台素材导入同样走 imported_platform_asset_kind，不再写死 ui 上传素材按内容证据推导 kind：upload_local_asset_at 不再把来源词 uploaded 当类型，改由 uploaded_asset_kind 按 mediaType 与扩展名推导 audio/video/image/document/code，判不出才用中性 asset；同一命令也收 .wav 与 .md，因此不能一刀切成 image 补 4 处回归与反查用例：本地导入与上传断言落盘 kind 与 category 且不得出现 ui、ui-interaction、uploaded；两处平台导入的 kind 解析加纯函数单测与调用点反查门禁；变异把错值改回来必须变红（M1/M2/M3 实测 4 个用例全红，还原后 diff 与基线逐字节一致） 覆盖边界：账户素材库与平台素材导入是异步 HTTP 路径，仓库内没有可复用的端到端夹具，这两条覆盖是纯函数单测加调用点反查门禁，不是端到端断言；本地导入与上传是读落盘 manifest 的行为级断言 后续事项：ImportedAsset.asset_kind 仍返回平台原始值（缺失为 none），与已落盘 kind 可能不一致，本次未改动	2026-09-12 02:30:31 +08:00
suzmii	90177308e0	pitfalls：补记「同一条命令的口径差异」——CI 用提交范围比较 git diff --check ... - docs/project-memory/shared-memory/pitfalls.md：在「只跑门禁子集 → 同一天两次 CI 红」条目的「原因」里补第三类成因 - 口径差异：CI 跑 git diff --check "${base_ref}"..."${head_ref}"（提交范围），本地裸跑 git diff --check（工作树 vs 索引）在干净树上恒为空，所以本地绿不能证明 CI 这一跳会过 - 实例：pitfalls.md 末尾多出的空行（f16aa440b 引入），因前两次推送分别停在 check:git-hooks 与 check:rustfmt 而一直未被这一跳检查	2026-09-12 02:07:49 +08:00
suzmii	a5c7938d05	修 CI：去掉 pitfalls.md 末尾多余空行（git diff --check 报 new blank line at EOF） ... - docs/project-memory/shared-memory/pitfalls.md：删掉文件末尾多出的一个空行，使文件以单个换行结尾（UTF-8 无 BOM、LF 不变，仅 -1 行） - 该空行由先前提交 f16aa440b 引入；前两次 CI 分别停在 check:git-hooks 与 check:rustfmt，都没走到最后一道 git diff --check，因此一直潜伏 - 自检口径按 CI：git diff --check fafe6b63c..HEAD（CI 是提交范围比较；本地裸跑 git diff --check 在干净树上恒为空，看不出来）	2026-09-12 02:02:12 +08:00
suzmii	31fcbb79dc	pitfalls：记一条「只跑门禁子集 → 同一天两次 CI 红」 ... - 现象：dd7cf401a 给 lint-staged 加 *.rs 键，但本地从未跑过 check:git-hooks（它是 npm run lint 链里的一环），而 scripts/git-hooks.test.mjs 用 assert.deepEqual 钉住 lint-staged 的整份配置形状 → CI 以 deepStrictEqual 失败；本批更早还因 check:rustfmt 红过一次（15660a98b 修 8 处格式偏差），成因是 pre-commit 的 lint-staged 当时只覆盖 *.{js,mjs,cjs,ts,tsx}，Rust 格式本地无守卫 - 原因：npm run lint 是一条 && 长链（encoding / npm-workspaces / git-hooks / rustfmt / spacetime-schema / production-ops / preview-deployer / maintenance-page / eslint / typecheck），中间任一步失败则其后步骤根本不执行，「跑到第 N 步就以为本地绿了」；更隐蔽的是本地若因环境原因在中间断掉（如 Windows 上 check:git-hooks 第 2 个用例的 EBUSY），后面那些本来能通过的步骤也从未被验证 - 处理：push 前按完整链路跑；&& 链在某一步失败时，必须把失败步之后的每一步单独再跑一遍（10 步 + git diff --check）并逐条记 exit code（取 exit code 不要接管道）；改动碰到 package.json / .husky/ / scripts/ 下的门禁资产时，check:git-hooks 是必跑项 - 验证：本次 check:git-hooks 因本机 Windows EBUSY 中断后，补跑其后各步全部 exit 0（spacetime-schema / production-ops / preview-deployer / maintenance-page / lint:eslint / typecheck / encoding），只有 check:rustfmt 红且红在别人在途的 .rs（assets.rs:519 落在其未提交 hunk +470,62、commands.rs:3079 落在其未提交 hunk +3068,58）；变异验证：把 *.rs 从 package.json 摘掉 → 第 1 个用例以同样的 deepStrictEqual operator 变红，还原（SHA256 一致）后回 ok - 纯文档追加：文件末尾 +8 行、无删改；本条只提交 docs/project-memory/shared-memory/pitfalls.md 一个路径	2026-09-12 01:28:05 +08:00
suzmii	21da95387b	decision-log：把守卫范围与本地限制两条裁定写进既有条目 ... - 取舍 bullet 补裁定理由：保持「整个 workspace」检查、不换成只查暂存文件（rustfmt --check --skip-children 与 cargo fmt 的口径不一致）；本批两次 CI 红的共同根因是「本地绿 ≠ CI 绿」，守卫必须与 CI 同口径 - 取舍 bullet 补流程归因：共树里的硌人是「共享 worktree」的症状、不是守卫的问题，对应流程修正是「一条线一个 worktree」 - 本地限制 bullet 定性为「本机环境限制，不是 CI 会红」，写明根因（Windows/WSL 跨 /mnt/c 的临时目录句柄在子进程退出后仍被持有）、删除重试实测无效且已还原、残留目录会累积（清前 16 个、最早 2026-09-05，本轮已清 0），并给出「Linux CI 上通过」的依据 - 明确裁定：接受该用例在 Windows 上红，不改它语义、本批不再修	2026-09-12 01:15:11 +08:00
suzmii	9fea60b850	append 锁：预算与项目写锁对齐、超时报可诊断的持锁方、争用做有界退避重试 ... - project/agent_db.rs：等待预算从 10ms×100≈1s 改为 5ms×2000≈10s，与项目写锁完整窗口同口径；新增 lock_short（5ms×200≈1s）供只读路径使用 - project/agent_db.rs：超时文案在锁路径后追加持锁方线索（读锁文件里的诊断元数据，读不到就明说不可读），现场不再只拿到一句"检查运行时配置" - project/agent_db.rs：取锁成功后把 label/pid/processStartedAt/acquiredAt 写进锁文件；仅作诊断，不参与判活、回收或抢占，同一进程重复取同一把锁不重写 - project/agent_db.rs：抽出 PROJECT_APPEND_LOCK_TIMEOUT_MARKER 常量，控制流不再各自复制中文 - project/conversation.rs：整份读对话记录的两处只读入口改用短窗口，避免把面板读路径一起拖住 - agent/direct_project_history.rs：争用类失败做一次有界退避重试（250ms）；格式类失败不重试 - agent/direct_runtime.rs：锁争用给可操作提示（另一个客户端进程正在读写该项目历史或项目锁，请稍后重试，确认没有其它客户端再重启），retryable 保持 true，但现在确实会自动重试 - 用例：预算口径、锁文件诊断元数据、持锁方线索、被独占持有时超时且不留残留、争用重试成功、超出预算失败关闭、格式类不重试 - 变异验证：预算常量改回 1s → 预算用例红（left 10ms / right 5ms）；去掉重试 → 重试用例红（append after retry 直接报跨进程锁超时）；验证后已还原	2026-09-12 01:09:37 +08:00
suzmii	cafd989bfb	decision-log：记录 pre-commit 新增 Rust 格式守卫的取舍与本地限制 ... - 新增 2026-09-11 条目：背景（本地无 Rust 守卫、CI check:rustfmt 是唯一防线）、决策（lint-staged 增 *.rs + 包装脚本对两个 workspace 只查不改）、连带维护点（git-hooks.test.mjs 钉住整份配置形状，增键必须同步） - 记下刻意保留的取舍：无暂存 .rs 时不触发；一旦暂存 .rs 则按整个 workspace 检查（与 CI 同口径），副作用是别人的未暂存未格式化 .rs 会挡住本次提交 - 记下未修的本地限制：check:git-hooks 第 2 个用例在 Windows 因 finally 里 rmSync 报 EBUSY 而红（断言全过、红在清理），TEMP 里堆了 16 个残留目录最早到 2026-09-05，加删除重试实测无效，CI 在 Linux 上不受影响 - 不动历史条目：2026-08-12 那条的「提交门禁」一行按本文件顶部口径只用于追溯	2026-09-12 01:01:51 +08:00
lhk229	86adaa738f	修复策划首轮错 lane 挂载导致 Agent 不工作 ... 运行模式改为随项目上下文同步派生，移除 effect 后置修正 做成游戏切换记录按项目路径与创建时间定位，跨项目自动失效 消除首帧游戏运行时挂载消耗首轮 claim 后策划实例无法补发的问题	2026-09-12 00:48:02 +08:00
suzmii	2a7bfadd72	修 CI：git-hooks 回归用例跟上 lint-staged 新增的 *.rs 守卫 ... - scripts/git-hooks.test.mjs 用 assert.deepEqual 钉住 package.json 的 lint-staged 整份配置形状，dd7cf401a 新增 *.rs 键时漏了同步，Repository checks（经 npm run lint → check:git-hooks）deepStrictEqual 失败 - 按新形态补上 '*.rs': ['node scripts/lint-staged-rustfmt.mjs']，不放宽断言：仍是整份配置的 deepStrictEqual，改回「只要含 js 那条就算过」这类弱化写法一律不做 - 第 2 个用例里的本地 lintStagedConfig 是 temp repo 的测试替身，不是对真实配置的期望：temp repo 里没有 Rust 文件，加 *.rs 只会命中 0 个文件，故不动 - 变异验证：把 *.rs 从 package.json 摘掉 → 本用例以同样的 deepStrictEqual operator 变红（# fail 2）；还原（package.json 字节级哈希一致）后复跑该用例回到 ok	2026-09-12 00:43:49 +08:00
suzmii	77871bfa56	把可能弹 UAC 的 ACL 提权修复移出 append 锁的持锁窗口 ... - project/agent_db.rs：Windows 取锁成功路径不再在"已持有零共享句柄"时做带提权的 ACL 修复；持锁期间只做不提权的严格校验，校验不过就先释放句柄、再提权修复，并返回"这轮没取到锁"由外层重试循环按修复后的 DACL 重新打开 - project/agent_db.rs：新增 release_project_append_os_lock_then_repair_acl，参数按值接收锁句柄且函数体第一件事是 drop，使"边持锁边等 UAC"在签名层面无法被表达 - 原因：提权修复走 powershell Start-Process -Verb RunAs -Wait 同步等用户点 UAC，在持锁期间等它等于把用户犹豫的时间记进别人的持锁窗口；只有 Windows 存在这条路径 - 判据（结构级）：提权修复只在此一处被调用，且调用点必须交出句柄所有权；测试环境不弹真 UAC（config.rs 测试分支本地收紧），故不写假 UAC 用例 - 真机判据：DACL 有缺陷的机器上，持锁方进入修复期间不再持锁，等待方从"超时"变为可成功 - 不变项：首次创建锁文件的本地 harden 仍留在持锁期间（本进程新建对象不因继承 DACL 自动提权）	2026-09-12 00:12:52 +08:00
suzmii	1affb5eec3	锁内只保留 append：DirectProject 历史的幂等回扫移出持锁窗口 ... - direct_project_history.rs：幂等回扫与序列化移到取锁之前，取锁后常态只做一次追加，不再在锁内读完并逐行解析整份历史 - direct_project_history.rs：回扫到取锁之间若历史文件变了（len/mtime 与回扫时不一致）才回到锁内重扫一次；同一 id 不写第二行的语义不放宽，只是常态不再为它读整份文件 - direct_project_history.rs：新增 direct_project_history_duplicate_at 三态判定（Absent/Identical/Conflict）与回扫状态快照，对外行为与原实现一致（幂等 no-op、id 冲突失败关闭） - direct_project_history.rs：新增回扫探针（两个时点回调）与三条用例：回扫在 append 锁外、锁外回扫后并发追加仍不重复写、id 冲突仍失败关闭 - project/agent_db.rs：新增测试专用探针 project_append_os_lock_is_held_for_test，用与生产同一套打开方式判断追加写目标的锁此刻是否被持有 - 变异验证：把回扫塞回锁内后 idempotency_reverse_scan_runs_outside_the_append_lock 变红（exit 101），报出「幂等回扫必须发生在 append 锁外」，验证后已还原	2026-09-12 00:07:04 +08:00
suzmii	f11942f357	展开态补回空态提示：复用栏目页同一个 .game-resource-page-empty 与文案，不新增样式 ... - index.tsx：展开态在"可见资源为 0"时渲染 <p class="game-resource-page-empty">没有匹配资源</p>，与栏目页那一条同一条判据口径与同一句文案 - 它挂在既有的画布浮层 host 下（该 host 自身不定位），因此按画本场景根居中，观感与栏目页一致，不需要任何新 CSS - 测试：空项目的「所有资源」用例补三条断言——进入展开态后标题栏是 .is-active[data-resource-book-category="all"]、卡片宿主数为 0、空态文案是「没有匹配资源」（把"复用既有空态、不新增样式"变成可执行判据）	2026-09-11 23:55:36 +08:00
suzmii	85358b2ca5	「所有资源」页的决策与验收判据跟上当前形态：分带几何口径 + 两页共用同一份布局数据 ... - decision-log 新增「各栏目按分带铺在同一张画布上」：记分带几何（buildResourceBookAllLayout + resourceBookAllTitlebarRects 复用总览标题栏渲染路径）与冻结口径（只在项目/排序/可见资源集变化时重算，拖动不重算；签名不含 token 的理由），以及本轮不动的三处"仍是另一套"（依赖连线 / 空态分带 / 总览缩略卡网格）与它们的后续顺序 - decision-log 新增「两页共用同一份布局数据」：记裁决（不开独立空间、写回同一 mode 同一 sidecar 的同一 section、提交前减带原点）、"为什么不会写偏"的依据、与"历史手动坐标只读恢复/不删除/不重置/不迁移"不冲突的理由，以及用户可自证的往返判据 - 验收文档 S7 行判据改写：旧判据 data-resource-book-all-page / data-resource-book-all-host 已随网格分支删除，改钉 .game-resource-book-scene-card[data-resource-book-category]（每张资源恰好一个宿主）、.is-active[data-resource-book-category="all"] 与 .game-resource-book-view；补上"展开态可拖且在栏目页看到同一位置"这条往返判据 - 验收文档 S7 期望结果同步：由"汇总页"改为"与栏目页同一套画本场景、各栏目按竖向分带铺开"	2026-09-11 23:40:12 +08:00
suzmii	0d98bd05cc	删掉「所有资源」页的独立网格样式：它已经走画本场景，这六条没有调用方了 ... - 删除 .game-resource-all-resources-host：整页 absoulte 层与自己的底纹（原本是为了盖住画本场景底纹、并躲开画布容器的滚动处理） - 删除 .game-resource-all-scroll：分组网格的自身滚动容器 - 删除 .game-resource-all-section：按栏目分组的分节卡片（边框 / 圆角 / 半透明底） - 删除 .game-resource-all-grid：repeat(auto-fill, 180px) 卡片网格 - 删除 .game-resource-all-card：网格里的卡片占位格 - 删除 .game-resource-all-grid .game-resource-card：只读页的光标与 touch-action 覆盖（展开态已可拖，卡片要保留画布那套 touch-action: none） - 不留任何 all 专属替代规则：展开态的外观全部由既有的 .game-resource-book-scene-card / .game-resource-card 与共享规则给出（"零新增 CSS"是本次红线）	2026-09-11 23:33:59 +08:00
suzmii	9788248d9b	「所有资源」页改走画本场景：与栏目页同一套卡片宿主与几何，并可拖动 ... - 新增 resourceBookShowsAllCategories：把"子画布里的 all"这一态判定收在 resourceBookModel 一处 - resourceBookCategoryCardPresentation：展开态下真实栏目返回 child（卡片仍由各栏目组承载，每张资源只有一个宿主）、all 自己返回 null（只出标题栏与全量计数） - 新增纯函数 buildResourceBookAllLayout：按栏目顺序纵向排"分带"，用各栏目可见资源的 extent 定带宽高；卡片世界坐标 = 栏目内局部坐标 + 带原点 - 新增 resourceBookAllTitlebarRects：分带 → 栏目标题栏矩形，让展开态复用总览态"按矩形钉标题栏"的同一条渲染路径（ResourceBookScene 不需要知道"展开态"这个概念） - 新增 resourceBookAllBandLocalPoint：展开态世界坐标 → 栏目内局部坐标，这是落盘前唯一的换算（减带原点） - buildResourceBookScenePlan：展开态下 all 只出标题栏（钉在视口 + 全量计数），真实栏目按带偏移铺满 child 卡；真实栏目这一支仍按 presentation === child 取卡，"能出卡的判定"只有一处 - buildResourceBookScenePlan：返回总览的淡出改为按"刚离开的那段子画布"判定（exitingCategory 传 all 时覆盖所有栏目），并用带偏移位置淡出，否则返回动画会跳位置 - buildResourceBookScenePlan：「所有资源」组不再接 child / exiting 卡，避免同一张卡在两组里各挂一份（DOM 查询与 FLIP 键撞车） - index.tsx：删掉独立网格页组件、其 host 块与 resourceBookAllResourcesSections memo，展开态整体交给画本场景 - index.tsx：新增内存态 resourceBookAllViewport（不落盘、不进按真实栏目键的 resourceCanvasViewports），滚轮 / 缩放 / 适应 / 平移 / 框选都作用到它 - index.tsx：分带几何按"项目 + 排序 + 可见资源集"冻结（签名 + ref 短路；签名不含 state.token——返回总览时 token 也会变，含它会在淡出期间重算），拖动不重算带高，避免"拖上面一带让后面所有带整体位移" - index.tsx：拖动放开——展开态下每张卡都能拖，section 取 resource.category（栏目页仍只拖当前分页栏目） - index.tsx：提交前用 resourceBookAllBandLocalPoint 把世界坐标减回带原点，写回的仍是同一 mode 同一 sidecar 的同一 section（.agent/workbench/resource-layouts/{dependency,type}.json），没有第二份空间，不改契约与 schema - index.tsx：renderResourceBookCard 去掉 options.draggable：展开态已可拖，这个"只读"开关没有调用方了 - 测试：resourceBookModel.test 钉住展开态 presentation 与"栏目页仍是原判据"；resourceBookLayout.test 退役旧分组函数用例，新增分带几何 / 标题栏矩形 / 减带原点换算 / 展开态计划（含"每张资源只有一个宿主"与按带位置淡出）断言 - 测试：appSurface 两处「所有资源」判据从旧网格宿主改为画本场景（.game-resource-book-scene-card[data-resource-book-category] 与 .is-active[data-resource-book-category="all"]），并断言旧网格容器 / 宿主一个都不再存在	2026-09-11 23:33:08 +08:00
suzmii	f16aa440b9	补踩坑：第四类索引事故——git add <路径> 会把同一文件里别人的 hunk 一起暂存 ... - 记录 28781a420 的事故形态：该笔除我新增的用例（@@ -1260,6 +1260,51 @@）外，还混入了 peer 对「所有资源」测试期望的在途改动（@@ -9562,37 +9607,83 @@），提交描述与实际内容不符，且对方那份文件随即显示为干净、容易被误判为已收口；内容未丢 - 写清正确护栏：对可能被他人同时编辑的文件，把 git add <path> + git diff --cached（看内容、不只看文件名）+ git commit 压进同一条命令，并逐 hunk 确认每一个都是自己这次要写的；发现混入他人 hunk 后保持现状并立即上报，不在共享树里用 --amend/reset/checkout --/revert 做手术 - 写清状态信号：M （已暂存且工作区与索引一致）/ MM（add 后又改过）/ M（仅工作区），并点明「M 只能说明 add 之后没人再动过，不能说明这份文件里只有我的改动」 - 写清同类隐患：pre-commit 的 lint-staged 会对它格式化过的文件做 git add（prettier --write 之后 Applying modifications from tasks），与 npx lint-staged --diff=… 属同类反向 git add - 与前三类索引事故（git add -A 卷走别人的文件 / stash pop 弹出别人的 stash / lint-staged --diff 反向 add）并列，指明本类正是「按文件名校验」这道护栏的失效点 - 门禁：npm run check:encoding exit 0（4399 file(s)）	2026-09-11 23:08:57 +08:00
suzmii	3a850ee6e7	补两条踩坑：app-server 会 1:1 回显注入内容（读侧上限不得小于写侧允许量），以及“掉了就补读”的补扫不是修复 ... - 新增「Codex app-server 会 1:1 回显注入内容：读侧上限不得小于写侧允许量」：记录隔离探针实测（捆绑 codex-cli 0.147.0）——注入 5 MiB 的 item，app-server 接受并回一条 5 243 245 字节的 rawResponseItem/completed 单行，而读侧上限当时 4 MiB、写侧无上限，于是合法的注入被读行判成连接级故障，报错方向指向 app-server；同时记下 stderrBytes=405 那类摘要不能当证据（正常启动就有 275/452/546/5996 B 的插件/别名警告）、experimentalRawEvents 需要 initialize.capabilities.experimentalApi、以及探针必须用管道 stdin 与按 CommandLine 精确清理 - 新增「「掉了就补读」的补扫不是修复：自激回路会一路耗到内存」：明确标注**由并行工作线报告、本线未独立复核**，并给出取证据前不得引用的警示与“去掉补扫症状是否回来”的判据 - 门禁：npm run check:encoding exit 0（4399 files）	2026-09-11 22:51:24 +08:00
suzmii	28781a420c	补资源总览网格的声明级断言：钉住 width:100% 与 max-width 并存，防止退回单列 ... - 新增用例「keeps the resource overview grid off fit-content so its columns stay responsive」：断言 .game-resource-book-main-grid 同时声明 width: 100% / max-width: 1120px / margin: 0 auto / repeat(auto-fit …)，并同款断言 .game-resource-book-main-heading 的 width: 100% - 取声明体前先剥掉 CSS 注释：本次修复的注释里就写着 width: 100% 等字样，不剥掉会让断言匹配到注释而假绿（删掉真正的声明也照样通过） - 注释里写明这条断言**验不到布局**：AGC 的 vitest 没开 css: true、styles.css 不会被加载、jsdom 也没有布局引擎，gridTemplateColumns 的解析结果与缩略卡列数只能在真机量；真机判据（3 个非 0 轨道 / grid 宽 432→1120 / 8 张缩略卡 top 只有 3 个取值，且需在总览态取样）写在用例注释里 - 变异验证：临时删掉 .game-resource-book-main-grid 的 width: 100% → 用例变红且失败信息打印的是真实声明体（证明注释剥离生效）；还原后 styles.css 逐字节哈希与已提交版本一致，复跑绿灯 - 门禁：npm run typecheck exit 0；npm run check:encoding exit 0（4399 files）；npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts 本用例 1 passed	2026-09-11 22:50:01 +08:00