ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

OfficeCLI Examples 全指南:用 CLI 与 Python SDK 自动化 Word、Excel、PowerPoint

OfficeCLI Examples 全指南:用 CLI 与 Python SDK 自动化 Word、Excel、PowerPoint CLIAI 应用MCP 服务【免费下载链接】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点击查看免费下载本指南基于 OfficeCLI 仓库中的 examples/README.md 展开系统梳理仓库内全部示例的组织方式、四件套文件约定、快速上手命令与核心编程模式。读完本文你将掌握如何用officecliCLI 或 Python SDK 双路径生成.docx/.xlsx/.pptx文档理解create / add / set / get / query / batch / validate等核心动词的用法并能直接运行仓库中的 60 个示例脚本作为实战模板。Examples 全景覆盖三大文档类型的演示矩阵examples/目录是 OfficeCLI 的能力演示中心按文档格式划分为word/、excel/、ppt/三个子目录每个示例都同时展示「操作说明 可运行脚本 预生成产物」既是上手教程也是回归测试集。examples/ ├── README.md # 本文件 ├── word/ # Word 示例 —— *.{md,sh,py,docx} │ ├── formulas.{md,sh,py,docx} # LaTeX 数学/化学/物理公式 │ ├── tables.{md,sh,py,docx} # 样式化表格 │ ├── textbox.{md,sh,py,docx} # 格式化文本框 │ ├── charts.{md,sh,py,docx} # 内嵌图表含 treemap/waterfall 等 14 种类型 │ ├── run-formatting.{md,sh,py,docx} # run/字符级属性面 │ ├── paragraph-formatting.{md,sh,py,docx} # 段落属性面 │ ├── document-formatting.{md,sh,py,docx} # 文档级属性面 │ ├── sections.{md,sh,py,docx} # 分节布局 —— 多栏、脚注/尾注属性、按节的页面设置 │ ├── content-controls.{md,sh,py,docx} # SDT 内容控件 —— 文本/下拉/组合框/日期/图片/分组录入表单 │ ├── fields.{md,sh,py,docx} # 域代码PAGE/DATE/REF/IF/HYPERLINK 自动目录 │ ├── pictures.{md,sh,py,docx} # 内嵌/浮动图片 —— 裁剪、alt、环绕、置于文字下方、绝对定位 │ ├── numbering.{md,sh,py,docx} # 列表/编号样式 │ ├── diagram.{md,sh,py,docx} # Mermaid 图表 —— 原生可编辑形状 高保真 PNG │ └── revisions.{md,sh,py,docx} # 修订tracked-changeAPI ├── excel/ # Excel 示例 —— *.{md,sh,py,xlsx} │ ├── cell-formatting.{md,sh,py,xlsx} # 完整 cell 属性面字体/填充/边框/numFmt/数据 │ ├── conditional-formatting.{md,sh,py,xlsx} │ ├──>bash name.sh # 通过 officecli CLI 二进制 python3 name.py # 通过 officecli Python SDKpip install officecli-sdk两者重新生成同一份输出文档。下面按文档类型给出示例清单展示其中一种形式bash …​.sh与python3 …​.py可随意互换。Word.docxcd word bash run-formatting.sh # Run/字符格式化粗体/下划线/删除线/大小写/上下标/字体/效果 bash paragraph-formatting.sh # 段落格式化对齐/缩进/间距/分页/底纹/markRPr bash formulas.sh # LaTeX 数学公式 bash tables.sh # 样式化表格 bash textbox.sh # 格式化文本框 bash numbering.sh # 列表/编号样式 bash revisions.sh # 修订tracked-changeAPI —— ins/del/format/move/cellChangeExcel.xlsxcd excel python cell-formatting.py # 完整 cell 属性面字体、填充、边框、数字格式、公式/链接 bash charts.sh # 图表总览一个工作簿内 8 种图表类型 bash charts/charts-basic.sh # 按类型的高层示例任意 charts/charts-type.sh python charts/charts-line.py # 单类型示例任意 charts/charts-type.py python pivot-tables.py # 数据透视表PowerPoint.pptxcd ppt bash presentation.sh # Morph 过渡 / 完整 deck bash animations.sh # 动画效果 python video.py # 视频嵌入 bash 3d-model.sh # 3D 模型嵌入 bash diagram.sh # Mermaid 图表 —— rendernative可编辑形状 renderimagePNG python charts/charts-column.py # PowerPoint 图表示例任意 charts/charts-type.py bash tables/tables-basic.sh # 表格 —— 最小创建 填充 bash tables/tables-styled.sh # 9 种内置样式 斑马纹标志 rowHeight/name bash tables/tables-merged.sh # gridSpan 水平合并 bash tables/tables-borders.sh # 逐边/逐单元格边框 bash tables/tables-rows-cols.sh # 增行/增列、逐行高度、gridSpan merge.down bash tables/tables-financial.sh # 端到端金融 deck bash transitions/transitions-basic.sh # cut/fade/dissolve/flash none 清除 bash transitions/transitions-directional.sh # push/wipe/cover/uncover × 方向矩阵 bash transitions/transitions-shapes.sh # circle/diamond/wedge/wheel/zoom bash transitions/transitions-bands.sh # blinds/strips/split/checker bash transitions/transitions-dynamic.sh # 2010 Exciting 画廊vortex/flip/... bash transitions/transitions-modern.sh # 2013 Exciting 画廊pageCurl/airplane/origami/... bash transitions/transitions-random.sh # newsflash / random bash transitions/transitions-timing.sh # speed、duration、advanceTime、advanceClick bash transitions/transitions-morph.sh # 2016 Morph 补间 bash shapes/shapes-basic.sh # 几何、填充、轮廓、旋转、基础效果 bash shapes/shapes-connectors.sh # 直线/肘形/曲线连接符 组合 bash shapes/shapes-effects.sh # autoFit、翻转、图片填充、3D、软边缘、链接、zorder bash shapes/shapes-typography.sh # 间距、kern、大小写、RTL 方向、font.cs、lang bash textboxes/textboxes-basic.sh # 对齐、项目符号、runs、逐脚本字体 bash textboxes/textboxes-advanced.sh # 逐段落覆盖、缩进、逐 run 排版 python pictures/pictures-basic.py # picture src/crop/rotation/links需要 Pillow核心命令模式示例脚本高度复用四种命令模式理解它们即可看懂绝大多数.sh/.py脚本。创建并填充Create and Populate#!/bin/bash set -e FILEdocument.docx officecli create $FILE officecli add $FILE /body --type paragraph --prop textHello World officecli validate $FILEcreate依据扩展名决定文档类型.docx/.xlsx/.pptxadd在指定父路径下追加元素validate对照 OpenXML schema 做一致性检查——这是所有示例的标准收尾动作例如 examples/word/formulas.sh 在末尾即执行closevalidate。批量操作Batch Operationscat EOF commands.json [ {command:add,parent:/body,type:paragraph,props:{text:Para 1}}, {command:set,path:/body/p[1],props:{bold:true,size:24}} ] EOF officecli batch document.docx commands.jsonbatch从 stdin 读取 JSON 数组每条都是一个{command, parent/path, type, props}字典与 Python SDK 的doc.batch([...])完全同构。从源码看BatchExecutor.cs 与 CommandBuilder.Batch.cs 负责逐条解析并执行这批指令遇到属性名无法识别时会给出明确的 UNSUPPORTED props 警告退出码 2examples/excel/charts.sh 就特意不设set -e以容忍这类前向兼容警告、继续构建完整文档。常驻模式Resident Mode3 次以上操作officecli open document.docx officecli add document.docx /body --type paragraph --prop textFast operation officecli set document.docx /body/p[1] --prop boldtrue officecli close document.docx对同一文件执行 3 次以上操作时open把文档载入内存常驻进程后续命令不再反复读写磁盘close时落盘释放。从源码结构看ResidentClient.cs 与 ResidentServer.cs 实现了这条命名管道会话ResidentFlushPolicy.cs 控制刷新策略。Python SDK 正是复用同一管道协议——sdk/python/README.md 说明它只做一件事把命令字典转发给常驻进程避免每次命令都拉起新进程因此循环编辑比逐命令 shell 调用快数百倍。查询与修改Query and Modify# 找出所有 Heading1 段落 officecli query report.docx paragraph[styleHeading1] --json # 修改它们的颜色 officecli set report.docx /body/p[1] --prop colorFF0000query使用 CSS 风格选择器定位元素如paragraph[styleHeading1]、cell[formula~SUM]--json输出结构化结果便于管道处理set通过/body/p[1]这类路径精确修改。/body/p[1]中的[1]是位置索引元素路径与选择器是 OfficeCLI 两个并行的定位体系。命令速查表文档类型支持矩阵格式扩展名创建查看修改Word.docx✓✓✓Excel.xlsx✓✓✓PowerPoint.pptx✓✓✓常用命令命令用途示例create创建空白文档officecli create file.docxview查看内容officecli view file.docx textget获取元素officecli get file.docx /body/p[1]set修改元素officecli set file.docx /body/p[1] --prop boldtrueadd添加元素officecli add file.docx /body --type paragraphremove删除元素officecli remove file.docx /body/p[5]queryCSS 风格查询officecli query file.docx paragraph[styleNormal]batch批量操作officecli batch file.docx commands.jsonvalidate检查 schemaofficecli validate file.docx查看模式View Modes模式说明用法text纯文本officecli view file.docx textannotated带格式标注的文本officecli view file.docx annotatedoutline文档结构officecli view file.docx outlinestats统计信息officecli view file.docx statsissues问题诊断officecli view file.docx issueshtmlHTML 预览officecli view file.docx htmlsvgSVG 预览officecli view file.docx svgforms表单域officecli view file.docx forms实战示例纵深从四件套脚本看底层实现WordLaTeX 公式formulasexamples/word/formulas.md 与其.sh/.py孪生脚本共同展示了 docxequation元素用 LaTeX 语法写入 60 条公式覆盖代数、微积分、线性代数、概率统计、数论、化学、物理与高级排版记号。其 CLI 形式的核心模式是officecli add formulas.docx /body --type equation --prop formulax \frac{-b \pm \sqrt{b^{2} - 4ac}}{2a}关键点在于mode属性modedisplay默认生成独立的块级oMathPara居中公式modeinline则把公式作为oMath子元素嵌入所在段落的句子中间。脚本还演示了矩阵环境pmatrix/vmatrix/bmatrix、分段函数cases、自动尺寸定界符、\cancel/\cancelto、\boxed、\textcolor彩色数学等高级 LaTeX 能力。Python 孪生脚本 examples/word/formulas.py 展示了同一批指令如何打包进单个doc.batch([...])往返——这正是 sdk/python/README.md 中「没有第二套词汇」的设计命令字典与officecli batch列表完全一致。Excel图表总览chartsexamples/excel/charts.sh 在一个工作簿内构建 8 种图表组合图、3D 柱状图、散点趋势线、3D 饼图、气泡图、股票 OHLC、填充雷达图、多环环形图分 4 张工作表组织月度销售、分析数据、股票数据、能力评估。脚本先用officecli set逐格写入带样式的表头--prop fill1F4E79 --prop font.colorFFFFFF --prop alignment.horizontalcenter与数据再通过add挂载图表。注意numFmt的两种写法numFmt#,##0千分位与numFmt0.0%百分比格式是 xlsx cell 属性面的典型用法。若需某种单一图表类型examples/excel/charts/ 提供了 17 个按类型拆分的四件套示例line、bar、pie、scatter、stock、waterfall、combo、histogram 等。PowerPointMermaid 图表diagramexamples/ppt/diagram.sh 是 Mermaid 图表示例演示三种渲染模式rendernative—— 无浏览器依赖生成可编辑的 PowerPoint 形状 连接符支持 flowchart / graph 与 sequenceDiagram 两种类型整图作为一个组合对象/slide[N]/group[K]可整体寻址与移动renderimage—— 通过真实 mermaid.js无头浏览器生成高保真 PNG覆盖全部 mermaid 类型源码会写入 alt 文本renderauto—— 默认值浏览器可用时走 image否则回退 native。该脚本特意export OFFICECLI_NO_AUTO_RESIDENT1关闭自动常驻renderimage会启动浏览器耗时数秒逐条命令以独立进程运行可避免与常驻进程的单命令管道争用Python 孪生则保留常驻其客户端会重试忙碌连接。源码来源mermaid标准、text、dsl、src指向.mmd文件脚本中的pie.mmd即此类四种可互换x/y/width/height定义放置框图表按比例适配并居中。实用技巧修改前先探索officecli view document.docx outline officecli get document.docx /body --depth 2outline视图快速把握结构get --depth 2查看两级子树。自动化用--jsonofficecli query data.xlsx cell[formula~SUM] --json | jq结构化输出可直接喂给后续管道或 Agent。用help查属性schema 参考内置于help动词之下officecli help docx set paragraph officecli help xlsx set cell officecli help pptx set shape仓库 schemas/help/ 目录中存放着对应的机器可读 schema JSON如 docx/paragraph.json 定义了 paragraph 的全部可设属性、别名与示例--json可输出原始 schema。修改后验证officecli validate document.docx批量操作使用常驻模式同一文件 3 次以上操作时officecli open file.pptx # ... 多条命令 ... officecli close file.pptx贡献新示例遵循以下步骤即可为仓库贡献示例编写带清晰注释的脚本测试并验证输出放入合适的目录word/excel/ppt更新对应目录的 README提交 PR推荐的示例脚本模板#!/bin/bash # 简要说明本示例演示的内容 # 关键技术在此列出 set -e FILEoutput.docx officecli create $FILE # ... 你的命令 ... officecli validate $FILE echo Created: $FILE帮助系统与更多资源顶层帮助officecli --help # CLI 用法 officecli help # Schema 参考入口 officecli help docx # 全部 docx 元素 officecli help docx set # docx 中支持 set 的元素 officecli help docx set paragraph # paragraph 可设属性 officecli help docx paragraph --json # 原始 schema JSON officecli help all # 平铺输出全部格式、元素、属性格式别名word→docx、excel→xlsx、ppt/powerpoint→pptx动词add、set、get、query、remove。深入资料方面SKILL.md 是为 AI Agent 准备的完整命令参考含 L1 读取 → L2 DOM 编辑 → L3 原始 XML 的三层策略与常驻模式说明README.md 提供项目总览与安装方式若要做整场 PPT 模板生成可参考 examples/ppt/templates/README.md 与 skills/morph-ppt/SKILL.md插件扩展能力见 plugins/plugin-protocol.md。结语examples/目录是 OfficeCLI 能力的完整标本库每个示例的.md讲解 .sh/.py双构建脚本 预生成产物让「读懂 → 复跑 → 改造」三步走没有任何障碍。无论你是想给 Agent 装配 Office 自动化能力、用 CLI 脚本批量生成报表还是用 Python SDK 在服务端流水线中产出文档都能在 examples/word/、examples/excel/、examples/ppt/ 中找到可直接复用或改造的实战模板。从公式排版到数据透视表从 Morph 过渡到 3D 模型嵌入跑一遍这些示例就是掌握 OfficeCLI 全部能力的最快路径。赞分享CLIAI 应用MCP 服务【免费下载链接】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点击查看免费下载相关推荐officecli Node.js SDK 实战用 officecli/sdk 通过 resident 管道高效读写 Word / Excel / PowerPointofficecli Node.js SDK 实战用 officecli/sdk 通过 resident 管道高效读写 Word / Excel / Powe人工智能AI 应用AI 技能CLIMCP 服务Open-XML-SDK快速入门10分钟学会Word、Excel、PowerPoint自动化Open XML SDK快速入门10分钟学会Word、Excel、PowerPoint自动化 Open XML SDK 是微软官方推出的强大工具库让开发者能后端开发工具OfficeCLI 内容控件Content Controls完全指南用 CLI 与 Python SDK 构建 Word 可填写表单OfficeCLI 内容控件Content Controls完全指南用 CLI 与 Python SDK 构建 Word 可填写表单 导读 本文以 Off人工智能AI 应用AI 技能CLIMCP 服务上一篇Godot 示例项目完全指南快速跑通 50 多个 Demo读懂导航寻路源码下一篇DSView信号分析软件完全指南从入门到精通的5个关键步骤创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表