Deskfolk v0.4
English GitHub
文档
源文件 按 main 分支生成 · 最新发布 v0.4.0

路线图

Deskfolk 的建设方向，不是稳定版承诺或交付时间表。

本页
  1. 当前重点
  2. 1. 本地协作与开放接入
  3. 2. 规划、任务与验收：应用当真（重点建设中）
  4. 3. 通过对话管理应用自身
  5. 4. 远程访问（默认关闭）
  6. 当前产品边界

Roadmap

WIP — 这是建设方向，不是稳定版承诺或交付时间表。 当前优先支持 macOS 上的单人、本地 Bot 协作。已实现能力也需要持续进行真实端点与 UI 验证。

当前重点

定位：交出去，离开，回来看结果。把一件多天、多步、要返工的活交给 Bot，人可以离开，回来时不用怀疑它悄悄停了、忘了你的规则，或者谎报做完。模型负责干活，应用负责当真。用别的 Agent 最常卡住的三处，在这里是核心：产物按件归好、在应用里直接打开和批注，每一轮在做哪张任务、为什么都画在流程图上，Bot 交付之后自己复盘、越用越会做。面向已经在用 Claude Code、Codex 这类本机 Agent，或会自己配模型端点和 API key 的独立开发者、技术型个人和小工作室；一个 Bot 单干也行，团队留给真要分工的活；一次问答、半小时就能做完的小活不是这里要解决的。这套做法本身是一份模板，可以用，也可以不用。底线是写在代码里的规矩（批准、叫停、花费），每条来自一次事故，不随什么变；底线之上是工作方式——跑不跑一件件事、应用自己的哪些环节跑、带什么数是引擎，内置开发者按自己的记录调过的通用、视频、代码三套，和不用这一套的「自由」，按对话选；每个环节用哪个模型、哪段提示词在分工页上设，Bot 每一轮读的提示词也能改。你在应用里改它们、或让 Bot 提改动，让它们照你的方式干活，底线不变。

接下来的时间按这个顺序花，前两步比任何新功能都重要：

  1. 内核成为默认，再收缩。 2026-10-04 起，构建默认把数据目录升到内核 8 级（engine_level，和第 6 条的引擎不是一回事）：交付与审查、外部作业、默认模型与阶梯、质量事件与教训，下载的人不用再手动开。剩下的是 ADR 0040 的 P6 收缩：带这个默认的版本发出去、旧版本退场之后，删掉 8 级已经不走的旧路径（每轮选路、纠正链复盘、学习跳等）和它们的表与列。
  2. 用长活做证据。 黄金路径（eval:golden-path）只量了三件小活，恰好是这层保证帮不上的地方：一个 Bot 单干和三人团队做完得一样多，花费低得多。把 ADR 0040 的事故夹具（F-a 到 F-g）做成第二张公开实测表：注入叫停、投诉、重启和返工，量叫停之后的副作用是不是零、规则是不是一条不丢、打扰了你几次。黄金路径照旧在每次改核心循环时重跑对照（eval:golden-path:combine）；要在浏览器里核对的活接一个浏览器类 MCP（落地页那件事的超时都出在这里）。三套内置引擎也要这样量：黄金路径能按引擎分组（--playbook），还没这样跑过；代码引擎背后的记录太少，它的数还是原来的默认。
  3. 首次上手先选一种活。 向导的最后一步选一种工作方式（通用、视频或代码），按它建好一组 Bot 模板，两个以上再建一个群（2026-10-11）。之后和 Bot 的私聊里，第一条起手提示就是「交出去，明早看结果」：写一页工作区简报，再建一个每天早上的日程，第二天回来有东西可看（2026-10-12）。Mac 版从 0.1.0-rc.16 起用 Developer ID 签名并经 Apple 公证，双击即可打开。
  4. 外围功能只维护。 远程访问（包括看屏）、日程、花费、全局搜索、工作台分屏：修 bug、跟着核心改动走，不再扩面，远程看屏这样的投入要更克制。产物的归档、预览和批注不在这里：它们和流程图、完工复盘一样是核心。
  5. 把「应用找你」做成可量的数。 每件事打扰你几次、每次是不是真要你，口径按 ADR 0058，进第二张实测表。
  6. 应用是你的工作方式模板。 内置提示词能改，Bot 也能提改动、由你在批准卡上放行，每次修改都能撤销（ADR 0064）；Bot 能只读地查本机记录，拿依据提改动（ADR 0065）；跑不跑一件件事、应用自己的哪些环节跑、带什么数是引擎，内置通用、视频、代码三套和不用这一套的自由，按对话选，每个环节的模型和提示词在分工页上一起设，还能在应用已有的时机上加你自己的环节，按规则、命令或模型判，「不过」做什么只能从固定清单里选（ADR 0082、ADR 0085、ADR 0103、ADR 0105）。应用的样子和用法也归你：令牌、用法清单、自定义 CSS 和界面上的字，你或你让 Bot 改，底线盖不住（ADR 0106）。接下来：Bot 提议改引擎（走批准卡片）、拿过去的话回放来评估一次改动、引擎的修改记录能撤销；局面块、回路里的提示和转录文案也做成能改的提示词；快捷键重绑和整体缩放。

