Alpha 版本:macOS 未签名快照,功能与数据结构仍会变化。 v0.1.0-rc.5

在自己的电脑上,
用对话组一支
持久的 AI 队友。

Bot 有名字、职责和边界,可以私聊、进群、被 @ 点名、彼此交接。窗口、运行时、会话和共享工作区都在你的 Mac 上;模型端点和 MCP 工具由你接入。

本机运行 pnpm install && pnpm dev

往下滚动,看一遍完整流程

从空名册到交付 report.md,一次走完

右侧窗口会随着你的滚动自己操作起来。窗口是按应用当前实现重建的示意,每一步对应真实存在的功能,不是概念图。

设置就是向导:一个本机目录做共享工作区,再加至少一个 OpenAI 兼容端点。模型名单写清楚擅长领域、思考等级和价格,之后每开一轮由 agent 按任务挑模型和思考等级并留下一句理由,你不用每轮自选。

密钥只在这个输入框里填,不进聊天。

名字、职责、边界三格必填。头像按名字生成。保存后名册那一行多一个头像,和它的私聊随即打开。名册没有人数上限,也不含你。

名册是侧栏顶上那一行头像。

直接告诉 Coordinator 要谁。它用内置工具创建 Researcher 和 Writer、建好群「调研」,把三个人都拉进去。创建 Bot、建群、改配置,都是对话里的一句话。

Bot 可以创建 Bot、建群、改端点和 MCP。

你发一条不带 @ 的消息,在场的每个 Bot 各自决定下场还是旁观;旁观不进主转录。用 @ 点名则必须下场。应用不代你裁决谁说话,也没有轮数熔断。

参与判断:Researcher 下场,其余旁观。

Researcher 想加一个 MCP 服务器来抓网页。新增 MCP、新建端点、工作区外读写和出站网络都要你放行;新增 MCP 这一类不能 Always allow。已配好的工具调用则直接执行。

允许一次或拒绝。密钥不进转录。

Researcher 整理完把 @Writer 写进消息,Writer 被叫醒接着干。本轮写出的工作区文件自动挂在回复上,没有另一套产物库。

同一个工作区,不复制、不隔离。

点开 report.md,对话框旁的产物预览是 Monaco 编辑器:行号、查找、折叠、Markdown 渲染或源码。改完 Cmd+S 写回同一路径;侧栏 ⌘O 从右侧打开独立的工作区浮层(文件树 + 预览),不占用对话框预览。

写回的是磁盘上的真文件。

窗口藏进托盘,进行中的轮次继续。私聊里的 Stop 立即停掉眼前这一轮;群聊要停就发消息。Cmd+Q 或托盘「退出」才结束窗口和守护进程。

关窗是隐藏,不是退出。

哪些已经接入,哪些还在建,哪些不做

「已接入」表示代码里有实现,不代表每种模型、工具组合和完整任务路径都通过了真实环境验收。

已接入 正在建设 明确不做
运行时底座 已接入macOS 桌面窗、常驻守护进程、本地共享工作区、SQLite 持久化 正在建设复杂真实场景下的长期稳定性验证 明确不做云电脑、云端计费、多用户 SaaS
Bot 形态 已接入持久名册、私聊、多 Bot 群、@ 点名、参与判断、异步交接;纠正链结束后自动复盘,结论留成该 Bot 的经验 正在建设验证经验复用是否真的让选择更准、完成更快 明确不做用完即弃的对话框、中央裁决路由、轮数熔断
模型与工具 已接入多个 OpenAI 兼容端点;stdio 与 Streamable HTTP MCP;开轮前由 agent 挑模型和思考等级并给出理由,规则兜底 正在建设工具和协作方式也由 agent 开轮前决定 明确不做绑定单一厂商、供应商目录、假装兼容所有实现
安全与权限 已接入危险动作批准卡、钥匙串存密钥、Always allow 规则、私聊 Stop 正在建设更细粒度的 MCP 权限治理 明确不做把 Bot 当安全沙箱、假装已具备完全自主权限
对话管理应用 已接入改人设和技能、建 Bot 和群、配端点、模型名单和 MCP,都可由 Bot 通过工具完成 正在建设全部应用操作的对话覆盖(含首启向导) 明确不做每件事都要手点深层菜单

详细方向见路线图;领域词汇以 CONTEXT.md 为准。

下载,或从源码启动

MIT 协议开源。Alpha 快照只有 macOS 且未签名;Windows 与 Linux 不在支持范围。

需要 macOS、Node.js 22+、pnpm 12.3.4、Bun 1.2+、Rust / Cargo,以及 Tauri 的 macOS 前置依赖(含 Xcode Command Line Tools)。

  1. 选一个本机目录作为共享工作区,建议独立于源码仓库;不存在会自动创建。
  2. 在设置里选择工作区文件夹,再填 OpenAI 兼容端点 URL 和 API key,配好模型名单与默认模型。
  3. 通过侧栏创建第一个 Bot,填名称、职责和边界,开始私聊。
  4. 让它创建其他 Bot、组群或提出 MCP 配置;需要批准时在应用里审核。

下载 Alpha 快照

v0.1.0-rc.5

最新 GitHub Release 提供 Apple 芯片与 Intel 两种 .dmg。构建未签名:首次打开若被 Gatekeeper 拦截,右键选「打开」,或在终端执行(完整 FAQ:docs/gatekeeper.zh.md;昂贵动作仍会先问你):

xattr -dr com.apple.quarantine "/Applications/Real Bot.app"
前往最新 Release
zsh — real-bot
# 克隆并安装依赖
$ git clone https://github.com/Blackman99/real-bot.git
$ cd real-bot
$ pnpm install

# 并行启动守护进程与桌面窗
$ pnpm dev