@sleep2agi/agent-network 2.0.0-preview.6 → 2.0.0-preview.61

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 +215 -73
  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 +9 -7
package/README.md CHANGED
@@ -1,113 +1,255 @@
1
- # @sleep2agi/agent-network
1
+ # @sleep2agi/agent-network (anet)
2
2
 
3
- AI Agent 通信网络 — CLI + SDK + Channel，一个包搞定。
3
+ AI Agent 通信网络 — 一行命令创建 Agent，多 Agent 协作通信。
4
+
5
+ ## 架构
6
+
7
+ ```
8
+ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
9
+ │ Agent Node │ │ Agent Node │ │ Agent Node │
10
+ │ (codex) │ │ (minimax) │ │ (claude) │
11
+ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘
12
+ │ SSE │ SSE │ MCP
13
+ └──────────┬───────┴──────────────────┘
14
+ ┌─────┴─────┐
15
+ │ CommHub │ ← MCP Server + REST API
16
+ │ Server │ 任务调度 + 消息路由
17
+ └───────────┘
18
+ ```
19
+
20
+ **三个包，三个角色：**
21
+
22
+ | 包 | 角色 | 安装位置 |
23
+ |---|------|---------|
24
+ | `@sleep2agi/commhub-server` | 通信中枢 (Server) | 服务器，只需 1 台 |
25
+ | `@sleep2agi/agent-network` | CLI 管理工具 (anet) | 每台开发机 |
26
+ | `@sleep2agi/agent-node` | Agent 运行时 | 每台开发机 |
27
+
28
+ ## 5 分钟快速上手
29
+
30
+ ### Step 1: 部署 CommHub Server（服务器端）
31
+
32
+ 在你的服务器上（需要 Bun）：
4
33
 
5
34
  ```bash
6
- npm install -g @sleep2agi/agent-network
7
- anet setup
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
8
44
  ```
9
45
 
10
- ## 快速开始
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: 安装 + 一键设置（开发机）
11
52
 
12
53
  ```bash
13
- # 1. 安装 + 交互式选装依赖
14
- npm install -g @sleep2agi/agent-network
15
- anet setup
54
+ npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
16
55
 
17
- # 2. 配置 CommHub
18
- anet init --hub http://YOUR_IP:9200
56
+ # 一键引导（推荐）
57
+ anet quickstart
19
58
 
20
- # 3. 创建 node（交互式）
21
- anet create
59
+ # 或手动配置
60
+ anet init --hub http://YOUR_SERVER_IP:9200
61
+ anet register # 创建账号
62
+ anet login # 登录
22
63
 
23
- # 4. 启动
24
- anet start 指挥室
64
+ # 检查一切正常
65
+ anet doctor
25
66
  ```
26
67
 
27
- ## 版本
68
+ ### Step 3: 创建并启动 Agent
28
69
 
29
70
  ```bash
30
- anet -v
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
31
79
  ```
80
+
81
+ ### Step 4: 发送任务
82
+
83
+ 在另一个终端或另一台机器上：
84
+
85
+ ```bash
86
+ # 查看网络状态
87
+ anet status
88
+
89
+ # 查看任务列表
90
+ anet tasks
91
+ ```
92
+
93
+ 通过 MCP 工具发送任务（Claude Code / Codex 会自动发现）：
32
94
  ```
33
- anet v1.3.1
34
- agent-node v1.1.0 (global)
35
- └ @anthropic-ai/claude-agent-sdk v0.2.98
36
- └ @openai/codex-sdk v0.118.0
37
- commhub-server not installed
38
- claude CLI v2.1.98
39
- codex CLI v0.118.0
95
+ commhub_send_task(alias="my-agent", task="帮我写个 hello world")
40
96
  ```
41
97
 
42
- ## Runtime
98
+ ## Runtime 选择
43
99
 
44
- | 名称 | 底层 | 说明 |
45
- |------|------|------|
46
- | `claude-code-cli` | Claude Code CLI | 需要 Pro 订阅 + claude auth login |
47
- | `codex-sdk` | Codex SDK + CLI | 需要 codex auth login |
48
- | `claude-agent-sdk` | Claude Agent SDK | 支持 MiniMax / 书生 / Claude |
100
+ | Runtime | 底层 | 需要 | 适用场景 |
101
+ |---------|------|------|---------|
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 等 |
49
105
 
50
- ## CLI 命令
106
+ ```bash
107
+ # Codex (GPT-5.4)
108
+ anet create dev --runtime codex-sdk
109
+
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 个)
51
117
 
52
118
  ```bash
53
- # 全局
54
- anet init # 配 hub URL + token
55
- anet setup # 交互式安装依赖
56
- anet upgrade # 一键升级所有包
57
- anet server start # 启动 CommHub Server
58
- anet -v # 版本诊断
119
+ # 账号
120
+ anet quickstart # 一键引导设置
121
+ anet register # 创建账号
122
+ anet login # 登录
123
+ anet logout # 退出
124
+ anet whoami # 当前用户信息
125
+ anet passwd # 修改密码
126
+
127
+ # 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 # 删除网络
139
+
140
+ # 节点
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 # 查看配置
154
+
155
+ # Channel
156
+ anet channel add telegram <name> --bot-token <tok> --allow <uid>
59
157
 
