# 使用 excelcli 实现 Excel 自动化 ## 前提条件 * 安装了 Microsoft Excel 的 Windows 主机（2016+） * 使用 COM 互操作 — 不适用于 macOS 或 Linux * 安装：`dotnet 工具安装 --global Sbroenne.ExcelMcp.CLI` ## 工作流程清单步骤|命令|当 ---|---|--- 1\.会议| `会话创建/打开` |永远第一 2\.床单| `工作表创建/重命名` |如果需要的话 3\.写入数据|见下文 |如果写值 4\.保存并关闭 | `会话关闭--保存` |永远最后 > **10 多个命令？** 使用 `excelcli -q batch --inputCommands.json` — 通过自动会话管理在一个进程中发送所有命令。参见规则 8。 **写入数据（第3步）：** * `--values` 采用 JSON 2D 数组字符串：`--values '[["Header1","Header2"],[1,2]]'` * 为了可靠性，**一次写入一行**： `--range-address A1:B1 --values '[["Name","Age"]]'` * JSON 中的字符串必须用双引号引起来：`"text"`。数字是空的：`42` * 始终将整个 JSON 值用单引号括起来以保护特殊字符 ## 关键规则（必须遵守） > **⚡ 构建仪表板或批量操作？** 跳至 **规则 8：批处理模式** — 它消除了每个命令的流程开销并自动管理会话 ID。 ### 规则 1：永远不要问澄清问题执行命令来发现答案：不要问 |改为这样做 ---|--- “我应该使用哪个文件？” | `excelcli -q 会话列表` “我该用什么桌子？” | `excelcli -q 表列表 --session ` “哪张纸上有数据？” | `excelcli -q 工作表列表 --session ` **你有命令来回答你自己的问题。使用它们。** ### 规则 2：始终以文本摘要结尾 **永远不要仅通过执行命令来结束回合。**完成所有操作后，请务必提供一条简短的短信来确认已完成的操作。仅静默命令响应是不完整的。 ### 规则 3：会话生命周期 **创建与打开文件：** # 新文件 - 使用会话创建 excelcli -q session create C:\path\newfile.xlsx # 创建文件 + 返回会话 ID # 现有文件 - 使用会话打开 excelcli -q session open C:\path\existing.xlsx # 打开文件 + 返回会话 ID **关键：对新文件使用`session create`。对不存在的文件进行“会话打开”将会失败！** **重要：在后续命令中始终使用“session create”或“session open”返回的会话 ID。切勿猜测或硬编码会话 ID。会话 ID 位于 JSON 输出中（例如 `{"sessionId":"abc123"}`）。解析并使用它。** # 示例：从输出中捕获会话 ID，然后使用它 excelcli -q session create C:\path\file.xlsx # 返回带有 sessionId 的 JSON excelcli -q 范围设置值 --session <返回的会话 ID> ... excelcli -q 会话关闭 --session <返回的会话 ID> --save **未关闭的会话使 Excel 进程保持运行，并锁定文件。** ### 规则 4：数据模型先决条件 DAX 操作需要数据模型中的表： excelcli -q table add-to-data-model --session --table-name Sales # 步骤 1 excelcli -q datamodel create-measure --session ... # 步骤 2 - 现在可以使用 ### 规则 5：Power Query 开发生命周期 **最佳实践：在创建永久查询之前测试 M 代码** # 第 1 步：测试 M 代码而不进行持久化（及早捕获错误） excelcli -q powerquery 评估 --session 1 --m-code-file query.m # 第 2 步：使用经过验证的代码创建永久查询 excelcli -q powerquery create --session 1 --query-name Q1 --m-code-file query.m # 第三步：将数据加载到目的地 excelcli -q powerquery 刷新 --会话 1 --查询名称 Q1 ### 规则 6：立即报告文件错误如果您看到“找不到文件”或“找不到路径” - 停止并向用户报告。不要重试。 ### 规则 7：使用计算模式进行批量写入当写入许多值/公式（10 个以上单元格）时，请禁用自动重新计算以提高性能： # 1.设置手动模式 excelcli -q 计算模式设置模式 --session 1 --mode 手动 # 2. 逐行写入数据以确保可靠性 excelcli -q range set-values --session 1 --sheet-name Sheet1 --range-address A1:B1 --values '[["名称","金额"]]' excelcli -q range set-values --session 1 --sheet-name Sheet1 --range-address A2:B2 --values '[["Salary",5000]]' # 3.最后重新计算一次 excelcli -q 计算模式计算 --session 1 --scope 工作簿 # 4.恢复自动模式 excelcli -q 计算模式设置模式--会话1--模式自动 ### 规则 8：使用批处理模式进行批量操作（10 个以上命令）当对同一文件执行 10 多个命令时，使用“excelcli batch”在单个进程启动中发送所有命令。这避免了每个进程的启动开销和终端缓冲区饱和。 # 创建一个包含所有命令的 JSON 文件 @' [ {"command": "session.open", "args": {"filePath": "C:\\path\\file.xlsx"}}, {"command": "range.set-values", "args": {"sheetName": "Sheet1", "rangeAddress": "A1", "values": [["Hello"]]}}, {"command": "range.set-values", "args": {"sheetName": "Sheet1", "rangeAddress": "A2", "values": [["World"]]}}, {"command": "session.close", "args": {"save": true}} ] '@ |设置内容命令.json # 一次性执行所有命令 excelcli -q 批处理--输入命令.json **主要特点：** * **会话自动捕获** : `session.open`/`create` 结果 sessionId 自动注入到后续命令中 - 无需解析和传递会话 ID * **NDJSON 输出** ：每行一个 JSON 结果：`{"index": 0, "command": "...", "success": true, "result": {...}}` * **`--stop-on-error`** ：第一次失败时退出（默认：继续全部） * **`--session`**：为所有命令预设会话ID（跳过session.open） **输入格式：** * 文件中的 JSON 数组：`excelcli -q batch --inputCommands.json` * 来自标准输入的 NDJSON：“获取内容命令.ndjson | excelcli -q 批处理` ## CLI 命令参考 > 从 `excelcli --help` 自动生成。使用这些确切的参数名称。 ###计算模式控制 Excel 重新计算（自动与手动）。在批量写入之前设置手动模式以获得更快的性能，然后在最后重新计算一次。 **操作：** `get-mode`、`set-mode`、`calculate` 参数|描述 ---|--- `--模式` |目标计算模式（需要：set-mode） `--范围` |范围：工作簿、工作表或范围（需要：计算） `--工作表名称` |工作表名称（工作表/范围范围必需） `--范围地址` |范围地址（范围范围所需） ###图表图表生命周期 - 创建、读取、移动和删除嵌入图表。定位（选择一项）： - targetRange（首选）：单元格范围，如“F2:K15”——单元格内的位置图表，无需点数学。 - 左/上：以点为单位手动定位（72 点 = 1 英寸）。 - 两者都不是：自动将图表放置在所有现有内容下方（使用的范围+其他图表）。碰撞检测：所有创建/移动/适合范围操作都会自动检查与数据和其他图表的重叠。如果检测到冲突，则会在结果消息中返回警告。创建图表后，始终使用屏幕截图（捕获表）验证布局。图表类型：70 多种可用类型，包括柱形图、折线图、饼图、条形图、面积图、XY 散点图。创建选项： - create-from-range：从单元格范围创建（例如“A1:D10”） - create-from-table：从 Excel 表创建（使用表的数据范围） - create-from-pivottable：创建链接的数据透视图对系列、标题、图例、样式、放置模式使用图表配置。 **操作：** `列表`、`读取`、`从范围创建`、`从表创建`、`从数据透视表创建`、`删除`、`移动`、`适合范围` 参数|描述 ---|--- `--图表名称` |图表的名称（或形状名称）（需要：读取、删除、移动、适合范围） `--工作表名称` |目标工作表名称（需要：从范围创建、从表创建、从数据透视表创建、适合范围） `--源范围地址` |图表的数据范围（例如，A1:D10）（需要：create-from-range） `--图表类型` |要创建的图表类型（需要：从范围创建、从表创建、从数据透视表创建） `--左` |距工作表边缘的左侧位置（以磅为单位） `--顶部` |距工作表边缘的顶部位置（以点数为单位） `--宽度` |图表宽度（以磅为单位） `--高度` |图表高度（以点为单位） `--目标范围` |用于在其中放置图表的单元格范围（例如“F2:K15”）。优先于左侧/顶部。设置后，左/上将被忽略。 `--表名` | Excel 表的名称（需要：create-from-table） `--数据透视表名称` |源数据透视表的名称（需要：create-from-pivottable） `--范围地址` |图表适合的范围（例如，A1:D10）（需要：适合范围） ### 图表配置图表配置 - 数据源、系列、类型、标题、轴标签、图例和样式。系列管理： - add-series：添加带有valuesRange（必需）和可选categoryRange的数据系列 - remove-series：按从1开始的索引删除系列 - set-source-range：替换整个图表数据源标题和标签： - set-title：设置图表标题（空字符串隐藏标题） - set-axis-title：设置轴标签（Category、Value、CategorySecondary、ValueSecondary）样式：1-48（具有不同配色方案的内置 Excel 样式）数据标签：显示值、百分比、系列/类别名称。位置：中心、InsideEnd、InsideBase、OutsideEnd、BestFit。趋势线：线性、指数、对数、多项式（2-6 阶）、幂、移动平均线。放置模式： - 1：随单元格移动并调整大小 - 2：移动但不随单元格调整大小 - 3：不随单元格移动或调整大小（自由浮动）使用图表进行生命周期操作（创建、删除、移动、适合范围）。 **操作：** `set-source-range`、`add-series`、`remove-series`、`set-chart-type`、`set-title`、`set-axis-title`、`get-axis-number-format`、`set-axis-number-format`、`show-legend`、`set-style`、`set-placement`、`set-data-labels`、`get-axis-scale`、`set-axis-scale`、 `获取网格线`、`设置网格线`、`设置系列格式`、`列表趋势线`、`添加趋势线`、`删除趋势线`、`设置趋势线` 参数|描述 ---|--- `--图表名称` |图表名称（必填） `--源范围` |新数据源范围（例如，Sheet1!A1:D10）（需要：set-source-range） `--系列名称` |系列的显示名称（必需：add-series） `--值范围` |包含系列值的范围（例如，B2:B10）（需要：add-series） `--类别范围` |类别标签的可选范围（例如，A2:A10） `--系列索引` |要删除的系列的基于 1 的索引（需要：remove-series、set-series-format、list-trendlines、add-trendline、delete-trendline、set-trendline） `--图表类型` |要应用的新图表类型（需要：set-chart-type） `--标题` |要显示的标题文本（需要：set-title、set-axis-title） `--轴` |要为哪个轴设置标题（Category、Value、SeriesAxis）（需要：set-axis-title、get-axis-number-format、set-axis-number-format、get-axis-scale、set-axis-scale、set-gridlines） `--数字格式` | Excel 数字格式代码（例如，“$#,##0”、“0.00%”）（需要：set-axis-number-format） `--可见` | True 表示显示图例，False 表示隐藏（需要：show-legend） `--图例位置` |图例的可选位置 `--style-id` | Excel 图表样式 ID（大多数图表类型为 1-48）（需要：set-style） `--放置` |放置模式：1=MoveAndSize、2=Move、3=FreeFloating（需要：set-placement） `--显示值` |在标签上显示数据值 `--显示百分比` |显示百分比值。仅对饼图和圆环图类型有意义；在其他图表类型上设置为 true 没有视觉效果。 `--show-系列名称` |在标签上显示系列名称 `--显示类别名称` |在标签上显示类别名称 `--显示气泡大小` |显示气泡大小（气泡图） `--分隔符` |标签组件之间的分隔符字符串 `--标签位置` |数据标签相对于数据点的位置 `--最小规模` |最小轴值（自动为空） `--最大规模` |最大轴值（自动为空） `--主要单位` |主要网格线间隔（自动为空） `--次要单位` |次网格线间隔（自动为空） `--显示专业` |显示主要网格线（空以保持最新） `--show-minor` |显示次要网格线（空以保持最新） `--标记样式` |标记形状样式 `--标记大小` |标记大小（以磅为单位） (2-72) `--标记背景颜色` |标记填充颜色 (#RRGGBB) `--标记前景色` |标记边框颜色 (#RRGGBB) `--反转负数` |反转负值的颜色 `--趋势线类型` |趋势线类型（线性、指数等）（需要：add-trendline） `--顺序` |多项式阶数（2-6，适用于多项式类型） `--句号` |移动平均周期（对于 MovingAverage 类型） `--前进` |向前延长的期限 `--向后` |向后延长的时期 `--拦截` |通过特定的 Y 截距强制趋势线 `--显示方程` |在图表上显示趋势线方程 `--显示-r-squared` |在图表上显示 R 平方值 `--名称` |趋势线的自定义名称 `--趋势线指数` |要删除的趋势线的从 1 开始的索引（需要：delete-trendline、set-trendline） ### 条件格式条件格式 - 基于单元格值的视觉规则。类型：cellValue（需要运算符类型+公式1）、表达式（仅限公式）。驼峰式和烤肉串式都被接受。格式：interiorColor/fontColor 为 #RRGGBB、fontBold/Italic、borderStyle/Color。运算符：等于、不等于、大于、小于、大于等于、小于等于、介于、不介于之间。对于“Between”和“notBetween”，公式 1 和公式 2 都是必需的。 **操作：** `添加规则`、`清除规则` 参数|描述 ---|--- `--工作表名称` |工作表名称（活动工作表为空） `--范围地址` |范围地址（A1 表示法或命名范围） `--规则类型` |规则类型：cellValue（或单元格值）、表达式、colorScale、dataBar、top10、iconSet、uniqueValues、blanksCondition、timePeriod、aboveAverage。驼峰式和烤肉串式都被接受。 `--运算符类型` | XlFormatConditionOperator：等于、不等于、大于、小于、greaterEqual、lessEqual、之间、notBetween `--公式1` |条件的第一个公式/值 `--公式2` |第二个公式/值（用于 Between/notBetween） `--室内颜色` |填充颜色（#RRGGBB 或颜色索引） `--室内图案` |内部图案（1=实心，-4142=无，9=灰色50等） `--字体颜色` |字体颜色（#RRGGBB 或颜色索引） `--字体粗体` |粗体字体 `--斜体字体` |斜体字体 `--边框样式` |边框样式：无、连续、虚线、点等。 `--边框颜色` |边框颜色（#RRGGBB 或颜色索引） ### 连接数据连接（OLEDB、ODBC、ODC 导入）。 TEXT/WEB/CSV：改用 powerquery。 Power Query 连接自动重定向到 powerquery。超时：刷新/加载自动超时 30 分钟。 **操作：** `list`、`view`、`create`、`refresh`、`delete`、`load-to`、`get-properties`、`set-properties`、`test` 参数|描述 ---|--- `--连接名称` |要查看的连接名称 `--连接字符串` | OLEDB 或 ODBC 连接字符串 `--命令文本` | SQL 查询或表名 `--描述` |连接的可选描述 `--超时` |刷新操作的可选超时 `--工作表名称` |目标工作表名称 `--连接字符串` |新连接字符串（空以保持最新） `--命令文本` |新的 SQL 查询或表名称（空以保持最新） `--后台查询` |在后台运行查询（空以保持最新） `--打开文件时刷新` |文件打开时刷新（空以保持最新） `--保存密码` |保存连接中的密码（空以保持最新） `--刷新周期` |自动刷新间隔（以分钟为单位）（空以保持最新） ### 数据模型数据模型 (Power Pivot) - DAX 度量和表管理。关键：工作表和数据模型是分开的！ - 表追加更改后，数据模型仍然具有旧数据 - 必须调用刷新来同步更改 - Power Query 刷新自动同步（无需手动刷新）先决条件：必须首先将表添加到数据模型中。使用工作表的 table add-to-datamodel 或 powerquery 将数据直接导入和加载到数据模型。 DAX 测量： - 使用“SUM(Sales[Amount])”等 DAX 公式创建 - DAX 公式在创建/更新时通过 Dax.Formatter (SQLBI) 自动格式化 - 读取操作返回存储的原始 DAX DAX EVALUATE 查询： - 使用评估对数据模型执行 DAX EVALUATE 查询 - 从“EVALUATE TableName”等查询返回表格结果 - 支持复杂 DAX： SUMMARIZE、FILTER、CALCULATETABLE、TOPN 等。 DMV（动态管理视图）查询： - 使用execute-dmv 通过类似 SQL 的语法查询数据模型元数据 - 语法：SELECT * FROM $SYSTEM.SchemaRowset（仅支持 SELECT *） - 使用 DISCOVER_SCHEMA_ROWSETS 列出所有可用的 DMV 使用 datamodelrel 建立表之间的关系。 **操作：** `list-tables`、`list-columns`、`read-table`、`read-info`、`list-measures`、`read`、`delete-measure`、`delete-table`、`rename-table`、`refresh`、`create-measure`、`update-measure`、`evaluate`、`execute-dmv` 参数|描述 ---|--- `--表名` |列出其中列的表的名称（必需：list-columns、read-table、delete-table、create-measure） `--测量名称` |要获取的度量的名称（需要：读取、删除度量、创建度量、更新度量） `--旧名称` |表的当前名称（需要：重命名表） `--新名称` |表的新名称（需要：重命名表） `--超时` |可选：刷新操作超时 `--dax 公式` |度量的 DAX 公式（将自动格式化）（创建度量所需） `--格式类型` |可选：格式类型（货币、小数、百分比、常规） `--描述` |可选：措施说明 `--dax-query` | DAX EVALUATE 查询（例如，“EVALUATE 'TableName'”或“EVALUATE SUMMARIZE(...)”）（需要：评估） `--dmv-query` |采用类似 SQL 语法的 DMV 查询（例如“SELECT * FROM $SYSTEM.TMSCHEMA_TABLES”）（需要：execute-dmv） ### 数据模型关系数据模型关系 - 用于跨表 DAX 计算的链接表。严重：删除或重新创建表会删除它们的所有关系。在表操作之前使用列表关系进行备份，然后在架构更改后重新创建关系。关系要求： - 两个表必须首先存在于数据模型中 - 列必须具有兼容的数据类型 - fromTable/fromColumn = 多侧（详细表、外键） - toTable/toColumn = 单侧（查找表、主键）活动与非活动： - 两个表之间只能存在一个活动关系 - 创建替代路径时使用 active=false - DAX USERELATIONSHIP() 激活非活动关系 **操作：** `列表关系`、`读取关系`、`创建关系`、`更新关系`、`删除关系` 参数|描述 ---|--- `--来自表` |源表名称（必需：读取关系、创建关系、更新关系、删除关系） `--来自列` |源列名称（必需：读取关系、创建关系、更新关系、删除关系） `--到表` |目标表名称（必需：读取关系、创建关系、更新关系、删除关系） `--到列` |目标列名称（必需：读取关系、创建关系、更新关系、删除关系） `--活跃` |关系是否应处于活动状态（默认值：true）（需要：update-relationship） ### 诊断用于在不使用 Excel 的情况下测试 CLI/MCP 基础设施的诊断命令。这些命令验证参数解析、路由、JSON 序列化和错误处理 — 无需 Excel COM 会话。 **操作：** `ping`、`echo`、`validate-params` 参数|描述 ---|--- `--消息` |要回显的消息（必需）（必需：echo） `--标签` |要包含在响应中的可选标签 `--名称` |必需的名称参数（需要：validate-params） `--计数` |必需的整数参数（需要：validate-params） `--标签` |可选标签参数 `--详细` |可选布尔标志（默认值：false） ### 命名范围公式/参数的命名范围。 CREATE/UPDATE：值是单元格引用（例如，“Sheet1！$A$1”）。 WRITE：值是要存储的数据。提示：批量数据读/写的范围（rangeAddress=namedRangeName）。 **操作：** `列表`、`写入`、`读取`、`更新`、`创建`、`删除` 参数|描述 ---|--- `--名称` |命名范围的名称（需要：写入、读取、更新、创建、删除） `--值` |要设置的值（需要：写入） `--参考` |新单元格引用（例如，Sheet1!$A$1:$B$10）（需要：更新、创建） ### 数据透视表数据透视表生命周期管理：从各种来源创建、列出、读取详细信息、刷新和删除。使用pivottablefield进行字段操作，使用pivottablecalc进行计算字段和布局。最佳实践：在创建之前使用“列表”。优先选择“刷新”或字段修改而不是删除+重新创建。删除+重新创建会丢失字段配置、过滤器、排序和自定义布局。刷新：使用数据透视表字段配置字段后调用“刷新”以更新视觉显示。这对于 OLAP/数据模型数据透视表尤其重要，其中字段操作仅是结构性的，不会自动触发视觉刷新。创建选项： - 'create-from-range'：使用源工作表和数据范围的范围地址 - 'create-from-table'：使用 Excel 表 (ListObject) 作为源 - 'create-from-datamodel'：使用 Power Pivot 数据模型表作为源 **操作：** `列表`、`读取`、`从范围创建`、`从表创建`、`从数据模型创建`、`删除`、`刷新` 参数|描述 ---|--- `--数据透视表名称` |数据透视表的名称（需要：读取、从范围创建、从表创建、从数据模型创建、删除、刷新） `--源表` |源工作表名称（需要：create-from-range） `--源范围` |源范围地址（例如“A1:F100”）（需要：create-from-range） `--目标表` |目标工作表名称（需要：从范围创建、从表创建、从数据模型创建） `--目标单元格` |目标单元格地址（例如“A1”）（以下情况需要：从范围创建、从表创建、从数据模型创建） `--表名` | Excel 表的名称（需要：create-from-table、create-from-datamodel） `--超时` |刷新操作的可选超时 ### 数据透视表计算数据透视表计算字段/成员、布局配置和数据提取。使用数据透视表进行生命周期，使用数据透视表字段进行字段放置。计算字段（对于常规数据透视表）： - 使用“=收入-成本”或“=数量*单价”等公式创建自定义字段 - 可以按名称引用现有字段 - 创建后，使用数据透视表字段添加值字段添加到值区域 - 对于复杂的多表计算，更喜欢使用数据模型的 DAX 度量计算成员（仅适用于 OLAP/数据模型数据透视表）： - 使用 MDX 表达式创建 -成员类型：成员、集、度量布局选项： - 0 = 紧凑（默认，单列中的字段） - 1 = 表格（单独列中的每个字段 - 最适合导出/分析） - 2 = 轮廓（带展开/折叠的分层结构） **操作：** `获取数据`、`创建计算字段`、`列表计算字段`、`删除计算字段`、`列表计算成员`、`创建计算成员`、`删除计算成员`、`设置布局`、`设置小计`、`设置总计` 参数|描述 ---|--- `--数据透视表名称` |数据透视表的名称（必填） `--字段名称` |计算字段的名称（必需：create-calculated-field、delete-calculated-field、set-subtotals） `--公式` |使用字段引用的公式（例如“=收入-成本”）（需要：create-calculated-field、create-calculated-member） `--成员名称` |计算成员的名称（MDX 命名格式）（需要：create-calculated-member、delete-calculated-member） `--类型` |计算成员的类型（成员、集或度量） `--解决顺序` |计算优先级的求解顺序（默认值：0） `--显示文件夹` |显示用于组织度量的文件夹路径（可选） `--数字格式` |计算成员的数字格式代码（可选） `--行布局` |布局形式：0=紧凑、1=表格、2=轮廓（需要：set-layout） `--显示小计` | True 表示显示自动小计，False 表示隐藏（需要：set-subtotals） `--show-row-grand-totals` |显示行总计（底部汇总行）（需要：set-grand-totals） `--显示列总计` |显示列总计（右侧汇总列）（需要：set-grand-totals） ### 数据透视表字段数据透视表字段管理：添加/删除/配置字段、过滤、排序和分组。使用数据透视表进行生命周期，使用数据透视表计算计算字段和布局。重要提示：现场操作仅修改结构。配置字段后调用数据透视表刷新以更新可视化显示，特别是对于 OLAP/数据模型数据透视表。字段区域： - 行字段：按类别对数据进行分组 (add-row-field) - 列字段：创建列标题 (add-column-field) - 值字段：使用 Sum、Count、Average 等聚合数值数据 (add-value-field) - 筛选字段：添加报告级别筛选器 (add-filter-field) 聚合功能：Sum、Count、Average、Max、Min、Product、Counts、StdDev、 StdDevP、Var、VarP 分组： - 日期字段：按天、月、季度、年分组（按日期分组） - 数字字段：按开始/结束/间隔范围分组（按数字分组）数字格式：使用美国格式代码，如货币“#,##0.00”或百分比“0.00%”。 **操作：** `列表字段`、`添加行字段`、`添加列字段`、`添加值字段`、`添加过滤字段`、`删除字段`、`设置字段功能`、`设置字段名称`、`设置字段格式`、`设置字段过滤器`、`排序字段`、`按日期分组`、`按数字分组` 参数|描述 ---|--- `--数据透视表名称` |数据透视表的名称（必填） `--字段名称` |要添加的字段名称（必需：add-row-field、add-column-field、add-value-field、add-filter-field、remove-field、set-field-function、set-field-name、set-field-format、set-field-filter、sort-field、group-by-date、group-by-numeric） `--位置` |行区域中的可选位置（从 1 开始） `--聚合函数` |聚合函数（适用于常规和 OLAP 自动创建模式）（需要：set-field-function） `--自定义名称` |字段/度量的可选自定义名称（需要：set-field-name） `--数字格式` |数字格式字符串（需要：set-field-format） `--选定值` |要显示的值（其他值将被隐藏）（需要：set-field-filter） `--方向` |排序方向 `--间隔` |分组间隔（月、季度、年）（必需：按日期分组） `--开始` |起始值（null = 使用字段最小值） `--最终值` |结束值（null = 使用字段最大值） `--间隔大小` |每个组的大小（例如，100 表示 100 组）（必需：按数字分组） ### 电源查询 Power Query M 代码和数据加载。测试优先的开发工作流程（最佳实践）： 1. 评估 - 测试 M 代码而不保留（捕获语法错误、验证源、显示数据预览） 2. 创建/更新 - 将 VALIDATED 查询存储在工作簿中 3. 刷新/加载到 - 将数据加载到目标仅对简单的文字表跳过评估。如果创建/更新失败：使用评估来获取实际的 M 引擎错误消息，修复代码，重试。 DATETIME COLUMNS：始终在 M 代码中包含 Table.TransformColumnTypes() 以显式设置列类型。如果没有显式类型，日期可能会存储为数字，并且数据模型关系可能会失败。目标：“工作表”（默认）、“数据模型”（对于 DAX）、“两者”、“仅连接”。使用“数据模型”加载到 Power Pivot，然后使用数据模型创建 DAX 度量。 TARGET CELL：targetCellAddress 放置表格而不清除工作表。超时：刷新和加载自动超时 30 分钟。对于快速查询，请使用 timeout=60 或类似值。 timeout=0 或省略使用 30 分钟默认值。 **操作：** `list`、`view`、`refresh`、`get-load-config`、`delete`、`create`、`update`、`load-to`、`refresh-all`、`rename`、`unload`、`evaluate` 参数|描述 ---|--- `--查询名称` |要查看的查询的名称（需要：view、refresh、get-load-config、delete、create、update、load-to、unload） `--超时` |等待刷新的最长时间（需要：刷新） `--m-code` |原始 M 代码（内联字符串）（需要：创建、更新、评估） `--加载目的地` |加载目标模式 `--目标表` |目标工作表名称（LoadToTable 和 LoadToBoth 必需；省略时默认为查询名称） `--目标单元格地址` |用于工作表加载的可选目标单元格地址（例如“B5”）。加载到包含其他数据的现有工作表时需要。 `--刷新` |更新后是否刷新数据（默认：true） `--旧名称` |查询的当前名称（需要：重命名） `--新名称` |查询的新名称（需要：重命名） ###范围核心范围操作：获取/设置值和公式、复制范围、清除内容以及发现数据区域。使用 rangeedit 进行插入/删除/查找/排序。使用 rangeformat 进行样式/验证。使用 rangelink 进行超链接和单元格保护。计算模式和显式重新计算由计算模式处理。最佳实践：在覆盖之前使用“get-values”检查现有数据。使用“清除内容”（而不是“清除全部”）在清除数据时保留单元格格式。设置值保留现有格式；如果需要更改格式，请在之后使用 set-number-format。数据格式：值和公式是表示行和列的 2D JSON 数组。示例：[[row1col1, row1col2], [row2col1, row2col2]] 单个单元格返回 [[value]]（始终为 2D）。所需参数： - 用于单元格操作的sheetName + rangeAddress（例如，sheetName='Sheet1'、rangeAddress='A1:D10'） - 对于命名范围，使用sheetName=''（空字符串）和rangeAddress='MyNamedRange' 复制操作：指定复制操作的源和目标工作表/范围。数字格式：使用美国区域设置格式代码（例如“#,##0.00”、“mm/dd/yyyy”、“0.00%”）。 **操作：** `获取值`、`设置值`、`获取公式`、`设置公式`、`验证公式`、`全部清除`、`清除内容`、`清除格式`、`复制`、`复制值`、`复制公式`、`获取数字格式`、`设置数字格式`、`设置数字格式`、`获取使用范围`、 `获取当前区域`、`获取信息` 参数|描述 ---|--- `--工作表名称` |包含范围的工作表的名称 - 单元格地址必需，仅对命名范围使用空字符串（以下必需：get-values、set-values、get-formulas、set-formulas、validate-formulas、clear-all、clear-contents、clear-formats、get-number-formats、set-number-format、set-number-formats、get-used-range、get-current-region、get-info） `--范围地址` |单元格范围地址（例如“A1”、“A1:D10”、“B:D”）或命名范围名称（例如“SalesData”）（以下项需要：获取值、设置值、获取公式、设置公式、验证公式、清除所有、清除内容、清除格式、获取数字格式、设置数字格式、设置数字格式、获取信息） `--值` |要设置的值的二维数组 - 行是外部数组，列是内部数组（例如，[[1,2,3],[4,5,6]] 表示 2 行 x 3 列）。如果提供了valuesFile，则可选。 `--值文件` |包含值的 JSON 或 CSV 文件的路径。 JSON：二维数组。 CSV：行/列。内联值参数的替代方案。 `--公式` |要设置的二维公式数组 - 包括“=”前缀（例如，[['=A1+B1'、'=SUM(A:A)']、['=C1*2'、'=AVERAGE(B:B)']]）。如果提供了 FormulasFile，则可选。 `--公式文件` |包含二维数组形式的公式的 JSON 文件的路径。内联公式参数的替代方案。 `--源表` |复制操作的源工作表名称（需要：复制、复制值、复制公式） `--源范围` |复制操作的源范围地址（例如“A1:D10”）（需要：复制、复制值、复制公式） `--目标表` |复制操作的目标工作表名称（需要：复制、复制值、复制公式） `--目标范围` |目标范围地址 - 可以是粘贴目标的单个单元格（例如“A1”）（需要：复制、复制值、复制公式） `--format-code` |美国区域设置中的数字格式代码（例如，数字为“#,##0.00”，日期为“mm/dd/yyyy”，百分比为“0.00%”，默认为“General”，文本为“@”）（set-number-format 必需） `--格式` |格式代码的二维数组 - 与目标范围尺寸相同（例如，[['#,##0.00', '0.00%'], ['mm/dd/yyyy', 'General']]）。如果提供了formatsFile，则可选。 `--formats-file` |包含二维格式代码数组的 JSON 文件的路径。内联格式参数的替代方案。 `--单元格地址` |单个单元格地址（例如“B5”） - 扩展到该单元格周围的连续数据区域（需要：get-current-region） ### 范围编辑范围编辑操作：插入/删除单元格、行、列；查找/替换文本；对数据进行排序。使用值/公式/复制/清除操作的范围。插入/删除单元格：指定移动方向以控制周围单元格的移动方式。 - 插入：“向下”或“向右” - 删除：“向上”或“向左” 插入/删除行：使用“5:10”等行范围插入/删除第 5-10 行。插入/删除列：使用“B:D”等列范围插入/删除 B-D 列。查找/替换：使用可选的大小写/单元格匹配在指定范围内搜索。 - 查找最多返回 10 个匹配的单元格地址及其总数。 - 替换默认修改所有匹配项。 SORT：将 sortColumns 指定为 {columnIndex: 1, ascending: true} 对象的数组。列索引相对于范围从 1 开始。 **操作：** `插入单元格`、`删除单元格`、`插入行`、`删除行`、`插入列`、`删除列`、`查找`、`替换`、`排序` 参数|描述 ---|--- `--工作表名称` |包含范围的工作表的名称（必填） `--范围地址` |将插入单元格的单元格范围地址（例如“A1:D10”）（必需） `--插入移位` |移动现有单元格的方向：“向下”或“向右”（插入单元格所需） `--删除-shift` |移动剩余单元格的方向：“向上”或“向左”（需要：删除单元格） `--搜索值` |要搜索的文本或值（需要：查找） `--find-options` |搜索选项：matchCase（默认值：false）、matchEntireCell（默认值：false）、searchFormulas（默认值：true）（查找所需） `--查找值` |要搜索的文本或值（需要：替换） `--替换值` |用于替换匹配项的文本或值（需要：替换） `--替换选项` |替换选项：matchCase（默认值：false）、matchEntireCell（默认值：false）、replaceAll（默认值：true）（替换所需） `--排序列` |排序规范数组：[{columnIndex: 1, ascending: true}, ...] - columnIndex 相对于范围从 1 开始（排序所需） `--有标题` |范围是否具有要从排序中排除的标题行（默认值：true） ### 范围格式范围格式化操作：应用样式、设置字体/颜色/边框、添加数据验证、合并单元格、自动调整尺寸。使用范围工具进行值/公式/复制/清除操作。 set-style：应用命名的 Excel 样式（标题 1、好、坏、中性、正常）。最适合语义状态标签（好/坏/中性有填充颜色并且主题感知）和文档层次结构（标题 1/2/3）。注意：标题样式不应用填充颜色 - 当您需要彩色标题行时，请使用格式范围。格式范围：应用粗体、填充颜色、字体颜色、对齐方式、边框的任意组合。每当您需要填充颜色或自定义品牌时都需要。在一次调用中传递所有所需的属性 - 不要对同一范围多次调用 format-range 。颜色：十六进制“#RRGGBB”（例如，“#FF0000”表示红色，“#00FF00”表示绿色）字体：以磅为单位的大小（例如，12、14、16），对齐方式：“左”、“中”、“右”/“上”、“中”、“下” 数据验证：使用验证规则限制单元格输入： - 类型：'list'、'whole'、'decimal'、'date'、'time'、'textLength'、'custom' - 对于列表验证，formula1 是列表源（例如，'=$A$1:$A$10' 或 '"Option1,Option2,Option3"'） - 运算符：' Between'、'notBetween'、'equal'、'notEqual'、 'greaterThan'、'lessThan'、'greaterThanOrEqual'、'lessThanOrEqual' 合并：将单元格合并为一个。仅保留左上角的单元格值。 **操作：** `set-style`、`get-style`、`format-range`、`validate-range`、`get-validation`、`remove-validation`、`auto-fit-columns`、`auto-fit-rows`、`merge-cells`、`unmerge-cells`、`get-merge-info`、`set-column-width`、`set-row-height` 参数|描述 ---|--- `--工作表名称` |包含范围的工作表的名称（必填） `--范围地址` |单元格范围地址（例如“A1:D10”）（必需） `--样式名称` |内置或自定义样式名称（例如“标题 1”、“好”、“坏”、“货币”、“百分比”）。使用“正常”进行重置。（需要：设置样式） `--字体名称` |字体系列名称（例如“Arial”、“Calibri”、“Times New Roman”） `--字体大小` |字体大小（以磅为单位）（例如，10、11、12、14、16） `--粗体` |是否应用粗体格式 `--斜体` |是否应用斜体格式 `--下划线` |是否应用下划线格式 `--字体颜色` |字体（前景）颜色为十六进制“#RRGGBB”（例如，“#FF0000”表示红色） `--填充颜色` |单元格填充（背景）颜色为十六进制“#RRGGBB”（例如，“#FFFF00”表示黄色） `--边框样式` |边框线样式：'连续'、'破折号'、'点'、'dashdot'、'dashdotdot'、'双'、'slantdashdot'、'无' `--边框颜色` |边框颜色为十六进制“#RRGGBB” `--边框权重` |边框粗细：“发际线”、“细”、“中”、“粗” `--水平对齐` |水平文本对齐方式：“左”、“居中”、“右”、“对齐”、“填充” `--垂直对齐` |垂直文本对齐方式：“顶部”、“中心”（或“中间”）、“底部”、“对齐” `--wrap-text` |是否在单元格内换行文本 `--方向` |文本旋转角度（-90 到 90，垂直方向为 255） `--验证类型` |数据验证类型：'list'、'whole'、'decimal'、'date'、'time'、'textLength'、'custom'（必需：validate-range） `--验证运算符` |验证比较运算符：'Between'、'notBetween'、'equal'、'notEqual'、'greaterThan'、'lessThan'、'greaterThanOrEqual'、'lessThanOrEqual' `--公式1` |第一个验证公式/值 - 对于列表验证，使用范围 '=$A$1:$A$10' 或内联 '"A,B,C"' `--公式2` |第二个验证公式/值 - 仅需要“Between”和“notBetween”运算符 `--显示输入消息` |选择单元格时是否显示输入消息（默认：false） `--输入标题` |输入消息弹出窗口的标题 `--输入消息` |输入消息弹出窗口的文本 `--显示错误警报` |是否对无效输入显示错误警报（默认值：true） `--错误风格` |错误警报样式：“停止”（阻止进入）、“警告”（允许覆盖）、“信息”（允许进入） `--错误标题` |错误警报弹出窗口的标题 `--错误消息` |错误警报弹出窗口的文本 `--忽略空白` |验证中是否允许空白单元格（默认值：true） `--show-dropdown` |是否显示列表验证的下拉箭头（默认值：true） `--列宽` |宽度以磅为单位（1 磅 = 1/72 英寸，约 0.35 毫米）。标准宽度~8.43 点。范围：0.25-409点。（必需：设置列宽） `--行高` |高度以磅为单位（1 点 = 1/72 英寸，约 0.35 毫米）。默认行高 ~15 点。范围：0-409 点。（必需：设置行高） ### 范围链接 Excel 区域的超链接和单元格保护操作。使用范围作为值/公式，使用范围格式作为样式。超链接： - 'add-hyperlink'：向单元格添加可点击的超链接（URL 可以是 web、file 或 mailto） - 'remove-hyperlink'：从单元格中删除超链接，同时保留单元格内容 - 'list-hyperlinks'：获取工作表上的所有超链接 - 'get-hyperlink'：获取特定单元格的超链接详细信息单元格保护： - 'set-cell-lock'：锁定或解锁单元格（仅在启用工作表保护时有效） - 'get-cell-lock'：检查单元格是否被锁定注意：单元格锁定仅在工作表受到保护时才生效。 **操作：** `添加超链接`、`删除超链接`、`列出超链接`、`获取超链接`、`设置单元格锁定`、`获取单元格锁定` 参数|描述 ---|--- `--工作表名称` |工作表名称（必填） `--单元格地址` |单个单元格地址（例如“A1”）（需要：add-hyperlink、get-hyperlink） `--url` |超链接 URL（网页：'https://...'、文件：'file:///...'、电子邮件：'mailto:...'）（需要：add-hyperlink） `--显示文本` |要在单元格中显示的文本（可选，默认为 URL） `--工具提示` |悬停时显示的工具提示文本（可选） `--范围地址` |要从中删除超链接的单元格范围地址（例如“A1:D10”）（需要：删除超链接、设置单元格锁定、获取单元格锁定） `--锁定` |锁定状态： true = 锁定（启用工作表保护时受保护）， false = 解锁（可编辑）（需要：set-cell-lock） ### 截图将 Excel 工作表内容捕获为图像以进行视觉验证。使用 Excel 的内置渲染 (CopyPicture) 将范围捕获为 PNG 图像。捕获格式、条件格式、图表和所有视觉元素。操作： - capture：捕获特定范围作为图像 - capture-sheet：捕获工作表的整个使用区域返回：带有尺寸元数据的 Base64 编码图像数据。对于 MCP：作为本机 ImageContent 返回（无需文件处理）。对于 CLI：使用 --output 将图像直接保存到 PNG/JPEG 文件，而不是返回内联的 base64。质量默认为“中”（JPEG 75% 比例），比“高”(PNG) 小 4-8 倍。仅当需要进行精细细节检查时才使用“高”。 **操作：** `捕获`、`捕获表` 参数|描述 ---|--- `--工作表名称` |工作表名称（活动工作表为空） `--范围地址` |捕获范围（例如“A1:F20”） `--质量` |图像质量：中（默认，JPEG 75% 比例）、高（PNG 全比例）、低（JPEG 50% 比例） ###表工作表生命周期管理：创建、重命名、复制、删除、移动、列出工作表。使用范围进行数据操作。使用工作表样式来设置选项卡颜色和可见性。原子操作：“复制到文件”和“移动到文件”不需要会话 - 它们会自动打开/关闭文件。定位：对于“移动”、“复制到文件”、“移动到文件” - 使用“之前”或“之后”（不能同时使用两者）来相对于另一个工作表定位工作表。如果两者均未指定，则移至末尾。注意：MCP 工具是在 ExcelWorksheetTool.cs 中手动实现的，以正确处理混合会话要求（复制到文件和移动到文件是原子的，不需要会话）。 **操作：** `列表`、`创建`、`重命名`、`复制`、`删除`、`移动`、`复制到文件`、`移动到文件` 参数|描述 ---|--- `--文件路径` |批处理包含多个工作簿时的可选文件路径。如果省略，则使用主工作簿。 `--工作表名称` |新工作表的名称（需要：创建、删除、移动） `--旧名称` |工作表的当前名称（需要：重命名） `--新名称` |工作表的新名称（需要：重命名） `--源名称` |源工作表的名称（需要：副本） `--目标名称` |复制的工作表的名称（需要：复制） `--在工作表之前` |可选：之前放置的工作表的名称 `--after-sheet` |可选：要放置在其后的工作表的名称 `--源文件` |源工作簿的完整路径（需要：复制到文件、移动到文件） `--源表` |要复制的工作表的名称（需要：复制到文件、移动到文件） `--目标文件` |目标工作簿的完整路径（需要：复制到文件、移动到文件） `--目标表名称` |可选：复制工作表的新名称（默认：保留原始名称） ### 工作表样式选项卡颜色和可见性的工作表样式操作。使用工作表进行生命周期操作（创建、重命名、复制、删除、移动）。选项卡颜色：使用 RGB 值（每个 0-255）设置自定义选项卡颜色以进行视觉组织。可见性级别： - 'visible'：正常可见工作表 - 'hidden'：隐藏，但可通过“格式”>“工作表”>“取消隐藏”访问 -“veryhidden”：只能通过 VBA 访问（防止随意取消隐藏） **操作：** `set-tab-color`、`get-tab-color`、`clear-tab-color`、`set-visibility`、`get-visibility`、`show`、`hide`、`very-hide` 参数|描述 ---|--- `--工作表名称` |要着色的工作表名称（必填） `--红色` |红色分量 (0-255)（需要：set-tab-color） `--绿色` |绿色分量 (0-255)（需要：set-tab-color） `--蓝色` |蓝色分量 (0-255)（需要：set-tab-color） `--可见性` |可见性级别：“visible”、“hidden”或“veryhidden”（需要：set-visibility） ### 切片机适用于数据透视表和 Excel 表的切片器视觉过滤器。可透视切片器：创建切片器、列表切片器、设置切片器选择、删除切片器。表切片器：创建表切片器、列表表切片器、设置表切片器选择、删除表切片器。命名：自动生成描述性名称，例如 {FieldName}Slicer（例如 RegionSlicer）。 SELECTION：selectedItems 作为字符串列表。空列表清除过滤器（显示所有项目）。设置clearFirst = false以添加到现有选择。 **操作：** `创建切片器`、`列表切片器`、`设置切片器选择`、`删除切片器`、`创建表切片器`、`列表表切片器`、`设置表切片器选择`、`删除表切片器` 参数|描述 ---|--- `--数据透视表名称` |要为其创建切片器的数据透视表的名称（需要：create-slicer） `--字段名称` |用于切片器的字段名称（需要：create-slicer） `--切片器名称` |新切片器的名称（以下必需：create-slicer、set-slicer-selection、delete-slicer、create-table-slicer、set-table-slicer-selection、delete-table-slicer） `--目标表` |将放置切片器的工作表（需要：create-slicer、create-table-slicer） `--位置` |切片器的左上角单元格位置（例如“H2”）（需要：create-slicer、create-table-slicer） `--所选项目` |要选择的项目（在数据透视表中显示）（需要：set-slicer-selection、set-table-slicer-selection） `--清除优先` |如果为 true，则在设置新项目之前清除现有选择（默认值：true） `--表名` | Excel 表的名称（需要：create-table-slicer） `--列名称` |用于切片器的列的名称（需要：create-table-slicer） ### 表 Excel 表 (ListObjects) - 生命周期和数据操作。表格提供结构化参考、自动格式化和数据模型集成。最佳实践：在创建之前使用“列表”检查现有表。优先使用“追加”/“调整大小”/“重命名”而不是删除+重新创建来保留引用。警告：删除用作数据透视表源或数据模型关系中的表将破坏这些对象。数据模型工作流程：要使用 DAX/Power Pivot 分析工作表数据： 1. 在工作表上创建或识别 Excel 表 2. 使用“add-to-datamodel”将表添加到 Power Pivot 3. 然后使用 datamodel 在其上创建 DAX 度量 DAX 支持的表：创建由 DAX EVALUATE 查询填充的表： -“create-from-dax”：创建由 DAX 支持的新表查询（例如 SUMMARIZE、FILTER） - 'update-dax'：更新现有 DAX 支持的表的 DAX 查询 - 'get-dax'：获取表的 DAX 查询信息（检查它是否支持 DAX）相关：tablecolumn（过滤器/排序/列）、数据模型（DAX 度量、评估查询） **操作：** `list`、`create`、`rename`、`delete`、`read`、`resize`、`toggle-totals`、`set-column-total`、`append`、`get-data`、`set-style`、`add-to-data-model`、`create-from-dax`、`update-dax`、`get-dax` 参数|描述 ---|--- `--工作表名称` |要在其上创建表的工作表的名称（需要：create、create-from-dax） `--表名` |新表的名称（在工作簿中必须是唯一的）（以下功能必需：创建、重命名、删除、读取、调整大小、切换总计、设置列总计、追加、获取数据、设置样式、添加到数据模型、从 dax 创建、更新 dax、获取 dax） `--范围地址` |表的单元格范围地址（例如“A1:D10”）（创建时需要） `--有标题` |如果第一行包含列标题，则为 true（默认值：true） `--表格样式` |表格样式名称（例如“TableStyleMedium2”、“TableStyleLight1”）。选修的。（需要：设置样式） `--新名称` |表的新名称（在工作簿中必须是唯一的）（需要：重命名） `--新范围` |新范围地址（例如“A1:F20”）（需要：调整大小） `--显示总计` | true 表示显示总计行， false 表示隐藏（需要：切换总计） `--列名称` |要设置总计功能的列的名称（需要：set-column-total） `--总功能` |总计函数名称：Sum、Count、Average、Min、Max、CountNums、StdDev、Var、None（需要：set-column-total） `--行` |要附加的行数据的二维数组 - 列顺序必须与表列匹配。如果提供了 rowsFile，则可选。 `--行文件` |包含要附加的行的 JSON 或 CSV 文件的路径。 JSON：二维数组。 CSV：行/列。内联行参数的替代方案。 `--仅可见` | True 则仅返回可见（未过滤）行；所有行均为 false（默认值：false） `--strip-bracket-column-names` |如果为 true，则在添加到数据模型之前重命名包含文字括号字符的源表列（删除括号）。这会修改工作表中的 Excel 表格列标题。 `--dax-query` | DAX EVALUATE 查询（例如“EVALUATE Sales”或“EVALUATE SUMMARIZE(...)”）（需要：create-from-dax、update-dax） `--目标细胞` |表放置的目标单元格地址（默认值：“A1”） ### 表格列 Excel 表 (ListObjects) 的表列、筛选和排序操作。使用table进行表级生命周期和数据操作。过滤： - 'apply-filter'：简单条件过滤器（例如，“>100”、“=Active”、“<>Closed”） - 'apply-filter-values'：按精确值过滤（提供要包含的值列表） - 'clear-filters'：删除所有活动过滤器 - 'get-filters'：查看当前过滤器状态排序： - 'sort'：单列排序（升序/降序） - 'sort-multi'：多列排序（提供 {columnName, ascending} 对象的列表）列管理： - 'add-column'/'remove-column'/'rename-column'：修改表结构数字格式：使用美国区域设置格式代码（例如，'#,##0.00'、'0%'、'yyyy-mm-dd'） **操作：** `apply-filter`、`apply-filter-values`、`clear-filters`、`get-filters`、`add-column`、`remove-column`、`rename-column`、`get-structed-reference`、`sort`、`sort-multi`、`get-column-number-format`、`set-column-number-format` 参数|描述 ---|--- `--表名` | Excel 表格的名称（必填） `--列名称` |要过滤的列的名称（必需：apply-filter、apply-filter-values、add-column、remove-column、sort、get-column-number-format、set-column-number-format） `--标准` |过滤条件字符串（例如，'>100'、'=Active'、'<>Closed'）（需要：apply-filter） `--值` |要包含在过滤器中的精确值列表（需要：apply-filter-values） `--位置` |从 1 开始的列位置（可选，默认为表末尾） `--旧名称` |当前列名称（需要：重命名列） `--新名称` |新列名称（需要：重命名列） `--区域` |表区域：“数据”、“标题”、“总计”或“全部”（需要：获取结构化引用） `--升序` |排序顺序：true = 升序（A-Z、0-9），false = 降序（默认值：true） `--排序列` |排序规范列表： [{columnName: 'Col1', ascending: true}, ...] - 按顺序应用（需要：sort-multi） `--format-code` |美国区域设置中的数字格式代码（例如“#,##0.00”、“0%”、“yyyy-mm-dd”）（需要：set-column-number-format） ### vba VBA 脚本（需要 .xlsm 并启用 VBA 信任）。先决条件： - 工作簿必须启用宏 (.xlsm) - 必须为自动化 RUN 启用 VBA 信任： procedureName 格式为“Module.Procedure”（例如“Module1.MySub”）。 **操作：** `列表`、`查看`、`导入`、`更新`、`运行`、`删除` 参数|描述 ---|--- `--模块名称` | VBA 模块的名称（需要：查看、导入、更新、删除） `--vba 代码` |要导入的 VBA 代码（需要：导入、更新） `--过程名称` |要运行的过程的名称（例如“Module1.MySub”）（需要：运行） `--超时` |可选的执行超时 `--参数` |传递给过程的可选参数（需要：运行） ### 窗口控制 Excel 窗口的可见性、位置、状态和状态栏。用于显示/隐藏 Excel、将其置于前面、重新定位或最大化/最小化。设置状态栏文字，为用户在操作过程中提供实时反馈。可见性：“显示”使 Excel 可见并置于前面。 “隐藏”隐藏 Excel。可见性更改反映在会话元数据中（会话列表显示更新状态）。窗口状态值：“正常”、“最小化”、“最大化”。排列预设：“左半部”、“右半部”、“上半部”、“下半部”、“中心”、“全屏”。状态栏：“set-status-bar”在 Excel 状态栏中显示文本。 “clear-status-bar”恢复默认值。 **操作：** `显示`、`隐藏`、`置于前面`、`获取信息`、`设置状态`、`设置位置`、`排列`、`设置状态栏`、`清除状态栏` 参数|描述 ---|--- `--窗口状态` |窗口状态：“正常”、“最小化”或“最大化”（需要：设置状态） `--左` |窗口左侧位置（以磅为单位） `--顶部` |窗口顶部位置（以点为单位） `--宽度` |窗口宽度（以磅为单位） `--高度` |窗口高度（以磅为单位） `--预设` |预设名称：'左半'，'右半'，'上半'，'下半'，'中心'，'全屏'（需要：排列） `--文本` |要显示的状态栏文本（例如“从销售数据构建数据透视表...”）（需要：set-status-bar） ## 常见陷阱 ### \--values-file 必须是现有文件 `--values-file` 需要磁盘上**现有** JSON 或 CSV 文件的路径。不要将内联 JSON 作为值传递 — CLI 将在该路径中查找文件并失败并显示“找不到文件”。如果您没有文件，请使用带有内联 JSON 的“--values”。 ### \--超时必须大于零使用“--timeout”时，该值必须是正整数（秒）。 `--timeout 0` 无效并且会出错。完全省略 `--timeout` 以使用默认值（大多数操作为 300 秒）。 ### 电源查询操作很慢 `powerquery create`、`powerqueryfresh` 和 `powerqueryevaluate` 可能需要 30 秒以上，具体取决于数据量。要么省略“--timeout”（默认使用 5 分钟），要么设置一个慷慨的值，例如“--timeout 120”。 ### JSON 值格式 `--values` 接受一个用单引号括起来的 2D JSON 数组： # 正确：带有单引号包装器的二维数组 --values '[["姓名","年龄"],["爱丽丝",30],["鲍勃",25]]' # 错误：不是二维数组 --值'[“爱丽丝”，30]' # 错误：对象而不是数组 --values '{"姓名":"爱丽丝","年龄":30}' ### 列表参数使用 JSON 数组接受列表的参数（例如切片器的“--selected-items”）需要 JSON 数组格式： # 正确：带有单引号包装器的 JSON 数组 --selected-items '["西","东"]' # 正确：转义内引号 --selected-items "[\"西\",\"东\"]" # 正确：清除选择 --所选项目'[]' # 错误：逗号分隔的字符串（无效） --selected-item“西，东” ## 参考文档 * [核心执行规则和LLM指南]() * [要避免的常见错误]() * [数据模型约束和模式]() * [图表、定位和格式]() * [条件格式化操作]() * [仪表板和报告最佳实践]() * [数据模型/DAX 详细信息]() * [数据模型分析的DMV查询参考]() * [Power Query M 代码语法参考]() * [数据透视表操作]() * [Power Query 详细信息]() * [范围运算和数字格式]() * [屏幕截图和视觉验证]() * [切片器操作]() * [表操作]() * [工作表操作]()

Excel 命令行界面

包含技能