docs: hand off private Windows runtime integration
This commit is contained in:
1 parent
bef87520c2
commit
0f3986fc80
6 files changed
+110
No files matched your search
@@ -0,0 +1,44 @@
|
||||
# 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)。随包保留上游许可证和出处;公开发布二进制之前须核实适用的对应源码/分发义务,本轮未发布安装器。
|
||||
Reference in new issue
Block a user