45 lines
3.5 KiB
Markdown
45 lines
3.5 KiB
Markdown
# Windows 内置运行时：交付 01
|
||
|
||
日期：2026-10-21。源码提交：`bef87520c263890f0ddd64a12d9c6a5104844daf`。
|
||
基线：`759df7060d854f758b9d2029fd5722a537460125`。
|
||
|
||
## 用户范围
|
||
|
||
集成 Windows 版 Node.js、Python、Git，并提供启用设置。用户参考图仅红框“内置运行时”卡片有效；实际入口为设置 → 安全中心，不复制删除保护、审计或其他内容。
|
||
|
||
## 已实现
|
||
|
||
- Windows x64：Node 24.22.0 + npm/npx 11.19.1；CPython 3.14.8 + pip 26.2.1/venv；PortableGit 2.56.0.windows.2 + Bash。
|
||
- 已实际下载官方压缩包，归档哈希和完整提取树校验通过。约 113 MB 压缩包、572 MiB 解包资源；不是预留空目录。大二进制不提交 Git，安装包构建自动下载、校验并收录；离线可预置已校验缓存。
|
||
- 安全中心总开关和三个单项开关；只展示真实文件可用状态。独立偏好文件原子保存、串行更新，损坏/不可读不会静默变为全部启用；保存错误有重读入口。
|
||
- 仅作用于新建终端、Claude 内核和 MCP stdio 子进程。Windows PATH 大小写归一、保留既有凭据过滤和 MCP 最小继承环境；不改系统/用户 PATH、注册表、权限模式或发送/排队/回合逻辑。
|
||
- npm prefix/cache、Python userbase/pip cache 位于 YCode userData；保留项目 venv 使用方式，详见工具链文档中的 pip 安装注意事项。
|
||
- 打包 beforePack 校验缺失/损坏/非 x64/内容树漂移并失败退出；PortableGit 做确定性的必要后处理，不执行 Windows 自解压程序或首次启动安装脚本。
|
||
|
||
## 验证
|
||
|
||
- 后端 15 组回归通过，包含总/单项开关、缺失资源、非 Windows、PATH 大小写与 SDK 合并、设置重启持久化、并发更新及失败/损坏配置。
|
||
- UI 18 项 DOM 检查通过，包含开关保存、禁用保留选择、读写失败、重试、卸载期间提交和非 Windows。
|
||
- 打包 4 项回归通过；实际 Node 1992、Python 1377、Git 9614 文件完整哈希通过。重复 prepare + verify 成功。
|
||
- `npm test`、严格 `test:alignment:dom`、生产构建通过；新 CSS 无 token 违规，既有六项 token 失败未改 baseline。
|
||
- 独立审查已修复 PATH 冲突、异步启动竞态、共享配置覆写和 Git 后处理问题。
|
||
- 证据：[目录](evidence/windows-runtimes-01)。
|
||
|
||
## 明确未验证
|
||
|
||
Linux 环境不能运行 Windows 二进制：`runtimes:smoke` 输出 SKIP，不登记为成功。未生成或启动 Windows 安装包、未做原生 GUI/截图像素验收、未验证 Git HTTPS/实际包联网下载/升级迁移。一次 Claude 集成测试因可能联系外部服务被执行权限审查阻止，未重试，未计入通过；未使用用户电脑或外部模型服务验证。
|
||
|
||
## Windows 验收步骤
|
||
|
||
```powershell
|
||
npm ci --legacy-peer-deps
|
||
npm run runtimes:prepare
|
||
npm run runtimes:verify
|
||
npm run runtimes:smoke
|
||
npm run dist:installer
|
||
```
|
||
|
||
在隔离 Windows x64 环境启动打包应用，安全中心逐一切换并重开终端/新会话；核对 `Get-Command node, npm, python, pip, git, bash` 的路径和各版本。开关关闭不禁止系统已有工具。验证含空格/中文路径、无系统 Node/Python/Git 的机器、MCP 新连接，以及原有会话不被中断。不得将这些待验步骤描述成已运行。
|
||
|
||
详细设计、构建和许可记录：[Windows 内置工具链](../Windows内置工具链.md)。随包保留上游许可证和出处；公开发布二进制之前须核实适用的对应源码/分发义务，本轮未发布安装器。
|