金山文档连接器 Tang-mm95/dsh-kdocs-connector

dsh-kdocs-connector

DeepSeek Harness
topic: dsh-plugin
License: MIT

金山文档（WPS 个人账号）连接器 —— 一个 DeepSeek Harness 永久插件：用户在浏览器中自行登录 WPS / 金山文档账号，即可在 DSH 里查看、引用、编辑、导出个人云文档，并可用自然语言对文档进行对话式处理。

基于金山官方 kdocs-cli（个人账号专用，凭据存系统钥匙串，不落明文）。

功能

| 模块 | 说明 |
| 🔐 登录 | 浏览器 OAuth 网页登录（个人账号），或从 kdocs.cn 复制 Token 粘贴登录；凭据存系统钥匙串 |
| 📁 浏览 | 我的云文档（文件夹导航 + 面包屑）、最近访问、⭐ 星标、👥 共享（收到的 / 我分享的）、关键词搜索 |
| 📄 文件操作 | 打开（浏览器在线查看/编辑）、链接（复制到剪贴板）、引用、下载（浏览器下载） |
| 💬 引用到对话 | 点击「引用」→ 自动关闭设置页回到对话，输入框只插入一行 📄金山文档「文件名」链接 标记；输入自然语言（如"帮我总结"）发送后，模型通过 kdocs_read 按链接读取文档并执行指令 |
| ➕ 新建 | 空白在线文档（otl / docx / xlsx / ksheet / dbt / pptx / xls / doc / ppt）与文件夹 |
| 🧠 模型工具 | kdocs_status / kdocs_list / kdocs_search / kdocs_read（支持链接）/ kdocs_link / kdocs_download / kdocs_create |
| 🧭 位置记忆 | 面板关闭（含「引用」自动关闭）后重新打开，恢复到上次的标签页 / 文件夹路径 / 搜索结果 |

安装

依赖：官方 kdocs-cli（首次使用前安装）：

curl -fsSL https://raw.githubusercontent.com/kdocs-app/kdocs-skill/master/scripts/setup.sh -o /tmp/setup.sh \
&& KDOCS_CLI_VERSION=2.5.29 bash /tmp/setup.sh

安装本插件（需重启 harness 生效）：

dsh plugin --profile web add https://github.com/Tang-mm95/dsh-kdocs-connector

或直接在对话里让 Agent 安装：

帮我安装这个插件 https://github.com/Tang-mm95/dsh-kdocs-connector

装好后：设置 → 金山文档 → 点「🌐 网页登录」，用 WPS 个人账号完成授权（企业账号不支持）。

结构

| 部件 | 文件 | 作用 |
| Bundle 清单 | package.json | 声明 dsh.bundle.patch（host 层）+ dsh.client（浏览器模块） |
| Patch 层 | cordis.patch.yml | 把插件 host 行插入 Loader 树 |
| Host 半 | lib/index.js | 封装 kdocs-cli（认证 / 云盘 / 读取 / 下载 / 新建）、同源路由 POST /api/kdocs/call、kdocs_* 模型工具 |
| Client 半 | lib/client.js | __ModuleLoader__ bundle：设置页「金山文档」面板 + 输入区引用桥（渲染 null） |

说明与限制

- 仅支持 WPS 个人账号；企业账号请使用 WPS365 CLI
- 「下载」通过浏览器下载链接完成（服务器直连下载需要浏览器登录态，会 403）
- 「引用」会把文件标记写入插件所在会话的输入框；在其它会话打开设置面板时若桥接不可用，会降级为面板内预览
- 每次更新需重启 harness

License

MIT