SuperAPI AI 工具集

link-checker-agent

测试与质量

查看项目

更新于 10-16 08:00

技能介绍

用途:该插件用于文档链接质量保证,通过五阶段流水线识别并解决失效引用,流程为 Inventory → Extract → Audit → Fix → Report。

主要能力:提供按顺序执行的编号脚本。01_build_file_inventory.py 建立仓库有效文件名索引;02_extract_link_references.py 提取所有链接/路径字符串及行号;03_audit_broken_links.py 交叉比对前两步,生成 broken_links.log 与 broken_links.json;04_autofix_unique_links.py 自动修正无歧义匹配,并写出 remaining_broken_links.json;05_report_unfixable_links.py 生成剩余问题的结构化报告。

使用方式:脚本位于技能根目录下的 scripts/,需从待扫描仓库根目录运行,而非插件目录内。完整流水线可依次执行:python ./scripts/01_build_file_inventory.py && python ./scripts/02_extract_link_references.py && python ./scripts/03_audit_broken_links.py && python ./scripts/04_autofix_unique_links.py --dry-run && python ./scripts/04_autofix_unique_links.py --backup && python ./scripts/05_report_unfixable_links.py。修复前应先用 git status 确认工作区干净,以便用 git restore . 回滚。

限制:不得跳过步骤,步骤 1、2 须先于 3,步骤 3 须先于 4。步骤 4 仅修复 Markdown 链接 label 与图片链接 ,不修改 .py/.js 中的代码路径引用。--dry-run 不写 remaining_broken_links.json;若仅运行 dry-run 后执行步骤 5,会回退到 broken_links.json 并显示修复前数据。歧义链接(同名多文件)不会被自动修复,需人工处理。若 broken_links.json 缺失,修复器会回退为全仓库遍历,速度更慢且精度更低。