SuperAPI AI 工具集

clawhub-batch-analysis

测试与质量

查看项目

更新于 10-28 04:49

技能介绍

用途

该技能用于回答维护者在修改 @openclaw/plugin-inspector 时的批量影响问题,例如:弃用某个 API 会影响多少 ClawHub 插件、哪些插件会收到新的警告或错误、导出的 ClawHub 插件中最常见的检查发现是什么。

主要能力

  • 确认 ClawHub 导出路由:在使用前核对当前 /api/v1/plugins/export 的接口约定,检查鉴权要求与 X-Next-Cursor 等分页响应头;除非用户明确要求生产环境,否则优先使用本地或预发 ClawHub 目标。
  • 导出插件语料库:通过 /api/v1/plugins/export 请求 ZIP 导出,默认同时包含 family=code-plugin 与 family=bundle-plugin 两类插件;若接口分页,则按 X-Next-Cursor 持续跟进直至取完;将原始导出 ZIP 与导出台账保存在临时或已忽略的工作目录中。
  • 安全解包:解压到全新目录,解包期间不执行插件代码,并在解压语料旁保留 ClawHub 导出元数据,以便追溯插件名称与所有者。
  • 批量运行 Plugin Inspector:在 plugin-inspector 仓库中执行批量扫描命令,可指定并发数、输出目录与 JSON 输出;需要针对本地 OpenClaw 检出或含新兼容性元数据的分支验证时,用 --openclaw <path> 替代 --no-openclaw;仅在需要逐插件产物时才加 --keep-plugin-reports,因为大型导出会产生大量文件。
  • 汇总影响:先给出扫描插件总数、有错误的插件数、有警告的插件数、按受影响插件数排序的主要发现代码;再列出正在调查的具体发现所对应的受影响插件/版本行;并指向 plugin-inspector-batch-report.json 与 plugin-inspector-batch-report.md 报告文件。

使用方式

按上述工作流依次执行:确认导出路由、导出语料、安全解包、批量扫描、汇总影响。批量扫描命令示例:

plugin-inspector batch /path/to/unpacked-clawhub-export
--no-openclaw
--out reports/clawhub-batch-analysis
--concurrency 8
--json

适用场景

适用于维护者评估检查规则、警告、弃用与兼容性变更对 ClawHub 插件语料库的批量影响,以及统计跨导出插件的常见检查发现。

限制与安全注意事项

  • 导出的插件应视为不可信源码;除非用户明确要求在隔离工作区进行运行时捕获,否则不要传入 --runtime、--mock-sdk 或 --allow-execute。
  • 除非用户明确要求发布经过清洗的产物,否则生产导出与报告不要放入 git。
  • 若导出数量或端点行为重要,应对照实时 ClawHub 验证,而不依赖记忆。
  • 资料未提供具体收费、平台支持范围或性能数据。