用 ruflo-federation status 命令诊断跨实例 Agent 联邦健康peers、trust 与消息指标完整解读【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo联邦Federation是 Ruflo 跨机器多 Agent 协同的通信层多台安装你的 Mac、服务器、队友的笔记本通过 Ed25519 身份握手、五级信任阶梯、PII 流水线与合规审计日志交换带签名的 Agent 信封。本文以federation-status技能为核心讲解如何用ruflo-federation status/peers命令输出健康快照结合会话数、消息交换、PII 脱敏与威胁检测等指标做一次完整的联邦体检并落到仓库源码层解释每个字段从哪来、每个状态机如何流转。技能定位什么时候触发 federation-status在 SKILL.md 中该技能被设计为按描述自动触发的运维技能skill frontmatter 中的description即触发条件用户询问 is federation healthy?、show peers、federation status用户想要检查跨安装的 Agent 连通性其 frontmatter 声明了运行所需的最小工具集frontmatter 字段取值namefederation-statusallowed-toolsBash(npx *)、mcp__plugin_ruflo-core_ruflo__memory_search、Readargument-hint空无需参数注意allowed-tools明确不允许通配符工具授权plugins/ruflo-federation/scripts/smoke.sh第 10 步专门校验no wildcard tool grants in skills这保证了技能只会通过npx运行联邦 CLI 与只读的 memory 检索不会触碰写操作。三步体检流程从整体健康到逐 peer 明细SKILL.md 规定的执行步骤只有三步但每一步背后都对应一条真实存在的 CLI 命令与源码调用链整体健康npx -y -p claude-flow/plugin-agent-federationlatest ruflo-federation status逐 peer 明细npx -y -p claude-flow/plugin-agent-federationlatest ruflo-federation peers汇总上报活跃会话数、消息交换量、PII 脱敏次数、威胁检测命中数npx -y -p packagelatest bin是 npm 的临时安装并执行模式-y免确认、-p把包放入临时 PATH因此无需预先全局安装latest确保每次运行都解析到claude-flow/plugin-agent-federation的最新发布版docs/federation/README.md 中当前为1.0.0-alpha.14。status 子命令的源码实现ruflo-federation status的处理器位于 cli-commands.ts。它以--format table|json为选项默认table底层调用coordinator.getStatus()Node ID: nodeId Active Sessions: n Known Peers: n Healthy: true|false而getStatus()定义在 federation-coordinator.tshealthy直接等于this.initialized即本节点是否完成过federation initactiveSessions统计当前仍为 active 的会话数knownPeers来自 discovery 注册表trustLevels是一张nodeId → TrustLevel的映射表。所以status的本质是一次对本地 Coordinator 状态的纯读快照不发起网络请求。peers 子命令带信任等级的 peer 列表ruflo-federation peers同样支持--format table|json。table 模式打印Node ID | Trust Level两列信任等级经getTrustLevelLabel转为可读名称json 模式直接输出status.trustLevels映射。若调用前未federation initrequireCoordinator会抛出Federation not initialized. Run federation init first.cli-commands.ts——这也是诊断联邦未初始化类问题的直接线索。技能内的补充检索SKILL.md 还建议用 memory 检索联邦历史把当前快照与历史背景对齐mcp__plugin_ruflo-core_ruflo__memory_search({ query: federation peer trust, namespace: federation })这依赖ruflo-core插件提供的 MCP server命名空间路由到federationpeer 注册表、信任分数历史、审计日志索引、信封回执都存放在该命名空间见 plugins/ruflo-federation/README.md 的 Namespace coordination 一节。读懂 status 输出背后的信任阶梯peers输出的Trust Level是联邦安全模型的核心。等级定义在 trust-level.ts 中是一个 0–4 的五级枚举等级数值解锁能力CAPABILITY_GATESUNTRUSTED0discoveryVERIFIED1status、pingATTESTED2send、receive、query-redactedTRUSTED3share-context、collaborative-taskPRIVILEGED4full-memory、remote-spawn信任不是一步到位的TRUST_TRANSITION_THRESHOLDS定义了升级门槛trust-level.ts跃迁upgradeScoredowngradeScoreminInteractionsVERIFIED→ATTESTED (1→2)0.700.5050ATTESTED→TRUSTED (2→3)0.850.65500TRUSTED→PRIVILEGED (3→4)0.950.805000也就是说你在peers输出里看到 peer 停留在ATTESTED可能是因为它只积累了 60 次交互、信任分未过 0.85而不是网络故障。另外ADR-164 提供了一条运营逃生通道federation trust elevate对已注册 peer 手动直升如--to TRUSTED --reason ... --audit--audit必填每次操作写入带bootstrap_elevation标签的trust_level_changed审计条目cli-commands.ts。会话与消息指标健康度的两个观测点SKILL.md 第 3 步要求Summarize: active sessions, messages exchanged, PII redactions, threat detections这些指标分布在多个只读工具上活跃会话status的Active Sessionsfederation_trust node-id可查单 peer 信任分详情mcp-tools.ts。消息交换与失败原因federation_send的返回结果被拒消息会以message_rejected审计事件落库并携带reasonPEER_SUSPENDED/PEER_EVICTED/INVALID_BUDGET/HOP_LIMIT_EXCEEDED/BUDGET_EXCEEDED等常量字符串成功的发送记录message_sent与latencyMsfederation-coordinator.ts。PII 脱敏联邦内每个跨 peer 信封都要过 PII 流水线14 类检测 按信任等级执行 BLOCK/REDACT/HASH/PASS 策略脱敏行为本身可审计。威胁检测handleThreatDetection与handleHmacFailure在检测到重复威胁或 HMAC 校验失败时会降级 peer 至UNTRUSTED、终止会话并写threat_blocked审计federation-coordinator.ts。若需要结构化回看这些事件用federation_audit工具或ruflo-federation audit命令加过滤条件npx -y -p claude-flow/plugin-agent-federationlatest ruflo-federation audit \ --compliance hipaa --since 2026-09-01 --limit 50支持--compliancehipaa/soc2/gdpr、--sinceISO 8601、--export json|csv|ndjson、--limit默认 50实现位于 cli-commands.ts。断路器状态status 之外的第二个状态机除了信任等级每个 peer 还挂着一个熔断状态机ACTIVE → SUSPENDED → EVICTEDADR-097README 中 Phase 4 落地。它与健康度直接相关SUSPENDEDpeer 的出站发送短路返回PEER_SUSPENDED已有会话继续、新发送被拒持续失败自动升级。EVICTED发送短路PEER_EVICTED会话被终止只能由操作员显式federation_reactivate恢复。熔断器不会自动恢复需要集成方的健康探针确认 peer 恢复后调用federation_reactivate。对应工具为federation_breaker_status返回每个 peer 的状态、变更时间与原因及{active, suspended, evicted}汇总计数、federation_evict与federation_reactivatemcp-tools.ts。getPeerStateCounts()在 Coordinator 上做 O(peers) 扫描可安全地放进状态栏做常驻观测federation-coordinator.ts。集成到自动化与无头模式技能描述里说这套体检经常出现在 show peers / federation status 场景也可被无头 CLI 驱动。claude -pprint/pipe 模式可以非交互地调用联邦 MCP 工具适合定时巡检claude -p --model haiku --max-budget-usd 0.20 --output-format text \ Federation MCP tools to verify cross-machine peering health: name 3. One line.注意claude -p每次调用处理完即退出若要常驻联邦监听需运行长生命周期 MCP serverdocs/federation/README.md 的 Using claude -p headless mode 一节有跨主机任务交接的完整示例。从源码结构看CLI 与 MCP 工具共用同一个FederationCoordinator因此两种入口读到的状态是一致的。验证与契约仓库以bash plugins/ruflo-federation/scripts/smoke.sh作为插件契约预期输出10 passed, 0 failed见 plugins/ruflo-federation/README.md Verification 一节。其中与 status 技能直接相关的校验包括三个技能含federation-statusfrontmatter 完整、README 声明了 ADR-097 预算字段maxHops/maxTokens/maxUsd/BUDGET_EXCEEDED/HOP_LIMIT_EXCEEDED、五级信任模型、合规模式HIPAA/SOC2/GDPR以及技能内无通配符工具授权。改动了联邦 CLI、信任模型或技能定义后跑一遍 smoke 即可快速回归。相关参考联邦能力总览见 docs/federation/README.md插件安装与命令全集见 plugins/ruflo-federation/README.md 与 commands/federation.md预算与熔断的架构决策记录在v3/docs/adr/下的 ADR-097、ADR-104、ADR-111 等文档中。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考