SuperAPI AI 工具集

medic

部署与运维

查看项目

更新于 10-16 00:24

技能介绍

用途:medic 是 overstack 框架的总体健康关口与最后防线,用一条命令证明系统仍健康:规则仍然生效、无漂移、文档与磁盘一致、代码可编译、评测无回归、git 后备可用;若失败则精确指出漏洞与一条修复命令。

主要能力:以 probe 为检查单元,覆盖 rules、coverage、docs、code、eval、backstop 等范围。输出每个 probe 的 ✓/⚠/✗ 状态、详情与修复建议、判定结论与目录结构。支持 --list 查看防御结构,支持 --ci 返回退出码(FAIL 为 1,否则 0)。medic.py 仅用标准库,只读仓库并运行本地 probe,不写文件、不强制联网。

使用方式:运行 python3 fdk/tools/medic.py [范围],若已建立 ~/.local/bin/medic 符号链接可用 medic [范围];需要退出码时加 --ci。范围可为匹配 probe 名称或标签的关键词(rules、coverage、docs、code、eval、backstop),多个范围以空格分隔,未指定则默认全部。触发场景包括提交或开 PR 前、拉取新版本或换机器后、怀疑某规则不再拦截时、刚新增 skill/rule/generator 后。

限制:medic 只做诊断,不修改任何内容,修复需另行执行;漂移或过期只提示重新生成/同步,不改逻辑,同步 validator 前须先确认方向。单一 probe 出错记为 SKIP(fail-open),不据此判定系统故障;仅有警告时视为已知债务,不自动大修。判定由 medic.py 确定而非由模型自行下结论;每次调用最多进行一轮修复后复跑。