在 DeepSeek Harness（DSH）中處理文件時，如果直接將完整內容（如 Excel 或 PDF）輸入模型，會消耗大量 token。dsh-plugin-office-markdown 在模型讀取文件之前，先將其轉換爲 Markdown 格式，從而減少上下文輸入量。
這是什麼¶
這是一個 Bundle 插件，由 Z8906 維護。它解決了在 DSH 中讀取大型 Office 或 PDF 文件時 token 消耗過高的問題。通過在本地將文件轉換爲 Markdown，插件用文件路徑代替了整份全文，既節省了 token，又避免了將敏感內容上傳到雲端。
核心功能¶
- 文件轉換：將 Office / PDF 文件轉成 Markdown。
- 路徑替代：用文件路徑代替整份全文，節省 token。
- 本地運行：本地轉換，不消耗 API 額度。
- 輕量級：0 npm 依賴。
- 所有權：產物歸用戶所有。
- 自動清理：卸載時自動清理 Python 環境。
- 批量支持：支持批量轉換和結構索引。
- 配置界面：內置設置頁，可配置 MarkItDown 環境。
安裝與啓用¶
- 確保你的 Node 版本 ≥ 18。
- 在 DSH 的 設置 → 插件 → 安裝 界面中填入插件名稱並回車。
- 填入以下內容進行安裝：
dsh-plugin-office-markdown
安裝完成後需要重啓 DSH。
典型用法¶
安裝後，可以通過工具調用或自然語言指令使用轉換功能。以下是可用的參數示例：
- 單文件轉換：
read_office_as_markdown({ path: "報表.xlsx" })
- 批量轉換：
read_office_as_markdown({ paths: [...] })
- 僅獲取結構索引（不觸發轉換）：
read_office_as_markdown({ action: "outline" })
- 清理舊產物：
read_office_as_markdown({ action: "clean" })
- 查看轉換器狀態：
read_office_as_markdown({ action: "status" })
調用後，插件會返回轉換後的 .md 文件路徑、體積、行數，以及一份結構索引（章節/工作表/幻燈片的標題與行號），並給出讀取建議。
適用場景與注意¶
- 適用場景：需要處理工作區內的 Office 文檔（.docx, .docm, .xlsx, .xlsm, .pptx, .pptm）或 PDF 文件，且希望減少 token 消耗的場景。
- 依賴要求：需要 Node ≥ 18，插件本身 0 npm 依賴。
- 文件支持：支持新版 Office 格式。.pdf 與舊版二進制格式（.doc, .xls, .ppt）需要 MarkItDown 或 Python 環境支持。
- 卸載行爲：卸載插件會清理它登記過的 Python 環境，這與禁用或關閉插件不同。
- 權限注意：插件以當前 DSH 進程的權限運行，請確保在安裝前檢查源碼與許可證。
總結¶
dsh-plugin-office-markdown 通過本地轉換和路徑引用機制，幫助 DSH 用戶在處理文檔時大幅降低 token 消耗。它支持多種文件格式和批量操作，並提供了內置的設置頁面來管理 MarkItDown 環境。
