# ARTEMIS 2.5.0 发布包验证

验证日期：2026-11-02（Asia/Singapore）。

## 包与源码

- 分支：`main`
- 源码提交：`3dd96078db7abd4914052711ff3145f9d5c3f1df`
- 发行标签：`v2.5.0`，指向上述提交。
- 文件：`artemis-2.5.0-source.zip`
- 大小：55,446,129 字节；ZIP 条目：1,161。
- SHA256：`5b9b64a879c913baee73f19d3bd432a02e2cf6af694ea78a6c3259e2666ab336`
- 使用仓库 `scripts/package_source.py` 从固定提交打包；以下两条安装验证使用同一个最终 ZIP，验证后不重新打包。
- 主程序与前端根版本均为 2.5.0；锁文件结构比较确认第三方版本、地址、完整性校验和依赖声明未改变。SDK、市场插件独立版本化。

## 实际运行时

- Windows，Node.js `v26.8.1`，npm `11.19.0`。
- 项目 Python `3.14.0`；Chrome Headless `156.0.0.0`。
- 仅上述运行时为本次实测，不代表其他 Node/Python 版本或操作系统也已验证。

## 最终 ZIP 的隔离安装与构建

分别解压至两个独立目录；解压后没有 node_modules，每条路径单独创建空 npm 缓存。校验 ZIP 完整性、解压后的 Git HEAD 和应用版本，安装及构建后 package-lock.json 字节不变、Git 跟踪源码保持干净。

| 路径 | npm registry | npm ci | 生产构建 | 前端测试 |
| --- | --- | --- | --- | --- |
| 官方 | `https://registry.npmjs.org` | 通过 | 通过 | 360 项通过 |
| 国内镜像 | `https://registry.npmmirror.com` | 通过 | 通过 | 未重复执行 |

每条路径执行：

```text
npm ci --registry=<上表对应地址> --cache=<本路径独立空缓存> --no-audit --no-fund
npm run build
```

官方路径额外执行：

```text
npm test -- --watch=false --browsers=ChromeHeadless
```

两份生产构建输出一致的主包 `main-NYGP6STV.js`，初始包约 1.85 MB。npm 的弃用及安装脚本策略提示保留在验证日志；未关闭完整性校验、强制安装、改写依赖哈希或清理用户全局缓存。

上述覆盖官方/国内入口使用的前端 registry、锁定安装和生产构建步骤；未运行完整 start.bat / start-cn.bat 的系统依赖下载、Python 全新环境安装或服务启动流程。

## 回归与界面核验

- Python 默认回归：3470 passed，2 skipped，8 deselected；102 条既有 Pillow getdata 弃用警告。
- Ruff 格式与静态检查通过；质量基线通过（754 / 0 / 18）；核心 Pyright：0 errors、0 warnings。
- 缓存亲和与 Responses 传输、任务用量的针对性回归：49 项通过。覆盖大小写/下划线会话头、正文键一致性、显式覆盖及并发任务隔离。
- 前端新增回归覆盖累计输入加权、零命中、无用量、读取失败、Flash/Pro/探索、切换任务、慢请求完成、持续刷新及关闭后取消读取。
- 从最终 ZIP 的生产构建打开只读预览，读取已有历史任务的真实统计，核对缓存 Token 与命中率；桌面 1280×720、窄屏 390×844 的弹窗文字和数值可读。预览不接受写请求，原服务未重启。

## 验证边界与升级

本次没有新建真实设备或付费模型任务，也未修改生产网关规则。会话亲和只提供稳定路由提示，不能保证渠道或模型缓存命中；缓存以服务端实际上报为准。已有上游参数膨胀样本尚不能宣称根治，详见发行说明中的诊断边界。

已有安装等待任务结束后运行 update.bat / update-cn.bat，再重启 ARTEMIS；使用 Codex 时重新加载 MCP。新安装先核对 SHA256SUMS.txt，再解压启动。保持已有配置，不用源码包直接覆盖正在运行的目录。