更新日志

版本号体系说明

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

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

v0.10.13 — grok-build-acp `session/prompt` 300s timeout 卡死修复（P0 hotfix）（2026-06-08）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-node@2.4.9 ← bumped（#210 / #204 runtime — ACP handleServerRequest 非整数错误码 coerce 修复）
@sleep2agi/agent-network@2.2.10 ← unchanged
@sleep2agi/commhub-server@0.8.4 ← unchanged（PINNED）

🌟 Highlights

`grok-build-acp` 节点 hang 至 `session/prompt timed out after 300000ms` 根因 + 修复

症状：grok-build-acp runtime 节点接到第二个 task 后 hang ≈5 min，最终 agent-node 报 grok ACP request 'session/prompt' timed out after 300000ms —— ai-insight 用户 A站Grok（grok 0.2.29 alpha）2026-06-07 19:53:09 抓到的精确日志：

text

ERROR failed to parse incoming message: invalid type: string 'ENOENT',
expected i32 at line 1 column 48.
Raw: {'jsonrpc':'2.0','id':5,
      'error':{'code':'ENOENT',
               'message':'ENOENT: no such file or directory, open ...'}}

根因：ACP server-request 响应（比如 read_file 失败）携带 JS-native 字符串错误码 'ENOENT'，但 Grok agent 端 protocol 要求 code 字段必须 i32 整数。旧 agent-node 直传 → Grok agent 解析失败 → 进入未定义状态 → hang 直到 client-side 300 s 超时。

修复（commit 4818776）：client.ts:handleServerRequest 加 Number.isInteger(rawCode) 守卫。非整数 code → coerce 成 -32000（JSON-RPC 标准 reserved range），原 code 字符串保留到 data.originalCode 不丢信息。

新增回归测试：+2 cases，bun test 89/89 pass。

实战验证（维护者本机，2026-06-07 19:50–19:55）：

同型 read_file 失败重试：立返结构化 code: -32000 + data.originalCode: "ENOENT"
grok turn 继续不 hang，任务正常 done/failed（47 s 完成，不到 300 s 超时门）
ai-insight A站Grok 节点全局装 2.4.9-preview.0 后 UAT 通过

🐛 Bugs Fixed

#210 / #204 runtime — grok-build-acp ACP server-request 响应携带非整数错误码（如 ENOENT）致 Grok agent 解析失败 hang 至 300 s timeout

📦 Install（全新安装）

bash

npm i -g @sleep2agi/agent-network@latest @sleep2agi/agent-node@latest
# 验证版本
anet --version          # agent-network v2.2.10（未变）
agent-node --version    # agent-node v2.4.9 ⬆

anet hub start 自动拉取 commhub-server@0.8.4（PINNED, 未变）。

🔄 Upgrade（老用户升级）

最窄路径（推荐 — 仅此 hotfix 必需）：

bash

npm i -g @sleep2agi/agent-node@2.4.9
# 重启所有 grok-build-acp 节点
cd <your-anet-workdir>
anet node stop <grok-node-alias> && anet node start <grok-node-alias>

全包升级（一并刷 README / metadata）：

bash

anet upgrade

⚠️ Node 版本：agent-node 兼容 Node ≥ 18；本 hotfix 在 Node 20.20 / 24.16 双跑 Docker smoke 通过。

详细排错入口见 troubleshooting → grok-build-acp 节点任务挂死。

🙏 Credits

bug 复现 + root cause + UAT：本机活体抓 19:53:09 日志 + Vincent A站Grok 47 s pilot；fix 实现：commit 4818776 + 2 回归测试；release ops：Method B 两阶段 + Install/Upgrade 分块 release notes。

Full Changelog: https://github.com/sleep2agi/agent-network/compare/v0.10.12...v0.10.13

v0.10.12 — Grok-build runtime 场景化能力 + 0.2.8 alpha 回归验证（2026-05-30）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-node@2.4.8 ← bumped（场景化文档 + 0.2.8 alpha 回归基线 tag）
@sleep2agi/agent-network@2.2.10 ← unchanged
@sleep2agi/commhub-server@0.8.4 ← unchanged

主要内容

视频生成场景（0 改动可用）：给 Grok 节点发送带图片 URL 的任务，后端自动路由到 grok-imagine-video 模型，产出 mp4。anet 端零代码改动，已用 ffmpeg 第一帧视觉验证。详见 research/grok-video-gen-capability-probe.md（含 Erratum）+ scenarios/video-gen-marketing.md。
基础 X 搜索（开箱即用）：按 keyword / handle 找 X URL + 标题 + 摘要 —— LLM 自动用 web_search + allowed_domains=["x.com"] 命中，无需预置。
实时 X 高级搜索（需工作区预置）：实时推流 + 帖子 faves/retweets/replies metadata + since: / min_faves: 高级语法 —— 需用户预置 twitterapi.io API key + fetcher 脚本，LLM 用 run_terminal_command 调。详见 scenarios/x-search-informant.md。
0.2.8 alpha 回归验证：87/87 bun 单元测试通过，#201 委派识别 + #204 .mcp.json 隔离修复在 Grok 0.2.8 alpha 上确认无回归。详见 tests/p-grok-028-regression-verify/report.md。
RFC-021 §12 / §13：ACP 能力档案补充 Path D（工作区预置 + 终端兜底）+ XSearch ACP 暴露实测（XSearch 后端工具在 0.1.219 → 0.2.12 alpha 一致不通过 ACP 暴露，属结构性，长期解在 xAI 上游 PR #1302）。

📦 Install / 🔄 Upgrade

升级无破坏性，0.2.8 alpha 回归已过，可安全升级：

bash

anet upgrade

或手动单包：npm i -g @sleep2agi/agent-node@2.4.8

Full Changelog: https://github.com/sleep2agi/agent-network/compare/v0.10.11...v0.10.12

v0.10.11 — #204 grok-build-acp 节点身份隔离 + #194 commhub broadcast 归属 hotfix（2026-05-28）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.10 ← bumped（anet hub stop / anet hub status 子命令 #200 + anet hub start stderr inherit #199 静默挂修 + PINNED commhub-server 0.8.3 → 0.8.4）
@sleep2agi/agent-node@2.4.7 ← bumped（#204 grok-build-acp per-node .anet/nodes/<alias>/runtime-cwd/ 隔离 + #201 Grok delegate parser 3-layer broaden）
@sleep2agi/commhub-server@0.8.4 ← bumped（#194 broadcast channel_meta_json sender 归属 hotfix —— from_session 注入不再覆盖真实 LLM agent alias）
@sleep2agi/agent-network-dashboard@0.5.6 ← unchanged

🌟 Highlights

#204 — grok-build-acp per-node isolated cwd

问题：grok-build-acp runtime 节点共享 .mcp.json 发现路径，导致 stale .mcp.json identity pollution —— 一个节点的工作目录里如果存在旧的 .mcp.json，新启的 grok 节点会被误认成那个旧节点的身份。

修复：每个节点 fork 独立 cwd（.anet/nodes/<alias>/runtime-cwd/），与发现路径解耦，彻底解决 stale .mcp.json 干扰。

E2E 验证：在真节点跑通跨节点 dispatch —— channel sender attribution 正确归属到发送节点 alias，证实 LLM 层 attribution 链路无污染。

#194 — commhub broadcast 发送者归属 hotfix

问题：跨节点 broadcast 时 channel_meta_json 的 sender 字段经过 from_session 注入路径，导致 real LLM agent 名字被覆盖。

修复：commhub-server 0.8.4 修正 from-name 注入逻辑，保留真实 sender alias。

🐛 Bugs Fixed

#199 — anet hub start 静默挂修：spawn 的 stdio 从 "pipe" 改为 "inherit"，commhub-server bunx fetch 失败时立即可见错误
#200 — anet hub stop / anet hub status 子命令补全：之前用户需手动 lsof + kill；现在 anet hub stop [--port <p>]（SIGTERM → 3s grace → SIGKILL）+ anet hub status（PID + port + /health version）
#201 — Grok runtime 拒绝 delegate：explicit delegation parser 3-layer wrapper broaden + prompt softening 全 case 覆盖

📦 Install（全新安装）

bash

npm i -g @sleep2agi/agent-network@latest
# 验证版本
anet -v  # 应显示 v2.2.10

anet hub start 会自动拉取 commhub-server@0.8.4 (PINNED) + 首次 node 启动会自动拉取 agent-node@2.4.7。

