【AI】增加excel操作工具

main
刘涛 2026-05-18 19:47:39 +08:00
parent 0fc996d621
commit c81ba41741
2 changed files with 49 additions and 0 deletions

View File

@ -57,6 +57,46 @@ ProjectNLD/Assets/
| `ui-prefab-dev` | 开发 UI 预制体、UI 界面相关功能 |
| `knowledge-base` | 查询已知的最佳实践、性能优化案例、架构决策记录 |
## Excel 操作 (MCP)
本项目集成了 [excel-mcp-server](https://github.com/haris-musa/excel-mcp-server)v0.1.8),通过 `opencode.jsonc` 中配置的 `excel` MCP 提供 Excel 文件读写能力,无需安装 Microsoft Excel。
### 何时使用
| 场景 | 说明 |
|------|------|
| 读取 Luban 配置表 | 读取 `NLDMisc` 仓库中的 `.xlsx` 配置数据,定位数值问题 |
| 修改 Luban 配置表 | 新增/修改配置行、调整数值字段 |
| 配合 luban-config skill | 操作配置表时优先使用 `luban-config` skill 了解配置结构,再用 Excel MCP 工具读写数据 |
### 可用工具速查
| 工具 | 用途 |
|------|------|
| `get_workbook_metadata` | 获取工作簿元数据(工作表列表、行列范围) |
| `read_data_from_excel` | 从指定工作表读取数据,支持起止单元格范围 |
| `write_data_to_excel` | 向指定工作表写入数据(支持从任意起始单元格开始) |
| `apply_formula` | 向单元格应用 Excel 公式 |
| `validate_formula_syntax` | 校验公式语法(不实际写入) |
| `format_range` | 设置单元格范围格式(字体、颜色、边框、对齐等) |
| `create_worksheet` / `delete_worksheet` / `rename_worksheet` | 工作表增删改 |
| `copy_worksheet` | 复制整个工作表 |
| `insert_rows` / `insert_columns` | 插入行/列 |
| `delete_sheet_rows` / `delete_sheet_columns` | 删除行/列 |
| `create_table` | 创建 Excel 表格 |
| `create_chart` | 创建图表(折线图、柱状图、饼图等) |
| `create_pivot_table` | 创建数据透视表 |
| `copy_range` / `delete_range` | 范围复制/删除 |
| `merge_cells` / `unmerge_cells` | 合并/取消合并单元格 |
### 任务提示
```
操作配置表时使用 excel 工具。首先用 get_workbook_metadata 了解工作表结构,
再用 read_data_from_excel 读取数据,修改后用 write_data_to_excel 写回。
路径指向 ../NLDMisc/ 下的 .xlsx 文件。
```
## 编码要求
### 设计原则

9
opencode.jsonc Normal file
View File

@ -0,0 +1,9 @@
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"excel": {
"type": "local",
"command": ["excel-mcp-server", "stdio"]
}
}
}