你实际在比较哪一类对象?
文档、日志、Markdown、CSV 或表格走文本/表格分支;JSON、数组或环境变量走结构化数据分支;数据库 schema、OpenAPI 文件或两次 API 响应走契约与行为分支;PDF 页面、图片、音频或跨断点页面截图走媒体分支;如果核心问题只是“字节是否一致、摘要是否匹配、AGEX 包是否按预期变化”,则走完整性分支。
Elysia Tools
导航
Workflow Playbook
比较两个候选产物,先按格式选择合适的 diff 路径,再补做结构或语义复核,并在需要严格验收时完成完整性校验。
专题
这套工作流适用于“有两个候选产物,需要产出可审批的差异结论”的场景。最诚实的起点不是工具名,而是先判断对象类型。Markdown 改稿、CSV 导出、OpenAPI 契约、两张截图、一个 AGEX 包,虽然都属于 diff 问题,但需要的证据完全不同。
文本类文件先用 text-diff,表格或导出先用 csv-excel-diff-tool,JSON 负载先用 json-diff-visualizer,文档和媒体产物则分别用 pdf-diff、image-difference、audio-diff。这一步的目标不是马上做结论,而是找出真正有意义的变化落在哪一层。
很多原始 diff 并不适合直接做决策。可以用 diff-formatter 整理文本 patch,用 pretty-json-diff 看字段级变化,用 difference-arrays 看成员增减,用 environment-config-diff-visualizer 看部署配置漂移。如果验收重点不再是“文件字面值改了什么”,而是“会不会破坏兼容性”,就升级到 database-schema-diff、openapi-diff-breach-detector 或 api-response-diff-semantic-analyzer。
最后一步要决定你需要的是感知层复核,还是字节级证明。responsive-breakpoint-diff 适合检查不同断点的布局回归;checksum-comparator 与 hash-algorithm-comparator 适合证明摘要层的一致性;agex-bundle-diff 适合检查加密包封装变化,而不是普通内容审稿。合格的最终结论应明确写出:比较对象是什么、走了哪个分支、发现了哪些关键差异,以及这份结果属于可读审阅证据、兼容性证据,还是完整性证据。
工作流指南
先用最贴近内容的比较器查看真实改动,避免一开始就得到不可读的二进制差异结论。
原始 diff 太噪时,进一步整理文本 patch、JSON 字段移动、数组成员变化或环境配置值变化,让责任边界和改动含义可读。
如果真正的问题不是“文件变了没”,而是“是否破坏兼容性”,就比较数据库 schema、OpenAPI 契约或真实 API 响应,找出破坏性变化和语义漂移。
当发布门禁关注跨断点回归、精确摘要或 AGEX 封装变化时,用对应工具补足最后一层确认。
文档、日志、Markdown、CSV 或表格走文本/表格分支;JSON、数组或环境变量走结构化数据分支;数据库 schema、OpenAPI 文件或两次 API 响应走契约与行为分支;PDF 页面、图片、音频或跨断点页面截图走媒体分支;如果核心问题只是“字节是否一致、摘要是否匹配、AGEX 包是否按预期变化”,则走完整性分支。
需要让审阅人理解改动内容时,优先用 formatter、schema、semantic 或 media 分支;发布门禁只接受精确字节或包状态证明时,再补做 checksum、hash 或 AGEX 包差异检查。