From c81ba41741f8efc3513deac3a6adf648e5432307 Mon Sep 17 00:00:00 2001
From: liutao <821580467@qq.com>
Date: Mon, 18 May 2026 19:47:39 +0800
Subject: [PATCH] =?UTF-8?q?=E3=80=90AI=E3=80=91=E5=A2=9E=E5=8A=A0excel?=
 =?UTF-8?q?=E6=93=8D=E4=BD=9C=E5=B7=A5=E5=85=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md      | 40 ++++++++++++++++++++++++++++++++++++++++
 opencode.jsonc |  9 +++++++++
 2 files changed, 49 insertions(+)
 create mode 100644 opencode.jsonc

diff --git a/AGENTS.md b/AGENTS.md
index 09e28e00371..3b0991bff0c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -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 文件。
+```
+
 ## 编码要求
 
 ### 设计原则
diff --git a/opencode.jsonc b/opencode.jsonc
new file mode 100644
index 00000000000..2223e3dbf36
--- /dev/null
+++ b/opencode.jsonc
@@ -0,0 +1,9 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "excel": {
+      "type": "local",
+      "command": ["excel-mcp-server", "stdio"]
+    }
+  }
+}