Tang-mm95 / dsh-kdocs-connector

dsh-kdocs-connector

金山文档（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