前言¶
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授权流程。