# 变更审计记录：pixel-audit 结构化审计方法论替换像素对比

| 字段 | 值 |
|------|-----|
| 日期 | 2026-03-12 00:28:40 |
| Prompt-ID | P20260311-235853 |
| Session-ID | cf4aef8c |
| Session 路径 | docs/audit/session_logs/2026-03/11/20_cf4aef8c_131105 |

## 操作摘要

完成 TASK 4 收尾工作：移除 image-compare MCP 依赖，将所有活跃文档中的「像素差异率」判定标准统一替换为「结构化偏差项统计」。同时为 pixel-audit Power 的 measure.md 补充附录 A（measure_gaps.py 详细用法 + CSS 选择器快查）和附录 B（图像反推验证）。

## 变更范围

本次变更为纯文档更新，不涉及代码逻辑、数据库、API 接口。

涉及模块：
- `docs/h5_ui/compare/` — 迁移编排文档
- `powers/pixel-audit/steering/` — pixel-audit Power 知识库

## 改动注解

### `docs/h5_ui/compare/ORCHESTRATION-PLAN.md`
- 变更类型：修改
- 原始原因：TASK 4 要求移除 image-compare MCP 后，编排计划中的回归校验模板仍引用「像素对比」和「差异率」概念，需统一替换
- 思路分析：将回归校验模板中的「像素对比」替换为「结构化审计」，「差异率」替换为「偏差项统计」；变体模板中的差异率引用也同步更新为偏差项引用。保持文档结构不变，仅替换术语
- 修改结果：编排计划的回归校验流程现在完全基于结构化偏差项统计，不再依赖像素级图像对比工具

### `docs/h5_ui/compare/AGENT-PLAYBOOK.md`
- 变更类型：修改
- 原始原因：子代理执行手册 §5.6 回归校验章节仍使用「像素对比」和「差异率」术语，与 ORCHESTRATION-PLAN.md 的更新保持一致
- 思路分析：定点替换 §5.6 中的术语：「像素对比」→「结构化审计」，「差异率」→「偏差项统计」。不改变章节结构和执行逻辑
- 修改结果：子代理手册的回归校验指引与编排计划术语统一，子代理执行时不再尝试调用已移除的 image-compare MCP

### `powers/pixel-audit/steering/measure.md`
- 变更类型：修改
- 原始原因：pixel-audit Power 在 TASK 2 测试中暴露了文档不够完整的问题——缺少 measure_gaps.py 的详细用法说明和 CSS 选择器快查表，以及图像反推验证的方法论
- 思路分析：新增两个附录：附录 A 提供 measure_gaps.py 的完整 CLI 用法、常用 CSS 选择器快查表（方便子代理快速定位元素）；附录 B 提供图像反推验证方法（当源码不可用时，通过截图反推尺寸的流程）
- 修改结果：Power 知识库更加完整，覆盖了工具使用和备选验证路径，减少子代理执行时的信息缺口

### `C:/Users/Administrator/.kiro/settings/mcp.json`（仓库外）
- 变更类型：尝试修改（未成功）
- 原始原因：TASK 4 要求移除 power-pixel-audit-image-compare MCP 服务器配置
- 思路分析：该文件位于用户主目录下的全局 Kiro 配置，非仓库内文件。AI 尝试删除其中的 image-compare 服务器条目，但因权限限制未成功
- 修改结果：未生效，需用户手动从 `C:/Users/Administrator/.kiro/settings/mcp.json` 中删除 `power-pixel-audit-image-compare` 服务器配置

## 合规检查

| 检查项 | 状态 | 说明 |
|--------|------|------|
| 新增迁移 SQL | ✅ 无 | 本次无数据库变更 |
| DDL 基线 | ✅ 不适用 | 本次无 DDL 变更 |
| API 接口变更 | ✅ 无 | 本次无接口变更 |
| OpenAPI spec 同步 | ✅ 不适用 | 无接口变更 |
| 文档同步 | ✅ 已完成 | 本次变更本身即为文档更新 |

## 待办事项

- [ ] 用户手动删除 `C:/Users/Administrator/.kiro/settings/mcp.json` 中的 `power-pixel-audit-image-compare` 服务器配置
