在 DSH 的開發與調試流程中，讓智能體訪問本地文件系統往往涉及上傳、沙盒配置或臨時存儲等步驟。dsh-doc-quick 插件提供了一種更直接的方案：通過 Web 界面拖拽文件，由 Agent 直接讀取本地文件內容並進行處理。
這是一個 DSH 插件，允許用戶將文檔拖入 Web 對話框，宿主程序將文件保存至本地目錄，Agent 讀取文件後，在右側側欄展示處理結果與文件路徑。
核心功能¶
拖拽與存儲¶
用戶將文件拖入 Web 對話框後，宿主程序會將文件保存至 ~/.dsh/doc-quick/<sessionId>/ 目錄，並註冊一個任務。
本地文件讀取¶
插件允許宿主直接讀取本地文件系統。支持的格式包括：PDF、Word (doc/docx)、PowerPoint (ppt/pptx)、EPUB、Notebook (ipynb)、Markdown 和純文本。
Agent 工具¶
插件爲 Agent 提供了三個工具：
* doc_list：查看當前待處理的任務列表。
* doc_read：讀取指定文件的內容。
* doc_complete：將處理後的產出註冊回插件系統。
結果側欄¶
處理完成後，對話界面的右側會彈出側欄，顯示任務狀態、摘要以及輸出文件路徑。用戶可以點擊鏈接預覽或下載結果。
安裝與啓用¶
該插件依賴 DSH 的 Web Profile。安裝命令如下：
dsh plugin --profile web add github:Entity-Him/dsh-doc-quick
插件本身是純 JavaScript 實現，不包含原生或 Node-gyp 依賴。PDF 解析會按需加載 pdfjs-dist，如果不可用則能優雅降級。
典型用法¶
- 打開 DSH Web 聊天界面。
- 將需要處理的文檔（如 PDF 或 Markdown）拖入輸入框。
- 向 Agent 發出指令，Agent 會自動識別已掛載的文件並進行讀取和處理。
- 任務完成後，右側側欄會列出輸出內容和文件路徑，支持直接預覽或下載。
適用場景與注意¶
此插件適合需要在 Web 環境下快速處理本地文檔的場景。使用前需確保當前使用的是 DSH Web Profile（側欄是 Web 客戶端 UI）。
- 依賴環境：必須啓用 Web Profile。
- 文件處理：PDF 解析依賴
pdfjs-dist，環境未配置時可能無法解析。 - 許可證：MIT 許可證。
- 生態歸屬：該插件收錄於 DSH 生態目錄，與 DeepSeek / 幻方無官方從屬關係。
總結¶
dsh-doc-quick 將本地文件系統的讀寫能力通過插件形式注入到 DSH Web 聊天中，配合右側側欄展示結果，降低了文檔處理的交互成本。更多細節與源碼可訪問項目主頁查看。
- GitHub 倉庫：https://github.com/Entity-Him/dsh-doc-quick
- 生態目錄：https://www.skillhub.cn/plugins/QinpanWan/dsh-doc-quick
