前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過「一切皆插件」的方式擴展能力。在網頁端開發或使用過程中，直接讀取本地文檔（如 PDF、Word、PPT）並填入對話輸入框，往往需要手動複製粘貼，效率較低。dsh-document-reader 插件解決了這一痛點，爲 DSH 的 Web Profile 增加了文件讀取能力，支持通過上傳或拖拽的方式將文檔內容導入到編輯器中。
插件定位¶
- 名稱：dsh-document-reader
- 類別：客戶端
- 作者：Yun-tech123
- 許可證：MIT
- 核心價值：在 DSH 聊天界面的輸入框中，直接讀取 PDF、Word、PPT 及純文本文件的內容。
核心功能¶
該插件主要提供以下三種交互方式與支持格式：
-
上傳讀取
安裝後，輸入框工具欄會出現「文檔」按鈕。點擊該按鈕，系統會彈出文件選擇框，支持多選文件。 -
整頁拖拽
將文檔文件拖動到頁面任意位置，界面會出現「釋放以讀取文檔」的遮罩提示，鬆手後即可觸發讀取。 -
格式與限制
- 支持格式：PDF、.docx、.pptx、以及 txt、md、csv、yaml、代碼文件。
- 輸出上限：單文件讀取字符數上限爲 20 萬，超出部分會自動截斷。
安裝與啓用¶
使用 DSH 的命令行工具安裝插件。安裝過程會自動註冊到 dsh.profile.bundles。
- 執行安裝命令：
dsh plugin --profile web add github:Yun-tech123/dsh-document-reader
- 重啓 Web 服務：
dsh web
- 刷新頁面後，在輸入框工具欄即可看到新增的「文檔」按鈕。
典型用法¶
安裝完成後，可以通過以下兩種方式使用：
- 點擊輸入框工具欄的「文檔」按鈕，選擇本地文件。
- 直接將文件拖拽至頁面任意空白處。
適用場景與注意¶
該插件以 DSH 進程當前的權限運行。在使用前，建議檢查源碼與許可證。
- PDF 限制：該插件僅支持文本提取。對於純掃描件（圖片型 PDF），因爲沒有文本層，無法提取內容。
- 舊版格式：老式的二進制 .doc、.xls、.ppt 格式暫不支持，請先轉換爲 .docx 或 .pptx 格式。
- 瀏覽器要求：需要較新的瀏覽器環境，支持
.docx/.pptx解壓（Chrome/Edge/Firefox 2022 及以上版本）。
結語¶
dsh-document-reader 爲 DSH 用戶提供了便捷的文件導入手段，減少了手動輸入的繁瑣步驟。更多細節與源碼，請參考項目目錄或 GitHub 倉庫。
