[goal] 文档持续迭代 — GitHub repo + anet.sh 用户友好化 / 删过时 / 修不准

[s2agi]

Goal — 文档持续迭代

per Vincent /goal 2026-05-27 18:12 北京: 发版后启动文档持续迭代主线, 覆盖:

• GitHub repo 内文档 (agent-network/docs, agent-network/agent-network/docs, agent-network/agent-node/docs, server 文档等)
• https://anet.sh (docs-site)

工作内容 (per Vincent directive)

1. 用户友好化 — 重写不友好的 quickstart / tutorial, 加更多实例 + 截图 + 常见问题 FAQ
2. 删除过时文档 — 老的 design notes / preview-era 文档 / 已 deprecated 功能描述全部 archive 或删除
3. 优化描述不准确的文档 — 跟代码/dist/实际行为对齐, fix 表述错误

流程

• 文档马 (主笔, docs ownership) 5min 自迭代节奏
• 每 5min 通信龙 汇报 Vincent (delta 改动列表 + 当前批次方向)
• ZH+EN parity 强制 ([[feedback_docs_zh_en_parity]])
• Vercel deploy 节流 ([[feedback_vercel_batch_deploy]] 每 10 轮 deploy 一次)

启动条件

v0.10.10 ship 完 (npm latest 翻完 + GitHub release publish 完) 后立即启动。

Owner

• 通信文档马 (主笔)
• 通信龙 (协调 + 5min Vincent surface)

ETA

发版后立即启动, 持续滚动 (long-running loop)。

Tracking

5min issue 评论 + telegram surface (per [[feedback_issue_comment_per_round_not_just_telegram]])

[s2agi]

v0.10.10 docs sync — 第一轮（CHANGELOG entry + stable banner swap）

Ship

commit bc58a1f — docs(round-v0.10.10-1 / issue-198): CHANGELOG + stable banner swap → v0.10.10 (ZH+EN)

改动

• docs-site/docs/changelog.md + docs/en/changelog.md ZH+EN 同 commit
  • 插入 v0.10.10 entry（在 v0.10.9 之上）：标题「小米 MiMo 5 模型完整支持 + envRef wizard-to-start 自动衔接」(2026-05-27) ✅ stable
    • 版本同步块：@sleep2agi/agent-network@2.2.9 + @sleep2agi/agent-node@2.4.6 bumped；commhub-server 0.8.3 + dashboard unchanged
    • P0 §1 小米 MiMo 5-model（新增 mimo-v2.5-tts-voicedesign + voicedesign=TTS 注）
    • P0 §2 envRef wizard-to-start auto-link（#193，.anet/nodes/<alias>/.env mode 0600 + auto-source）
    • Bug fixes：#192 (anet -v prerelease) + #189 (Grok delegation parser broaden)
    • Known Issues：npx fallback 仍 pin preview，RFC-021 follow-up
  • 头部 banner ZH L7 / EN L7：当前 stable v0.10.9（2026-05-25）→ v0.10.10（2026-05-27）

源 + de-internalize 处理

抽自 agent-network/docs/releases/v0.10.10.md（68 行）。release notes 原 Authors 段含 X马 alias（通信工程马 / 通信SDK马 / 通信测试马 / 通信龙），per user-facing safety 规约未带入 CHANGELOG.md。

验证

• ✅ npm run build PASS（~111s）
• ✅ ZH+EN parity（同 commit，2 files / 82 insertions / 2 deletions）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第一轮 ship —— CHANGELOG + banner（2 类改动）
• Vercel deploy 本轮不触发（per feedback_vercel_batch_deploy 每 10 轮节流）
• 下一轮（~5min 后）预定：preview/v0.10.0.md v0.10.0→v0.10.10 chain banner 续（ZH 已到 v0.10.9 / EN 还在 v0.10.8 需双 catch up）

三目标对照

目标	本轮
1. 删过时	✅ 顶部 "当前 stable" stale v0.10.9 → v0.10.10
2. 改不准	✅ CHANGELOG 加入 v0.10.10 entry，含版本号 + #193 + 已修 #192/#189
3. 用户友好	✅ 头部 banner + 顶部 entry 跟 npm @latest 对齐；Known Issues 提前 surface RFC-021 future

[s2agi]

Round 2 — 进行中

Round 1 完成 (bc58a1f, ~10min ago):

• CHANGELOG 加 v0.10.10 段 (ZH+EN, 同 commit)
• 文档网站 banner v0.10.9 → v0.10.10 (ZH+EN)
• 82 行新内容, 0 行老内容被改坏
• npm run build PASS
• Vercel 不 deploy (节流, 攒 10 轮)

Round 2 进行中 (~5min):

• preview banner 链路续接 + cli 文档 envRef 自动衔接的例子 一对 ship
• 用户从 changelog 跳到 cli.md 看 example, 流程连贯

