Agent Network

简体中文

English

简体中文

English

Appearance

更新日志 ​

版本号体系说明

本日志按时间倒序排列，版本号经历过一次重新规划：

  • 2026-05 起：采用 v0.6 → v0.7 → v0.8.x 渐进发布，对应 commhub-server semver
  • 2026-04 之前：曾使用 v1.0.0-preview.N / v2.1 等过度承诺型版本号，已废弃
  • 当前 stable：v0.8.2（2026-05-12，通过 npm latest tag 发布；v0.8.1 是 Apache 2.0 OSS 首发版本）
  • 旧版历史保留作 git blame 完整性，详见下方 v1.0.0-preview / v2.1 / v0.x 段落

2026-05-12 — v0.8.2 正式版 telegram channel + claude-code-cli session resume ✅ stable ​

版本同步（npm latest tag）：

  • @sleep2agi/agent-network@2.1.7
  • @sleep2agi/commhub-server@0.8.0 (无变化)
  • @sleep2agi/agent-node@2.3.0 (无变化)

关联：issue #13 (closed) · issue #14 · commit 143b2a1 (release: 2.1.7 stable) · commit f1e3d9c (fix(cli): bind claude code sessions on first start)

新功能 ​

  • anet channel add telegram 一键接入 — 给已有 node 绑定 Telegram bot token + allow user，自动生成 channels/telegram 配置（细节见 cases/telegram-squad）。

修复 ​

  • claude-code-cli runtime 创建节点时预生成 Claude session UUID。
  • 首次启动使用 claude --session-id <uuid> 绑定固定 session；检测到本机已有 ~/.claude/projects/<cwd>/<uuid>.jsonl 后改用 claude --resume <uuid> 续会话，避免 anet node start 误开新对话。
  • anet node start --new-session 会生成并保存新的 session UUID。

2026-05-11 — v0.8.1 补丁 Dashboard SSE-online 全局修补 ✅ stable ​

版本同步（npm latest tag，git tag v0.8.1）：

  • @sleep2agi/commhub-server@0.8.0 (无变化)
  • @sleep2agi/agent-network@2.1.5
  • @sleep2agi/agent-network-dashboard@0.4.2
  • @sleep2agi/agent-node@2.3.0 (无变化)

修复 ​

  • Dashboard /nodes、/admin、/api/hub/session 三处都因为 SSE key 在 v0.7+ 改成 network_id:alias 而显示所有 agent 为 offline。0.4.1 的 fix 漏了这 3 处，0.4.2 补齐全局 sse 查询的 alias-fallback 模式。
  • CLI 同步 bump PINNED_DASHBOARD_VERSION 到 0.4.2，否则 anet hub dashboard 仍拉老版。

2026-05-11 — v0.8.0 正式版 🎉 RFC-001 阶段 2 落地 ✅ stable ​

版本同步（git tag v0.8.0）：

  • @sleep2agi/commhub-server@0.8.0
  • @sleep2agi/agent-network@2.1.4
  • @sleep2agi/agent-network-dashboard@0.4.1
  • @sleep2agi/agent-node@2.3.0 (无变化)

