VibeValley：本机多编码 Agent

18次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 vibevalley

30秒速读

VibeValley 是一个运行在本机的多编码 Agent 协作工具，定位是帮你一个人同时指挥多个编码 Agent 干活。你用语音或聊天向管家派活，系统给每个任务开独立分支和 worktree，Agent 在各自的分支里改代码，你审查提交、差异和测试结果之后再合并。它最适合已经在用 pi、Claude Code 或 Codex，并且手头经常同时并行好几件开发任务的 Apple 芯片 Mac 用户。先说清楚一条硬边界：帮工没有沙箱，也没有权限确认机制，可以在本机执行任意命令，所以只能把它用在你完全愿意交给 Agent 的项目里，不能当成隔离环境来用。

软件信息表

项目名称	VibeValley
一句话定位	本机多编码 Agent 协作农场
运行平台	Apple 芯片 macOS 为主，也可单独运行服务端并通过浏览器访问
支持的编码 Agent	通过 oar 统一驱动 pi、Claude Code、Codex 等
核心技术	服务端 TypeScript 与 Effect v4，数据存储 PGlite，前端 Solid 2，桌面版 Electron
并行能力	最多同时并行六项任务，每项独立分支和 worktree
构建要求	Bun 1.4 与 Node 24，至少一个已安装并已登录的编码 Agent，DeepSeek API 密钥
可选能力	Agora 语音、微信、飞书、QQ 外部派活连接器，各需单独凭据或机器人配置
数据目录	默认 ~/.vibevalley，可用 VIBEVALLEY_HOME 指定，服务端日志在该目录下的 logs/desktop-server.log
获取方式	GitHub 开源仓库，见文末直链按钮

上手指南

先确认环境：Apple 芯片 Mac，装好 Bun 1.4 与 Node 24，至少一个编码 Agent 已经安装并登录，DeepSeek API 密钥准备好。
从 GitHub 获取 VibeValley 仓库，按仓库文档完成构建或安装桌面版。应用没有签名，首次打开需要在 macOS 的隐私与安全性设置中手动放行。
启动后先接一个你熟悉的小项目，不要一上来就接生产代码库。服务端默认只监听 127.0.0.1，这个默认值不要动。
派第一个任务时说清楚验收标准，例如改哪几个文件、跑通哪条测试、输出格式是什么。任务描述越具体，Agent 返工越少。
等 Agent 提交后，先看轨迹里的命令与输出，再看差异与测试结果，最后才合并分支。合并前针对具体步骤评论并要求继续修改，是这个工具正常的工作流。
长任务不要一次派完，先用种植计划拆成有先后关系的步骤，每步检查通过后再推进计划分支。

装完先做这 5 项设置

限定工作目录：只把 Agent 放进你愿意交给它的项目，最好是分支副本或可丢弃的实验项目，不要直接对唯一一份生产代码开全权。
守住本机监听：服务端默认只监听 127.0.0.1，不要改成对外地址。需要远程访问时另外走你自己的安全通道，不要直接暴露这个服务。
先备份数据目录：升级前备份 ~/.vibevalley 或 VIBEVALLEY_HOME 指定的目录。概念、接口和存盘格式仍可能调整，升级后旧数据可能需要迁移。
预算与巡查先设阈值：预算提醒和定时巡查默认不要全开，先给小任务设一个预算上限，跑顺了再放开，避免一次巡查烧掉大量 API 调用。
语音与外部渠道默认关闭：Agora 语音、微信、飞书、QQ 派活都是可选能力，用到哪一项再配哪一项的凭据，不要一次性全接通。

注意事项与常见问题

问：没有沙箱到底意味着什么？意味着 Agent 在本机跑的命令和你本人跑的命令权限相当，删文件、改配置、调外部服务都可能发生。防范办法只有一个：工作目录、分支、备份三件套先做好，再派活。

问：首次打不开，提示未签名怎么办？这是已知情况，应用没有签名，需要在 macOS 的隐私与安全性设置中手动放行。放行前先确认下载来源就是 GitHub 官方仓库。

问：手机端能用吗？目前不行，公开说明是手机版正在更换壳，暂时不可用。现阶段只按桌面与浏览器访问来规划。

问：升级后旧数据会丢吗？不一定会丢，但存盘格式可能迁移。升级前备份数据目录，升级后先跑一个旧项目验证，再投入新任务。

问：六个任务并行会不会互相干扰？每项任务有独立分支和 worktree，代码层面是隔离的，但它们共享同一台本机、同一批 API 密钥和同一个你。并行数量先从两到三项起步，跑顺了再加。

明确取舍：适合谁，不适合谁

适合：已经在用 pi、Claude Code 或 Codex 的开发者；经常同时推进多个小改动、修多个缺陷，需要统一派活与统一审查的人；愿意自己管理 API 密钥、工作目录和分支合并流程的小团队。

不适合：需要沙箱隔离或细粒度权限审批的团队；主要在 Windows 或 Linux 上开发、没有 Apple 芯片 Mac 的用户；要求长期兼容承诺、稳定移动端或完善商业支持的正式项目；不能接受存盘格式未来迁移的用户。

深度：一个真实使用场景推演

假设你周五下午同时有三件事：给官网修一个表单校验缺陷、给内部工具加一个导出按钮、把一段重复代码抽成公共函数。没有协作工具的做法是三个终端窗口来回切，改到一半很容易把改动混进同一个分支。换成 VibeValley 的做法是这样：先派三项任务，每项自动落在独立分支和 worktree 里。修缺陷那项先立一个失败的验收测试，测试变绿才算完成；导出按钮那项要求先贴出接口返回示例再动手；抽公共函数那项要求列出所有调用点再改。三个 Agent 并行跑的时候，你在轨迹里逐条看命令与输出，发现导出按钮那项把日期格式写错了，直接针对那一步评论要求重改，不用等它全部跑完再返工。最后三项分别审查差异与测试结果，逐项合并，任何一项出问题都不会污染另外两项。这个流程的价值不在 Agent 写代码有多快，而在分支隔离加人工确认合并，让并行真正可控。反过来，如果你只有一个任务、改动很小，直接在编辑器里让 Agent 改反而更快，不必为它专门搭一套协作流程。

前往 GitHub 查看 VibeValley

GitHub 国内访问较慢，如打不开可多刷新几次

推广