设置就是向导:一个本机目录做共享工作区,再加至少一个 OpenAI 兼容端点。端点下已启用的模型各占一行,写清擅长领域、思考等级和价格,点一行就设成默认。之后每开一轮由 agent 按任务挑模型和思考等级并留下一句理由,你不用每轮自选。
密钥只在这个输入框里填,不进聊天。
Alpha 版本:macOS 未签名快照,功能与数据结构仍会变化。 v0.1.0-rc.6
Bot 有名字、职责和边界,可以私聊、进群、被 @ 点名、彼此交接;一件事一张流程图,每一轮用的模型都说得出理由。窗口、运行时、会话和共享工作区都在你的 Mac 上;模型端点和 MCP 工具由你接入。
pnpm install && pnpm dev 往下滚动,看一遍完整流程
右侧窗口会随着你的滚动自己操作起来。窗口是按应用当前实现重建的示意,每一步对应真实存在的功能,不是概念图。
设置就是向导:一个本机目录做共享工作区,再加至少一个 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 上批准。这是默认关闭的实验功能,发布包暂时还不能配对。
接入步骤 →页面由你自己的中继提供,消息端到端加密。
「已接入」表示代码里有实现,不代表每种模型、工具组合和完整任务路径都通过了真实环境验收。
详细方向见路线图;领域词汇以 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)。
最新 GitHub Release 提供 Apple 芯片与 Intel 两种 .dmg。构建未签名:首次打开若被 Gatekeeper 拦截,右键选「打开」,或在终端执行(完整 FAQ:docs/gatekeeper.zh.md;昂贵动作仍会先问你):
xattr -dr com.apple.quarantine "/Applications/Deskfolk.app"
# 克隆并安装依赖 $ git clone https://github.com/Blackman99/deskfolk.git $ cd deskfolk $ pnpm install # 并行启动守护进程与桌面窗 $ pnpm dev