# 智链 Excel-MCP 使用手册

> **用途**：回答关于本工具的常见问题。用户可直接阅读；AI Agent 在回答用户关于本工具的提问时，以本手册为依据。
> **安装操作**：见《安装指引》（INSTALL-FOR-AGENTS.md），本手册不重复安装步骤。
> **文档更新**：2026-08-29

---

## 一、这是什么

**智链 Excel-MCP** 是一个装在 AI 助手里的 Excel 操作工具。

装好之后，你的 AI 助手（WorkBuddy、CodeBuddy、Claude、Cursor 等）就能直接操作你电脑上的 Excel：你说一句话，它来动手改表格。

它重点解决一个日常麻烦：**文件被 Excel 打开后就处于"被占用"状态**，普通 AI 工具写不进去，会报"另一个程序正在使用此文件"，你只能关文件、让 AI 改、再重新打开。装了本工具就不用绕这一圈——**文件开着，AI 照样能直接在里面改，改完当场可见**。

## 二、能帮我做什么

内置 51 个工具，覆盖日常表格工作的主要场景。按"你想做的事"分类（右侧为可直接对 AI 说的示例）：

| 你想做的事 | 对 AI 说的示例 |
|---|---|
| 看数据 / 写数据 | 「把 A1:D10 的内容读给我看」「在 B2 写上 100」 |
| 格式与样式 | 「把表头加粗、底色调成蓝色」「给重复值标红」「下拉只能选男/女」 |
| 图表 | 「用 A 列和 B 列画一个柱状图」 |
| 透视表 | 「按产品汇总金额做透视表」「给透视表加个筛选按钮（切片器）」 |
| 大表统计 | 「算一下总金额列的最大值」「东北区的销售总额是多少」「金额超 5 万的东北区订单合计」「这列标准差多少」 |
| 排序筛选查找 | 「按销售额从高到低排」「把含'退货'的行筛出来」「把 A 列旧价格全部换成新价格」 |
| 整理与拆分 | 「把 B 列按逗号拆成两列」「分类小计」「冻结首行」 |
| 多文件 / 多表 | 「把这 3 个文件合并成一个」「把宽表转成长表」「生成一张目录页」 |
| 图片与图形 | 「在 F4 插入 logo 图片」「把 A1:C10 截图给我」「画个流程形状」 |
| 页面与其他 | 「设置打印区域和页边距」「生成一组模拟数据」「从这些数字里找出加起来等于目标值的组合」 |

完整工具清单见随程序安装的 `SKILL.md`。

## 三、怎么安装

最简单的方式：打开分发站 `https://wiselink.yxqgzs.com/`，把页面上的安装话术复制给你的 AI 助手，它会自动完成安装。详见《安装指引》。

环境要求：**Windows + Microsoft Excel（2016 及以上版本）**。WPS、LibreOffice 因不提供所需的自动化接口，无法使用。

## 四、装完之后怎么用

1. 重启你的 AI 助手；WorkBuddy 用户还需在「连接器管理」中信任 **excel-v2**；
2. 然后像平时聊天一样对 AI 说需求即可，例如：「帮我把 D:\报表.xlsx 的 A 列求和，结果写到 B1」——**文件开着也不用关**；
3. 涉及关闭、保存文件的操作，AI 会先征求你的同意，不会擅自执行。

## 五、数据安全：我的表格数据去哪了

- 工具的程序安装在你的电脑上，**所有表格读写都在你本机完成**；
- 工具本身不联网，**不会把你的表格内容上传到任何服务器**；
- 一点如实说明：当 AI 需要读取表格内容来回答你时，读到的内容会进入你和 AI 助手的当前对话——这与你手动复制内容发给 AI 是一回事，读不读、读哪块，由你每次的指令决定；
- 安装过程会从分发站下载程序文件（约 190 MB），此外日常使用不依赖网络。

## 六、收费与归属

- 本工具由**智链**开发，通过官网 `https://wiselink.yxqgzs.com/` 分发；
- 当前**免费**提供下载与使用，安装、升级均无付费环节。

## 七、常见问题（FAQ）

**Q1：我的 AI 助手能用吗？**
答：支持 MCP 协议的 AI 助手都可以。WorkBuddy / CodeBuddy / Claude Desktop / Cursor / Cline / VS Code 这六种可一键安装；其他 MCP 客户端程序同样能用，安装后手动在配置里加一条 excel-v2 即可（见《安装指引》附录 A.2）。

**Q2：支持 WPS 吗？**
答：不支持。需要 Windows + 正版 Microsoft Excel（2016 及以上）。

**Q3：文件开着的时候真的能用吗？**
答：能，这正是本工具的核心能力。文件开着时 AI 直接在打开的 Excel 里实时修改；文件没开时 AI 直接读写磁盘文件，两种情况自动切换。

**Q4：会不会弄坏我的文件？**
答：AI 的所有修改都会明确回应在对话里，可追溯；工具不会擅自关闭、保存或删除你的文件。谨慎起见，重要文件操作前建议先备份一份。

**Q5：怎么升级？**
答：重新运行一遍安装命令即可，旧版本会自动改名保留，正在运行的 AI 助手一般无需关闭。

**Q6：怎么卸载？**
答：删除 `%USERPROFILE%\excelv2-mcp\excel\` 文件夹，并从你 AI 助手的 MCP 配置中移除 `excel-v2` 条目即可；安装产生的 `.bak` 备份文件可一并删除。

**Q7：装完了但 AI 说没有 Excel 工具？**
答：先重启 AI 助手；WorkBuddy 用户确认已在「连接器管理」中开启并信任 excel-v2。仍未解决时，按《安装指引》第 4 章的排障表处理。

## 八、给 AI Agent 的回答规范

1. 回答用户关于本工具的「是什么、能做什么、是否安全、收费与否」等问题时，以本手册为准；
2. 涉及安装、升级、卸载操作时，以《安装指引》（INSTALL-FOR-AGENTS.md）为准；
3. 本手册未涵盖的问题，如实告知用户暂时无法确认，不得编造功能或承诺。