1059 Commits

Author	SHA1	Message	Date
k88936	e0f743b608	修复组件计数的布尔值转换 ... 将布尔值显式转换为 usize，恢复 Rust 工作流模块编译。	2026-09-12 21:17:41 +08:00
suzmii	aa0fcc1d71	合并 master：修复 CI comparison base 门禁 ... - 合入 origin/master（b12a81e9c「修复 AGC 自主运行时测试目录权限与任务目录加固」），使 PR 头包含当前 master tip，门禁 Resolve comparison base 不再拦 - 冲突零：自动合并成功 - 验证：npm run typecheck exit 0；npm run check:rustfmt exit 0	2026-09-12 20:55:15 +08:00
kdletters	b12a81e9c2	修复 AGC 自主运行时测试目录权限与任务目录加固 ... 恢复 relaxed autonomous lane 的美术工具与写入门禁旁路 统一 Runtime 任务与事件目录的安全创建和校验 测试临时目录在 Windows 下初始化当前用户 owner	2026-09-12 20:31:43 +08:00
suzmii	64b0d2f766	收敛外部错误体、注入提示词与锁诊断的不设界行为 ... 收敛外部错误体、注入提示词与锁诊断的不设界行为（PR #316 review） - resource_editor.rs:2476 [bug · medium] 已被修复：`error_details` 改为 `error.details` 优先、顶层 `details` 兜底，与 docstring 声明的取值顺序一致；新增「两种形状同时出现」用例钉住优先级。 - resource_editor.rs:2468 [performance · low] 已被修复：4xx 错误体改走 `bytes_stream` 有界读取（64KiB 上限，超限即放弃取原因），不再用 `response.text()` 无上限缓冲外部正文。 - resource_editor.rs:2514-2525 [maintainability · low] 已被修复：provider / assetKind / mediaType / code 四个追加字段各自按 80 字符截断（`MAX_EDITOR_ERROR_DETAIL_CHARS`），最终文案长度不再随外部正文增长；新增超长字段整串比对用例。 - direct_codex_references.rs:175-182 [performance · medium] 已被修复：`resourceIds` 超过 32 条直接按模块失败关闭口径拒绝，并在同一 id 的重复项上做去重，注入提示词的「关联素材 ID」行长度与 manifest 扫描次数都有界；新增去重 + 超限用例。 - direct_runtime.rs:1795-1797 [maintainability · low] 已被修复：`direct_project_history_contention_failure` 收窄为只认追加锁超时标记（项目写锁争用已在更早的专用分支判掉，是死代码），恢复提示文案相应去掉「或项目锁」；新增用例钉住两条判据互不重叠、各自命中正确提示。 - conversation.rs:984-989 [maintainability · medium] 已被修复：`DIRECT_PROJECT_HISTORY_RECORD_TYPE` 提升为 `pub(crate)`，读取侧 `is_direct_project_history_row` 引用同一常量，`project.jsonl` 的信封契约改为编译期共享。 - agent_db.rs:3570-3574 [other · medium] 已被修复：`lock_with_attempts` 的进程内锁改为有界 `try_lock` 轮询（窗口与调用方一致，2000/200 次 × 5ms），同进程读路径不再被写者的 10s 跨进程等待拖住；顺序仍是「进程内锁 → 跨进程锁」，无 ABBA；新增用例验证短窗口 <5s 失败且释放后立即可重取。 - agent_db.rs:3668-3669 [maintainability · low] 已被修复：新增与锁同级的旁路诊断文件（普通共享写入），诊断优先读它、读不到再退回锁文件，Windows 上 zero-share 独占锁文件时也能报出持锁方；新增「取锁写出旁路文件」「锁文件不可读时退到旁路」两条用例。仅存 pid/用途/时间戳，不参与判活、回收或抢占。 - agent_db.rs:3827-3828 [maintainability · low] 已被修复：仅当修复错误真的符合提权口径（`windows_acl_error_may_need_elevation`）时才追加「自动提权修复未完成」，否则原样透传底层错误，不再重复报同一个错误并谎称尝试过提权。 - main.rs:29-31 [maintainability · low] 判定为不适用/不改：实测删掉那四个 import 会产生 18 处 E0425（`direct_tool_bridge` / `canvas_generation` / `assets` / `manifest` / `resource_editor` / `resource_dependency_graph` / `recovery_tests` 等经 `use super::*` 从 crate 根复用它们），而保留它们并不产生 `unused_imports` 警告（cargo check --all-targets 无一条指向这几行）；已按原样恢复 main.rs，工作树中该文件无改动。	2026-09-12 20:20:39 +08:00
suzmii	daef9f6cc9	修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性 ... 修复素材删除幂等、重命名 CAS 与 manifest 预览缓存一致性（PR #316 review） - assets.rs:2048-2049 [bug · medium] 已被修复：删除登记在「身份 + revision 两项 CAS 都已通过」后遇到素材已不在 manifest 时按 no-op 成功收敛并照常推进 revision，不再报「项目资源不存在」；新增 `asset_delete_retry_converges_when_only_the_revision_advance_failed` 复现「manifest 已提交、revision 未推进」并验证重试收敛（原「不存在的素材必须报错」断言相应改为幂等语义，前端只消费 assetId/committedProjectRevision）。 - assets.rs:2035-2042 [performance · low] 已被修复：引用集合只算一次并用 `HashSet<String>` 做成员判定，`retain` 不再是 O(V²)；版本守卫闭包按约定在写入前另行求值、拿不到该可变借用，故两次扫描保留并已在注释里说明。 - commands.rs:1032 [maintainability · medium] 已被修复：`RenameLocalProjectAssetInput` 补 `expectedProjectId` / `expectedProjectRevision`，`rename_local_project_asset_at` 与删除/分类更新同口径做两段身份复核 + revision CAS，失败时磁盘、manifest、revision 全不动；新增 CAS 用例（陈旧 revision / 跨项目身份 / 空身份）。注意：前端 `confirmResourceRename` 必须同时补传这两个字段（TS 侧由前端 owner 落地）。 - asset_rename.rs:84 [bug · low] 已被修复：新增 `asset_frame_directory_matches`，目录段在 Windows/macOS 按大小写不敏感比较（Linux 保持敏感），与文件名比较同口径；新增 `Assets/hero.png` 帧对齐用例。 - asset_rename.rs:249-250 [bug · medium] 已被修复：revision 推进失败改为报 `reconciliation-required: 素材已改名…且 manifest 已落盘，但项目 revision 未能推进`，明确这是「已提交但对账未完成」而非普通失败；同时新增的 CAS 使后续命令必须按新 revision 重试，重试会命中同名 no-op 分支收敛。 - tests/asset_rename.rs:257-263 [maintainability · medium] 已被修复：删除 `RenameLocalProjectAssetFaultStage` 枚举与生产签名上的 `fault` 参数，故障注入改用 `#[cfg(test)]` 的 `.agent/runtime/test-fail-next-asset-rename-manifest-write` 标记文件（与 agent_db 既有约定一致），生产 API 面不再能被推上「只回滚、不写 manifest」的路径。 - manifest.rs:1386 [bug · medium] 已被修复：预览缓存失效点下沉到唯一的装盘公共体 `write_manifest_locked_with_version_guard`（install 成功后立即失效，含安装后回读不一致的失败路径），`mutate_manifest_at_allowing_version_removals` 与绑定改写通道一并覆盖；`write_manifest_with_lock_hook` 里的重复调用已移除。 - manifest.rs:1480-1482 [bug · medium] 已被修复：填充侧改为「先取身份快照 → 读取 → 复核快照一致才入缓存」，不再可能出现「旧内容 + 新文件身份」的缓存条目。 - manifest.rs:1135 [security · low] 已被修复：新增 `normalize_manifest_asset_tags`，在共享归一化之后按数量（16）与单标签长度（32 字符）失败关闭；超长标签不截断，避免与共享标签库静默分叉。 - manifest.rs:1180-1181 [bug · medium] 已被修复：审计改为幂等——前后分类与标签完全相同时不追加记录，重试不会再写出 `previousCategory == category` 的假变更审计（保留「manifest 落盘后、推进 revision 前追加」这一既有位置约定）。 - manifest.rs:1140 [maintainability · low] 已被修复：分类写入的项目写锁标签由 `asset.register` 改为 `asset.classification.update`，争用诊断不再误报成素材登记。 - 测试：新增 preview_cache_tests（命中/TOCTOU 不入缓存/身份漂移丢弃/主写入通道显式失效）、分类重复写入不留假审计、标签上下界拒绝；7 条变异验证全部 CAUGHT。	2026-09-12 20:20:12 +08:00
suzmii	3a9e45c805	修复素材导出缺少敏感文件拒绝与自我覆盖保护 ... 修复素材导出缺少敏感文件拒绝与自我覆盖保护（PR #316 review） - asset_export.rs:27-30 [security · high] 已被修复：`resolve_export_source_file` 现在与通用读取路径同一口径，normalize 后先 `reject_agent_runtime_private_control_path` 再 `reject_sensitive_project_file_read`，`.env` / 本地凭据配置与 `.agent/runtime|checkpoints|workbench` 控制面都不能被复制到项目外。 - asset_export.rs:31-33 [security · medium] 已被修复：源路径改用 `resolve_local_project_path` 逐段复核符号链接与 Windows reparse point，`assets` 本身是链接/junction 时不再把项目外文件当成素材导出。 - asset_export.rs:76-78 [bug · high] 已被修复：新增 `reject_export_destination_matching_source`，在创建写句柄之前按「路径等价（大小写不敏感平台忽略大小写）」+「文件身份（含硬链接，退化身份不参与判定）」拒绝保存目标与源素材同一份文件；否则 `File::create` 先截断源文件、复制读到 0 字节还会报成功。 - asset_export.rs:93-95 [other · low] 已被修复：复制改为同目录临时文件 + `sync_all` + `rename` 原子替换，失败时清理临时文件；不再先截断既有目标、也不再留下半截文件。 - 文档：命令 docstring 不再声称「只导出 manifest 已登记素材」——DirectProject 导入的附件同样要能另存，而它们不是 manifest 资产，所以这里明确写成与通用读取同一套路径门禁。 - 测试：新增 5 条用例覆盖敏感/控制面源拒绝、中间目录符号链接逃逸、目标即源文件、硬链接目标、原子替换不留临时文件；7 条变异验证全部 CAUGHT。	2026-09-12 20:19:57 +08:00
k88936	a19684a5f5	Merge remote-tracking branch 'origin/master' into feat/ui-editor-auto-seperation	2026-09-12 19:46:41 +08:00
k88936	46b0871e6d	补充背景节点规则说明	2026-09-12 18:56:31 +08:00
k88936	5c40abce47	识别树根节点改为模型根节点 ... 识别协议改用 trees[].root 并保留根节点非几何字段 同步根节点解析校验、提示词与 UI 树转换	2026-09-12 18:10:45 +08:00
k88936	47d09d51ef	简化并集中化随机 NodeId 生成逻辑	2026-09-12 17:57:48 +08:00
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
k88936	d44c6ab62c	补充背景节点规则示例说明	2026-09-12 16:28:31 +08:00
k88936	bb2f080d3b	分离产物使用 UUID 文件名 ... 切分图片文件名改用 UUID，避免把 NodeId 当作物理路径。 继续通过 cut_paths 写入 BoundNode.cut_image_path，保留逻辑节点 ID 与产物路径的独立性。	2026-09-12 16:18:13 +08:00
lhk229	2e87a1403a	自动隔离损坏的策划会话并修复 CI ... 会话读取损坏时自动备份并允许项目继续打开 登记会话重置命令并补齐 Native shell 配置检查	2026-09-12 07:48:07 +00:00
k88936	6235fa3298	修复分离状态跨平台原子替换 ... 使用唯一临时文件并同步写入，避免 checkpoint 临时文件互相覆盖。 Unix 使用 rename，Windows 使用 MoveFileExW 原子覆盖已有 state.json。 拒绝符号链接和非普通文件目标，并增加覆盖已有目标回归测试。	2026-09-12 15:40:12 +08:00
lhk229	f505d2792f	允许损坏策划会话降级打开项目 ... 会话读取失败时保留工作台与产物访问能力 新增策划会话备份重置命令，不删除工作区产物	2026-09-12 07:33:49 +00:00
k88936	8a9d37d5ad	移除分离提示词的破坏性清洗 ... 保留描述、返工意见和 NodeId 原文，删除重复截断与字符改写。 返工意见仍由 validate_binding_response 统一执行 MAX_REWORK_NOTE_CHARS 校验。	2026-09-12 15:19:24 +08:00
k88936	f055961714	修正分离源图 MIME 识别回退 ... 缺失或未知 MIME 时强制走 PNG 规范化，避免非 PNG 数据被误标为 image/png。	2026-09-12 14:55:35 +08:00
k88936	2bfc870854	复用分离流程已选批次节点 ... 让批次校验和应用使用同一份已选节点，避免重复选择造成目标漂移。	2026-09-12 14:54:05 +08:00
k88936	b52a33cc28	明确提示词清洗的字符映射意图 ... 使用 map 替代始终返回 Some 的 filter_map，保持清洗行为不变。	2026-09-12 14:48:42 +08:00
k88936	398edd6e86	将分离状态序列化移入阻塞任务 ... 避免在异步执行器线程同步格式化大型 separation state。	2026-09-12 14:48:00 +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	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	a4373d7494	修正策划资源文档引用路径 ... 将阶段 Skill 和系统模块中的旧附件名称统一为资源逻辑路径。 修正模板、范例、系统总纲及模块配套文件引用。	2026-09-12 05:28:26 +00:00
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	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
k88936	48e669d167	合并主线并解决界面编辑器冲突 ... 合并主线的 AGC Runtime、UI 工作流与开发脚本变更 保留现行 Prompt Runtime 结构并整合设计基础提示词契约断言 适配 CanvasWorld 逆缩放渲染并修正预览缩放回归测试 同步项目文档、共享契约与已退役策划资源清理	2026-09-12 11:38:50 +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
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	12fbb61fad	限制分离恢复状态写入大小 ... 写盘前校验与读取一致的八兆字节上限 超限时记录原因并拒绝不可恢复检查点	2026-09-12 02:17:55 +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