安装扩展

在 VS Code 扩展面板搜索 Digital IDE，确认标识为 sterben.fpga-support；也可以从项目 Releases 获取 VSIX，使用扩展面板菜单中的 Install from VSIX 安装。选择与目标主机平台和架构匹配、包含后端资源的包。

当前语言服务由 digital-server 提供。打开 Output 的 Digital-IDE 通道，检查 Digital Server executable 和启动错误。若提示找不到可执行文件，检查安装包是否包含 resources/server/<platform>/<arch>/digital-server（Windows 为 .exe）。重新安装匹配的完整包；不要把其他平台的程序改名使用。

安装 dide-mcp

dide-mcp 随 Digital IDE 的 digital-server 后端提供，可让支持 MCP 的 AI 客户端读取工程、操作波形，以及调用已配置的仿真和工具链。安装包含该功能的扩展后，将客户端连接到插件管理的后台即可。

启动插件后台

1. 在 VS Code 中打开工程文件夹，并确认该工作区受信任。Remote SSH 环境中，扩展需要安装在远程端。
2. 等待插件自动启动 MCP 后台，默认无需手动开启。只有此前关闭过 digital-ide.mcp.enabled 时，才需要将其恢复为 true 并执行 Developer: Reload Window。
3. 打开 Output → Digital-IDE，等待后端初始化完成，记录 Digital Server executable 中的可执行文件绝对路径，以及 DIDE MCP ready ... Endpoint: 后的 endpoint.json 绝对路径。

endpoint.json 由插件生成，与工作区对应；应使用当前窗口日志中的路径。插件退出时后台也会关闭，因此使用 MCP 时保持该 VS Code 工程窗口打开。连接文件包含认证令牌，不要把文件内容粘贴进对话或提交到 Git。

连接 Codex

在与插件后端相同的主机、能访问上述文件的用户环境中运行下面的命令。将两个示例路径替换为日志中的实际路径，并保留引号；Windows 的后端文件名为 digital-server.exe。

codex mcp add dide-mcp -- "/absolute/path/to/digital-server" dide-mcp --connect "/absolute/path/to/endpoint.json"
codex mcp get dide-mcp

--connect 启动 stdio 适配器，复用插件已经启动的后台。Remote SSH 使用远程路径，应在远程端运行对应的 Codex 客户端；这些路径不能直接填给 Windows 本地进程执行。命令格式也可通过 codex mcp add --help 查看。

重新打开 AI 会话，让客户端发现服务和工具。先调用 list_wave_views 检查连接；没有波形视图时返回空列表也属于正常结果。再调用 get_project，确认连接到预期的工程。codex mcp get 仅说明客户端已有配置，实际工具调用成功才表示连接可用。

连接其他 MCP 客户端

选择 stdio 传输，将启动命令设为 digital-server 的绝对路径，参数依次填写 dide-mcp、--connect 和连接文件的绝对路径。支持 mcpServers 格式的客户端可参考：

{
  "mcpServers": {
    "dide-mcp": {
      "command": "/absolute/path/to/digital-server",
      "args": ["dide-mcp", "--connect", "/absolute/path/to/endpoint.json"]
    }
  }
}

按客户端要求合并到已有配置，不要覆盖其他服务。Windows 的 JSON 路径可以使用 C:/.../digital-server.exe；配置文件位置及外层字段以所用客户端为准。

使用 AI 安装的 Prompt

将下面的提示词直接复制给具有终端和文件访问能力的 AI 助手即可，无需填写或替换任何内容。助手会自动识别客户端、当前工程和运行环境，查找实际路径并完成配置。

请为当前 Digital IDE 工程安装并配置 dide-mcp，完成一次实际连接验证。

请自行从当前会话、工作目录、VS Code 工作区、扩展安装信息和日志中识别所需信息，不要要求我预先填写客户端名称、主机、工程路径或可执行文件路径。

请按以下步骤执行：
1. 自动识别当前 AI 客户端、目标工程，以及客户端和 Digital IDE 后端所在的主机、操作系统和用户。结合当前会话和工作区判断本机或 Remote SSH 环境，确保远程路径由远程主机上的进程使用。
2. 检查 Digital IDE 的安装与后台状态。MCP 默认自动启用，无需添加设置；若此前明确禁用，请说明并处理。后台需要已打开且受信任的 VS Code 工程窗口。只有缺少访问权限或确实需要人工界面操作时，才说明具体阻塞和最小操作。
3. 从当前工程对应的 Digital-IDE 输出、扩展日志和安装目录中自动定位 Digital Server executable 与 DIDE MCP ready 的 Endpoint，核实可执行文件和 endpoint.json 存在且属于目标工程。多个窗口时按工作区和日志匹配，不随意选择第一个结果。不要猜路径、自行创建 endpoint.json 或输出其中的认证令牌。
4. 使用查到的 digital-server 绝对路径作为 stdio 启动命令，参数依次为 dide-mcp、--connect 和查到的 endpoint.json 绝对路径。这里的 dide-mcp 由 digital-server 提供，不要尝试 npm install dide-mcp。
5. 自动找到当前客户端的 MCP 配置入口并保留其他服务。若客户端是 Codex，先检查已有配置和 codex mcp add --help，再用实际路径构造并执行 codex mcp add 命令，随后运行 codex mcp get dide-mcp。其他客户端按其格式写入相同的 command 和 args。已有正确配置时直接复用，不让我手动拼接命令或替换路径。
6. 重新发现 MCP 工具，并实际调用 list_wave_views 和 get_project，确认连接可用且工程正确。若当前会话需要重开，告诉我重开步骤和重开后要执行的验证，不要提前报告安装成功。
7. 最后报告运行主机、修改的配置文件、服务名、可执行文件路径、连接文件路径及实际验证结果。安装验证只读取工程，不修改 HDL、不启动仿真或厂商构建。

连接失败时

现象	检查方法
没有 DIDE MCP ready	检查是否打开了受信任的工作区、MCP 设置是否开启，以及后端是否成功初始化；修改设置后重载窗口。
找不到 endpoint.json 或连接失败	保持 VS Code 工程窗口打开，从当前日志重新获取路径，并确认客户端与后端在同一主机、具有文件访问权限。
客户端看不到工具	重开 AI 会话或重新发现服务；检查启动参数是否包含 dide-mcp --connect。
工具提示需要插件后台	确认使用了 --connect。直接运行独立 stdio 模式不会接入当前 VS Code 工程与界面。

完成安装后，继续 打开与配置工程。

界面语言

Digital IDE 的菜单、设置、通知、工程管理、IP 配置、构建报告和 Webview 支持英语、简体中文、繁体中文、德语、日语、法语和俄语。运行 VS Code 的 Configure Display Language，选择显示语言并重新加载窗口，扩展会跟随该语言。Remote SSH 使用客户端的显示语言。

波形页面可以在右侧设置面板中单独选择语言，选择会保留到下次打开。独立浏览器页面也支持 ?locale=de 等语言参数。未支持的语言回退到英语。

工程字段、信号名、路径、代码片段正文和厂商原始日志保持原文；IP 的厂商参数名称仍以 Vivado 提供的元数据为准。

外部工具与远程环境

语言编辑和工具链执行是不同环节。使用 Vivado、Efinity、ModelSim/Questa、Icarus 等功能前，分别安装所需工具和许可证，并在 工具链路径配置 中指定路径。Remote SSH 下将扩展安装到远程端，并填写远程路径。

若开发窗口一直等待启动，查看脚本输出与扩展开发宿主的 Output；图标或 Webview 异常时查看 Developer: Toggle Developer Tools 中实际失败的资源请求。