OfficeCLI 雷達(dá)圖Radar Chart實戰(zhàn)指南從 CLI 與 Python SDK 生成標(biāo)準(zhǔn)、標(biāo)記與填充雷達(dá)圖【免費下載鏈接】OfficeCLIOfficeCLI 是首款也是最佳的專為 AI 代理設(shè)計的命令行工具可用于讀取、編輯和自動化處理 Word、Excel 和 PowerPoint 文件。它免費、開源僅包含一個二進(jìn)制文件無需安裝 Office 套件。項目地址: https://gitcode.com/iOfficeAI/OfficeCLI導(dǎo)讀本指南以examples/excel/charts/charts-radar.md為核心完整講解如何在 OfficeCLI 中通過一條條officecli add --type chart命令或等價的 Python SDK 批處理調(diào)用為 Excel 工作簿生成 16 個雷達(dá)圖覆蓋radarStylestandard/marker/filled三種樣式、標(biāo)題與系列特效、數(shù)據(jù)標(biāo)簽與圖例、多系列對比與高級主題化方案。讀完本文你將掌握雷達(dá)圖全部核心配置參數(shù)的取值與組合方式并理解這些參數(shù)在 OfficeCLI 源碼中如何被翻譯為 OOXML 雷達(dá)圖c:radarChart。一、示例文件與整體結(jié)構(gòu)雷達(dá)圖示例由三個文件協(xié)同工作見 charts-radar.mdcharts-radar.py— Python 腳本通過 OfficeCLI Python SDKpip install officecli-sdk在單個doc.batch(...)往返中生成全部圖表每個圖表的{command,parent,type,props}字典結(jié)構(gòu)與 CLI 的officecli batch列表完全等價charts-radar.xlsx— 生成的工作簿1 個默認(rèn) Sheet 被移除后包含 4 個圖表 Sheet、共 16 個圖表charts-radar.md— 將每個 Sheet 與其演示的功能特性一一映射即本指南的主體。還有一份 CLI 孿生腳本 charts-radar.sh與 Python SDK 版本產(chǎn)出等價文件適合希望在純 Shell 環(huán)境中復(fù)現(xiàn)的用戶。二、環(huán)境準(zhǔn)備與重新生成cd examples/excel python3 charts-radar.py # → charts-radar.xlsx運行前提機(jī)器上安裝了officecli二進(jìn)制并在 PATH 中Python 版本需要officecli-sdk腳本也會自動回退使用倉庫內(nèi)sdk/python的源碼副本見 charts-radar.py。SDK 的工作方式是一次性啟動一個 resident 進(jìn)程通過命名管道把整個 Sheet 與圖表列表在單次doc.batch(...)調(diào)用中發(fā)送出去見 charts-radar.py。Bash 版本 charts-radar.sh 則是經(jīng)典的create→open→ 多條add→remove /Sheet1→close→validate流程。需要注意腳本故意不啟用set -e因為它要容忍前向兼容的 UNSUPPORTED props 警告officecli 退出碼 2繼續(xù)構(gòu)建直到產(chǎn)出完整文檔見 charts-radar.sh——這是把多步構(gòu)建腳本與嚴(yán)格錯誤處理共存時的實用經(jīng)驗。三、Sheet 1Radar Fundamentals三種雷達(dá)樣式這一 Sheet 用 4 個圖表演示雷達(dá)圖最基礎(chǔ)的能力標(biāo)準(zhǔn)、帶標(biāo)記、填充三種樣式。3.1 基礎(chǔ)標(biāo)準(zhǔn)雷達(dá)三系列officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylestandard \ --prop series1Alice:85,70,90,60,75 \ --prop series2Bob:65,90,70,80,85 \ --prop categoriesSpeed,Strength,Stamina,Agility,Accuracy \ --prop colors4472C4,ED7D31,70AD47要點解析chartTyperadar聲明圖表類型。從源碼看radar別名spider是受支持的類型之一且與 scatter 一樣是2D-only若傳入 3D 標(biāo)記會被明確拒絕并提示Use scatter / radar見 ChartHelper.csradarStylestandard樣式枚舉合法值為standard | marker | filled大小寫不敏感fill也接受見 ChartHelper.Builder.cs 的映射邏輯series1/2/3名稱:值1,值2,...內(nèi)聯(lián)數(shù)據(jù)序列值數(shù)量需與categories的條目數(shù)一致categories...逗號分隔的分類即雷達(dá)圖的輻條spokecolors4472C4,ED7D31,70AD47按位置為各系列指定顏色十六進(jìn)制 RGB 去掉#。源碼中BuildRadarChart會為每個系列調(diào)用ApplySeriesColor雷達(dá)這類線型系列的顏色被放到線條描邊a:lna:solidFill上而不是裸的a:solidFill——因為真實 PowerPoint 會忽略裸填充而回退到主題色見 ChartHelper.Builder.cs。省略colors時使用OfficeDefaultThemeColors.DefaultChartSeriesPalette默認(rèn)調(diào)色板同一常量同時供 OOXML 構(gòu)建器與 SVG 預(yù)覽渲染器使用避免兩處漂移見 ChartHelper.Builder.cs。3.2 帶標(biāo)記的雷達(dá) 數(shù)據(jù)標(biāo)簽officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylemarker \ --prop markercircle:6:2E75B6 \ --prop dataLabelstruemarkercircle:6:2E75B6標(biāo)記形狀:大小(磅):顏色可用的形狀除circle外還有diamond、square等見 Sheet 4dataLabelstrue在每個數(shù)據(jù)頂點顯示數(shù)值。SVG 渲染器把數(shù)據(jù)標(biāo)簽放在頂點沿徑向向外偏移 10px 的位置避開標(biāo)記與多邊形邊緣見 ChartSvgRenderer.cs。3.3 填充雷達(dá) 透明度officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylefilled \ --prop transparency40transparency40填充透明度0–100數(shù)值越大越透明用于讓重疊的多邊形相互透出radarStylefilled只保留區(qū)域填充、不畫數(shù)據(jù)點標(biāo)記。3.4 填充雷達(dá) 白色描邊分隔officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylefilled \ --prop series.outlineFFFFFF-0.5 \ --prop transparency35series.outlineFFFFFF-0.5系列描邊顏色-線寬(磅)。在多個填充系列相互疊加時用白色描邊把每個多邊形切出來視覺上清晰可辨series.outline這類點分屬性命名空間series.、axis.、title.、plotArea.、chartArea.等是 OfficeCLI 圖表命令的統(tǒng)一擴(kuò)展機(jī)制除了下文聲明的扁平鍵點分/索引屬性如series{N}.color、dataLabel{N}.、point{N}.同樣被驗證器接受見 schemas/help/xlsx/chart.json 的 note 說明。本 Sheet 特性匯總radar、radarStylestandard/marker/filled、markercircle:6:color、transparency、series.outline、dataLabels、legendbottom。四、Sheet 2Radar Styling圖表美化這一 Sheet 聚焦標(biāo)題、陰影、坐標(biāo)軸字體、網(wǎng)格線與圖表區(qū)域裝飾。4.1 標(biāo)題樣式字體/字號/顏色/加粗/陰影officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop title.fontGeorgia --prop title.size18 \ --prop title.color1F4E79 --prop title.boldtrue \ --prop title.shadow000000-3-315-2-30title.shadow000000-3-315-2-30的段格式為顏色-透明度-角度-距離-模糊此處即黑色、透明度 3、315° 投影方向、2pt 距離、30% 模糊。4.2 系列陰影officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylefilled \ --prop series.shadow000000-4-315-2-30 \ --prop transparency30對填充雷達(dá)的系列整體加投影透明度 4讓區(qū)域產(chǎn)生浮起的層次感。注意title.shadow與series.shadow只是同一段式陰影格式應(yīng)用于不同對象。4.3 坐標(biāo)軸字體與網(wǎng)格線officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop axisfont10:333333:Calibri \ --prop gridlinesD9D9D9:0.5axisfont10:333333:Calibri字號:顏色:字體族gridlinesD9D9D9:0.5網(wǎng)格線顏色:線寬(磅)。網(wǎng)格線對應(yīng) SVG 渲染中的 5 圈同心多邊形見 ChartSvgRenderer.cs。4.4 圖表區(qū)裝飾填充、圓角、邊框officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop plotFillF5F5F5 --prop chartFillFAFAFA \ --prop roundedCornerstrue \ --prop chartArea.borderBFBFBF:0.5 \ --prop plotArea.borderD9D9D9:0.25plotFill繪圖區(qū)背景色chartFill整個圖表區(qū)背景色roundedCornerstrue圖表區(qū)圓角開關(guān)schema 中聲明為true|false見 schemas/help/xlsx/chart.jsonchartArea.border/plotArea.border各自區(qū)域的邊框顏色:線寬。本 Sheet 特性匯總title.font/size/color/bold/shadow、series.shadow、axisfont、gridlines、plotFill、chartFill、roundedCorners、chartArea.border、plotArea.border。五、Sheet 3Labels Legend標(biāo)簽與圖例5.1 數(shù)據(jù)標(biāo)簽字體與位置officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylemarker \ --prop dataLabelstrue --prop labelPosoutsideEnd \ --prop labelFont9:333333:true \ --prop markercircle:6:2E75B6labelPosoutsideEnd標(biāo)簽位于頂點外側(cè)。需要留意的是在 Setter 源碼中有一處明確注釋dLblPos 對 doughnut、area、radar、stock 圖表并不適用見 ChartHelper.Setter.cs——即outsideEnd在雷達(dá)圖中由渲染層按徑向偏移方式實現(xiàn)而非寫死 OOXML 的dLblPos枚舉labelFont9:333333:true字號:顏色:是否加粗。5.2 圖例定位與覆蓋officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop legendright \ --prop legendfont10:1F4E79:Calibri \ --prop legend.overlaytruelegendright圖例位置bottom、right等legendfont10:1F4E79:Calibri圖例字體legend.overlaytrue圖例浮在繪圖區(qū)之上節(jié)省縱向空間。5.3 手動繪圖區(qū)布局分?jǐn)?shù)坐標(biāo)officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop plotArea.x0.1 --prop plotArea.y0.15 \ --prop plotArea.w0.8 --prop plotArea.h0.75plotArea.x/y/w/h使用相對于圖表區(qū)的分?jǐn)?shù)坐標(biāo)0–1本例將繪圖區(qū)置于圖表區(qū)左上角 10%/15% 處寬度 80%、高度 75%可精確控制雷達(dá)在整圖中的位置與大小。5.4 五系列同圖對比officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop series1Dev:90,70,80,65,75 \ --prop series2QA:60,85,70,80,90 \ --prop series3Design:75,80,85,70,60 \ --prop series4PM:80,65,75,90,70 \ --prop series5DevOps:70,75,60,85,80 \ --prop colors4472C4,ED7D31,70AD47,FFC000,7030A05 個系列疊加在同一張標(biāo)準(zhǔn)雷達(dá)上配合 5 色配色4472C4, ED7D31, 70AD47, FFC000, 7030A0完成多團(tuán)隊能力對比。構(gòu)建器中系列按Index/Order依次寫入c:sercolors數(shù)組按位置一一對應(yīng)見 ChartHelper.Builder.cs。本 Sheet 特性匯總dataLabels、labelPosoutsideEnd、labelFont、legendright、legendfont、legend.overlay、plotArea.x/y/w/h、單圖 5 系列。六、Sheet 4Advanced高級效果6.1 標(biāo)題發(fā)光 陰影 菱形標(biāo)記officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop title.glow4472C4-8 \ --prop title.shadow000000-3-315-2-30 \ --prop markerdiamond:7:2E75B6title.glow4472C4-8發(fā)光顏色-半徑(磅)。與title.shadow組合可做出霓虹標(biāo)題效果markerdiamond:7:2E75B6演示菱形標(biāo)記大小 7pt。6.2 8 輻條雷達(dá) 基準(zhǔn)線疊加officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylefilled \ --prop categoriesTechnical,Communication,Leadership,Creativity,Analytical,Teamwork,Adaptability,Initiative \ --prop gridlinesD9D9D9:0.25 --prop transparency35傳入 8 個分類即得到 8 輻條雷達(dá)。Python SDK 版還疊加了一條灰色BFBFBF的全 70 分 Benchmark 系列用于候選人能力與基準(zhǔn)線的對照見 charts-radar.py。SVG 渲染按catCount均勻分布輻條角度-π/2 2π·c/catCount分類數(shù)不限 5見 ChartSvgRenderer.cs。6.3 單系列主題化配色紫色系officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylemarker \ --prop colors7030A0 --prop markersquare:7:7030A0 \ --prop title.color7030A0 --prop plotFillF8F0FF \ --prop chartArea.border7030A0:0.5 --prop roundedCornerstrue整套方案統(tǒng)一使用紫色7030A0系列線、方形標(biāo)記、標(biāo)題顏色一致淺紫繪圖區(qū)F8F0FF搭配紫色細(xì)邊框是個人畫像類單系列雷達(dá)的完整主題化范例Python 版還加入了dataLabelstrue與labelFont9:7030A0:true見 charts-radar.py。6.4 低透明度重疊前后對比圖officecli add data.xlsx /Sheet --type chart \ --prop chartTyperadar \ --prop radarStylefilled \ --prop transparency20 \ --prop series.outlineFFFFFF-0.75 \ --prop chartFillFAFAFA --prop plotFillF5F5F5transparency20較低值讓 Before紅C00000與 After綠70AD47兩個填充區(qū)域可辨識地重疊白色描邊0.75pt進(jìn)一步分離邊界是前后對比的經(jīng)典可視化模式。Python 版在此圖同樣啟用了數(shù)據(jù)標(biāo)簽見 charts-radar.py。本 Sheet 特性匯總title.glow、title.shadow、markerdiamond/square、8 分類輻條、主題化配色方案、低透明度重疊可視化、前后對比模式。七、參數(shù)速查表參數(shù)格式/取值說明出現(xiàn)位置chartTyperadar別名spider聲明雷達(dá)圖2D-only全部圖表radarStylestandard|marker|filled雷達(dá)樣式fill亦被接受見 ChartHelper.Builder.csSheet 1–4series{N}名稱:v1,v2,...內(nèi)聯(lián)系列數(shù)據(jù)Sheet 1/3/4categories逗號分隔字符串雷達(dá)輻條數(shù)量決定輻條數(shù)全部colors逗號分隔十六進(jìn)制去#按位置為系列著色全部marker形狀:大小:顏色形狀支持 circle/diamond/square 等Sheet 1/3/4dataLabelstrue|false頂點數(shù)值標(biāo)簽Sheet 1/3/4labelPosoutsideEnd等標(biāo)簽位置radar 由渲染層實現(xiàn)Sheet 3labelFont字號:顏色:加粗?jǐn)?shù)據(jù)標(biāo)簽字體Sheet 3/4legendbottom|right等圖例位置Sheet 1/3legendfont字號:顏色:字體族圖例字體Sheet 3legend.overlaytrue|false圖例浮于繪圖區(qū)Sheet 3transparency0–100 整數(shù)填充透明度Sheet 1/2/4series.outline顏色:線寬系列描邊多填充區(qū)分隔Sheet 1/4title.font/size/color/bold—標(biāo)題字體/字號/顏色/加粗Sheet 2/4title.shadow顏色-透明度-角度-距離-模糊標(biāo)題陰影Sheet 2/4title.glow顏色-半徑標(biāo)題發(fā)光Sheet 4series.shadow顏色-透明度-角度-距離-模糊系列陰影Sheet 2axisfont字號:顏色:字體族坐標(biāo)軸字體Sheet 2gridlines顏色:線寬網(wǎng)格線Sheet 2/4plotFill/chartFill十六進(jìn)制顏色繪圖區(qū)/圖表區(qū)背景Sheet 2/4roundedCornerstrue|false圖表區(qū)圓角Sheet 2/4chartArea.border/plotArea.border顏色:線寬區(qū)域邊框Sheet 2/4plotArea.x/y/w/h0–1 分?jǐn)?shù)繪圖區(qū)手動布局Sheet 3關(guān)于合法性校驗radarStyle在 schema 中聲明為add/set/get全支持、appliesWhen.chartTyperadar非法值會被 Setter 拒絕并提示Invalid radarStyle .... Valid values: standard, filled, marker.見 ChartHelper.Setter.cs 與 schemas/help/xlsx/chart.json。八、驗證生成結(jié)果生成完成后可以用查詢命令反向檢查文件結(jié)構(gòu)與屬性驗證 16 個雷達(dá)圖是否齊全、radarStyle等屬性是否正確回讀officecli query charts-radar.xlsx chart officecli get charts-radar.xlsx /1-Radar Fundamentals/chart[1]query列出所有圖表節(jié)點get按SheetName/chart[N]定位路徑讀取單個圖表的屬性。雷達(dá)圖的類型回讀由 Reader 完成C.RadarChart radar、radarStyle從c:radarStyle元素取值見 ChartHelper.Reader.cs。Bash 腳本最后還會執(zhí)行officecli validate $FILE對文件做 schema 級校驗見 charts-radar.sh。九、小結(jié)從本示例可以提煉出 OfficeCLI 雷達(dá)圖的使用方法論先用chartTyperadarradarStyle定骨架再用series{N}與categories填充數(shù)據(jù)最后用點分屬性逐層美化標(biāo)題 → 系列 → 坐標(biāo)軸/網(wǎng)格 → 圖表區(qū)。16 個圖表的組合演示覆蓋了絕大多數(shù)真實場景——人才評估、產(chǎn)品評分、團(tuán)隊對比、KPI 對標(biāo)、前后對比等——所有命令均可直接復(fù)制運行且 CLI 與 Python SDK 兩條路徑產(chǎn)出等價文件適合 AI 代理在自動化流程中按需選用?！久赓M下載鏈接】OfficeCLIOfficeCLI 是首款也是最佳的專為 AI 代理設(shè)計的命令行工具可用于讀取、編輯和自動化處理 Word、Excel 和 PowerPoint 文件。它免費、開源僅包含一個二進(jìn)制文件無需安裝 Office 套件。項目地址: https://gitcode.com/iOfficeAI/OfficeCLI創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考