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

在自己的电脑上,
用对话组一支
持久的 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 在渲染和源码之间切换。改完 ⌘S 写回同一路径。一条会话只有一块预览,再点别的文件就换到它。

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

会话窗格窄了,顶栏按钮收进 ⋯。点「经过」,这件事按谁叫醒了谁画出来:一轮一张卡片,交出的文件挂在卡片上。Bot 卡片底下一行是这一轮的模型、思考等级和消息类别,开轮前由 agent 挑定;点开看它为什么这么挑、走了几跳。纠正链结束时的复盘也记在这里,只有判成模型的问题才留成这个 Bot 的经验。

每轮挑的模型和理由,记在这一轮的卡片上。

在任意窗格里右键,可以向上下左右分割;新的空窗格列着新终端、工作区和日程。开一个终端跑 pnpm dev:这是你自己的 shell,不走批准,Bot 也碰不到。当前窗格描一圈强调色;排法只记在这台 Mac 上,退出再开,分屏和终端都回来。

关掉终端标签不杀进程,从「+」接回。

窗口藏进托盘,进行中的轮次和终端里的 pnpm dev 都接着跑。Coordinator 复核完,macOS 横幅点开就是这条会话;Dock 角标只数你没看过的和还在等你的。私聊里的 Stop 立即停掉眼前这一轮;Cmd+Q 或托盘「退出」才结束窗口和守护进程。

关窗是隐藏,不是退出。

配对过的手机经你自己部署的中继连回这台 Mac:会话、批准、工作区和终端都在,消息在两端之间端到端加密,中继只转发它解不开的密文。在手机上让 @Writer 补一节,干活的仍是 Mac 上那个 Writer;你在手机上读过,Mac 的 Dock 角标也跟着消掉。配对只做一次:Mac 的设置里给出一段一次性配对内容,粘到手机上、两边核对指纹,再在 Mac 上批准。这是默认关闭的实验功能,发布包暂时还不能配对。

接入步骤 →

页面由你自己的中继提供,消息端到端加密。

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

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

已接入 正在建设 明确不做
运行时底座 已接入macOS 桌面窗、常驻守护进程、本地共享工作区、SQLite 持久化;关窗不停,你自己的终端会话也由守护进程持有 正在建设复杂真实场景下的长期稳定性验证 明确不做云电脑、云端计费、多用户 SaaS
桌面工作台 已接入主栏任意分屏,标签装会话、终端、日程图或工作区;一件事一张流程图;等你的事标在会话列表上,macOS 横幅与 Dock 角标 正在建设几条会话同时可见时,只有当前那条会报在线,其余仍可能弹一次横幅 明确不做多窗口进程、手机上分屏
Bot 形态 已接入持久名册、私聊、多 Bot 群、@ 点名、参与判断、异步交接;纠正链结束后自动复盘,结论留成该 Bot 的经验 正在建设验证经验复用是否真的让选择更准、完成更快 明确不做用完即弃的对话框、中央裁决路由、轮数熔断
模型与工具 已接入多个 OpenAI 兼容端点;stdio 与 Streamable HTTP MCP;开轮前由 agent 挑模型和思考等级并给出理由,规则兜底,记在流程图那一轮的卡片上 正在建设工具和协作方式也由 agent 开轮前决定 明确不做绑定单一厂商、供应商目录、假装兼容所有实现
安全与权限 已接入危险动作批准卡、钥匙串存密钥、Always allow 规则、私聊 Stop 正在建设更细粒度的 MCP 权限治理 明确不做把 Bot 当安全沙箱、假装已具备完全自主权限
对话管理应用 已接入改人设和技能、建 Bot 和群、配端点、模型名单和 MCP,都可由 Bot 通过工具完成 正在建设全部应用操作的对话覆盖(含首启向导) 明确不做每件事都要手点深层菜单
远程访问 已接入默认关闭的实验原型:自托管中继、端到端 Noise 加密;配对过的手机能看会话、回消息、处理批准、翻工作区、用终端,源码态可做集成测试 正在建设独立安全复核,真机主屏幕 WebAuthn 与 Web Push 验收;在这之前公网配对保持关闭 明确不做项目方运营的云端中继、把实验原型当成可用的远控

详细方向见路线图;领域词汇以 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.6

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

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

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