CatNebulaaaa/wps-dsh-plugin

Project Overview项目介绍

This is a native DSH plugin that integrates the WPS Office automation MCP server from the upstream lc2panda/wps-skills project into DeepSeek Harness. It does not duplicate any of the upstream WPS MCP code, WPS add-ins, or tool definitions. Instead, it uses DSH’s built-in MCP client to launch the existing upstream service, and adds lightweight DSH-specific tool naming, routing, error handling, and a pre-flight check script to verify environment status. The pre-flight check issues clear OK/WARN/ERROR status codes and will fail plugin load on critical errors to avoid running a broken empty plugin. All actual WPS automation capabilities and 200+ tools are provided by the upstream wps-skills repository.

To use this plugin, you first need to clone the upstream wps-skills repository, install dependencies, build the MCP server, and install the WPS add-in following the upstream installation instructions. Next, you install this plugin to DSH either by adding a local checkout or installing directly from the GitHub repository with a fixed commit hash for stability. You then set one of two optional environment variables to point DSH to the path of your built upstream WPS MCP server. Finally, you can run the built-in diagnostic script to check that all dependencies are correctly configured before starting DSH. This plugin is aimed at users who want DSH agent to automate WPS document workflows.

This plugin requires several prerequisites to run correctly: WPS Office with the WPS add-in installed from upstream, a pre-built copy of the upstream wps-skills MCP server, Node.js version 22.19+ or 24+, and DeepSeek Harness version 0.1.0-rc.5 or a compatible newer version. The plugin itself is licensed under the MIT license, and the upstream wps-skills project retains its original MIT license from its author. Since WPS tools can modify actual document files, you should always confirm the scope of bulk operations and back up your important documents before running automated changes. The MCP server runs as a trusted local process, not inside the DSH agent sandbox. This is an unofficial project not affiliated with WPS or DeepSeek.

这是专为 DeepSeek Harness (DSH) 开发的原生插件,作用是将上游 lc2panda/wps-skills 项目提供的 WPS Office MCP 自动化服务接入 DSH。它本身不复制上游的 WPS MCP 代码、加载项或工具定义,仅通过 DSH 自带的 MCP 客户端启动已有服务,补充适配 DSH 工具命名规则的轻量 Skill 定义和错误处理规则。

用户需要先按照上游文档完成 WPS 加载项安装,克隆并构建 wps-skills 仓库,再安装本插件,配置 WPS_SKILLS_ROOT 或 WPS_OFFICE_MCP_ENTRY 环境变量指定上游仓库路径。它面向需要让 DSH Agent 自动读写编辑 WPS 文字、表格、演示文档的用户,总共可提供 200 多个 WPS 相关自动化工具。

本插件要求 Node.js 22.19+ 或 24+ 版本、DSH 0.1.0-rc.5 或兼容版本、已正常安装的 WPS Office 以及正确配置的 WPS 加载项。本插件本身采用 MIT 许可证,上游 wps-skills 仍遵循原作者的 MIT 许可,执行批量修改操作前需要确认范围并备份文档,避免误修改重要文件。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:CatNebulaaaa/wps-dsh-plugin#COMMIT_SHA

把 CatNebulaaaa/wps-dsh-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-plugin-wps-office

Unofficial DeepSeek Harness integration for lc2panda/wps-skills.

这是一个独立的 DSH 适配层。它不复制 WPS MCP、WPS 加载项或上游 Skills,而是通过 DSH 自带的 MCP Client 启动现有 wps-office-mcp,并补充一份适配 DSH 工具命名的轻量 Skill。

当前按 DeepSeek Harness 0.1.0-rc.5 开发和验证。DSH 仍处于 Developer Preview,后续版本可能产生破坏性变化。

提供什么

  • 把 wps-office-mcp 的 stdio 服务挂载进 DSH。
  • 将工具暴露为 mcp__wps-office__<上游工具名>,避免与其他 MCP Server 冲突。
  • 注册 wps-office-dsh Skill,提供 DSH 专用路由、安全和错误处理规则。
  • 提供只读的环境检查脚本,明确报告 Node、DSH、WPS MCP 和 Windows 加载项状态。

WPS Office 自动化、MCP Server 和 200 多个专业工具均由上游 lc2panda/wps-skills 提供。

前提条件

  • WPS Office,以及按上游说明安装完成的 WPS 加载项。
  • 一个已经构建的 lc2panda/wps-skills checkout。
  • Node.js 22.19+(22.x)或 Node.js 24+,以满足当前 DSH 的运行要求。
  • DeepSeek Harness 0.1.0-rc.5 或兼容版本。

先构建上游 MCP:

git clone https://github.com/lc2panda/wps-skills.git
Set-Location .\wps-skills\wps-office-mcp
npm install
npm run build

加载项安装和重启 WPS 的步骤以上游安装文档为准。

配置 WPS 路径

推荐设置 WPS_SKILLS_ROOT 为上游仓库的绝对路径:

$env:WPS_SKILLS_ROOT = (Resolve-Path 'C:\path\to\wps-skills').Path

也可以只设置编译入口:

$env:WPS_OFFICE_MCP_ENTRY = (Resolve-Path 'C:\path\to\wps-skills\wps-office-mcp\dist\index.js').Path

DSH 会从启动目录的 .env 和 $DSH_HOME/.env 加载环境变量。需要跨项目使用时,可将不含密钥的路径配置写入 $DSH_HOME/.env;不要把个人路径或任何凭据提交到 Git。

上游 MCP 默认把日志写到用户主目录的 .wps-office-mcp/logs。如果运行环境限制该目录写入,可把日志重定向到另一个可写目录:

$env:WPS_MCP_HOME = 'D:\path\to\writable-home'

使用本地构建的 DSH 安装

下面示例直接运行源码 checkout 已构建的 CLI:

$DshRoot = 'D:\path\to\deepseek-harness'
$PluginRoot = 'D:\path\to\dsh-plugin-wps-office'

node "$DshRoot\apps\cli\lib\bin.js" plugin --profile web add $PluginRoot
node "$DshRoot\apps\cli\lib\bin.js" --profile web --dump-config
node "$DshRoot\apps\cli\lib\bin.js" web

已全局安装 DSH 时:

dsh plugin --profile web add .
dsh --profile web --dump-config
dsh web

安装 GitHub 版本时建议固定 commit:

dsh plugin --profile web add github:CatNebulaaaa/wps-dsh-plugin#COMMIT_SHA

诊断

node scripts/doctor.mjs `
  --wps-skills-root 'D:\path\to\wps-skills' `
  --dsh-source-root 'D:\path\to\deepseek-harness'

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-speech 下一个 Next dsh-tool-encoding →