ycode/docs/沙盒移除记录-2026-10-20.md

自建 AppContainer 沙盒移除记录（2026-10-20）

范围

按用户要求移除 YCode 自建的 Windows AppContainer / Job Object 执行沙盒，包括：

• 主进程沙盒实现：src/main/sandbox
• 原生执行器与文件/Git/工作区组件：native/sandbox
• 随包资源与内置 MinGit：resources/sandbox
• 工具适配：src/main/agent/tools/sandbox-git.ts、src/main/agent/tools/sandbox-workspace.ts
• 共享契约：src/shared/sandbox.ts
• 构建、供应、维护和回归脚本：scripts/build-sandbox.mjs、scripts/vendor-sandbox-git.mjs、scripts/verify-sandbox-app.cjs、scripts/sandbox-*
• package.json 中 sandbox:build、test:sandbox:*、sandbox:maintain 与沙盒 extraResources
• .gitignore 中沙盒产物规则
• release/win-unpacked/resources/sandbox 本地构建产物

保留项

• Electron 渲染进程隔离继续使用 webPreferences.sandbox、contextIsolation 和无 nodeIntegration。
• 对话页“默认权限 / 完全访问”开关保留，因为它是现有权限交互契约；default-sandbox 只是枚举名称，不代表仍有自建 AppContainer 后端。
• 历史沙盒设计、验收和取证文档未删除，仍可作为先前工作记录；其中的能力结论不再适用于当前代码。

行为变化

• npm run build 不再编译原生沙盒，也不再要求 Visual Studio C++ Build Tools。
• 安装包与免安装目录不再包含 ycode-sandbox.exe、沙盒 Node/Python 适配器或内置 MinGit 资源。
• execute_command 继续使用宿主 Shell；YCode 不再提供自建 OS 级命令、文件写回、Git 或长期工作区隔离。
• 普通文件工具原有的工作区路径约束和变化检查不受影响。

验证

• npm run typecheck：通过。
• npm run build：通过（TypeScript、Electron main/preload/renderer）。
• out/main/index.mjs：未发现 windows-appcontainer、sandbox_workspace、sandbox_git、ycode-sandbox、executeSandboxCommand、sandboxStatus。
• src、scripts、package.json、.gitignore：未发现上述自建沙盒标识。
• git status 显示相关受控文件均为删除；唯一既有未跟踪文件为 in，未修改。

限制

• 本次没有重新生成 NSIS 安装包；发布前需要重新执行 npm run dist:installer，并核对新产物不包含 resources/sandbox。
• 历史 .tmp 测试记录和用户数据目录中可能残留旧沙盒测试状态，不参与当前运行，也不会被打包。
• 移除 AppContainer 后，若需要操作系统级强制隔离，应作为新方案重新设计和取证，不能引用本仓库旧沙盒结论。