让任何一台设备都能作为 AI 能力节点接入平台，按 9:1 分成机制 赚取积分；让任何用户用积分调用全球分布式 AI 能力。
完整商业闭环：接入费 · 定价 · 调用 · 结算 · 争议 · 仲裁 · MCP/A2A 协议兼容。
1. 协议层与商业层必须分层。MCP（Anthropic 2024-11）和 A2A（Google 2025-04）是横向协议，解决"AI 之间能对话"；但"AI 能力作为商品做交易"是纵向商业要解决的问题——计费、信任、争议、结算、平台担保。联邦 AI 必须在协议之上自建完整的商业层基础设施。
2. 真实物理设备联邦是空白市场。Hugging Face / Replicate / Coze 全部依赖云端稳定算力，无一家覆盖"内网家庭算力" + "异构硬件" + "个人或小机构作为提供方"三个特征。联邦 AI 用 2000 积分（¥20）的极低接入门槛 + RK3568 设备联邦打开这扇门。
3. 信任是平台护城河。MCP/A2A 协议层只定义"能调用"，不解决"谁信谁 / 坏了谁赔"。联邦 AI 通过平台担保 + 9:1 实时结算 + 7 天争议窗口 + admin 仲裁构建闭环。这是协议层无法替代的"水池"。
详细运营数据仅对管理员可见，不在此公开
2024–2025 年 AI 行业同时经历两场结构性变革：
MCP（Anthropic 2024-11）标准化 LLM ↔ 工具/数据接入；A2A（Google 2025-04 → Linux Foundation 2025-06）标准化 Agent ↔ Agent 协作。
解决"能调用"Hugging Face / Replicate / Coze / OpenAI GPT Store / 飞书机器人市场……共同短板：依赖云端稳定算力、面向大机构、缺乏对个人/边缘设备的支持。
解决"做交易"大模型推理集中在云端 GPU 集群，边缘设备闲置。解法：让 RK3568 等任何设备作为能力节点接入。
主流平台对个人/小机构门槛高（云 GPU 时薪 100+ 元）。解法：2000 积分 = ¥20，约 22 天可回本。
个人/长尾设备难以被用户信任，调用方与提供方无仲裁机制。解法：平台担保 + 9:1 实时分账 + 7 天争议窗口 + admin 仲裁。
两个协议是协议层创新，不解决商业层问题：
cost / billing / split 字段MCP/A2A 是"管道"，联邦 AI 是"水池"——联邦 AI 在最上层做商业闭环，下层用 MCP/A2A 做能力接入和 Agent 协作。两者不冲突，是不同层级。
| 维度 | Hugging Face | Replicate | Coze | GPT Store | 联邦 AI |
|---|---|---|---|---|---|
| 目标提供方 | 大机构/研究者 | 模型作者 | 开发者 | ChatGPT 用户 | 任意设备持有者 |
| 算力位置 | 云 + 商用 | 云 GPU | 云 | 云 | 真实物理设备（含内网） |
| 计费粒度 | GPU 时间/订阅 | GPU × 秒 | 订阅 | 用户参与分成 | 按次/按时长 + 接入费 |
| 接入门槛 | 机构/商务对接 | 模型打包 + 部署 | 注册即用 | 需 ChatGPT Plus | 2,000 积分 = ¥20 |
| 信任机制 | 平台托管 | 云 SLA | 平台托管 | 平台托管 | 平台担保 + 争议仲裁 |
| 协议兼容 | REST | REST | REST | OpenAPI | REST + MCP 规划 + A2A 规划 |
「任意设备即能力」——比现有平台多覆盖"内网 + 异构 + 个人算力"三个关键词，是当前所有对标项目都没覆盖的空白。
┌──────────────────────────────┐
│ 1 个 admin（唯一） │
│ - 设备审批 / 争议仲裁 │
│ - 兑换码生成 / 资产总览 │
└──────────┬───────────────────┘
│ 审批设备
┌──────────▼───────────────────┐
│ N 个 master（每设备 1 个） │
│ - 发布能力 / 接收调用 / 分账 │
└──────────┬───────────────────┘
│ 提供能力
┌──────────▼───────────────────┐
│ 不限量 user（任何注册用户） │
│ - 浏览市场 / 购买能力 / 评价 │
└──────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────┐
│ 第一层：门户（port 443） │
│ frd19.com → index.html（中央核心球散开多路径）+ 静态资源 │
│ 静态部署到 nginx 标准 webroot │
└────────────────────────────┬────────────────────────────────────────┘
│
┌────────────────────────────▼────────────────────────────────────────┐
│ 第二层：联邦 AI 平台（port 8004） │
│ FastAPI 后端（单体可演进为微服务） │
│ - 用户体系（手机号 + JWT + 30 天设备免登录） │
│ - 积分制度（兑换码 + 转账 + 商城 + 5 类发放穿透） │
│ - 能力市场（master_capabilities + capability_invocations） │
│ - 接入费 + 9:1 分成 + 7 天争议窗口 │
│ - admin 资产总览 + 兑换码生成 + 设备审批 + 争议处理 │
│ - WebSocket 实时通知链路（fedai 持有 aictrl 长连，转发至浏览器） │
└────────────────────────────┬────────────────────────────────────────┘
│
┌────────────────────────────▼────────────────────────────────────────┐
│ 第三层：aictrl 设备控制（port 9890） │
│ aictrl_server.py（设备注册、审批、token 管理、心跳） │
│ - 设备注册 → admin 审批 → token 签发 │
│ - 联邦节点能力部署 / 异步 invoke / 状态回调 │
│ - 永久 UUID（WSL 设备 `WSL-<16hex>`，RK3568 设备按 serial） │
└─────────────────────────────────────────────────────────────────────┘
能力元数据：name / category / model / billing_mode（per_call/per_minute）/ price_points / price_per_minute_points / visibility / 评分聚合
每次调用留痕：cost_points / master_earning（90%）/ platform_fee（10%）/ duration_minutes / status（success/failed）
UNIQUE(invocation_id) 防重复；三档裁决：approved_full / approved_partial / denied；退款数学按 9:1 反算
所有积分进出留痕：amount + reason（兑换码/注册/接入/调用/能力收益/admin手动/退款/转账）
共 60+ 端点，覆盖用户体系、接入费、能力市场、争议处理、积分三通道、admin 后台、WebSocket 实时通知、MCP/A2A 桥接（规划）。
| 类别 | 端点数 | 关键端点 |
|---|---|---|
| 用户体系 | 12 | /api/auth/login、/api/auth/register、/api/auth/auto_login、/api/me |
| 接入费 / 通道 | 8 | /api/channels、/api/channels/{id}/access、/api/channels/{id}/invoke |
| 能力市场 | 11 | /api/marketplace/search、/api/marketplace/{cap_id}、/api/capabilities/invoke |
| 能力定价 | 2 | /api/capability/pricing?model=X&category=Y（11 模型 × 11 类别 = 121 组合） |
| master 自管理 | 8 | /api/master/capabilities、/api/master/earnings |
| 争议处理 | 4 | /api/disputes、/api/admin/disputes/{id}/resolve |
| 积分三通道 | 6 | /api/points/shop、/api/points/transfer、/api/admin/redeem_codes/generate |
| admin 后台 | 11 | /api/admin/devices/pending、/api/admin/redeem_codes/list、/api/admin/assets/summary |
| WebSocket | 1 | /api/admin/ws（审批实时通知） |
| A2A 桥接（V1.2） | 3 | /.well-known/agent.json、/a2a/v1/tasks/send、/a2a/v1/tasks/{id} |
| MCP 桥接（V1.1） | 2 | /mcp/tools/list、/mcp/tools/call |
任何设备都能作为"能力节点"加入联邦：
| 设备类型 | 标识 | 接入流程 | 典型场景 |
|---|---|---|---|
| RK3568（家庭边缘） | serial（aarch64） | /host/request → 审批 → /host/register | 家庭网关式推理（语音合成 / 本地 LLM） |
| WSL（开发者本地） | WSL-<UUID16> | 同 RK3568，UUID 持久化到 ~/.config/fedai/uuid | 开发者本地测试与开发 |
| 云服务器 | serial（x86_64 / aarch64） | 同 RK3568 | 商用 GPU 推理节点 |
| PC 端 | serial（x86_64） | 同 RK3568 | 业余玩家 / 个人算力共享 |
以"master 多久能回本"为锚反推：先定目标回本周期（个人 ≤1 月），反推单次售价 + 接入费的合理区间，靠"最低保护价"防恶性竞争。
| 模式 | 适用场景 | 用户心理模型 | 防止滥用 |
|---|---|---|---|
| per_call（按次） | 短文案 / 翻译 / 图像 / 单次查询 | "每次成本明明白白" | — |
| per_minute（按时长） | 语音通话 / 实时陪伴 / 多轮对话 / 长时服务 | "按使用时长付费" | MAX_DURATION_MINUTES = 240（4 小时封顶） |
per_call: cost = price_points
per_minute: cost = price_per_minute_points × duration_minutes
master_earning = int(cost × 0.9) # 截断保平台不亏
platform_fee = cost - master_earning # 严格保证 master + platform = cost
9:1 分成（master 90 / 平台 10）:
master_earning = int(cost × 0.9) # 截断
platform_fee = cost - master_earning # 严格保证等式
7 天争议窗口:
✓ 调用完成后 7 天内可发起争议
✓ capability_disputes.invocation_id UNIQUE 防重复
✓ 三档裁决：approved_full / approved_partial / denied
✓ 退款数学：caller 拿 R 积分 → master 扣 int(R × 0.9) 积分
联邦 AI 复用 MCP / A2A 作为传输层，在协议之上自建商业层。两者是不同层级，不冲突。
┌──────────────────┐ JSON-RPC 2.0 ┌──────────────────────────┐
│ Claude Desktop │ ◄─────────────► │ fedai-mcp-server │
│ (MCP Client) │ tools/call │ (新进程, ~200 行 Python) │
└──────────────────┘ └─────────────┬────────────┘
│ HTTP + JWT
▼
┌──────────────────────────┐
│ fedai 平台 (8004) │
│ 积分扣减 + 9:1 结算 │
└─────────────┬────────────┘
│ WSS dispatch
▼
┌──────────────────────────┐
│ RK3568 设备 (master) │
└──────────────────────────┘
1. Tool 映射：把每个能力映射为 MCP tool：
{
"name": "fedai_invoke_capability",
"description": "调用联邦 AI 平台上的能力",
"inputSchema": {
"type": "object",
"properties": {
"capability_id": { "type": "integer" },
"input": { "type": "object" },
"duration_minutes": { "type": "integer", "default": 0 }
},
"required": ["capability_id", "input"]
}
}2. 鉴权流：用户在 Claude Desktop 配置中提供 fedai API Key → 调 /api/auth/api_key_auth → 拿 session token
3. 价值：让所有 MCP 生态客户端能调用联邦 AI 能力，LLM 帮用户付积分，5 分钟可体验。
{
"name": "FederatedAI Marketplace",
"description": "从联邦 AI 能力市场找到最合适的能力并调用",
"url": "https://www.frd19.com/FederatedAI/a2a",
"version": "1.0",
"capabilities": [
"natural-language-requirement-to-capability",
"capability-search-and-rank",
"invoke-capability-and-return-artifact"
],
"authentication": { "schemes": ["Bearer"] },
"skills": [
{ "id": "search-capability", ... },
{ "id": "invoke-capability", ... }
]
}Task 状态机（严格遵循 A2A）：
submitted → working → completed
→ input-required（参数不足）
→ failed（调用失败，已退款）4 步处理：暴露 Agent Card → 收到 task 解析 → 调 /api/marketplace/search → invoke 并包装 Artifact 返回
价值：让联邦 AI 能力进入 A2A 生态（Google Agentspace、LangGraph 多 Agent、SAP Joule、ServiceNow AI Agents）
让 master 能力 = "本机推理 + GitHub MCP + 其他 A2A Agent"的组合工作流，单价 = 各组件成本之和 + 平台分润。能力声明格式：
{
"name": "GitHub Issue 自动回复",
"billing_mode": "per_call",
"price_points": 50,
"components": [
{ "type": "mcp", "server": "github", "tool": "get_issue", "cost_points": 5 },
{ "type": "local", "model": "qwen-turbo", "estimated_tokens": 2000, "cost_points": 20 },
{ "type": "a2a", "agent": "translator", "skill": "translate", "cost_points": 5 }
]
}长期护城河：MCP/A2A 协议可被任何项目实现，但"组合能力 + 成本穿透 + 平台担保"只有联邦 AI 提供。
MCP / A2A / OpenAPI / 自研 — 解决"AI 之间能对话"
⬆ 协议无关 ⬆
| 层 | 机制 | 防护对象 |
|---|---|---|
| 传输层 | HTTPS / WSS（TLS 1.3） | 中间人攻击 |
| 身份层 | JWT（30 天 TTL）+ device_id 绑定（30 天滑动） | 凭证盗用 |
| 授权层 | 角色双轨（普通用户 + 独立 admin）+ master 不可转让 | 越权访问 |
| 资源层 | 积分扣减前置 + consume_points 原子事务 | 重复扣费 |
| 信任层 | 平台担保 + 7 天争议窗口 + admin 仲裁 | 调用方与提供方互信 |
| 加密层 | 兑换码 HMAC 签名 + 私钥用户自管（与代码仓库隔离） | 兑换码伪造 |
| 审计层 | point_logs 完整流水穿透 + admin 资产总览 | 财务审计 |
AI 不读、不写、不传加密逻辑；加密模块与平台代码仓库物理隔离，按部署方安全规范存放于独立路径，私钥不进版本控制。
# 加密模块（按部署方约定路径存放，私钥不进版本控制）
def generate_redeem_code(points: int, note: str = "") -> str:
"""生成兑换码，签名长度可控，碰撞概率可忽略"""
...
def verify_redeem_code(code: str) -> dict | None:
"""验证兑换码，None=无效，dict={"valid":True,"points":int,...}"""
...# 平台启动时按用户配置的路径懒加载用户自管的加密模块
crypto = load_user_crypto_module(configured_path)
if crypto is None:
crypto = _BuiltinCrypto() # 占位 fallback（仅 dev）设备注册流程: 1. 设备生成 serial（或 WSL-UUID） 2. 调 aictrl /host/request → 进入待审队列 3. admin 在 me.html 设备审批中心看到 → 批准 / 驳回 4. 批准 → aictrl /host/register → 设备拿到 host_token（持久化） 5. 设备用 host_token 调 fedai /api/host/ws → 维持 WSS 长连 WSS 长连: - fedai 持有 aictrl WSS 长期连接（指数退避重连） - 设备心跳: 30s 一次 - 异常断开: 5 分钟内自动重连（指数退避） master 不可转让: - channel_grants 行 = master 身份凭证 - 设备换主只能: 旧 master revoke + admin 撤销设备 + 重新审批新设备
接入费 2000 积分 = ¥20；典型按次 20 积分 = ¥0.2；master 实际到手 18 积分 = ¥0.18。
┌──────────────────────────┐
│ 联邦 AI 积分 (1=0.01元) │
└──────────┬───────────────┘
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
获取通道 消费通道 转移通道
├─ 注册赠送 100 ├─ 接入费 2000 ├─ 用户间转账
├─ 兑换码 (admin) ├─ 能力调用按次/时长 │ (手机号)
├─ 商城购买 └─ 争议退款逆向
├─ 评价 / 发布能力
└─ admin 手动 grant
收入 = channel_grants.points_cost SUM
+ capability_invocations.platform_fee SUM
负债 = redeem_codes.points SUM
+ capability_invocations.master_earning SUM
净资产(账面) = 收入 - 负债收入 = Σ|point_logs WHERE reason LIKE
'接入通道%' OR '调用市场能力%'|
负债 = Σ point_logs WHERE reason LIKE
'兑换码%' OR '注册赠送%'
OR 'admin 手动发放%'
OR '能力被调用%'
(其他系统调整 reason)
净资产(实际) = 收入 - 负债账面会高估负债（未兑换的兑换码在外面飞），实际会低估负债（可能有未通过 point_logs 留痕的发放）。两数字之差 = "未结清差额"。
| 渠道 | SQL | 计入 total_issued |
|---|---|---|
| 兑换码 | reason LIKE '兑换码%' | ✅ |
| 注册赠送 | reason LIKE '注册赠送%' | ✅ |
| admin 手动 | reason LIKE 'admin 手动发放%' | ✅ |
| 提供方收益 | reason LIKE '能力被调用%' | ✅ |
| 系统调整 | 系统对账 / 补偿发分等特殊场景（详情见内部文档） | ✅ |
| 用户间转账收到 | reason LIKE '收到←%' | ❌ 转移非新增 |
资产穿透是平台对自身的内部审计能力，让 admin 能从一条积分流水反向还原"它从哪来、到哪去、现在在哪"。本节仅说明会计模型，不展示任何具体数字——具体数字属于运营内部信息，不在此公开。
流通积分余额 = 累计来源 - 累计去路
= (兑换码 + 注册赠送 + 平台补发)
- (调用扣费 + 接入费 + 提供方提现 + 退款)| 指标 | 公式 | 业务含义 |
|---|---|---|
| 来源-去路健康度 | 来源 / 去路（滚动 30 天） | >1 净流入（健康扩张）；<1 净流出（消耗大于发分） |
| 兑换码兑付率 | 已兑换金额 / 已签发金额 | 衡量市场对兑换码的需求强度；<50% 需重新设计面额 |
| 接入费 vs 提现比 | 接入费累计 / 提供方提现累计 | 平台是否"先收后付"（健康）还是"倒贴"（危险信号） |
每一条 point_logs 记录都带 reason 字段（兑换/接入/调用/退款/调整），admin 凭 admin key 可按 reason 聚合任意时间窗口、任意用户、任意能力维度的资金流向。
| 平台 | 形态 | 计费粒度 | 能力交易 | 商业闭环 | 联邦 AI 差异化 |
|---|---|---|---|---|---|
| Hugging Face | 模型托管 | GPU 时间 / 订阅 | 半 | 部分 | + 真实设备 + 个人算力 |
| Replicate | 模型 API | GPU × 秒 | 否 | ✅ | + 内网 + 异构 |
| OpenAI GPT Store | 应用 | 用户参与分成 | ✅ | ✅ | + 设备联邦 + 9:1 透明分成 |
| Coze | Agent 编排 | 订阅 / 企业 | 半 | 部分 | + 设备 + 信任担保 |
| Dify | 编排平台 | 席位 + 调用 | 半 | 部分 | + 设备 + 自动分账 |
| Poe | Bot 市集 | 每条消息 | ✅ | ✅ | + 设备 + 接入门槛低 |
| OpenRouter | 模型路由 | token | 否 | ✅ | + 设备 + 9:1 透明 |
| 飞书/钉钉市场 | 企业机器人 | 席位 / 调用 | ✅ | ✅ | + 设备 + 个人算力 |
| 联邦 AI（目标） | 能力市集 + 支付仲裁 | 积分（次/时长）+ 接入费 + 争议 7 日 | ✅ | ✅ | 差异化 |
任何设备都能接入，门槛 2000 积分（vs HF/Replicate 只能云端）
完整"上架→定价→调用→结算→争议"链路（vs MCP/A2A 是协议不是商业）
平台担保 + admin 仲裁 + 争议处理（vs MCP/A2A 无信任层）
自然语言搜索、人民币结算、中文界面（vs MCP/A2A 是英文圈协议）
真实的边缘算力网络（vs MCP/A2A 只是协议）
智能排序 + 类目筛选 + 自然语言（vs MCP 工具列表很难搜）
2026 (V1.x): 100 设备 · 1,000 用户 · ¥10 万月流水 · 协议层 MCP 兼容 2028 (V2.x): 1,000 设备 · 10,000 用户 · ¥100 万月流水 · 协议层 MCP+A2A 兼容 2030 (V2.5): 10,000 设备 · 100,000 用户 · ¥1000 万月流水 · 跨链结算 2035 (V3.x): 100,000 设备 · 1,000,000 用户 · ¥1 亿月流水 · 设备自进化
| 风险 | 影响 | 概率 | 对策 |
|---|---|---|---|
| master 跑路 | 平台被投诉 / 跑路后能力消失 | 中 | 接入费不退 + 7 天争议 + master 信誉分级 + 黑名单 |
| 羊毛党刷单 | 积分系统被刷空 | 中 | 注册送 100 已限制 + 兑换码 admin 加密 + 设备指纹 + 行为风控 |
| 设备算力不足 | 调用延迟高 / 超时 | 中 | 240 分钟时长封顶 + 异步 dispatch + 超时自动退款 |
| LLM 成本失控 | 平台毛利率被吞掉 | 中 | 最低保护价（20/10 积分）+ 定价助手提示真实成本 + master 自负盈亏 |
| MCP/A2A 协议升级 | 集成代码失效 | 低 | 关注规范更新 + 抽象适配层 + 季度回归测试 |
| 私钥泄露 | 兑换码被伪造 | 低 | 用户自管 + 私钥不进 AI 上下文 + 服务端不存私钥 |
| A2A / MCP 商业层竞争 | 主流平台做"内建计费" | 中 | 先发优势 + 设备联邦壁垒 + 9:1 透明分成 |
| 术语 | 含义 |
|---|---|
| FACA | Federated AI Capability Network，联邦 AI 能力网络 |
| master | 能力提供方，每台接入设备 1 个 |
| user | 能力使用方，任意注册用户 |
| builder | 联邦节点，共建者角色 |
| admin | 平台管理员，1 人 |
| channel | 接入通道（RK3568 设备 / WSL / 服务器） |
| capability | 能力（master 发布的具体服务） |
| billing_mode | 计费模式（per_call / per_minute） |
| dispute | 争议（调用方对结果不满） |
| platform_fee | 平台抽成（10%） |
| master_earning | 提供方所得（90%） |
| point_logs | 积分流水表（穿透审计用） |
| MCP | Model Context Protocol（Anthropic 2024-11） |
| A2A | Agent-to-Agent Protocol（Google 2025-04） |
| 9:1 | 提供方:平台 分成比例 |
| 接入费 | 2000 积分 = ¥20（一次性） |
| 最低保护价 | 按次 20 积分 / 按时长 10 积分（防 0 元恶意竞争） |
联邦 AI 能力网络以标准 FastAPI + nginx + systemd 形态交付，可一键部署到任意 Linux 服务器。完整源码 + 部署脚本以"对接包"形式提供给合作方，具体路径与凭据由部署方按自身安全规范决定，不在本白皮书公开。