前言¶

在 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。