@sleep2agi/agent-network 2.0.0-preview.9 → 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 +102 -96
  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 +10 -8
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,119 +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
+ 完整流程（local-only，零云依赖）：
33
34
 
34
35
  ```bash
35
- # 安装 Bun (如果没有)
36
- curl -fsSL https://bun.sh/install | bash
36
+ # 1) 安装 CLI（自带 hub + dashboard 启动器）
37
+ npm install -g @sleep2agi/agent-network
37
38
 
38
- # 启动 CommHub Server
39
- bunx @sleep2agi/commhub-server
40
- # 默认端口 9200, 访问 http://YOUR_IP:9200/health 验证
41
- ```
39
+ # 2) 启动本地 CommHub（默认端口 9200，SQLite 在 ~/.commhub/commhub.db）
40
+ anet hub start
42
41
 
43
- Server 启动后会显示：
44
- - MCP 端点: `http://0.0.0.0:9200/mcp`
45
- - REST API: `http://0.0.0.0:9200/api`
46
- - 健康检查: `http://0.0.0.0:9200/health`
42
+ # 3) 另开终端，启动 Dashboard（自动连本地 hub）
43
+ anet hub dashboard
44
+ # → 浏览器打开 http://localhost:3000
47
45
 
48
- ### Step 2: 安装 CLI 工具（开发机）
46
+ # 4) 登录（默认账号 admin / anethub，首次 hub start 自动创建）
47
+ anet login
49
48
 
50
- 在每台要跑 Agent 的机器上：
49
+ # 5) 创建一个 Agent 节点（交互式选 Runtime + 模型）
50
+ anet node create alice
51
51
 
52
- ```bash
53
- npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
54
-
55
- # 配置 CommHub 地址
56
- anet init --hub http://YOUR_SERVER_IP:9200
57
-
58
- # 检查一切正常
59
- anet doctor
52
+ # 6) 启动它
53
+ anet node start alice
60
54
  ```
61
55
 
62
- ### Step 3: 创建并启动 Agent
56
+ `anet node create` 会让你两步选择：先选 Runtime（claude-agent-sdk / codex-sdk / claude-code-cli），再选 Provider（Anthropic / DeepSeek / GLM / Kimi / MiniMax / OpenRouter / 自定义）。
63
57
 
64
- ```bash
65
- # 交互式创建（会问你选哪个 Runtime / Model）
66
- anet create my-agent
67
-
68
- # 或直接指定
69
- anet create my-agent --runtime codex-sdk --model gpt-5.4
70
-
71
- # 启动
72
- anet start my-agent
73
- ```
74
-
75
- ### Step 4: 发送任务
76
-
77
- 在另一个终端或另一台机器上：
58
+ ### 多 Agent 协作示例
78
59
 
79
60
  ```bash
80
- # 查看网络状态
81
- anet status
61
+ # 终端 A
62
+ anet node create alice
63
+ anet node start alice
82
64
 
83
- # 查看任务列表
84
- anet tasks
65
+ # 终端 B
66
+ anet node create bob
67
+ anet node start bob
85
68
  ```
86
69
 
87
- 通过 MCP 工具发送任务（Claude Code / Codex 会自动发现）：
88
- ```
89
- commhub_send_task(alias="my-agent", task="帮我写个 hello world")
90
- ```
70
+ Agent 会自动通过 commhub MCP 工具发现彼此（`get_all_status`），并用 `send_task` 互相派活。Dashboard 的 `Tasks` / `Messages` 页面实时看到所有交互。
91
71
 
92
72
  ## Runtime 选择
93
73
 
94
74
  | Runtime | 底层 | 需要 | 适用场景 |
95
75
  |---------|------|------|---------|
96
- | `codex-sdk` | GPT-5.4 via Codex | `codex auth login` | 代码任务 |
97
- | `claude-agent-sdk` | Claude Code | Claude Pro + `claude auth login` | 通用任务 |
98
- | `http-api` | 任何 OpenAI/Anthropic 兼容 API | API Key | MiniMax, DeepSeek 等 |
99
-
100
- ```bash
101
- # Codex (GPT-5.4)
102
- anet create dev --runtime codex-sdk
103
-
104
- # MiniMax (通过 Anthropic 兼容 API)
105
- ANTHROPIC_BASE_URL=https://api.minimaxi.com/anthropic \
106
- ANTHROPIC_API_KEY=sk-cp-xxx \
107
- agent-node --alias dev --runtime http-api --model claude-3-5-haiku-20241022
108
- ```
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
80
  ## CLI 命令