不做的继续不做：云电脑、多用户、供应商目录、把 Bot 当安全边界。

1. 本地协作与开放接入

已有基础：

  • 持久 Bot、私聊与群组、点名、参与判断和异步交接；连发的几句按顺序处理，发出去的话能改，Bot 照改后的做。
  • 本机守护进程、共享目录、文件工具、shell、危险动作批准与 Stop。
  • 多个端点，OpenAI 兼容（Chat Completions）或 Anthropic 兼容（Messages，ADR 0066），stdio / Streamable HTTP MCP 工具。
  • 一件事一张流程图：共用工作目录的群、私聊和 Bot↔Bot 私聊按谁叫醒了谁画在同一张板上，一轮一张卡片，交出的文件挂在卡片上；应用自己的调用（读句、归档、书记员、判断下场、看图判定、整理、复盘）作为环节画在卡片之间，点开看结论、模型、提示词版本、当时的引擎和原始回答，没归属的话也能打开自己的一张（ADR 0083）。
  • 桌面窗格工作台：主栏任意纵横分割，一块窗格一组标签页，标签装会话（连同它唯一的一块预览和流程图）、终端、日程图或工作区；排法只记在本机，窄屏和手机仍一次一屏。
  • 你自己的终端会话：守护进程持有，关窗不停，退出再开回到原来的目录和屏幕；Bot 跑的命令边跑边在它那条气泡下滚动，跑完折成一行。
  • 每天 / 每周日程：按运行它的那台电脑的本地时间定点叫醒 Bot，日程图把全部日程铺在一张周视图里。
  • 等你的事标在会话列表上：没有通知页；macOS 横幅点开就是那条会话，Dock 角标只数没看过的和还在等你的，可设免打扰时段。

接下来：

  • 验证从任务输入、Bot 自主协作到交付文件的完整路径，包括人工组队与 Bot 创建队友两种方式。
  • 持续验证不同模型与 MCP 的兼容性、错误恢复和协作一致性。
  • 模型与工具只承诺 OpenAI 兼容的 Chat Completions 端点和 Anthropic 兼容的 Messages 端点、MCP（stdio / Streamable HTTP），以及由你本机安装并登录的 Agent 跑的 Bot（Claude Code、Codex、Grok、OpenCode、ZCode、Antigravity 和讲 ACP 的程序，ADR 0061、ADR 0079），写清接口约束；不承诺兼容任何模型、任何工具。

2. 规划、任务与验收：应用当真（重点建设中）

模型负责理解、提议和干活，状态只由应用的代码写（ADR 0040）。2026-10-04 起构建默认开到内核 8 级，下面写的就是下载版的行为（其中书记员、完工复盘和反思是引擎里能关的环节：默认的通用引擎跑完工复盘、不跑书记员和反思，代码引擎只关书记员，视频引擎都开着，见 ADR 0085）；和还不读版本闸的旧安装版共用数据目录时，数据目录停在更低的级别，照旧每轮选路、事后复盘纠正链。

