前言¶
DeepSeek Harness (DSH) 通過插件機制擴展能力。dsh-ruankao-essay 是一個針對軟考系統分析師論文的 DSH 插件，由 Zm886 維護。該插件將題庫索引、寫作規範與 Word 交付流程封裝在一起，解決了手動寫作時需要反覆回憶題目結構、理論要點、字數要求和格式規範的問題。
插件提供三個核心技能和一個 Web 速查面板，支持從查題、寫作、自評到生成 Word 文檔的完整鏈路。
核心功能¶
插件主要包含以下能力：
- 題庫索引與速查：提供 2016—2026 年真題索引、題型理論骨架及寫作規格，支持在 Web UI 面板快速切換查看。
- 10 段式論文寫作與規範：提供標準化的 10 段式結構、字數口徑（含標點 2500~2800）、語氣禁忌及子題目回應規則。
- 逐段自評與改寫建議：通過
ruankao-essay-review技能提供機械項檢查（段數/字數/禁寫項）及逐條改寫建議。 - Word 交付：提供 PowerShell 腳本，將 Markdown 格式的草稿轉換爲 Word 文檔（.doc），並包含段落數與字數統計。
安裝與啓用¶
方式一：Web UI 安裝（推薦）¶
在 DSH Web 側邊欄打開 Plugins（插件） → Add plugin（添加插件），在輸入框粘貼本目錄的絕對路徑：
D:\project\deeepseek\dsh-plugins\dsh-ruankao-essay
DSH 支持通過絕對本地路徑安裝，無需聯網。安裝後，在會話中輸入相關指令即可調用技能。
方式二：Agent 調用安裝¶
Agent 需要插件管理器授權才能操作。可以通過 Agent 調用 plugin_manager 進行安裝：
{ "action": "install_bundle", "target": "D:\\project\\deeepseek\\dsh-plugins\\dsh-ruankao-essay" }
方式三：技能目錄安裝¶
將插件的 assets 目錄內容拷貝到 DSH 的技能根目錄（如 D:\project\deeepseek\.dsh\skills 或用戶目錄下的 .dsh\skills），插件資源即可被自動發現。
使用示例¶
在會話中調用¶
在任意 DSH 會話中輸入以下指令，Agent 會自動加載對應技能：
- 「寫軟考系分論文」
- 「這個論文題目怎麼寫」
生成 Word 文檔¶
使用插件提供的腳本生成 Word 文檔。腳本會剝掉 Markdown 粗體標記並統計真實字數：
& "<skill-directory>\scripts\make-essay-doc.ps1" -MdPath "D:\out\論微服務架構及其應用.md"
輸出示例：
段落數: 10 含標點字數: 2534 純漢字: 2116
已生成: D:\out\論微服務架構及其應用.doc
注意事項¶
- 環境依賴：插件依賴 Node.js 版本 >= 20。
- 重啓生效：修改
index.js或client.js後，需要重啓 DSH 才能加載新的模塊代碼。 - 腳本編碼：
make-essay-doc.ps1等腳本必須保存爲帶 BOM 的 UTF-8 編碼。在 Windows PowerShell 5.1 下，無 BOM 會導致中文被按 ANSI 誤讀，腳本無法正常運行。 - 權限限制：調用
plugin_manager需要 Agent 授權。 - 用途限制：本插件僅供個人備考使用，請勿將倉庫內容用於商業用途。
結語¶
dsh-ruankao-essay 通過將軟考論文的繁瑣流程標準化，降低了手動寫作的認知負擔。對於需要頻繁進行系統分析師論文備考的用戶，該插件提供了一套從查題到交付的閉環解決方案。更多細節可查看插件目錄或 GitHub 倉庫。