🔄 Upgrade（老用户升级）

bash

anet upgrade
# 或手动
npm i -g @sleep2agi/agent-network@latest

anet upgrade 会同步 agent-network + agent-node + commhub-server 到最新 latest 版。

🙏 Credits

Shipped by 团队 Agent Network — 设计 + lead review / agent-node #204 fix / agent-network release ops + commhub-server promote / 测试 + 文档全程协作完成. 个人贡献明细见 v0.10.11 GitHub release page. LLM E2E attribution 由真节点跨 hub dispatch 验证.

Full Changelog: https://github.com/sleep2agi/agent-network/compare/v0.10.10...v0.10.11

v0.10.10 — 小米 MiMo 5 模型完整支持 + envRef wizard-to-start 自动衔接（2026-05-27）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.9 ← bumped（envRef Option A 自动 source + anet -v 显示完整 prerelease 后缀 + Grok delegation parser broaden）
@sleep2agi/agent-node@2.4.6 ← bumped（envRef Option A 实施 + Grok 节点延续 stabilization）
@sleep2agi/commhub-server@0.8.3 ← unchanged
@sleep2agi/agent-network-dashboard ← unchanged

P0 — 小米 MiMo Vendor Preset 完整

新增 mimo-v2.5-tts-voicedesign，凑齐官方 5 个模型
anet node create 选 claude-agent-sdk runtime → 「小米 MiMo」vendor → 5 模型任选：mimo-v2.5-pro（默认）/ mimo-v2.5 / mimo-v2-pro / mimo-v2-omni / mimo-v2.5-tts-voicedesign
endpoint https://token-plan-cn.xiaomimimo.com/anthropic 完整对接 Anthropic Messages 协议
📌 注：voicedesign 是 TTS 语音设计模型，Anthropic Messages 文本请求 vendor 大概率不支持；文本对话请用前 4 个模型

P0 — envRef wizard-to-start 自动衔接（#193）

痛点：anet node create 完后同 shell 立即 anet node start 报 FATAL env var not set，必须手动 export ANTHROPIC_AUTH_TOKEN_N_<id>=...。

现在的行为：

wizard create 时 API key 自动写入 .anet/nodes/<alias>/.env（mode 0600，自动加入 .anet/.gitignore）
anet node start 启动前自动 source 该 .env，无需手动 export
跨机部署仍支持（wizard 仍 print 一次 export 命令，可手动 copy 到另一台机）
Debug 日志只输出 loaded N key(s) from .anet/nodes/<alias>/.env，不 echo key 值
向后兼容：已有 ANTHROPIC_AUTH_TOKEN_N_* shell export 继续 work；老节点 plain config.json 模式继续 work

适用所有 claude-agent-sdk 类型节点（MiMo / MiniMax / 书生 / GLM / 任意 Anthropic Messages 兼容 vendor）。

Bug fixes

#192 anet -v 不显示完整 prerelease 后缀已修，现显示 v2.2.9 完整版本号（含 -preview.N 后缀 when applicable）
#189 Grok runtime grok-build-acp 全面稳定化：explicit delegation parser broaden 覆盖含「你和 X 沟通一下…」「send_task X 一下…」等无标点尾随 body 句式，跨节点 delegation 路由可靠

Known Issues

agent-network 内部 npx fallback 仍 pin @sleep2agi/agent-node@preview 标签 —— 未来 preview 推进可能让 latest 用户拉到不稳版本。本 release 不存在 regression（preview 2.4.6-preview.2 内容接近 latest 2.4.6），但需后续 RFC 处理（follow-up tracking 待 issue 开；与同号 RFC-021 ACP capability profile expansion 为 X-search unlock 主题不同）。

v0.10.9 — Dashboard 图片发送 + CommHub 附件元数据 + codex-sdk 图片输入（2026-05-25）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.7 ← bumped（PINNED server 切到 @sleep2agi/commhub-server@0.8.3）
@sleep2agi/agent-node@2.4.3 ← bumped（codex-sdk runtime 读取结构化图片附件）
@sleep2agi/commhub-server@0.8.3 ← bumped（meta_json 持久化 + MCP/REST 附件元数据）
@sleep2agi/agent-network-dashboard@0.5.4 ← bumped（TaskChatPanel 图片上传/粘贴发送）

P0 — Dashboard 指挥链路支持发送图片

Vincent catch：Dashboard 聊天里已经能上传/预览图片，但任务发送到 agent 后只剩文字路径，codex-sdk runtime 没有拿到图片输入。结果是移动端/网页指挥时无法把截图、设计稿、报错图直接交给团队处理。

Implementation：

Dashboard TaskChatPanel 上传/粘贴图片后发送结构化 attachments，同时保留文本中的本地路径和预览 URL 作为兼容 fallback。
Hub send_task / REST /api/task 接收 meta.attachments，写入 inbox.meta_json 与 tasks.meta_json；get_inbox 返回解析后的 meta。
agent-node 从 meta.attachments 中抽取本机可读图片路径，传给 codex-sdk/studio 的 image input。
修复 Telegram 图片通道参数顺序，避免 channel image 参数被误放到 contextFrom。

Rollout + Smoke

本机 CommHub 已升级并重启到 0.8.3 源码状态。
Dashboard 已升级并重启，dm.vansin.me:3000 对应的图片发送链路走结构化附件。
27 个 host codex-sdk agent-node 进程已按新版代码滚动重启。
P0 smoke：向 通信测试牛 发送 /tmp/anet-image-smoke.png，节点日志显示 +1 image(s) / → processing [codex] +1 image(s)，回执 图片通道OK。

Known Limits

Dashboard 上传的图片当前以同机文件路径交给 hub/agent，最适合 hub 与 agent 共享本机文件系统的部署；跨机器对象存储分发留后续版本。
已运行的旧容器镜像不会自动获得本次代码，需要重新安装/重启到 latest。
本 release 解决“图片能送到 agent runtime”；图片消息的富媒体历史展示、移动端 IM 化体验仍留在 dashboard 后续 issue 中推进。

详见 v0.10.9 tag。

v0.10.8 — Dashboard Servers 面板 UI 文案修 + TopoGraph density tier polish（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.6 (无变化，v0.10.7)
@sleep2agi/agent-node@2.4.2 (无变化)
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.3 ← bumped（UI copy + Playwright attrs + polish fold-in）

Fix — #157 Dashboard Servers 面板 UI 文案修正（Root cause #1）

Vincent 实测 catch（附 dashboard 截图）：Servers 面板对每台 hub 显示 agent rollup pending hub ≥ 0.8.2-preview / disk metric pending hub ≥ 0.8.2-preview，但生产 hub 已经全部 ≥ 0.8.2，文案过时且误导，让 Vincent 一度以为版本控制台数据完全错误。

Root cause #1（本 patch）：ServersDrawer UI 早期为 0.8.2 升级 window 而埋的占位文字。0.8.2 早已上线，但占位文字未删，对 ≥ 0.8.2 hub 仍显示 "pending"，误导用户认为 hub 数据缺失。

Implementation（app/components/ServersDrawer.tsx）：

diff

- <div ...>agent rollup pending hub ≥ 0.8.2-preview</div>
- <div ...>disk metric pending hub ≥ 0.8.2-preview</div>
+ <div ... data-server-agents-missing="true">agent rollup not reported by hub</div>
+ <div ... data-server-disk-missing="true">disk metric not reported by hub</div>

文案精准反映"该 hub 此刻未上报"语义，不再 imply 版本不够。新增 data-server-agents-missing / data-server-disk-missing Playwright 钩子供下一轮 e2e 验证 hub-side telemetry coverage。

Root cause #2 + #3 已定位但 defer

#2（v0.10.9 候选）：同 hostname 多实例时 dedupe 缺失，可能 double-count 服务器 —— Dashboard 团队修复方案已就位，待 v0.10.9 ship
#3（v0.11.0 候选）：status=offline 与 telemetry 报告 mismatch（telemetry 仍上报但 SSE last_seen 超时）—— 系统级 status 协调

Polish fold-in — TopoGraph density tier（纯 additive）

Dashboard 团队 commit 3f73810 （0.5.3-preview.16）—— Canvas state attr data-topo-fleet-density-tier ∈ {empty, sparse, normal, dense, very-dense} 暴露第 12 个 observable testing surface。Tier 边界（sparse 1-3 / normal 4-15 / dense 16-30 / very-dense 31+）跟 dense-layout collapse gate 对齐。纯 additive，无 UX 改变，配 numeric counts 提供 e2e selector 完整 canvas state snapshot 能力。