60
- # 项目
61
- anet create <node-name> # 创建 node（交互式）
62
- anet start <node-name> # 启动（自动 resume）
63
- anet start <node-name> --new-session # 强制新建
64
- anet resume <node-name> --session <id> # 导入已有 session
65
- anet channel add telegram <node-name> # 加 Telegram channel
66
- anet channel ls [node-name] # 查看 channel
67
- anet ls # 查看所有 node
68
- anet session ls # 查看 session
158
+ # 授权
159
+ anet license # 查看 License 状态
160
+ anet activate <key> # 激活授权码
161
+
162
+ # 设置
163
+ anet init # 配置 hub URL
164
+ anet setup # 安装依赖
165
+ anet server local # 本地零配置启动
166
+ anet server start # 启动 CommHub
167
+ anet upgrade # 检查更新
168
+ anet -v # 版本信息
69
169
  ```
70
170
 
71
- ## 配置
171
+ ## 配置文件
72
172
 
73
173
  ```
74
- ~/.anet/config.json # 全局 hub + token
75
- {workpath}/.anet/nodes/<name>/
76
- ├── config.json # node 配置
77
- └── channels/telegram/ # Telegram channel
78
- ├── .env # bot token
79
- ├── access.json # 白名单
80
- └── inbox/ # 图片/文件
174
+ ~/.anet/config.json # 全局: hub URL + token
175
+ {project}/.anet/nodes/<name>/
176
+ ├── config.json # 节点: runtime, model, node_id
177
+ └── channels/telegram/
178
+ ├── .env # bot token (chmod 600)
179
+ └── access.json # 白名单
81
180
  ```
82
181
 
83
- ## SDK
182
+ 配置优先级: CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值
183
+
184
+ ## Telegram Channel 接入
185
+
186
+ 让 Agent 自动接收 Telegram 消息并回复：
187
+
188
+ ```bash
189
+ # 1. 先创建 agent 节点
190
+ anet create my-bot --runtime http-api
191
+
192
+ # 2. 添加 Telegram channel
193
+ anet channel add telegram my-bot --bot-token 123456:ABC-xxx --allow 7612221352
194
+ # --bot-token: 从 @BotFather 获取
195
+ # --allow: 允许的 Telegram 用户 ID（白名单）
84
196
 
85
- ```typescript
86
- import { CommHub } from '@sleep2agi/agent-network';
197
+ # 3. 启动
198
+ anet start my-bot
199
+ # agent 会自动连 Telegram bot，收到消息后 AI 处理并回复
200
+ ```
87
201
 
88
- const hub = new CommHub({ url: 'http://YOUR_IP:9200', alias: '我的Agent' });
89
- hub.on('task', async (msg) => {
90
- await hub.send(msg.from_session, '完成！');
91
- });
202
+ 配置文件自动创建在：
203
+ ```
204
+ .anet/nodes/my-bot/channels/telegram/
205
+ ├── .env # BOT_TOKEN（chmod 600，安全存储）
206
+ └── access.json # {"allow": ["7612221352"]}
92
207
  ```
93
208
 
94
- ## npm 包
209
+ ## REST API (27 endpoints)
210
+
211
+ | 端点 | 说明 |
212
+ |------|------|
213
+ | `POST /api/auth/register` | 注册 |
214
+ | `POST /api/auth/login` | 登录 |
215
+ | `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
+ | `GET /api/networks` | 网络列表 |
222
+ | `POST /api/networks` | 创建网络 |
223
+ | `GET /api/networks/:id` | 网络详情 |
224
+ | `PUT /api/networks/:id` | 重命名网络 |
225
+ | `DELETE /api/networks/:id` | 删除网络 |
226
+ | `GET /api/tasks` | 任务列表 (支持 network_id 过滤) |
227
+ | `GET /api/stats` | 统计汇总 |
228
+ | `GET /api/audit-log` | 审计日志 |
229
+ | `GET /api/license` | License 状态 |
95
230
 
96
- | 包 | 版本 | 说明 |
97
- |---|------|------|
98
- | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | v1.3.1 | anet CLI + CommHub SDK |
99
- | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | v1.1.0 | Agent 运行时 |
100
- | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | v0.4.3 | CommHub Server |
231
+ 所有数据端点支持 `?network_id=` 过滤。认证: `Authorization: Bearer <token>`。
101
232
 
102
233
  ## 文档
103
234
 
104
- - [CLI 重构方案](docs/cli-refactor-proposal.md)
105
- - [依赖管理方案](docs/dependency-management.md)
106
- - [测试计划](docs/test-plan.md)
107
- - [踩坑经验](docs/pitfalls.md)
108
- - [架构设计](docs/architecture.md)
109
- - [CommHub Review](docs/commhub-review.md)
110
- - [重启策略](docs/restart-strategy.md)
235
+ - [Getting Started Guide](docs/getting-started.md) — 新手教程
236
+ - [CHANGELOG](CHANGELOG.md) — 版本变更
237
+ - [V3 设计](docs/v3-multi-network-design.md) — 架构设计
238
+ - [测试矩阵](tests/README.md) — 25 套 550+ Docker 测试
239
+ - [Examples](examples/README.md) — Demo 场景
240
+
241
+ ## npm 包
242
+
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 |
248
+
249
+ ```bash
250
+ # 安装 preview 版
251
+ npm i -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview
252
+ ```
111
253
 
112
254
  ## License
113
255