10 Commits

Author	SHA1	Message	Date
suzmii	d2d78fa3d4	修复AGC随包资源staging边界 ... 修复 --no-bundle 构建前的资源准备接线。 拒绝插件随包目录中的未声明文件并同步Rust校验。 增加staging替换失败后的旧资源恢复与回归测试。	2026-09-30 19:12:30 +08:00
suzmii	b5a143c04f	合并 origin/master：随包资源仍由准备步骤生成，Claude Agent SDK sidecar 按同一架构归位 ... - 合并 origin/master（140 个提交），解决 4 处冲突：build.rs 取只读校验分支、package.json 同时保留 bundled-resources:test 与 check:generated-bindings、决策日志与踩坑记录两侧条目并存 - master 的构建期 staging（stage_bundled_claude_agent、prune_stale_codex_components）不进构建脚本；sidecar 改由声明与准备步骤产出 - package-layout.json 新增 claudeAgent section（锁定版本、sidecar 入口、上游 SDK 与平台原生运行时目标表、复制跳过规则），layoutVersion 递增到 2 - prepare-bundled-resources.mjs 新增 sidecar 整目录原子替换与缓存 key，复制规则按 section 参数化，Windows 真机 24 个文件、复跑命中缓存零写入 - package_layout.rs 新增 sidecar 只读校验（入口与仓库源码逐字节一致、上游包版本、可执行位、白名单外文件）与声明钉住用例 - build.rs 调用 sidecar 校验并导出 AGC_CLAUDE_AGENT_SDK_VERSION；claude_code_cli.rs 的 sidecar 身份串改用声明版本 - resources/claude-agent 映射从基线 tauri.conf.json 移到 windows/macos 平台配置，check-config.mjs 增加「基线不得声明 resources/**」守卫 - 修正 package_layout 的 Windows 路径期望用例（期望值改与实现同形，原用例在 Windows 必红） - 同步技术方案 §4.5/§4.9、共享决策日志与踩坑记录	2026-09-30 17:23:04 +08:00
suzmii	acf021de2a	按评估结论落地：门禁交叉校验、CLI 缺值校验、编辑器分支覆盖与文档 ... - 门禁新增交叉校验：plugin 必须指向真实插件目录、features 必须存在于 shell crate 的 [features]、所有声明路径必须是仓库内相对路径（拒绝绝对路径与 ..） - 准备步骤 CLI：--target/--destination/--features 缺值直接失败（不再静默回退宿主目标），--features 空值也拒绝 - 用例：fixture 补齐 agc-unity-editor/agc-godot-editor/agc-cocos-editor，新增「编辑器分支产物按 prepared 与 library staging 交付」用例；godot_bundle 补 validate 负例单测 - 运维文档：dev 构建下客户端读 target/debug/plugins/**，改资源要重跑准备步骤 - 未做（已按评估结论记录）：P2-2 运行时常量锁定需要先把 nativePayloads 也 emit 进 Rust 声明，留作后续 - 验证：准备步骤 14/14、发布入口 39/39、dev 入口 12/12、godot_bundle 19 通过、声明门禁一致、cargo check 通过	2026-09-28 11:36:34 +08:00
suzmii	3b4f9b2e10	按系统性审计修复 M3：指纹反判断、守卫死代码、fail-open 与卫生项 ... - P1-1：pluginSourceFingerprint 的判断取反（prepared 内容与交付态真正进入指纹）；pluginTreeMatches 的「当前目标/feature 下不该存在却存在 → 重建」从死代码修活 - P1-7：package_layout 的 `sha256_file(x).ok() != ...` 改为 map_err 传播，两侧读失败不再被判为「相等」 - P3-2：copyNativePayloads 的 'plugins' 字面量改由声明 sourceDirectory 派生 - P3-5：payload 交付内容一致时跳过写入（命中缓存保持零写入、时间戳稳定） - P3-7：门禁提示里的脚本名改为 agc:bundled-resources:sync - P3-8：删除已无写入方的 resources/cocos-editor-bridge 占位目录 - P2-4：root 包装脚本补结尾 `--`，文档里的 prepare 命令可直接复制执行 - 验证：工具用例全绿、声明门禁通过	2026-09-28 10:20:09 +08:00
suzmii	547fb0dbce	按第三轮复测修复 M3：dry-run 零写入、所有权先行、指纹与门禁补口 ... - P2：preparePlugins 重排——dry-run 只做只读判断即返回，预缓存交付不再排在 dry-run 之前；所有权断言提到任何写入之前 - P3：pluginSourceFingerprint 放开 origin=source 过滤（prepared 内容哈希分支可达），库文件与 payload 交付态纳入指纹，pluginTreeMatches 增加「不该存在却存在 → 需要重建」判定 - P3：门禁交叉校验 nativePayloads[].destinationSubdirectory 必须是同插件 origin=prepared 的子目录之一 - P2：里程碑验收清单注明 Cocos payload 只在 injection 构建交付并给出对应命令；dry-run 用例补 injection feature 覆盖 - 夹具补齐 agc-cocos-editor 插件（所有权检查要求目标插件真实存在） - 验证：工具用例 13/13、声明门禁通过 - 已知缺口：injection 构建后切回默认 feature，随包目录里陈旧 payload 的清理尚未生效（已记在 PR）	2026-09-28 01:03:40 +08:00
suzmii	06ffa7b6ac	按复测修复 M3：payload 门槛与交付、缓存键、条件写反与门禁覆盖 ... - P0：native/payload 补 features=["cocos-editor-injection"]（与 nativePayloads 同门槛，保持迁移前语义），Windows 默认 feature 下不再无条件要求该目录 - P0：copyNativePayloads 真正改用 destinationFileName（此前声明了却仍写 sourceFileName，落盘成 cocos_editor_bridge.dll 而运行时找 cocos-editor-bridge.dll） - P1：payload 交付移到插件缓存短路之前（先默认构建、之后开 injection 不再整条跳过），并把交付物（含缺失态）纳入 pluginSourceFingerprint，删掉它必须导致重建 - P2：修正 pluginTreeMatches 里被写反的条件（原为 || 短路，导致内容比对整体失效） - P2：门禁新增 validateExtendedDeclarations，覆盖 prepareSteps/nativePayloads 的字段与引用完整性（含 destinationFileName） - P2：删除 godot_bundle 的 stage/source_files 及其单测（构建脚本不再有调用方），清掉遗留的 PathBuf 导入 - P3：CLI 支持 --features=a,b 形式 - 验证：工具用例 13/13；声明门禁通过；cargo fmt/cargo check 通过	2026-09-28 00:50:48 +08:00
suzmii	e4634928c6	按评审修复 M3：校验按插件收敛、Cocos 链路与 Godot 指纹、门禁与文档收口 ... - P0：validate_prepared_payloads 遍历所有插件 × 所有子目录 → 与 libraryStaging 分支对称地按插件收敛（声明新增 subdirectories[].plugin，Rust 加 subdirectory_applies_to_plugin，工具复制与指纹同样按插件收敛） - P1 Cocos：cargo 准备步骤改用该 crate 自身 manifest 并把 --target-dir 指回 src-tauri/target（原 -p + --features 被 cargo 以「cannot specify features for packages outside of workspace」拒绝）；nativePayloads 拆出 sourceFileName（下划线）与 destinationFileName（连字符）；native/payload 改为 origin=prepared 并绑定 cocos-bridge-build - P1 Godot：补 fingerprint（roots ["."]，排除 bin/.build/native-build，戳文件 bin/win-x64/.agc-source.sha256），不再每次真跑 build.ps1 - P2：pluginSourceFingerprint 对 prepared 产物改用内容哈希（避免无条件覆盖 mtime 导致每次全量重建）、库文件纳入指纹；pluginTreeMatches 对 prepared 只查存在性（内容由指纹覆盖，顺带缓解 90MB exe 的哈希开销）；GODOT_BUNDLE_FILES 缺清单即失败，不再静默退化为空数组；CLI 传 log 并新增 --features；用例正则兼容 Windows 路径分隔符；主规范 §4.8 残留的 AGC_SKIP_RESOURCE_STAGING 已清 - 安全：撤出误提交进 .env.local 的真实 token（还原模板并 force-push 分支尖端） - 验证：npm run agc:bundled-resources:check 通过；cargo fmt + cargo check --no-default-features 通过（含新 plugin 字段与按插件收敛的校验）；工具用例 12/13（余 1 条为夹具断言待修）	2026-09-28 00:23:26 +08:00
suzmii	faa510e999	AGC 编辑器分支产物归位：构建脚本彻底退出写入 ... - 声明扩展：subdirectories 新增 origin=prepared；libraryStaging 增加 prepare/files；新增 nativePayloads 与 plugins.prepareSteps（程序类型、工作目录、指纹、必需产物） - Godot 随包文件清单改由声明提供，godot_bundle::BUNDLE_FILES 从生成的编译期常量取值，不再各写一份 - 准备步骤按声明运行 powershell.exe -File build.ps1（Unity/Godot，Godot 移除 PSModulePath）与 cargo build -p cocos-editor-bridge --target … --features windows-injection，内容指纹命中且必需产物齐全时零写入，命令执行器可注入以便在 macOS 上覆盖调度与失败关闭 - build.rs 删除 prepare_unity_editor_helper、prepare_godot_editor_extension、stage_cocos_editor_payload、stage_build_generated_plugin_payloads 及辅助函数（415 → 193 行），只留只读校验，并新增已准备产物存在性与 Godot 随包库深度校验；AGC_SKIP_RESOURCE_STAGING 开关随写入分支删除 - 删除两份只含 staging 条目的 .taurignore；发布入口传 profile=release 以定位 Cocos 产物 - 文档：技术方案 §4.9/§8、M3 里程碑（含 Windows 验收清单）、运维文档、决策日志与排障经验同步 - 验证：准备步骤 13 条用例通过（三类准备步骤调度、指纹跳过、缺产物失败关闭、幂等）；npm run agc:bundled-resources:check 通过；cargo check --no-default-features 通过且第二次 0.62 秒 fresh - 未验证：Windows 真机（powershell/cargo 路径、产物归位、包内容一致性与客户端加载），按 M3 里程碑验收清单在 Windows 上确认	2026-09-28 00:17:49 +08:00
suzmii	f6dad1950f	AGC 随包资源准备步骤接入 dev 与发布入口，构建脚本退出写入 ... - start-tauri-dev.mjs 在前端与配套后端就绪后、spawn Tauri CLI 之前调用准备步骤，并保留依赖注入供入口测试断言顺序 - build-release.mjs 的 runTauriBuild 与既有 stageRuntime 并列调用 stageBundledResources，tauri build --no-bundle 仍不强制 staging - 声明新增 origin 字段：source 由准备步骤写，build 由构建脚本在产物生成后写；构建脚本删除 codex 与插件白名单的写入分支及 stage_plugin_file/copy_plugin_tree/copy_plugin_file，改为 stage_build_generated_plugin_payloads - 插件随包工作区改为与仓库源码逐文件比对（清单 + 逐文件 sha256 + 整树符号链接），实现移入 build_support/package_layout.rs 复用单测 - 上游原生包元数据改由准备步骤按声明校验，build_support/codex_package_metadata.rs 因失去调用方删除 - 准备步骤改为同步实现，dev 与发布入口可直接调用而无需子进程 - 测试：build-release 39 passed（新增 stage、bundled、build 顺序与 no-bundle 不 staging）、dev 入口 12 passed（新增准备步骤先于 CLI 启动）、准备步骤 9 passed、package_layout 36 passed - 文档：技术方案 §4.9 记录构建期写入边界，M1 里程碑标记完成，运维文档补入口接线与 resources/plugins 所有权，决策日志与排障经验同步	2026-09-27 18:56:44 +08:00
suzmii	21c3bd7a2b	引入 AGC 随包资源的单一声明与生成门禁 ... - 新增 build_support/package-layout.json：Codex 三元表与组件白名单、上游候选路径、第三方声明来源、插件随包子目录与跳过规则、平台与 feature 门槛的唯一人工声明 - 新增 scripts/check-package-layout.mjs：由声明生成 build_support/package-layout.generated.rs，并校验目标唯一、可执行组件属于白名单、每个目标恰有一条第三方声明来源、codex.version 与应用锁定的 @openai/codex 一致 - 新增 build_support/package_layout.rs：声明类型、插件与平台门槛判定、逐块 sha256、随包 Codex 目录只读校验及其单测 - codex_bundle.rs 的布局与版本常量改由声明提供，公开接口与取值不变；src/main.rs 在测试期引入该模块以复用既有单测 - package.json 新增 bundled-resources:check/sync 并接进 typecheck 链，根 package.json 提供 agc:* 别名	2026-09-27 18:35:57 +08:00