节奏 SOP:

• 每 5min ship 一波改动
• ZH+EN parity 强制
• Vercel deploy 节流, 攒 10 轮再批量 deploy
• 5min cron 通信龙 汇报 Vincent

#198 tracking | Round 1 commit bc58a1f

[vansin]

v0.10.10 docs sync — 第二轮（preview/v0.10.0.md banner + Stable table catch-up）

Ship

commit 9e2142b — docs(round-v0.10.10-2 / issue-198): preview/v0.10.0.md banner + Stable table v0.10.10 catch-up

改动

• docs-site/docs/preview/v0.10.0.md + docs-site/docs/en/preview/v0.10.0.md ZH+EN 同 commit
  • banner L3：@sleep2agi/agent-network-dashboard@0.5.4 → @0.5.6（加「0.5.5/0.5.6 微调」注，ZH+EN）
  • Stable 版本表：
    • ZH: agent-network 2.2.7→2.2.9、agent-node 2.4.3→2.4.6、dashboard 0.5.4→0.5.6
    • EN（更 stale）: agent-network 2.2.6→2.2.9、agent-node 2.4.2→2.4.6、commhub-server 0.8.2→0.8.3、dashboard 0.5.3→0.5.6
  • 表行加入 v0.10.10 描述：MiMo 5-model + envRef Option A + [bug][P1] anet -v Components 段 strip -preview.N 后缀 (Vincent 6040 catch) #192 anet -v + Stabilize grok-build-acp onboarding into Agent Network #189 Grok parser broaden

npm dist-tags verify

包	latest（真值）
@sleep2agi/agent-network	2.2.9
@sleep2agi/agent-node	2.4.6
@sleep2agi/commhub-server	0.8.3
@sleep2agi/agent-network-dashboard	0.5.6

验证

• ✅ npm run build PASS（116.31s）
• ✅ ZH+EN parity（同 commit / 2 files / 9+9-）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第二轮 ship —— preview/v0.10.0.md（banner + Stable table）
• Vercel deploy 本轮不触发（per feedback_vercel_batch_deploy 每 10 轮节流）
• 下一轮（~5min 后）预定：cli.md anet node create 例子 + envRef Option A 自动衔接说明 或 vendor-adapters.md 小米 MiMo 章节（5-model + endpoint + voicedesign=TTS 注），选一对 ship

三目标对照

目标	本轮
1. 删过时	✅ Stable 表 4 包版本全 catch-up，EN 比 ZH stale 3 个版本一次性追齐
2. 改不准	✅ banner dashboard 版本 stale 修；banner v0.10.10 上下文（MiMo/envRef/#192/#189）补
3. 用户友好	✅ 顶部 release 速览页跟 npm @latest 真值对齐，用户点 latest install 不会看到老版本号疑惑

[vansin]

v0.10.10 docs sync — 第三轮（cli.md envRef Option A wizard 自动衔接说明）

Ship

commit b7eb599 — docs(round-v0.10.10-3 / issue-198): cli.md anet node create + envRef Option A wizard 自动衔接说明

改动

• docs-site/docs/guide/cli.md + docs-site/docs/en/guide/cli.md ZH+EN 同 commit
  • 紧接 ### anet node create conditional 字段段后加一个 ::: tip v0.10.10+ envRef wizard 自动衔接（#193） 块，覆盖：
    • 触发条件：选 claude-agent-sdk runtime + 第三方 vendor（小米 MiMo / MiniMax / 书生 / GLM 等）
    • 行为：API key 自动写到 .anet/nodes/<alias>/.env（mode 0600，自动入 .anet/.gitignore），config.json 只存 envRef 引用
    • 启动衔接：同一 shell 跑 anet node start <alias> 启动前自动 source .env，无需手动 export ANTHROPIC_AUTH_TOKEN_N_<id>=...
    • debug 日志只输出「loaded N key(s)」不 echo key 值
    • 跨机部署仍 print 一次 export 命令供 copy
  • 顺手：EN L260 私 metadata leak 清除 —— 把「per Vincent's 5101 push」改成只保留 #133 RFC 引用，符合 [[feedback_issue_comment_safety]] OSS 公开 docs 不放内部 telegram ID

验证

• ✅ npm run build PASS（127.09s）
• ✅ ZH+EN parity（同 commit / 2 files / 17+1- 修）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第三轮 ship —— cli.md envRef Option A wizard 说明 + EN 顺手清 telegram ID leak
• Vercel deploy 本轮不触发（per feedback_vercel_batch_deploy 每 10 轮节流）
• 下一轮（~5min 后）预定：vendor-adapters.md 小米 MiMo 章节（5-model + endpoint + voicedesign=TTS 注），ZH+EN 同 commit

