@sleep2agi/agent-network 2.0.0 → 2.0.1-preview.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +79 -152
  2. package/dist/bin/cli.js +1 -1
  3. package/dist/src/client.js +1 -1
  4. package/dist/src/node-server.js +1 -1
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  AI Agent 通信网络 — 一行命令创建 Agent，多 Agent 协作通信。
4
4
 
5
+ **v2.0.0 stable** — 推荐普通用户直接 `npm install -g @sleep2agi/agent-network` 上手。
6
+
5
7
  ## 架构
6
8
 
7
9
  ```
@@ -19,155 +21,106 @@ AI Agent 通信网络 — 一行命令创建 Agent，多 Agent 协作通信。
19
21
 
20
22
  **三个包，三个角色：**
21
23
 
22
- | 包 | 角色 | 安装位置 |
23
- |---|------|---------|
24
- | `@sleep2agi/commhub-server` | 通信中枢 (Server) | 服务器，只需 1 台 |
25
- | `@sleep2agi/agent-network` | CLI 管理工具 (anet) | 每台开发机 |
26
- | `@sleep2agi/agent-node` | Agent 运行时 | 每台开发机 |
24
+ | 包 | 版本 | 角色 |
25
+ |---|------|------|
26
+ | `@sleep2agi/commhub-server` | 0.5.0 | 通信中枢 (Server) |
27
+ | `@sleep2agi/agent-network-dashboard` | 0.1.0 | Web Dashboard |
28
+ | `@sleep2agi/agent-network` | 2.0.0 | CLI 管理工具 (anet) |
29
+ | `@sleep2agi/agent-node` | 2.1.1 | Agent 运行时 |
27
30
 
28
31
  ## 5 分钟快速上手
29
32
 
30
- ### Step 1: 部署 CommHub Server（服务器端）
31
-
32
- 在你的服务器上（需要 Bun）：
33
-
34
- ```bash
35
- # 安装 Bun (如果没有)
36
- curl -fsSL https://bun.sh/install | bash
37
-
38
- # 启动 CommHub Server (默认 SQLite, 零配置)
39
- bunx @sleep2agi/commhub-server
40
- # 默认端口 9200, 访问 http://YOUR_IP:9200/health 验证
41
-
42
- # 或使用 PostgreSQL
43
- DATABASE_URL=postgres://user:pass@host:5432/commhub bunx @sleep2agi/commhub-server
44
- ```
45
-
46
- Server 启动后会显示：
47
- - MCP 端点: `http://0.0.0.0:9200/mcp`
48
- - REST API: `http://0.0.0.0:9200/api`
49
- - 健康检查: `http://0.0.0.0:9200/health`
50
-
51
- ### Step 2: 安装 + 一键设置（开发机）
33
+ 完整流程（local-only，零云依赖）：
52
34
 
53
35
  ```bash
54
- npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
36
+ # 1) 安装 CLI（自带 hub + dashboard 启动器）
37
+ npm install -g @sleep2agi/agent-network
55
38
 
56
- # 一键引导（推荐）
57
- anet quickstart
39
+ # 2) 启动本地 CommHub（默认端口 9200，SQLite 在 ~/.commhub/commhub.db）
40
+ anet hub start
58
41
 
59
- # 或手动配置
60
- anet init --hub http://YOUR_SERVER_IP:9200
61
- anet register # 创建账号
62
- anet login # 登录
42
+ # 3) 另开终端，启动 Dashboard（自动连本地 hub）
43
+ anet hub dashboard
44
+ # → 浏览器打开 http://localhost:3000
63
45
 
64
- # 检查一切正常
65
- anet doctor
66
- ```
46
+ # 4) 登录（默认账号 admin / anethub，首次 hub start 自动创建）
47
+ anet login
67
48
 
68
- ### Step 3: 创建并启动 Agent
49
+ # 5) 创建一个 Agent 节点（交互式选 Runtime + 模型）
50
+ anet node create alice
69
51
 
70
- ```bash
71
- # 交互式创建（会问你选哪个 Runtime / Model）
72
- anet create my-agent
73
-
74
- # 或直接指定
75
- anet create my-agent --runtime codex-sdk --model gpt-5.4
76
-
77
- # 启动
78
- anet start my-agent
52
+ # 6) 启动它
53
+ anet node start alice
79
54
  ```
80
55
 
81
- ### Step 4: 发送任务
56
+ `anet node create` 会让你两步选择：先选 Runtime（claude-agent-sdk / codex-sdk / claude-code-cli），再选 Provider（Anthropic / DeepSeek / GLM / Kimi / MiniMax / OpenRouter / 自定义）。
82
57
 
83
- 在另一个终端或另一台机器上：
58
+ ### 多 Agent 协作示例
84
59
 
