Neo
14a12342b5
这些审计记录原本堆积在 docs/audit/changes/changes/ 嵌套误产物目录下（由开发机迁移
79d3c2e 前后的不明批量操作产生）。由于同期 .gitignore 屏蔽了 docs/audit/ 全目录，
它们从未入过 git 任何分支 history。删除即永久丢失。
按 docs/specs/audit-gap-recovery/tasks.md 阶段 1 执行，将全部 96 份 D 类孤本
（主目录无同名、git history 亦无记录）复制到 docs/audit/changes/ 主目录入仓。
涵盖主题: P1-P18 全栈集成 / 多模块累积变更 / ETL bug 修复 / 业务日切 /
召回与任务引擎改造 / 租户管理与审批 / 董事会财务 / 客户与助教详情 /
DDL 基线合并 / Kiro 到 Claude Code 迁移
阶段 2（B 类内容漂移 1 份）和阶段 4（嵌套目录删除）独立推进。
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
61 lines
3.7 KiB
Markdown
61 lines
3.7 KiB
Markdown
# 变更审计记录：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` 服务器配置
|