前言¶

在 DeepSeek Harness（DSH）里接入已有 MCP Server 时，常见的问题是工具命名冲突、缺少 DSH 侧的路由与错误处理规则，以及启动失败时没有明确反馈。dsh-plugin-wps-office 是一个非官方 DSH 适配层。它通过 DSH 的 MCP Client 启动 lc2panda/wps-skills 中的 wps-office-mcp，并注册 wps-office-dsh Skill。

这是什么¶

dsh-plugin-wps-office 由 CatNebulaaaa 维护，仓库地址为 https://github.com/CatNebulaaaa/wps-dsh-plugin。

它解决的问题是把 wps-office-mcp 的 stdio 服务挂载进 DSH，并把工具暴露为 mcp__wps-office__<上游工具名>，同时注册一份 DSH 专用的 wps-office-dsh Skill。

本项目是非官方项目，不是金山办公、DeepSeek 或 wps-skills 维护者的官方项目。许可证为 MIT；wps-skills 仍由其原作者按自己的 MIT License 发布。

核心功能¶

下面介绍它提供的几项能力：

1. 把 wps-office-mcp 的 stdio 服务挂载进 DSH。
2. 将工具暴露为 mcp__wps-office__<上游工具名>，避免与其他 MCP Server 冲突。
3. 注册 wps-office-dsh Skill，提供 DSH 专用路由、安全和错误处理规则。
4. 提供只读的环境检查脚本，报告 Node、DSH、WPS MCP 和 Windows 加载项状态。

安装与启用¶

安装 GitHub 版本时建议固定 commit。下面命令中的 COMMIT_SHA 是占位符，需要替换为你要固定的实际 commit：

dsh plugin --profile web add github:CatNebulaaaa/wps-dsh-plugin#COMMIT_SHA

如果已经全局安装 DSH，也可以在插件目录下执行下面的命令。第一条用于安装当前目录插件，第二条用于导出配置，第三条用于启动 DSH web：

dsh plugin --profile web add .
dsh --profile web --dump-config
dsh web

卸载命令如下：

dsh plugin --profile web remove dsh-plugin-wps-office

典型用法¶

先配置上游路径。推荐把 WPS_SKILLS_ROOT 设置为上游仓库绝对路径：

$env:WPS_SKILLS_ROOT = 'D:\path\to\wps-skills'

也可以只设置编译入口：

$env:WPS_OFFICE_MCP_ENTRY = 'D:\path\to\wps-skills\wps-office-mcp\dist\index.js'

上游 MCP 默认写入 .wps-office-mcp/logs。如果日志目录受限，可以把 WPS_MCP_HOME 设置到可写目录：

$env:WPS_MCP_HOME = 'D:\path\to\writable-home'

运行诊断脚本，可以检查 Node、DSH、WPS MCP 和 Windows 加载项状态：

node scripts/doctor.mjs --wps-skills-root 'D:\path\to\wps-skills' --dsh-source-root 'D:\path\to\deepseek-harness'

安全与注意事项¶

使用前需要注意以下几点：

1. 当前按 DeepSeek Harness 0.1.0-rc.5 开发和验证。DSH 仍处于 Developer Preview，后续版本可能产生破坏性变化。
2. DSH 会把 stdio MCP Server 作为受信任的本机子进程启动。它不运行在 Agent 文件系统沙箱内。
3. WPS 工具能够修改真实文档。执行批量或覆盖操作前，应确认范围并保留备份。
4. 不要把个人路径或任何凭据提交到 Git。
5. 插件设置 failOnStartupError: true。WPS MCP 路径错误、服务启动失败或工具发现失败时，DSH 应明确报错，而不是加载一个没有 WPS 工具的空壳。
6. 上游 MCP 默认写入 .wps-office-mcp/logs。本插件保留这一行为，并允许通过 WPS_MCP_HOME 改变日志根目录。

结尾¶

dsh-plugin-wps-office 的价值在于：在 DSH 中复用现有 wps-office-mcp，同时用 mcp__wps-office__<上游工具名> 降低命名冲突风险，并通过 wps-office-dsh Skill 补充 DSH 侧的路由、安全和错误处理规则。

仓库地址：https://github.com/CatNebulaaaa/wps-dsh-plugin。