前言¶
DeepSeek Harness (DSH) 採用插件化架構。直接調用 WPS 或金山文檔的雲文檔能力通常需要繁瑣的 API 封裝。dsh-wps 插件通過連接官方 Kingsoft SkillHub MCP,將 WPS 的雲文檔操作能力下沉到 DSH 對話中,解決了這一需求。
插件定位¶
這是一個爲 DSH 提供的 WPS / 金山文檔集成插件,由用戶 zhengjy01 維護,採用 MIT 許可證。它通過官方 SkillHub MCP 接口,將 WPS 的文檔管理能力註冊爲 mcp__wps__* 工具,支持在對話中直接操作雲文檔。
核心功能¶
- 連接官方 SkillHub MCP:插件直接連接
https://mcp-center.wps.cn/skill_hub/mcp。 - 動態工具註冊:自動註冊
mcp__wps__*前綴的工具,並動態發現 558 個工具(覆蓋 drive、wps、sheet、wpp、dbsheet、pdf、form、aippt 等模塊)。 - 自定義瀏覽器授權:使用
auth-guide流程打開 WPS 登錄頁,通過輪詢exchange接口獲取 Token,非標準 MCP OAuth 流程。 - 安全存儲:訪問令牌存儲在
~/.dsh/dsh-wps.json,文件權限爲 0600。 - 輔助工具:包含 4 個助手工具,用於查看狀態、啓動 OAuth、測試連接和清除緩存。
- Web 設置面板:內置 Web 設置面板,可在界面上管理 WPS 相關配置。
安裝與啓用¶
安裝插件後需重啓 DSH 進程才能生效。
dsh plugin --profile web add dsh-wps
安裝完成後,在對話中觸發授權流程。插件會打開瀏覽器跳轉到 WPS 登錄頁,使用個人賬戶登錄。企業賬戶會被拒絕(返回 403 狀態碼)。
典型用法¶
安裝並授權成功後,可通過自然語言調用以下能力:
| 你說的話 | 調用的工具 |
|---|---|
| 看看我最近的 WPS 文件 | mcp__wps__list_latest_items |
| 列我的雲文檔根目錄 | mcp__wps__list_my_files |
| 搜含『週報』的文件 | mcp__wps__search_files |
| 讀這個文檔/表/演示 | read_file / sheet.get_range_data / read_slide |
| 新建一個 docx,內容是…… | create_file_with_content |
| 把這個演示導出 PDF | wpp.export.export.pdf |
完整的工具列表可通過 wps_test 命令查看。
注意事項¶
- 僅支持個人賬戶:該插件目前僅支持 WPS 個人賬戶,企業賬戶會被拒絕。
- Token 安全:Token 以明文存儲在本地文件
~/.dsh/dsh-wps.json,請確保該文件權限正確(mode 0600)。 - 自定義授權流程:由於 WPS 的 OAuth 發現端點返回 404,插件實現了自定義的
auth-guide+exchange-poll授權流程。