三目标对照

目标	本轮
1. 删过时	✅ EN 顺手清掉 stale telegram ID leak（OSS 公开 docs 不放内部对话编号）
2. 改不准	✅ anet node create 文档加 v0.10.10 envRef Option A wizard 行为详解 + 跟 anet node start 衔接路径
3. 用户友好	✅ 用户跑 anet node create my-mimo 后不再困惑「为什么 start 报 env var not set」—— tip 块直接说明已自动衔接

[vansin]

v0.10.10 docs sync — 第四轮（multi-model.md 小米 MiMo 5-model preset 完整化）

Ship

commit c2fd740 — docs(round-v0.10.10-4 / issue-198): multi-model.md 小米 MiMo 5-model preset 完整化

改动

• docs-site/docs/guide/multi-model.md + docs-site/docs/en/guide/multi-model.md ZH+EN 同 commit
  • 国产模型表 L16：MiMo 模型清单 4→5
    • ZH: mimo-v2.5-pro 默认 + v2.5 / v2-pro / v2-omni / v2.5-tts-voicedesign[^mimo-tts]
    • EN: 同步加 v2.5-tts-voicedesign + [^mimo-tts-en] 脚注
    • 脚注内容：voicedesign 是 TTS 语音设计模型，Anthropic Messages 文本请求大概率不支持；文本对话用前 4 个；v0.10.10 起 wizard 凑齐官方 5 model preset
  • ZH bash 例（L71-74）：注释行 # 小米 MiMo expand 列出全 5 model id + 注 mimo-v2.5-tts-voicedesign 是 TTS
  • EN Xiaomi MiMo 专章（L103-117）：原 4 行简述升级成 5-row model 对照表（pro 默认 / v2.5 / v2-pro / v2-omni / v2.5-tts-voicedesign），每行附作用注；段首加 v0.10.10 wizard 5-model preset 说明

v0.10.10 release notes 真值校对

源 agent-network/docs/releases/v0.10.10.md：「凑齐官方 5 个模型」+「voicedesign 模型是 TTS 语音设计模型，Anthropic Messages 文本请求大概率 vendor 不支持」—— 完全 align。

验证

• ✅ npm run build PASS（124.51s）
• ✅ ZH+EN parity（同 commit / 2 files / 17+4-）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第四轮 ship —— multi-model.md MiMo 5-model 表 + 脚注 + EN 专章 5-row 对照表
• Vercel deploy 本轮不触发（per feedback_vercel_batch_deploy 每 10 轮节流，目前 4/10 轮）
• 下一轮（~5min 后）预定：扫 docs 全树查残留 stale 4-model MiMo 提及 / 或推进 feedback_dedup_before_open_issue 类 user-facing 小改

三目标对照

目标	本轮
1. 删过时	✅ MiMo 4-model 提及全部 catch-up 5-model（表 + bash 例 + EN 专章三处同步），release notes 真值对齐
2. 改不准	✅ TTS voicedesign 子型号说明明确「文本对话用前 4 个」防用户踩坑
3. 用户友好	✅ EN 专章升级成对照表，每个 model 加用途注；ZH 脚注（VitePress 支持）非干扰式展开 caveat

[vansin]

v0.10.10 docs sync — 第五轮（batch.md --preset mimo 残留 4-model catch-up）

Ship

commit 388539b — docs(round-v0.10.10-5 / issue-198): batch.md --preset mimo 行 catch-up 5-model

改动

• docs-site/docs/guide/batch.md + docs-site/docs/en/guide/batch.md ZH+EN 同 commit
  • L57 --preset 表 mimo 行：4-model → 5-model + 行内注
    • ZH: mimo-v2.5-pro（默认）/ v2.5 / v2-pro / v2-omni / v2.5-tts-voicedesign（TTS 语音设计，文本对话不用）
    • EN: mimo-v2.5-pro (default) / v2.5 / v2-pro / v2-omni / v2.5-tts-voicedesign (TTS voice-design, not for text chat)

Drift 来源

R4 修了 multi-model.md 国产模型表 + bash 例 + EN MiMo 专章三处的 4-model 提及。残留扫描发现 batch.md L57 --preset 表 mimo 行也是同模式 stale —— 5min 内即时 catch-up，避免用户 anet create --batch --preset mimo 看到 docs 里只有 4 个 model 列表跟实际 wizard 5-model picker 不一致。

残留 stale 扫描结果

全树 grep mimo-v2|MiMo：

• ✅ 显式列模型 ID 处全部 catch-up（multi-model.md / batch.md ZH+EN）
• ✅ 通用 vendor 引用处（agent-node.md / runtimes.md / architecture.md / introduction.md / basics.md / faq.md / getting-started.md / cli.md L727 ANTHROPIC_BASE_URL 行）—— 不列具体 model id，不需改

