AgentTeams Dashboard v1.2.5：68 个 commit，把「自己更新自己」做进去了

原创

Nil2024
Nil2024

鸿渐在路上

2026年9月30日 20:07
江苏

在小说阅读器读本章

去阅读

在公众号小说中沉浸阅读

本期导读：v1.2.5 已于 2026-09-30 发布。从 v1.2.4.9 到 v1.2.5 共合入 68 个 commit、触及 167 个文件，其中 21 个功能与修复、6 个重构、5 个测试与 CI、17 篇文档、13 项工程与依赖治理。本文按这五类逐条展开，所有条目均取自 GitHub Compare API 与官方 CHANGELOG，未做删减与推测。

如果你在用 AgentTeams Dashboard，大概遇到过这些场景：想升级版本却只能改 compose 文件重新 docker pull；多实例部署时页面提示「有新版本」，刷新、无痕、清缓存都不管用；npm audit 挂着 8 个高危不敢动。

v1.2.5 把这三件事一次处理完，并且顺手把 README 的定位语改成了 Mission Control。

AgentTeams Dashboard 是 AgentTeams 的 Mission Control——基于 Next.js 16 + React 19 的操作台，让操作者实时督导多智能体团队：集群拓扑、带人工干预的任务看板、具备运行时感知渲染的 Matrix 聊天、RBAC 与审计治理，以及 AI 诊断助手。

项目地址：github.com/agentteams-group/agentteams-dashboard

一、版本速览

68 个 commit 的分布

167 个文件改在哪

超过六成改动落在组件层——这不是一次「加功能」的版本，是一次「让程序能自己更新自己」的版本。

二、21 个功能与修复

1. 应用内热补丁（本次最重）

完整链路（src/app/api/self-update/route.ts + src/lib/hotfix.ts）：

` POST /api/self-update → 从最新正式 Release 下载 dashboard-hotfix-\*.tar.gz → sha256 校验 → tar 解包完整性检查（server.js / BUILD\_ID） → 原子热替换应用目录（旧版本保留于 app.prev） → 进程三级强杀（SIGTERM → SIGKILL → exit） → 容器监管方拉起 `

三个设计约束：

• 无 docker socket、无旁路容器

——docker restart 策略与 k8s restartPolicy 行为一致
* 页面轮询服务器版本号变化后自动刷新（5 分钟超时）
* 安装器部署默认 --restart unless-stopped，保证进程退出后被拉起

这里有个值得记的演进。commit 历史里能看到一条完整的路线：

` feat(dashboard): container self-update via watchtower sidecar   ← 先用 watchtower feat(dashboard): in-app hot patch replaces watchtower sidecar    ← 自己的热补丁取代它 `

先用现成方案跑通，再换成自研。 watchtower 那一版被完整替换掉了。

2. 按钮式更新

设置面板新增「更新」tab（src/components/dashboard/settings/update-tab.tsx）：

配套：

• GET /api/dashboard-build

只读构建身份接口（buildId + version + builtAt，Cache-Control: no-store，免认证）
* chunk 加载失败自愈

——懒加载 chunk 被新部署清除时，会话内自动整页刷新一次
* feat(update): distinguish same-version rebuilds from real new versions

——版本号一致但构建号不同时，提示改为「同版本新构建，建议刷新同步」，只有真实版本差异才显示「发现新版本」

3. 任务看板切换修复

现象：从 chat 首次点击「任务看板」无响应，要点第二次。

根因（commit 410018a）：

useActiveSection() 初始解析 effect 随组件挂载重复执行，同 commit 同步挂载路径下把 store 回滚为旧 hash 值。

修法：改为模块级 once 标记，并附「remount 不回滚」回归测试。

顺带修的：chat 会话侧栏拖拽中途切换区块时 pointermove / pointerup 监听器泄漏——处理器入 ref，卸载统一移除。

4. Worker 环境编辑与网关校验

• feat: edit worker environment and verify saved gateway access

（出现两次，一次在 PR 合并前、一次在合并后）
* test(workers): gateway-probe route e2e cases

——补了端到端用例

验证从 UI 一直做到路由层。

5. MCP 可信目录

• feat(mcp): expose catalog servers + trusted-name helper

（B7 21.1 groundwork）
* feat(mcp): trusted-catalog default pre-check for new workers

新建 Worker 前先做可信目录预检——这是一个安全边界的收紧。

6. 会话回放

feat(replay): shareable sanitized session replays（D3 MVP）

可分享的、经过脱敏的会话回放。 与 v1.2.4.9 的「Matrix 聊天运行时感知渲染」是同一条线。

7. 存储回归测试与凭据回退

feat(storage): regression suite + installer RUSTFS_* credential fallback

安装器支持 RUSTFS_* 凭据回退——对象存储从 MinIO 向 RUSTFS 迁移的配套。

8. 运行时一致性清扫

feat(dashboard): runtime consistency sweep - cards, KB gating, capability doc（B2）

统一了卡片、知识库门控与能力文档。

9. 贡献者入口基线

feat(dashboard): contributor entry baseline - templates, gallery, dead link（D1）

模板、画廊与死链检查——这是给外部贡献者铺路。

