52 lines
3.1 KiB
Markdown
52 lines
3.1 KiB
Markdown
# Artemis v1.5.2 观察链补丁
|
||
|
||
适用：团队希望复现开发机已经验证的“只观察APP → 保存笔记 → 正常结束 → Checker核验”流程。补丁在 [artemis-v1.5.2-observation.patch](../assets/patches/artemis-v1.5.2-observation.patch)，不是 Artemis 安装包，不会因安装 Skill 自动应用。
|
||
|
||
## 基线与作用
|
||
|
||
- 已核对基线：Artemis tag `v1.5.2`，Git提交 `bdc75d0c657c5c2707b4c6e352eed6a1f5c14fff`。
|
||
- 补丁涉及3个实现文件及3个测试文件：Operator在计划完整完成时结束无设备动作循环；Checker能查看笔记预览并读取被省略笔记、精确匹配检查项展示前缀；resolver补充Windows标准scrcpy安装位置。
|
||
- 不包含模型Key、环境配置、用户历史、截图或设备资料。补丁摘要见发布清单；补丁不是所有Artemis问题的通用修复。
|
||
|
||
## 检查并应用
|
||
|
||
在同事的 Artemis 项目执行以下只读检查。先保存工作，确认当前没有运行任务。变量只为示例，将Skill和Artemis路径换为本机目录。
|
||
|
||
```powershell
|
||
$artemisRoot = 'D:/Artemis'
|
||
$skillRoot = 'D:/TeamSkills/artemis-device-test'
|
||
$patchFile = Join-Path $skillRoot 'assets/patches/artemis-v1.5.2-observation.patch'
|
||
git -C $artemisRoot rev-parse HEAD
|
||
git -C $artemisRoot status --short
|
||
git -C $artemisRoot apply --stat $patchFile
|
||
git -C $artemisRoot apply --check $patchFile
|
||
```
|
||
|
||
只有提交完全匹配上述基线、相关文件没有其他未保存改动且 `apply --check` 成功时，才在当前已授权的环境修复范围执行：
|
||
|
||
```powershell
|
||
git -C $artemisRoot apply $patchFile
|
||
git -C $artemisRoot diff --check
|
||
```
|
||
|
||
若已应用相同补丁，`git apply --reverse --check` 成功可辅助确认，不能重复叠加。其他版本、存在相关修改或正反检查都失败时保留原文件，记录版本和冲突，不执行 reset/clean 或强行套补丁。无Git的源码包须先取得可核对基线，不能仅凭网页显示1.5.2判断一致。
|
||
|
||
## 复验和回退
|
||
|
||
在Artemis自己的环境中运行对应离线测试（不连接设备或模型）：
|
||
|
||
```powershell
|
||
Push-Location $artemisRoot
|
||
try {
|
||
uv run pytest tests/unit/agents/test_checker.py tests/unit/agents/test_operator_recovery.py tests/unit/core/test_toolchain.py
|
||
} finally {
|
||
Pop-Location
|
||
}
|
||
```
|
||
|
||
测试通过后，在无运行任务时正常重载Artemis服务及MCP，让长驻进程载入修改，再运行 [APP-01](pilot-smoke.md) 的只读观察。不要自动关闭用户任务或重启正在使用的模拟器。
|
||
|
||
如需撤销本补丁，先确认文件没有后续改动，运行 `git -C $artemisRoot apply --reverse --check $patchFile`，检查成功且当前任务要求回退后再执行同一命令去掉 `--check`。已有无关修改时停止，不使用强制还原。回退后同样在空闲时正常重载。
|
||
|
||
开发机历史证据：相关回归90项通过；当时默认全套为2425通过、3失败、5跳过、8未选中，不能称Artemis全套通过。3项失败已分开定位为原基线问题或检出资源差异。本包的本轮校验记录会单独列出实际执行的检查；Skill自己的74项测试也不能代替Artemis回归或新机器APP验证。
|