CatCatUncle/openworkbuddy

本机优先的 AI 办公工作台，把你的资料和要求变成可打开、可修改的文件。
给经常做周报、PPT、表格和文档的人，也给需要自托管的团队。
使用你选择的模型，查看执行过程，在成果区核对交付文件。

▶ 做一份项目汇报 PPT · 下载安装包 · 项目网站 · 文档 · English

_{个人非商用、学校和公益机构免费；公司及个人商用须获 商业授权。模型与媒体服务的费用由所选服务商决定。}

_{界面流程演示；首次成功耗时按下面的任务实测。}

前置条件：一台能运行应用的电脑，以及一个可用的模型服务、已安装的本地模型或已登录的本机 CLI。用 API 时需要自己的 Key。本例用文字和简洁图形生成 PPT，不需要生图、视频、消息渠道或额外连接器；准备 PowerPoint、WPS 或 LibreOffice，方便下载后打开检查。

1. 安装并启动。 macOS / Windows 在 Releases 选择适合芯片的安装包：Windows 安装版 *-win-setup.exe，免安装版 *-win-x64-portable.exe / *-win-arm64-portable.exe；macOS 用 .dmg。Linux 用下方源码方式或 Docker 部署。
2. 连接模型。 首次启动注册账号；在「设置 → 模型」选择服务商、填写准确型号和 API 地址、添加 Key，再测试连接。已有本机 CLI 的用户也可在「设置 → 智能体」选择它。
3. 复制任务，打开结果。 选择 Craft 执行模式，粘贴下面的任务。完成后在「成果文件」预览或下载 project-update.pptx，用演示软件打开核对四页内容，再试一句“把第 4 页的下周计划改成两列表格，保留其他页”。

请做一份 4 页的项目汇报 PPT，保存为 project-update.pptx。
汇报对象：项目负责人。项目：示例网站上线。
第 1 页｜封面：示例网站上线——项目进展汇报。
第 2 页｜本周完成：上线产品页；修复移动端菜单。
第 3 页｜当前进展：正在补充用户指南。
第 4 页｜下周计划：完成英文版；收集 5 条试用反馈。
要求：16:9、中文、简洁商务风；正文使用可编辑文本，
每页一个重点、字号适合投屏、无文字溢出；保留原始事实，不补造数据。
写完确认文件存在，并在成果区提供可打开的文件。

成功标准：磁盘上有非空的 project-update.pptx；PowerPoint、WPS 或 LibreOffice 能打开，四页内容与输入一致、文字可编辑、排版无溢出；第二次要求能更新同一份文件的第 4 页。看到聊天回复或“安装完成”，都还未达到这次任务的成功标准。可复制的任务文件：中文 / English。

计时方式：从开始安装计到首次打开且核对通过，分别记录下载、启动、模型配置和任务等待。“三分钟”是优化目标，实际时间取决于网络、模型准备情况和任务执行，当前没有发布实测成功率。

git clone https://github.com/CatCatUncle/openworkbuddy.git
cd openworkbuddy
npm ci
npm start

跑通后再试 核心场景，或阅读 用户指南。觉得有用可以 Star 收藏；要收到新版本通知，设置 Watch → Custom → Releases。

字号、主题和显示密度可在「头像菜单 → 外观」调整。

HTML 内嵌预览使用隔离的临时存储（localStorage、sessionStorage 各最多 64 MiB，关闭后清除）。需要让网页保存业务数据时，点预览上方的「本地部署并打开」；它会启动仅本机可访问的服务并打开当前网页，数据可跨页面刷新保留。此时使用浏览器原生存储配额，具体上限因浏览器而异；重要数据仍应使用网页自己的导出/备份功能。

OpenWorkBuddy：开源的 AI 办公助理，跑在自己电脑上。
说一句话，它自己规划、动手、验收，交给你能打开的 PPT / Word / Excel / 网页，不是一段聊天记录。
· 模型随便换：DeepSeek、通义、Kimi、智谱、Ollama，本机的 Claude Code / Codex 也能直接当发动机
· 数据全在本机，默认只听 127.0.0.1；也能放服务器给团队用，每个人绑自己的微信、飞书
· 加个能力 = 丢一个 Markdown 文件
适合：天天做 PPT、周报、调研报告的人；想私有化部署 AI 助理的团队；想读懂 Agent 怎么搭的开发者。
个人非商用免费：https://github.com/CatCatUncle/openworkbuddy

