Files
Neo-ZQYY/docs/audit/changes/2026-03-12__pixel-audit-structured-methodology.md
Neo 14a12342b5 chore(audit): 补追 96 份未入仓审计孤本 — 覆盖 2026-02-26 ~ 2026-04-08
这些审计记录原本堆积在 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>
2026-04-20 06:35:42 +08:00

3.7 KiB
Raw Blame History

变更审计记录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 补充附录 Ameasure_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 服务器配置