【DSH插件推荐】handsomeboyck/dsh-wps-plugings
Lv.2潜力创作者
一、项目简介
GitHub 仓库地址为 https://github.com/handsomeboyck/dsh-wps-plugings
该插件是 DeepSeek Harness生态中为 WPS 云文档量身打造的能力集成插件，旨在让用户通过自然语言对话直接操作 WPS 云文档，涵盖云盘文件管理、智能文档编辑、表格数据处理、演示文稿操作等场景。该插件已发布到 npm，包名为 dsh-wps-plugin，当前版本为 0.2.0。
二、与金山文档官方生态的关系
2.1 金山文档 Skill 的架构演进
金山文档 Skill 架构升级：从 mcporter 到 kdocs-cli
金山文档 Skill 是金山办公官方为 AI Agent 提供的云文档操作能力，经历了两个阶段的架构演进：
第一阶段（旧版）：MCP 协议模式
该阶段以金山文档 Skill v1 为代表，技术栈为：
通过 mcporter（MCP 中间件管理工具）将金山文档能力注册为 MCP 服务
AI Agent 通过 mcporter call kdocs.xxx 间接调用工具
工具层连接的是 mcp-center.wps.cn/skill_hub/mcp 这个官方 HTTP MCP 端点
该端点是金山文档对外提供 AI 工具调用能力的统一入口。任何支持 MCP over HTTP 协议的 AI 客户端（如 Claude Code、Cursor、GitHub Copilot、Trae 等），只需配置好上述地址和 Authorization Token，即可调用金山文档的云文档操作能力，涵盖文件管理、智能文档、表格、演示文稿、PDF、多维表、知识库等场景，上游共计 258 个工具。
第二阶段（新版）：CLI 命令行模式
该阶段以金山文档 Skill v2 为代表，技术栈为：
彻底抛弃 mcporter 和 MCP 协议依赖
改用预编译的独立二进制工具 kdocs-cli
调用链路简化为 Agent → kdocs-cli → 金山文档 API
Token 从配置文件明文存储升级为系统密钥链加密存储
在新版 kdocs-cli 中，直接调用金山文档 API，不再经过 MCP 协议层。
2.2 dsh-wps-plugin 复用了旧版 MCP 协议通道
dsh-wps-plugin 以DSH Cordis 插件的形式复用了 kdocs Skill 旧版的 MCP 协议通道，但省略了 mcporter 这个中间件。
具体来说：
插件通过 DSH 自带的 HTTP Client 能力，直接连接 mcp-center.wps.cn/skill_hub/mcp 这个官方 MCP 端点
使用 WPS OAuth 完成用户授权，获取 Token 并安全存储
将 56 个核心工具以 DSH 原生工具的形式注册到 Cordis 运行时
上游官方 SkillHub 端点共提供 258 个工具，插件默认启用其中 56 个核心工具，其余可按需扩展
核心优势总结：
一键授权：浏览器 OAuth 自动授权，无需手动配置 API Key
安全存储：Token 优先存入系统密钥链，避免明文落盘
云端操作：无需安装 WPS 本地客户端，跨平台可用
工具丰富：56 个核心工具覆盖云盘管理、文档编辑、表格处理、演示文稿、分享协作等场景
可扩展：上游 258 个工具可按需启用
三、功能概述
dsh-wps-plugin 默认向 DSH 注册 56 个核心工具，覆盖 9 大服务类别，这些工具均由上游官方 SkillHub 端点提供。
3.1 文件与云盘管理（13 个工具）
工具名 | 功能说明 |
list_my_files | 列出云文档根目录 |
list_files | 列出指定目录下的文件 |
search_files | 搜索文件 |
get_file_info | 获取文件详细信息 |
create_file_with_content | 创建带内容的文档 |
create_folder | 创建文件夹 |
upload_new_file | 上传新文件 |
download_file | 下载文件 |
read_file | 读取文档内容 |
move_file | 移动文件 |
copy_file | 复制文件 |
rename_file | 重命名文件 |
list_latest_items | 列出最近访问的文件 |
3.2 智能文档 OT 操作（6 个工具）
工具名 | 功能说明 |
otl.insert_content | 插入内容 |
otl.convert | 转换文档格式 |
otl.block_query | 查询文档块 |
otl.block_insert | 插入文档块 |
otl.block_update | 更新文档块 |
otl.block_delete | 删除文档块 |
3.3 分享与协作（5 个工具）
工具名 | 功能说明 |
share_file | 分享文件 |
get_share_info | 获取分享信息 |
set_collaborator_permissions | 设置协作者权限 |
list_document_collaborators | 列出文档协作者 |
create_document_comment | 创建文档评论 |
3.4 文字文档 WPS 操作（7 个工具）
工具名 | 功能说明 |
wps.create_empty_document | 创建空白文档 |
wps.read_text | 读取文本内容 |
wps.write_text | 写入文本内容 |
wps.read_table | 读取表格内容 |
wps.write_table | 写入表格内容 |
wps.search_replace | 查找替换文本 |
wps.export | 导出文档 |
3.5 表格 Sheet 操作（10 个工具）
工具名 | 功能说明 |
sheet.get_sheets_info | 获取工作表信息 |
sheet.get_range_data | 获取指定范围数据 |
sheet.update_range_data | 更新指定范围数据 |
sheet.range_data_batch_update | 批量更新范围数据 |
sheet.add_sheet | 添加工作表 |
sheet.delete_sheets | 删除工作表 |
sheet.find_range_data | 查找范围数据 |
sheet.delete_range_data | 删除范围数据 |
sheet.insert_rows_cols | 插入行列 |
sheet.merge_range | 合并单元格 |
3.6 演示文稿 WPP 操作（4 个工具）
工具名 | 功能说明 |
wpp.create_empty_presentation | 创建空白演示文稿 |
wpp.read_slide | 读取幻灯片内容 |
wpp.write_slide | 写入幻灯片内容 |
wpp.export_pdf | 导出为 PDF |
3.7 其他服务
服务类别 | 工具数 | 关键工具 |
PDF 处理 | 4 | get_pdf_page_count、extract_pdf_pages、convert、convert_query |
多维表 DBSheet | 4 | get_schema、list_records、create_records、update_records |
知识库 KWiki | 2 | list_knowledge_views、list_items |
版本历史 | 1 | list_file_versions |
四、安装与使用
4.1 环境要求
依赖 | 版本要求 | 说明 |
Node.js | >= 18.0.0 | 建议使用 LTS 版本（20/22） |
DeepSeek Harness | 0.1.0-rc.x | 通过 npm install -g @deepseek-ai/dsh 安装 |
WPS 账号 | 个人账号 | 授权走 WPS OAuth 流程 |
4.2 安装方式
方式一：一句话安装（推荐）
在 DSH 对话中直接输入：
请帮我安装 dsh-wps-plugin 插件
方式二：手动命令行安装
dsh plugin --profile web add dsh-wps-plugin
dsh web
方式三：从 Git 仓库安装
dsh plugin --profile web add https://github.com/handsomeboyck/dsh-wps-plugings.git
dsh web
方式四：本地开发模式安装
git clone https://github.com/handsomeboyck/dsh-wps-plugings.git
cd dsh-wps-plugings
npm install
npm run build
dsh plugin --profile web add link:$PWD
dsh web
4.3 授权流程
DSH 智能体将自动完成安装。重启 DSH 后，第一次调用任意 WPS 工具时，浏览器会自动打开 WPS 授权页（mcp-center.wps.cn），登录 WPS 账号并完成授权即可。页面显示"授权成功"后可关闭，Token 自动保存，之后无需重复授权。授权轮询最长等待 5 分钟。
4.4 使用示例
自然语言指令 | 实际调用的工具 |
"看看我最近的文件" | list_latest_items |
"列出我的云文档根目录" | list_my_files |
"搜一下含'周报'的文件" | search_files |
"读一下这个文档" | read_file |
"新建一个 docx 文档，内容是……" | create_file_with_content |
"把这份周报上传到 WPS" | upload_new_file |
"看下这个文件的详情" | get_file_info |
"把这个文件分享给同事" | share_file |
4.5 卸载
dsh plugin --profile web remove dsh-wps-plugin
与基于本地 WPS Office 客户端的方案（如【DSH插件推荐】CatNebulaaaa/wps-dsh-plugin）相比，dsh-wps-plugin 提供的是云端文档操作能力，两者形成互补——前者适用于云端文档管理与协作，后者适用于本地文档的实时操控。
