@sleep2agi/agent-network 1.3.0 → 1.3.2

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 +63 -146
  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
@@ -1,162 +1,85 @@
1
1
  # @sleep2agi/agent-network
2
2
 
3
- AI Agent 通信网络 — CLI + SDK + Channel 插件，一个包搞定。
3
+ AI Agent 通信网络 — CLI + SDK + Channel，一个包搞定。
4
4
 
5
- ```
5
+ ```bash
6
6
  npm install -g @sleep2agi/agent-network
7
+ anet setup
7
8
  ```
8
9
 
9
- 当前版本：v0.0.48 | [agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) v0.7.0 | [commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) v0.4.3
10
-
11
10
  ## 快速开始
12
11
 
13
12
  ```bash
14
- # 1. 启动通信服务器（首次自动生成 auth token）
15
- anet server start --port 9200
13
+ # 1. 安装 + 交互式选装依赖
14
+ npm install -g @sleep2agi/agent-network
15
+ anet setup
16
16
 
17
- # 2. 配置（交互式，填 hub URL 和 token）
18
- anet init
17
+ # 2. 配置 CommHub
18
+ anet init --hub http://YOUR_IP:9200
19
19
 
20
- # 3. 启动 Claude Code Agent
21
- cd ~/your-project
22
- anet init project
23
- anet start 指挥室
20
+ # 3. 创建 node（交互式）
21
+ anet create
24
22
 
25
- # 4. 快速接入已有 session（无需 init profile）
26
- anet resume 你的Agent --session <session-id>
27
-
28
- # 5. 查看状态
29
- anet ls
30
- anet session ls # 列出当前项目的 Claude Code session
31
- anet -v # 查看版本
23
+ # 4. 启动
24
+ anet start 指挥室
32
25
  ```
33
26
 
34
- ## CLI 命令
35
-
36
- | 命令 | 说明 |
37
- |------|------|
38
- | `anet init` | 配 hub URL + token（全局，交互式） |
39
- | `anet init project` | 配当前项目（channel 插件 + .mcp.json + CLAUDE.md） |
40
- | `anet init profile <id>` | 创建 node 启动配置 |
41
- | `anet start <id>` | 新建 session |
42
- | `anet resume <id>` | 恢复 session |
43
- | `anet resume <id> --session <sid>` | 快速接入已有 session（自动创建配置） |
44
- | `anet session ls` | 列出当前项目的 session（ID / 大小 / 时间） |
45
- | `anet ls` | nodes + sessions + 网络状态 |
46
- | `anet server start` | 启动 CommHub Server |
47
- | `anet server config` | 查看/设置 server 配置 |
48
- | `anet import` | 从 CommHub 导入在线 session |
49
- | `anet -v` | 查看版本 |
50
-
51
- ## 配置体系
52
-
53
- ### 全局配置
27
+ ## 版本
54
28
 
29
+ ```bash
30
+ anet -v
55
31
  ```
56
- ~/.anet/config.json # hub URL + token（anet init 写入）
57
- ~/.anet/server/config.json # server 配置（port/host/token）
58
- ```
59
-
60
- ### 项目配置
61
-
62
32
  ```
63
- {project}/
64
- ├── .mcp.json # commhub MCP server
65
- └── .anet/
66
- ├── node-server.ts # channel 插件（自动从 npm 包同步）
67
- ├── package.json
68
- └── nodes/
69
- └── 指挥室/
70
- └── config.json # 启动配置
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
71
40
  ```
72
41
 
73
- ### 配置继承规则
74
-
75
- 两个 config.json 都会读，**字段级合并**：
76
-
77
- ```
78
- 项目 .anet/nodes/<id>/config.json 有值的字段优先
79
- ↓ fallback
80
- 全局 ~/.anet/config.json 缺失字段兜底
81
- ```
42
+ ## Runtime
82
43
 
83
- 项目 config 不需要写 token/hub，全局配一份所有项目共用。
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 |
84
49
 
85
- ### Node 配置示例
86
-
87
- 路径：`.anet/nodes/<id>/config.json`
88
-
89
- **Claude Code：**
90
- ```json
91
- {
92
- "runtime": "claude-code",
93
- "alias": "指挥室",
94
- "hub": "http://YOUR_IP:9200",
95
- "channels": ["server:commhub"],
96
- "env": {},
97
- "flags": { "dangerouslySkipPermissions": true, "teammateMode": "in-process" },
98
- "resume": "98039093-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
99
- }
100
- ```
101
-
102
- **MiniMax（agent-sdk）：**
103
- ```json
104
- {
105
- "runtime": "agent-sdk",
106
- "alias": "小明",
107
- "hub": "http://YOUR_IP:9200",
108
- "model": "MiniMax-M2.7",
109
- "tools": ["Read", "Bash", "Grep"],
110
- "env": {
111
- "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
112
- "ANTHROPIC_AUTH_TOKEN": "your-key"
113
- }
114
- }
115
- ```
116
-
117
- ## Token 认证
50
+ ## CLI 命令
118
51
 
