从一条命令到 K8sOfficeCLI 无头 Office 文档自动化实战【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI每天下班前要生成两百份格式固定的发票和月报交付到对象存储。听起来是脚本活卡在环境上服务器没有显示、没有 Office 授权LibreOffice 无头模式装起来也重生成后没法确认排版对不对、结构合不合法。这类无头环境产出 Office 文档的活正是 OfficeCLI 要解决的。OfficeCLI 是面向 AI Agent 与自动化流水线设计的开源 Office 套件一个自包含二进制不需要安装 Microsoft Office就能创建、读取、修改和校验 .docx / .xlsx / .pptx。它内建 HTML 渲染引擎可以把文档渲染成 HTML 或 PNG——生成方看得见自己的产出。同一套 create / view / validate 命令在你本机、CI 里、容器里表现一致。一键装好 OfficeCLI3 分钟跑通第一条命令macOS / Linux 一行装Windows 用 install.ps1也可以走包管理器或手动下载静态二进制# macOS / Linux curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash # Windows PowerShell irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex # 包管理器 / 手动 brew install officecli # 或 scoop install officecli npm install -g officecli/officecli # 或直接从 GitHub Releases 下载对应平台的静态二进制脚本会把二进制放进 PATH并顺带把 officecli 技能文件装进它检测到的 AI 编码工具。装完立刻跑officecli --version有版本号输出才算装好。接下来三条命令出一份最小 PPT。create按扩展名决定文档类型add用--type声明要加的元素、--prop传属性两条view一条做结构校验、一条看大纲这是后面所有流水线的验证模板officecli create deck.pptx officecli add deck.pptx / --type slide --prop titleQ4 Report --prop background1A1A2E officecli add deck.pptx /slide[1] --type shape \ --prop textRevenue grew 25% --prop x2cm --prop y5cm --prop size24 --prop colorFFFFFF officecli validate deck.pptx # 按 OpenXML schema 校验结构非法直接报出来 officecli view deck.pptx outline # 预期看到Slide 1: Q4 Report / Shape 1 [TextBox]: Revenue grew 25%想在 CI 或 Agent 流程里看见结果把每页渲染成 PNGofficecli view deck.pptx screenshot -o /tmp/deck.png # 加 --page 1-10 指定页码范围这一步是 AI Agent 的眼睛把截图喂给多模态模型就能检查文字溢出、形状重叠、配色错误形成 render → look → fix 的闭环。能力地图Word、Excel、PPT 各能做什么Word从段落样式到修订模式段落、run 级字符属性、样式、表格、图表、LaTeX 公式、Mermaid 图、图片、页眉页脚、水印、目录TOC、表单域、修订模式tracked changes完整 i18n 和 RTL 支持。officecli create handbook.docx officecli set handbook.docx /body/p[1] --prop text员工手册 · 2026 --prop styleHeading1 officecli set handbook.docx /body/p[1]/r[1] --prop boldtrue --prop color1F4E79set直接改属性即可路径用/body/p[1]这种带 1-based 索引的稳定寻址。中文场景加--locale zh-CN创建段落级 RTL、按脚本分列的字体槽都可以直接设。Excel公式写入即算透视表一条命令单元格字体 / 填充 / 边框 / 数字格式、条件格式、数据校验、迷你图、切片器、14 种以上图表。350 内置函数在写入时自动求值——写完SUM(A1:A2)再get值已经在那里不依赖 Office 重算。数据透视表一条命令从源范围生成行 / 列 / 筛选多字段、10 种聚合、showDataAs、日期分组都支持打开 Excel 时聚合已经算好officecli add sales.xlsx /Sheet1 --type pivottable \ --prop sourceData!A1:E10000 --prop rowsRegion,Category \ --prop colsQuarter --prop valuesRevenue:sum,Units:avg \ --prop showDataAspercentOfTotalPowerPoint幻灯片到动画转场幻灯片、形状、表格、图片、多类图表、15 种强调与 16 种退出动画、Morph 与 12 个 2013 转场预设、3D 模型.glb、视频音频、演讲者备注、主题。批量加页时--prop background1A1A2E这类颜色值支持 hex、命名色、RGB、主题色四种写法。单机先跑通watch 预览加 validate 卡口进 CI 之前先在你机器上把反馈循环建起来。watch起一个本地服务浏览器自动刷新officecli watch deck.pptx # 打开 http://localhost:26315之后每条add/set/remove都会即时刷进浏览器Excel 的 watch 还支持单元格内联编辑和图表拖拽。调试模板时这个循环比改一次渲染一次快得多。在 CI 里跑文档生成进流水线的第一原则别在每次 run 里现装把静态二进制钉在版本上放进 PATH。这里以 v1.0.0 为例换成你固定的 tag# .github/workflows/docs.yml name: office-docs on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: install officecli run: | curl -fsSL -o /usr/local/bin/officecli \ https://d.officecli.ai/releases/download/v1.0.0/officecli-linux-x64 chmod x /usr/local/bin/officecli officecli --version - name: generate xlsx run: | officecli create sales.xlsx officecli import sales.xlsx /Sheet1 data/sales.csv --header officecli add sales.xlsx /Sheet1 --type chart --prop typebar --prop dataA1:D10 officecli validate sales.xlsx - name: render evidence run: officecli view sales.xlsx screenshot -o /tmp/sales.png - uses: actions/upload-artifactv4 with: name: office-output path: sales.xlsximport直接吃 CSVvalidate放在流水线里当质量卡点schema 不过这一版就不许出。最后用 screenshot 把产出截图上传成工件——文档生成流水线最缺的从来不是产出文件而是这次长什么样的证据。容器与 K8s一个二进制的镜像Dockerfile 不需要 Node、Python 或 .NET——运行时已经嵌在自包含二进制里。注意install.sh会按 musl / glibc 自动选对包Alpine 基础镜像直接可用FROM alpine:latest RUN apk add --no-cache curl RUN curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | sh RUN mv $HOME/.local/bin/officecli /usr/local/bin/officecli USER nobody CMD [officecli, --version]验证方式是docker run --rm --entrypoint officecli image --version。镜像里没有 Office、没有 LibreOffice只有这一个二进制。K8s 侧按普通无状态服务部署即可apiVersion: apps/v1 kind: Deployment metadata: name: officecli-worker spec: replicas: 2 template: spec: containers: - name: officecli image: your-registry/officecli:1.0.0 resources: requests: { memory: 256Mi, cpu: 250m } limits: { memory: 512Mi, cpu: 500m }常驻会话会把整份文档留在内存里文档越大占用越高limit 按你的文档体量上调即可。提效进阶merge 模板、dump 复刻、resident 会话merge——模板填 N 次。{{key}}占位符用 JSON 数据替换覆盖 .docx / .xlsx / .pptx跨越段落、表格、形状、页眉页脚和图表标题。模板设计一次贵之后生产代码只做确定性填充便宜cat invoice-001.json # {client:Acme,total:$5,200} officecli merge invoice-template.docx invoice-001.docx --data invoice-001.json批量出两百份发票时这比让 Agent 每份重新生成一遍布局可靠得多——后者每次产出的版式都可能漂移。dump / batch——从存量文档学结构。dump把任意文档或其中一棵子树一个表格、一张工作表、styles 部分序列化成可重放的 batch JSONbatch再把它放回去。拿一份同事做的模板研究结构然后批量产出同类版式不用手写 OOXMLofficecli dump existing.docx -o blueprint.json officecli batch new.docx --input blueprint.jsonresident——低延迟多步编辑。几百次修改逐条起进程开销很大open/close之间走命名管道常驻会话officecli open report.docx officecli set report.docx /body/p[1]/r[1] --prop boldtrue officecli close report.docx踩坑实录现象set明明成功下游 Python 脚本读到的还是旧内容。原因resident 模式为了低延迟会延迟落盘officecli自己的get/view总看到最新编辑但外部读取方python-docx、上传、渲染服务看到的是滞后的磁盘文件。解法交接前显式落盘——officecli save report.docx落盘且保持会话热或close落盘并释放流水线场景直接设OFFICECLI_RESIDENT_FLUSHeach让每条 mutation 在命令返回前就写进磁盘。现象安装脚本退出码 0officecli却提示 command not found。原因二进制装进了~/.local/binPATH 导出写进了 shell rc 文件当前 shell 还没重新加载。解法source ~/.bashrc或 zshrc或直接用全路径或把二进制挪进/usr/local/bin。判断标准只有一个装完立刻officecli --version有输出才算过。现象Alpine 容器里手动塞的二进制跑不起来。原因Release 同时发 glibc 与 alpine 两个变体musl libc 的镜像必须用officecli-linux-alpine-x64arm64 同理拿 glibc 版硬装会直接符号报错。install.sh本身会自动检测 musl 选对包只有手动挑 asset 时才容易拿错。边界与选型什么时候该用什么时候别用适合的场景标准化文档批量生成发票、报表、周报、CI 内产出与校验文档、无显示的容器环境、需要结构化 JSON 输出的 AI Agent。不适合的场景替代 Office 桌面端做交互式精细排版.doc / .hwpx 老格式的编辑只读 / 导出依赖插件Excel 重算语义必须与 Office 全量函数库逐一对齐的审计级场景内置引擎覆盖 350 常用函数但不是全集。性能量级参考单进程批处理百级文档在几十秒量级瓶颈通常在 I/O 与文档复杂度不在 CPU。你的需求更合适的选择交互式排版、人工精修版式Office / LibreOffice 桌面端只处理表格且团队全是 Pythonopenpyxl 等库直连无头生成 校验 渲染 Agent 集成OfficeCLI收束三步走装二进制并officecli --version验证本机跑通 create → add → validate → view screenshot再把这条链路原样搬进 CI 或容器。命令细节看 examples/每个示例都带 .sh / .py 双版本与产物文件属性与 schema 清单在 schemas/Agent 技能与薄 SDK 入口在 skills/ 和 sdk/。【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从一条命令到 K8s：OfficeCLI 无头 Office 文档自动化实战
从一条命令到 K8sOfficeCLI 无头 Office 文档自动化实战【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI每天下班前要生成两百份格式固定的发票和月报交付到对象存储。听起来是脚本活卡在环境上服务器没有显示、没有 Office 授权LibreOffice 无头模式装起来也重生成后没法确认排版对不对、结构合不合法。这类无头环境产出 Office 文档的活正是 OfficeCLI 要解决的。OfficeCLI 是面向 AI Agent 与自动化流水线设计的开源 Office 套件一个自包含二进制不需要安装 Microsoft Office就能创建、读取、修改和校验 .docx / .xlsx / .pptx。它内建 HTML 渲染引擎可以把文档渲染成 HTML 或 PNG——生成方看得见自己的产出。同一套 create / view / validate 命令在你本机、CI 里、容器里表现一致。一键装好 OfficeCLI3 分钟跑通第一条命令macOS / Linux 一行装Windows 用 install.ps1也可以走包管理器或手动下载静态二进制# macOS / Linux curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash # Windows PowerShell irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex # 包管理器 / 手动 brew install officecli # 或 scoop install officecli npm install -g officecli/officecli # 或直接从 GitHub Releases 下载对应平台的静态二进制脚本会把二进制放进 PATH并顺带把 officecli 技能文件装进它检测到的 AI 编码工具。装完立刻跑officecli --version有版本号输出才算装好。接下来三条命令出一份最小 PPT。create按扩展名决定文档类型add用--type声明要加的元素、--prop传属性两条view一条做结构校验、一条看大纲这是后面所有流水线的验证模板officecli create deck.pptx officecli add deck.pptx / --type slide --prop titleQ4 Report --prop background1A1A2E officecli add deck.pptx /slide[1] --type shape \ --prop textRevenue grew 25% --prop x2cm --prop y5cm --prop size24 --prop colorFFFFFF officecli validate deck.pptx # 按 OpenXML schema 校验结构非法直接报出来 officecli view deck.pptx outline # 预期看到Slide 1: Q4 Report / Shape 1 [TextBox]: Revenue grew 25%想在 CI 或 Agent 流程里看见结果把每页渲染成 PNGofficecli view deck.pptx screenshot -o /tmp/deck.png # 加 --page 1-10 指定页码范围这一步是 AI Agent 的眼睛把截图喂给多模态模型就能检查文字溢出、形状重叠、配色错误形成 render → look → fix 的闭环。能力地图Word、Excel、PPT 各能做什么Word从段落样式到修订模式段落、run 级字符属性、样式、表格、图表、LaTeX 公式、Mermaid 图、图片、页眉页脚、水印、目录TOC、表单域、修订模式tracked changes完整 i18n 和 RTL 支持。officecli create handbook.docx officecli set handbook.docx /body/p[1] --prop text员工手册 · 2026 --prop styleHeading1 officecli set handbook.docx /body/p[1]/r[1] --prop boldtrue --prop color1F4E79set直接改属性即可路径用/body/p[1]这种带 1-based 索引的稳定寻址。中文场景加--locale zh-CN创建段落级 RTL、按脚本分列的字体槽都可以直接设。Excel公式写入即算透视表一条命令单元格字体 / 填充 / 边框 / 数字格式、条件格式、数据校验、迷你图、切片器、14 种以上图表。350 内置函数在写入时自动求值——写完SUM(A1:A2)再get值已经在那里不依赖 Office 重算。数据透视表一条命令从源范围生成行 / 列 / 筛选多字段、10 种聚合、showDataAs、日期分组都支持打开 Excel 时聚合已经算好officecli add sales.xlsx /Sheet1 --type pivottable \ --prop sourceData!A1:E10000 --prop rowsRegion,Category \ --prop colsQuarter --prop valuesRevenue:sum,Units:avg \ --prop showDataAspercentOfTotalPowerPoint幻灯片到动画转场幻灯片、形状、表格、图片、多类图表、15 种强调与 16 种退出动画、Morph 与 12 个 2013 转场预设、3D 模型.glb、视频音频、演讲者备注、主题。批量加页时--prop background1A1A2E这类颜色值支持 hex、命名色、RGB、主题色四种写法。单机先跑通watch 预览加 validate 卡口进 CI 之前先在你机器上把反馈循环建起来。watch起一个本地服务浏览器自动刷新officecli watch deck.pptx # 打开 http://localhost:26315之后每条add/set/remove都会即时刷进浏览器Excel 的 watch 还支持单元格内联编辑和图表拖拽。调试模板时这个循环比改一次渲染一次快得多。在 CI 里跑文档生成进流水线的第一原则别在每次 run 里现装把静态二进制钉在版本上放进 PATH。这里以 v1.0.0 为例换成你固定的 tag# .github/workflows/docs.yml name: office-docs on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: install officecli run: | curl -fsSL -o /usr/local/bin/officecli \ https://d.officecli.ai/releases/download/v1.0.0/officecli-linux-x64 chmod x /usr/local/bin/officecli officecli --version - name: generate xlsx run: | officecli create sales.xlsx officecli import sales.xlsx /Sheet1 data/sales.csv --header officecli add sales.xlsx /Sheet1 --type chart --prop typebar --prop dataA1:D10 officecli validate sales.xlsx - name: render evidence run: officecli view sales.xlsx screenshot -o /tmp/sales.png - uses: actions/upload-artifactv4 with: name: office-output path: sales.xlsximport直接吃 CSVvalidate放在流水线里当质量卡点schema 不过这一版就不许出。最后用 screenshot 把产出截图上传成工件——文档生成流水线最缺的从来不是产出文件而是这次长什么样的证据。容器与 K8s一个二进制的镜像Dockerfile 不需要 Node、Python 或 .NET——运行时已经嵌在自包含二进制里。注意install.sh会按 musl / glibc 自动选对包Alpine 基础镜像直接可用FROM alpine:latest RUN apk add --no-cache curl RUN curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | sh RUN mv $HOME/.local/bin/officecli /usr/local/bin/officecli USER nobody CMD [officecli, --version]验证方式是docker run --rm --entrypoint officecli image --version。镜像里没有 Office、没有 LibreOffice只有这一个二进制。K8s 侧按普通无状态服务部署即可apiVersion: apps/v1 kind: Deployment metadata: name: officecli-worker spec: replicas: 2 template: spec: containers: - name: officecli image: your-registry/officecli:1.0.0 resources: requests: { memory: 256Mi, cpu: 250m } limits: { memory: 512Mi, cpu: 500m }常驻会话会把整份文档留在内存里文档越大占用越高limit 按你的文档体量上调即可。提效进阶merge 模板、dump 复刻、resident 会话merge——模板填 N 次。{{key}}占位符用 JSON 数据替换覆盖 .docx / .xlsx / .pptx跨越段落、表格、形状、页眉页脚和图表标题。模板设计一次贵之后生产代码只做确定性填充便宜cat invoice-001.json # {client:Acme,total:$5,200} officecli merge invoice-template.docx invoice-001.docx --data invoice-001.json批量出两百份发票时这比让 Agent 每份重新生成一遍布局可靠得多——后者每次产出的版式都可能漂移。dump / batch——从存量文档学结构。dump把任意文档或其中一棵子树一个表格、一张工作表、styles 部分序列化成可重放的 batch JSONbatch再把它放回去。拿一份同事做的模板研究结构然后批量产出同类版式不用手写 OOXMLofficecli dump existing.docx -o blueprint.json officecli batch new.docx --input blueprint.jsonresident——低延迟多步编辑。几百次修改逐条起进程开销很大open/close之间走命名管道常驻会话officecli open report.docx officecli set report.docx /body/p[1]/r[1] --prop boldtrue officecli close report.docx踩坑实录现象set明明成功下游 Python 脚本读到的还是旧内容。原因resident 模式为了低延迟会延迟落盘officecli自己的get/view总看到最新编辑但外部读取方python-docx、上传、渲染服务看到的是滞后的磁盘文件。解法交接前显式落盘——officecli save report.docx落盘且保持会话热或close落盘并释放流水线场景直接设OFFICECLI_RESIDENT_FLUSHeach让每条 mutation 在命令返回前就写进磁盘。现象安装脚本退出码 0officecli却提示 command not found。原因二进制装进了~/.local/binPATH 导出写进了 shell rc 文件当前 shell 还没重新加载。解法source ~/.bashrc或 zshrc或直接用全路径或把二进制挪进/usr/local/bin。判断标准只有一个装完立刻officecli --version有输出才算过。现象Alpine 容器里手动塞的二进制跑不起来。原因Release 同时发 glibc 与 alpine 两个变体musl libc 的镜像必须用officecli-linux-alpine-x64arm64 同理拿 glibc 版硬装会直接符号报错。install.sh本身会自动检测 musl 选对包只有手动挑 asset 时才容易拿错。边界与选型什么时候该用什么时候别用适合的场景标准化文档批量生成发票、报表、周报、CI 内产出与校验文档、无显示的容器环境、需要结构化 JSON 输出的 AI Agent。不适合的场景替代 Office 桌面端做交互式精细排版.doc / .hwpx 老格式的编辑只读 / 导出依赖插件Excel 重算语义必须与 Office 全量函数库逐一对齐的审计级场景内置引擎覆盖 350 常用函数但不是全集。性能量级参考单进程批处理百级文档在几十秒量级瓶颈通常在 I/O 与文档复杂度不在 CPU。你的需求更合适的选择交互式排版、人工精修版式Office / LibreOffice 桌面端只处理表格且团队全是 Pythonopenpyxl 等库直连无头生成 校验 渲染 Agent 集成OfficeCLI收束三步走装二进制并officecli --version验证本机跑通 create → add → validate → view screenshot再把这条链路原样搬进 CI 或容器。命令细节看 examples/每个示例都带 .sh / .py 双版本与产物文件属性与 schema 清单在 schemas/Agent 技能与薄 SDK 入口在 skills/ 和 sdk/。【免费下载链接】OfficeCLIOfficeCLI is the first and best Office suite purpose-built for AI agents to read, edit, and automate Word, Excel, and PowerPoint files. Free, open-source, single binary, no Office installation required.项目地址: https://gitcode.com/GitHub_Trending/of/OfficeCLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考