用途
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:可视化模式——展示舰队拓扑结构
使用方式
执行流程分为若干步骤:
- 检测与加载:通过 git 定位 ORACLE_ROOT,检查 CLAUDE.md 与 ψ 目录,确定 PSI 路径。
- 加载 contacts:读取
$PSI/contacts.json;若不存在则提示先运行/contacts注册舰队成员。 - 发现节点与 oracle:用 Python 解析 contacts.json,按
maw字段中的冒号前缀划分节点,输出每个节点下的 oracle 列表及 repo、notes。 - ping 与采集(--deep 模式):对本地 oracle 直接检查仓库(最后提交、ψ/ 中最近活动文件、已安装技能数量);对远程 oracle 通过
maw hey发送 wormhole ping 请求汇报版本、技能数与最后提交。 - 报告:输出标准化表格,含节点、oracle 数量、状态、最后活动时间,以及每个 oracle 的详情(repo、最后提交、技能数、备注)。
- 保存普查:将结构化 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
暂未提供
文档未说明该技能的价格、收费模式、平台支持范围、安装命令及具体效果指标,这些信息暂未提供。