Quality gates + lessons

Source-grep verify：grep -rh "not reported by hub" 命中 + 旧文案只在 JSDoc 注释 ✅
Docker preview 实测：docker run --rm node:24-slim sh -c "npm install -g @sleep2agi/agent-network-dashboard@0.5.3-preview.15 && grep..." ✅
JSX 文案 verify 走 source level：在 app/components/ServersDrawer.tsx source 验，不依赖 .next/server bundled output
v0.10.x patch density 单日 8 patch 验证 audit-first cadence 可持续

发布统计 — v0.10.8

18 累计 @latest publish（v0.9.0 → v0.10.8）：0 split-brain / 0 rollback / 0 retry
2026-05-17 当日 v0.10.x：v0.10.1-8 = 8 ships in ~11 hours（audit-first cadence）
Vincent catch + Vincent #158 LOCKED directive 同 cycle 闭环

详见 release v0.10.8。

v0.10.7 — codex-sdk batch path yolo flags parity（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.6 ← bumped（codex-sdk batch path yolo parity）
@sleep2agi/agent-node@2.4.2 (无变化)
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.2 (无变化)

Fix — #156 codex-sdk batch path yolo flags parity

Vincent catch："fast 也要开新一下默认 / codex 默认 fast 啊"。

Pre-fix vs Post-fix matrix：

Path	Pre-fix	Post-fix
`anet node create --runtime codex-sdk`	✅ 4/4 yolo flags（#149 v0.10.3 ship）	✅ 4/4 yolo flags（不变）
`anet create --batch --runtime codex-sdk`	❌ 仅 1/4（`dangerouslySkipPermissions` baseline only）	✅ 4/4 yolo flags（跟 single-node 对齐）
`anet [...] --runtime codex-sdk --no-yolo`	（无此 flag）	✅ 1/4 baseline（opt-out for CI/scripted）

Implementation — clean helper extraction at bin/cli.ts:125-131：

function codexSdkYoloFlags(noYolo?: boolean): Record<string, string | boolean> {
  if (noYolo) return {};
  return {
    approvalPolicy: "never",
    sandboxMode: "danger-full-access",
    skipGitRepoCheck: true,
  };
}

Source-of-truth helper：single-node path（cli.ts:1146）+ batch path（cli.ts:6223）都 call 同一个，阻断 v0.10.6 1/4-vs-4/4 drift。dangerouslySkipPermissions: true 是 baseline，在每个 call site 单独 set，1+3=4 yolo total。

用户影响

batch + codex-sdk 用户：之前 batch wizard 出的 codex agents 在 tool approval popup / sandbox / git check 处 block，失去 yolo autonomous 状态 → 现在 4/4 flags 全 set，autonomous 行为跟 single-node 一致
single-node 用户：不受影响（path 不变）
CI / scripted 用户：新 --no-yolo flag 提供 explicit safe-mode opt-out
非 codex-sdk runtime（claude / sdk）：完全不变（helper gated on runtime === "codex-sdk"）

Quality gates + lessons

Source-grep verify：grep -n 对 bin/cli.ts HEAD 5 sites 全 PASS（helper + 2 call sites + wiring + field）
Docker container smoke：Cell A anet login setup failed（test infra blocker, not a fix bug）→ Gate 2 source-grep evidence accepted as substitute per v0.10.6 precedent
Docker smoke 用 curl 直调 API 拿 token（本次新增）—— Docker smoke entry script 用 curl direct API call /api/auth/register + /api/auth/login 写 token，不要 interactive anet login（在 non-TTY container 容易 stall，hub login 调用阻塞）

发布统计 — v0.10.7

17 累计 @latest publish（v0.9.0 → v0.10.7）：0 split-brain / 0 rollback / 0 retry
2026-05-17 当日 v0.10.x：v0.10.1-7 = 7 ships in ~10 hours（audit-first cadence）
10 项用户反馈全闭环：包括 v0.10.7 #156

详见 release v0.10.7。

v0.10.6 — `anet upgrade` Option B detached spawn + `anet create --batch` wizard silent-exit 修（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.5 ← bumped（CLI upgrade + wizard fixes）
@sleep2agi/agent-node@2.4.2 (无变化，v0.10.3)
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.2 (无变化，v0.10.4)

Chicken-and-egg 升级注 — 仅本次需手装 1 次

v0.10.4 的 #151 Option A 只改了 verbiage（anet upgrade 显示 "⚠️ NEEDS MANUAL UPGRADE"），chicken-and-egg deadlock 没解 —— 你的当前 2.2.2 / 2.2.3 / 2.2.4 binary 跑 anet upgrade 还会沿用旧 "skipped (would replace running CLI)" 行为（这条 frozen 在 npm 上的老逻辑）。

bash

npm install -g @sleep2agi/agent-network@2.2.5    # 只需一次手装
anet --version                                    # 期望 v2.2.5

之后再有新版本（e.g. 2.2.6+），直接跑 anet upgrade 就会自动 detached spawn 升级，不再手装。

Fixes

#154 anet upgrade Option B detached spawn 默认开启（Vincent catch）：之前用户跑 anet upgrade 看到 anet (self): skipped (would replace the running CLI). + [anet] Done. 以为成功，实际 anet binary 没变（chicken-and-egg deadlock —— Node 进程无法 in-place 替换自己 binary）。bin/cli.ts:3873-3874 改成 spawn(forkScript, [], { stdio: "inherit", detached: true }) + child.unref() + 主进程 process.exit(0)，detached child 后台跑 npm install。新版本一两分钟后生效，无需用户 --self flag。
#155 anet create --batch wizard silent-exit 修（Vincent catch）：workdir mode select() 之后 process.stdin 状态变化，readline-based ask() helper 在 EOF 立即 return → 整个 wizard 在 Node prefix prompt 静默退出（同 #137 v0.9.2 preview.5 anet create regression 同根问题，不同代码路径再发）。Fix：post-select prompts 全 migrate 到 inquirer.input()，stdin handling 跟前面的 select 保持一致；catch fallback 保留 legacy ask() for non-TTY / 无 inquirer 环境。

Quality gates + lessons

Docker smoke gate 永不跳过（Vincent）—— v0.10.4 紧急 trust path SUSPENDED，Docker smoke gate 永不跳。
测试节点全在 Docker（Vincent）—— 红线：测试节点全 Docker，不许 connect 本机 hub。
dist 是混淆 bundle、code verify 走 source（本次新增）—— dist/bin/cli.js 是 esbuild bundled + obfuscated（rotating string-table, identifiers mangled, string literals encoded），静态 grep 对 dist 完全失效。Code-path verify 一律 grep bin/cli.ts source（HEAD = preview build source）。

发布统计 — v0.10.6

16 累计 @latest publish（v0.9.0 → v0.10.6）：0 split-brain / 0 rollback / 0 retry
2026-05-17 当日 v0.10.x: v0.10.1 + v0.10.2 + v0.10.3 + v0.10.4 + v0.10.5 + v0.10.6 = 6 ships in ~9 hours（audit-first cadence）
9 项用户反馈全闭环：Install/Upgrade 文档分块 + #149 / #150 / #151 / #152 / #153 / #154 / #155 + 安全红线 SOP

详见 release v0.10.6。

v0.10.5 — `anet create --batch` wizard 双修（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.4 ← bumped（CLI wizard 修）
@sleep2agi/agent-node@2.4.2 (无变化，v0.10.3 ship)
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.2 (无变化，v0.10.4 ship)

Fixes

#152 anet create --batch wizard 加 workdir mode 选择（Vincent push）：--workdir-mode <shared|separate> flag 早就 ship（#55）但 interactive wizard 从来没 prompt → 用户必须知道 flag 名才能改 default separate。createBatchWizardCommand 加 inquirer select（separate 默认 / shared 共 cwd），TTY-aware（flag set / non-TTY 都 fallback separate + INFO hint）。agent-node / server / dashboard 不动 —— 纯 CLI wizard UX。
#153 codex-sdk / claude-code-cli 选完不再误问 ANTHROPIC_AUTH_TOKEN（Vincent push）：runtime-first wizard (#133) 选 codex-sdk / claude-code-cli 时仍调 selectVendorAndModel() → 问 API key（只 claude-agent-sdk 需要）。Wizard 选 codex / claude-code-cli 后 skip API key prompt + print codex auth login / claude auth login 一行提示。