已有基础：

  • 原话与需求台账（ADR 0042）：你说的每句话原样另存一份，Bot 写不了；你的要求一条一条记进台账，只增不删，引文由库核对是你原话里的字。书记员在后台读你的话、只提补丁（通用和代码引擎默认不跑它，台账里只有你在流程图写的规则和验收，和你挑已交付成果毛病的原话）；改一条只出待你确认的替代，旧的照样生效。每一轮的局面和流程图上列的是同一张单子。
  • 规划、任务与归属（ADR 0043、ADR 0057）：一件事是一个规划，下面是有交付物的任务。你的话先看它自己指着的（你选的、批注、引用回复、路径），没有就由模型读它在说哪件事；读不出、或和开着的事都无关的，交给被叫醒的 Bot，它真动手时为这句话新开一件事。产物按任务落在 work/<规划>/<NN-任务>/，map.md / ticket.md 镜像给 Bot 读。整理跳只剩静下来后的交接整理和旧路径的兼容。
  • 读句（ADR 0055）：一句话是不是叫停或继续、是不是只问进度、是不是在挑已交付成果的毛病，Bot 的话是不是在许诺「随后」、是不是声称测过，由一次无工具的短调用读；建不建叫停、退不退回、出不出卡仍由规则定。读不了时退回旧词表。
  • 叫停与重启（ADR 0041）：叫停是一条只有你能解除的记录，开轮、叫醒和有副作用的工具调用都要先过它，库里的触发器再兜一层。重启按原因分类，会自己接着做的不打扰你。
  • 工作项、委派与结束契约（ADR 0044）：一个 Bot 在一件事上同时只跑一段；交给别的 Bot 用具名委派，回复和取消都有记录；说了还在做、却什么都不欠就结束的一段会被退回。
  • 监督器（ADR 0045）：每 15 秒一拍，不调模型，重启不丢期限；按持球者叫回没人推的任务，从断的地方接着做被中断或失败的段。有副作用的调用先记账，结果不明的不重做。
  • 交付与审查（ADR 0046、ADR 0053）：任务的阶段只由交付（连同应用当场跑的检查）、审查、监督器和你推进。审查逐条判你说过两次以上的、关于画面的要求，判通过要带依据；只写一句「通过」不推进任何东西。负责人可以用 plan_items 一次拆好任务、谁做谁审和依赖。
  • 外部作业（ADR 0047）：媒体服务器接下的渲染由守护进程轮询，同样的参数半小时内不重复提交，完成时叫醒等它的 Bot。
  • 模型选择（ADR 0048、ADR 0049、ADR 0054）：任务上指定的 → 你钉的 → Bot 的默认模型（按它最近 7 天用得最多的定）→ 端点默认，每轮记下是哪一条，挂在流程图那一轮的卡片上；要看图的活不落到标着看不了图的模型上（钉的除外）。交付连着没过或一轮里接连出错先提一档思考，思考档用完、交付还没过，再沿你排的模型阶梯往上换（钉的和任务指定的不换）。
  • 质量事件与教训（ADR 0050、ADR 0051）：出了问题按事件的类型直接归类，不再问模型「是不是模型不行」，也不把这些事件写进记忆。递归搜索跑满超时这类命令，应用在调用前先警告、再拦下；误放行或卡在能力天花板之后，当事的 Bot 只能提一条清单项或一条检查，你采用才生效（反思，通用引擎默认不跑）。一个 Bot 的技能可以由你共享给所有 Bot（ADR 0052）。你接受的一件事交付之后，做过它的 Bot 做一次完工复盘（ADR 0062）：找出踩的坑和让你返工的做法，对照已有的记忆和技能修正、合并、补进去，不发消息、不问你，每处改动都能在流程图上撤销；三套内置引擎都跑它。
  • 验收检查与收尾自检（ADR 0036、ADR 0037）：验收里能机器判定的那几条挂成检查（文件存在、包含、匹配正则、命令的退出码和输出、几个 Bot 做的几部分接起来是否一致），由守护进程在本机跑，结果标在流程图上；你加改删，整理跳只能加改自己的，Bot 写不了。交付物发给你之前不调模型核一次：检查过没过、说了「随后」有没有约回看或点名交出、说了「测过」这一轮有没有真跑命令，不满足就退回一次。
  • 应用只在需要你时找你（ADR 0058）：要你放行、要只有你给得了的东西、或者它停下了不会再自己往下做，才发卡片和「等你」通知；它替你定了、你随时能改的，你刚说过的，它会自己接着做的，都不发。
  • 进度询问：你只问进度的一句话由应用用规划、任务、活轮和检查的状态直接回答，不调模型，不叫醒也不改道 Bot；没人在做就照实说，不顺带叫回谁。
  • 回看：Bot 给自己约一次性叫醒（最远 7 天；最早几分钟后、每件活每小时最多几个按引擎，通用是 5 分钟、6 个，视频是 15 分钟、3 个；任务在等你时约不上），到点在同一件事里被自己的备注叫醒，去核对交出去的活；叫停时挂起，守护进程正在轮询的作业不用约。
  • 跨会话记忆：Bot 用工具自己记下跨会话仍然成立的事实，启用中的全部进入它每一跳的上下文，别的 Bot 看不到。没有检索，也不在后台蒸馏转录；完工复盘只在你接受的一件事交付后、按这件事的记录改它的记忆。写满了会报错让 Bot 自己取舍。你能在 Bot 设置里看到每条记忆的来源和时间，可以改、停用或删除。

