跳转至

安装教程

本文详细介绍如何安装杰瑞WORD直连助手插件，目前仅支持Windows系统，安装后可在WPS和WORD中使用，需要注意的是，直连助手相当于是给AI装上了眼睛和手，让它可以看见我们的文档，可以操作我们的窗体，因此本助手不限于任何一款IDE，基本目前所有IDE都支持，例如Trae，Qoder等，下面我们以Trae为例，介绍一下如何安装。

关注公众号 【杰瑞学长的小屋】，回复 WORD直连助手 获取最新版，或 点击此处下载

一、安装Trae（相当于问题思考的大脑）

进入官网，点击下载，选择对应的Windows版本，安装很简单，我这里不详细展开介绍，如果实在有问题，可以看下这个官方演示视频对照下载，注意Trae更新后，有一个SOLO MTC的模式，那个不是我们要用的编程IDE，我们一定指定用IDE模式，如下：

下载安装完成后，打开Trae，大概就是这么一个界面，非常简洁：

二、安装杰瑞WORD直连助手插件

在这个界面的左上角，我们可以打开一个文件夹（文件夹我们可以提前准备好一个空的，比如我的是 D:\pythonProject\WORDProject ），这样我们后面就可以在这个文件夹中同步我们的VBA项目

在整个页面的左侧，有一个拓展，我们只需要把安装包拖入进去，就安装成功了(这里和VBE直连助手安装类似，所以我这里就直接用VBE安装包的截图了)

安装成功之后的界面如下图，左侧区域多了一个按钮，点击之后可以打开我们的面板，同时拓展区也多了一个选项

这个时候，我们在面板中配置好文件配置这部分：

  • word文件：就是你需要操作的那个文件，格式目前兼容 docx，doc，docm （如果你要写宏就用docm）
  • 本地同步目录：就是将你word文件中的具体模块，窗体等都会同步存放的一个目录，这样Ai能更方便了解你的项目结构，建议本地同步目录就选择当前文件夹（建议用一个空文件夹）

目前是可以同时设置多个文件的，当然你刚上手的话，建议开始用一个文件即可，中间的MCP模式在后面会讲到，简单来说就是VBE模式下主要帮你写VBA代码，画窗体，在WORD模式下主要是一些高频的WORD能力，配置好之后，本地你同步的文件夹中就会出现一个.trae文件夹，其中有mcp.json配置文件

接下来，右上角点击设置，MCP，将两个开关都打开，同时启用MCP，如下图，点击启用

启动之后，状态变成 绿色的"√"，说明启动成功

三、同步文件，开始编程

先打开你的word文件，注意启用 对VBA工程对象模型的访问，这一步非常重要，否则Ai无法访问你的VBA工程，无法帮你直接操作窗体，具体步骤如下：

在WPS中，按下图所示步骤操作，即可开启授权：

在微软EXCEL版本中，在 文件 → 选项 → 信任中心 → 信任中心设置 中，按下图操作：

然后我们回到助手面板，点击 WORD→本地按钮，将word中的文件同步到本地来，同步完成之后，会生成如图所示的一些文件和文件夹，如果没有同步成功，检查word文件是否打开以及对象模型是否开启。

  • 自动执行 勾选之后，Ai写完程序会帮你执行代码
  • 自动同步 开启之后，本地文件夹的变动会实时同步到你的VBE端

到这里，我们基本完成了配置，最后按下 Ctrl+U 打开Ai对话面板，注意把模式切换成 Build with MCP，如下图：

注意：Trae的新版本里可能没有单独这样一个称呼，所以我们用Agent或者solo都是可以的

如果绿灯亮起，说明Ai已经准备好了，可以开始编程了，如果为红灯，则检查第二步的MCP配置是否打开，成功之后，我们可以简单测试一下

如果像上面这样，那就安装并使用成功了，祝你使用愉快，从此你打开了一扇新大门!

常见问题

一、为什么同步失败？

同步失败的时候，你可以将光标移动到左下角同步失败按钮上方，会显示提示信息，一般来说都是 未打开word文件，此时请确认如下几点：

  • 是否通过WORD或者WPS打开了word文件？→ 需要打开word文件
  • 是否启用了对VBA工程对象模型的访问？→ 需要启用
  • WORD和WPS是否同时打开，但是是用的WPS打开的word文件？→ 优先检测的是WORD打开，要在WPS里做，则关闭WORD

如果你习惯在WPS中进行设计，排除以上问题还是同步失败，则看看设置中的 沙箱保护 是否关闭

另外检查一下设置里面的 窗口管理模式 是不是选择的整合模式，不是的话，需要选择整合模式，如下图：

如果WPS还是不能同步，确认WPS是否更新到最新版本了，如果没有，可以在 【WPS官网】 下载最新版本，最后的最后，如果还是不能同步，请关闭或者卸载所有杀毒软件，本插件绝对安全！

二、为什么同步后文件是乱码？

看看你的IDE是否encoding和decoding用的都是标准的UTF-8编码，在软件右下角可以看到当前文件的编码格式

三、如何选用更合适的模式？

WORD直连助手支持VBE模式，WORD模式和双开模式三种情况，具体区别如下：

  • VBE模式：主要为你写代码，画窗体，能实现代码的同步，也就是写VBA的时候我们用这个模式
  • WORD模式：可以帮你写word公式，做修订，绘制表格等，主要是常规任务的执行模式
  • 框图模式：可以帮你画框图，画流程图等，主要是画图相关的任务
  • 双开模式：同时开启VBE模式和WORD模式，但有些IDE（如trae）对MCP上下文长度有限制，所以有的时候如果你看到MCP列表里明明有这个工具，但是Ai看不到，大概率就是触发了上限

因此建议针对具体任务，一般开一个模式就行

四、如何在其他IDE端配置MCP

除了Trae，其他IDE都能实现配置，目前支持的IDE有：trae，cursor，codex，opencode，claude code，Qoder，可以点击面板文件配置右边的MCP按钮打开配置目录，勾选你选用的IDE平台，勾选后即在工作区目录生成对应的配置文件，如下图：

如果需要写入到该IDE系统的MCP配置文件中，则可以点击右侧的 填系统MCP 按钮实现。

五、窗口置顶功能的作用是什么？

开启后，可以置顶当前已打开的WORD/WPS窗口，这样当你回到IDE端进行操作的时候，WORD/WPS窗口会持续置顶，不会自动最小化，方便对照查看

但是注意，当你新开了其他窗口，需要重开一下窗口置顶以记录窗口状态

另外其他类似的操作都和VBE直连助手差不多，只不过核心能力都改成和WORD相关的，所以两个工具可以对照着来看，分工合作，实现更如意的效果