「同一个人，换四个场景，手里举块写着字的牌子——要像随手拍的，别像 AI 图」

难的不是画人，是四张里得是同一个人、牌子上的中文不能糊。它先出一张，再用看图工具真去读自己刚生的那张（不是凭记忆吹），确认了才照这个方向铺开其余三张。

「做个湖南旅游攻略网站，14 个市州一个都不能少」

https://hunan-travel.pages.dev/ —— 点开就能逛。一个 HTML 加一个图片文件夹，不挂任何外部 CDN，扔到静态托管上就是一个站。这不是截图拼的示意图，是它交出来的那份东西本身。

「我要去北京玩三天，给我做一个旅游规划，用地图组件」

回答里的行程直接画成一张行程卡：按天切换，地图上按顺序标好每个地点，右边是带照片的地点卡片。点「打开路线」，这一天的几站按顺序整条带进地图，站名和卡上一样；国内默认用高德打开，旁边能换成 Google（上面第二张就是），国外开 Google 地图；「发到手机」出二维码，扫了在手机上接着走。右上角切到「时间线」，一天从上午排到晚上。不填 Key 也能用；在 设置 → 地图 填了高德 Key，国内地点更准。

「每天早上七点，把今天的天气和该注意的事发到我飞书」

一句话排出来的定时任务，人不在电脑前也照跑；每趟调了哪些工具、为什么这么说，都在「自动化 → 运行记录」里点得开。飞书 / 企微 / 钉钉 / Telegram 同一条路。

怎么做到的、本机 Claude Code 当发动机长什么样 → 三个案例，拆开讲

剧本、角色、场景、分镜、参考图、视频、配音、时间线摆在同一张图上。连线不是装饰——它表示下一步生成真会去读的角色、首帧和声音。改哪个镜头，只有那个镜头重跑。

一句话做出来的 AI 短剧：说一句「做一集《不烧心》竖屏短剧」，剧本、定妆、分镜、首帧、镜头视频、成片一路做到底，下面这集 75 秒就是这么出来的（点封面看成片）。

左侧点「无限画布」就能开始。空白处拖拽平移，Shift+拖拽框选，Shift/⌘ 点节点加选减选，底部对话框里能 @ 引用任意节点和素材。

git clone https://github.com/CatCatUncle/openworkbuddy.git && cd openworkbuddy
bash deploy.sh --domain buddy.example.com # Docker + 自动 HTTPS

多租户、席位、额度、离职一键收权限都有。起来先注册管理员——第一个注册的就是超管。 → 部署 · 运维手册 · 多人协作 · 账号与部署运维

设置 → 模型，挑预设（OpenAI / Anthropic / OpenRouter / DeepSeek / 通义 / 智谱 / Kimi / 火山方舟 / Ollama），粘 Key，保存即生效。生图、配音、生视频另有一张表。对照表 → 配置模型

openworkbuddy 跟桌面版共用同一份配置、技能、记忆、连接器和会话——终端里起的活儿，手机和网页上看得见、插得上话；桌面上做到一半，终端里 openworkbuddy resume 接着往下走。

默认简洁显示，只保留当前进度、最终回答和本轮实际成果。/details 看工具过程，/usage 看用量，/verbose on 展开详情。生成网页后说“给我打开啊”，会直接交给本机程序打开；也可用 /open 1 或 /open 子目录/index.html。

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 等全部参数 → 命令行用法

入口分别在 server.js、cli.js、src/im/；Agent 在 src/agent/agent.js，工具在 src/agent/tools.js 与 src/tools/。会话、配置和用量记在本机 data/，任务文件写入项目工作区。代码分层 → 代码架构；任务流程 → 实现细节

• 10-20 文件链接按原项目定位，外部文件按完整路径打开；修复同名串页、部署串目录和切换预览时的迟到覆盖
• 10-20 安装版首次打开自动注册 CLI，无需另装 Node.js；源码目录移动后用 npm link 修复命令入口
• 10-20 首页缩为两组十个常用任务；任务行直接置顶、菜单重命名；关闭本机会话导入和只读分享
• 10-20 通知已读后不再反复提醒；区分本轮结束、停止和未完成；生成网页增加脚本语法检查，视频输出避免覆盖
• 10-20 源码更新先检查 Git 状态；有本地改动或分叉时保留原目录，避免更新时覆盖会话和成果
• 10-19 技术架构图按实际调用关系重画，改用可缩放 SVG，保证节点文字完整显示
• 10-19 任务可改名并显示日期；Goal 模式单轮 100 步后检查未完成项并有限续跑；沙箱拒绝会说明无法后台审批
• 10-19 网页内嵌预览临时存储上限增至 64 MiB；关闭预览后清除

