快速开始：做一份项目汇报 PPT
前置条件：一台能运行应用的电脑，以及一个可用的模型服务、已安装的本地模型或已登录的本机 CLI。用 API 时需要自己的 Key。本例用文字和简洁图形生成 PPT，不需要生图、视频、消息渠道或额外连接器；准备 PowerPoint、WPS 或 LibreOffice，方便下载后打开检查。
- 安装并启动。 macOS / Windows 在 Releases 选择适合芯片的安装包：Windows 安装版
*-win-setup.exe，免安装版 *-win-x64-portable.exe / *-win-arm64-portable.exe；macOS 用 .dmg。Linux 用下方源码方式或 Docker 部署。
- 连接模型。 首次启动注册账号；在「设置 → 模型」选择服务商、填写准确型号和 API 地址、添加 Key，再测试连接。已有本机 CLI 的用户也可在「设置 → 智能体」选择它。
- 复制任务，打开结果。 选择 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
看到服务已启动后，打开 http://localhost:3800，继续上面的第 2、3 步。桌面开发模式用 npm run app。开发时数据默认在仓库的数据目录；安装包的数据默认在 ~/OpenWorkBuddy。完整说明见 安装与启动。
卡住时先看这里
| 卡在哪 | 下一步 |
|---|
| 系统阻止首次打开 | 按 安装与启动 对应系统的说明处理 |
npm ci 在 Electron 下载处失败 | 核对网络与 Node 版本，查看 源码启动排错 |
| 服务启动报端口占用 | macOS / Linux 用 PORT=3801 npm start；Windows cmd 用 set PORT=3801 && npm start，打开新端口 |
| 测试连接失败，或任务报上游错误 | 核对服务商的 API 地址、型号、Key 和额度，见 模型配置 |
| 任务在等批准或答复 | 查看输入框上方的审批卡或收件箱，处理后继续 |
| 回复说完成但找不到文件 | 确认当前项目，在成果区和工作目录核对文件；让助理检查 project-update.pptx，不要直接把这次计作成功 |
跑通后再试 核心场景，或阅读 用户指南。觉得有用可以 Star 收藏；要收到新版本通知，设置 Watch → Custom → Releases。
字号、主题和显示密度可在「头像菜单 → 外观」调整。
v0.18.3 的预览优化会在首次打开及预览栏尺寸变化时自动适配，手动放大后保留所选比例，无需先点击“适合宽度”。详见 预览操作与格式限制；自 v0.18.3 提供。
删除历史任务时，可同时清理应用为该任务创建的独立文件夹（默认勾选，也可取消勾选保留成果）。桌面版将文件移入系统废纸篓；纯服务端运行时移入原工作目录的 .trash/tasks/，附带 restore.json 记录原位置。项目根目录和多个任务共用的文件夹会保留。正在运行的任务会先停止并完成收尾；清理失败时，对话仍保留并显示原因。
整理中间文件和资料库删除改为可恢复回收：桌面版进入系统废纸篓/回收站，服务端保存在原目录 .trash/files/ 并记录原路径；不再仅凭 out/ 等目录名清理整目录，有任务或后台命令在运行时禁止回收。详见 文件清理与恢复。回收后仍占用空间，系统回收失败不会转为永久删除。
当前 macOS 发行包使用本地签名，尚未通过 Apple 公证。请使用本仓库 Releases 的安装包。
- macOS「无法验证」：如你选择继续安装，先关闭提示，进入 系统设置 → 隐私与安全性 → 仍要打开，按系统要求确认。Apple 操作说明。
- macOS「已损坏」：先重新下载；仍打不开时按安装与启动检查签名与启动日志，不能只按「无法验证」处理。
- Windows：核对下载来源后，在 SmartScreen 选择「更多信息 → 仍要运行」。
- 双击没反应：查看
~/OpenWorkBuddy/logs/boot.log，见双击了没反应。
HTML 内嵌预览使用隔离的临时存储（localStorage、sessionStorage 各最多 64 MiB，关闭后清除）。需要让网页保存业务数据时，点预览上方的「手动在浏览器打开」；它会启动仅本机可访问的服务并打开当前网页，数据可跨页面刷新保留。此时使用浏览器原生存储配额，具体上限因浏览器而异；重要数据仍应使用网页自己的导出/备份功能。
你说一句，它交给你
| 你说一句 | 它交给你 |
|---|
| 帮我出一份 Q3 复盘 PPT，数据用这个 Excel | 读表 → 算 → 一个能直接放的 .pptx |
| 调研国内 AI 陪伴产品，出一份报告 | 联网搜 → 逐个打开读 → Markdown / Word |
| 把这份材料做成手机上能看的网页 | 写 HTML → 起本机服务 → 扫码就能看（成品） |
| 每天 9 点抓行业新闻，做成晨报发我飞书 | 定时任务 + IM 推送，错过了会补跑 |
| 做个 30 秒产品宣传片，竖版横版各一份 | 填表挑时长、画幅、声音 → 配音、动效、合成 → .mp4 |
[!NOTE]
多任务并行、目标验收、👍👎 进自进化、双层记忆、权限档位、IM 远程指挥、桌面宠物…… 全部能力见 功能清单。
为什么是它
📄 文件是真的。
PPT / Word / Excel / 网页都真生成，成果面板里点开就能验收。交付后在成果区和磁盘上核对实际文件。
🔌 模型随便换，东西全在你手里。
DeepSeek / 通义 / 智谱 / Kimi / OpenRouter / Ollama 界面点一下就切；本机装了 Claude Code / Codex 的，一键拿它当发动机，不用另买 token。配置与成果文件留在本机，默认只听 127.0.0.1；云模型和远程连接器会收到完成任务所需的数据。
🧩 加个能力 = 丢一个 Markdown 文件。
存成 skills/<名字>/skill.md，存盘后下一条任务就生效——不改代码、不重启、不打包。
🔍 也适合拿来读懂 Agent。
模型路由、工具调用、文件验收、记忆、权限、本地 Trace 全在同一个仓库里：一条真实任务，从它为什么这么做到最后交了什么，你都看得见。
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，国内地点更准。
「每天早上七点，把今天的天气和该注意的事发到我飞书」
应用运行时，定时任务可自动执行；每趟过程和通知送达状态都在「自动化 → 运行记录」。飞书主动通知需在助理设置保存机器人凭证和接收 ID；详见 IM 与定时任务。
怎么做到的、本机 Claude Code 当发动机长什么样 → 三个案例，拆开讲
创作无限画布
从一张图、一段视频或一组素材开始：卡片里写描述、连接参考、生成、做变体或继续做视频。短剧工作流还支持剧本、角色、场景、分镜、配音与时间线，连线会成为实际生成输入。按 / 搜节点，图片能切宫格、批量做视频，常用的一组卡能存成工作流。
角色定妆照、场景图都能在卡片里填写设定、选择图像模型。未指定型号时跟随当前窗口的默认模型，Agent 写入未配置型号时会被拦下。型号失效时会先提示重新选择；点「默认模型」可覆盖旧的剧本设置。使用与排错。
火山视频的人像审核错误会保留在卡片上；支持已审核素材 ID 的参考生成，首尾帧传输保留原图。人像素材与模式说明。
一句话做出来的 AI 短剧：说一句「做一集《不烧心》竖屏短剧」，剧本、定妆、分镜、首帧、镜头视频、成片一路做到底，下面这集 75 秒就是这么出来的（点封面看成片）。
左侧点「无限画布」就能开始。空白处拖拽平移，Shift+拖拽框选，Shift/⌘ 点节点加选减选，展开底部 Agent 后可 @ 引用节点和素材。
卡片内可改模型、查看参考、对比版本；Agent 按需展开，空提示词不会生成。批量长高只让位一次，未选中的卡片也能看到生成失败原因。支持保留参考的复制、多选整理、小地图，以及画布与素材一起导出。操作与恢复方法见无限画布使用指南。
放服务器给团队用：多人、私有化部署
git clone https://github.com/CatCatUncle/openworkbuddy.git && cd openworkbuddy
bash deploy.sh --domain buddy.example.com # Docker + 自动 HTTPS
This is the beginning of the README. Read the rest at the original. Read the full README ↗
