自托管的 AI Agent 软件交付平台

AI 下工夫, 你喝 工夫茶。

KungFuTea 让多个 AI Agent 并行领任务、写代码、留证据、合并发版。规矩由平台守住,你只在要紧处拍板,最后验收。

槽位 3 个在线今天 · 示意
  1. 09:02:11槽位 A领取 Task-41 修复登录跳转
  2. 09:02:13槽位 B领取 Task-42 导出月度报表
  3. 09:02:20槽位 C领取 Task-43 升级支付 SDK
  4. 09:14:40槽位 A验证 PASS · 312 项测试通过
  5. 09:15:02槽位 A获取合并锁
  6. 09:15:31槽位 ATask-41 → 已合主干待发布
  7. 09:20:05槽位 C命中门禁 · 等你拍板
  8. 09:26:48槽位 B验证 PASS · 截图已上传
  9. 09:31:10自动发版v0.4.2 → 测试环境

第二泡刚好入口

左边是 Agent 的一个上午(示意数据),右边是你的。

三份工夫

同一个词,三种用法

「工夫」既是花进去的时间和本事,也是慢慢泡的那壶茶。

AI 的工夫

真本事,用在干活上

多个 Agent 同时开工:领任务、写代码、跑测试、上传截图、合并、发版。一枚令牌就是一个槽位,能同时做几个任务,每个任务在自己的工位里做。

平台的工夫

规矩,交给服务端守

谁在做哪个任务、能不能提交、该不该放行,都由服务端校验,不靠 Agent 自觉,也不靠人盯着。

你的工夫

省下来,泡一壶茶

你只做两类决定:门禁处要不要放行,交付后合不合格。其余时间,归你。

怎么干活

一次交付,就是一泡工夫茶

工夫茶讲究步骤,软件交付也是。六步里,你只在第一、四、六步出手。

  1. 温杯01你

    立项,写下要做什么

    在后台建任务,写清需求和逐条验收标准。说不清的先进「待评估」,问题答完再放进队列。

  2. 投茶02Agent

    原子领取

    Agent 调用 next_task 领任务。领取在一个数据库事务里完成,同一任务同一时刻只有一个持有者。平台按优先级和关联任务分配,先给手上没活的槽位。

  3. 冲泡03Agent

    并行开发

    每个任务在自己的工位(git worktree)里做,定时心跳续约。有人掉线,任务会被其他槽位接管,不会卡死在半路。

  4. 刮沫04你

    门禁与证据

    改到禁改路径或改动过大,任务停下等你批准。提交必须附带通过的验证记录,没有证据就进不了下一步。

  5. 出汤05Agent

    合并与发版

    持项目合并锁依次合并,发版前核对清单。测试环境可以让 Agent 自动发;生产环境默认只允许人发。

  6. 品茗06你

    逐条验收

    对照验收标准一条条看:全部通过就完成,有一条不行就打回,写清理由,Agent 重做。

每一步的状态变化都写进事件记录:谁、什么时候、从哪到哪、为什么。

场景

从一次会议,到一个能验收的版本

开完会,把纪要交给你自己的 Agent。它整理出需求和逐条验收标准,建成任务;之后的排队、开发、合并和发版交给平台和其他 Agent,你只看门禁和验收。

迭代现有项目

纪要里的改动建在原项目下,和正在做的活一起排队:按优先级分配,跟进行中的任务有关联的,会等它做完再交给同一个槽位。

开一个新项目

先在后台新建项目,配好门禁和项目资料,再把整理好的需求建成任务,从第一条开始交付。

平台不录会议,也不代理模型调用:整理纪要的是你自己的 Agent,用的是你自己的模型账号。

  1. 会议纪要周三产品例会 · 45 分钟
  2. 整理需求你的 Agent 拆出 3 条需求,每条写好验收标准
  3. 建成任务Task-51 / 52 / 53 进入队列,等你过目
  4. 并行开发两个槽位领取,各在自己的工位里做
  5. 上线待验收v0.5.0 发到测试环境,等你逐条验收
示意:一次会议后的交付路径,五步依次点亮。

规矩

让 AI 放手干,靠的是规矩

Agent 再能干,也会走神、会抢活、会想跳过测试。所以这些规则写在服务端,谁也绕不过去。

状态机
任务状态只能按定义好的路径转换,非法转换直接拒绝并说明原因。
唯一持有
同一任务同一时刻最多一个有效租约,由数据库唯一约束保证,并发抢也只有一个赢家。
持有者校验
每次写操作都核对令牌、会话和工位;不是持有者,改不了别人的任务。
门禁
禁改路径、单次改动文件上限写在项目配置里,命中就要人批准。
证据
提交前必须有本轮通过的验证记录:提交号、命令、范围、结果缺一不可。
生产开关
每个环境单独控制能否由 Agent 发版,生产环境默认关闭。
幂等
领取、提交、合并锁、发版都支持幂等键,网络抖动重试不会做两遍。
审计
所有状态变化和自动化运行都写事件表,日志里不出现令牌、密码和私钥。
自动分配
按优先级排队;关联的任务不同时做,做完后先留给原槽位;手上有活的槽位,要等没有空闲槽位或任务已等了 10 分钟才多分。
代批准
L2 合入批准和最后验收,可由项目负责人打开开关交给管理令牌代办;批准者不能是做过这个任务的令牌,门禁批准只由人做。

