DeepSeek Harness（DSH）的核心理念是“一切皆插件”。在利用大模型撰寫技術文檔時，常見痛點是內容可能存在事實偏差（幻覺）、術語不統一或“AI味”過重。docs-mode 是一個爲解決這些問題而設計的 DSH agent preset，它將 Agent 定位爲“技術文檔撰寫專員”，覆蓋 11+ 類技術文書，內置了從調研到交付的全流程工具。
這是什麼¶
這是一個自包含的 DSH agent preset。安裝後，DSH 在該模式下將不再進行通用對話，而是轉爲執行技術文檔的撰寫任務。它內置了“先調研再動筆”的工作準則，強制模型覈實項目真實信息，嚴禁編造細節。
支持的文書類型¶
該模式覆蓋了從開發到交付的全生命週期文檔，每類均內置骨架與風格卡：
| 類別 | 主要面向 |
|---|---|
| 開發概要說明書 | 系統設計、軟著申報配套 |
| 使用說明書 | 最終用戶操作手冊 |
| 彙報/總結材料 | 階段彙報、項目總結 |
| 接口/API 文檔 | 對接開發者的接口契約 |
| 技術評審稿 | 方案/設計評審 |
| 需求規格說明書 (SRS) | 產品需求 |
| 項目計劃書 | 里程碑、分工、風險 |
| 測試報告 | 功能/性能/迴歸測試 |
| 部署運維手冊 | 安裝、配置、升級、故障 |
| 週報/會議紀要 | 輕量彙報與會議記錄 |
| 軟著申請說明書 | 軟著使用說明書 + 開發概要 |
| 英文技術文檔 | 英文通用骨架 (README/Spec/API) |
核心功能¶
1. 模板驅動與自主學習¶
模式內置三種技能：
* doc-template-learning：負責模板驅動寫作。當用戶傳入模板時，系統會先拆解骨架，確認大綱後纔開始撰寫，並將骨架/風格卡保存到工作區。用戶自定義的模板會自動存檔到 ~/.dsh/template-library/<類別>/，每類滿 3 份會自動提煉“共識-骨架”與“共識-風格卡”。
* tech-doc-deai：負責去除“AI 味”。基於規範庫改造高危句式，確保術語統一、準確、簡潔，嚴禁口語化。
* doc-quality：負責質量保障。包含量化體檢（AI 味指數/編號/引號/空話/術語）、多文檔口徑交叉校驗、編號重排、版本同步檢查、PDF 導出及界面截圖自動化。
2. 無模板自主寫作¶
當不提供模板時，模式會按三層優先級自動選型：
1. 工作區 docs/style-cards/（用戶確認版）
2. ~/.dsh/template-library/（自學習共識版）
3. 本包 assets/templates/（內置出廠版）
3. 交付格式靈活¶
支持 Markdown、Word、PDF 三種格式。Word 交付使用 assets/docx-tools/，PDF 交付使用 md_to_html + html_to_pdf 鏈路，軟著源代碼文檔支持按 50 行/頁排版。
安裝與啓用¶
方式一：插件市場安裝（推薦）¶
通過插件管理界面搜索 dsh-docs-mode 安裝，或直接使用命令：
dsh plugin add dsh-docs-mode
方式二：從本地源碼安裝¶
需要將倉庫克隆到本地，並使用絕對路徑安裝：
git clone https://github.com/zh851233/docs-mode
dsh plugin add /絕對路徑/docs-mode
啓用與配置說明¶
- 重啓 DSH：安裝完成後必須重啓 DSH 才能加載新模式。
- 版本兼容性：DSH 0.2 起不再讀取
$DSH_HOME/.agent-presets/<id>/目錄，本插件採用cordis.patch.yml方式聲明，無需手動拷貝文件。 - 舊版本兼容：1.x 版本的安裝器（
lib/index.js）已廢棄，僅供舊版 DSH 使用，不再隨發行包發佈。
典型用法¶
- 按模板寫文書：將模板內容粘貼到對話中，或提供文件路徑，指令“按這個模板寫一份使用說明書”。系統會先出大綱確認，再撰寫，並將確認後的模板保存。
- 無模板寫作：直接指令“寫一份技術評審稿”或“寫一份測試報告”，系統自動匹配內置模板或自學習模板。
- 去除 AI 味：在交付前，系統會詢問是否去除 AI 味，確認後自動應用
tech-doc-deai規範進行改造。 - 選擇交付格式：交付前詢問“導出爲 Word”或“導出爲 PDF”，系統自動處理轉換。
注意事項¶
- 升級舊版本：如果你是從 1.x 升級，請務必清理舊的 preset 目錄，否則在 DSH 0.2+ 中模式將無法加載：
# Windows
rmdir /s /q "%USERPROFILE%\.dsh\.agent-presets\docs"
# Linux/macOS
rm -rf ~/.dsh/.agent-presets/docs
- 權限與安全：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。
- 自定義：如需調整去 AI 味的力度或補充句式，可編輯
skills/tech-doc-deai/tech-doc-deai.md；如需修改人設，可編輯preset/agent.cordis.yml。
總結¶
docs-mode 通過模板庫、去 AI 味工具鏈和質量保障流程，將 DSH 轉變爲一個可落地的技術文檔專員。它適合需要批量生成規範文檔、軟著材料或技術評審稿的開發者與工程師。
- 項目地址：https://github.com/zh851233/docs-mode
- 插件目錄：https://www.skillhub.cn/plugins/zh851233/docs-mode
