AI 助手¶
IPRO Workbench 内置 IPRO AI 助手。它不只是回答问题,还能自行使用 IDE 的工具来构建、读取构建输出、烧录、读取串口、修改配置、引脚和 GATT 服务、查阅内存映射和寄存器,以及解码崩溃地址。IDE 之外的 AI 助手(例如 Claude Code)也可以通过 MCP 使用同一组工具。
开启 AI 功能¶
AI 功能默认关闭。使用之前:
-
开启 AI 功能。 打开设置(
Cmd+,/Ctrl+,),找到 AI Features 并开启 AI 功能。 -
选择模型。 在同一位置设置要使用的模型,例如 Claude Code、Anthropic API 密钥或 GitHub Copilot。密钥和账号登录请自己输入,不要让他人代为填写。
如果在 AI 功能仍处于关闭状态时点击下文任何一个 Ask AI… 按钮,IDE 会先显示“AI features are off…”。点击 Turn On AI 即可开启。
让 AI 修复构建错误¶
-
提出请求。 构建失败时,点击错误通知上的 Ask AI to Fix。
应看到:右侧打开 AI 聊天。第一条消息以
@IPRO开头并附带错误信息。助手会读取构建输出和源代码,修复问题的根源,重新构建,最后用几句话说明它修改了什么。 -
检查修改。 阅读说明后,在编辑器中检查被修改的文件。如果不同意某处修改,可以撤销(
Cmd+Z/Ctrl+Z),或用版本控制恢复该文件。
pins.yaml 或 gatt.yaml 有错误或 CMake 配置失败时,通知上的 Ask AI to Fix 同样会请助手处理该问题。
让 AI 分析崩溃¶
-
询问最近一次崩溃。 开发板崩溃或停止运行时(串口监视器保持打开),在 IPRO 菜单中选择 Ask AI About the Last Crash。
应看到:聊天中附带了监视器最近几十行的内容。助手会解码代码地址、阅读对应位置的代码,并解释原因和修复方法。
-
使用崩溃转储。 如果已经收集了崩溃转储,请在 Crash Dump 视图中点击 Ask AI to Explain。助手会根据完整的调用链解释崩溃。
让 IDE 之外的 AI 助手使用它(MCP)¶
IPRO Workbench 打开期间,会在本机提供一个 MCP 服务器,让 Claude Code、VS Code 和 Cursor 等 AI 助手可以使用 IPRO 工具。助手执行构建时,输出仍会显示在 IDE 的 IPRO Build 中。
-
复制配置。 在 IPRO 菜单中选择 Connect an AI Assistant (MCP)…(或点击 IPRO Home 上的 AI assistant (MCP)),然后选择你使用的助手。
应看到:出现通知“Copied the … setup. It includes the token, so keep it private.”列表中有 Claude Code、VS Code / GitHub Copilot 和 Cursor。对于 Claude Code,复制的内容是一条要在终端中运行的
claude mcp add …命令;对于另外两个,复制的内容要粘贴到配置文件(.vscode/mcp.json、~/.cursor/mcp.json)中。 -
粘贴。 将剪贴板内容粘贴到对应的位置。以 Claude Code 为例,在终端中粘贴并运行该命令,然后启动 Claude Code。
应看到:在 Claude Code 的 MCP 列表中,
ipro服务器已连接,并列出ipro_build、ipro_flash等工具。 -
下达指令。 向助手下达指令,例如“构建并烧录 ipro_unit_test,读取串口并告诉我测试结果。”
应看到:IDE 中的 IPRO Build 和 IPRO Flash 先后显示构建和烧录过程,助手最后报告通过和失败的测试数量。
重要
- MCP 服务器只在本机提供(
127.0.0.1,默认端口 41730),每个请求都必须携带访问令牌。 - 令牌保存在主目录下的
.ipro-ide/mcp.json中,只有你的账户可以读取。复制的配置中包含令牌;请勿将其粘贴到任何公开的地方。 - 不需要该服务器时,请在设置中关闭
ipro.mcp.enabled。
MCP 提供的工具请参阅 MCP 工具。