SuperAPI AI 工具集

diag-harness

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:回答一个核心问题——本机的 @metaharness/kernel 是否与该 harness 脚手架时依赖的版本一致。这是跨机器兼容性排查中最常见的“harness 不工作”根因。

主要能力:读取 .harness/manifest.json 中的 meta.surface(由哪个界面生成,cli 或 web-ui)与 meta.kernel_version(脚手架时标记的内核版本),再通过以 harness 自身 package.json 为根的 createRequire 真实解析本机内核版本,计算偏差并给出可复制的下一步命令。判定与退出码:match→0(完全一致);patch-diff→0(补丁级偏差,通常安全,可能含修复);minor-diff→1(次版本偏差,可能缺少新特性,并提示 Run: npm install @metaharness/kernel@X.Y.Z);major-diff→1(主版本偏差,API 可能变更,预计会出问题);路径下无 .harness/manifest.json→2。

使用方式:在 Codex 中可用 /diag-harness 或 /diag-harness path=./my-harness;等价 CLI 为 harness diag、harness diag ./my-harness、harness diag ./my-harness --json(适合 CI)、harness diag ./my-harness --bundle(生成支持工单用 JSON 快照,含诊断报告、脱敏 manifest、@metaharness/* 依赖与 Node/平台信息;匹配 secret|token|key|password|api_key 的键会被隐去,可安全贴入公开 issue)。

适用场景:克隆他人 harness 后;在 package.json 中升级内核后;harness doctor 报出难以理解的形状错误时;CI 中先于其他子命令运行以快速失败。流程位置为 scaffold 之后、doctor/validate/sign/publish 之前。

限制:仅做版本偏差诊断,不修复代码;需存在 .harness/manifest.json 且本机能解析到 @metaharness/kernel;具体安装命令以输出提示为准。其余信息暂未提供。