鉴权变化 ​

  • COMMHUB_AUTH_TOKEN 进入软废弃：v0.8 只保留 /api/* 读类兼容并打印 warning，v1.0 移除。
  • anet hub start 首次启动 bootstrap 默认 admin 账户（admin / anethub 快速上手默认），把本机恢复用 admin utok_ 写到 ~/.anet/server/admin-utok.json（chmod 600）。公网部署立刻 anet passwd 改强密码。
  • 第二次起 anet hub start 是 idempotent：admin-utok.json 已存在直接跳过 bootstrap，不再 prompt。
  • Dashboard 改为浏览器 cookie 透传（thin proxy 起步，完整 0-token 模型留 v0.8.x 后续）。
  • tmux / admin 端点强制 admin utok_。

密码管理 ​

  • anet passwd 默认交互输入旧密码、新密码、确认密码；保留 --old / --new。
  • 改密成功后当前设备换新 utok_，其他设备 utok_ 自动失效；Agent ntok_ 不受影响。
  • 新增 anet hub admin reset-user --username <u>，仅 hub 主机本机恢复普通用户密码，写入 password_reset_by_admin 审计事件。
  • 用户自选密码最小长度 8 + top-1000 弱密码字典；首次 bootstrap admin 的默认密码不受此限制（≥ 4 即可）。

Doctor 大幅增强 ​

  • anet doctor --fix 现在会主动 probe 每个 node 的 ntok_ 是否被 hub 接受。401/403 自动从当前 utok_ 重新颁发 ntok_，in-place patch 文件，session_id / channels / runtime / role 全部保留。这覆盖了"hub DB 被 wipe / token 被撤销" 场景。

CLI / UX ​

  • anet hub start 默认 silent auto-generate，不再 prompt 中断启动。
  • anet login 输出加 ✅ + 下一步提示；prompt 文案去掉重复冒号 bug。
  • 命令行错误信息从 [anet] 平淡前缀改为 ✅ / ❌ 视觉标识。

Dashboard 0.4.1 ​

  • 修 Command Mesh 的 sse:undefined：SSE key 在 server v0.7+ 改为 network_id:alias，dashboard 同步按双层 key 查询，带 alias-only fallback 兼容老 hub。
  • light/mint 主题 solid button 修补（从 0.3.4 起）。

2026-05-10 — v2.1 正式版 🎉 ​

版本同步（npm latest tag）：

  • @sleep2agi/agent-network@2.1.0
  • @sleep2agi/commhub-server@0.6.0
  • @sleep2agi/agent-node@2.3.0
  • @sleep2agi/agent-network-dashboard@0.3.0

安装

bash
npm install -g @sleep2agi/agent-network

不需要再加 @preview，默认就是新正式版。

这一波带来什么 ​

🩺 anet doctor --fix 自动迁移老 V2 节点 来自一线踩坑：claude-code-cli runtime 路径上很多 V2 时代的 node config（带 alias/resume/没 token / hub URL 是 dev IP）跑 V3 hub 直接报 utok_ but SSE needs ntok_。doctor 现在能：

  • 检测 6 类老 config 问题（字段重命名、runtime 改名、stale hub、缺 token、无前缀 token、缺 node_id）
  • 一键 --fix 升级，保留 session 字段不丢对话历史，重新申请 ntok_

🪄 anet demo 子命令族

  • anet demo ls — 列出 demo
  • anet demo debate — 6 agent 9 步辩论赛
  • anet demo socialmedia — 4 agent 社交媒体内容工厂（小红书/Twitter/微信/LinkedIn）
  • 默认建独立 demo-<suffix> network 跑完自动清场，不污染 default

🔧 hub telemetry 修复

  • POST /api/task 现在双写 inbox + tasks 表（之前只写 inbox 导致 dashboard Tasks 页空 + send_reply 找不到 task）
  • 派任务时立即 UPDATE sessions.task + updated_at（dashboard Overview 实时反映"任务在飞"）

🎨 dashboard 多主题

  • 4 个主题：Cyber（默认深色）/ Light / Mint / Sunset
  • 右下角切换，localStorage 持久化
  • 修复 useSSE 死循环（之前 hub 收 1500+ admin SSE 把 mcp 拖死）
  • 默认 COMMHUB_URL fallback 改回 127.0.0.1:9200（之前是 leftover dev IP）

🛠️ CLI

  • --runtime http-api 不再错走 claude CLI 分支
  • agent-node HTTP runtime 同时识别 ANTHROPIC_AUTH_TOKEN（之前只读 ANTHROPIC_API_KEY）
  • demo 子命令调 createCommand 时不再触发 6 次 "选择 provider" 交互弹窗

📦 一键部署脚本

  • hub-only.sh 重写：4G swap + sudoers NOPASSWD + enable-linger + systemd autostart + AUTOSTART=1
  • agent-only.sh 同步更新

升级路径 ​

bash
# 1. 升级 CLI
npm install -g @sleep2agi/agent-network    # 或 npm update -g

# 2. 重启 hub（让新 commhub-server 生效）
# tmux 起的: tmux kill-session -t hub; tmux new -d -s hub 'anet hub start'
# systemd-user 起的: systemctl --user restart anet-hub

# 3. 每个老项目目录跑 doctor --fix
cd <project-dir>
anet doctor --fix

# 4. 重启 agent
kill <claude-pid> && anet resume <node-name>

详细见 升级指南。

2026-05-03 — anet demo 子命令族 + 多个 bug 修复 ​

版本同步：anet@2.0.3-preview.4 / agent-node@2.2.0-preview.1 / dashboard@0.2.1-preview.1 / commhub-server@0.5.3-preview.0

新功能 ​

  • anet demo ls — 列出可用 demo
  • anet demo debate — 一键 6-agent 辩论赛（主持人/正反 4 辩/评委）
    • --topic "议题" 议题（默认交互输入）
    • --key sk-cp-xxx MiniMax API key（默认 $MINIMAX_KEY）
    • --quick 4 步简化版（默认 9 步完整版）
    • --keep 跑完保留 6 个临时 agent（默认清掉）
    • --out path.md 实录路径
    • 角色个性独立 systemPrompt，跑完输出 markdown 实录
  • anet demo monitor（旧 anet demo --live 别名保留）

Bug 修复 ​

  • anet CLI：--runtime http-api 在 node start 时错走 claude CLI 分支 → 改为 spawn agent-node 并显式传 --runtime
  • agent-node：HTTP runtime 加读 ANTHROPIC_AUTH_TOKEN env（之前只读 ANTHROPIC_API_KEY，导致 MiniMax 配置无法工作）
  • dashboard：useSSE 钩子的 connect callback 依赖 onEvent，调用方传内联函数导致每次 render 都 reconnect → 用 ref 包装 onEvent（修复了"hub 收 1500+ admin SSE"的死循环）
  • hub-only.sh 一键脚本重写：自动加 4G swap、配 sudoers NOPASSWD、enable-linger、systemd --user 自启（AUTOSTART=1 启用）

2026-04-30 — Parent Task Lineage + Auto-Chain Reply ​

commhub-server@0.5.3-preview.0

修复多 agent 链式调用断链问题：admin → 指挥室 → 主编 时，指挥室 reply 后会话结束，主编返回结果时找不到 admin。

  • tasks 表加 parent_task_id 列 + chainReplyToParent() helper
  • send_task 接受 parent_task_id（缺失时根据 caller 最近一个 open task 推断）
  • send_reply / report_completion 自动沿 parent 链向上转发结果
  • agent-node 自动注入 CURRENT_TASK_ID env，prompt 提示 LLM 必须传 parent_task_id

2026-04-26 — Hub Server Logs Page + V2 Lineage Foundation ​

commhub-server@0.5.2-preview.0 / dashboard@0.2.1-preview.0 / anet@2.0.3-preview.1

  • Dashboard 新页面 /server-logs：实时查看 hub stdout（最近 N 行 ring buffer）
  • REST GET /api/server-logs（admin 鉴权）
  • Hub banner & /health 显示真实 published 版本号

2026-04-15 — V3 Stable: Multi-Network + User System + Trial License ​

Agent Network V3 — Multi-Network + Commercial Ready（commhub-server 0.5.x、anet 2.0.x）

主要交付：

  • 多网络支持：每个网络隔离 nodes/tasks/sessions
  • 用户系统：用户名+密码注册/登录、JWT、双 Token 体系（utok_ + ntok_）
  • 试用授权：14 天免费试用，授权码激活 Pro
  • 39 CLI 命令：quickstart、login、register、passwd、token、network (CRUD)、status、tasks、doctor、info、logs、demo、config、license、activate、hub start...
  • 17 MCP 工具：send_task/send_reply/retry_task/cancel_task/reassign_task/list_tasks/get_task/...
  • 17 REST 端点：/api/auth/* + /api/networks/* + /api/tasks + /api/nodes + /api/stats + /api/audit-log + /api/license + ...
  • 3 种 Runtime：claude-agent-sdk、codex-sdk、http-api（OpenAI/MiniMax 兼容）
  • 审计日志 + 速率限制 + PostgreSQL 支持（DbAdapter 接口）

测试：200+ Docker E2E 回归测试覆盖（认证、网络、隔离、token CRUD、SSE 并发、审计）。

v1.0.0-preview.25 (2026-04-11) ​

PostgreSQL + Adapter Architecture ​

新功能：

  • PostgreSQL 支持：DATABASE_URL=postgres://... 启用 PostgreSQL（SQLite 仍为默认）
  • DbAdapter 接口：统一数据库抽象层（SQLiteAdapter + PgAdapter）
  • SQL 自动翻译器：sqliteToPostgres() 处理 datetime->NOW、?N->$N、AUTOINCREMENT->SERIAL
  • 34 个 CLI 命令：新增 passwd、token (create/ls/revoke)、network (info/rename/delete)、demo、config、license、activate、hub start
  • 17 个 REST 端点：新增 PUT /api/networks/:id、DELETE /api/networks/:id、POST /api/auth/password、token CRUD
  • 一键 Demo：bash examples/demo-one-click.sh -- 60 秒自动化演示
  • createAdapter() 工厂：环境驱动的数据库选择

架构改进：

  • 全部 85+ 个 db.query() 调用迁移到 adapter 方法（db.get()、db.all()、db.run()）
  • 全部 7 个手动 BEGIN/COMMIT/ROLLBACK 事务转换为 db.transaction()
  • 零原始数据库访问 -- 所有代码通过 DbAdapter 接口
  • SQL 翻译器处理 4 个源文件中的 161 个 SQL 片段

测试：

  • 200 个 Docker E2E 测试（137 基础 + 25 认证 + 22 网络 + 16 配置）
  • 19 个 adapter 专项 E2E 测试
  • 10 个 SQL 翻译器单元测试

v1.0.0-preview (2026-04-10) ​

Agent Network V3 -- Multi-Network + Commercial Ready ​

新功能：

  • 多网络支持：创建隔离的网络，每个有独立的 nodes/tasks/sessions
  • 用户系统：用户名+密码注册/登录、API Token 认证
  • 试用授权：14 天免费试用，授权码激活 Pro
  • 39 个 CLI 命令：quickstart、login、register、passwd、token、network (create/ls/use/info/rename/delete)、status、tasks、doctor、info、logs、demo、config、license、activate、hub start...
  • 17 个 MCP 工具：send_task、send_reply、retry_task、cancel_task、reassign_task、list_tasks、get_task...
  • 17 个 REST 端点：/api/auth/、/api/networks/、/api/tasks、/api/nodes、/api/stats、/api/audit-log、/api/license...
  • 2 种 AI Runtime：codex-sdk (OpenAI Codex / GPT-5)、claude-agent-sdk (Claude / MiniMax / OpenAI 兼容)
  • 审计日志：所有用户操作 + 任务状态变更记录
  • 速率限制：注册 30/min、登录 10/min per IP

安全：

  • MCP/SSE/WebSocket 认证
  • Server 端强制 network_id（token 绑定，客户端不可覆盖）
  • SQL 注入修复（全部参数化查询）
  • 网络所有权检查（跨用户访问 403）
  • 密码哈希（SHA-256）
  • localhost 免速率限制（开发/测试）

数据库（13 张表）： sessions、inbox、tasks、nodes、completions、task_events、users、networks、api_tokens、audit_log、licenses、network_members、network_invites

测试（200 个回归测试）：

  • 基础 E2E：137 个测试（节点生命周期、消息生命周期、认证、授权、SSE、并发）
  • 认证套件：25 个测试（注册、登录、token、profile、密码、审计、速率限制）
  • 网络套件：22 个测试（CRUD、隔离、所有权、重命名、删除、跨用户）
  • 配置优先级：16 个测试（CLI > env > project > global）
  • 真实 AI：Codex (GPT-5) + MiniMax (Anthropic API) 验证
  • 10-agent 成语接龙（混合 codex + minimax）

npm 包：

  • @sleep2agi/agent-network (anet CLI)
  • @sleep2agi/agent-node (Agent 运行时)
  • @sleep2agi/commhub-server (通信中枢)

v0.x (2026-03 ~ 2026-04-09) -- Pre-V3 ​

核心功能建设 ​

  • CommHub Server：基于 MCP + SSE 的通信中枢
  • agent-node：双引擎 Runtime（Claude + Codex）
  • anet CLI：create / start / resume / channel 等基础命令
  • Dashboard：基础版本
  • 消息类型：task / reply / message / ack 四种类型区分
  • Channel 插件：Claude Code 接入 CommHub

早期里程碑 ​

版本日期内容
v0.12026-03 初基础 CommHub + SSE
v0.32026-03 中agent-node 双引擎
v0.52026-03 末anet CLI + Channel
v0.72026-04 初Dashboard + 消息类型
v0.92026-04-09多模型支持（MiniMax、书生）

未来规划 ​

v0.9 -- 安全硬化 ​

  • 密码哈希升级到 Argon2id（当前 SHA-256）
  • utok_ / ntok_ TTL + revoke-all
  • 安装脚本 checksum 校验
  • Dashboard 完整 0-token 模型收尾

v1.0 -- 清理 + 公开网络 ​

  • 完全移除 COMMHUB_AUTH_TOKEN 兼容路径
  • Token scope (full/agent/readonly) 完整实现
  • 公开 / 邀请混合网络（member 申请 + owner 审批流）
  • Dashboard 按角色精细化按钮可见性

后续探索 ​

  • 可选 PostgreSQL 后端 — adapter 接口保留作扩展点，v0.8+ 产品方向已转为 SQLite only（见 docs/v3-postgresql-design.md banner）
  • SSO 集成
  • Webhook 回调
  • 任务调度（cron）

下一步 ​

Powered by Sleep2AGI

© 2026 sleep2agi