111
81
 
112
82
  ```bash
113
- # 节点管理
114
- anet create <name> # 创建 node（交互式）
115
- anet start <name> # 启动
116
- anet stop <name> # 停止
117
- anet delete <name> --force # 删除
118
- anet rename <ref> <new> # 重命名
119
- anet ls # 节点列表 + 网络状态
120
- anet status # 网络总览
121
- anet tasks [status] # 任务列表
122
- anet doctor # 系统诊断
83
+ # Hub
84
+ anet hub start # 本地启动 CommHub Server
85
+ anet hub stop # 停止
86
+ anet hub dashboard # 启动 Dashboard Web UI
87
+
88
+ # 账号
89
+ anet register # 创建账号
90
+ anet login # 登录
91
+ anet logout # 退出
92
+ anet whoami # 当前用户
93
+
94
+ # Token
95
+ anet token create <name> # 创建 API Token
96
+ anet token ls # Token 列表
97
+ anet token revoke <id> # 撤销
98
+
99
+ # 节点
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 # 系统诊断
123
112
 
124
113
  # Channel
125
114
  anet channel add telegram <name> --bot-token <tok> --allow <uid>
126
115
 
127
116
  # 设置
128
- anet init # 配置 hub URL
129
- anet setup # 安装依赖
130
- anet server start # 启动 CommHub
131
- anet upgrade # 检查更新
132
- anet -v # 版本信息
117
+ anet init # 配置 hub URL
118
+ anet -v # 版本信息
133
119
  ```
134
120
 
121
+ > `anet quickstart` 命令存在但流程仍在打磨（experimental）— 请使用上面的显式步骤。
122
+ > `anet license` / `anet activate` 是 placeholder（云授权暂未启用），local-only 用法不需要。
123
+
135
124
  ## 配置文件
136
125
 
137
126
  ```
@@ -145,31 +134,48 @@ anet -v # 版本信息
145
134
 
146
135
  配置优先级: CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值
147
136
 
148
- ## REST API
137
+ ## Telegram Channel 接入
138
+
139
+ 让 Agent 自动接收 Telegram 消息并回复：
140
+
141
+ ```bash
142
+ anet node create my-bot
143
+ anet channel add telegram my-bot --bot-token 123456:ABC-xxx --allow 7612221352
144
+ anet node start my-bot
145
+ ```
146
+
147
+ ## REST API（部分）
149
148
 
150
149
  | 端点 | 说明 |
151
150
  |------|------|
152
- | `GET /health` | 健康检查 (无需 auth) |
153
- | `GET /api/status` | 所有 session |
154
- | `GET /api/tasks?status=&from_name=&to_name=&limit=` | 任务列表 |
155
- | `GET /api/nodes?node_id=&alias=` | 节点信息 |
156
- | `GET /api/task_events?task_id=` | 任务审计日志 |
157
- | `GET /api/messages?limit=&since=` | 消息列表 |
158
- | `POST /mcp` | MCP Streamable HTTP |
151
+ | `POST /api/auth/register` | 注册 |
152
+ | `POST /api/auth/login` | 登录 |
153
+ | `GET /api/auth/me` | 当前用户 |
154
+ | `GET /api/networks` | 网络列表 |
155
+ | `POST /api/networks` | 创建网络 |
156
+ | `GET /api/tasks` | 任务列表 |
157
+ | `GET /api/stats` | 统计汇总 |
158
+ | `GET /api/audit-log` | 审计日志 |
159
+
160
+ 认证: `Authorization: Bearer <token>` 或 cookie。
161
+
162
+ ## 文档
159
163
 
160
- 设置 `COMMHUB_AUTH_TOKEN` 环境变量启用 Bearer token 鉴权。
164
+ - [CHANGELOG](CHANGELOG.md) — 版本变更
165
+ - [docs/](docs/) — 设计文档与指南
166
+ - [tests/](tests/) — Docker 测试矩阵
161
167
 
162
- ## npm 包
168
+ ## npm 包（已发布稳定版）
163
169
 
164
- | 包 | 最新 Preview | 说明 |
165
- |---|-------------|------|
166
- | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.6 | anet CLI + SDK |
167
- | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.3 | Agent 运行时 |
168
- | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.6 | 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 |
169
176
 
170
177
  ```bash
171
- # 安装 preview 版
172
- npm i -g @sleep2agi/agent-network@preview @sleep2agi/agent-node@preview
178
+ npm install -g @sleep2agi/agent-network
173
179
  ```
174
180
 
175
181
  ## License