refactor(agent): replace OMP with Claude Code kernel

2026-10-20 14:47:56 +08:00
1 parent 0fb2226f8c
commit 9a1f182397
@@ -0,0 +1,42 @@
+# 自建 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 后，若需要操作系统级强制隔离，应作为新方案重新设计和取证，不能引用本仓库旧沙盒结论。