前言¶
DeepSeek Harness（DSH）採用插件化架構，通過擴展組件來豐富功能。在處理非文本文件（如 PDF、Word、Excel 等）時，大模型往往難以直接理解。dsh-tool-markitdown 插件通過 Microsoft MarkItDown 引擎，將文件在本地轉換爲 Markdown 格式，使大模型可以直接閱讀和處理。
安裝¶
在安裝插件前，需先滿足環境依賴：安裝 Python 3.9+，並安裝 MarkItDown 庫。
0. 安裝 MarkItDown¶
pip install "markitdown[all]"
安裝完成後，可通過 python -m markitdown --version 驗證版本號。
1. 安裝插件¶
在 DSH Web 環境中，使用以下命令安裝插件：
dsh plugin --profile web add dsh-tool-markitdown
2. 安裝插件依賴¶
插件是獨立目錄，DSH 加載器會按插件路徑解析依賴。安裝插件代碼後，需在插件目錄內安裝運行時依賴（schemastery）：
cd dsh-tool-markitdown
pnpm install # 或 npm install
使用¶
插件提供多種方式將文件轉換爲 Markdown。
輸入框一鍵轉換¶
點擊輸入框工具欄的 📄 按鈕，選擇文件。MarkItDown 會立即轉換並在輸入框插入 Markdown 內容（帶註釋頭），發送前可編輯。
拖拽與自動轉換¶
從右側文件面板將文件拖拽到輸入框，發送時插件會自動識別該行文件路徑（如 docs/報告.pdf），將其轉換爲 Markdown 後再發送。
模型側工具調用¶
在對話中，若用戶提及本地路徑、HTTP(S) 鏈接或上傳後的 attachmentId，模型會自動調用 markitdown 工具進行轉換後再閱讀。
超長內容處理¶
默認單次返回 120,000 字符。超出時內容會被截斷，並在結尾給出 attachmentId。模型可通過該 ID 調用接口獲取完整內容。
配置與注意事項¶
可視化配置¶
在「設置 > 插件配置 > markitdown」中，可調整 Python 命令、文件大小上限、輸出字符上限、超時時間以及發送時自動轉換開關。
注意事項¶
- 本地執行：轉換在本地執行，不消耗 API 額度。
- 原文件安全：磁盤上的原文件爲只讀狀態，不會被修改或刪除。上傳的臨時副本在轉換完成後會立即清理。
- 圖片處理：默認不轉換圖片，圖片仍優先走視覺識別。若需 OCR，需使用模型調用
markitdown工具處理圖片路徑。 - 依賴要求：轉換功能依賴 Python 3.9+ 和 markitdown 庫。
