前言¶
DeepSeek Harness（DSH）的设计理念是「一切皆插件」。在进行 Unity 游戏开发时，开发者通常需要通过命令行或脚本与 Unity 编辑器交互。DSH 提供了插件机制来扩展其功能。dsh-unity-mcp 插件解决了将 DSH 与 Unity MCP 服务器连接的痛点，它通过 unity-ai-relay 可执行文件作为中间层，让 DSH 能够直接调用 Unity 的工具链。
插件简介¶
该插件由开发者 ComeCaramelos 维护，连接 DSH 与 Unity MCP 服务器。它利用 Unity AI Assistant 包自带的 unity-ai-relay 可执行文件，并通过 DeepSeek 的标准 MCP 客户端桥接，在 Web GUI 中提供设置和状态卡片。
核心功能¶
- 连接 Unity MCP 服务器：通过
unity-ai-relay建立与 Unity 编辑器的通信。 - 工具映射：将 Relay 注册的工具暴露为标准的
mcp__unity__*工具，供 DSH 直接调用。 - Web GUI 集成：在 Web 界面的设置中提供状态卡片，用于配置和监控连接。
- 本地启动：插件不执行任何下载操作，而是直接启动本地已安装的
unity-ai-relay可执行文件。
安装与启用¶
通过官方命令行工具安装该插件：
dsh plugin --profile web add @comecaramelos/dsh-unity-mcp
典型用法¶
使用该插件前，需确保满足以下前提条件：
1. 在 Unity 编辑器中已安装 Unity AI Assistant 包（com.unity.ai.assistant）。
2. 保持 Unity 编辑器处于运行状态。
安装后，通过以下步骤进行配置：
- 进入 Settings 菜单。
- 导航至 Plugins -> Plugin configuration -> DSH Unity MCP。
- 配置 Relay 可执行文件：点击「Fetch executables」按钮搜索本地路径（包括 WSL 主机可访问的 Windows 用户配置文件），选择正确的
unity-ai-relay路径。 - 设置额外参数：在「Extra flags」栏中添加启动参数，例如
--project-path=/home/roberto/game或--name=MyProject。 - 日志控制：选择是否将 Relay 的输出重定向到日志文件以减少控制台噪音，或在调试时直接输出到控制台。
适用场景与注意事项¶
- 运行环境：插件以当前 DSH 进程的权限运行。在安装前，建议检查源码与许可证（MIT）。
- 依赖要求：必须依赖 Unity AI Assistant 包，且 Unity 编辑器必须处于运行状态。Relay 是编辑器的侧通道，若编辑器未运行，连接将失败。
- 配置持久化：配置项保存在 Web GUI 中，若 Relay 程序路径无效，插件不会自动重新解析，需手动修正。
结语¶
dsh-unity-mcp 提供了标准化的桥接方案，让开发者能够在 DSH 环境中无缝调用 Unity 的 MCP 工具。它通过本地执行的方式减少了网络传输开销，并利用 Web GUI 实现了可视化的配置管理。