正在建设的目标：

  • 收缩（P6）： 带默认 8 级的版本发出去、旧版本退场之后，删掉 8 级已经不走的旧路径（每轮选路、纠正链复盘、学习跳、规划叫回）和它们的表与列。
  • 长活的实测： 把事故夹具做成第二张公开实测表（见「当前重点」第 2 步），连同每件事打扰你几次。
  • 评估： 目标覆盖评估（eval:goal-coverage）拿规划的目标和验收对照交出的文件，让评判模型逐条判 covered / partial / missing；黄金路径基准（eval:golden-path）用任务集里固定的验收逐项判，外加交付文件、内容和命令的确定性检查，算出完成率和人工介入次数。上一次是 2026-09-29 内核落地之前量的，要在默认 8 级上重量。

原话、需求、质量事件和教训都存在本机；轮次本身，以及读句、书记员、反思、完工复盘和验收检查里看图的调用，会把相关消息发给你配置的端点，遵循所选模型与工具的数据边界。

3. 通过对话管理应用自身

已有基础：

  • Bot 修改自己的头像、名称、职责、边界与技能。
  • Bot 创建其他 Bot、创建群组并管理成员。
  • Bot 管理 provider、模型名单与 MCP server；危险配置需要用户批准。
  • 内置提示词：你直接改（每一轮的在设置里，应用自己的调用的在分工页上）；Bot 用 edit_prompt 提，批准卡放行，能撤销（ADR 0064）。
  • 本机记录：Bot 用 describe_data / query_data / read_data_log 只读地查应用存下的记录和守护进程日志，拿依据分析、提改动，常问的几种分析有现成的查询；密钥、远程访问和你的终端查不到（ADR 0065）。
  • 界面方案：你在对话里说想要的样子和用法，Bot 用 describe_interface / edit_interface 改令牌、一份固定的用法清单、自定义 CSS 和界面上的字，所有窗口和手机共用，立刻生效、能撤销；停止、批准和设置入口由代码守着盖不住（ADR 0106）。
  • Bot 发消息、点名和交接，主动推进其他 Bot 的工作。

接下来：

  • 逐步覆盖全部应用操作，明确仍需图形界面的操作和首次配置要求。
  • 验证配置更新在当前轮次、其他 Bot、私聊、群聊与日程中一致生效。
  • 在扩大自主操作范围时保留用户批准、拒绝、Stop、密钥输入和执行记录；自主不等于自动放宽权限。
  • 局面块、回路里的提示、转录与控制文案也做成内置提示词；给「读不懂几次」加上分母；用你改过的提示词跑评估。

4. 远程访问（默认关闭）

已有基础：

  • 自托管 Bun 中继：一次性 bootstrap、按设备的出站链路，只转发不透明的 Noise 流量，日志只记元数据。
  • Noise IK 端到端加密与 WebAuthn 身份，一次性配对内容钉住主机公钥，中继就是服务这个页面的那一个；托管信使 PWA 与本机接口同一套方法，托管生产包不含本机发现与回环 bearer。
  • 手机端的会话、工作区、终端和文件：断线自己退避重连，回到前台只要这段时间的变化；图片先到缩小副本；「文件」会话把手机上的文件送进工作区 inbox/，不叫醒 Bot。
  • 可选 Web Push 只发泛化的待办提醒，由 Mac 出站，点开只回到会话列表，绝不批准。
  • 手机上的日常功能、Web Push 和看屏都已验证，可以正常使用。
  • 安装的应用能登记中继、配对设备：远控凭据存在数据目录的私有文件里，每台设备由窗弹触控 ID 批准（ADR 0033）。
  • 手机上看和操作 Mac 的屏幕（默认关，Mac 上打开）：借 macOS 自带的屏幕共享，锁屏也能用；能直连就走 WebRTC，连不上经中继（ADR 0056）。Windows 上借用户装的 VNC 服务（TightVNC），远控本身也接上了，用 Windows Hello 批准设备（ADR 0059）。

接下来：

  • 打包门（G-pack）：封好口的守护进程运行时加正式签名，远控凭据才能从文件搬进钥匙串的专用访问组。

部署中继、让 Mac 连上、配对手机的步骤见远程访问指南。

当前产品边界

  • 本地单人使用，不是多人 SaaS，也不是云端虚拟机。
  • Bot 共享工作区与工具，不提供 Bot 之间的权限隔离。
  • 当前运行与验证以 macOS 为主。Windows 是实验性预览，还没有独立运行时、应用内安装更新和桌面通知；Linux 也是实验性预览（x86_64 的 AppImage 与 deb），还没有远程访问、桌面通知和应用内安装更新，也还没在真的 Linux 桌面上从头到尾用过；Windows 与 Linux 的签名安装包没有交付承诺。
  • 远程访问是默认关闭的实验原型，没有项目方运营的云端中继。
  • 尚不承诺稳定 API、数据库兼容性或生产环境可用性。

贡献入口见 CONTRIBUTING.md，当前使用方式见 README.md。