详见 release v0.10.5。

v0.10.4 — `anet upgrade` UX 警告 + Dashboard orphan-band 布局（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.3 ← bumped（#151 anet upgrade UX）
@sleep2agi/agent-network-dashboard@0.5.2 ← bumped（#150 orphan-band layout）
@sleep2agi/agent-node@2.4.2 (无变化，v0.10.3 ship)
@sleep2agi/commhub-server@0.8.2 (无变化)

Fixes

#151 anet upgrade self-skip 警告更明确（Vincent push）：之前 anet (self) — self-skip 行没解释 why & how，用户照着 plan 跑完发现自己版本没升。现在加 explicit warning + 引导 --self flag。
#150 Dashboard 拓扑图 orphan 节点收到 "其他" cluster box（Vincent push）：之前 orphan 节点（无 prefix 分组）散落画布各处难找；现在收到统一 "其他" cluster box 跟其他 group 一起渲染。

Vincent 紧急 trust path

v0.10.4 Vincent 紧急 ship 跳过测试团队 Docker smoke gate（不在生产跑测试的规矩不豁免，但 Vincent lead-scope 决定 trust path）。Docker smoke 仍是 release-gate playbook 标准卡控点，不变。

详见 release v0.10.4。

v0.10.3 — codex-sdk default model gpt-5.5 + yolo flags 可见（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.2 ← bumped（cli.ts vendor preset）
@sleep2agi/agent-node@2.4.2 ← bumped（codex-sdk runtime + flags）
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.1 (无变化)

Fixes

#149 codex-sdk 默认模型修 + yolo flags 写进 config（Vincent catch）：
- cli.ts codex vendor preset 默认 model placeholder gpt-5.4 → 真实 gpt-5.5
- codex-sdk runtime 加 yolo: true flags（跟 Claude Code preset 的 dangerouslySkipPermissions + teammateMode 同概念）—— 跳过权限交互弹窗便于 multi-agent batch 跑
- flags 写进 config.json 而非 ephemeral runtime arg，用户能 inspect / 编辑

详见 release v0.10.3。

v0.10.2 — Hero A disk telemetry + Hero D 拓扑图标签 UX（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.1 (无变化，PINNED_SERVER_VERSION 仍 0.8.2)
@sleep2agi/agent-node@2.4.1 ← 2.4.0（Hero A disk telemetry additive，commit 50d25b2）
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.1 ← 0.5.0（Hero D 拓扑图前缀标签 Option C + disk render + 100+ 轮 polish）

Hero A — agent-node disk telemetry（#99 守护节点 Phase 2 host metrics 闭环 final 10%）

agent-node/src/host-telemetry.ts 新增 readDiskStats()（execFileSync('df', ['-k', '/'])，+33 lines）：

POSIX -k 标准化 KB 输出，Linux + macOS 同一 parse 路径
不走 shell pipe（per recent shell-audit safety review），execFileSync direct call
Windows / 解析失败：graceful null（dashboard 渲染 — 不误导成 0）
HostTelemetry interface 加 disk_total_gb / disk_used_gb / disk_avail_gb，getHostTelemetry() 通过 toGb() 同 mem/cpu 同 path 合成
Backward compat：老 server 端 schema silent-drop unknown keys；agent / server 可独立升

接 RFC-014 — /api/server/:host/health 响应现在带 disk 三字段 + 24h 分桶 history 也含 disk_avail_min / disk_used_max；alert_level 加 disk < 1GB critical / < 5GB warn 触发（server/src/index.ts:253-258）。

测试团队 Docker Linux smoke 3/3 PASS（disk 299.8 GB total / 216 used / 71.5 avail，alert green，backward compat verified）。

Hero D — Dashboard 拓扑图前缀标签 UX Option C（dashboard `0.5.1`）

#147（5/16 ack）+ Option C 落地：