85
60
  ```bash
86
- # 查看网络状态
87
- anet status
61
+ # 终端 A
62
+ anet node create alice
63
+ anet node start alice
88
64
 
89
- # 查看任务列表
90
- anet tasks
65
+ # 终端 B
66
+ anet node create bob
67
+ anet node start bob
91
68
  ```
92
69
 
93
- 通过 MCP 工具发送任务（Claude Code / Codex 会自动发现）：
94
- ```
95
- commhub_send_task(alias="my-agent", task="帮我写个 hello world")
96
- ```
70
+ Agent 会自动通过 commhub MCP 工具发现彼此（`get_all_status`），并用 `send_task` 互相派活。Dashboard 的 `Tasks` / `Messages` 页面实时看到所有交互。
97
71
 
98
72
  ## Runtime 选择
99
73
 
100
74
  | Runtime | 底层 | 需要 | 适用场景 |
101
75
  |---------|------|------|---------|
102
- | `codex-sdk` | GPT-5.4 via Codex | `codex auth login` | 代码任务 |
103
- | `claude-agent-sdk` | Claude Code | Claude Pro + `claude auth login` | 通用任务 |
104
- | `http-api` | 任何 OpenAI/Anthropic 兼容 API | API Key | MiniMax, DeepSeek 等 |
105
-
106
- ```bash
107
- # Codex (GPT-5.4)
108
- anet create dev --runtime codex-sdk
76
+ | `claude-agent-sdk` | Anthropic Messages API | API Key（Anthropic / DeepSeek / GLM / Kimi / MiniMax / OpenRouter / 自定义） | 通用任务，最广兼容 |
77
+ | `codex-sdk` | OpenAI GPT-5 / o3 | `codex auth login` | 代码任务，强推理 |
78
+ | `claude-code-cli` | 本地 Claude Code | Claude Pro 订阅 | 复用 Pro 订阅 |
109
79
 
110
- # MiniMax (通过 Anthropic 兼容 API)
111
- ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
112
- ANTHROPIC_API_KEY=sk-cp-xxx \
113
- agent-node --alias dev --runtime http-api --model claude-3-5-haiku-20241022
114
- ```
115
-
116
- ## CLI 命令 (39 个)
80
+ ## CLI 命令
117
81
 
118
82
  ```bash
83
+ # Hub
84
+ anet hub start # 本地启动 CommHub Server
85
+ anet hub stop # 停止
86
+ anet hub dashboard # 启动 Dashboard Web UI
87
+
119
88
  # 账号
120
- anet quickstart # 一键引导设置
121
- anet register # 创建账号
122
- anet login # 登录
123
- anet logout # 退出
124
- anet whoami # 当前用户信息
125
- anet passwd # 修改密码
89
+ anet register # 创建账号
90
+ anet login # 登录
91
+ anet logout # 退出
92
+ anet whoami # 当前用户
126
93
 
127
94
  # Token
128
- anet token create <name> # 创建 API Token
129
- anet token ls # Token 列表
130
- anet token revoke <id> # 撤销 Token
131
-
132
- # 网络
133
- anet network create <name> # 创建网络
134
- anet network ls # 我的网络列表
135
- anet network use <name> # 切换网络
136
- anet network info # 当前网络详情
137
- anet network rename <new> # 重命名网络
138
- anet network delete --force # 删除网络
95
+ anet token create <name> # 创建 API Token
96
+ anet token ls # Token 列表
97
+ anet token revoke <id> # 撤销
139
98
 
140
99
  # 节点
141
- anet create <name> # 创建 node（交互式）
142
- anet start <name> # 启动
143
- anet stop <name> # 停止
144
- anet delete <name> --force # 删除
145
- anet rename <ref> <new> # 重命名
146
- anet ls # 节点列表 + 网络状态
147
- anet status # 网络总览
148
- anet info <name> # 节点详情
149
- anet tasks [status] # 任务列表
150
- anet logs <name> # 查看日志
151
- anet doctor # 系统诊断
152
- anet demo # 实时仪表盘
153
- anet config # 查看配置
100
+ anet node create <name> # 创建 node（两步交互式选 Runtime + Provider）
101
+ anet node start <name> # 启动
102
+ anet node stop <name> # 停止
103
+ anet node delete <name> # 删除
104
+ anet node ls # 节点列表
105
+
106
+ # 状态
107
+ anet status # 网络总览
108
+ anet ls # 节点 + 网络状态
109
+ anet tasks [status] # 任务列表
110
+ anet logs <name> # 查看日志
111
+ anet doctor # 系统诊断
154
112
 
155
113
  # Channel
156
114
  anet channel add telegram <name> --bot-token <tok> --allow <uid>
157
115
 
158
- # 授权
159
- anet license # 查看 License 状态
160
- anet activate <key> # 激活授权码
161
-
162
116
  # 设置
163
- anet init # 配置 hub URL
164
- anet setup # 安装依赖
165
- anet server local # 本地零配置启动
166
- anet server start # 启动 CommHub
167
- anet upgrade # 检查更新
168
- anet -v # 版本信息
117
+ anet init # 配置 hub URL
118
+ anet -v # 版本信息
169
119
  ```