10. 跨平台脚本

feat(scripts): cross-platform dev/build/start wrappers（A7）

11. 三条收尾修复

三、五个 beta 修了什么

这一节比功能列表更有信息量——它记录的是「热更新」这个功能自身被反复打磨的过程。

beta.5 的根因值得单说

同一次构建内 Turbopack 的 client / server worker 各自加载 next.config，时间戳构建号被求值两次——页面内联 A、服务端文件 B，永久分裂。

修法是构建号确定化（src/lib/build-id.ts），三级回退：

` DASHBOARD\_BUILD\_ID env  →  git short sha  →  .next/.build-id-lock（10 分钟锁文件） `

CI 镜像经 --build-arg DASHBOARD_BUILD_ID=${VERSION} 注入，镜像构建号即版本号。

同时把升级语义从构建号门控切成版本号门控——同版本不同构建号视为「已是最新」，只有真实版本差异才提示升级。

四、6 个重构：把五个大组件拆开

每个拆分都配了一篇 wiki 同步（docs 下 5 篇 docs(wiki) commit）——拆完立刻把架构文档跟上，这是纪律。

还有一条更硬的：清除 any

` refactor(types): eliminate all explicit any from non-test source   (A6.2) chore(types): restore no-explicit-any as error, enable noImplicitAny (A6.3) `

把 any 从「允许」改回「报错」。 对应 chore(lint): clear the eslint baseline to zero warnings（A6.1）——告警基线清零。

五、5 个测试与 CI 门禁

docs: ... add consistency gate to CI（A4）把文档一致性检查也做成了 CI 门禁——README 里的说法过时就会挂。

六、13 项工程与依赖治理

依赖高危 8 → 0

一批 caret-range 补丁升级（A9）：

• three 0.185.1 → 0.186.1
• @a2ui 0.10 → 0.12（含 API 迁移）
• lucide-react 0.525.0 → 1.48.0（跨大版本）
• recharts 3.8.1 → 3.10.1
• vitest 4.1 → 5.0.2（含 coverage-v8、显式 vite 7）

两个明确不修的漏洞

官方对利用面的判断是「二者仅解析自有可信 S3 后端响应，利用面受限」，且 audit 建议的 [email protected] 降级是破坏性变更、与对象存储迁移方向冲突，不采纳。

运行时与其他

七、17 篇文档：其中 4 篇是新增规范

还有两篇定位向的：

• docs(readme): Mission Control positioning + demo placeholders

（D2）——README 全面改写，并留了三张待录制截图的占位（overview 拓扑 / 任务看板 HITL / Chat 回放），录制清单在 docs/images/README.md
* docs(readme): MCP governance story + lint:tone baseline to zero

（D4）

官方给的 Mission Control 定位语（docs/release-notes-mission-control-draft.md，中英双语）：

全景可视——集群拓扑、Worker/Team 健康、Matrix 房间动态与基础设施状态，一屏尽览。 随处干预——带人工介入（HITL）审批的任务看板：确认卡出现在工作发生的地方。 看懂智能体——Matrix 聊天按运行时渲染流式过程，历史会话完整回放。 更快诊断——问天助手把日志、会话与消息汇成一份 AI 诊断报告。 默认治理——RBAC 分级、追加式审计日志、PII 脱敏的调试日志包。

部署侧也补齐了：docs(deploy): compose + coolify 模板、兼容原则（D5+D6）。

八、从 v1.2.4.9 升级，注意这几点

九、质量与验证

• 全部变更经 CI（Lint, Typecheck & Test）合入
• 本地 tsc / eslint / vitest 全量验证
• eslint 告警基线清零

、非测试源码零 explicit any
* 文档一致性检查进 CI
* 新增 docs/RELEASE.md 发版规范与 scripts/build-hotfix-bundle.sh（tar.gz + sha256 随 Release 分发）

结语

v1.2.4.9 把聊天、知识库、任务看板、模型网关、安全审计拧成了一条完整动线。v1.2.5 补上的最后一块是「版本自己会更新自己」——从检查、下载、校验、热替换到进程拉起，全链路在控制台内完成，不碰 docker socket，也不依赖旁路容器。

而五个 beta 修掉的三个问题——进程退出被吞、缓存层穿透、构建号永久分裂——恰好说明「让程序自己更新」这件事比看上去难得多。官方的处理方式值得学：先上 watchtower 跑通链路，再换成自研热补丁；每个 beta 的坑都写进 Release 说明，构建号自检直接进发版规范。

同一批 commit 里还有另一条线：清除 any、eslint 归零、文档一致性进 CI、安全模块补测试覆盖。这些不是功能，是让项目能撑住后续版本的地基。

项目地址：github.com/agentteams-group/agentteams-dashboard

全部版本标签：github.com/agentteams-group/agentteams-dashboard/tags

上游运行时：github.com/agentscope-ai/AgentTeams

如果你在用 AgentTeams Dashboard，从 beta.1 以来的用户可以直接用 设置 → 更新 → 检查更新 → 热更新 原地升级，不必改 compose 文件。欢迎在仓库提 Issue / PR 反馈问题与想法。