拓扑节点前缀标签（[节点 → group 边的 label distinguishability）实装 Option C 设计（Dashboard 团队 design pass）
disk telemetry hover card 渲染（disk_total_gb / disk_used_gb / disk_avail_gb 三字段对接 GET /api/server/:host/health 响应）
100+ 轮 typography + corner-radius cascade polish

Dashboard 团队 design pass + 4/4 verify（commit 7de97ee + screenshot evidence，local ship f9c83cd）。

Closed issues

#99 守护节点 Phase 2 close gate met（host metrics 闭环 final 10%，Hero A disk ship）
#147 Hero D（5/16 ack 后 Option C 落地）

RFC artifacts preserved（v0.12.0 scope）

本轮 v0.10.2 是 hotfix scope（不含 v0.11.0 系列 RFC ship），3 个 RFC artifact 保留进 v0.12.0 candidate：

RFC-013 v5 rename hot-reload（third-pass review 整改完）
RFC-014 v2 daemon Phase 2 host metrics（v0.10.2 Hero A 已 ship final 10%）
RFC-015 v2 #114 token usage UI（first-pass REVISION 完）

Upgrade

bash

anet upgrade                                     # 升 agent-node 2.4.0 → 2.4.1 + dashboard 0.5.0 → 0.5.1
anet project restart                             # 重启项目（拉新 agent-node + dashboard）

Migration / Breaking

No breaking changes —— disk 字段是 additive (HostTelemetry interface 扩 3 字段，server schema silent-drop unknown keys backward compat)；agent / server 可独立升级，老 agent 不带字段时 SQL NULL → dashboard 渲染 — 不误导

发布流程沿用 v0.9.0 split-brain lessons #126 的两 phase publish SOP。

v0.10.1 — Hotfix: PINNED_SERVER_VERSION 跟 v0.10.0 ship chain-bump（2026-05-17）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.2.1
@sleep2agi/agent-node@2.4.0 (无变化)
@sleep2agi/commhub-server@0.8.2 (无变化)
@sleep2agi/agent-network-dashboard@0.5.0 (无变化)

Fix

agent-network/bin/cli.ts:61 PINNED_SERVER_VERSION 跨 v0.9.x + v0.10.0 promote 漏 bump，仍 hardcode 0.8.0 —— anet hub start 实际 bunx --bun @sleep2agi/commhub-server@0.8.0 启服务（cli.ts:2589），跑的是老 server 不是 v0.10.0 ship 的 0.8.2。直接影响：

#99 守护节点 endpoint family GET /api/server/:host/health + GET /api/server/:host/agents 在 0.8.0 不存在 → 404
#142 server schema align process_telemetry 字段在 0.8.0 没接 → 老 schema silent-drop 字段
dashboard 0.5.0 §3.F server-health ring tint 数据源失败 / §3.E hover card process_telemetry 字段全 null

v0.10.0 announced functionality regression in default-path anet hub start workflow（手动 bunx --bun @sleep2agi/commhub-server@latest 不受影响）。

修复（commit 4d24024）：

diff

- const PINNED_SERVER_VERSION = "0.8.0";
+ const PINNED_SERVER_VERSION = "0.8.2";

Upgrade

bash

anet upgrade                                     # 升 agent-network 2.2.0 → 2.2.1
anet project restart                             # 重启项目（拉新 commhub-server）

或 fresh install：

bash

npm install -g @sleep2agi/agent-network@latest

Lessons

release-gate playbook 加 case —— 每次 promote latest 时 PINNED_*_VERSION（server pin / dashboard pin / agent-node pin）必跟 chain-bump，否则默认路径仍跑老 ship。跟 #80 PINNED bump SOP 一致但 Hero 4 release-gate playbook 当时漏覆盖；本 hotfix 后已加 case (见 lesson memory)。

发布流程沿用 v0.9.0 split-brain lessons #126 的两 phase publish SOP。

v0.10.0 — Direct Runtime + Observability Foundations（2026-05-16）✅ stable（Phase 1，3 包 promote）

版本同步（npm latest tag，Phase 1）：

@sleep2agi/agent-network@2.2.0
@sleep2agi/agent-node@2.4.0
@sleep2agi/commhub-server@0.8.2
@sleep2agi/agent-network-dashboard@0.5.0 ✅ Phase 2 ship

主题：治本

v0.7 → v0.9.2 累积 11 release、5 P0 chain（#135-#139）暴露 runtime 架构债。v0.10.0 治本 —— runtime 架构债（codex-sdk wrapper bypass，opt-in）+ observability 基础（守护节点 endpoint + per-agent process telemetry）+ release-gate playbook。为 v0.11.0 多厂商 AI Agent 社会 24/7 直播打地基。详见 v0.10.0 release tracker #140。

5 features

A. #141 codex app-server stdio direct（opt-in ANET_CODEX_STDIO_DIRECT=1） 之前 codex runtime 走 @openai/codex-sdk npm wrapper，wrapper 的 --mcp-config HTTP transport bug 是 #102 hang root cause family。v0.10.0 新增直 spawn('codex', ['app-server']) + 最小 stdio JSON-RPC client (~155 LOC) 路径，bypass wrapper 整个绕过这 family bug，同时拿到完整 67-method v2 protocol surface（thread / turn / item / realtime 等），不再受 codex-sdk breaking change 牵制。v0.10.0 默认仍是 wrapper 路径（先收 preview 反馈），显式 ANET_CODEX_STDIO_DIRECT=1 开启直 stdio；v0.11.0 计划 default flip。

B. #99 守护节点 Phase 1 scaffold（监测 only） 新增 server-side endpoint family（commit e575cc6）：

GET /api/server/:host/health — host CPU / mem / disk / process 健康
GET /api/server/:host/agents — agent list per host + telemetry 历史

dashboard 集成留 Phase 2（#119 ServersDrawer 整合）。控制层（kill / restart / redeploy）defer 到 v0.11.0。

C. #142 Per-agent process telemetry agent-node 每次 commhub_report_status 心跳带上 process_telemetry：rss / cpu_pct / uptime_seconds / in_flight_count。零 sysmon 依赖、零特权。commhub-server schema 端对齐（commit 209cac7），dashboard 渲染 hover card Phase 2（#119 sibling）。跟 #119 host fields 是 sibling 关系（host step 1 ✅ 之前 ship，agent step 2 本 release ship）。

D. Dashboard 网络节点前端展示升级（Hero 3 — 8/8 surface complete，dashboard 0.5.0）

§3.A prefix-group fix（Vincent #1 catch）
§3.B sweep retire（旧 sweep 路径并入 grid）
§3.C recent-panel hide
§3.D grid default view
§3.E hover detail card
§3.F server-health ring tint（接 #99 endpoint）
§3.G fullscreen mode
§3.I canvas brand mark
(§3.H 砍 per RFC Q2 review)

随包附 19+ 轮 typography + 圆角级联 polish（4 typography family + corner radius cascade 系统化重整）。dashboard 0.5.0 已通过 npm latest tag promote，跟随 v0.10.0 Phase 2 docs sync 落地。

E. 发布前轻量级测试 playbook（release-gate Phase 1+2）docs/tests/release-gate-playbook.md — 测试团队 lead 维护，覆盖 hub / dashboard / login / node lifecycle / runtime smoke / vendor verify 等关键路径。本次 v0.10.0 ship 是首次完整跑通该 playbook 的 release，为后续每次 latest promote 卡 release-gate。

Breaking changes / Migration

codex runtime 默认行为不变：仍走 @openai/codex-sdk wrapper；要切直 stdio 必须显式 ANET_CODEX_STDIO_DIRECT=1。ANET_CODEX_LEGACY_SDK=1 之前 preview chain 的 fallback 命名在 latest 改成 opt-in ANET_CODEX_STDIO_DIRECT=1 反向开关，含义更直接。
agent-node commhub_report_status payload 加 process_telemetry 子对象：commhub-server 0.8.2 schema 已对齐；老 server 版本（≤ 0.8.1）会忽略未知字段不会 fail。
/api/server/:host/health + /api/server/:host/agents 是新 endpoint：rate limit / auth 行为跟现有 /api/servers 同（admin or self-network member），不破坏现有 client。

Known follow-ups

~~Phase 2 dashboard 0.5.0 promote~~ ✅ 已 ship（dashboard 0.5.0 跟随 v0.10.0 Phase 2 docs sync 落地，8/8 Hero 3 surface complete + 19+ 轮 polish）
#102 / #103 hang 关闭凭证（codex direct stdio 路径回归 #102 hang 场景 verify）—— preview chain 内 Phase 1.5 已规划，待 latest opt-in 路径回归 verify 完成关闭。
Sessions NETWORK 列显示 bug（Vincent catch）—— defer 到 v0.10.x patch 或 v0.11.0。
#117 anet project up detached tmux follow-up（macOS bun setRawMode 已 #136 修，但 detached 模式 follow-up 仍欠）—— v0.11.0 配套 control 层一起做。

发布流程沿用 v0.9.0 split-brain lessons #126 的两 phase publish SOP：先 --tag preview 上传 tarball + curl verify HTTP 200，再 npm dist-tag add @<v> latest。Phase 1 三包（agent-network / agent-node / commhub-server）clean semver promote 完成；dashboard Phase 2 待 §3.D/F/G ship。

v0.9.2 — Patch: Auth fast-fail + Fan-out retry + Wizard 重做 + #122 default-tmux 回退（2026-05-16）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.1.15
@sleep2agi/agent-node@2.3.10
@sleep2agi/commhub-server@0.8.1 (无变化)
@sleep2agi/agent-network-dashboard@0.4.6 (无变化)

发布流程沿用 v0.9.0 split-brain lessons (#126) 的两 phase publish SOP（先 --tag preview 上传 tarball + curl verify HTTP 200，再 npm dist-tag add @<v> latest）避免 npm publish --tag latest 直推路径在 CDN 异步窗口内的 split-brain；版本号本身用 clean semver（无 -preview.N 后缀，便于 anet upgrade 比较 + npm range 选择）。

5 P0 fix chain

1. #129 Vendor API auth 快速失败 + vendor-specific URL hint（9840cf3）起因：intern key 过期时 agent-node 之前默默等 120s 才报「claude-agent-sdk 调用超时」通用错误。现在 isAuthError(msg) 启发式正则覆盖 Anthropic 标准（401/403、invalid_api_key、authentication_error）+ intern A02xx 系列（user_token_expired）+ 通用 OpenAI-compat 401 envelope（unauthorized / expired_token），命中后短路 retry loop（用同一个坏 key 重试只是浪费 backoff window）并按 ANTHROPIC_BASE_URL 域名 print vendor-specific URL hint（intern → chat.intern-ai.org.cn、minimax → platform.minimaxi.com、anthropic → console.anthropic.com、其他 → generic）。从 v0.9.1 之前的 15min 缩到 <5s 拿到具体修复 URL。详见 troubleshooting → Vendor API auth 失败。

2. #132 Tier 1 Fan-out timeout + retry-with-backoff（同 commit 9840cf3） SDK concurrency investigation Phase 3：30-agent papercope fan-out demo 下 intern API per-request latency 拉到 17-37s（10-20× 单 agent 1.57s 基线），老 120s timeout 中途 abort 让 25/30 子 agent 静默 fail。两件事：

CLAUDE_TIMEOUT_MS default 120000 → 300000（300s，给 intern queue drain 留 buffer）
新 CLAUDE_MAX_RETRIES env var，default 2（共 3 attempts）；transient error / timeout backoff 4s, 8s + 0-1s jitter（jitter 散开 herd retries 防一窝蜂打 vendor queue）；auth-class 错误不 retry（接 #129 fast-fail）

设 CLAUDE_MAX_RETRIES=0 退回 v0.9.1 no-retry 行为。

3. #133 anet node create runtime-first wizard（29fd290） Vincent catch：老 vendor-first selector 只 enum claude-agent-sdk vendors（intern / MiniMax / Claude / GLM / ...），用 claude-code-cli (Anthropic Max plan + 本地 claude CLI 登录态) 或 codex-sdk (OpenAI codex auth login) 的用户implicitly stuck —— 必须知道传 --runtime codex-sdk 才能 skip vendor picker。新 flow：

selectRuntime() 3-way picker: claude-agent-sdk / claude-code-cli / codex-sdk
claude-agent-sdk → 继续走 selectVendorAndModel() (existing flow)
claude-code-cli → print claude auth login hint, skip vendor
codex-sdk → print codex auth login hint, skip vendor

backward-compat：显式 --runtime <X> 仍 skip picker；demo / batch / 已 --env 注入 credential 的 scripted 调用路径不变。

4. #136 回退 v0.9.0 #122 默认 detached tmux（a3a3fd4）起因：detached tmux + bun claude-code-cli 调 setRawMode 在 macOS 触发 errno 5 (EIO) —— detached child 的 stdio 不是 real PTY。回退 v0.9.0 短暂引入的 4 条件 wrap 矩阵：

anet node start <alias> → 默认前台（修 macOS bug）
anet node start <alias> --tmux → tmux new -As <alias> attached 模式（PTY chain 保持完整不再触发 setRawMode bug）

移除 --foreground / --no-tmux / --attach flag（默认就是 foreground，--tmux 自带 attach）。anet project up 内部 startNodeTmuxSession 路径仍是 detached（在 macOS bun 下可能 re-trigger setRawMode，跟进 follow-up 待）。

5. Wizard 静默退出修复链 #135 / #138 / #139

#135 Node v24 top-level await warning (fa08eb4 v3)：dispatch 包进 async main() 解决 root cause
#138 @inquirer/prompts + readline ask() stdin mismatch (b8c5885 preview.5 + 596cfe9 preview.6)：wizard select() 之后 silent exit 修复 + launchAgent await child before parent exit
#139 dispatch add await to 5 async commands (15cf6de preview.7)

跟 #133 runtime-first wizard 配合：让交互式 wizard 在 Node v24 环境跑得稳。

6 SOP 升级

两 phase publish SOP 沿用（v0.9.0 split-brain lessons #126）—— 避免 npm --tag latest 直推
macOS PTY 边界 case 进入 release smoke checklist（detached tmux + setRawMode）
fan-out / 高并发 timeout 调参文档化：troubleshooting Vendor API 超时段 + agent-node.md env table
runtime-first wizard 区分 anet create vs --batch：batch wizard 仍 vendor-first（用 selectVendorAndModel() 但不走 selectRuntime()），doc 显式消歧
CLAUDE_MAX_RETRIES=0 opt-out：保留退回 v0.9.1 行为路径供调试 / 跑老脚本
vendor-specific remediation hint 路由进入设计原则：每加一个 verified vendor 都附 URL hint

Breaking changes / Migration

⚠ anet node start 默认行为再变（v0.9.0 → v0.9.1 短暂 detached → v0.9.2 回退前台）：脚本/CI 上 v0.9.1 加的 --foreground / --no-tmux flag v0.9.2 已移除（默认前台无需 flag）；想 tmux 用 --tmux opt-in attached 模式
⚠ anet node create interactive 行为变（vendor-first → runtime-first）：scripted --runtime <X> 仍 skip picker，没有 backward-compat 问题；交互用户体验改善（3 runtime 平等可选）
⚠ CLAUDE_TIMEOUT_MS 默认从 120 → 300：之前显式覆盖到更短超时的脚本不受影响；fan-out 场景默认更宽容
✅ 新 CLAUDE_MAX_RETRIES env var：默认 2（共 3 attempts）。设 0 退回 v0.9.1 no-retry 行为

v0.9.1 — Patch: #130 intern tool-calling hotfix promote（2026-05-15）✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.1.14 （只升 version 字段，无源码变更；让 anet upgrade 看到 v0.9.1 line 跟 agent-node 2.3.9 + dashboard 配套）
@sleep2agi/agent-node@2.3.9 （promote #130 hotfix to latest）
@sleep2agi/commhub-server@0.8.1 (无变化)
@sleep2agi/agent-network-dashboard@0.4.6 (无变化)

修复

#130 intern-s2-preview tool calling 真打通（commit 4cd0024 ＋双 phase publish promote）—— v0.9.0 时 intern-s2-preview 在 Anthropic 协议 tool_choice: "auto" 下默认走 verbose Thinking Process 不发 tool_use content blocks，强制 tool_choice 又被 -20077 拒。Hotfix：检测到 ANTHROPIC_BASE_URL 命中 intern-ai.org.cn / chat.intern-ai 时，prepend 一段短 system-prompt bias 让 model 直接发 tool_use。curl A/B verified：stop_reason: max_tokens → tool_use，output_tokens: 1024 → 122。详见 Vendor 适配层（含 5 副作用 + opt-out 路径）。

已知 gap 提醒（不阻 promote）

vendor adapter detection 用 URL regex 检测 vendor —— 自部署 lmdeploy / 走 proxy / 走 aggregator 的 intern endpoint 不命中 bias，需要手动 --prompt 复制 bias。详见 Vendor 适配层 ⚠ 5 副作用。
--no-vendor-bias flag 未实现（P1 polish gap，跟 bias_active info display follow-up 一起规划）。

发布流程

per v0.9.0 split-brain 教训（issue #126）：两 phase publish 路径

1. version bump → preview.N+1
2. npm publish --tag preview     → tarball uploaded
3. curl tarball URL               → HTTP 200 确认
4. npm dist-tag add @<pkg>@<v> latest
5. npm view dist-tags.latest      → "<v>" verified

避开 npm publish --tag latest 直推路径的 split-brain（CDN 异步同步窗口里 latest tag 指向但 tarball 还没分发）。

v0.9.0 — Recovery & Observability（2026-05-15）✅ stable

@sleep2agi/agent-network@2.1.13
@sleep2agi/agent-node@2.3.8
@sleep2agi/commhub-server@0.8.1
@sleep2agi/agent-network-dashboard@0.4.6

🎯 主题：Recovery & Observability

22 节点 reboot 后的零键盘恢复闭环 + 默认 toolset 行为透明化 + 服务器级聚合观测。

新功能 — Recovery 链

anet project up / restart / down（issue #117）— cwd-wide 节点编排，扫 .anet/nodes/ 全起 / 全重启 / 全停。共享选项 --stagger <秒>（默认 3 错峰）/ --only a,b,c / --exclude x,y。down 给 hub-offline 通知设 2s race timeout 防 hub 自挂场景拖死命令。
anet node create --resume <id> / --resume-latest（issue #115）— 创建节点时直接绑定已有 Claude session；TTY 模式下交互式 picker 列 ~/.claude/projects/<cwd>/*.jsonl（age / size / 60-char 首行预览）。anet session ls 用同一份 listClaudeSessions() helper。
零键盘恢复机制（#115）— anet node start spawn claude 时自动注入 CLAUDE_CODE_RESUME_THRESHOLD_MINUTES=999999999，跳过 Claude Code 默认 70min session-age 阈值的「Resume from summary / full / Don't ask again」交互弹窗；per-spawn 注入、不污染 ~/.claude/settings.json、用户显式 export 覆盖；resume 还原完整 session（restart-recovery 不带意外 compaction）。
anet node start 默认 detached tmux（issue #122，⚠ v0.9.2 已回退见 #136）— v0.9.0 短暂引入 4 条件 wrap 矩阵（TTY + $TMUX 未设 + 装了 tmux + 同名 session 不存在）+ --foreground / --no-tmux / --attach flag + 两层递归保护。v0.9.2 回退：macOS bun 在 detached tmux 下触发 setRawMode errno 5（detached child stdio 不是 real PTY），新机制改成默认前台 + --tmux opt-in attached 模式（保留 PTY chain）。anet node stop 联动 tmux kill-session 先于 SIGTERM 仍然保留。
anet upgrade 4-包 + 双通道 + dry-run + self（issue #88）— 覆盖 anet self / agent-node / commhub-server / dashboard。Channel auto-detect（prerelease tag → preview，否则 latest）+ --channel 覆盖。--dry-run 只 print plan。--self opt-in detached spawn（默认 print 手动命令避免升级时替换运行进程）。Plan 行带 action badge：upgrade / up-to-date / lazy via npx skip / self skip / lookup failed。commhub-server 行恒显 PINNED_SERVER_VERSION = 0.8.0 提醒 anet hub start 跑 pinned 不跟全局走。
anet.sh install / upgrade scripts 同步（issue #123）— anet.sh 一键脚本与 npm 双通道对齐 + Node 22.13 engine 校验。

新功能 — Runtime 默认行为透明化

claude-agent-sdk 默认 Claude Code preset 全集（issue #101 Option B）— 修了 root cause：config.json 无 tools 字段时 agent-node 设 SDK options.tools = undefined → agent 零内建工具 → 幻觉「网络受限」。改成 fallback 到 SDK { type: 'preset', preset: 'claude_code' } sentinel，agent 默认获得 WebFetch / WebSearch / Bash / Read / Write / Edit / Glob / Grep / Task / NotebookEdit 等。--tools "all" 路由到同一 preset（去硬编码 8-tool 列表）。
行为披露 banner（#101 Vincent push）— anet node create 成功后 print built-in tools + MCP tools + dangerouslySkipPermissions=true 警示 + restrict-tools / disable-auto-skip / inspect-current-set hint。anet info <alias> 显示 tools: + flags: 行供随时审计。
anet ls -v / --verbose（同 #101 配套）— 每节点多打一行 tools=... permGate=on/off。

新功能 — Security hardening

Vendor token envRef 模式（issue #125，v0.9.0 P0 gate #2）— config.json env map 接受 tagged union：string（legacy，仍兼容，print 一次性 deprecation banner）或 { "_envRef": "VAR_NAME" }（推荐，secret 留 process.env 永不落盘）。agent-node unset envRef 时启动直接 FATAL exit + remediation hint，refuse silent broken。
anet node create 自动 envRef rewrite — saveCreatedNode 前跑 rewritePlainSecretsToEnvRef()：secret 识别启发式（key 后缀 /_TOKEN|_KEY|_SECRET|AUTH$/ 或 value 前缀 /sk-|utok_|ntok_|atok_|ak-|gsk_|key-|Bearer/）任一命中就翻 envRef，原值塞当前 process.env（spawn 立即可用）+ print export NAME='value' 让用户抄进 ~/.bashrc。
anet node migrate-token-to-envref <alias> — 新命令，已有节点一键迁。备份原文件到 config.json.bak-<ts>，rewrite + print export 行；idempotent（非 secret + 已 envRef 不动）。
anet doctor enumerate plain-secret 节点 — passive 扫描 + 提示走 migrate 命令（不自动 --fix，per-node opt-in）。

新功能 — Observability

GET /api/servers REST endpoint（issue #119，server 11a3018）— 按 hostname + ip 聚合 agent + host 实时遥测，dashboard「服务器侧栏」用。返回裸 JSON array（非 {ok, ...} wrapper）。先 10min stale 标 offline 再聚合；addNetworkScope 网络作用域。字段：hostname / ip / agent_count / cpu_load_1min / cpu_cores / mem_avail_gb / mem_used_gb / last_seen。
agent-node host telemetry（#119 step 1，5364931）— 每次 report_status 附带 host 字段。Linux /proc/loadavg + /proc/meminfo MemAvailable 优先；macOS/Win 兜底 os.loadavg() / os.totalmem() / os.freemem()；Windows [0,0,0] 主动 coerce null；10s cache 阻断 burst。
Dashboard ServersDrawer（#119 step 3）— Web UI 侧栏展示按物理机聚合的 agent count + CPU / RAM 实时条。
Dashboard 拓扑图重做 + 38 轮持续 polish（issue #112 + #116）— grid / ring 双视图 + mount fade-in + hover ring focus + click ripple + label scale + arrow tier + offline dim + group-box hover + minimap + cwd tooltip 等 9+ 轮交互细化。

文档

GitHub README 门面级优化（issue #118，commit 2dd646d）— Hero / Quick start / Demo / CTA 提前；anet vs LangGraph/AutoGen/CrewAI 5×4 对比表；信任信号 4-badge + Star History chart；mermaid 架构图 + 节点接入流程；ZH + EN 双语同步。
docs-site catch-up sweep（issue #124）— 把今日 ship 的所有新功能批量同步到 anet.sh：cli.md / upgrade.md / security.md / rest.md / CHANGELOG.md 全部 ZH + EN。

Breaking changes / Migration

⚠ anet node start 默认行为变化（v0.9.0 only，v0.9.2 已回退） — 从 v0.9.0 起短暂默认 wrap 进 detached tmux（v0.8 是前台跑），但 v0.9.2 via #136 回退到前台默认（macOS bun setRawMode bug）。脚本/CI 用 v0.9.1 时仍需 --foreground / --no-tmux，v0.9.2+ 已默认前台无需 flag；想 tmux 走 --tmux opt-in attached 模式。
⚠ claude-agent-sdk 节点默认 toolset 变化 — 从空集变成 Claude Code preset 全集（含 Bash / WebFetch / Write 等）。已有节点显式 tools 列表保留原行为。新节点请确认是否需要 --tools Read,Glob,Grep 显式收窄。
⚠ vendor secret 不再落 config.json 明文 — 新建节点自动走 envRef；已有明文节点跑 anet node migrate-token-to-envref <alias> 一键迁，过渡期 plain string 仍兼容（deprecation banner 提醒）。
✅ Preview 版本号规则（Vincent push）— preview chain 内升 -preview.N+1 后缀，不升 patch 重置 preview.0，避免版本号「倒退看起来像 downgrade」。

Smoke validation 必跑（promote 前）

1. plain fallback           — 旧 config 含 "sk-..." 仍能启动 + 显示 deprecation banner
2. envRef happy path        — { _envRef: "TEST_TOKEN" } + export TEST_TOKEN=fake → 节点拿到正确 token
3. envRef missing var FATAL — #2 不 export → 启动 FATAL + remediation hint
4. anet doctor 扫描         — 混合 plain + envRef 节点 → 只 plain 入 warning
5. migrate 幂等            — plain → migrate → 再跑无 op + `.bak-<ts>` 存在 + export 行打印
6. anet node create 自动    — `--env ANTHROPIC_AUTH_TOKEN=sk-fake` → config.json 是 envRef，不是字面 sk-fake

详见 issue #125 完整可复现步骤。

2026-05-14 — v0.8.3 正式版 batch primitive + 多 demo + P0/UX 修复 ✅ stable

版本同步（npm latest tag）：

@sleep2agi/agent-network@2.1.9
@sleep2agi/agent-node@2.3.1
@sleep2agi/commhub-server@0.8.0 (无变化)
@sleep2agi/agent-network-dashboard@0.4.5

注：agent-network 2.1.8 因早先 stale build 占位跳过，正式版为 2.1.9。

新功能

anet create --batch 批量 agent 原语（issue #55）— 一行起 N 个带身份的 agent，--prefix 自动编号，每节点独立工作目录 + config + tmux session；配套 anet batch <verb> 统一管 lifecycle（list/stop/cleanup/start/restart）。
anet demo sci-team（issue #51）— 科研军团 demo：1 leader + N-1 worker 主动 fan-out 协作。
anet demo pr-review（issue #41）— 4-agent PR review room demo。
anet login 首次登录引导（issue #58）— 认证失败时给出 register / 默认账号 / hub admin reset-user 指引。
claude-agent-sdk 模型 dropdown 增加 verified vendor presets（issue #48）— MiniMax + 书生 Intern。
SDK 升级 — codex-sdk / claude-agent-sdk / inquirer 依赖升级。

修复

batch 节点身份注入（issue #93，P0）— batch 创建的节点之前不知道自己的 alias；现在 per-node 注入身份前缀。
anet hub dashboard npx 缓存自愈（issue #89，P0）— spawn 前自动清理 stale staging dir。
anet hub dashboard release channel 匹配（issue #61）— dashboard 版本号改为按 anet channel 动态匹配。
anet init token prompt UX + session 计数（issue #56）。
进程 spawn 移除 shell（issue #36）— 消除 command injection 面。
claude-agent-sdk env 注入 + timeout guard（issue #98，部分修复）— config.json env 块在 --config 启动路径正确注入；claude 调用加 wall-clock timeout guard，hang 变可见超时错误。
PINNED commhub-server → 0.8.0 stable。

包变更明细

agent-network 2.1.7 → 2.1.9（13 个 preview 迭代累积）
agent-node 2.3.0 → 2.3.1 — claude-agent-sdk / codex-sdk 依赖升级 + #98 修复
commhub-server 0.8.0 (无变化)
agent-network-dashboard 0.4.2 → 0.4.5 — 三环 layout / alias 头像 / 全屏 zoom / 前缀分组 / 书生头像 / 标签遮挡修复 / trial badge 删除

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.1	2026-03 初	基础 CommHub + SSE
v0.3	2026-03 中	agent-node 双引擎
v0.5	2026-03 末	anet CLI + Channel
v0.7	2026-04 初	Dashboard + 消息类型
v0.9	2026-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）

下一步

升级指南 — v0.7 → v0.8 行为变化 + 标准步骤
架构概览 — 各版本是怎么累积成现在这套系统的
GitHub Releases — 每个 git tag 的 release notes
RFC-001 — v0.8 ~ v1.0 master token 废弃路线图

更新日志 ​

v0.10.13 — grok-build-acp session/prompt 300s timeout 卡死修复（P0 hotfix）（2026-06-08）✅ stable ​

🌟 Highlights ​

grok-build-acp 节点 hang 至 session/prompt timed out after 300000ms 根因 + 修复 ​

🐛 Bugs Fixed ​

📦 Install（全新安装） ​

🔄 Upgrade（老用户升级） ​

🙏 Credits ​

v0.10.12 — Grok-build runtime 场景化能力 + 0.2.8 alpha 回归验证（2026-05-30）✅ stable ​

主要内容 ​

📦 Install / 🔄 Upgrade ​

v0.10.11 — #204 grok-build-acp 节点身份隔离 + #194 commhub broadcast 归属 hotfix（2026-05-28）✅ stable ​

🌟 Highlights ​

#204 — grok-build-acp per-node isolated cwd ​

#194 — commhub broadcast 发送者归属 hotfix ​

🐛 Bugs Fixed ​

📦 Install（全新安装） ​

🔄 Upgrade（老用户升级） ​

🙏 Credits ​

v0.10.10 — 小米 MiMo 5 模型完整支持 + envRef wizard-to-start 自动衔接（2026-05-27）✅ stable ​

P0 — 小米 MiMo Vendor Preset 完整 ​

P0 — envRef wizard-to-start 自动衔接（#193） ​

Bug fixes ​

Known Issues ​

v0.10.9 — Dashboard 图片发送 + CommHub 附件元数据 + codex-sdk 图片输入（2026-05-25）✅ stable ​

P0 — Dashboard 指挥链路支持发送图片 ​

Rollout + Smoke ​

Known Limits ​

v0.10.8 — Dashboard Servers 面板 UI 文案修 + TopoGraph density tier polish（2026-05-17）✅ stable ​

Fix — #157 Dashboard Servers 面板 UI 文案修正（Root cause #1） ​

Polish fold-in — TopoGraph density tier（纯 additive） ​

Quality gates + lessons ​

发布统计 — v0.10.8 ​

v0.10.7 — codex-sdk batch path yolo flags parity（2026-05-17）✅ stable ​

Fix — #156 codex-sdk batch path yolo flags parity ​

用户影响 ​

Quality gates + lessons ​

发布统计 — v0.10.7 ​

v0.10.6 — anet upgrade Option B detached spawn + anet create --batch wizard silent-exit 修（2026-05-17）✅ stable ​

Fixes ​

Quality gates + lessons ​

发布统计 — v0.10.6 ​

v0.10.5 — anet create --batch wizard 双修（2026-05-17）✅ stable ​

Fixes ​

v0.10.4 — anet upgrade UX 警告 + Dashboard orphan-band 布局（2026-05-17）✅ stable ​

Fixes ​

v0.10.3 — codex-sdk default model gpt-5.5 + yolo flags 可见（2026-05-17）✅ stable ​

Fixes ​

v0.10.2 — Hero A disk telemetry + Hero D 拓扑图标签 UX（2026-05-17）✅ stable ​

Hero A — agent-node disk telemetry（#99 守护节点 Phase 2 host metrics 闭环 final 10%） ​

Hero D — Dashboard 拓扑图前缀标签 UX Option C（dashboard 0.5.1） ​

Closed issues ​

RFC artifacts preserved（v0.12.0 scope） ​

Upgrade ​

Migration / Breaking ​

v0.10.1 — Hotfix: PINNED_SERVER_VERSION 跟 v0.10.0 ship chain-bump（2026-05-17）✅ stable ​

Fix ​

Upgrade ​

Lessons ​

v0.10.0 — Direct Runtime + Observability Foundations（2026-05-16）✅ stable（Phase 1，3 包 promote） ​

5 features ​

Breaking changes / Migration ​

Known follow-ups ​

v0.9.2 — Patch: Auth fast-fail + Fan-out retry + Wizard 重做 + #122 default-tmux 回退（2026-05-16）✅ stable ​

5 P0 fix chain ​

6 SOP 升级 ​

Breaking changes / Migration ​

v0.9.1 — Patch: #130 intern tool-calling hotfix promote（2026-05-15）✅ stable ​

修复 ​

已知 gap 提醒（不阻 promote） ​

发布流程 ​

v0.9.0 — Recovery & Observability（2026-05-15）✅ stable ​

🎯 主题：Recovery & Observability ​

新功能 — Recovery 链 ​

新功能 — Runtime 默认行为透明化 ​

新功能 — Security hardening ​

新功能 — Observability ​

文档 ​

Breaking changes / Migration ​

Smoke validation 必跑（promote 前） ​

更新日志

v0.10.13 — grok-build-acp `session/prompt` 300s timeout 卡死修复（P0 hotfix）（2026-06-08）✅ stable

🌟 Highlights

`grok-build-acp` 节点 hang 至 `session/prompt timed out after 300000ms` 根因 + 修复

🐛 Bugs Fixed

📦 Install（全新安装）

🔄 Upgrade（老用户升级）

🙏 Credits

v0.10.12 — Grok-build runtime 场景化能力 + 0.2.8 alpha 回归验证（2026-05-30）✅ stable

主要内容

📦 Install / 🔄 Upgrade

v0.10.11 — #204 grok-build-acp 节点身份隔离 + #194 commhub broadcast 归属 hotfix（2026-05-28）✅ stable

🌟 Highlights

#204 — grok-build-acp per-node isolated cwd

#194 — commhub broadcast 发送者归属 hotfix

🐛 Bugs Fixed

📦 Install（全新安装）

🔄 Upgrade（老用户升级）

🙏 Credits

v0.10.10 — 小米 MiMo 5 模型完整支持 + envRef wizard-to-start 自动衔接（2026-05-27）✅ stable

P0 — 小米 MiMo Vendor Preset 完整

P0 — envRef wizard-to-start 自动衔接（#193）

Bug fixes

Known Issues

v0.10.9 — Dashboard 图片发送 + CommHub 附件元数据 + codex-sdk 图片输入（2026-05-25）✅ stable

P0 — Dashboard 指挥链路支持发送图片

Rollout + Smoke

Known Limits

v0.10.8 — Dashboard Servers 面板 UI 文案修 + TopoGraph density tier polish（2026-05-17）✅ stable

Fix — #157 Dashboard Servers 面板 UI 文案修正（Root cause #1）

Polish fold-in — TopoGraph density tier（纯 additive）

Quality gates + lessons

发布统计 — v0.10.8

v0.10.7 — codex-sdk batch path yolo flags parity（2026-05-17）✅ stable

Fix — #156 codex-sdk batch path yolo flags parity

用户影响

Quality gates + lessons

发布统计 — v0.10.7

v0.10.6 — `anet upgrade` Option B detached spawn + `anet create --batch` wizard silent-exit 修（2026-05-17）✅ stable

Fixes

Quality gates + lessons

发布统计 — v0.10.6

v0.10.5 — `anet create --batch` wizard 双修（2026-05-17）✅ stable

Fixes

v0.10.4 — `anet upgrade` UX 警告 + Dashboard orphan-band 布局（2026-05-17）✅ stable

Fixes

v0.10.3 — codex-sdk default model gpt-5.5 + yolo flags 可见（2026-05-17）✅ stable

Fixes

v0.10.2 — Hero A disk telemetry + Hero D 拓扑图标签 UX（2026-05-17）✅ stable

Hero A — agent-node disk telemetry（#99 守护节点 Phase 2 host metrics 闭环 final 10%）

Hero D — Dashboard 拓扑图前缀标签 UX Option C（dashboard `0.5.1`）

Closed issues

RFC artifacts preserved（v0.12.0 scope）

Upgrade

Migration / Breaking

v0.10.1 — Hotfix: PINNED_SERVER_VERSION 跟 v0.10.0 ship chain-bump（2026-05-17）✅ stable

Fix

Upgrade

Lessons

v0.10.0 — Direct Runtime + Observability Foundations（2026-05-16）✅ stable（Phase 1，3 包 promote）

5 features

Breaking changes / Migration

Known follow-ups

v0.9.2 — Patch: Auth fast-fail + Fan-out retry + Wizard 重做 + #122 default-tmux 回退（2026-05-16）✅ stable

5 P0 fix chain

6 SOP 升级

Breaking changes / Migration

v0.9.1 — Patch: #130 intern tool-calling hotfix promote（2026-05-15）✅ stable

修复

已知 gap 提醒（不阻 promote）

发布流程

v0.9.0 — Recovery & Observability（2026-05-15）✅ stable

🎯 主题：Recovery & Observability

新功能 — Recovery 链

新功能 — Runtime 默认行为透明化

新功能 — Security hardening

新功能 — Observability

文档

Breaking changes / Migration

Smoke validation 必跑（promote 前）