前言¶
在 DeepSeek Harness（DSH）裏做文檔類任務時，常見情況是：工作區裏已有 Word、PDF、表格或 Markdown，需要轉成另一種格式給 Agent 讀、給同事下載，或寫回倉庫。若離開 Harness 用桌面軟件手工轉換，路徑和權限與工作區不一致，Agent 也不方便參與。社區插件 dsh-doc-convert（維護者 zsy334）把轉換收進同一工作區：側邊欄面板可上傳或選文件，對話裏也可通過 convert_document 工具讓 Agent 直接轉換並寫回。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-doc-convert 是 DSH 的客戶端（Web）插件，在 Harness 工作區面板或 convert_document 工具中轉換 Word、PDF、Markdown、HTML、TXT、Excel/CSV 與 PowerPoint 等常用格式。兩個入口共用同一套轉換服務：面板適合人工拖選文件並下載結果；工具適合在對話裏指定路徑與目標格式，由 Agent 完成轉換。
插件源碼與說明見 GitHub：zsy334/dsh-doc-convert，社區目錄頁：skillhub.cn/plugins/zsy334/dsh-doc-convert。DSH 生態強調「一切皆插件」；SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
核心功能¶
兩個入口¶
- 側邊欄「文檔轉換」面板：從本機拖入或選擇文件上傳，或瀏覽工作區已有文件，選定目標格式後轉換並下載。
convert_document對話工具：傳入工作區內的輸入路徑與目標格式，轉換結果默認寫在源文件同目錄。
格式支持（以插件內支持矩陣爲準）¶
Office 與 PDF 版式類轉換由隨插件安裝的 LibreOffice Kit（@deepseek-ai/libreoffice-kit）完成；Markdown、HTML、TXT 與部分表格管線由 JS 實現。下表摘自項目 README，完整規則以倉庫內 lib/formats.js 爲準。
| 源格式 | 可轉目標 |
|---|---|
| docx | pdf、html、md、txt、odt |
| doc（Word 97-2003） | docx、pdf、html、md、txt、odt |
| odt | docx、pdf、html、md、txt |
| txt | docx、pdf、html、md |
| md | html、docx、pdf、txt |
| html | md、docx、pdf、txt |
| txt、md（僅文本抽取） | |
| xlsx / xls / ods | csv、pdf、ods/xlsx、html、json |
| csv | xlsx、pdf、html、json |
| tsv | csv、xlsx、json |
| pptx / ppt / odp | pdf、pptx/odp |
說明要點：
- PDF 只做文本或 Markdown 抽取，不做 PDF→Word/PPT 的版面重建；掃描件需 OCR，當前版本不支持。
- 多工作表導出 CSV 時需填寫準確的工作表名（面板有輸入框；工具使用
sheet參數）。 - 輸出默認與源文件同目錄；重名時自動加
-1、-2等後綴；所有寫入限制在工作區內。
運行依賴¶
- Node.js：
>=22.19.0 - DSH：
>=0.2.1-rc.1 <0.3.0-0 - 插件版本（package.json）：
0.1.0，許可證 MIT
安裝與啓用¶
安裝面向 Web 配置檔（--profile web）。首次安裝會下載約 160MB 的 LibreOffice Kit 引擎；Linux 若無原生引擎包，會使用 WASM 版本。
dsh plugin --profile web add dsh-doc-convert
# 或直接從 GitHub 安裝：
dsh plugin --profile web add github:zsy334/dsh-doc-convert
插件以當前 DSH 進程權限運行。安裝前建議瀏覽倉庫源碼與 LICENSE，確認符合你的安全與合規要求。
典型用法¶
面板¶
點擊左側欄的「文檔轉換」圖標，選擇工作區與文件，再選目標格式，完成轉換後可下載結果。
convert_document 工具¶
在對話中讓 Agent 調用工具，參數示例：
{ "input_path": "docs/report.md", "target_format": "pdf" }
input_path 爲工作區相對路徑；target_format 須在該源格式支持的目標列表中。Excel 等多表場景按需補充 sheet 等工作表名參數。
適用場景與注意¶
適合：在 Harness 內統一處理交付物格式（如 md→pdf、docx→md 供 Agent 閱讀、csv↔xlsx 數據交換、pptx→pdf 預覽）；希望 Agent 在任務鏈裏自動轉換並寫回同目錄文件。
注意：
- 不要指望 PDF 轉回可編輯 Office 版式；複雜掃描 PDF 需另備 OCR 流程。
- 轉換大文件或首次拉起 LibreOffice Kit 可能耗時，與機器與 WASM/原生引擎環境有關。
- 維護與問題反饋可走 GitHub Issues。
結尾¶
dsh-doc-convert 把常用文檔格式轉換放進 DSH 工作區，面板與 convert_document 共用同一服務，輸出受工作區邊界約束，便於人與 Agent 協作。如需安裝說明與支持矩陣的最新變更，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/zsy334/dsh-doc-convert
- GitHub：https://github.com/zsy334/dsh-doc-convert