119
52
  ```bash
120
- # 方式 1：anet init 交互式填写
121
- anet init
122
-
123
- # 方式 2：命令行参数
124
- anet init --hub http://YOUR_IP:9200 --token your-secret
125
-
126
- # 方式 3：server 首次启动自动生成
127
- anet server start
128
- # → Generated auth token: xxxx（自动存到全局 + server config）
53
+ # 全局
54
+ anet init # 配 hub URL + token
55
+ anet setup # 交互式安装依赖
56
+ anet upgrade # 一键升级所有包
57
+ anet server start # 启动 CommHub Server
58
+ anet -v # 版本诊断
59
+
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
129
69
  ```
130
70
 
131
- Token 流转：
71
+ ## 配置
132
72
 
133
73
  ```
134
- ~/.anet/config.json (token)
135
- ↓ 自动传递
136
- ├→ anet start/resume → COMMHUB_TOKEN env → channel 插件
137
- ├→ anet ls/import → Authorization header → CommHub API
138
- └→ channel 插件启动时也会直接读 ~/.anet/config.json
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/ # 图片/文件
139
81
  ```
140
82
 
141
- node config 可以单独配 token（覆盖全局），适用于连不同 CommHub 的场景。
142
-
143
- ## 自动配置行为
144
-
145
- `anet start`/`anet resume` 对 `runtime: "claude-code"` 自动确保：
146
-
147
- 1. `.anet/node-server.ts` 从 npm 包同步（对比内容，不同才更新）
148
- 2. `.anet/package.json` + 依赖安装
149
- 3. `.mcp.json` 包含 commhub（**已有配置不覆盖**）
150
-
151
- ## 支持的模型
152
-
153
- | 模型 | ANTHROPIC_BASE_URL | runtime |
154
- |------|-------------------|---------|
155
- | Claude | 不设 | claude-code |
156
- | MiniMax M2.7 | `https://api.minimaxi.com/anthropic` | agent-sdk |
157
- | 书生 Intern-S1-Pro | `https://chat.intern-ai.org.cn` | agent-sdk |
158
- | 任意 Anthropic 兼容 | 对应端点 | agent-sdk |
159
-
160
83
  ## SDK
161
84
 
162
85
  ```typescript
@@ -168,29 +91,23 @@ hub.on('task', async (msg) => {
168
91
  });
169
92
  ```
170
93
 
171
- | 方法 | 说明 |
172
- |------|------|
173
- | `hub.send(alias, content)` | 发任务 |
174
- | `hub.message(alias, content)` | 发消息 |
175
- | `hub.reply(taskId, text, status?)` | 回复任务 |
176
- | `hub.status(state, extra?)` | 更新状态 |
177
- | `hub.broadcast(content)` | 广播 |
178
- | `hub.getAllStatus()` | 查看所有 session |
179
-
180
94
  ## npm 包
181
95
 
182
- | 包 | 说明 | 版本 |
96
+ | 包 | 版本 | 说明 |
183
97
  |---|------|------|
184
- | [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | anet CLI + CommHub SDK + Channel 插件 | v0.0.48 |
185
- | [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | Agent 运行时（MiniMax/书生/Claude） | v0.7.0 |
186
- | [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | CommHub 通信服务器 | v0.4.3 |
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 |
187
101
 
188
102
  ## 文档
189
103
 
190
- - [快速上手](docs/anet-quickstart.md)
191
- - [CLI 设计](docs/cli-design.md) — 命令 + 配置规范
104
+ - [CLI 重构方案](docs/cli-refactor-proposal.md)
105
+ - [依赖管理方案](docs/dependency-management.md)
106
+ - [测试计划](docs/test-plan.md)
107
+ - [踩坑经验](docs/pitfalls.md)
192
108
  - [架构设计](docs/architecture.md)
193
- - [踩坑经验](docs/pitfalls.md) — Channel 插件开发注意事项
109
+ - [CommHub Review](docs/commhub-review.md)
110
+ - [重启策略](docs/restart-strategy.md)
194
111
 
195
112
  ## License
196
113