前言¶

在 DeepSeek Harness（DSH）裏讓智能體寫 Word，常見做法是每次會話重複說明格式、禁用詞和章節結構，模型也容易在未驗收排版的情況下宣佈完成。手工改 docx 時，LaTeX 公式、模板樣式、表格錯位等問題往往要到導出後才暴露。

下面介紹社區插件 dsh-word-master（維護者 wszw142857-beep，GitHub：wszw142857-beep/dsh-word-master）。它以 agent preset 形式提供一條帶硬停與閘門的流水線：素材轉換 → 規格凍結 → 逐節寫作 → 質檢門 → 審閱界面 → 渲染閘門 → 導出，並把寫作偏好落盤、每輪注入。架構範式學習自 PPT Master（獨立實現，MIT 許可）。插件在 SkillHub 目錄分類爲「工作流」，npm 包當前版本爲 0.2.0。

這是什麼¶

Word Master for DeepSeek Harness 是一套只在選中「Word Master」預設的會話裏生效的工具與 skill：不佔其他會話上下文。它解決的核心問題是：把「素材 → 規範 Word 文檔」做成可續跑、可質檢、可視覺驗收的流程，而不是一次性長文生成。

與「只在對話裏答應格式要求」相比，偏好寫入本地庫並在每次請求注入；與「結構對了但版式沒驗」相比，渲染後還有 PDF/PNG 與視覺判據；與「PDF 素材接不住」相比，word_convert 支持 PDF、Word、Excel、PPT、網頁等轉爲 Markdown 再進入後續步驟。

核心功能¶

流水線階段¶

README 中的階段順序如下（⓪ 爲建項與素材，①–⑨ 爲環境與交付）：

⓪ word_project  建項目 + 收素材
⓪b word_convert 素材轉 Markdown
① word_env      體檢（Python / python-docx / lxml / LibreOffice）
② word_pref     偏好覈對（read / set / memory_text）
   word_template 套模板（可選）
③ word_spec     規格凍結 ← 硬停，等用戶確認
④ 寫 draft.md   逐節寫，遵守已注入的偏好
⑤ word_build    構建 docx
⑥ word_gate     質檢門 ← 硬停，P0 阻斷交付
⑦ word_review   HTML 審閱界面 ← 硬停，等用戶逐段設決定
⑧ word_render   渲染閘門 + word_visual 視覺判據
⑨ word_export   導出 DOCX / PDF

兩個硬停點需要單獨記住：規格凍結前禁止寫正文；質檢 P0 未清（退出碼 3）不能進入審閱，需改到 0 或 4。

工具一覽¶

跨會話續做時，可先跑 word_project validate：推斷階段（empty→draft→frozen→built→reviewed→delivered），並檢查如 gate-p0、stale-gate、spec-not-frozen 等漏步。

偏好記憶¶

本地偏好庫路徑爲 $DSH_HOME/word-master/preferences.json，是唯一事實來源；每輪通過系統提示詞小節注入，不依賴模型「想起來」。用戶說「以後都用小四」之類要求時，必須用 word_pref 的 set 落盤，僅在對話裏答應無效。memory_text 可把偏好渲染成可交給 mnemon_remember 的文本，用於跨機器檔案，與每輪注入分工明確。

審閱界面（word_review）¶

本地 HTML 分欄：左側改 draft.md 正文並逐段設處理方式；右側展示質檢發現、已記錄決定與全局補充。決定寫入 review-notes.json（schemaVersion 2），交接看 review-result.json。審閱服務器有文件鎖、端口避讓（5070 起）、空閒超時（默認 1800 秒）；用完須 word_review action=stop 優雅關閉。

環境與實現要點¶

• Node：>=22（package.json engines）
• Python：3.10+（README badge）；依賴含 python-docx、lxml、LibreOffice 等，由 word_env 體檢
• 公式：Markdown 中的 LaTeX 可轉爲 Word 原生公式；構建時注意中文字體 w:eastAsia、標題樣式等（README「實現筆記」中有說明）

安裝與啓用¶

DSH 生態裏插件通過 profile 安裝；社區目錄頁見 SkillHub：dsh-word-master（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。

推薦從 npm 安裝：

dsh plugin --profile <你的profile> add dsh-word-master

包地址：npm dsh-word-master。

本地調試可用 link（示例路徑以 README 爲準，按本機修改）：

dsh plugin --profile desktop add D:/dsh/plugins/dsh-word-master

裝完後重啓 DSH，新建會話時在預設選擇器裏選 「Word Master」；不選該預設的會話不受影響。

安裝前建議自行查看 GitHub 源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，會讀寫項目目錄、起本地審閱服務，並調用 Python / LibreOffice 等外部程序。

典型用法¶

1、安裝並選預設¶

執行上述 dsh plugin add，重啓後在 Word 相關任務裏選用 Word Master 預設。

2、建項與環境¶

在 agent 引導下依次使用 word_project（init、收素材）、word_convert（如需）、word_env、word_pref / 可選 word_template。

3、凍結規格後再寫正文¶

word_spec 完成 freeze 並確認後，再逐節維護 draft.md，然後 word_build。

4、質檢與審閱¶

# 由 agent 調用 word_gate；P0 時退出碼 3，需修復後重跑

通過門禁後啓動 word_review，在界面中確認段落與全局意圖，stop 服務後繼續。

5、渲染與導出¶

word_render 與 word_visual 完成視覺驗收後，word_export 導出 DOCX / PDF。

偏好變更示例（須在工具中執行，而非僅口頭約定）：

word_pref { action: "set", patch: { formatting: { bodySizePt: 10.5 } } }

維護者提供的自檢：

node verify.mjs

（在插件包根目錄；50 項檢查，含契約、schema、偏好一致性等。）

適用場景與注意¶

適合：需要 repeatable 的長文/報告/論文式 Word；有多源素材（含 PDF）；要單位模板樣式；強調禁用詞、章節結構、半角括號等硬規則；願意在規格凍結與審閱硬停點人工確認的場景。

注意：

• 流程紀律靠 [!CAUTION] 與 BLOCKING 硬停，不是全自動狀態機；跳過 freeze 或 gate 會導致後續返工範圍變大。
• 改 draft.md 後若未重跑 word_gate，validate 可能報 stale-gate。
• 改 profile JSON 時 README 提醒：須用 Node 寫回 UTF-8，避免 PowerShell 5.1 Set-Content -Encoding UTF8 寫入 BOM 導致 Host 啓動失敗。

結尾¶

dsh-word-master 把「素材 → 規範 Word」拆成可驗證的階段，用 preset 隔離上下文、用偏好庫與質檢/渲染閘門約束交付質量。若要安裝或讀完整工具說明，可看目錄頁 SkillHub 與倉庫 GitHub README。