# ARTEMIS 2.7.1 发布包验证

验证日期：2026-11-05T12:01:35.704713+08:00。

## 源码与最终附件

- 分支：`main`；源码提交：`8bf59897bb89207576b012594ba2e31c9048101b`；发行标签：`v2.7.1`，须指向该提交。
- 最终 ZIP：`artemis-2.7.1-source.zip`；55,893,534 字节；1204 条目。
- ZIP SHA256：`e7a5901b15b17287bd5a6177e886fffbc6cbf0f6e9d5a9e18253cde1746e44bd`。
- 使用仓库 `scripts/package_source.py` 从固定提交生成。官方与国内路径验证同一个最终 ZIP；验证后逐字节复制至正式附件目录并重新校验，未重新打包。
- 主程序和前端根版本为 2.7.1。与正式 2.7.0 结构比较后确认，uv.lock 的第三方包条目及 npm 依赖、下载地址、完整性校验和依赖声明均未变化。
- SDK、插件和 Android 助手保持独立版本。随包助手 1.3.0 / versionCode 15，文件与清单 SHA256 一致：`544c38d5c135518fe6796aa4e03f804e87342687125a383ff3244952c8160d1f`。

## 实际运行时与安装验证

- Windows；Node.js `v26.8.1`；npm `11.19.0`；Python `3.14.0`；Chrome Headless `156.0.0.0`。
- 从最终 ZIP 的独立解压目录运行 `uv sync --dev --locked`，使用独立虚拟环境，实际安装 artemis 2.7.1、websockets 15.0.1；可复用 uv 下载缓存，未同步或替换用户原有虚拟环境。
- 两条前端路径分别解压最终 ZIP，安装前没有 node_modules，且各自使用独立空 npm 缓存。安装和构建后，package-lock.json 字节不变，跟踪源码保持干净。

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

分别执行 `npm ci --registry=<对应地址> --cache=<本路径独立空缓存> --no-audit --no-fund` 和 `npm run build`，官方路径额外执行 `npm test -- --watch=false --browsers=ChromeHeadless`。未关闭完整性校验、修改依赖哈希、强制安装或清理用户全局缓存。

## 最终源码回归

- 从最终 ZIP 解压源码和独立 Python 环境运行默认回归：3929 passed，6 skipped，8 deselected；102 条既有 Pillow getdata 弃用警告。
- 首次从纯源码包回归为 3928 passed、1 failed，失败项为 `test_source_tree_contains_complete_release_resources`：源码 ZIP 按约定不含预编译的 Python 包前端备用目录，而该测试要求备用资源完整。随后仅在独立验证目录，将同一 ZIP 的生产构建产物复制到备用目录，逐文件校验 SHA256、确认跟踪源码未变化，再完整重跑默认测试。未修改源码、测试要求或最终 ZIP；实际源码启动仍使用 apps/showcase_ui/dist 构建目录。
- 覆盖录屏的本地/远程 ADB 环境隔离、空结果及解析失败的有限重试、Hopper 兜底与取消、包名缓存、批次恢复、运行环境证据导出和旧 ZIP 缓存升级。
- Ruff 检查、格式检查、质量基线通过；质量计数为 broad exception 754、silent broad exception 0、type ignore 17。核心 Pyright：0 errors、0 warnings。
- 官方/国内两份最终解压包的 16 个 PowerShell 脚本通过 Windows PowerShell 5.1.26100.9818 语法解析。发行文档相对链接、助手清单及 git diff --check 检查通过。

## 验证边界与升级

以上仅代表列出的 Windows、Node/npm/Python 版本，未将其它运行时视为已实测。验证覆盖官方和国内入口的前端锁定安装、构建与脚本输入；未完整执行 start.bat/start-cn.bat 的系统工具下载、MCP 安装和服务启动。

本次未新增实机业务任务或付费模型调用，也未更改或重启用户运行的 ARTEMIS、恢复暂停批次。回归测试不等于已复现现场内存压力或已证明 ADB 崩溃的唯一原因。新增快照仅在任务开始和失败收尾时采集，采集失败不会改变任务结果；未加入持续内存监控、保护阈值、自动暂停或录屏处理并发限制。

已有安装等待任务结束后运行 update.bat/update-cn.bat，再重启 ARTEMIS；升级程序会终止本项目运行进程，需保留要继续的暂停任务。Codex 用户重新加载 MCP。新安装先校验 SHA256SUMS.txt，再解压启动，避免覆盖运行中的目录。继续沿用 2.7.0 的 WebSocket 默认协议及一次性配置迁移，已手动切回 HTTP 的配置保持原选择。