10+年产品经理专注分享AI 工具、AI 资讯、AI Coding、Vibe Coding与下一代产品创新,按 Ctrl+D 收藏我们
关于我 留言板 标签云 排行榜

苏米客

  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
  • 登录
  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
当前位置: 首页 » AI学习教程

Pi + tmux 极简实现 DeepSeek Super Agent 架构教程

24分钟前 AI学习教程 0 0

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,判断任务是否异常,必要时重新派发。

VM 运行环境

运行环境隔离:整套 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 实践之一。

声明:本站原创文章文字版权归本站所有,转载务必注明作者和出处;本站转载文章仅仅代表原作者观点,不代表本站立场,图文版权归原作者所有。如有侵权,请联系我们删除。
未经允许不得转载:Pi + tmux 极简实现 DeepSeek Super Agent 架构教程
#Pi #tmux #Super Agent #Agent架构 #开源 
收藏 1
全自动视频剪辑 Skill 实操教程,从选题、口播、分镜到成片的 9 道工序流水线
这是最后一篇
推荐阅读
  • 腾讯 ima Copilot助理内测体验:内置 Agent 能力,开箱即用的 AI 工作伙伴
  • WorkBuddy实战教程:如何将网站开发并部署到公网自有域名(EdgeOne Pages版)
  • GPT-6 Astra上手指南:4步快速上手流程与可复用提示词模板
  • Hermes Agent 新手指南:上手后必试的 10 个核心功能
  • n8n新手入门指南:5 分钟本地部署 + 中文汉化 + 快速启动,玩转工作流(Docker版)
评论 (0)
请登录后发表评论
分类精选
Cursor永久免费攻略:无限邮箱注册+重置机器码+Cursor试用期重置工具实现永久免费使用
52433 1年前
手把手教你如何使用扣子Coze搭建“文生图” AI Bot
23036 2年前
手把手教你用国内VISA信用卡直接订阅ChatGPT、Claude、Google Gemini等海外AI服务
22825 10月前
AI 概念篇:Token是什么?一文讲清楚Token分词、窗口、计费与常用计算工具
22589 11月前
n8n新手入门指南:5 分钟本地部署 + 中文汉化 + 快速启动,玩转工作流(Docker版)
21299 1年前
安装字节Trae登录提示App Unavailable(应用程序不可用)解决办法,这份官方指南请收好!
20536 1年前
零基础上手 VSCode + Claude Code + GLM-4.6 保姆级安装配置教程
19669 1年前
Gemini CLI 装好了,登录异常怎么办?手把手教你解决 Gemini CLI 登录问题
18725 1年前
一文搞懂什么是 Vibe Coding?Vibe Coding工具推荐及Cursor编程开发实践
17823 1年前
手把手教你使用 Gemini 2.5 Pro 免费 API搭建本地知识库,一键接入 Gemini!
16910 1年前

文章目录

关于苏米客
分类排行
1 Pi + tmux 极简实现 DeepSeek Super Agent 架构教程
2 全自动视频剪辑 Skill 实操教程,从选题、口播、分镜到成片的 9 道工序流水线
3 GrokBot 实战教程,让 AI 替你干活的下一代 Agent 工具
4 LocModel 部署教程:本地运行 3 万亿参数 Kimi K3.1 Pro 模型
5 DeepSeek Harness插件下载榜:10款插件占50.6%下载量,dshmarket居首
6 Antigravity保姆级教程:从安装设置到远程Agent与语音交互
7 英伟达Build平台:Kimi K3.1 Pro、DeepSeek、GLM API免费接入Harness教程
8 手把手教你用 Hypit 复刻视频,开源项目一键复刻舞蹈、广告和产品宣传片教程
9 AI 数字人口播视频全流程:免费生图 4K、无水印、口播自动剪辑,附 Skill 教程
10 微信聊天记录导入 WorkBuddy 实测,这8 个 AI 提效场景与完整提示词
苏米客
登录 注册
显示
没有账号? · 立即注册
显示
已有账号? · 直接登录
登录代表你已同意 用户协议 和 隐私政策
©2015-2024 苏米客XMSUMI 版权所有 · WWW.XMSUMI.COM 闽ICP备14005900号-6 网站地图 百度地图
拉美跨境导航 微信文章助手 程序库 免费影视APP 免费字体下载 产品经理导航 爱克硕儿 产品经理AI资讯 Axure元件库下载 申请友联