跑在你自己电脑上的 AI 办公助理。
交代一句话，它自己规划、动手、验收，把 PPT / Word / Excel / 网页落到你硬盘上。
给你的是能打开的文件，不是一段聊天记录。
A local-first AI office agent that hands you files, not chat logs. · English
▶ 三分钟跑起来 · 下载安装包 · 功能清单 · 文档 · 交流群 · 变更记录
自己用、学习用、非营利用 免费；公司里用要授权，一句话讲清 ↓
| 你说一句 | 它交给你 |
|---|---|
| 帮我出一份 Q3 复盘 PPT，数据用这个 Excel | 读表 → 算 → 一个能直接放的 .pptx |
| 调研国内 AI 陪伴产品，出一份报告 | 联网搜 → 逐个打开读 → Markdown / Word |
| 把这份材料做成手机上能看的网页 | 写 HTML → 起本机服务 → 扫码就能看（成品） |
| 每天 9 点抓行业新闻，做成晨报发我飞书 | 定时任务 + IM 推送，错过了会补跑 |
Note
多任务并行、目标验收、👍👎 进自进化、双层记忆、权限档位、IM 远程指挥、桌面宠物…… 全部能力见 功能清单。
|
📄 文件是真的。 PPT / Word / Excel / 网页都真生成，成果面板里点开就能验收。说写了文件却不在磁盘上，当场拦下重做。 |
🔌 模型随便换，东西全在你手里。 DeepSeek / 通义 / 智谱 / Kimi / OpenRouter / Ollama 界面点一下就切；本机装了 Claude Code / Codex 的，一键拿它当发动机，不用另买 token。会话、文件、Key 全在本机，默认只听 |
|
🧩 加个能力 = 丢一个 Markdown 文件。 存成 |
🔍 也适合拿来读懂 Agent。 模型路由、工具调用、文件验收、记忆、权限、本地 Trace 全在同一个仓库里：一条真实任务，从它为什么这么做到最后交了什么，你都看得见。 |
三条路都是完整功能，没有哪条是阉割版。
macOS 一句话装好（下载 → 装进「应用程序」→ 摘掉隔离标记 → 打开）：
curl -fsSL https://raw.githubusercontent.com/CatCatUncle/openworkbuddy/main/install-mac.sh | bash
⚠️ 手动下 dmg 的话，第一次打开一定会弹「未打开“OpenWorkBuddy”· Apple 无法验证…」，弹窗里只有「完成 / 移到废纸篓」。 这是苹果对没买证书的应用的统一拦截，不是包有毒——证书正在申请，批下来这一步就消失了。 点「完成」→ 系统设置 → 隐私与安全性 → 滚到最下面 → 点「仍要打开」→ 输开机密码，只需要做这一次。 上面那句curl全程一个弹窗都没有，嫌麻烦直接走它。三条路的详细步骤在下面「第一次打开被系统拦住」那一段。
Windows / 手动下包：去 Releases 拿 -win-setup.exe（x64 和 ARM 同一个），双击即装；公司电脑不让装软件的拿免安装版 -win-x64-portable.exe（ARM 机器换成 arm64）。
从源码跑（Node.js 18+，零构建零框架，改完刷新就生效）：
git clone https://github.com/CatCatUncle/openworkbuddy.git
cd openworkbuddy && npm install
npm run app # 桌面版；或 npm start 走浏览器 http://localhost:3800起来之后填一个模型 API Key，然后在输入框里说人话就行，比如「帮我做一份介绍 OpenWorkBuddy 的 PPT」。
你的东西都在 ~/OpenWorkBuddy：配置、会话、成果文件、技能，卸载不删，换电脑整个搬走。
嫌字小、想换个皮肤：右上角头像 →「外观」，字号四档、五套主题、界面密度都在那一页。
第一次打开被系统拦住 · 双击了没反应
代码签名证书还在申请（苹果一年 99 美元、Windows 一年几千块），所以现在发出去的包是 ad-hoc 签名的。
系统拦的是「这个开发者我没见过」，不是「这个文件有毒」——包里的签名本身完好，用 codesign --verify --deep --strict 自己验得出来。
macOS · 三条路，挑一条
- 不想碰终端（推荐）：双击 → 弹窗点**「完成」（别点「移到废纸篓」）→ 打开「系统设置 → 隐私与安全性」→ 一直滚到最下面的「安全性」那一段，会看到「已阻止使用"OpenWorkBuddy"，因为它来自身份不明的开发者」→ 点「仍要打开」→ 输开机密码 → 再弹一次点「打开」**。只需要做这一次。
- 一句命令：先把 .app 从 dmg 拖进「应用程序」（dmg 是只读卷，在里面跑这条会失败），然后
xattr -dr com.apple.quarantine /Applications/OpenWorkBuddy.app
- 一个弹窗都不想见：用最上面那句
curl。浏览器下载的文件会被打上com.apple.quarantine标记，curl 下的不会——整条路径上没有 Gatekeeper。
别照着网上「右键 → 打开」的教程点。 那条路只在 macOS 14 及更早有效，macOS 15 (Sequoia) 起苹果把它取消了，右键弹窗里已经没有第二个「打开」按钮——照着点会以为「就是打不开」。
如果提示的是**「已损坏，应将它移到废纸篓」**（而不是「无法验证」），那是签名真的被弄坏了——网盘、同步盘、某些解压工具都会干这事。重下一次，或者跑
codesign --force --deep --sign - /Applications/OpenWorkBuddy.app就地重签。
Windows：弹「Windows 已保护你的电脑」时点灰色小字「更多信息」→「仍要运行」。
- 双击没反应：启动日志在
~/OpenWorkBuddy/logs/boot.log，停在哪儿问题就在哪儿；源码跑的先来一句node cli.js doctor。对照表 → 安装与启动
镜像、端口占用、换数据目录 → 安装与启动 | 换电脑搬家 → 数据同步与搬家
「同一个人，换四个场景，手里举块写着字的牌子——要像随手拍的，别像 AI 图」
难的不是画人，是四张里得是同一个人、牌子上的中文不能糊。它先出一张，再用看图工具真去读自己刚生的那张（不是凭记忆吹），确认了才照这个方向铺开其余三张。
「做个湖南旅游攻略网站，14 个市州一个都不能少」
https://hunan-travel.pages.dev/ —— 点开就能逛。一个 HTML 加一个图片文件夹，不挂任何外部 CDN，扔到静态托管上就是一个站。这不是截图拼的示意图，是它交出来的那份东西本身。
「每天早上七点，把今天的天气和该注意的事发到我飞书」
一句话排出来的定时任务，人不在电脑前也照跑；每趟调了哪些工具、为什么这么说，都在「自动化 → 运行记录」里点得开。飞书 / 企微 / 钉钉 / Telegram 同一条路。
怎么做到的、本机 Claude Code 当发动机长什么样 → 三个案例，拆开讲
剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。连线不是装饰——它表示下一步生成真会去读的角色、首帧和声音。改哪个镜头，只有那个镜头重跑。
左侧点「无限画布」就能开始。空白处拖拽平移，Shift+拖拽框选，Shift/⌘ 点节点加选减选，底部对话框里能 @ 引用任意节点和素材。
一台干净的 VPS，装好 Docker 之后一条命令：
git clone https://github.com/CatCatUncle/openworkbuddy.git && cd openworkbuddy
bash deploy.sh --domain buddy.example.com # 自动 HTTPS，起来就对外能用脚本会等健康检查真的通过才说成功，起不来就把日志打给你。数据全在 ./openworkbuddy-data 一个目录里。
Important
起来第一件事是注册管理员。 第一个注册的就是超级管理员（每个组织只有一个，只能转让不能增发），之后默认不再允许别人自建账号——空实例挂在公网上，等于谁先访问谁是超管。
一个进程能同时给多家公司用，各租户互相看不见。管理员头像菜单 → 企业管理后台：建组织、分席位、看用量、配安全策略。新人按部门模板开号（角色和月额度一次配好），人走了点一下，扫码连上的设备、他名下的定时任务、没用完的邀请码、二次验证、在跑的任务一起关——关权限，不删数据，完事出一张能贴进离职交接单的回执。
指标每分钟落一行，命中阈值推企业微信 / 钉钉，要接现成监控就抓 /api/ops/metrics.prom（和别的接口一样锁在平台管理员后面）。
反代、升级迁移、安全清单 → 部署 | 运维手册 | 多人协作
设置 → 模型，挑渠道预设（OpenAI / Anthropic / OpenRouter / 火山方舟 / 百炼 / DeepSeek / 智谱 / Kimi / Ollama），地址和协议自动填好，只差粘 Key，保存即热生效。Key 粘歪了当场就说是第几个字符不对，不用等发出去收一个看不懂的 401。带 reasoning 的模型能在界面里关掉思考或调档。
生图 / 配音 / 生视频另配一张表，视频认五家协议（通义万相 · 火山方舟 Seedance · 智谱 CogVideoX · MiniMax 海螺 · 硅基流动）；认不准是哪家就不发那一趟——视频按条计费，白发一趟得等好几分钟才看见错。
对照表 → 配置模型
Important
config.json 是唯一存 API Key 的文件，已经在 .gitignore 里，别手滑提交。
openworkbuddy 跟桌面版共用同一份配置、技能、记忆、连接器和会话——终端里起的活儿，手机和网页上看得见、插得上话；桌面上做到一半，终端里 openworkbuddy resume 接着往下走。
npm link # 一次性：装成全局命令（也可以直接 node cli.js …）
openworkbuddy "帮我写一份本周周报" # 单发：跑完就退
openworkbuddy # 交互：连续对话，打一个 / 出命令菜单
cat error.log | openworkbuddy "这是什么问题" # 管道：管道内容当材料送进去
openworkbuddy -q "生成本周周报" > 周报.md # 文件里只有周报，没有进度条
openworkbuddy engines use claude-code # 换执行引擎：跑在你已经付过钱的订阅上，不烧 API 额度单发和管道模式下不会反问你，脚本和 cron 里不会卡住。退出码说实话：0 成功、1 任务失败、2 参数写错、130 Ctrl+C，所以 openworkbuddy doctor && npm start 拦得住没配好的机器。
sessions / resume / engines / doctor / pair（扫码把手机连上来）/ worktree，以及 --mode --perm -C -f --json 等全部参数 → 命令行用法
flowchart TB
subgraph Entry["你的设备"]
Desktop["桌面端 / Web"]
CLI["openworkbuddy CLI"]
IM["飞书 / 微信等远程入口"]
end
Entry --> Runtime["OpenWorkBuddy 本地运行时\n会话 · 权限 · 项目 · API"]
Runtime --> Agent["Agent 编排\n规划 · 工具调用 · 文件验收"]
Agent <--> Models["模型路由\n云端 LLM / Ollama / Claude Code / Codex"]
Agent <--> Capabilities["能力层\nMarkdown Skills · 专家 · MCP · Plugins"]
Agent <--> Workspace["本机工作区\n文件 · 素材 · 项目上下文 · 记忆"]
Agent --> Canvas["可执行无限画布\n剧本 · 角色 · 镜头 · 素材 · 时间线"]
Agent --> Trace["本地 Trace\n模型 · 工具 · 耗时 · Token · 输入输出"]
Trace -. 可选 .-> Langfuse["Langfuse"]
这张图也是读代码的路线：从 server.js 进去，再看 agent.js 怎么编排模型和工具。细节 → 实现细节
- 09-20 一个租户的日常操作，能把另一个租户的审计记录整个挤掉：全部组织的审计条目挤在同一个数组里、存盘时砍到 1000 条，实测乙公司的 21 条被甲公司 1200 条正常操作挤得一条不剩，后台显示「0 条」——跟「从来没发生过事」长得一模一样。现在一个组织一本
data/audit/<组织 id>.jsonl，谁也挤不掉谁，顺带把getOrg()从 45.57ms 拉回 0.02ms（审计以前躺在热路径上，37 处调用每次都要整本 parse）。界面上那两句假话也改了：存满了会说「已到保留上限」而不是继续写「全部」，导出按钮真按筛选导全量而不是只导屏幕上这 50 条 - 09-20 读 Office 文档的九个静默错漏：Excel 表尾整行整列丢（
actualRowCount数的是非空行数不是末行下标），而且还报「没截断」；公式格一片空白；合并格的标题横着重复四遍；PPT 用addChart做的页读回来整页是空的；Word 的有序列表和项目符号分不开、超链接地址整个丢、页眉页脚从来不读。顺带只认 http/https/mailto，外面发进来的.docx里那句javascript:超链接不再是可点的入口 - 09-20 启动失败那一页，现在右键复制得动：它写着「把这行贴到 issue 里」，可右键菜单当初挂在服务端 require 后面——而启动失败时那句 require 就是抛出点，于是最该能复制的一页反倒复制不了，只能手抄。「提 issue」也改成去你自己的浏览器，不再是应用里另开一个没地址栏的窗；显卡那条建议也给出
config.json的真实路径，不再让你猜用户目录在哪 - 09-20 打不开的时候，屏幕上写的是该怎么修，不是「去提 issue」：缺依赖就写
npm install、装机版少文件就写去 Releases 重下、Node 太老就写去下 LTS——这三样闸门本来就诊断出来了，以前却在窗口那边拿英文关键字重猜一遍，三种死法全落进「把这行贴到 issue 里」那句兜底 - 09-20 少装一个包，现在报得出是哪个、一共少几个：依赖清单不再手写（手写那份停在 3 个，
package.json里是 13 个），超过三个就跟上总数——「整体没装成」和「就差一个包」以前在屏幕上长得一模一样，可这两种该做的事不一样 - 09-20 设置页里问完渠道一个模型都没有时，不再是一行字凭空消失：本机 Ollama 会告诉你去终端
ollama pull哪一句、大概多大，拉完回来重开下拉框会真去问一次（那趟空清单不再被缓住）；云端渠道回空是另一回事，照实说；连请求都没发出去也得说一句 - 09-20 抓网页不再是一道多余的选择题：
render_page并回fetch_url的render:"force"——它俩本来就是同一段代码，清单里摆两个名字只会让模型每次先挑一遍。老名字照样调得动，外部 CLI 引擎那边也照常借得到 - 09-20 接本机 Ollama 时能自己选模型了：向导直接问你那台机器装了哪些（
/v1/models），列成下拉框；模板里的默认值只在你真装了的时候才选中，列表里没有就「自己填…」。Ollama 没起来会告诉你先ollama serve再ollama pull，拉完点「重新问一次」。选中的型号会真拿去验活，验不过不许改动你原来能用的那条。连不上时的兜底也从qwen3:14b（约 9GB）换成qwen3:8b（约 5GB） - 09-20 装了包的 macOS 用户点升级，不再被推回去下一个新 dmg（那样第一次打开又撞「Apple 无法验证」）：第一条给的是零弹窗那句
curl，单独画成一行等宽字加一颗「复制这条命令」，而且只在真有新版时才露出来 - 09-20 往输入框里拖文件、粘贴文件，松手那一瞬间就有卡片（以前要等上传回来，4MB 的片子空窗 124ms，人会以为没拖进去再拖一次）；卡片上写着体积、删除和打开都是真按钮、点名字直接打开那份素材；传失败会把文字锚点撤回来并留一颗重试键，还在传的时候点发送会被拦住；重复文件、文件夹这两种以前的静默失败现在都当面说清楚
- 09-20 macOS 上**「Apple 无法验证」那个死胡同弹窗，现在处处都告诉你怎么放行**：dmg 窗口里就画着「点完成 → 系统设置 → 隐私与安全性 → 滚到底 → 仍要打开」，README、安装文档和线上 7 个 release 的正文也都补齐了，不开终端的那条路排第一。签名还在申请，批下来就没这一步
- 09-20 卡片上的字不再被挡住、也不再被横切：连不上的原因原来当标签胶囊塞着，只露中间一截，现在整块红字、三行封顶、点一下看全文；命令原文、画布节点正文这类「先给你看几行」的框，封顶一律落在整行上，不再把最后一行拦腰切断；右上角那颗角标也不再压着标题和状态字
- 09-20 内置技能 35 条、连接器 52 个：竞品监控、市场调研、表格分析、一稿多投、用户反馈、SEO 简报、财务测算、播客、信息图、销售开发信十条新技能；连接器补上 Linear、Jira / Confluence、Sentry、Vercel、Figma、Airtable、Asana、Canva、Apify、YouTube、AntV 图表、EdgeOne 一键部署、B 站
- 09-20 用完真浏览器之后它会自己走了：闲置十分钟自动关、进程退出时带走、也能手动关，而且是整个进程组一起收。之前留下过一个挂十个半小时、GPU 进程 160% CPU 的
- 09-20 macOS 上下载的包双击打不开，现在多一条命令绕过去：
curl -fsSL .../install-mac.sh | bash——curl 下的文件不带隔离标记，全程零弹窗 - 09-20 无限画布能一次选一片了：Shift / ⌘ 加选减选、工具条上一个「框选」开关、⌘A 全选、Delete 一起删。之前框也框得出来、也高亮着，按 Delete 就是没反应——焦点从来没落到画布上
- 09-20 画图表不再只出 SVG 不出 PNG（飞书文档和 Word 只收 PNG）：图两秒就写到盘上了，只是 Chrome 之后挂着不退，旧写法等满超时就把那张好图一起丢了
- 09-20 短剧进度带展开后不再压住画布，浮在上面的工具条也跟着让位，剧本和定妆那两格终于露得出来
- 09-20 「N 个角色的定妆照在画布上写着、盘上已经没有了」不再冤枉人：判文件在不在改成挨个去问一次盘，路径认不出来的宁可不喊
- 09-19 跑自动评测不再动你的真记忆、真偏好、真额度账本；题库补上长任务、多轮、记忆召回三种单轮题考不出来的题形
- 09-19 两条任务同时改一个代码仓库时，后到的那条进自己的 git worktree——你眼前那份工作区一个字不动
- 09-19 权限按 RBAC 重做，补上超级管理员这一档：只能管比自己低的那一档，发管理员的四条路堵在同一道闸上
更早的看 变更记录。
Warning
它能执行命令、读写文件、访问网络——所以闸门是真拦的：命令审批、文件黑名单、URL 白名单、审计日志、四档权限。 放到公网前务必先读 安全，默认配置只为本机使用而调。
装别人的技能之前，它会先体检一遍。 一个技能就是一份给 agent 看的指令，接到一个能在你机器上敲命令的东西上——这跟 npm install 不一样，npm 包要你 require 才跑，技能是它自己会去读、会照着做的。所以装之前先过 34 条静态规则，然后把看到的摊开给你，落到三档：直接装 / 看一眼再装 / 默认不装（不打分，分数只会让人养成「42 分应该还行」的习惯）。其中 10 条真拦（反弹 shell、curl | bash、读 SSH 私钥、抹盘、抹痕迹……），管理员能强装，但那一下会记进 .install.json。
它不是杀毒。 公开标注集上纯静态规则大概七成五，四个漏一个。本机装了 toolward 就自动当第二把尺子用，合的规矩是只严不松。最后这条比上面所有规则都重要：装之前自己读一眼 skill.md，它是 Markdown，不是二进制。
用崩了、有想法、想一起改，进飞书群直接说：
- 用崩了、卡住了，开个 issue，哪怕只贴一句报错——你以为「只有我遇到」的坑，多半所有人都在踩。贴之前扫一眼，别把 API Key 带上。
- 10 分钟 写个技能：一个 Markdown 存成
skills/<名字>/skill.md，存盘即生效，模板在这 - 一晚上 挑个 issue 改：
npm install && npm start就跑起来，npm test不用 API Key 也能全绿
项目结构、测试、PR 规范都在 参与贡献。不用先开 issue 问，直接发 PR。
| 文档 | 一句话 | 文档 | 一句话 |
|---|---|---|---|
| 功能清单 | 全部能力、技能与工具 | 部署 | 服务器 / Docker / 反代 |
| 案例 | 上面那几张图怎么做出来的 | 多人协作 | 多租户、账号、权限、额度 |
| 安装与启动 | 安装包、源码、常见卡壳 | 安全 | 审批闸门、黑白名单、审计 |
| 配置模型 | 各家 base_url / 模型名对照 | 数据同步与搬家 | 数据存哪、换电脑怎么搬 |
| 命令行用法 | CLI 参数、管道、--json、cron |
开源与商业版边界 | 买授权到底买到什么 |
| 扩展 | 写技能、接 MCP、装插件、建专家 | 路线图 | 接下来做什么、怎么算做完 |
| IM 与定时任务 | 飞书 / QQ / 企微 / 微信 / 钉钉 | 变更记录 | 一句话一条，最新在上 |
| 实现细节 | agent 主循环怎么转的 | 参与贡献 | 项目结构、测试、提 PR |
| 安全基线 | 数据落在哪、谁看得见、哪些没做到 | 远程访问 | 手机/外网连本机，两个开关默认关着 |
- toolward —— 给 agent 用的技能 / MCP 连接器静态安检：37 条规则分六族，零运行时依赖。
npm i -g toolward装上，OpenWorkBuddy 自动把它当第二把尺子用，不装也完全不影响。同样是 PolyForm Noncommercial。
一句话：自己用、学习用、非营利机构用——免费；拿去赚钱（公司内部提效也算）——找作者买商业授权。 协议是 PolyForm Noncommercial 1.0.0，哪些算商用、怎么谈见 COMMERCIAL-LICENSE.md。
买授权不解锁功能。 只有一份代码，就是这个仓库，你看到的就是全部：Agent 主循环、40+ 工具、短剧画布、IM 远程指挥、执行追踪、自进化与记忆，连多租户和企业管理后台都在里面——没有功能开关，没有试用倒计时，没有灰按钮。买的是另外三样：一张允许你拿它赚钱的许可证、商标与白标的口子、能找到人的支持 → 开源与商业版边界
有一部分连非商业限制都没有。 部署配置、CI 流水线、脚本、评测集、技能模板、文档里的示例代码，额外按 MIT 发布 → LICENSE-ECOSYSTEM.md。而你自己写的技能、插件、连接器配置是你自己的作品，跟这份协议无关。
这份协议不授予任何第三方产品、商标、logo、品牌素材或截图的权利，那些归各自权利人。
Copyright (c) 2026 开发者猫叔
这是什么。 OpenWorkBuddy（仓库 CatCatUncle/openworkbuddy）是 开发者猫叔 从零写起的独立开源项目，源码全在本仓库。架构、工具协议、权限模型、记忆与自进化都是自行设计实现；借鉴过的外部项目在 NOTICE.md 第四节逐条列了。名字是 Work + Buddy 两个通用英文词加开源项目通行的 Open- 前缀，直白描述这个项目做的事。
与第三方的关系：没有。 本项目与腾讯公司及其 WorkBuddy 产品无任何关联、授权、赞助或背书，不含其任何代码、素材、界面资源或非公开信息。「WorkBuddy」若为他人注册商标，权利归各自权利人；文档中提及第三方名称时仅为说明兼容性或做事实区分（指示性使用）。对接飞书、企业微信、QQ 等一律走各自公开发布的开放接口，不涉及逆向工程。
权利人若觉得哪里不妥，请通过 Issues 或 COMMERCIAL-LICENSE.md 里的方式直接联系我，核实后尽快改。
顺手把它转给一个天天手搓 PPT、周报、会议纪要的同事，比一百次曝光管用。
感谢每一个动手改过这个项目的人。想加入他们：参与贡献。