SuperAPI AI 工具集

fleet

智能体与模型

查看项目

更新于 10-16 06:04

技能介绍

用途

fleet 的核心用途是“Deep Fleet Census”(深度舰队普查):跨所有节点发现全部 oracle,收集其版本、已安装技能、最后活动时间与健康状态,从而得到 oracle 网络的完整图景。文档将其描述为“Count the stars. Know the constellation. The fleet is one body, many hands.” 当用户说出 "fleet"、"census"、"all oracles" 等词时使用。

主要能力

提供多种运行模式:

  • /fleet:标准普查——节点 + oracle + 状态
  • /fleet --quick:快速模式——仅从 contacts 统计节点和 oracle 数量
  • /fleet --deep:深度模式——ping 全部节点,收集版本、技能与活动
  • /fleet --diff:对比模式——显示自上次普查以来的变化
  • /fleet --map:可视化模式——展示舰队拓扑结构

使用方式

执行流程分为若干步骤:

  1. 检测与加载:通过 git 定位 ORACLE_ROOT,检查 CLAUDE.md 与 ψ 目录,确定 PSI 路径。
  2. 加载 contacts:读取 $PSI/contacts.json;若不存在则提示先运行 /contacts 注册舰队成员。
  3. 发现节点与 oracle:用 Python 解析 contacts.json,按 maw 字段中的冒号前缀划分节点,输出每个节点下的 oracle 列表及 repo、notes。
  4. ping 与采集(--deep 模式):对本地 oracle 直接检查仓库(最后提交、ψ/ 中最近活动文件、已安装技能数量);对远程 oracle 通过 maw hey 发送 wormhole ping 请求汇报版本、技能数与最后提交。
  5. 报告:输出标准化表格,含节点、oracle 数量、状态、最后活动时间,以及每个 oracle 的详情(repo、最后提交、技能数、备注)。
  6. 保存普查:将结构化 JSON 保存到 $PSI/memory/fleet-census-latest.json,含时间戳、节点列表、oracle 详情与 ping 结果,供下次 --diff 使用。

--map 模式会以树状图展示舰队拓扑,并用 “← YOU ARE HERE” 标记当前 oracle;说明中明确线条表示节点归属,而非通信路径。--diff 模式通过对比上次保存的普查,展示新增 oracle、移除 oracle、变更的 oracle 以及活动增量(自上次普查以来的提交数)。

适用场景

适用于管理由多个节点和多个 oracle 组成的分布式网络,需要统一盘点成员、健康状态与活动情况,或需要跟踪网络随时间变化、可视化拓扑结构时。文档强调其通用性:“works for ANY fleet, ANY contacts.json”。

限制与规则

  • 必须从 contacts 发现,绝不硬编码节点或 oracle
  • 本地优先:先直接检查本地仓库,再 ping 远程
  • 不包含机密:普查绝不包含 .env、token 或凭据
  • 始终保存普查以供未来对比
  • 对无响应的远程节点设置超时,每次 ping 5 秒,避免挂起
  • 依赖 contacts.json 存在,否则以错误退出并提示先运行 /contacts

暂未提供

文档未说明该技能的价格、收费模式、平台支持范围、安装命令及具体效果指标,这些信息暂未提供。