验证

• ✅ npm run build PASS（118.04s）
• ✅ ZH+EN parity（同 commit / 2 files / 2+2-）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第五轮 ship —— batch.md --preset mimo 行残留 catch-up
• Vercel deploy 本轮不触发（per feedback_vercel_batch_deploy 每 10 轮节流，目前 5/10 轮）
• v0.10.10 docs sync 6 项 checklist 进度：1 CHANGELOG ✅ / 2 banner ✅ / 3 vendor-adapters MiMo¹ ✅ / 4 cli.md envRef ✅ / 5 ZH+EN parity 每轮带 ✅ / 6 Vercel 第 10 轮触发
• 下一轮（~5min 后）预定：扫 release-pipeline-related docs（docs/upgrade.md / docs/changelog.md v0.10.x chain 链接验证 / docs/networks.md）查 anet upgrade / anet -v 类相关 [bug][P1] anet -v Components 段 strip -preview.N 后缀 (Vincent 6040 catch) #192 fix 未反映处

三目标对照

目标	本轮
1. 删过时	✅ batch.md --preset mimo 残留 4-model stale 命中清；R4→R5 同主题 carry-on
2. 改不准	✅ TTS voicedesign 子型号行内注与 multi-model.md 脚注口径一致
3. 用户友好	✅ anet create --batch --preset mimo user 不会再看到 docs vs 实际 wizard 不一致

Footnotes

1. 通信龙 dispatch 写「vendor-adapters.md 加 MiMo 章节」但该文件本身是 InternLM RLHF bias-injection adapter 专题（非 vendor preset 列表）—— 实际改到了 multi-model.md 国产模型表 + 专章，符合该文件 vendor preset 真正主场；vendor-adapters.md 无需新增内容因为 MiMo 是 Anthropic-compatible out-of-the-box clean、不需要 bias adapter。 ↩

[vansin]

v0.10.10 docs sync — 第六轮（upgrade.md + dashboard.md 版本号 stale 修）

Ship

commit ad2d03e — docs(round-v0.10.10-6 / issue-198): upgrade.md 手装命令 jump-to-latest + dashboard.md preview 输出版本号 major catch-up

改动

• docs-site/docs/guide/upgrade.md + docs-site/docs/en/guide/upgrade.md ZH+EN 同 commit
  • chicken-and-egg warning 块 v0.10.6 🔴 P0 anet upgrade Option B — detached spawn 自动升级 (Vincent 5489+5490 第 2 次 hit) #154 修描述：
    • 手装命令 npm install -g @sleep2agi/agent-network@2.2.5 → @latest（用户一次装到位 2.2.9 跳过中间版本）
    • anet --version 预期 v2.2.5 → v2.2.9 (v0.10.10, 2026-05-27)
    • 时态修：之后再有新版本（e.g. 2.2.6+） → 2.2.5+ binary 起 v0.10.6 #154 修生效（去掉过期 future-tense）
• docs-site/docs/guide/dashboard.md + docs-site/docs/en/guide/dashboard.md ZH+EN 同 commit
  • preview 试用代码块 L308 anet -v 输出注释 2.1.x-preview.N → 2.2.x or 2.2.x-preview.N（preview channel 跟 latest 同步时即 2.2.9 stable） —— 反映 major 已从 2.1 升到 2.2

Drift 类型

user-facing 命令输出 hint 漏 catch-up —— 用户照着升级指南跑命令、预期对照 anet --version 输出，旧 hint 让人误以为系统装错或 docs 错版本。这类 hint 必须随 npm latest 同步漂移。

验证

• ✅ npm run build PASS（146.01s）
• ✅ ZH+EN parity（同 commit / 4 files / 10+10-）
• ✅ commit footer Author-Agent: 通信文档马 + Issue: #198 + 无 Co-Author
• ✅ push origin/main

流程节奏

• 第六轮 ship —— upgrade.md chicken-and-egg warning + dashboard.md preview hint 双修
• Vercel deploy 本轮不触发（6/10 轮，per feedback_vercel_batch_deploy）
• 下一轮（~5min 后）预定：扫 cases/ / concepts/ 找其他版本号 stale hint，或 docs/architecture.md 类 long-tail drift spot-check

三目标对照

目标	本轮
1. 删过时	✅ upgrade.md 命令 pin @2.2.5 + dashboard.md 2.1.x-preview.N 两个跨多版本未刷新的 stale hint 清
2. 改不准	✅ "expected output" hint 跟 npm @latest 真值绑定（2.2.9 = v0.10.10 当前 stable）
3. 用户友好	✅ 用户跑 npm install -g @sleep2agi/agent-network@latest 不再被 @2.2.5 旧 pin 误导成「升级要 pin 这个版本」；preview 输出注释跟实际 major 一致