跑在你自己电脑上的 AI 办公助理——交代一句话，它自己规划、动手、验收，把 PPT / Word / Excel / 网页落到你硬盘上
更新于 2026-09-26 · v0.9.5
← 返回汇总给你的是能打开的文件，不是一段聊天记录
开源的本地优先 AI 办公 agent，官方定位为 Claude Cowork / Codex / WorkBuddy / 豆包办公 / 千问办公的开源替代。模型随便换（DeepSeek / 通义 / 智谱 / Kimi / OpenRouter / Ollama，BYOK），本机装了 Claude Code / Codex 的还能一键拿它们当执行引擎。适合：天天手搓 PPT / 周报 / 会议纪要的办公族、想给 DeepSeek 找 agent 外壳的开发者、想读懂 agent 内部构造的学习者。
2026-08-10 创建 · 2026-09-25 最近 push · 09-21 至 09-24 四天发了 10 个 release · 数据采集于 2026-09-26
多数「AI 办公」产品给你一段 Markdown 回复，还得自己粘到 Office 里排版。OpenWorkBuddy 直接交付能打开的 .pptx / .docx / .xlsx / .html，而且验收环节真的去查文件在不在磁盘上。
商业办公 agent 通常绑定自家模型，贵且不可换。这里是 BYOK：九家预设界面点一下就切，本机有 Claude Code / Codex 订阅的直接当发动机，不烧 API 额度。
会议纪要、财报数据都过一遍厂商服务器。这里会话、文件、Key 全在本机（~/OpenWorkBuddy），默认只听 127.0.0.1。
加一个能力 = 丢一个 Markdown 文件：skills/<名字>/skill.md 存盘即生效，不改代码、不重启、不打包。
# 设置 → 模型：挑预设、粘 Key、保存即生效 预设: OpenAI / Anthropic / OpenRouter DeepSeek / 通义 / 智谱 / Kimi 火山方舟 / Ollama # 本机有 Claude Code？直接当引擎 openworkbuddy engines use claude-code openworkbuddy engines use codex # 生图、配音、生视频单独一张表 TTS → 豆包 / 通义 / … Image → 即梦 / DALL·E / … Video → 可灵 / Seedance / …
DeepSeek 一类模型的工具调用是权重里的特殊 token，经某些中转层不会被解析进 tool_calls，而是原样解码进正文——模型「以为」抓了网页，实际什么都没发生，接着编造结果。llm.js 认出这些标记、还原成真正的工具调用去执行；流式输出上设闸门，特殊 token 不漏到界面。
会话、账本、定时任务表先写临时文件再改名（原子），改名前留 .bak。文件坏了先拿 .bak 顶上，连 .bak 都没有就隔离成 .corrupt-时间戳 留人工捞，绝不静默当空文件——否则下次保存就把用户对话永久覆盖了。账本 users.json 走 strict：坏了直接报错，回退可能吞掉一笔充值。
浏览器级请求头（B 站 / 微博不再 412 风控）；fetch_url 抓到空壳时自动用 Electron 内置 Chrome 真渲染动态页；渲染也失败时返回「为什么失败 + 还能换哪三条路」。系统提示词配套纪律：同一目标至少真试满三种路子才许说做不到，且不许把选择题丢回给用户。
一轮里 5 个 web_search / fetch_url / read_file 并发执行（上限 3 路），只花最慢一次的时间；批次里只要混进写文件、跑命令、委派专家的调用，整批退回串行——那些工具的先后顺序本身就是语义。过程卡按调用 id 配对，结果不会贴错卡。
官方 SSR 模式纯 Node 出 SVG。坑：SSR 会留着动画定时器让进程永不退出，必须 chart.dispose() + 强制 animation:false。
@viz-js/viz（WASM）纯 Node 渲染，画架构图 / 依赖图最稳。中文节点要设 fontname="PingFang SC"，否则全是豆腐块。
必须要真浏览器量文字宽度——应用本体跑在 Electron 里等于随身带 Chrome：开隐藏窗口渲染完就销毁。CLI 环境降级走 kroki.io。
本机装了 plantuml 就用本机的，没有就 deflate + base64 变种发给 kroki。回复正文里的 ```svg 围栏当图渲染，SVG 流式吐出时每来一段补全重画一次——图是一笔一笔长出来的。每张图另导 2x 高清 PNG（飞书云文档不收 SVG）。安全上走清洗：script / foreignObject / on* 事件 / 外链全剔掉，样式规则改写成 #svgfigN 锁死图内，通名 .t 不会污染页面。
| 体检指标 | 数值 | 说明 |
|---|---|---|
| skill-guard 规则 | 34 条 | block 10 / warn 24 / ok |
| 公开标注集检出率 | 74.9% | 约四个漏一个——静态规则的上限 |
| 自家 36 技能误拦 | 2 个 | 都是真命中：讲解攻击的资讯正文 |
| frontmatter description | 升一级 | 常驻系统提示词，注入风险更高 |
| node_modules / .venv | 不逐文件扫 | 实测一个 .venv 贡献 60+ 假命中 |
定位是「装之前把话说清楚」，不是查毒——block 必须能被显式放行，人绕不过去的闸，人就会绕过整个工具。
; && || | & 换行、$( ) 反引号、子 shell、环境变量前缀、全路径、nohup 套壳——10 种变体全拆开查；引号里的不当真（echo "记得 rm 掉旧文件" 不误弹审批）cat ~/.ssh/id_rsa 也过不去——拦的是「顺手」，不是刻意绕，别把这当沙箱require("child_process").execSync(...) 就从旁边过去了；审计日志环形 1000 条，审批超时 120 秒按拒绝算| 入口 | 形态 | 关键点 |
|---|---|---|
| 桌面端 / Web | Electron App · localhost:3800 | 成果面板 · 过程卡 · 无限画布 · 外观设置 |
| CLI | openworkbuddy | 与桌面版共用同一份配置 / 技能 / 记忆 / 会话；resume 接续、-q 纯输出、管道喂料、退出码 0/1/2/130 说实话；单发和管道模式不反问，cron 里不会卡住 |
| IM 远程 | 飞书 / 企微 / 钉钉 / Telegram / QQ / 微信 | 人不在电脑前也照跑；pair 扫码把手机连上来 |
| 定时任务 | cron 式调度 | 错过会补跑；每趟调了哪些工具、为什么这么说，运行记录里点得开 |
bash deploy.sh --domain buddy.example.com 一条命令 Docker + 自动 HTTPS；多租户、席位、额度、离职一键收权限。第一个注册的就是超管。
npm install && npm start 就跑起来，npm test 不用 Key 也能全绿——贡献门槛压到一晚上。
| 你说一句 | 它交给你 |
|---|---|
| 帮我出一份 Q3 复盘 PPT，数据用这个 Excel | 读表 → 算 → 一个能直接放的 .pptx |
| 调研国内 AI 陪伴产品，出一份报告 | 联网搜 → 逐个打开读 → Markdown / Word |
| 把这份材料做成手机上能看的网页 | 写 HTML → 起本机服务 → 扫码就能看（成品 hunan-travel.pages.dev，14 市州湖南旅游站，零外部 CDN） |
| 每天 9 点抓行业新闻，做成晨报发我飞书 | 定时任务 + IM 推送，错过了会补跑 |
剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。连线不是装饰——表示下一步生成真会去读的角色、首帧和声音。改哪个镜头，只有那个镜头重跑。
「同一个人换四个场景」难在一致性：它先出一张，再用看图工具真去读自己刚生的那张（不是凭记忆吹），确认了才照这个方向铺开其余三张——牌子上的中文不能糊。
# macOS：一个弹窗都没有 curl -fsSL https://raw.githubusercontent.com/\ CatCatUncle/openworkbuddy/main/install-mac.sh | bash # Windows：Releases 下 -win-setup.exe # （x64 / ARM 通用）；不让装软件就用 # 免安装版 -win-x64-portable.exe # 源码：Node.js 18+，零构建 git clone https://github.com/CatCatUncle/openworkbuddy.git cd openworkbuddy && npm install npm run app # 桌面版；或 npm start → :3800 # 服务器版：Docker + 自动 HTTPS bash deploy.sh --domain buddy.example.com
openworkbuddy doctor 先体检，配好没有一目了然agent 手里有 shell，OpenWorkBuddy 用四档权限 + 逐段拆解的命令闸管住它。选一个档位、敲一条命令，看它当场怎么判——放行、问一句、还是拦下。试试 echo $(rm -rf ~/x) 这种套壳变体。
规则表复刻自 docs/安全.md 的四档权限与拆段逻辑（演示级）· 零网络依赖 · 单文件
评分 8.0：国产开源 AI 办公 agent 里完成度罕见的一个——桌面 / CLI / IM / 定时任务四入口共享一套大脑，BYOK + 拿 Claude Code 当发动机的模型路由切中痛点，「文件验收闸门 + 断点续跑 + 工具调用救援」这批工程细节是踩过真实坑才会写的。文档密度（20+ 篇 docs）和对标页打法（Claude Cowork / Codex / 豆包办公逐家对比）显出成熟的产品自觉。扣分：PolyForm NC 挡住公司采用（个人免费但团队上不了）、单人维护的可持续性、204 stars 生态尚小。看点：Skills 市场化、toolward 式安全生态、v1.0 后的 API 稳定。个人办公自动化的当下最优选之一，团队采用先谈授权。