VibeValley · 码农场物语

A team of coding agents you direct by voice or chat, drawn as a pixel farm. Runs on your own machine.

**VibeValley**（码农场物语）是一个用语音或打字指挥的编码 agent 团队，画成一座像素农场。

你只和**管家**说话。管家把活派给**帮工**，帮工是你机器上真实的编码 agent（pi、Claude Code、Codex……），在你的项目里开分支、改代码、跑测试、提交。地里的庄稼跟着它们的真实进度长：读代码时发芽，改文件时长叶，做完了结出麦子。你看过**收成清单**，才把它的分支合进主分支。

你、管家和帮工在同一个群聊**田头**里说话：每件活下面挂着一个工单串，帮工在里面确认、提问、汇报，你随时插话。说到底，VibeValley 是一个跑在本机的多 agent 协作工作区，外面包了一层游戏的壳。


[!WARNING] 帮工**没有权限确认、不开沙箱**，能在这台机器上执行任意命令。服务端只监听 `127.0.0.1`，不要把它暴露到网络上。只把你愿意交给编码 agent 的项目放进工作目录。

能做什么

• 派活和收获：对管家说「在 clock-in 里加一个查询打卡记录的接口，写测试」。管家挑一个合适的帮工，在项目里给它开独立的分支和 worktree。做完后你看提交、diff 和会不会冲突，确认了再合进主分支；冲突了让它自己解决。
• 同时干好几件活：最多 6 个帮工同时在地里干活，每人一个分支，互不干扰。
• 地图：每个项目是一座小岛，岛上的地是它的 worktree 和还能派活的空位，排队的活是院门外的种子袋；点空位就给这个项目写一张工单。
• 看得见过程：每个帮工的每一步都记成轨迹，包括收到的话、每条命令和输出、说的话。哪一步不对，可以就那一步写评论，它会接着改。
• 种植计划：长任务先派一个帮工读代码、拆成一张有先后的步骤图，你看过草稿再开工。互不依赖的步骤同时做，每一步过了检查才合进计划分支，最后一次收进主分支。修 bug 时第一步先写一个会失败的验收测试，后面的步骤不能改它，最后一步要让它通过。
• 频道、定时和巡查：按项目开频道；「每天九点跑一遍测试」这样的定时任务；不调模型的巡查，提醒没人回的提问、没动静的帮工、做完没收的活。
• 帮工档案和记性：给帮工捏人设、选农机和模型、装技能。帮工在汇报里写的「记住：……」，下次开工时会想起来。
• 语音：按住说话，语音管家（Agora Conversational AI）听你说完，交给同一个管家去派活。
• 从外面派活：把田头接到微信、飞书或 QQ，只认你自己的账号。手机或另一台电脑可以经「院门」连进来，前提是你在本机点过头。
• 管住花费：每个农机的额度、今天花了多少、每日预算；额度快用完时提醒，用完了就不再派。
• 农场本身：像素村有昼夜和光照，有狗、会在路上走的帮工、成就和称号，还有一部能玩小游戏的手机。


它是怎么工作的

flowchart LR
  you([你]) -- 打字 / 语音 --> app[Flutter 客户端
农场画面、田头、配置]
  app -- HTTP 命令 --> server
  server -- SSE：折好的核心状态 --> app
  subgraph server[Go 服务端 127.0.0.1:8787]
    foreman[管家
vibevalley 自己的 agent]
    chat[田头
SQLite]
    site[核心状态
只由事实改变]
    crew[帮工
smith]
  end
  foreman --> crew
  crew -- 会话事件 --> site
  crew --> rt[本机的农机
pi · Claude Code · Codex]
  rt --> repo[(你的项目
每个帮工一个 worktree)]

• 服务端（server/，Go，不用 cgo）：管家、帮工、田头、项目和收获、种植计划、语音、连接器都在这一个进程里。帮工由 [sm