DeepSeek 提出的 SuperAgent 把 Agent 拆成负责沟通调度的 Router 与负责执行的 Worker,配合事件触发、异步任务和外部监控,让工作从「等一条指令做一件事」变成「持续接收任务并推进」。本文介绍的是一套组件尽量少的极简实现:用 Pi、tmux、Telegram、cron 和 VM 搭出核心架构,把 Router、Worker、异步执行与 Watchdog 的协作跑通。

DeepSeek SuperAgent 的核心思路,是把持续交互、任务调度与并发执行分开,并围绕事件触发、任务上下文、状态管理和 Watchdog 构建更完整的系统。我们选的是更普通的工程组件,两者的对应关系如下:

这套方案落实的是几个基础动作:用一个常驻 Router 统一接收请求,把具体任务派发到独立 Worker,通过后台执行减少 Router 的阻塞,用定时事件监督长期任务,并把计划、日志和任务记录保存成文件。
整体架构
这套实现只用了六个通用组件:Pi 常驻为 Router,负责接收指令、理解任务与调度;tmux 提供持久化的终端 Session,承载 Pi、Gateway 和各个 Coding CLI Worker;Telegram 是远程入口,任务从 Bot 提交、结果从 Bot 返回;Coding CLI 执行具体开发任务(当前接入的是 pi-coding-agent 与 Opencode CLI);cron 周期性触发检查,提醒 Pi 核对各 Worker 的状态;整套系统跑在 VM 里,Workspace 指向宿主机共享目录,便于直接访问已有项目文件。

Pi 负责协调,Coding CLI 负责执行。收到任务后,Pi 把它派发到独立的 tmux Session 里后台运行,自身继续保持可交互。Pi 不必亲自完成每一次代码修改,长耗时的工具调用也就不会阻塞交互,不同任务的上下文不会混在一起。
关键组件
常驻 Router:Pi 是整套系统的控制入口,运行在一个持久化的 tmux Session 中。它接收来自 Telegram 的消息,借助 system prompt 与 Telegram mirror extension 把用户消息转成任务,再启动对应的 Coding CLI。Router 尽量不亲自承担具体的 Coding 工作,把执行交给独立 Worker,Router 才能始终轻量。
Worker 运行时:tmux 承担的是任务运行时。每个任务对应一个独立 Session,命名上就能区分角色。Coding CLI 启动后就在自己的 Session 里运行,执行输出通过 tee 落到 .tmp 目录下的任务日志。Router 不必等 Worker 结束,tmux ls 能随时列出运行中的任务,attach 到某个 Session 就能现场观察执行过程。
远程交互入口:Telegram Bot 提供远程入口。用户消息经 Telegram Bot API 到达 Gateway,Gateway 通过 WebSocket 转给 Pi Router;Pi 处理任务、派发 Worker,结果与状态再沿原路同步回 Telegram。
外部监督(Watchdog):用 cron 每 20 分钟执行一次检查脚本:脚本记录 tmux 状态快照、确认 Pi 是否正在处理请求,再通过 Gateway Webhook 向 Pi 注入一条检查提醒。Pi 收到提醒后逐个检查 Worker,判断任务是否异常,必要时重新派发。

运行环境隔离:整套 Agent 系统运行在 VM 中,Workspace 则映射到宿主机的共享目录。运行环境相对独立,便于安装工具、管理依赖和长期运行;Coding CLI 又能直接访问宿主机上的项目文件。VM 隔离的是运行环境,而不是文件,由于 Workspace 是共享目录,Worker 对它的读写仍会直接影响宿主机文件。
扩展方向
- 任务状态管理:当前主要依赖 tmux Session、日志文件和 Daily Task 文档判断。后续可以引入 SQLite 或其他轻量数据库建立 Task Registry,状态查询、异常恢复与每日汇总由此建立在结构化数据之上。
- 工作区隔离:可以为每个任务创建独立的 Git Worktree,在 Workspace 下分出不同分支目录,减少并发任务之间的相互影响。
- 确定性检查前置:后续可以先由脚本做确定性检查(tmux Session 是否存在、Worker 进程是否退出、任务是否超时等),然后只把异常情况交给 Pi 做语义判断与恢复决策。
- 任务结果协议:Worker 完成任务后可以按照统一格式输出结果,包含 task_id、status、summary、changed_files 等字段,Router 据此统一汇总、通知用户。
当前实现保留了简单共享,后续可以借 Git Worktree 或任务级目录进一步隔离。这套方案为后续扩展留出了空间,是目前最精简的 Super Agent 实践之一。