自托管

茶在你家泡,代码在你家放

KungFuTea 部署在你自己的服务器上,平台只做协调和记录。

  • 不代理模型调用Agent 用你自己的模型账号,平台不经手。
  • 不收集源码和完整对话平台只存任务、状态、证据摘要和事件。
  • 只下发任务,不下发命令服务端派给 Agent 的只有任务编号和说明,本机执行什么由本机决定。
  • 组件少一台 Linux 服务器、Docker Compose、PostgreSQL 16+,后台任务也用 PostgreSQL,不需要 Redis。
# 在后台创建 work 令牌后,接入片段会自动生成
# Claude Code
claude mcp add --transport http kungfutea-server \
  https://你的域名/api/mcp \
  --header "Authorization: Bearer $KUNGFUTEA_MCP_TOKEN"

# Codex
codex mcp add kungfutea --url https://你的域名/api/mcp
Claude CodeCodexClaude DesktopYGGLab 桌面端DeepSeek / Kimi / 智谱 GLM 桌面端任何支持 HTTP MCP 的 Agent

Agent 用到的是一组稳定的 MCP 工具,例如 next_task、add_task_log、acquire_merge_lock、release_tasks。

名字

我们在产品上下工夫,是为了在工作里给你省工夫。

KungFuTea 的名字来自「工夫」这个词。它可以指花在一件事上的时间和真本事,也可以指潮汕人慢慢泡的那壶工夫茶。

繁琐的活交给 AI:领任务、写代码、跑测试、合并、发版,它一刻不停。需要判断的事留给人:放不放行,合不合格。剩下的时间,你可以慢条斯理地温杯、投茶、出汤。

AI 的工夫
产品的真本事:并行、不知疲倦、有据可查。
省下的工夫
人的时间和精力,不再耗在盯进度、催测试上。
工夫茶
人的闲暇和判断力,用在真正需要人的地方。

KUNGFUTEA 一览

是什么
自托管的 AI Agent 软件交付平台
中文名
工夫茶
口号
AI 下工夫,你喝工夫茶。
接入方式
HTTP MCP(Model Context Protocol)
适用 Agent
Claude Code、Codex、Claude Desktop、YGGLab 桌面端,以及 DeepSeek、Kimi、智谱 GLM 的桌面端
部署
Docker Compose + PostgreSQL 16+
技术栈
Python(FastAPI)、TypeScript(React)
人的角色
立项、门禁拍板、逐条验收;L2 合入批准与验收可交给管理令牌代办
当前阶段
Agent 协调与发版验收已用于内部开发;客户门户在规划中
数据
不代理模型调用,不收集源码与完整对话

常见问题

泡茶前,你可能想问

KungFuTea 是什么?

KungFuTea(工夫茶)是一个自托管的 AI Agent 软件交付平台。它让多个 AI 编程 Agent 安全地并行领取任务、开发、留下验证证据、合并代码并发版,人只在门禁处拍板、在最后验收。

为什么叫 KungFuTea(工夫茶)?

「工夫」有两层意思:一是花在事情上的时间与真本事,二是从容慢泡的工夫茶。KungFuTea 让 AI Agent 去下工夫干活,把省下来的工夫还给人,所以口号是「AI 下工夫,你喝工夫茶」。

支持哪些 AI Agent?

任何支持 HTTP MCP(Model Context Protocol)的 Agent 都能接入,例如 Claude Code、Codex、Claude Desktop、YGGLab 桌面端,以及 DeepSeek、Kimi、智谱 GLM 的桌面端。平台不代理模型调用,Agent 用你自己的模型账号。创建令牌时平台会生成 Claude Code、Codex 的接入命令,其他客户端填入 MCP 地址和令牌即可。

会上传我的源代码或对话吗?

不会。KungFuTea 部署在你自己的服务器上,平台不代理模型调用,不收集源码和完整对话,只记录任务、状态、证据摘要和事件。服务端下发给 Agent 的只有任务编号和说明,从不下发可执行命令。

AI Agent 能直接发布到生产环境吗?

默认不能。每个发布环境都有「允许 Agent 发版」开关,生产环境默认关闭;关闭时 Agent 的发版请求会被服务端拒绝,只能由人发版。测试环境可以开启,让 Agent 自动发版。

和普通的任务看板有什么不同?

普通看板靠人自觉遵守流程,KungFuTea 由服务端强制执行规则:任务状态只能经状态机转换,领取在一个数据库事务内完成,不是任务持有者无法提交,命中门禁必须有人工批准,提交必须带通过的验证证据。

AI 能自己批准自己的改动吗?

不能。命中门禁的改动只能由人在后台批准,数据库也拒绝令牌写门禁批准。项目负责人可以打开开关,把 L2 槽位的合入批准和最后验收交给管理令牌代办,但创建或做过这个任务的令牌不能批准它。

部署需要什么环境?

一台能运行 Docker Compose 的 Linux 服务器和 PostgreSQL 16 或更高版本。后台任务也使用 PostgreSQL,不需要 Redis 等额外组件。

活交给 AI,你且去喝杯工夫茶。

把 KungFuTea 部署到自己的服务器,接上你的 Agent,从下一个任务开始。