拓冰网站定制 
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/excel/charts/charts-combo.md 演示项目为核心讲解如何用officecli add ... --type chart --prop chartTypecombo一条命令在 Excel 工作簿中生成柱形折线、柱形面积混合的组合图并系统掌握comboSplit、combotypes、secondaryAxis、referenceLine、colorRule等近 30 个图表属性。读完本文你将能够用 CLI 一行命令或 Python SDK 批量构建包含双轴、多序列、渐变/发光/边框等效果的专业级组合图并具备用query/get反向校验生成文件的能力。1. 演示文件结构一文三件套组合图演示由三个协同文件构成均位于 examples/excel/charts 目录charts-combo.py—— 调用officecliPython SDK 生成工作簿的脚本每个图表命令以注释形式给出可复制的 Shell 等价命令charts-combo.xlsx—— 最终生成的工作簿共 5 个工作表1 个默认表 4 个图表工作表合计 16 张组合图charts-combo.md—— 本文档对应的映射说明将每个工作表映射到它演示的功能点。重新生成产物只需两步cd examples/excel python3 charts-combo.py # - charts-combo.xlsx若你更习惯纯 Shell 工作流可直接运行 CLI 双子脚本 charts-combo.sh。该脚本刻意不启用set -e其注释说明它会容忍向前兼容的UNSUPPORTED props警告officecli退出码 2继续构建以产出完整文档——这是批量脚本在属性集迭代演进时的常见容错写法。2. 组合图的三种构建路径与底层实现在看具体命令前先明确 OfficeCLI 中组合图的三个核心概念。它们在 schemas/help/_shared/chart.json 中有完整定义属性类型说明示例chartTypecomboenum声明图表为组合图chartType仅在创建时固定set:false事后改类型需删除重建--prop chartTypecombocomboSplitnumber组合分割索引前 N 个序列使用主图表类型其余序列使用次类型。仅创建时可用--prop comboSplit2combotypesstring按序列逐一指定类型column,line,area,...逗号分隔每序列一个--prop combotypescolumn,column,line,area三者的定位差异值得注意comboSplit是一刀切comboSplit2表示前 2 个序列画成柱形、其余画成折线适合收入成本利润率这类固定形态combotypes是逐序列定制允许在同一个图中混排column,column,line,area甚至支持带后缀的类型如columnstacked、areapercentstackedsecondaryAxis是把指定 1-based 序列索引如2、2,3,4挂到右侧数值轴上解决销售额百万级 增长率个位数这类量纲悬殊的展示问题。从源码看combotypes会触发一次完整的结构重建。ChartHelper.Advanced.cs 中的RebuildComboChart会先校验每个 token仅接受 bar/column/col/line/area/scatter可带 stacked/percentstacked 后缀读取全部序列数据与轴 ID删除旧的图表容器元素再按目标类型分组重建BarChart/LineChart/AreaChart/ScatterChart容器并把ConvertSeriesToType转换后的序列挂回正确的轴。该实现还包含了防御性处理重建时会顺带丢弃残留的次级轴声明避免 Excel 因孤立的catAx/valAx声明报错并为柱形组补写GapWidth150OOXML 规范默认值保证重建结果与直接构建的图表在 dump→replay 往返中完全一致。3. Sheet 1Combo Fundamentals——分割、双轴与逐序列类型第一个工作表用 4 张图覆盖comboSplit、secondaryAxis、combotypes及其组合用法。图 1基础 combocomboSplit22 柱 1 线officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop series1Revenue:120,145,160,180,195 \ --prop series2Expenses:90,100,110,115,125 \ --prop series3Margin %:25,31,31,36,36 \ --prop comboSplit2 --prop legendbottom图 2折线挂到次级 Y 轴secondaryAxis2officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop comboSplit1 --prop secondaryAxis2 \ --prop catTitleYear --prop axisTitleSales ($K)这里secondaryAxis2表示第 2 个序列如增长率百分比绘制在右侧数值轴上catTitle设置分类轴标题、axisTitle设置数值轴标题。完整的 Python 版本见 charts-combo.py还补充了series1Sales ($K):320,380,420,510,560、series2Growth %:8,19,11,21,10、colors2E75B6,C00000与x/y/width/height排版参数。图 3combotypes 逐序列类型控制officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,line,area图 4combotypes secondaryAxis 组合officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,line \ --prop secondaryAxis3secondaryAxis3让第 3 个序列Net Margin %独占右轴。需要注意源码中的一个顺序约束ChartHelper.Setter.cs中combotypes分支返回PropOrder0调度优先级确保它在secondaryAxis之后执行——因为RebuildComboChart的重建会清空次级轴绑定如果顺序颠倒右侧轴会失效对应源码注释中的 R26: combo secondaryAxis combotypes left every series on the primary axis 历史问题。本表覆盖功能点combo、comboSplit、secondaryAxis、combotypescolumn,column,line,area、catTitle、axisTitle4. Sheet 2Combo Styling——字体、渐变、数据标签与填充第二个工作表集中演示标题/图例/轴字体、系列阴影与渐变、数据标签、绘图区与图表区填充。图 1标题、图例、轴字体样式officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop title.fontGeorgia --prop title.size16 \ --prop title.color1F4E79 --prop title.boldtrue \ --prop legendfont10:333333:Calibri --prop axisfont9:666666legendfont与axisfont都采用size:color:fontname三段式格式任何一段可省略。源码ChartHelper.Setter.cs在解析时会剥离pt后缀并支持小数号如10.5pt避免静默回退到默认 10pt。标题的title.font/size/color/bold逐属性写入标题 run 的 RunProperties并同步更新 DefaultRunProperties 保持一致。图 2系列阴影与渐变officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop gradients1F4E79-5B9BD5:90;C55A11-F4B183:90 \ --prop series.shadow000000-4-315-2-30gradients按序列分号分隔每个条目是c1-c2[:angle]渐变:90为 90° 角度与对所有序列生效的gradient不同gradients可逐序列定制chart.json 中gradients定义per-series gradient fills, semicolon-separatedseries.shadow格式为COLOR-BLUR-ANGLE-DIST-OPACITY颜色-模糊-角度-距离-不透明度none可移除。图 3折线序列上的数据标签officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop dataLabelstrue --prop labelPostop \ --prop labelFont9:333333:truelabelFont的第三段为布尔true加粗。labelPos支持 center/insideEnd/outsideEnd/bestFit/top/bottom/left/right 等位置。注意 schema 中的约束提示labelPos在 doughnut/area/radar/stock 上不支持且 combo 图在部分位置处理上有专门逻辑实操时按示例使用top最稳妥。图 4图表区样式officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop plotFillF0F4F8 --prop chartFillFAFAFA \ --prop roundedCornerstrueplotFill绘图区背景与chartFill图表区背景均接受#RRGGBB、命名颜色或渐变roundedCorners开启圆角。本表覆盖功能点title.font/size/color/bold、legendfont、axisfont、gradients、series.shadow、dataLabels、labelPos、labelFont、plotFill、chartFill、roundedCorners5. Sheet 3Combo Advanced——参考线、坐标轴缩放、手动布局与标记图 1参考线与网格线officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop referenceLine110:Target:C00000 \ --prop gridlinesD9D9D9:0.5referenceLine的完整格式为value[:color][:label][:dash]示例中110:Target:C00000会在 110 处绘制一条红色目标线并标注 Targetgridlines支持true|false、color、color:width、color:width:dash四种形态none移除。图 2坐标轴缩放与显示单位officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop axisMin1000000 --prop axisMax2000000 \ --prop dispUnitsthousandsaxisMin/axisMax对应 schema 中的axismin/axismax别名min/max是数值轴刻度范围dispUnits合法取值包括hundreds、thousands、tenThousands、hundredThousands、millions、tenMillions、hundredMillions、billions、trillions见 ChartHelper.Setter.cs 的校验分支。示例将 100 万~200 万的数据以千为单位显示刻度标签变为 1000K~2000K。图 3手动绘图区布局officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop plotLayout0.1,0.15,0.85,0.75plotLayoutleft,top,width,height四个值均为 0~1 的归一化坐标示例左侧 10%、顶部 15%、宽 85%、高 75%。从源码看这对应plotarea.x/y/w/h系列属性最终由SetManualLayoutProperty写入绘图区layout元素读取路径则在 ChartHelper.Reader.cs 的ReadManualLayout中同时覆盖plotArea、title、legend、trendlineLabel、displayUnitsLabel等节点说明同一套布局机制也适用于标题与图例。图 4多折线 标记officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop comboSplit1 --prop secondaryAxis2,3,4 \ --prop markerscircle-6secondaryAxis2,3,4一次把 3 条折线North/South/West 区域占比全部挂到右轴与左轴的柱形序列Units Sold分离。markerscircle-6指定圆形标记、大小 6marker属性还支持symbol:size:color三要素circle/square/diamond/triangle/x/plus/star/dash/dot仅对 line/scatter/radar 系列生效。本表覆盖功能点referenceLine、gridlines、axisMin/Max、dispUnits、plotLayout、markers、多序列次级轴6. Sheet 4Combo Effects——发光、边框、条件着色与复杂多序列图 1标题发光与阴影officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop title.glow4472C4-6 \ --prop title.shadow000000-3-315-2-30title.glow颜色-半径给标题文字加发光title.shadow与系列阴影同格式COLOR-BLUR-ANGLE-DIST-OPACITY。底层实现ChartHelper.Setter.cs通过DrawingEffectsHelper.ApplyTextEffect将Glow/OuterShadow效果插入标题 run 的属性中。图 2图表区与绘图区边框officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop chartArea.border333333-1.5 \ --prop plotArea.border999999-0.75chartArea.border别名chartborder与plotArea.border别名plotborder均支持color[:width[:dash]]或none注意.sh脚本中使用了:分隔333333:1.5而文档示例用-分隔两种分隔符均可接受。图 3条件着色colorRuleofficecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop colorRule80:C00000:70AD47colorRulethreshold:belowColor:aboveColor实现按数据点阈值着色小于 80 的点显示C00000红大于等于 80 的点显示70AD47绿。源码 ChartHelper.Advanced.cs 会严格校验阈值必须是数字、规格必须是三段式否则直接抛ArgumentException而不是静默降级。图 45 序列混合类型仪表盘officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,column,area,line \ --prop secondaryAxis5这一图完整还原了一个经营仪表盘Revenue/COGS/OpEx 三根柱、Net Income 面积、Margin % 折线挂右轴。Python 版本还配了colors4472C4,ED7D31,A5A5A5,BDD7EE,C00000五色方案与gridlinesE0E0E0:0.5浅灰网格最终删除默认空白Sheet1全部数据均为内联不依赖单元格引用。本表覆盖功能点title.glow、title.shadow、chartArea.border、plotArea.border、colorRule、5 序列combotypes7. 校验生成结果query / get / validate文档末尾给出了两条反向校验命令officecli query charts-combo.xlsx chart officecli get charts-combo.xlsx /1-Combo Fundamentals/chart[1]query ... chart列出工作簿中所有图表的概要信息get ... /1-Combo Fundamentals/chart[1]以 XPath 风格定位到指定工作表的第 1 张图表读取其完整属性树包含secondaryAxis、dispUnits、布局等 readback 字段读取逻辑见 ChartHelper.Reader.cs 对次级轴的识别与报告。.sh脚本还在收尾阶段执行了officecli validate charts-combo.xlsx用于确认生成文件通过校验。8. Python SDK 等价实现一次 resident 批量往返charts-combo.py 是 .sh 的 SDK 孪生版本它启动一个 resident 进程把 4 个工作表和 16 张图表一次性打包进单个doc.batch(...)往返中。核心模式如下import officecli # pip install officecli-sdk另需 officecli 二进制在 PATH 中 with officecli.create(FILE, --force) as doc: items [ {command: add, parent: /, type: sheet, props: {name: 1-Combo Fundamentals}}, {command: add, parent: /1-Combo Fundamentals, type: chart, props: { chartType: combo, title: Revenue vs Expenses vs Margin, series1: Revenue:120,145,160,180,195, series2: Expenses:90,100,110,115,125, series3: Margin %:25,31,31,36,36, categories: Q1,Q2,Q3,Q4,Q5, comboSplit: 2, colors: 4472C4,ED7D31,70AD47, x: 0, y: 0, width: 12, height: 18, legend: bottom}}, # ... 其余 15 张图表与 remove /Sheet1 操作 ] doc.batch(items) doc.send({command: save})每个 item 就是你会写进officecli batch列表的同一份{command,parent/path,type,props}字典。SDK 所在的仓库路径为 sdk/python/officecli.py其文档与安装说明见 sdk/python/README.md。两套入口产出的charts-combo.xlsx完全等价——这得益于上文提到的combotypes重建与直建保持 dump 幂等性的设计。9. 实战要点与注意事项小结结合文档示例与源码行为整理以下踩坑清单chartType创建后不可修改schema 明确标注set:false改类型需删除重建唯一例外是 combo 图中用combotypes做逐序列类型覆盖。combotypes与secondaryAxis的先后顺序combotypes触发全量重建并清空次级轴必须在其后再设secondaryAxis。源码通过PropOrder0的调度保证该顺序但如果你在自定义流程中混用请保持先 combotypes、后 secondaryAxis。secondaryAxis的合法取值1-based 序列索引2、逗号列表2,3、true/false/none、series2别名、或 combo 图上的类型名如line。非法值会抛异常而非静默忽略ChartHelper.Setter.cs。labelPos的类型限制doughnut/area/radar/stock 不支持pi 图限ctr/inEnd/inBase/bestFit堆叠系列会被夹到ctr/inBase/inEnd。内联数据 vs 单元格引用series1Revenue:120,145,160,180,195与categories都是内联数据schema 中categories也支持Sheet1!$A$2:$A$5形式的单元格范围引用需要从工作表取数时可直接切换。脚本容错charts-combo.sh故意不启用set -e以容忍未来属性集演进带来的UNSUPPORTED props警告退出码 2保证整个文档仍能产出——自动化流水线中建议对退出码做分级处理而非一刀切失败。10. 延伸阅读组合图之外的全部图表能力单个 demo 入口 examples/excel/charts/charts.md覆盖柱/线/饼/散点/气泡/雷达/股票/瀑布等 15 类图表。完整属性字典与各属性add/set/get权限 schemas/help/_shared/chart.json组合图核心属性combosplit、combotypes、secondaryaxis、colorrule、referenceline均在此文件。组合图结构重建与序列类型转换实现ChartHelper.Advanced.csRebuildComboChart与ConvertSeriesToType。图表属性 Setter 解析与校验逻辑ChartHelper.Setter.cs。从生成文件反读属性含次级轴、显示单位识别ChartHelper.Reader.cs。赞分享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点击查看免费下载相关推荐组合图Combo Chart完全指南组合图Combo Chart完全指南 Metabase 组合图Combo Chart完全指南折线、柱状与面积图的自由混排与逐系列定制 组合图Comb数据分析数据可视化后端数据库客户端企业应用Chart.js 组合图表实战柱状图与折线图Combo Bar/Line Chart混搭指南Chart.js 组合图表实战柱状图与折线图Combo Bar/Line Chart混搭指南 本篇技术指南以 Chart.js 官方示例 Combo ba图表库前端数据可视化OfficeCLI Excel 高级图表实战用命令行批量生成 Scatter、Bubble、Combo、Radar 与 Stock 图表OfficeCLI Excel 高级图表实战用命令行批量生成 Scatter、Bubble、Combo、Radar 与 Stock 图表 本篇技术指南围绕 O人工智能AI 应用AI 技能CLIMCP 服务上一篇3步搞定《杀戮尖塔》模组安装ModTheSpire终极使用指南下一篇UI-TARS 入门指南让 AI 看懂截图5 分钟跑通 GUI 自动化测试创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OfficeCLI 组合图（Combo Chart）实战指南：从 comboSplit 到 16 图仪表盘的 Excel 自动化
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/excel/charts/charts-combo.md 演示项目为核心讲解如何用officecli add ... --type chart --prop chartTypecombo一条命令在 Excel 工作簿中生成柱形折线、柱形面积混合的组合图并系统掌握comboSplit、combotypes、secondaryAxis、referenceLine、colorRule等近 30 个图表属性。读完本文你将能够用 CLI 一行命令或 Python SDK 批量构建包含双轴、多序列、渐变/发光/边框等效果的专业级组合图并具备用query/get反向校验生成文件的能力。1. 演示文件结构一文三件套组合图演示由三个协同文件构成均位于 examples/excel/charts 目录charts-combo.py—— 调用officecliPython SDK 生成工作簿的脚本每个图表命令以注释形式给出可复制的 Shell 等价命令charts-combo.xlsx—— 最终生成的工作簿共 5 个工作表1 个默认表 4 个图表工作表合计 16 张组合图charts-combo.md—— 本文档对应的映射说明将每个工作表映射到它演示的功能点。重新生成产物只需两步cd examples/excel python3 charts-combo.py # - charts-combo.xlsx若你更习惯纯 Shell 工作流可直接运行 CLI 双子脚本 charts-combo.sh。该脚本刻意不启用set -e其注释说明它会容忍向前兼容的UNSUPPORTED props警告officecli退出码 2继续构建以产出完整文档——这是批量脚本在属性集迭代演进时的常见容错写法。2. 组合图的三种构建路径与底层实现在看具体命令前先明确 OfficeCLI 中组合图的三个核心概念。它们在 schemas/help/_shared/chart.json 中有完整定义属性类型说明示例chartTypecomboenum声明图表为组合图chartType仅在创建时固定set:false事后改类型需删除重建--prop chartTypecombocomboSplitnumber组合分割索引前 N 个序列使用主图表类型其余序列使用次类型。仅创建时可用--prop comboSplit2combotypesstring按序列逐一指定类型column,line,area,...逗号分隔每序列一个--prop combotypescolumn,column,line,area三者的定位差异值得注意comboSplit是一刀切comboSplit2表示前 2 个序列画成柱形、其余画成折线适合收入成本利润率这类固定形态combotypes是逐序列定制允许在同一个图中混排column,column,line,area甚至支持带后缀的类型如columnstacked、areapercentstackedsecondaryAxis是把指定 1-based 序列索引如2、2,3,4挂到右侧数值轴上解决销售额百万级 增长率个位数这类量纲悬殊的展示问题。从源码看combotypes会触发一次完整的结构重建。ChartHelper.Advanced.cs 中的RebuildComboChart会先校验每个 token仅接受 bar/column/col/line/area/scatter可带 stacked/percentstacked 后缀读取全部序列数据与轴 ID删除旧的图表容器元素再按目标类型分组重建BarChart/LineChart/AreaChart/ScatterChart容器并把ConvertSeriesToType转换后的序列挂回正确的轴。该实现还包含了防御性处理重建时会顺带丢弃残留的次级轴声明避免 Excel 因孤立的catAx/valAx声明报错并为柱形组补写GapWidth150OOXML 规范默认值保证重建结果与直接构建的图表在 dump→replay 往返中完全一致。3. Sheet 1Combo Fundamentals——分割、双轴与逐序列类型第一个工作表用 4 张图覆盖comboSplit、secondaryAxis、combotypes及其组合用法。图 1基础 combocomboSplit22 柱 1 线officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop series1Revenue:120,145,160,180,195 \ --prop series2Expenses:90,100,110,115,125 \ --prop series3Margin %:25,31,31,36,36 \ --prop comboSplit2 --prop legendbottom图 2折线挂到次级 Y 轴secondaryAxis2officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop comboSplit1 --prop secondaryAxis2 \ --prop catTitleYear --prop axisTitleSales ($K)这里secondaryAxis2表示第 2 个序列如增长率百分比绘制在右侧数值轴上catTitle设置分类轴标题、axisTitle设置数值轴标题。完整的 Python 版本见 charts-combo.py还补充了series1Sales ($K):320,380,420,510,560、series2Growth %:8,19,11,21,10、colors2E75B6,C00000与x/y/width/height排版参数。图 3combotypes 逐序列类型控制officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,line,area图 4combotypes secondaryAxis 组合officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,line \ --prop secondaryAxis3secondaryAxis3让第 3 个序列Net Margin %独占右轴。需要注意源码中的一个顺序约束ChartHelper.Setter.cs中combotypes分支返回PropOrder0调度优先级确保它在secondaryAxis之后执行——因为RebuildComboChart的重建会清空次级轴绑定如果顺序颠倒右侧轴会失效对应源码注释中的 R26: combo secondaryAxis combotypes left every series on the primary axis 历史问题。本表覆盖功能点combo、comboSplit、secondaryAxis、combotypescolumn,column,line,area、catTitle、axisTitle4. Sheet 2Combo Styling——字体、渐变、数据标签与填充第二个工作表集中演示标题/图例/轴字体、系列阴影与渐变、数据标签、绘图区与图表区填充。图 1标题、图例、轴字体样式officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop title.fontGeorgia --prop title.size16 \ --prop title.color1F4E79 --prop title.boldtrue \ --prop legendfont10:333333:Calibri --prop axisfont9:666666legendfont与axisfont都采用size:color:fontname三段式格式任何一段可省略。源码ChartHelper.Setter.cs在解析时会剥离pt后缀并支持小数号如10.5pt避免静默回退到默认 10pt。标题的title.font/size/color/bold逐属性写入标题 run 的 RunProperties并同步更新 DefaultRunProperties 保持一致。图 2系列阴影与渐变officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop gradients1F4E79-5B9BD5:90;C55A11-F4B183:90 \ --prop series.shadow000000-4-315-2-30gradients按序列分号分隔每个条目是c1-c2[:angle]渐变:90为 90° 角度与对所有序列生效的gradient不同gradients可逐序列定制chart.json 中gradients定义per-series gradient fills, semicolon-separatedseries.shadow格式为COLOR-BLUR-ANGLE-DIST-OPACITY颜色-模糊-角度-距离-不透明度none可移除。图 3折线序列上的数据标签officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop dataLabelstrue --prop labelPostop \ --prop labelFont9:333333:truelabelFont的第三段为布尔true加粗。labelPos支持 center/insideEnd/outsideEnd/bestFit/top/bottom/left/right 等位置。注意 schema 中的约束提示labelPos在 doughnut/area/radar/stock 上不支持且 combo 图在部分位置处理上有专门逻辑实操时按示例使用top最稳妥。图 4图表区样式officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop plotFillF0F4F8 --prop chartFillFAFAFA \ --prop roundedCornerstrueplotFill绘图区背景与chartFill图表区背景均接受#RRGGBB、命名颜色或渐变roundedCorners开启圆角。本表覆盖功能点title.font/size/color/bold、legendfont、axisfont、gradients、series.shadow、dataLabels、labelPos、labelFont、plotFill、chartFill、roundedCorners5. Sheet 3Combo Advanced——参考线、坐标轴缩放、手动布局与标记图 1参考线与网格线officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop referenceLine110:Target:C00000 \ --prop gridlinesD9D9D9:0.5referenceLine的完整格式为value[:color][:label][:dash]示例中110:Target:C00000会在 110 处绘制一条红色目标线并标注 Targetgridlines支持true|false、color、color:width、color:width:dash四种形态none移除。图 2坐标轴缩放与显示单位officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop axisMin1000000 --prop axisMax2000000 \ --prop dispUnitsthousandsaxisMin/axisMax对应 schema 中的axismin/axismax别名min/max是数值轴刻度范围dispUnits合法取值包括hundreds、thousands、tenThousands、hundredThousands、millions、tenMillions、hundredMillions、billions、trillions见 ChartHelper.Setter.cs 的校验分支。示例将 100 万~200 万的数据以千为单位显示刻度标签变为 1000K~2000K。图 3手动绘图区布局officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop plotLayout0.1,0.15,0.85,0.75plotLayoutleft,top,width,height四个值均为 0~1 的归一化坐标示例左侧 10%、顶部 15%、宽 85%、高 75%。从源码看这对应plotarea.x/y/w/h系列属性最终由SetManualLayoutProperty写入绘图区layout元素读取路径则在 ChartHelper.Reader.cs 的ReadManualLayout中同时覆盖plotArea、title、legend、trendlineLabel、displayUnitsLabel等节点说明同一套布局机制也适用于标题与图例。图 4多折线 标记officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop comboSplit1 --prop secondaryAxis2,3,4 \ --prop markerscircle-6secondaryAxis2,3,4一次把 3 条折线North/South/West 区域占比全部挂到右轴与左轴的柱形序列Units Sold分离。markerscircle-6指定圆形标记、大小 6marker属性还支持symbol:size:color三要素circle/square/diamond/triangle/x/plus/star/dash/dot仅对 line/scatter/radar 系列生效。本表覆盖功能点referenceLine、gridlines、axisMin/Max、dispUnits、plotLayout、markers、多序列次级轴6. Sheet 4Combo Effects——发光、边框、条件着色与复杂多序列图 1标题发光与阴影officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop title.glow4472C4-6 \ --prop title.shadow000000-3-315-2-30title.glow颜色-半径给标题文字加发光title.shadow与系列阴影同格式COLOR-BLUR-ANGLE-DIST-OPACITY。底层实现ChartHelper.Setter.cs通过DrawingEffectsHelper.ApplyTextEffect将Glow/OuterShadow效果插入标题 run 的属性中。图 2图表区与绘图区边框officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop chartArea.border333333-1.5 \ --prop plotArea.border999999-0.75chartArea.border别名chartborder与plotArea.border别名plotborder均支持color[:width[:dash]]或none注意.sh脚本中使用了:分隔333333:1.5而文档示例用-分隔两种分隔符均可接受。图 3条件着色colorRuleofficecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop colorRule80:C00000:70AD47colorRulethreshold:belowColor:aboveColor实现按数据点阈值着色小于 80 的点显示C00000红大于等于 80 的点显示70AD47绿。源码 ChartHelper.Advanced.cs 会严格校验阈值必须是数字、规格必须是三段式否则直接抛ArgumentException而不是静默降级。图 45 序列混合类型仪表盘officecli add data.xlsx /Sheet --type chart \ --prop chartTypecombo \ --prop combotypescolumn,column,column,area,line \ --prop secondaryAxis5这一图完整还原了一个经营仪表盘Revenue/COGS/OpEx 三根柱、Net Income 面积、Margin % 折线挂右轴。Python 版本还配了colors4472C4,ED7D31,A5A5A5,BDD7EE,C00000五色方案与gridlinesE0E0E0:0.5浅灰网格最终删除默认空白Sheet1全部数据均为内联不依赖单元格引用。本表覆盖功能点title.glow、title.shadow、chartArea.border、plotArea.border、colorRule、5 序列combotypes7. 校验生成结果query / get / validate文档末尾给出了两条反向校验命令officecli query charts-combo.xlsx chart officecli get charts-combo.xlsx /1-Combo Fundamentals/chart[1]query ... chart列出工作簿中所有图表的概要信息get ... /1-Combo Fundamentals/chart[1]以 XPath 风格定位到指定工作表的第 1 张图表读取其完整属性树包含secondaryAxis、dispUnits、布局等 readback 字段读取逻辑见 ChartHelper.Reader.cs 对次级轴的识别与报告。.sh脚本还在收尾阶段执行了officecli validate charts-combo.xlsx用于确认生成文件通过校验。8. Python SDK 等价实现一次 resident 批量往返charts-combo.py 是 .sh 的 SDK 孪生版本它启动一个 resident 进程把 4 个工作表和 16 张图表一次性打包进单个doc.batch(...)往返中。核心模式如下import officecli # pip install officecli-sdk另需 officecli 二进制在 PATH 中 with officecli.create(FILE, --force) as doc: items [ {command: add, parent: /, type: sheet, props: {name: 1-Combo Fundamentals}}, {command: add, parent: /1-Combo Fundamentals, type: chart, props: { chartType: combo, title: Revenue vs Expenses vs Margin, series1: Revenue:120,145,160,180,195, series2: Expenses:90,100,110,115,125, series3: Margin %:25,31,31,36,36, categories: Q1,Q2,Q3,Q4,Q5, comboSplit: 2, colors: 4472C4,ED7D31,70AD47, x: 0, y: 0, width: 12, height: 18, legend: bottom}}, # ... 其余 15 张图表与 remove /Sheet1 操作 ] doc.batch(items) doc.send({command: save})每个 item 就是你会写进officecli batch列表的同一份{command,parent/path,type,props}字典。SDK 所在的仓库路径为 sdk/python/officecli.py其文档与安装说明见 sdk/python/README.md。两套入口产出的charts-combo.xlsx完全等价——这得益于上文提到的combotypes重建与直建保持 dump 幂等性的设计。9. 实战要点与注意事项小结结合文档示例与源码行为整理以下踩坑清单chartType创建后不可修改schema 明确标注set:false改类型需删除重建唯一例外是 combo 图中用combotypes做逐序列类型覆盖。combotypes与secondaryAxis的先后顺序combotypes触发全量重建并清空次级轴必须在其后再设secondaryAxis。源码通过PropOrder0的调度保证该顺序但如果你在自定义流程中混用请保持先 combotypes、后 secondaryAxis。secondaryAxis的合法取值1-based 序列索引2、逗号列表2,3、true/false/none、series2别名、或 combo 图上的类型名如line。非法值会抛异常而非静默忽略ChartHelper.Setter.cs。labelPos的类型限制doughnut/area/radar/stock 不支持pi 图限ctr/inEnd/inBase/bestFit堆叠系列会被夹到ctr/inBase/inEnd。内联数据 vs 单元格引用series1Revenue:120,145,160,180,195与categories都是内联数据schema 中categories也支持Sheet1!$A$2:$A$5形式的单元格范围引用需要从工作表取数时可直接切换。脚本容错charts-combo.sh故意不启用set -e以容忍未来属性集演进带来的UNSUPPORTED props警告退出码 2保证整个文档仍能产出——自动化流水线中建议对退出码做分级处理而非一刀切失败。10. 延伸阅读组合图之外的全部图表能力单个 demo 入口 examples/excel/charts/charts.md覆盖柱/线/饼/散点/气泡/雷达/股票/瀑布等 15 类图表。完整属性字典与各属性add/set/get权限 schemas/help/_shared/chart.json组合图核心属性combosplit、combotypes、secondaryaxis、colorrule、referenceline均在此文件。组合图结构重建与序列类型转换实现ChartHelper.Advanced.csRebuildComboChart与ConvertSeriesToType。图表属性 Setter 解析与校验逻辑ChartHelper.Setter.cs。从生成文件反读属性含次级轴、显示单位识别ChartHelper.Reader.cs。赞分享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点击查看免费下载相关推荐组合图Combo Chart完全指南组合图Combo Chart完全指南 Metabase 组合图Combo Chart完全指南折线、柱状与面积图的自由混排与逐系列定制 组合图Comb数据分析数据可视化后端数据库客户端企业应用Chart.js 组合图表实战柱状图与折线图Combo Bar/Line Chart混搭指南Chart.js 组合图表实战柱状图与折线图Combo Bar/Line Chart混搭指南 本篇技术指南以 Chart.js 官方示例 Combo ba图表库前端数据可视化OfficeCLI Excel 高级图表实战用命令行批量生成 Scatter、Bubble、Combo、Radar 与 Stock 图表OfficeCLI Excel 高级图表实战用命令行批量生成 Scatter、Bubble、Combo、Radar 与 Stock 图表 本篇技术指南围绕 O人工智能AI 应用AI 技能CLIMCP 服务上一篇3步搞定《杀戮尖塔》模组安装ModTheSpire终极使用指南下一篇UI-TARS 入门指南让 AI 看懂截图5 分钟跑通 GUI 自动化测试创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考