Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

office-cli-setup

WorkBuddy 装上 OfficeCLI 的一键安装脚本 —— 让 AI 真的会做 PPT / Word / Excel。

Windows(PowerShell 里粘贴):

irm https://gitee.com/macxu/office-cli-setup/raw/master/install.ps1 | iex

macOS(终端里粘贴):

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 有没有格式问题

为什么不能直接跑官方 install.sh

官方脚本会探测机器上的 AI 工具目录并植入 skill —— 它认 ~/.claude~/.cursor~/.copilot10 个目录,里面没有 ~/.workbuddy

就算认了,它也只装根目录那 1 个 SKILL.mdskills/ 下另外 10 个专项技能(融资 BP、学术论文、财务模型、数据看板、Morph 动画…)一个都不装 —— 那 10 个才是真正值钱的部分。

本仓库的脚本就是补这两块。


前置条件

前置 说明
WorkBuddy 装好并至少启动过一次(要存在 ~/.workbuddy 目录)

就这一条。不需要装 git,不需要配 SSH key,不需要代理。


下载走哪条线

内容 地址 大小
二进制 d.officecli.ai(官方镜像) 32MB,实测 3 秒
skills 本仓库内置的 skills.zip(gitee raw) 760KB

两条都是国内直连。只有官方镜像挂了才回退 GitHub,那时脚本才去探测本机 HTTP 代理端口。

关于 skills.zip

打包自上游 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。

Windows

打开「开始菜单 → 搜索 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)

macOS

打开「访达 → 应用程序 → 实用工具 → 终端」,粘贴:

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

脚本做了什么

  1. 识别 CPU 架构(arm64 / x64)
  2. 从官方镜像解析最新版本号,下载对应二进制到 ~/.local/bin/
  3. SHA256 校验,不匹配直接终止,不会把半个文件装进去
  4. 过系统门禁:macOS 去隔离属性 + 本地自签名;Windows Unblock-File
  5. 下载 skills.zip 解压,铺 11 个 skill 到 ~/.workbuddy/skills/
  6. 数一遍装了几个,不够 11 个直接报错
  7. 自检:真造一个 pptx,写入文字再读回来验证

官方镜像失败会自动回退 GitHub 并借用本机代理。


装进去的 11 个技能

技能 干什么
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

中文不乱码、内容能读回来,就算通了。


踩坑记录

坑 1:下载一直失败

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

坑 2:git clone 卡死几分钟

上游仓库带完整 .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 skills

坑 3:技能静默失效

skills/officecli/SKILL.md 在上游仓库里是一根指向 ../../SKILL.md 的软链接。

  • macOScp -R 会拷成断链,必须写 cp -RL。检查:find ~/.workbuddy/skills -type l | wc -l 必须是 0
  • Windows:git 默认 core.symlinks=false,会把软链检出成一个内容是 ../../SKILL.md 的 30 字节文本文件。

两种情况 WorkBuddy 都读不到内容,且不会报错 —— 只是这个 skill 静默失效。

本仓库的 skills.zip 在打包时就把软链解开了,跑脚本碰不到这个坑;手动 clone 更新时才要注意。

坑 4:提示「已损坏,无法打开」

macOS 门禁拦截未签名二进制:

xattr -d com.apple.quarantine ~/.local/bin/officecli
codesign -s - -f ~/.local/bin/officecli

Windows 上是 SmartScreen,对应 Unblock-File

坑 5:WorkBuddy 里报写权限错误

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 秒空闲自动退出,不会一直占内存。

相关

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages