@twinsearth/agent-universe 2.3.6 → 2.5.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Universe Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,410 @@
+# Agent Universe（智能体宇宙）
+
+> **使命：让科技造福全人类！**
+>
+> **一句话简介：群众化的 AGI 路线，去中心化的智能体共享 & 开源网络。**
+
+[![CI](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml/badge.svg)](https://github.com/TwinsEarth/agent-universe/actions/workflows/ci.yml)
+[![Release](https://img.shields.io/github/v/release/TwinsEarth/agent-universe)](https://github.com/TwinsEarth/agent-universe/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Rust](https://img.shields.io/badge/rust-2021%20edition-orange.svg)](https://www.rust-lang.org/)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![npm](https://img.shields.io/badge/npm-%40twinsearth%2Fagent--universe-red.svg)](https://github.com/TwinsEarth/agent-universe/packages)
+
+## 核心理念
+
+### 群体智能 = 网络结构的 Scaling Law
+
+大模型通过参数、数据、算力的 Scaling Law 已实现智能涌现，解决了智能的有无问题。
+
+**智能体宇宙**是在其基础上，实现更多、更大、更强的智能与自我迭代——这是**网络结构的 Scaling Law**，从 token 网络结构向智能体网络结构演进。
+
+### 群众路线
+
+当前基础大模型军备竞赛已达千亿万亿元级门槛，普通人无法参与，智能即将被巨头垄断。
+
+**急需第三方介入**，在闭源阵营与开源阵营之间探索一条普惠大众、全民参与的 AGI 甚至 ASI 之路——**群众路线**。
+
+通过这个全民网络，让底层人民也能参与、贡献、分享这场智能科技革命。（类似于 Linux）
+
+### 结构相变拐点
+
+大模型（参数、数据、算力）的 Scaling Law 已预见单个大模型撞到了 Scaling Law 规模墙。
+
+通过大力出奇迹的收益已经逼近"结构相变拐点"：**Scaling Law 即将失效**，需要从结构上突破。
+
+## 系统架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Agent Universe 网络                       │
+│                                                               │
+│   ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐       │
+│   │ Mac mini│  │ Windows │  │ Android │  │ 服务器   │       │
+│   │ 根种子   │  │ 全节点   │  │ 轻节点   │  │ 全节点   │       │
+│   └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘       │
+│        └────────────┴────────────┴────────────┘             │
+│                         │                                    │
+│              ┌──────────┴──────────┐                        │
+│              │  Kademlia DHT 路由表  │                        │
+│              │  （每个节点持有切片）  │                        │
+│              └──────────┬──────────┘                        │
+│                         │                                    │
+│         ┌───────────────┼───────────────┐                   │
+│         ▼               ▼               ▼                   │
+│   ┌──────────┐   ┌──────────┐   ┌──────────┐               │
+│   │ GossipSub │   │  CRDT    │   │ 纠删码    │               │
+│   │ 消息广播  │   │ 状态同步  │   │ 数据冗余  │               │
+│   └──────────┘   └──────────┘   └──────────┘               │
+│                                                               │
+│   链上信任锚（Base / Arbitrum）                                │
+│   · 身份  · 质押  · 结算  · 治理                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 核心模块
+
+### Rust 核心库（gsn-core）
+
+| 模块 | 功能 |
+|------|------|
+| `identity/` | DID 身份、Ed25519 密钥对、签名、平台安全存储 |
+| `agent/` | AgentCard 身份卡、Skill 注册、任务生命周期 |
+| `net/` | Kademlia DHT、GossipSub、libp2p 节点、根种子 |
+| `chain/` | PoCV 可验证计算、EVM 轻客户端 |
+| `storage/` | SQLite 本地存储 |
+| `verifier/` | Verifier HTTP 客户端 |
+| `swarm/` | **群体智能层**：涌现检测、轻量共识 |
+| `economy/` | **信誉经济系统**：信誉分、贡献证明、动态定价 |
+| `scheduler/` | **任务调度器**：任务路由、负载均衡 |
+| `topology/` | **网络拓扑**：邻居管理、拓扑图 |
+| `proof/` | **贡献证明**（Proof of Contribution） |
+| `mode/` | 节点模式：Archive / Full / Light / Edge / Browser |
+| `crdt/` | CRDT 无冲突复制数据类型 |
+| `erasure/` | Reed-Solomon 纠删码 |
+| `mcp/` | **MCP 兼容层**（v2.3.2） |
+| `aca/` | **ACA 兼容 API**（v2.3.2） |
+| `marketplace/` | **智能体市场 Agent Market**（v2.3.4）：注册/发现/匹配/BFT验证/结算/信誉 |
+| `bin/` | **gsn-daemon** 守护进程 |
+
+### Python SDK（aip-sdk-py）
+
+- Agent Interop Protocol 客户端
+- 任务提交与查询
+- 本地开发与测试
+
+### 智能体市场（Agent Market · v2.3.4）
+
+智能体宇宙的第一版**经济层**，让智能体、技能、任务、算力可以完成完整交易闭环：
+
+```
+注册 → 发布 → 匹配 → 执行 → 验证 → 结算 → 信誉更新
+  ↑                                      ↓
+  └──────────── 争议/仲裁/罚没 ←─────────┘
+```
+
+| 机制 | 说明 |
+|------|------|
+| AgentCard 注册 | 质押准入（最低门槛），能力声明 + 签名 |
+| TaskSpec | 六字段校验：goal/context/done/todo/trace/owner |
+| 匹配引擎 | 技能/信誉/负载过滤，性价比排序 |
+| BFT-lite QA | n≥3f+1，equivocation 整轮作废，view change |
+| 结算守恒 | balance_sum = budget - slashed，防重复支付 |
+| 多维信誉 | quality/speed/honesty/availability，**不可转让** |
+| 质押罚没 | 作恶扣除质押，信誉同步下降 |
+| 证据分级 | verified / cpu-proto / unverified |
+
+### Smart Contracts
+
+| 合约 | 功能 |
+|------|------|
+| `GovernorToken.sol` | 治理代币 |
+| `AgentCardAnchor.sol` | AgentCard 链上锚定 |
+| `PoCVSettlement.sol` | PoCV 结算 |
+| `ReputationBridge.sol` | 跨链信誉桥接 |
+
+## 快速开始
+
+### 编译 Rust 核心库
+
+```bash
+cd gsn-core
+cargo build --release
+```
+
+### 运行测试
+
+```bash
+# Rust 测试
+cd gsn-core && cargo test
+
+# Python SDK 测试
+cd aip-sdk-py && PYTHONPATH=. pytest tests/ -v
+```
+
+### 启动 gsn-daemon
+
+```bash
+cd gsn-core
+# 前台运行（默认 P2P 4001 / HTTP API 4002）
+cargo run --release --bin gsn-daemon
+# 自定义端口与数据目录
+cargo run --release --bin gsn-daemon -- \
+  --port 4001 --api-port 4002 --data-dir ~/.gsn/data
+# 连接已有引导节点（非根种子）
+cargo run --release --bin gsn-daemon -- \
+  --bootstrap /ip4/<bootstrap-ip>/tcp/4001
+```
+
+启动后可访问 HTTP API：
+
+| 方法 & 路径 | 功能 |
+|---|---|
+| `GET /health` | 节点健康、版本、模式、连接数、运行时长 |
+| `GET /version` | daemon 版本 |
+| `GET /peers` | 本地 Peer ID、连接数、DHT 路由表条目 |
+| `GET /agents` | 已注册智能体列表 |
+| `GET /tasks` | 任务列表 |
+| `POST /agents` | 注册 AgentCard（同时落 SQLite 与 DHT） |
+
+> **当前实现状态**：gsn-daemon 已是**真实网络节点**——libp2p（Noise 加密 + Kademlia DHT + GossipSub）真实 bind P2P 端口，HTTP API 真实 bind API 端口，agents/tasks 通过 SQLite 真实落盘并在重启后恢复。已真机验证：两端口 `LISTEN`、各 API 端点返回正确、POST 注册可查、404 路径正确转义、kill 重启后数据仍在。核心业务逻辑（Agent Market 结算守恒、BFT-lite 验证、信誉）由 155 个 Rust 测试 + 17 个 Python 测试 + 12 个 JS 测试守护，跨语言签名测试保证三端身份/签名互验。链上结算与跨主机多节点 DHT 联调为下一步目标。
+
+### 三大连接层：CLI · API · MCP（v2.3.5 引入，v2.3.6 深化）
+
+v2.3.5 重新梳理并补全三种连接方式，v2.3.6 进一步把 MCP 真实化、把 ACA 身份与签名补全，并让 Rust/Python/JS 三端在身份与协议层跨语言对齐。三者分别服务于不同场景：
+
+- **CLI** 让用户通过命令行直接操控节点；
+- **REST API** 让不同软件按约定交换数据与能力；
+- **MCP** 为 AI 提供统一工具连接标准，让大模型安全、规范地调用市场能力。
+
+**① CLI（子命令式，二进制 `gsn`）**
+
+```bash
+cargo run --bin gsn -- version          # 版本
+cargo run --bin gsn -- identity         # 生成 Ed25519 身份
+cargo run --bin gsn -- daemon           # 启动节点（等价 gsn-daemon）
+cargo run --bin gsn -- mcp              # 以 stdio 方式启动 MCP 服务
+
+# market 子命令通过 HTTP API 连接运行中的节点
+export GSN_API=http://127.0.0.1:4002    # 或用 --api 指定
+gsn market deposit caller-1 1000        # 充值
+gsn market balance caller-1             # 查询余额
+gsn market register card.json           # 注册智能体（也支持内联 JSON）
+gsn market get <agent_id>               # 查询智能体
+gsn market discover translation         # 按技能发现
+gsn market search 关键词                # 搜索
+gsn market stats                        # 市场统计
+```
+
+**② REST API（`/api/v1/*`，同时兼容旧版 `/agents` `/tasks`）**
+
+| 方法 & 路径 | 功能 |
+|---|---|
+| `POST /api/v1/accounts/:account/deposit` | 充值 |
+| `GET /api/v1/accounts/:account/balance` | 余额 |
+| `POST /api/v1/agents` | 注册智能体（201，需质押） |
+| `GET /api/v1/agents?skill=` / `?q=` | 按技能发现 / 关键词搜索 |
+| `GET /api/v1/agents/:id` | 智能体详情 |
+| `POST /api/v1/tasks` | 发布任务（201） |
+| `GET /api/v1/tasks` / `/:id` | 任务列表 / 详情 |
+| `POST /api/v1/tasks/:id/bids` | 投标（201） |
+| `POST /api/v1/tasks/:id/match` | 匹配最优智能体 |
+| `POST /api/v1/tasks/:id/results` | 提交执行结果（201） |
+| `POST /api/v1/tasks/:id/verify` | BFT-lite QA 验证 |
+| `POST /api/v1/tasks/:id/settle` | 结算 |
+| `POST /api/v1/disputes` / `:id/arbitrate` | 争议 / 仲裁 |
+| `GET /api/v1/conservation` | 结算守恒检查 |
+| `GET /api/v1/leaderboard?limit=` / `/stats` | 排行榜 / 统计 |
+| `POST`·`GET /api/v1/mcp` | MCP（无状态 JSON-RPC / SSE） |
+
+业务错误返回 `422`，资源不存在返回 `404`，注册类成功返回 `201`，`OPTIONS` 返回 `204`。
+
+**③ MCP（18 个市场工具，支持 stdio 与 HTTP/SSE 两种传输）**
+
+- stdio：`gsn mcp`，逐行读写 JSON-RPC（日志走 stderr），可直接接入 Claude Desktop / Cursor 等；
+- HTTP：`POST /api/v1/mcp` 无状态 JSON-RPC，`GET /api/v1/mcp` 返回 `text/event-stream` 初始化帧。
+
+工具命名 `market_*`，覆盖：`market_register_agent`、`market_discover_agents`、`market_publish_task`、`market_submit_bid`、`market_match_task`、`market_submit_result`、`market_verify_result`、`market_settle_task`、`market_open_dispute`、`market_arbitrate`、`market_deposit`、`market_balance`、`market_conservation`、`market_leaderboard`、`market_stats` 等共 18 个。`tools/call` 全部路由到市场 actor **真实执行**（非占位）。
+
+> 三层均已真机验证：daemon 真实 bind P2P/API 端口，curl 走通「充值→注册→发布→投标→匹配→结果→验证→结算→守恒」完整闭环；MCP stdio 完成 `initialize` / `tools/list`（18 工具）/ `tools/call`；CLI 各子命令连接节点返回真实数据。由 155 个 Rust 测试守护，跨语言签名测试保证 Rust/Python/JS 三端身份、规范载荷与签名逐字节一致、可互验。
+
+### Python SDK 使用
+
+```python
+from aip import AgentCard, Task, ShardedIndex
+
+card = AgentCard.new(did="did:aip:demo", name="my-agent")
+card.with_capability("text-generation")
+
+index = ShardedIndex(num_shards=16)
+index.put(card.did, card)
+```
+
+### JS SDK 安装
+
+**方式一：公共 npmjs（零认证，推荐）**
+
+包已发布到公共 npm registry，任何人无需 token 即可安装：
+
+```bash
+npm install @twinsearth/agent-universe
+```
+
+**方式二：jsDelivr 公开 CDN（无需登录 / 无需 token）**
+
+浏览器或 Node 直接下载：
+
+```bash
+# 一键下载主入口与全部模块（零认证）
+BASE="https://cdn.jsdelivr.net/gh/TwinsEarth/agent-universe@main/js"
+curl -O "$BASE/index.js" --create-dirs
+for f in keychain models dht market aca mcp; do
+  curl -o "lib/$f.js" --create-dirs "$BASE/lib/$f.js"
+done
+```
+
+也可在 HTML 中直接引用单文件：`https://cdn.jsdelivr.net/gh/TwinsEarth/agent-universe@main/js/index.js`
+
+**方式三：GitHub Packages（需 GitHub token）**
+
+```bash
+# 包发布在 GitHub Packages registry，需先配置凭证
+npm config set @twinsearth:registry https://npm.pkg.github.com
+npm install @twinsearth/agent-universe
+```
+
+已发布版本：1.0.0 / 2.0.0 / 2.2.0 / 2.3.0 / 2.3.1 / 2.3.4 / 2.3.5 / 2.3.6 / 2.4.0 ~ 2.5.6，详见 [Releases](https://github.com/TwinsEarth/agent-universe/releases)。
+
+## 版本谱系
+
+| 版本 | 代号 | 核心特性 |
+|------|------|----------|
+| v1.0.0 | Genesis | 项目初始化 |
+| v2.0.0 | Shard | 分片存储与 DHT |
+| v2.1.0 | Bridge | 跨链桥接与经济层 |
+| v2.2.0 | Mesh | 全对等网络 |
+| v2.3.0 | P2P | P2P 分布式网络基础 |
+| v2.3.1 | Swarm | 群体智能：网络结构的 Scaling Law |
+| v2.3.2 | MCP+ACA | MCP 和 ACA 兼容 API |
+| v2.3.3 | P2P Net | P2P 分布式网络应用 |
+| v2.3.4 | Market | 智能体市场 Agent Market |
+| v2.3.5 | **Client** | **跨平台客户端 + CLI/REST/MCP 重构** |
+| v2.3.6 | **MCP/ACA** | **MCP/ACA 深化重构 + 三端跨语言可信对齐** |
+| v2.4.0 | **Govern** | **CPU 治理轻量化：结算守恒 O(1) 增量维护 + Sandbox trait（Docker/Firecracker）** |
+| v2.4.1 | **Layer** | **Lv1–Lv7 分层拓扑：扇入有界、边数亚二次、路由≤7 跳 + TopologyRouter 降级** |
+| v2.4.2 | **Memory** | **个体内部记忆库 + 群体外部共享记忆库** |
+| v2.4.3 | **3-Tier Memory** | **分层主体记忆（Lv1–Lv7）+ 跨代记忆哈希链** |
+| v2.4.4 | **Memory+** | **个体记忆增强：标签/关键词检索、记忆评价防污染、LRU 压缩遗忘** |
+| v2.4.5 | **Handoff** | **TransferBundle 六字段交接 + TraceLedger 审计 + 证据三级标签** |
+| v2.4.6 | **Flywheel** | **群体智能飞轮：协同→经验→优化结构→闭环** |
+| v2.4.7 | **Hetero LLM** | **异构 LLM 多智能体：跨智能体协同、评分内部投票、跨模型记忆协作** |
+| v2.4.8 | **DeepSeek** | **DeepSeek 模型适配层：提示词编码、协议互转、token 编解码** |
+| v2.4.9 | **Multi-LLM** | **OpenAI / Gemini / Anthropic 三大后端适配** |
+| v2.5.0 | **Doubao** | **豆包 / 火山引擎方舟适配（Seed 2.1，1024K）** |
+| v2.5.1 | **CN Models** | **国内六大模型统一适配：Kimi / 千问 / 智谱 / MiniMax / 混元 / 小米** |
+| v2.5.2 | **Net Partition** | **国内外模型网络分区感知 + 外网不可达自动降级** |
+| v2.5.3 | **Mesh** | **Mesh 自组网：心跳 / 广播 / 嗅探 / 会话，临时 SN↔永久身份绑定** |
+| v2.5.4 | **Traversal** | **NAT 穿透：Circuit Relay v2 + AutoNAT + DCUtR + Ping，跨网中继** |
+| v2.5.5 | **Relay Pool** | **Relay 节点池管理 + 多通道智能切换（默认 3 条，掉线自动补）** |
+| v2.5.6 | **Regression** | **历史 Bug 回归套件：test/ 14 条 + Rust 网络回归，CI 强制全量回归，修新 bug 先加用例** |
+
+详见 [RELEASES.md](RELEASES.md) 和 [releases/](releases/) 目录。
+
+## 技术栈
+
+- **语言**: Rust 2021 Edition + Python 3.10+
+- **P2P**: libp2p（Kademlia DHT + GossipSub + QUIC）
+- **加密**: Ed25519 + SHA256 + X25519
+- **存储**: SQLite + DHT + IPFS Bitswap
+- **合约**: Solidity（Base / Arbitrum 主网）
+- **部署**: Mac mini M4 + launchd / Docker / systemd
+- **CI/CD**: GitHub Actions（矩阵构建 + 自动测试）
+
+## 贡献
+
+欢迎贡献！请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解开发流程。
+
+## 安全
+
+报告安全漏洞请参考 [SECURITY.md](SECURITY.md)。
+
+## 开源协议
+
+[MIT License](LICENSE)
+
+---
+
+**Agent Universe · 智能体宇宙**
+
+*让科技造福全人类！*
+
+## v2.3.5 跨平台客户端
+
+v2.3.5 新增基于 Tauri 2 的跨平台客户端。客户端**源码**在仓库内，**安装包为构建产物、不入库**：在推送版本 tag 时由 [`.github/workflows/client-build.yml`](.github/workflows/client-build.yml) 在对应系统的 runner 上自动构建，并发布到 GitHub Release 下载。
+
+**源码位置**
+
+- 客户端工程：`client/`（前端 Vite + HTML/JS 在 `client/src/`，Rust 壳 `client/src-tauri/`，Android 工程 `client/src-tauri/gen/android`）
+- 桌面端源码目录：`desktop/`
+- 各平台本地构建说明：`client/platforms/`
+
+**安装包（在 GitHub Release 下载，非仓库内路径）**
+
+| 平台 | 产物 | 说明 |
+|------|------|------|
+| macOS | `.dmg` / `.app` | Apple Silicon（Intel 可本地自行构建） |
+| Windows | `.msi` / `-setup.exe`（NSIS） | x64 |
+| Linux | `.deb` / `.AppImage` | x64 |
+| Android | `.apk` | universal / 分 ABI |
+| iOS | 见 `client/ios/README.md` | 需 Apple Developer 证书与描述文件，开源仓库不内置签名成品 |
+
+Release 下载：https://github.com/TwinsEarth/agent-universe/releases/tag/v2.3.5
+
+**本地手动构建**
+
+```bash
+cd client
+npm install
+npm run build        # 前端
+npx tauri build      # 桌面安装包（需在对应系统上，并装好平台依赖）
+npx tauri android build --apk   # Android（需 JDK + Android SDK/NDK）
+```
+
+## v2.3.6 MCP/ACA 深化与跨语言可信对齐
+
+v2.3.6 把 MCP 从占位门面重写为真实工具协议，把 ACA 的身份与规范签名补全，并让 Rust/Python/JavaScript 三端在身份、规范载荷与签名层面逐字节对齐、可互验。
+
+**统一身份与规范签名**
+
+三端身份口径一致：Ed25519 原始 32 字节公钥 → SHA256 前 8 字节 → `did:aip:<16hex>`；规范载荷为移除 `signature` 键后紧凑、键按字典序、非 ASCII 不转义的 JSON 字节。
+
+```js
+const { AipIdentity, buildManifest } = require('@twinsearth/agent-universe');
+const id = AipIdentity.generate();
+const manifest = buildManifest(id, 'MyAgent', ['text-generation'], { stake: 100 });
+AipIdentity.verifyObject(manifest, id.publicKey);   // true
+```
+
+**MCP 客户端连接节点**
+
+```js
+const { McpHttpClient } = require('@twinsearth/agent-universe');
+const mcp = new McpHttpClient('http://127.0.0.1:4002');
+await mcp.initialize();
+const tools = await mcp.listTools();        // 18 个工具，字段为规范 inputSchema
+await mcp.callTool('market_stats', {});    // 经 daemon 真实路由执行
+```
+
+Python 侧对应 `aip.AipIdentity`、`aip.build_manifest`、`aip.McpHttpClient`、`aip.MarketClient`，与 JS/Rust 同口径。固定种子（32 字节 `0x01`）下三端公钥、DID、签名逐字节一致，篡改载荷或使用他人公钥即被拒绝。
+
+Release 说明：https://github.com/TwinsEarth/agent-universe/releases/tag/v2.3.6
+
+## 文档
+
+- **版本号登记表（发版必读）**：[docs/version-checklist.md](docs/version-checklist.md) — 全仓所有版本声明点清单 + 发版 SOP；一键改版本见 `scripts/bump-version.sh`。
+- **架构文档 v2.5.5**：[docs/architecture-v2.5.5.md](docs/architecture-v2.5.5.md) — v2.5.x 全量：Lv1–Lv7 分层拓扑、三层记忆共享、异构 LLM 适配层、网络分区降级、Mesh 自组网、Relay 池与多通道、三端跨网真机实测。
+- **架构文档 v2.3.6**：[docs/architecture-v2.3.6.md](docs/architecture-v2.3.6.md) — 技术架构与系统框架、网络结构与安全机制、功能模块与产品功能（含分层图）。
+- **设计文档 v2.4.0–v2.4.1**：[docs/design-v2.4.0-v2.4.1.md](docs/design-v2.4.0-v2.4.1.md) — CPU 治理轻量化与 Lv1–Lv7 分层拓扑设计。
+- 深度分析 v2.3.4：[docs/v2.3.4-deep-analysis.md](docs/v2.3.4-deep-analysis.md)
+- 部署与验证报告：[docs/部署与验证报告-2026-09-23.md](docs/%E9%83%A8%E7%BD%B2%E4%B8%8E%E9%AA%8C%E8%AF%81%E6%8A%A5%E5%91%8A-2026-09-23.md)
+- 旗舰论文归档：[docs/papers/](docs/papers/) — 46 篇 × 三语言（zh / zhen / en）共 138 篇 PDF，含 P0d 群体智能旗舰。

package/index.d.ts

@@ -1,209 +1,6 @@
-// Type definitions for @twinsearth/agent-universe
+/**
+ * Agent Universe - 智能体宇宙
+ * 群众化的 AGI 路线，去中心化的智能体共享 & 开源网络
+ */
 
-export const version: string;
-export const MIN_STAKE: number;
-
-export class Keypair {
-  publicKey: string;
-  privateKey: string;
-  did: string;
-  static generate(): Keypair;
-  sign(message: string | Buffer): string;
-  verify(message: string | Buffer, signatureHex: string): boolean;
-}
-
-export class AgentCard {
-  did: string;
-  name: string;
-  capabilities: string[];
-  skills: string[];
-  version: string;
-  stake: number;
-  reputation: number;
-  static new(opts: { did: string; name: string }): AgentCard;
-  withCapability(cap: string): this;
-  withSkill(skill: string): this;
-  hasCapability(cap: string): boolean;
-}
-
-export const TaskStatus: Record<string, string>;
-
-export class Task {
-  taskId: string;
-  goal: string;
-  status: string;
-  assignee: string | null;
-  history: string[];
-  constructor(taskId: string, goal: string);
-  assign(did: string): this;
-  start(): this;
-  complete(): this;
-  verify(passed: boolean): this;
-  settle(): this;
-  readonly isTerminal: boolean;
-}
-
-export class MemoryDHT {
-  put(key: string, value: unknown): void;
-  get(key: string): unknown;
-  has(key: string): boolean;
-  remove(key: string): boolean;
-  readonly size: number;
-}
-
-export class ShardedIndex {
-  constructor(numShards?: number);
-  put(key: string, value: unknown): number;
-  get(key: string): unknown;
-  has(key: string): boolean;
-  remove(key: string): boolean;
-  readonly size: number;
-  distribution(): number[];
-}
-
-export function shardOf(key: string, numShards: number): number;
-
-export class Bid {
-  agentId: string;
-  price: number;
-}
-
-export class Reputation {
-  quality: number;
-  speed: number;
-  honesty: number;
-  availability: number;
-  overall(): number;
-}
-
-export class AgentMarket {
-  agents: Map<string, unknown>;
-  tasks: Map<string, Task>;
-  deposit(account: string, amount: number): void;
-  balance(account: string): number;
-  registerAgent(card: AgentCard, stake: number): boolean;
-  publishTask(taskId: string, goal: string, budget: number, requester: string): Task;
-  submitBid(taskId: string, agentId: string, price: number): boolean;
-  matchTask(taskId: string): Bid;
-  completeTask(taskId: string, passed?: boolean): Task;
-  settle(taskId: string): { paid: number; reason: string };
-  slash(agentId: string, amount: number, reason: string): unknown;
-  discoverBySkill(skill: string): AgentCard[];
-  leaderboard(limit?: number): unknown[];
-  conservationCheck(totalDeposits: number): {
-    conserved: boolean;
-    balanceSum: number;
-    totalSlashed: number;
-    expected: number;
-  };
-}
-
-export class AgentUniverse {
-  identity: Keypair;
-  dht: MemoryDHT;
-  market: AgentMarket;
-  readonly did: string;
-  register(card: AgentCard): AgentCard;
-  discover(capability: string): AgentCard[];
-}
-
-// ── MCP ──
-export const MCP_PROTOCOL_VERSION: string;
-
-export class McpError extends Error {
-  code: number;
-}
-
-export class McpHttpClient {
-  initialized: boolean;
-  constructor(baseUrl?: string, path?: string, timeout?: number);
-  initialize(): Promise<{
-    protocolVersion: string;
-    serverInfo: { name: string; version: string };
-  }>;
-  ping(): Promise<boolean>;
-  listTools(): Promise<
-    Array<{
-      name: string;
-      description?: string;
-      inputSchema: Record<string, unknown>;
-    }>
-  >;
-  callTool(
-    name: string,
-    args?: Record<string, unknown>
-  ): Promise<{ content: Array<{ type: string; text: string }>; isError?: boolean }>;
-}
-
-// ── ACA ──
-export class AipIdentity {
-  did: string;
-  readonly publicKey: Buffer;
-  static generate(): AipIdentity;
-  static fromSeed(seed: Buffer | Uint8Array): AipIdentity;
-  signObject(obj: Record<string, unknown>): string;
-  signInto(obj: Record<string, unknown>): Record<string, unknown>;
-  static verifyObject(obj: Record<string, unknown>, rawPub: Buffer): boolean;
-}
-
-export function buildManifest(
-  identity: AipIdentity,
-  name: string,
-  capabilities: string[],
-  opts?: Record<string, unknown>
-): Record<string, unknown>;
-
-export function buildEnvelope(
-  requesterDid: string,
-  capability: string,
-  outputSpec: string,
-  opts?: Record<string, unknown>
-): Record<string, unknown>;
-
-export function buildMessage(
-  identity: AipIdentity,
-  msgType: string,
-  toDid: string,
-  payload: unknown
-): Record<string, unknown>;
-
-export function buildReceipt(
-  identity: AipIdentity,
-  taskId: string,
-  result: Buffer,
-  opts?: Record<string, unknown>
-): Record<string, unknown>;
-
-export function handshakeMessage(
-  identity: AipIdentity,
-  manifest: Record<string, unknown>
-): Record<string, unknown>;
-
-export function proposalMessage(
-  identity: AipIdentity,
-  toDid: string,
-  envelope: Record<string, unknown>
-): Record<string, unknown>;
-
-export function receiptMessage(
-  identity: AipIdentity,
-  toDid: string,
-  receipt: Record<string, unknown>
-): Record<string, unknown>;
-
-export function verifyManifest(
-  manifest: Record<string, unknown>,
-  rawPub: Buffer
-): boolean;
-export function verifyMessage(
-  message: Record<string, unknown>,
-  rawPub: Buffer
-): boolean;
-export function verifyReceipt(
-  receipt: Record<string, unknown>,
-  rawPub: Buffer
-): boolean;
-export function verifyReceiptResult(
-  receipt: Record<string, unknown>,
-  result: Buffer
-): boolean;
+export * from './js/index';