SuperAPI AI 工具集

provider-setup

部署与运维

查看项目

更新于 10-15 17:20

技能介绍

用途:在委派任务前或 provider 报错时,查明本机可以委派给哪些服务。它探测每个已注册服务,确认二进制是否已安装、版本、是否已认证,并给出不健康项的修复办法;对缺失项可执行安装,并把结果记入缓存。

主要能力:脚本 scripts/delegation_setup.py 支持三种查询方式:python3 scripts/delegation_setup.py --status 输出每个注册服务的安装与认证状态表;--doctor 用于诊断;--available 只列出当前确认可接收工作的 provider。安装命令只能来自 delegation_executor 中的 provenance 映射,没有 provenance 记录的二进制会抛出 UnverifiedBinaryError,不会猜测执行命令;可安装单个服务(如 python3 scripts/delegation_setup.py --install gemini)或全部(python3 scripts/delegation_setup.py --all),每次安装都会先询问,拒绝也计为已记录结果而非失败。

状态记录:plugins/conjure/scripts/provider_ledger.py 写入 ~/.claude/hooks/delegation/provider-state.json,安装状态与版本缓存 6 小时,凭证只记时间戳而非布尔值,记录到失败会立即清除已确认状态;凭证存在 CLI 内部时会报告 auth_checked: false,不视为已确认。缓存文件损坏或不可读时按空处理。

限制与边界:路由仍实时探测,Delegator.verify_service 照旧执行版本与认证探测,ledger 不会短路它,这是刻意设计,因为缓存状态无法反映刚失效的凭证。把 ledger 接入 verify_service 还需要区分瞬时拒绝与凭证吊销的失败分类,目前尚不具备。

适用场景:新机器首次委派前;provider 报错且原因不明(二进制、凭证还是模型)时;需要在委派请求中指定 provider 时。不适用于在两个都已就绪的 provider 之间选择,也不用于调试 provider 的输出。

相关:Skill(conjure:delegation-core)(它所支撑的路由)与 Skill(leyline:service-registry)(外部服务的通用健康检查)。