@sleep2agi/agent-network 2.0.0-preview.9 → 2.0.0

package/README.md

@@ -35,9 +35,12 @@ AI Agent 通信网络 — 一行命令创建 Agent，多 Agent 协作通信。
 # 安装 Bun (如果没有)
 curl -fsSL https://bun.sh/install | bash
 
-# 启动 CommHub Server
+# 启动 CommHub Server (默认 SQLite, 零配置)
 bunx @sleep2agi/commhub-server
 # 默认端口 9200, 访问 http://YOUR_IP:9200/health 验证
+
+# 或使用 PostgreSQL
+DATABASE_URL=postgres://user:pass@host:5432/commhub bunx @sleep2agi/commhub-server
 ```
 
 Server 启动后会显示：
@@ -45,15 +48,18 @@ Server 启动后会显示：
 - REST API: `http://0.0.0.0:9200/api`
 - 健康检查: `http://0.0.0.0:9200/health`
 
-### Step 2: 安装 CLI 工具（开发机）
-
-在每台要跑 Agent 的机器上：
+### Step 2: 安装 + 一键设置（开发机）
 
 ```bash
 npm install -g @sleep2agi/agent-network @sleep2agi/agent-node
 
-# 配置 CommHub 地址
+# 一键引导（推荐）
+anet quickstart
+
+# 或手动配置
 anet init --hub http://YOUR_SERVER_IP:9200
+anet register          # 创建账号
+anet login             # 登录
 
 # 检查一切正常
 anet doctor
@@ -107,10 +113,31 @@ ANTHROPIC_API_KEY=sk-cp-xxx \
 agent-node --alias dev --runtime http-api --model claude-3-5-haiku-20241022
 ```
 
-## CLI 命令
+## CLI 命令 (39 个)
 
 ```bash
-# 节点管理
+# 账号
+anet quickstart              # 一键引导设置
+anet register                # 创建账号
+anet login                   # 登录
+anet logout                  # 退出
+anet whoami                  # 当前用户信息
+anet passwd                  # 修改密码
+
+# Token
+anet token create <name>     # 创建 API Token
+anet token ls                # Token 列表
+anet token revoke <id>       # 撤销 Token
+
+# 网络
+anet network create <name>   # 创建网络
+anet network ls              # 我的网络列表
+anet network use <name>      # 切换网络
+anet network info            # 当前网络详情
+anet network rename <new>    # 重命名网络
+anet network delete --force  # 删除网络
+
+# 节点
 anet create <name>           # 创建 node（交互式）
 anet start <name>            # 启动
 anet stop <name>             # 停止
@@ -118,15 +145,24 @@ anet delete <name> --force   # 删除
 anet rename <ref> <new>      # 重命名
 anet ls                      # 节点列表 + 网络状态
 anet status                  # 网络总览
+anet info <name>             # 节点详情
 anet tasks [status]          # 任务列表
+anet logs <name>             # 查看日志
 anet doctor                  # 系统诊断
+anet demo                    # 实时仪表盘
+anet config                  # 查看配置
 
 # Channel
 anet channel add telegram <name> --bot-token <tok> --allow <uid>
 
+# 授权
+anet license                 # 查看 License 状态
+anet activate <key>          # 激活授权码
+
 # 设置
 anet init                    # 配置 hub URL
 anet setup                   # 安装依赖
+anet server local            # 本地零配置启动
 anet server start            # 启动 CommHub
 anet upgrade                 # 检查更新
 anet -v                      # 版本信息
@@ -145,27 +181,70 @@ anet -v                      # 版本信息
 
 配置优先级: CLI 参数 > 环境变量 > 项目配置 > 全局配置 > 默认值
 
-## REST API
+## Telegram Channel 接入
+
+让 Agent 自动接收 Telegram 消息并回复：
+
+```bash
+# 1. 先创建 agent 节点
+anet create my-bot --runtime http-api
+
+# 2. 添加 Telegram channel
+anet channel add telegram my-bot --bot-token 123456:ABC-xxx --allow 7612221352
+# --bot-token: 从 @BotFather 获取
+# --allow: 允许的 Telegram 用户 ID（白名单）
+
+# 3. 启动
+anet start my-bot
+# agent 会自动连 Telegram bot，收到消息后 AI 处理并回复
+```
+
+配置文件自动创建在：
+```
+.anet/nodes/my-bot/channels/telegram/
+├── .env          # BOT_TOKEN（chmod 600，安全存储）
+└── access.json   # {"allow": ["7612221352"]}
+```
+
+## REST API (27 endpoints)
 
 | 端点 | 说明 |
 |------|------|
-| `GET /health` | 健康检查 (无需 auth) |
-| `GET /api/status` | 所有 session |
-| `GET /api/tasks?status=&from_name=&to_name=&limit=` | 任务列表 |
-| `GET /api/nodes?node_id=&alias=` | 节点信息 |
-| `GET /api/task_events?task_id=` | 任务审计日志 |
-| `GET /api/messages?limit=&since=` | 消息列表 |
-| `POST /mcp` | MCP Streamable HTTP |
-
-设置 `COMMHUB_AUTH_TOKEN` 环境变量启用 Bearer token 鉴权。
+| `POST /api/auth/register` | 注册 |
+| `POST /api/auth/login` | 登录 |
+| `GET /api/auth/me` | 当前用户 |
+| `PUT /api/auth/me` | 修改资料 |
+| `POST /api/auth/password` | 修改密码 |
+| `GET /api/auth/tokens` | Token 列表 |
+| `POST /api/auth/tokens` | 创建 Token |
+| `DELETE /api/auth/tokens/:id` | 撤销 Token |
+| `GET /api/networks` | 网络列表 |
+| `POST /api/networks` | 创建网络 |
+| `GET /api/networks/:id` | 网络详情 |
+| `PUT /api/networks/:id` | 重命名网络 |
+| `DELETE /api/networks/:id` | 删除网络 |
+| `GET /api/tasks` | 任务列表 (支持 network_id 过滤) |
+| `GET /api/stats` | 统计汇总 |
+| `GET /api/audit-log` | 审计日志 |
+| `GET /api/license` | License 状态 |
+
+所有数据端点支持 `?network_id=` 过滤。认证: `Authorization: Bearer <token>`。
+
+## 文档
+
+- [Getting Started Guide](docs/getting-started.md) — 新手教程
+- [CHANGELOG](CHANGELOG.md) — 版本变更
+- [V3 设计](docs/v3-multi-network-design.md) — 架构设计
+- [测试矩阵](tests/README.md) — 25 套 550+ Docker 测试
+- [Examples](examples/README.md) — Demo 场景
 
 ## npm 包
 
 | 包 | 最新 Preview | 说明 |
 |---|-------------|------|
-| [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.6 | anet CLI + SDK |
-| [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.3 | Agent 运行时 |
-| [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.6 | CommHub Server |
+| [@sleep2agi/agent-network](https://www.npmjs.com/package/@sleep2agi/agent-network) | 2.0.0-preview.28 | anet CLI + SDK |
+| [@sleep2agi/agent-node](https://www.npmjs.com/package/@sleep2agi/agent-node) | 2.1.0-preview.8 | Agent 运行时 |
+| [@sleep2agi/commhub-server](https://www.npmjs.com/package/@sleep2agi/commhub-server) | 0.5.0-preview.28 | CommHub Server |
 
 ```bash
 # 安装 preview 版