1975 Commits

Author	SHA1	Message	Date
k88936	b1751784ba	修正切分状态写入日志格式 ... 移除状态写入完成日志中多余的格式参数	2026-09-12 13:26:36 +08:00
lhk229	34616e1631	修复 CI 调试工作区测试 ... 格式化 design runtime 调试命令 为 debug fixture 测试显式开启并清理 debug 环境变量	2026-09-12 05:21:21 +00:00
k88936	379611d552	避免渲染阶段写入画布尺寸引用 ... 在 ResizeObserver 尺寸更新回调中同步 canvasSizeRef	2026-09-12 13:20:30 +08:00
k88936	ef04a19d5a	抽取组件确认弹窗公共结构 ... 统一替换与移除操作的确认弹窗布局 保留各操作独立文案与按钮样式	2026-09-12 13:19:59 +08:00
k88936	4b8e268816	统一重启切分失败通知 ... restartSeparation 失败时复用工作流完成上报并清理完成提示	2026-09-12 13:18:30 +08:00
k88936	7e7d6f1563	避免忙碌时继续切分隐藏恢复提示 ... 在清理恢复对话框前检查分离与工作流忙碌状态	2026-09-12 13:18:13 +08:00
k88936	a4b1d81123	避免忙碌时重启切分丢失恢复状态 ... restartSeparation 在清理 sidecar 前复用并发工作流守卫	2026-09-12 13:17:52 +08:00
k88936	983b15c3a7	允许恢复流程识别已完成的素材回填 ... 同一 Sprite 已绑定的节点直接跳过 仅对缺失 Image 或绑定其他素材报告错误	2026-09-12 13:17:38 +08:00
k88936	cdb6fcfe97	切换组件时重置检查面板展开状态 ... 按组件身份变化同步展开状态，避免沿用上一个节点的折叠状态	2026-09-12 13:17:01 +08:00
k88936	d8a4e35232	减少切分状态写入的重复克隆 ... 让状态写入接口借用状态并在阻塞任务中写入序列化字节 保留 schema 与大小校验，避免每批次复制完整状态树	2026-09-12 13:16:25 +08:00
k88936	0726106818	为图片分离请求设置超时 ... 将原图编辑 HTTP 请求限制为 120 秒，避免工作流永久阻塞	2026-09-12 13:14:22 +08:00
k88936	8beade5b4d	为业务校验重试增加退避 ... 校验失败重试复用请求错误的递增等待并记录日志	2026-09-12 13:13:56 +08:00
k88936	46984a4945	净化切分提示中的节点标识 ... 复用提示文本清洗逻辑，阻断控制字符与反引号注入	2026-09-12 13:13:25 +08:00
k88936	a8a30ecbc8	修正切分恢复命令映射 ... finalize_separation 调用 finalize helper discard_separation_recovery 调用 discard helper	2026-09-12 13:13:06 +08: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	48e669d167	合并主线并解决界面编辑器冲突 ... 合并主线的 AGC Runtime、UI 工作流与开发脚本变更 保留现行 Prompt Runtime 结构并整合设计基础提示词契约断言 适配 CanvasWorld 逆缩放渲染并修正预览缩放回归测试 同步项目文档、共享契约与已退役策划资源清理	2026-09-12 11:38:50 +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
k88936	afc9ecbd51	补充 WebP 源图转码测试 ... 验证 WebP 输入可转换为 PNG 上传格式	2026-09-12 10:42:15 +08:00
k88936	fc2f4b71ce	支持分离流程转换非 PNG 源图 ... 在上传图片编辑请求前将 JPEG 和 WebP 转码为 PNG 新增 JPEG 转 PNG 单元测试并将转码放入阻塞任务	2026-09-12 10:38:00 +08:00
k88936	2a50614c11	将分离恢复阻塞 I/O 移出异步线程 ... 新增 spawn_blocking 状态读取封装 sidecar 目录创建改用阻塞任务执行	2026-09-12 10:23:32 +08:00
k88936	915006c98f	适配绑定区域类型错误调用方 ... 在区域归一化边界转换 typed error 为展示文案	2026-09-12 10:23:21 +08:00
k88936	69ce232a74	为绑定区域校验引入类型错误 ... 用 ZeroDimension 和 OutOfBounds 区分边界校验失败 补充 typed error 单元测试并保留展示层中文文案	2026-09-12 10:20:17 +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
k88936	319aa69d6e	统一分离树根节点坐标空间 ... 子节点收集复用根节点实际解析矩形	2026-09-12 02:24:01 +08:00
k88936	bec468bdc9	统一分离终止节点判定 ... 批次选择与提取提示复用同一终止节点集合	2026-09-12 02:23:02 +08:00
k88936	eada20c199	恢复自动切分前重新校验状态 ... 继续分离前确认 sidecar 存在并检查前置条件 恢复入口异常统一写入工作流失败通知	2026-09-12 02:20:52 +08:00
k88936	e8cf773aac	统一自动切分失败完成提示 ... 分离入口异常时写入工作流完成失败通知	2026-09-12 02:19:48 +08:00
k88936	12fbb61fad	限制分离恢复状态写入大小 ... 写盘前校验与读取一致的八兆字节上限 超限时记录原因并拒绝不可恢复检查点	2026-09-12 02:17:55 +08:00
k88936	0e67fbf80a	停止对最终工作流步骤重复预检 ... 资产分离作为最后步骤不再校验不存在的下一步	2026-09-12 02:12:15 +08:00
k88936	ed2cfbad36	避免预览容器变化重置缩放 ... 自动适配仅在图片或逻辑尺寸变化时执行 通过尺寸引用保留初始视口兜底值	2026-09-12 02:11:22 +08:00
k88936	560422286b	稳定组件面板展开与移除交互 ... 仅在组件存在性变化时自动展开面板 为移除组件增加确认并保留失败弹窗	2026-09-12 02:08:56 +08:00
k88936	e04075fd95	为分离模型请求增加重试退避 ... 瞬时请求失败时按递增毫秒延迟后重试 将重试循环末尾改为不可达断言	2026-09-12 02:07:02 +08:00
k88936	d7776f2a17	修正文生绑定提示语法 ... 改进分离要求和返工建议英文表述	2026-09-12 02:05:18 +08:00
k88936	4d9e69841e	加固分离提示词生成 ... 绑定提示改用切片参数避免多余复制 清理提取提示中的描述与返工备注文本	2026-09-12 02:04:32 +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
lhk229	86adaa738f	修复策划首轮错 lane 挂载导致 Agent 不工作 ... 运行模式改为随项目上下文同步派生，移除 effect 后置修正 做成游戏切换记录按项目路径与创建时间定位，跨项目自动失效 消除首帧游戏运行时挂载消耗首轮 claim 后策划实例无法补发的问题	2026-09-12 00:48:02 +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	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	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
suzmii	3db6afa052	对齐 Codex app-server 读写单行上限：写侧守卫 + DirectProject 历史注入前置校验，并把注入超限改判为不可重试 ... - 隔离探针实测（codex-cli 0.147.0，AGC 捆绑版本）：experimentalRawEvents 线程收到 thread/inject_items 后会逐条原样回显 rawResponseItem/completed —— 注入一个 5 MiB 的 item，stdout 就回一条 5 243 245 字节的单行；而读侧上限原为 4 MiB，于是「我们注入得进去」却「我们读不回来」，报错方向指向 app-server，实际是我方读行判死 - codex_app_server.rs 的 GAME_CREATOR_CODEX_APP_SERVER_LINE_MAX_BYTES 由 4 MiB 提到 32 MiB，注明它同时充当 stdout 读侧上限与 stdin 写侧守卫；取值依据写进注释（单张图 base64 上限 10 MiB、单次图片总量 16 MiB 折 base64 约 21.3 MiB，再加 JSON 信封），再大就失去内存/DoS 边界的意义 - 新增写侧守卫 game_creator_codex_app_server_message_oversize_error：write_message 超限即失败关闭并给出字节数，绝不写出自己读不回来的行（两侧共用同一常量即这条不变量） - 新增 DirectProject 历史注入前置校验 direct_project_history_injection_oversize_error：单条 item（扣掉 rawResponseItem/completed 回显信封余量）与整份载荷都必须落在上限内；超限指名 itemId/type/字节数并失败关闭，且不截断、不摘要、不改写历史（技术方案末节口径） - 新增专属前缀 DIRECT_PROJECT_HISTORY_INJECTION_OVERSIZE_PREFIX，供 direct_runtime 判可重试性与给专属提示 - direct_runtime.rs：direct_codex_failure_is_retryable 把注入超限改为不可重试（同一份历史每次读结论相同，且本轮用户消息已先追加进同一文件、载荷只会更大）；direct_codex_failure_recovery_hint 与 direct_codex_failure_public_summary 各补一条专属文案，用户不再看到笼统的「Codex 未完成本轮代码修改，请检查运行时配置后重试（可直接重试）」 - 新增 2 条用例：写侧守卫与读侧共用同一上限的边界（等于上限必须放行、上限+1 必须拒绝）、注入侧整份载荷与单条 item 双超限必须拒绝 - 变异验证：把写侧守卫改成 >=、把单条上限放成 usize::MAX，两条用例各在自己那一处变红；还原后逐字节哈希一致并复跑绿灯 - 门禁：npm run check:rustfmt exit 0；npm run typecheck exit 0；cargo test 定向 2 passed（2257 filtered out）	2026-09-11 22:24:30 +08:00
suzmii	1b7261685c	登记素材上传配对的踩坑与覆盖边界：断言打在生产函数上，端到端 UI 未覆盖 ... - `pitfalls.md` 新增「素材上传不要把『上传前读到的 revision』贴到『上传后读到的清单』上」：现象（每次上传都先吃一条拒收提示）、根因（上传本身推进 revision，错配必然发生而非竞态）、处理（上传动作与配对读收进同一个函数，调用方拿不到中间那个 revision，也就没机会贴错）、同类文案坑（`unresolved` 三条进入路径里有两条重读是**成功**的，写成"读取磁盘清单失败"就是误报）、验证与变异，并记录关联文件与提交。 - 覆盖边界（按当下口径写清，防止后人误读）：断言打在生产函数 `uploadProjectAssetFilesAndReadSnapshot` 上 —— 它同时拥有上传与配对读，所以配对语义是真测的；但 AGC 侧**没有**「资源面板上传 → 拒收提示条」的端到端 UI 用例（现有 harness 只有聊天入口的 `/asset.upload`，资源面板 file input 无用例），因此「界面上不再出现拒收提示」是推理结论而非端到端断言，禁止当成端到端覆盖引用。 - 同一条边界同时写进 `projectResourceLiveUpdateModel.test.ts` 用例组头部，随断言一起走，避免只看测试文件的人误读。 - 纯文档 + 测试注释，无功能改动。	2026-09-11 22:19:14 +08:00