English | 中文

dsh-wps

DeepSeek Harness（DSH）WPS / 金山文档云文档能力集成插件。 装上后，你可以在 DSH 对话里用自然语言操作 WPS 云文档：列目录、搜索、读取、创建、上传/下载云文档，以及文字/表格/演示/PDF 的内容读写。

它做什么

• 连接金山文档官方 SkillHub MCP（https://mcp-center.wps.cn/skill_hub/mcp）。
• 通过自定义浏览器授权（auth-guide + exchange 轮询拿 token，非标准 OAuth）登录你的 WPS 个人账号。
• 授权后把官方 MCP 的工具动态注册为 mcp__wps__<名称>（云盘 / wps / sheet / wpp / dbsheet / pdf / form / aippt 等）。
• 提供 4 个帮助工具 wps_status / wps_oauth_start / wps_test / wps_clear，并带 Web 设置面板「WPS」。

安装（npm）

dsh plugin --profile web add dsh-wps
# 或从 Git：
# dsh plugin --profile web add github.com/zhengjy01/dsh-wps

重启后触发授权：浏览器会打开 WPS 登录页，用个人 WPS 账号登录授权（企业账号会被拒绝）。之后即可直接说「列一下我的 WPS 云文档根目录」。

使用（示例）

| 你说的话 | 调用 | | --- | --- | | 「看看我最近的 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 实际列出为准（共 558 个）。

授权（实现要点）

mcp-center.wps.cn/.well-known/oauth-authorization-server 返回 404，说明 WPS 不用标准 MCP OAuth 发现，而是自定义流程：生成 auth_code → 打开 https://mcp-center.wps.cn/kdocs-auth/auth-guide?auth_code=<uuid> → 用户登录 → 每秒轮询 POST https://api.wps.cn/office/v5/ai/skill_hub/wps_auth/exchange（body {code}）直到 {code:200, token}。403=企业账号被拒（用个人号）、409=已取消。token 作为每次 JSON-RPC 调用到 SkillHub MCP 的 Bearer 凭据。

目录结构

dsh-wps/
├── src/
│   ├── index.ts     # cordis 插件入口（apply + 帮助工具 + 公告）
│   ├── store.ts     # token 存储（~/.dsh/dsh-wps.json，0600）
│   ├── auth.ts      # 浏览器授权（auth-guide + exchange 轮询）
│   ├── mcp.ts       # JSON-RPC-over-HTTP MCP 客户端 + 动态注册 mcp__wps__*
│   ├── routes.ts    # /api/dsh-wps/*（设置面板）
│   └── client/      # Web 设置面板「WPS」
├── cordis.patch.yml # bundle patch（insert wps 行）
├── tsdown.config.ts # host + client bundle 构建
└── package.json     # dsh.bundle.patch 声明

License

MIT