给 WorkBuddy 装上 OfficeCLI 的一键安装脚本 —— 让 AI 真的会做 PPT / Word / Excel。
Windows(PowerShell 里粘贴):
irm https://gitee.com/macxu/office-cli-setup/raw/master/install.ps1 | iexmacOS(终端里粘贴):
curl -fsSL https://gitee.com/macxu/office-cli-setup/raw/master/install.sh | bash前置只有一条:装好 WorkBuddy 并启动过一次。详见用法。
| 脚本 | 平台 | 状态 |
|---|---|---|
install.sh |
macOS (Intel / Apple Silicon) | 端到端实测通过 |
install.ps1 |
Windows (x64 / ARM64) | 未实测,欢迎提 issue |
WorkBuddy 能聊、能写代码、能读文件。但你让它「做一份 Q4 汇报 PPT」,它没有一双手去真正操作 .pptx。
OfficeCLI 就是这双手:不依赖 Microsoft Office、不依赖 Python 库的单文件命令行工具,直接读写 .docx / .xlsx / .pptx。
装完之后你说人话,它自己调命令干活:
帮我把这份 CSV 做成带 KPI 卡片和图表的 Excel 看板
这份合同帮我改成可填写表单,只留签名和日期能编辑
做一份 A 轮融资的 pitch deck,深色系,12 页
检查这份 Word 有没有格式问题
官方脚本会探测机器上的 AI 工具目录并植入 skill —— 它认 ~/.claude、~/.cursor、~/.copilot 等 10 个目录,里面没有 ~/.workbuddy。
就算认了,它也只装根目录那 1 个 SKILL.md,skills/ 下另外 10 个专项技能(融资 BP、学术论文、财务模型、数据看板、Morph 动画…)一个都不装 —— 那 10 个才是真正值钱的部分。
本仓库的脚本就是补这两块。
| 前置 | 说明 |
|---|---|
| WorkBuddy | 装好并至少启动过一次(要存在 ~/.workbuddy 目录) |
就这一条。不需要装 git,不需要配 SSH key,不需要代理。
| 内容 | 地址 | 大小 |
|---|---|---|
| 二进制 | d.officecli.ai(官方镜像) |
32MB,实测 3 秒 |
| skills | 本仓库内置的 skills.zip(gitee raw) |
760KB |
两条都是国内直连。只有官方镜像挂了才回退 GitHub,那时脚本才去探测本机 HTTP 代理端口。
打包自上游 459b1a4(对应 v1.0.143),11 个 skill,软链接已在打包时解开 —— 所以 Windows 上不会出现「skill 静默失效」那个坑。含 LICENSE / NOTICE,满足 Apache-2.0 第 4 条的再分发要求。
代价是它是个快照,上游更新了这里不会自动跟。想拿最新的自己来一发:
git clone --depth 1 --filter=blob:none --sparse https://github.com/iOfficeAI/OfficeCLI.git
cd OfficeCLI && git sparse-checkout set skills
cp -RL skills/* ~/.workbuddy/skills/ # -L 不能省,见坑 3复制一行,粘进终端,回车。不用 clone 仓库,不用装 git。
打开「开始菜单 → 搜索 PowerShell → 回车」,粘贴:
irm https://gitee.com/macxu/office-cli-setup/raw/master/install.ps1 | iex提示「无法加载文件,因为在此系统上禁止运行脚本」的话,先跑一次这个再重试:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned极小概率报一个莫名其妙的语法错误(脚本带 UTF-8 BOM,老版本 PowerShell 可能不吃),换这条:
iex (irm https://gitee.com/macxu/office-cli-setup/raw/master/install.ps1).TrimStart([char]0xFEFF)
打开「访达 → 应用程序 → 实用工具 → 终端」,粘贴:
curl -fsSL https://gitee.com/macxu/office-cli-setup/raw/master/install.sh | bash看到 全部完成 就成了。然后 完全退出并重启 WorkBuddy(⌘Q / 托盘退出,不是关窗口)—— skill 目录是启动时扫描的。
不想直接管道执行的话,先把脚本下下来看一眼再跑也一样:
curl -fsSLO https://gitee.com/macxu/office-cli-setup/raw/master/install.sh && bash install.sh- 识别 CPU 架构(arm64 / x64)
- 从官方镜像解析最新版本号,下载对应二进制到
~/.local/bin/ - SHA256 校验,不匹配直接终止,不会把半个文件装进去
- 过系统门禁:macOS 去隔离属性 + 本地自签名;Windows
Unblock-File - 下载
skills.zip解压,铺 11 个 skill 到~/.workbuddy/skills/ - 数一遍装了几个,不够 11 个直接报错
- 自检:真造一个 pptx,写入文字再读回来验证
官方镜像失败会自动回退 GitHub 并借用本机代理。
| 技能 | 干什么 |
|---|---|
officecli |
主技能,命令总纲 + 帮助系统 |
officecli-docx |
Word 通用:报告、信函、备忘录、模板、修订、目录 |
officecli-xlsx |
Excel 通用:公式、图表、透视表、CSV 导入 |
officecli-pptx |
PPT 通用:建页、排版、母版、备注 |
officecli-pitch-deck |
融资 BP(种子 / A / B / C 轮) |
officecli-academic-paper |
学术论文:APA / MLA / IEEE 双栏、公式编号、参考文献 |
officecli-financial-model |
财务模型:三表、DCF、LBO、敏感性分析、IRR |
officecli-data-dashboard |
Excel 数据看板:KPI 卡片、迷你图、条件格式 |
officecli-word-form |
可填写表单:内容控件、复选框、文档保护 |
morph-ppt |
Morph 平滑动画 PPT,自带一批设计好的 .pptx 样式模板 |
morph-ppt-3d |
在 Morph 基础上加 GLB 3D 模型和运镜 |
officecli/docx/xlsx/pptx四个实测跑通了完整的增删改查。 后面 7 个场景技能是官方随仓库提供的,本脚本只负责把它们正确装到位。
cd /tmp && mkdir -p octest && cd octest
officecli create t.pptx
officecli add t.pptx / --type slide --prop title="安装成功" --prop background=1A1A2E
officecli close t.pptx
officecli view t.pptx text # 应该原样吐出上面的字
officecli create t.xlsx
officecli set t.xlsx /Sheet1/A1 --prop value="指标" --prop bold=true
officecli close t.xlsx
officecli get t.xlsx /Sheet1/A1 # 应输出 "指标" ... font.bold=true中文不乱码、内容能读回来,就算通了。
mirror unreachable, falling back to github...
Download failed.
官方 install.sh 会先试 d.officecli.ai 再回退 GitHub,两条都断的时候就是这个报错。
本仓库脚本默认走国内源(镜像 + gitee),正常情况下碰不到这个坑。真要回退 GitHub 了,脚本会自动探测本机 HTTP 代理端口。手动的话给 curl 加 --proxy http://127.0.0.1:你的端口。
不确定本机代理开在哪个端口,扫一下:
for p in 7897 7890 1087 8888 6152 10808 10809; do nc -z -G1 127.0.0.1 $p && echo "开着: $p"; done上游仓库带完整 .NET 源码,直接 clone 很慢。本仓库脚本改用 skills.zip 已经绕开了;只有你想手动更新 skills 时才会碰到。稀疏克隆只拉 skills,1.8MB 秒下:
git clone --depth 1 --filter=blob:none --sparse https://github.com/iOfficeAI/OfficeCLI.git
cd OfficeCLI && git sparse-checkout set skillsskills/officecli/SKILL.md 在上游仓库里是一根指向 ../../SKILL.md 的软链接。
- macOS:
cp -R会拷成断链,必须写cp -RL。检查:find ~/.workbuddy/skills -type l | wc -l必须是 0。 - Windows:git 默认
core.symlinks=false,会把软链检出成一个内容是../../SKILL.md的 30 字节文本文件。
两种情况 WorkBuddy 都读不到内容,且不会报错 —— 只是这个 skill 静默失效。
本仓库的 skills.zip 在打包时就把软链解开了,跑脚本碰不到这个坑;手动 clone 更新时才要注意。
macOS 门禁拦截未签名二进制:
xattr -d com.apple.quarantine ~/.local/bin/officecli
codesign -s - -f ~/.local/bin/officecliWindows 上是 SmartScreen,对应 Unblock-File。
WorkBuddy 有沙箱。officecli 运行时会在 ~/.officecli 存配置,如果被拦,编辑 ~/.workbuddy/settings.json,在 sandbox.extraAllowWrite 数组里加:
"~/.officecli"注意 WorkBuddy 在某些情况下会重写 settings.json,加过的项可能丢失。
没报错就别加。
rm ~/.local/bin/officecli ~/.local/bin/.officecli-skills-installed
rm -rf ~/.officecli
cd ~/.workbuddy/skills && rm -rf officecli* morph-ppt morph-ppt-3d重启 WorkBuddy 即恢复原状。
- OfficeCLI 是文件操作层,不是排版设计师。审美取决于 skill 里写的设计规则和你的描述。
- 不需要装 Office,但生成的文件最终还是要用 Office / WPS / Keynote 打开看效果。
- 单文件二进制 32MB,常驻进程模式默认 60 秒空闲自动退出,不会一直占内存。
- OfficeCLI 上游仓库:https://github.com/iOfficeAI/OfficeCLI
- 国内镜像仓库:https://gitee.com/jerrycell/ai-office-cli