SuperAPI AI 工具集

qa

设计与创作

查看项目

更新于 10-15 17:21

技能介绍

用途:作为内容迁移的 QA 工程师,将 WXR 文件中的每个页面与其原始来源 URL 对比,确认文字、标题、图片和链接在提取过程中完整保留;发现缺口后修补 WXR 或重新提取该页,并输出含前后证据的结构化报告。

主要能力:解析 WXR 并统计带 _source_url 的可测页面与跳过的页面;抓取原始页面,用 parseContent() 将 HTML 与 WXR 内容解析为正文、标题、图片、链接模型,再用 diffContent() 做差异比较。按加权维度打分:文字相似度 50%、标题 20%、图片 20%、链接 10%。页面评级为 pass(加权匹配 >90%)、warn(70–90%)、fail(<70%)或 error(抓取失败)。据此计算 0–100 的内容健康分并输出逐页报告与主要问题。

使用方式:以 tiers 决定修复范围——Quick 只修 fail,Standard 修 fail+warn(默认),Exhaustive 修所有含细微差异的问题。用 runQa({ wxrFile, fix: true }) 修补 WXR 中缺失的 alt 文本和小缺口;文字相似度低于 50% 等重大缺口需标记后重新提取。修复后重跑 runQa({ wxrFile, fix: false }) 验证,变差则从备份回滚。每 5 次修复自评一次,硬性上限为 20 次修复尝试。若失败呈同一模式,建议转到 /diagnose 排查根因。结果中 pages[] 含 slug、sourceUrl、grade 与差异详情,summary 含 pass/warn/fail/error/fixed 计数,日志写入与 WXR 同目录的 qa-log.jsonl。未提供 WXR 路径时调用 liberate_paths({ url }) 解析站点输出目录,默认基准 ~/Studio/_liberations/<host>,可用 --output 或 DLA_OUTPUT_DIR 覆盖;缺少 URL 时需向用户询问。

适用场景:WordPress 内容迁移后的保真度核查与修补。限制:QA 直接对比 WXR 与原始站点,无需 WordPress 站点;无 _source_url 的页面无法 QA,需用记录来源 URL 的较新版本重新提取;导航、页脚、Cookie 横幅等文本差异可接受,不应过度修复;抓取失败(如原始 404)的页面标记为 deferred,无法对比。执行前须先对比并展示报告,应用修复前须征得用户同意。更多细节暂未提供。