前言¶

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 才能生效。