170
120
 
121
+ > `anet quickstart` 命令存在但流程仍在打磨（experimental）— 请使用上面的显式步骤。
122
+ > `anet license` / `anet activate` 是 placeholder（云授权暂未启用），local-only 用法不需要。
123
+
171
124
  ## 配置文件
172
125
 
173
126
  ```
@@ -186,69 +139,43 @@ anet -v # 版本信息
186
139
  让 Agent 自动接收 Telegram 消息并回复：
187
140
 
188
141
  ```bash
189
- # 1. 先创建 agent 节点
190
- anet create my-bot --runtime http-api
191
-
192
- # 2. 添加 Telegram channel
142
+ anet node create my-bot
193
143
  anet channel add telegram my-bot --bot-token 123456:ABC-xxx --allow 7612221352
194
- # --bot-token: 从 @BotFather 获取
195
- # --allow: 允许的 Telegram 用户 ID（白名单）
196
-
197
- # 3. 启动
198
- anet start my-bot
199
- # agent 会自动连 Telegram bot，收到消息后 AI 处理并回复
200
- ```
201
-
202
- 配置文件自动创建在：
203
- ```
204
- .anet/nodes/my-bot/channels/telegram/
205
- ├── .env # BOT_TOKEN（chmod 600，安全存储）
206
- └── access.json # {"allow": ["7612221352"]}
144
+ anet node start my-bot
207
145
  ```
208
146
 
209
- ## REST API (27 endpoints)
147
+ ## REST API（部分）
210
148
 
211
149
  | 端点 | 说明 |
212
150
  |------|------|
213
151
  | `POST /api/auth/register` | 注册 |
214
152
  | `POST /api/auth/login` | 登录 |
215
153
  | `GET /api/auth/me` | 当前用户 |
216
- | `PUT /api/auth/me` | 修改资料 |
217
- | `POST /api/auth/password` | 修改密码 |
218
- | `GET /api/auth/tokens` | Token 列表 |
219
- | `POST /api/auth/tokens` | 创建 Token |
220
- | `DELETE /api/auth/tokens/:id` | 撤销 Token |
221
154
  | `GET /api/networks` | 网络列表 |
222
155
  | `POST /api/networks` | 创建网络 |
223
- | `GET /api/networks/:id` | 网络详情 |
224
- | `PUT /api/networks/:id` | 重命名网络 |
225
- | `DELETE /api/networks/:id` | 删除网络 |
226
- | `GET /api/tasks` | 任务列表 (支持 network_id 过滤) |
156
+ | `GET /api/tasks` | 任务列表 |
227
157
  | `GET /api/stats` | 统计汇总 |
228
158
  | `GET /api/audit-log` | 审计日志 |
229
- | `GET /api/license` | License 状态 |
230
159
 
231
- 所有数据端点支持 `?network_id=` 过滤。认证: `Authorization: Bearer <token>`。
160
+ 认证: `Authorization: Bearer <token>` 或 cookie。
232
161
 
233
162
  ## 文档
234
163
 
235
- - [Getting Started Guide](docs/getting-started.md) — 新手教程
236
164
  - [CHANGELOG](CHANGELOG.md) — 版本变更
237
- - [V3 设计](docs/v3-multi-network-design.md) — 架构设计
238
- - [测试矩阵](tests/README.md) — 25 套 550+ Docker 测试
239
- - [Examples](examples/README.md) — Demo 场景
165
+ - [docs/](docs/) — 设计文档与指南
166
+ - [tests/](tests/) — Docker 测试矩阵
240
167
 
241
- ## npm 包
168
+ ## npm 包（已发布稳定版）
242
169
 
243
- | 包 | 最新 Preview | 说明 |
244
- |---|-------------|------|
245
- | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.28 | anet CLI + SDK |
246
- | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.8 | Agent 运行时 |
247
- | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.28 | CommHub Server |
170
+ | 包 | latest | 说明 |
171
+ |---|--------|------|
172
+ | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0 | anet CLI |
173
+ | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.1 | Agent 运行时 |
174
+ | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0 | CommHub Server |
175
+ | [@sleep2agi/agent-network-dashboard](https://www.npmjs.com/package/@sleep2agi/agent-network-dashboard) | 0.1.0 | Web Dashboard |
248
176
 
249
177
  ```bash
250
- # 安装 preview 版
251
- npm i -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview
178
+ npm install -g @sleep2agi/agent-network
252
179
  ```
253
180
 
254
181
  ## License