前言¶

DeepSeek Harness（DSH）采用插件化架构，旨在通过扩展组件丰富应用能力。在本地数据与云端文档交互的场景中，开发者常需要直接调用云文档服务。dsh-kdocs-connector 是一个接入金山文档（WPS 个人账号）的插件，它允许用户在浏览器中完成登录认证，并在 Harness 环境中浏览、引用、新建及导出个人云文档。

功能概览¶

该插件提供了一整套与金山文档交互的能力。

1. 登录与浏览
用户可通过浏览器进行 OAuth 网页登录，或将 Token 粘贴登录。凭据会被安全地存储在系统钥匙串中。登录后，可浏览“我的云文档”、最近访问记录、星标文档、共享文档（收到的/我分享的），以及进行关键词搜索。

2. 文件操作
支持在浏览器中打开文档进行在线查看或编辑，复制链接，下载文件（通过浏览器下载链接实现），以及引用文档。

3. 引用到对话
这是该插件的核心交互方式。在设置面板中点击文档的“引用”按钮，设置页会自动关闭并回到对话界面，输入框中会插入一条包含链接的标记。用户随后输入自然语言指令（如“帮我总结”），模型将通过 kdocs_read 工具读取文档内容并执行指令。

4. 新建与工具
支持新建空白在线文档（支持 otl、docx、xlsx、ksheet、dbt、pptx、xls、doc、ppt 格式）与文件夹。插件提供了多个模型工具，包括 kdocs_status、kdocs_list、kdocs_search、kdocs_read、kdocs_link、kdocs_download 和 kdocs_create。

5. 位置记忆
面板关闭（包括通过“引用”自动关闭）后重新打开，会恢复到上次的标签页、文件夹路径或搜索结果。

安装与启用¶

1. 安装插件
在终端中执行以下命令安装插件：

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

安装完成后，需要重启 Harness 才能使新插件生效。

2. 首次使用
进入 Harness 设置，找到“金山文档”选项，点击“🌐 网页登录”。使用 WPS 个人账号完成授权即可。

典型用法¶

1. 安装插件
若不想手动输入命令，可在对话中直接发送以下指令：

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

2. 引用文档处理
在设置页浏览到需要处理的文档，点击“引用”按钮。回到对话输入框后，输入指令让模型处理该文档。例如：

“请根据这份文档总结核心观点。”

模型会自动调用 kdocs_read 工具解析文档内容并返回结果。

注意事项¶

• 账号类型限制：该插件仅支持 WPS 个人账号。若使用企业账号，请改用 WPS365 CLI。
• 下载机制：下载功能通过浏览器下载链接实现，服务器直连下载会因缺少浏览器登录态而返回 403 错误。
• 引用作用域：引用功能仅写入当前会话的输入框，不会修改文档本身。
• 更新生效：每次更新插件后，必须重启 Harness 才能生效。