前言¶
在 DeepSeek Harness（DSH）裏處理文檔時，常見做法是把內容交給在線轉換服務或讓模型重寫格式，既涉及上傳，又難以固定版式。若只需要把 .md、.docx、.doc 轉成帶統一樣式的 DOCX，並在本地留審計痕跡，更適合用宿主原生插件在機器上完成轉換。下面介紹社區插件 dsh-doc-converter（維護者 bronya19c818，GitHub 星標 0，包版本 0.1.10，MIT 許可）：全程不調用模型、文檔不上傳，樣式按不可變版本保存。
這是什麼¶
dsh-doc-converter 是 DSH 原生插件，在本地完成 Markdown、DOCX、DOC 到 DOCX 的轉換；樣式預設分角色配置（標題、正文、表格、圖片、頁邊距等），保存時生成新版本，舊版本仍可追溯。側邊欄「文檔轉換」頁面與 doc_converter 工具調用共用同一套後端。
核心功能¶
資料中明確的能力如下。
- 導入與輸出：支持
.md、.markdown、.docx、.doc；選定樣式預設後生成 DOCX 供下載，併產出規範化報告與樣式快照，便於複覈。 - 樣式管理：預設按角色設置；
list_styles、create_style、revise_style、delete_style等可選動作與頁面邏輯一致；可從舊數據目錄一次性遷移，身份、版本與原始字段不變（migrate_styles）。 - Markdown 處理：標題層級由後端統一判定；
*、^等與算式可能衝突的符號按上下文評分決定是否作爲強調或上標，判定結果寫入報告。 - DOCX / DOC 路徑：DOCX 直接走 OOXML 規範化，不重建內容；僅顯式指定時才走 Markdown 重建。DOC 轉換依賴 LibreOffice；Markdown 與 DOC 轉換依賴 Pandoc。只轉換 DOCX 時不需要外部程序。
- 環境與依賴探測：可選
dependencies動作；頁面「轉換環境」會顯示 Python、Pandoc、LibreOffice 的探測結果。
運行條件¶
- 操作系統：Windows（README 寫明）。
- DSH：
engines.dsh要求>=0.2.1-rc.5；插件面向 web profile（dsh.client.platform爲web）。 - Python：3.12 或更新，用於插件自有轉換進程；插件在數據根下建私有
venv，不與系統 Python 混用。 - 外部工具：Pandoc（Markdown、DOC）；LibreOffice（僅 DOC）。由插件在執行端探測並調用，包內不分發。
安裝與啓用¶
在 DSH 中執行官方安裝命令（來自 README，勿自行拼接 GitHub 路徑）：
dsh plugin --profile web add dsh-doc-converter
安裝後重啓 DSH，側邊欄會出現「文檔轉換」。
首次使用：準備私有 Python 環境
用包內準備腳本執行一次（路徑中的 <DSH_HOME> 替換爲實際 DSH 主目錄）：
node <DSH_HOME>/profiles/web/node_modules/dsh-doc-converter/scripts/setup-python.mjs \
--python <Python 3.12+ 可執行文件絕對路徑> \
--data-root <DSH_HOME>/storages/dsh-doc-converter
依賴版本來自包內 python/requirements.txt 的鎖定列表。也可在 Host 配置裏顯式提供 pythonPath 和 dataRoot，此時使用執行端的絕對路徑。
典型用法¶
頁面：選文件、選預設、開始轉換；任務在後臺運行，切換頁面後仍可查看進度與結果；完成後下載 DOCX，其餘產物在「其他產物」中查看。
工具調用（與頁面一致的序列）：
import_file -> convert -> get_job（直到 completed/failed）-> artifact
可選動作還包括：dependencies、list_styles、create_style、revise_style、delete_style、migrate_styles。
數據位置¶
默認數據根爲 $DSH_HOME/storages/dsh-doc-converter：
jobs/<id>/source/：原始輸入副本，不覆蓋上傳文件jobs/<id>/：正式產物與審計文件style-packs/<id>/<version>.json：不可變樣式版本
同一數據根只由一個工作進程寫入。
適用場景與注意¶
適合：需要在 Windows 上的 DSH web 環境中本地批量或單次產出統一版式 DOCX、並保留規範化報告與樣式快照的開發者或團隊。
務必注意：
- 插件以當前 DSH 進程權限運行，安裝前應自行查看 GitHub 倉庫 源碼與 MIT 許可及
THIRD_PARTY_NOTICES.txt。 - 非 Windows 或未安裝 Pandoc / LibreOffice（當需要對應格式時）會導致相應轉換路徑不可用；僅 DOCX 輸入時無此外部依賴要求。
- 社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
經過上面的步驟，可以在 DSH 內完成不經過模型的文檔轉換，並把樣式版本與審計產物留在本地存儲。進一步瞭解可訪問插件目錄頁與源碼倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/bronya19c818/dsh-doc-converter
- GitHub：https://github.com/bronya19c818/dsh-doc-converter