完整历史见 变更记录。

它能跑命令、读写文件、上网，所以有命令审批、文件黑名单、URL 白名单、审计日志和四档权限；macOS 和 Windows 上，它跑的命令还套一层系统沙箱，读不到 Key 和账本。装别人的技能前会先过一遍静态体检，危险的默认不装——但它不是杀毒，装前自己读一眼 skill.md。 放公网前先读 安全，默认配置只为本机调。

用崩了、有想法、想一起改，进飞书群直接说：

• 用崩了、卡住了，开个 issue，哪怕只贴一句报错——你以为「只有我遇到」的坑，多半所有人都在踩。贴之前扫一眼，别把 API Key 带上。
• 10 分钟 写个技能：一个 Markdown 存成 skills/<名字>/skill.md，存盘即生效，模板在这
• 一晚上 挑个 issue 改：npm install && npm start 就跑起来，npm test 不用 API Key 也能全绿

项目结构、测试、PR 规范都在 参与贡献。不用先开 issue 问，直接发 PR。

买授权不解锁任何功能：只有这一份代码，没有功能锁、不倒计时，授权不联网验证。软件不向作者或任何第三方回传使用数据；检查更新时会去 GitHub Releases 查有没有新版（GitHub 能看到本机 IP）。 没授权就商用，权利人可以依法追究民事责任；未经许可删改版权声明，还可能单独构成侵权——依据和判例见 未授权商用的法律后果。

除了授权，我们还承接企业 AI 业务：

作者是前大厂 Agent 工程师，服务过跨境电商、制造业、AI 初创、私募金融机构、消费品巨头、国央企等客户。常驻深圳，欢迎来交流和考察。

📮 合作联系：联系维护者

在找 Claude Cowork、Codex、豆包办公、千问办公的开源替代，或者想给 DeepSeek 找一个 agent 外壳（harness）？每一家都写了一页老实对比，也写了什么时候还是用它更合适：

OpenWorkBuddy 是独立开源项目，跟上面这些公司都没有关联。

首次成功的试用流程、计时口径与缺失指标 → 采用与反馈。

在线文档：用户指南 · 开发者指南 · 中英文项目网站

• toolward —— 给 agent 用的技能 / MCP 连接器静态安检：37 条规则分六族，零运行时依赖。npm i -g toolward 装上，OpenWorkBuddy 自动把它当第二把尺子用，不装也完全不影响。同样是 PolyForm Noncommercial。

个人非商用、学校公益免费；公司使用（哪怕只在内部）和个人商用要买商业授权，公司可先免费试用 30 天。购买请联系维护者。

协议 PolyForm Noncommercial 1.0.0，细则和没授权商用的后果见 COMMERCIAL-LICENSE.md。部署配置、脚本、技能模板另按 MIT（清单）；名称和图标不在授权范围内。

复制或分发本软件的任何部分，都要带上协议全文（或网址）和 LICENSE 开头所有以 Required Notice: 开头的行。

官方发布只有 GitHub 上的 CatCatUncle/openworkbuddy 及其 Releases。非官方渠道的安装包不由作者提供更新和支持，使用者的授权以 PolyForm Noncommercial 1.0.0 的条件和商业授权为准。

KylinWork 等项目未经作者许可拿本项目代码二次开发，还擅自改了开源协议，作者已要求其全网下架。

Copyright (c) 2026 开发者猫叔 (DeveloperCatUncle)

独立开源项目，与腾讯及其 WorkBuddy 产品无任何关联，不含其代码或素材；对接的 IM 均走公开接口。借鉴来源见 NOTICE.md。有问题请开 Issue。

_{顺手把它转给一个天天手搓 PPT、周报、会议纪要的同事，比一百次曝光管用。}

感谢每一个动手改过这个项目的人。想加入他们：参与贡献。