本地优先的多代理协作办公室,AI 角色团队自主构建共享知识库,推送驱动持续执行任务,永不丢失上下文。
WUPHF 是一个面向 AI 代理团队的协作运行时,将多个角色化代理(CEO、PM、工程师、设计师等)置于统一的"虚拟办公室"中。核心架构基于推送驱动的消息总线(Broker),代理在收到消息时才被唤醒,空闲成本为零。每个代理在隔离的 git worktree 中运行,每轮使用全新会话并通过 Anthropic prompt cache 实现 ~97% 命中率,相比累积式编排器减少约 7 倍 token 消耗。
知识管理方面,每个代理拥有独立 Notebook 记录原始上下文与临时结论,并可自主将验证过的内容提升到团队共享 Wiki。Wiki 的默认 markdown 后端基于本地 git 仓库构建知识图谱,支持三元组事实存储、/lookup 引用检索和 /lint 矛盾检测。系统支持 Claude Code、Codex CLI、OpenClaw 及本地 LLM(通过 OpenCode)四种执行后端,同一频道内可混用不同 provider 的代理。MCP 工具表面按代理角色和协作模式动态裁剪,进一步优化 prompt 大小与缓存效率。
项目采用 Go 为主语言,提供单二进制文件分发,跨平台运行(macOS/Linux/Windows),内置 Web UI 和可选 tmux TUI。通过 Telegram Bridge 可实现双向消息桥接,Skills 生态支持从公共市场发布和安装代理技能。全部数据本地存储,无 SaaS 依赖,用户自带 API key。
核心特性#
- 多代理协作:内置 CEO、PM、ENG、DSG、CMO、CRO 等角色代理,支持 Collaborative Mode(广播式)和 Focus Mode(CEO 路由委托),代理间可 @mention 通信
- 知识管理:Notebook(代理私有)→ Wiki(团队共享)的两级知识体系,markdown 后端支持知识图谱、三元组事实、矛盾检测
- LLM 运行时:多 provider 支持,全新会话策略 + prompt cache,按角色/模式动态裁剪 MCP 工具表面,实测 ~87k 输入/轮
- 协作与共享:
wuphf share通过 Tailscale/WireGuard 私有网络邀请联合创始人,Skills 生态对接 Anthropic marketplace、Lobehub 等 - 外部集成:Telegram Bridge 双向桥接、OpenClaw Bridge、Composio 云托管 OAuth
安装与使用#
npx wuphf # 推荐
npm install -g wuphf && wuphf # 全局安装
go build -o wuphf ./cmd/wuphf # 源码构建
可选团队包:founding-team、coding-team、starter、lead-gen-agency、revops
关键 CLI 命令#
| 命令 | 作用 |
|---|---|
wuphf init | 首次设置 |
wuphf share | 邀请联合创始人 |
wuphf --1o1 | 与 CEO 一对一对话 |
wuphf skills publish/install | 技能发布/安装 |
/connect | 连接 Telegram / OpenClaw |
/focus | 切换到 CEO 路由模式 |
架构概览#
Human → Web UI / TUI / 1:1 → Broker (pub/sub + queue) ← Nex / Telegram / Composio
│
push on message
▼
Per-agent headless runners
(Claude Code / Codex, fresh session per turn, scoped MCP)
│
▼
isolated git worktree per agent
三个关键设计决策:全新会话避免上下文膨胀、按角色裁剪 MCP 工具优化缓存、推送驱动 Broker 实现零空闲成本。当前版本 v0.108.1,pre-1.0 阶段,main 分支每日更新,采用 MIT 许可证。