dsh-docx-export：在 DeepSeek Harness 中導出真實 Word 文檔

在 DeepSeek Harness (DSH) 的會話中，智能體通常以 Markdown 或文本形式產出內容。直接保存爲 .docx 需要手動轉換或依賴第三方工具。dsh-docx-export 解決了這個問題，它將 DSH 會話中的文本導出爲真正的 Word 文檔，而非重命名的 Markdown 文件。

這是一個客戶端插件，由 Cai-Chengyu 維護，採用 MIT 許可證。它的核心價值在於零運行時依賴（僅依賴 Node.js 內置的 zlib），且不依賴 @deepseek-ai/* 包，因此可以承受 Harness 版本漂移，安裝後作爲插件包掛載，無需額外配置。

核心能力¶

該插件將 Markdown 語法轉換爲 Word 原生支持的 OOXML 結構，支持以下特性：

標題與目錄：Heading 1–6 樣式（模板友好，目錄就緒）。
字符格式：粗體、斜體、刪除線、代碼，支持中日韓（CJK）字體。
列表：真正的多級項目符號和編號列表。
複選框：將 - [x] 轉換爲 ☑，將 - [ ] 轉換爲 ☐。
代碼塊：等寬字體、背景陰影和邊框的代碼區域。
引用：帶有左側邊框的引用樣式。
表格：生成真實的 Word 表格，支持列對齊。
媒體：嵌入圖片（PNG/JPEG/GIF/BMP）和可點擊的外部超鏈接。
文檔屬性：自動填充標題、作者和時間戳。
頁腳：默認包含頁碼。

安裝與啓用¶

安裝插件後需要重啓 DeepSeek Harness，以便新的插件包掛載生效。

通過 npm（推薦）：

    dsh plugin --profile desktop add dsh-docx-export

從 GitHub 安裝：

    dsh plugin --profile desktop add github:Cai-Chengyu/dsh-docx-export

    dsh plugin --profile desktop add G:\path\to\dsh-docx-export
    dsh plugin --profile desktop add .\dsh-docx-export-1.0.0.tgz

如果 dsh 不在系統 PATH 中，請使用 Harness 自帶的 CLI 路徑。安裝完成後，插件會在下次啓動時生效。

典型用法¶

安裝完成後，主要有三種調用方式。

1. 會話對話¶

直接在 DSH 會話中向智能體提問即可。模型會調用 export_docx 工具：

Export what you just wrote as a Word document titled “Q1 analysis”, with a table of contents.

2. JSON 工具調用¶

直接調用 export_docx 工具，傳入 Markdown 內容和配置參數。

{
  "content": "# Title\n\nBody **bold**\n\n| col | value |\n|:--|--:|\n| a | 1 |\n",
  "title": "Q1 analysis",
  "outputPath": "G:\\dsh\\analysis.docx",
  "toc": true,
  "pageSize": "a4"
}

3. 命令行¶

插件自帶 CLI，可在 DSH 外部使用，處理本地 Markdown 文件。

node bin/docx-export.mjs report.md -o report.docx --title "Quarterly report" --toc

配置與注意事項¶

配置¶

在 Harness 的 cordis.patch.yml 中可以覆蓋默認配置：

- id: docx-export
  name: dsh-docx-export
  config:
    toolName: export_docx          # 重命名工具名以避免衝突
    outputDir: "D:/exports"        # 默認輸出目錄（空字符串則爲會話工作目錄）
    fontFamily: Calibri            # 西文字體
    eastAsiaFont: 微軟雅黑          # 中日韓字體
    monoFont: Consolas             # 代碼字體
    fontSize: 11                   # 字號
    pageSize: a4
    toc: false                     # 默認插入目錄
    footer: true                   # 默認包含頁碼
    allowOutsideWorkspace: false    # 是否允許寫入工作目錄外
    allowedRoots: []               # 允許的額外目錄
    maxContentChars: 400000        # 單次導出內容限制

注意事項¶

環境要求：需要 Node.js >= 20，兼容 DSH 0.1.7+。
權限安全：默認情況下，插件僅寫入會話的工作目錄。若需寫入外部路徑，必須在配置中顯式設置 allowOutsideWorkspace 或通過 allowedRoots 指定路徑。圖片嵌入也僅限於允許的範圍內。
版本漂移：由於沒有導入 @deepseek-ai/* 包，插件可以長期在 Harness 的不同版本中運行。

生態與鏈接¶

該插件遵循 DSH 的插件化理念，已發佈至社區目錄，源碼託管於 GitHub。

GitHub 倉庫: https://github.com/Cai-Chengyu/dsh-docx-export
社區目錄: https://www.skillhub.cn/plugins/Cai-Chengyu/dsh-docx-export