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/ppt/tables/tables-basic.md演示为骨架系统讲解如何在 PowerPoint 幻灯片中创建与编排数据表格从一条命令的dataCSV 内联灌数、rows/cols空网格 逐格set填充到单元格填充、字体排版与布局属性的完整清单并深入其底层源码PowerPointHandler.Add.Table.cs、PowerPointHandler.Set.Table.cs与 schema 定义让读者既能照着命令直接生成tables-basic.pptx也能理解每条属性在 OOXML 层面对应的具体实现。演示文件与再生方式该演示由三个文件协同工作均位于 examples/ppt/tables/ 目录tables-basic.sh — Shell 脚本调用officecliCLI 命令生成整套幻灯片tables-basic.pptx — 生成的 5 页演示文稿分别覆盖内联数据、逐格填充、填充变体、单元格排版与单元格布局tables-basic.md — 本文所依托的说明文档将每页幻灯片映射到其演示的特性。在仓库根目录执行以下命令即可重新生成cd examples/ppt bash tables/tables-basic.sh # → tables/tables-basic.pptx脚本末尾会调用officecli validate tables-basic.pptx对产物做结构校验。整个示例只依赖officecli单二进制无需安装 Officecreate/open/add/set/close/validate是它的核心子命令。Slide 1data内联 CSV 一键建表最快捷的建表方式是让一条add --type table命令通过data参数同时完成建表与灌数officecli create tables-basic.pptx officecli open tables-basic.pptx officecli add tables-basic.pptx / --type slide # data uses CSV: comma cell separator, semicolon row separator. # First row becomes the header row when headerFill is set. officecli add tables-basic.pptx /slide[1] --type table \ --prop x0.5in --prop y1.2in --prop width12in --prop height2in \ --prop headerFill4472C4 --prop bodyFillDEEAF6 \ --prop dataRegion,Q1,Q2,Q3,Q4;North,120,135,142,168;South,98,110,121,140;East,165,178,190,205数据语法data采用 CSV 约定——逗号,分隔单元格分号;分隔行。首行示例中的Region,Q1,Q2,Q3,Q4在设置了headerFill时自动成为表头行。引号感知解析从源码 PowerPointHandler.Add.Table.cs 可以看到data的解析并非简单的Split(,)而是经由OfficeCli.Core.DelimitedText.ParseGrid处理被双引号包裹的单元格可以安全地包含分隔符例如Doe, John,30会被解析为两个单元格而非三个。此外当data的值是一个可解析的路径/URL/data-URI 时FileSource.IsResolvable判定会按 CSV 文件/URL 读取——也就是说data同样支持从外部 CSV 文件导入数据。尺寸与行高推导未提供data时rows/cols默认值均为 3提供data后行列数由网格数据自动推导若同时显式给出rows/cols则它们作为“下限”生效例如dataH1,H2;,, rows2仍生成 2 行表格。源码还对行列数设置了 5000 的实用上限MaxTableDim防止 EMU 计算溢出产生非法 OOXML。x/y/width/height接受 EMU 可解析的长度in/cm/pt等未指定时的默认行高为 370840 EMU约 1.03cm/行。表头与表体配色headerFill应用于第 0 行表头bodyFill应用于第 1..N 行表体源码还支持表级fill别名background作为兜底填充整体作用于所有单元格。表级tblLook默认开启firstRowtrue与bandRowtrue首行强调 隔行斑马纹可通过firstRow/bandedRows等属性覆盖。该页演示的字段--type table、dataCSV,为单元格、;为行、headerFill表头行背景十六进制色、bodyFill表体行背景十六进制色、x/y/width/height位置与尺寸。Slide 2rows/cols空网格 逐格set当数据不适合用 CSV 表达或需要逐格精确控制格式时可先创建无数据的网格骨架再用set逐格写入officecli add tables-basic.pptx / --type slide # Empty table skeleton — no data, just dimensions officecli add tables-basic.pptx /slide[2] --type table \ --prop x0.5in --prop y1.2in --prop width10in --prop height2.5in \ --prop rows4 --prop cols3 --prop headerFill2E75B6 # Header cells: tr[1] first row, tc[N] Nth column (1-based) officecli set tables-basic.pptx /slide[2]/table[1]/tr[1]/tc[1] \ --prop textProduct --prop boldtrue --prop colorFFFFFF officecli set tables-basic.pptx /slide[2]/table[1]/tr[1]/tc[2] \ --prop textUnits --prop boldtrue --prop colorFFFFFF officecli set tables-basic.pptx /slide[2]/table[1]/tr[1]/tc[3] \ --prop textRevenue --prop boldtrue --prop colorFFFFFF # Body cells — row 2..4 officecli set tables-basic.pptx /slide[2]/table[1]/tr[2]/tc[1] --prop textWidget officecli set tables-basic.pptx /slide[2]/table[1]/tr[2]/tc[2] --prop text1,200 officecli set tables-basic.pptx /slide[2]/table[1]/tr[2]/tc[3] --prop text\$48,000 officecli set tables-basic.pptx /slide[2]/table[1]/tr[3]/tc[1] --prop textGizmo officecli set tables-basic.pptx /slide[2]/table[1]/tr[3]/tc[2] --prop text850 officecli set tables-basic.pptx /slide[2]/table[1]/tr[3]/tc[3] --prop text\$72,250 officecli set tables-basic.pptx /slide[2]/table[1]/tr[4]/tc[1] --prop textSprocket officecli set tables-basic.pptx /slide[2]/table[1]/tr[4]/tc[2] --prop text430 officecli set tables-basic.pptx /slide[2]/table[1]/tr[4]/tc[3] --prop text\$25,800路径语法与索引规则单元格定位路径为/slide[N]/table[M]/tr[R]/tc[C]其中N/M/R/C全部从 1 开始计数源码中经PathIndex.ToArrayIndex统一换算为 0-based 内部索引。Shell 中\$48,000的转义用于避免美元符号被 shell 展开。行级快捷写法源码补充在 PowerPointHandler.Set.Table.cs 中对tr[R]行路径的set还有两种便捷行为text不含制表符时会把文本广播到该行所有单元格包含\t时则按位置分发X1\tX2\tX3→tc[1]X1、tc[2]X2、tc[3]X3此外c1、c2、… 属性可直接定位行内指定列。同理表格级set会把text/bold/italic/size/font/color/fill/padding等单元格属性扇出到整张表的所有单元格。该页演示的字段rows/cols创建空网格、路径语法/table[N]/tr[R]/tc[C]均从 1 起、text、bold、color文字颜色十六进制。Slide 3单元格填充的六种写法幻灯片 3 用一张两列参考表集中演示fill的全部语法形态officecli add tables-basic.pptx / --type slide # stylenone disables the built-in theme; border.all applies a uniform border officecli add tables-basic.pptx /slide[3] --type table \ --prop x0.5in --prop y1.2in --prop width12in --prop height4in \ --prop rows5 --prop cols2 --prop stylenone --prop border.all1pt solid 808080 # Solid hex fill officecli set tables-basic.pptx /slide[3]/table[1]/tr[2]/tc[2] --prop fillFF0000 # Named color (also accepts rgb(255,0,0) form) officecli set tables-basic.pptx /slide[3]/table[1]/tr[3]/tc[2] --prop fillred # Theme color — follows deck theme; changes when theme changes officecli set tables-basic.pptx /slide[3]/table[1]/tr[4]/tc[2] --prop fillaccent1 # Gradient — COLOR1-COLOR2-ANGLE officecli set tables-basic.pptx /slide[3]/table[1]/tr[5]/tc[2] \ --prop fillFF0000-0000FF-90 # fillnone — explicit transparent (cell becomes slide-background color) officecli add tables-basic.pptx /slide[3] --type table \ --prop x0.5in --prop y5.9in --prop width4in --prop height0.8in \ --prop rows1 --prop cols2 --prop stylenone --prop border.all1pt solid 000000 officecli set tables-basic.pptx /slide[3]/table[2]/tr[1]/tc[1] \ --prop textsolid --prop fillFFE699 officecli set tables-basic.pptx /slide[3]/table[2]/tr[1]/tc[2] \ --prop textnone --prop fillnonefill的完整取值域依据 schemas/help/pptx/table-cell.json 与演示脚本写法说明示例fillRRGGBB十六进制纯色fillFF0000fill颜色名命名颜色等价于rgb(r,g,b)形式fillred、fillrgb(255,0,0)fillaccent1..6主题色随演示文稿主题联动fillaccent1另有dk1/dk2/lt1/lt2/hyperlinkfillC1-C2-ANGLE渐变格式颜色1-颜色2-角度fillFF0000-0000FF-90fillnone显式无填充透明露出幻灯片背景fillnonestylenone关闭内置主题style属性对应 OOXML 的a:tblStyleId。根据 PowerPointHandler.Helpers.Table.cs 中的ResolveTableStyleId其合法取值包括medium1..4、light1..3、dark1..2、none、复合形式如dark2-accent1、medium3-accent4或直接 GUID。none即写入{2D5ABB26-0587-4C30-8999-92F81FD8307C}这类无样式 GUID让后续自定义 fill/border 不受主题干扰。border.all复合简写格式为宽度[ 线型][ 颜色]空格分隔如1pt solid 808080也接受分号形式STYLE;WIDTH;COLOR[;DASH]风格字段仅为 docx 对齐而保留线型DASH可取solid|dot|dash|lgDash|dashDot|sysDot|sysDashborder.allnone可清除。值得注意的是PPT OOXML没有表级边框元素——ApplyTableBorderFanOutPowerPointHandler.Add.Table.cs会把表级border.all/top/bottom/left/right扇出为每个单元格的a:lnL/lnR/lnT/lnB边线border.horizontal/border.vertical别名border.insideH/V则对应行/列内部隔线。该页演示的字段fill十六进制、命名色、rgb()、accent1..6主题色、C1-C2-ANGLE渐变、none、stylenone禁用内置主题、border.allNpt solid HEX复合简写。Slide 4单元格字体排版全览七行参考表逐个演示单元格内可用的全部文本属性officecli add tables-basic.pptx / --type slide officecli add tables-basic.pptx /slide[4] --type table \ --prop x0.5in --prop y1.1in --prop width13in --prop height5in \ --prop rows7 --prop cols2 --prop stylenone --prop border.all1pt solid 808080 # italic officecli set tables-basic.pptx /slide[4]/table[1]/tr[2]/tc[2] \ --prop textThis cell text is italic. --prop italictrue # underline officecli set tables-basic.pptx /slide[4]/table[1]/tr[3]/tc[2] \ --prop textThis cell text is underlined. --prop underlinesingle # strike officecli set tables-basic.pptx /slide[4]/table[1]/tr[4]/tc[2] \ --prop textThis cell text has strikethrough. --prop strikesingle # font size officecli set tables-basic.pptx /slide[4]/table[1]/tr[5]/tc[2] \ --prop textThis cell uses Georgia. --prop fontGeorgia --prop size16 # wrapfalse — text overflows/clips rather than wrapping to next line officecli set tables-basic.pptx /slide[4]/table[1]/tr[6]/tc[2] \ --prop textThis is a long sentence that will not wrap because wrap is disabled — it just runs off the edge. \ --prop wrapfalse # linespacing spacebefore spaceafter — paragraph spacing inside cell officecli set tables-basic.pptx /slide[4]/table[1]/tr[7]/tc[2] \ --prop textParagraph A \ --prop linespacing1.5x --prop spacebefore4pt --prop spaceafter4pt各属性对应的 OOXML 落点依据 table-cell.jsonitalic别名font.italic→ 每个 run 的a:rPr ibold别名font.bold→a:rPr bunderline别名font.underline→a:rPr u取值single|double|none或任意 OOXML 下划线 tokenstrike别名font.strike等→a:rPr strike取值single|double|nonefont别名font.name/font.latin→a:rPr/a:latin及东亚字体a:ea按类型面名称填入size别名font.size→a:rPr sz接受14pt或裸数字点数wrap别名wordwrap→ 单元格文本体a:bodyPr wraptrue为方形换行、false为裁切文本溢出被裁剪而非换行linespacing→ 单元格内每个段落的行距接受倍数1.5x、150%或固定磅值18ptspacebefore/spaceafter→ 段前/段后间距a:pPr/spcBef、spcAft单位限定长度4pt、0.5cm。该页演示的字段italic、underlinesingle/double/heavy/dotted/dash、strikesingle/double、font字体名、size磅、wrapfalse 关闭换行、linespacing倍数或磅、spacebefore/spaceafter磅。Slide 5单元格布局进阶八行参考表演示内边距、透明度、图片填充、文字方向、合并与单边边框officecli add tables-basic.pptx / --type slide officecli add tables-basic.pptx /slide[5] --type table \ --prop x0.5in --prop y1.1in --prop width13in --prop height6.2in \ --prop rows8 --prop cols2 --prop stylenone --prop border.all1pt solid 808080 # padding — uniform inner text margin officecli set tables-basic.pptx /slide[5]/table[1]/tr[2]/tc[2] \ --prop textLarge inner margin. --prop fillF1FAEE --prop padding0.25in # padding.bottom — single-edge padding override officecli set tables-basic.pptx /slide[5]/table[1]/tr[3]/tc[2] \ --prop textExtra space below this text. --prop fillF1FAEE \ --prop padding.bottom0.3in # opacity — fill transparency (0opaque, 1invisible); requires fill officecli set tables-basic.pptx /slide[5]/table[1]/tr[4]/tc[2] \ --prop text40% transparent fill. --prop fill4472C4 --prop opacity0.4 # image — blipFill (picture fill on the cell background) officecli set tables-basic.pptx /slide[5]/table[1]/tr[5]/tc[2] \ --prop image/path/to/img.png # textdirectionvert — vertical text rendering inside a cell officecli set tables-basic.pptx /slide[5]/table[1]/tr[6]/tc[2] \ --prop textVertical text --prop textdirectionvert --prop fillFFE699 # directionrtl — RTL paragraph direction within a cell officecli set tables-basic.pptx /slide[5]/table[1]/tr[7]/tc[2] \ --prop textمرحبا --prop directionrtl --prop size18 --prop fillA8DADC # merge.right bevel border.right — combined cell properties officecli set tables-basic.pptx /slide[5]/table[1]/tr[8]/tc[2] \ --prop textMerged, beveled, custom right border. \ --prop fillF4A261 --prop bevelcircle \ --prop border.right2pt solid E63946 officecli close tables-basic.pptx officecli validate tables-basic.pptx逐条解读其实现细节padding与单边覆盖padding0.25in是a:tcPr marL/marR/marT/marB的简写同时设置四边内边距padding.bottom0.3in只覆盖底边schema 中另有padding.top/left/right别名margin.*opacity填充透明度0不透明、1完全透明作用于单元格实心/渐变填充的 alphafill.opacity/alpha别名依赖fill存在也接受0–100百分数形式如opacity50%image图片填充将本地图片作为单元格背景的 blipFilla:tcPr/a:blipFill会替换既有填充。演示脚本通过 Python heredoc 现场生成一张 32×32 蓝青棋盘格 PNG 作为填充图该特性在 tables-basic.py 的 SDK 版本中以同名函数实现textdirection文字方向vert为垂直文字规范取值horizontal|vertical90|vertical270|stacked映射a:tcPr vert别名textdir/vertdirection段落方向directionrtl设置单元格首段落a:pPr rtl可安全承载阿拉伯语等 RTL 文本会扇出到该格所有段落bevel3D 斜面bevelcircle是 3D 斜面预设可选circle/slope/cross/angle/softRound/convex/coolSlant/divot/riblet/hardEdge/artDeco等也支持bevelcircle;6pt;6pt指定宽高bevelnone清除merge.right横向合并merge.rightN将本格与右侧 N 个相邻格合并spanN1底层写入gridSpan并为后续格打hMergetrue对应属性还有merge.down纵向合并、colspan别名gridspan与rowspan单边边框border.right格式同border.allNpt solid HEX另有border.top/left/bottom与对角线border.tl2br/border.tr2bl均可带.width/.color/.dash/.compound细分键。该页演示的字段padding统一另含padding.top/right/bottom/left、opacity0.0–1.0需配合fill、image文件路径单元格背景 blipFill、textdirectionvert垂直文字、directionrtlRTL 段落、bevel3D 斜面预设、border.right单边Npt solid HEX。功能覆盖速查表以下为演示文档提供的完整特性→幻灯片映射表便于快速定位每个属性的可运行示例FeatureSlidedata:CSV inline population (, cell,; row)1headerFill / bodyFill:header body background colors1, 2rows / cols:empty grid creation2Per-cell set:/table[N]/tr[R]/tc[C]path targeting (1-based)2–5fill:hex, named, rgb(), accent1..6, gradient, none3stylenone:disable built-in table theme3–5border.all:shorthand uniform border (Npt solid HEX)3–5italic / underline / strike:cell text decoration4font / size:cell typeface and point size4wrapfalse:no text wrapping4linespacing / spacebefore / spaceafter:paragraph spacing in cell4padding:uniform inner margin (also per-edge variants)5opacity:fill transparency5image:picture fill on cell background5textdirectionvert:vertical text in cell5directionrtl:RTL paragraph in cell5bevel:3D bevel on cell5border.right / border.left / …:per-edge borders5检视与验证生成的表格生成完成后可用query与get反向读取已写入的属性验证每一页的渲染参数# List tables on each slide officecli query tables-basic.pptx /slide[1]/table officecli query tables-basic.pptx /slide[3]/table # Get fill properties on slide 3 officecli get tables-basic.pptx /slide[3]/table[1]/tr[2]/tc[2] officecli get tables-basic.pptx /slide[3]/table[1]/tr[5]/tc[2] # Check typography on slide 4 officecli get tables-basic.pptx /slide[4]/table[1]/tr[5]/tc[2] officecli get tables-basic.pptx /slide[4]/table[1]/tr[7]/tc[2] # Inspect layout properties on slide 5 officecli get tables-basic.pptx /slide[5]/table[1]/tr[4]/tc[2] officecli get tables-basic.pptx /slide[5]/table[1]/tr[8]/tc[2]get对单元格的读回readback由 PowerPointHandler.Helpers.Table.cs 实现边框会被规范化为宽度 线型 颜色如2pt solid #FF0000并附.color/.width/.dash/.compound细分键四边一致时还会额外汇总出border.all填充透明度、内边距等同样有标准化的单位化读回。此外脚本最后的officecli validate会对文档做结构校验确保产物可被 PowerPoint 正常打开。深入扩展表级属性与 Python SDK 孪生实现除了演示覆盖的单元格属性表格元素本身/slide[N]/table[M]在 schemas/help/pptx/table.json 中声明了更多表级能力可与单元格set组合使用定位方式除位置索引/slide[N]/table[M]外还支持稳定路径/slide[N]/table[idID]与/slide[N]/table[nameNAME]几何与网格x/y/width/height可动态setrowHeight设置所有行高、colWidths逐列宽2cm,3cm,2cm形式autofittrue还会按各列最大文本长度启发式重算列宽Set.Table.cs主题与样式开关firstRow/lastRow/firstCol/lastCol/bandedRows/bandedCols控制a:tblPr的样式标志style切换内置表格样式shadow/glow支持表级阴影与辉光表级扇出在表路径上set text/bold/fill/padding/textdirection/…会扇出到全部单元格bandcolor.odd/bandcolor.even可分别给奇偶行批量填色结构增删add --type row/add --type column/add --type cell可在建表后继续扩展行列行高、列宽默认取平均值或 370840 EMU并在变更后自动同步GraphicFrame的外框尺寸。同样值得关注的是 tables-basic.py 这一Python SDK 孪生脚本它与 Shell 脚本产出等价的tables-basic.pptx驱动officecli-sdkpip install officecli-sdk。SDK 版本启动一个常驻进程通过命名管道逐页发送doc.batch(...)请求每一条命令都是与 CLIbatch列表同构的{command,parent,type,props}add或{command,path,props}set字典。例如 Slide 1 等价于一次 batch 里塞入建页、加标题、加表格三条指令——这意味着你在 CLI 里练会的每一条--prop都能原样迁移到 sdk/python/ 的 Python 脚本或officecli batch批量清单中实现表格生成的完全脚本化与可复现。若需要更复杂的表格形态同一目录还提供了 tables-borders.md、tables-rows-cols.md、tables-merged.md、tables-nested.md、tables-styled.md 与 tables-financial.md 等进阶演示可结合本文的data灌数、逐格set与填充/排版/布局属性体系构建出从数据报表到版式设计所需的任意 PPT 表格。赞分享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 3D 图表实战指南用 CLI 与 Python SDK 生成 PowerPoint 立体图表OfficeCLI 3D 图表实战指南用 CLI 与 Python SDK 生成 PowerPoint 立体图表 本指南以 OfficeCLI 仓库中的 exCLIAI 应用MCP 服务OfficeCLI 组合图Combo Chart完整实战指南用 CLI 与 Python SDK 构建柱线面积混排的 PowerPoint 图表OfficeCLI 组合图Combo Chart完整实战指南用 CLI 与 Python SDK 构建柱线面积混排的 PowerPoint 图表 OffiCLIAI 应用MCP 服务OfficeCLI 实战用 gridSpan 在 PowerPoint 表格中实现单元格横向合并与分层表头OfficeCLI 实战用 gridSpan 在 PowerPoint 表格中实现单元格横向合并与分层表头 本篇文章围绕 OfficeCLI 官方示例 tab人工智能AI 应用AI 技能CLIMCP 服务上一篇5步掌握Path of Building打造流放之路最强Build规划神器下一篇Foundry 仓库 AI 编码 Agent 协作指南从架构、测试到 PR 的全流程开发规范创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考