前言¶
DeepSeek Harness（DSH）支持插件擴展能力，用於豐富模型的工具集。在處理系統設計、架構文檔等任務時，模型有時僅憑自身記憶給出泛泛而談的建議。dsh-arch-advisor 插件旨在解決這個問題，它通過實時訪問開源知識庫，爲模型提供架構設計的具體方法、模板和案例，引導設計併產出符合規範的文檔。
該插件由 LeeGuanWei-a 維護，核心價值在於讓模型在對話中能夠“查閱”架構書，而非僅憑印象回答。
核心功能¶
插件提供 7 個 arch_* 工具，分爲查閱、設計、文檔三個組別，覆蓋從知識檢索到落地的完整流程。
查閱組：檢索與閱讀¶
arch_roadmap：提供知識庫總覽與學習路徑，包含教程六階段、模板分類與案例索引。arch_search：支持中英文關鍵詞檢索，匹配標題、主題或代表產品。arch_read：讀取知識庫中的具體內容，提供目錄與開頭預覽，支持中英文切換，可獲取全文。
設計組：引導與映射¶
arch_ask：輸入想法後，自動映射到最相關的教程、模板和案例，抓取摘錄並給出建議路線。arch_design：分步引導式設計，引導需求澄清、約束/質量屬性定義、結構設計、關鍵決策 ADR（架構決策記錄）、演進路線及生產級審查。
文檔組：規範與版本¶
arch_docs：提供開發文檔規範，包含需求（PRD）、概要（HLD）、詳細（LLD）、數據庫（DBD）、架構（Arch）的章節骨架及完成標準清單。arch_version：提供開發文檔版本管理規範，約定當前版與歷史歸檔的存儲方式。
安裝與啓用¶
插件以 Host 常駐插件的形式安裝，安裝後重啓生效。
# GitHub 直裝
dsh plugin --profile web add github:LeeGuanWei-a/dsh-arch-advisor
安裝完成後，重啓 DSH 或刷新會話即可使用。驗證插件是否加載成功的命令：
dsh plugin --profile web list
使用與觸發¶
插件通過注入的觸發規則驅動工具調用，使用者無需記憶具體工具名，只需按照自然語言描述需求。
典型流程¶
- 定位與精讀：提出需求後，模型會自動調用
arch_ask定位案例，並調用arch_read精讀相關內容。 - 設計引導：進入
arch_design階段，分步澄清需求、定義結構、輸出 ADR。 - 文檔產出：最後調用
arch_docs生成文檔骨架，並使用arch_version進行版本歸檔。
觸發規則¶
- 方案設計：當對話中出現“想一個方案”、“設計一個系統”等意圖時，模型會先調用
arch_ask映射知識庫，再調用arch_design進行分步引導。 - 文檔生成：當對話中出現“生成文檔”、“生成說明書”等意圖時，模型會調用
arch_docs獲取規範，並調用arch_version進行版本管理。
技術實現與約束¶
- 運行機制：插件基於 cordis 4 體系編寫，屬於 Host 常駐插件，內容在運行時從 GitHub 拉取，插件包體積爲零。
- 網絡要求：必須聯網才能從 GitHub 拉取知識庫內容。不聯網時，目錄和學習路徑仍可用，但正文讀取會提示網絡不可達。
- 版本要求：最低支持 dsh 0.1.2-rc.1。
- 文檔結構：插件約定了固定的文檔目錄結構，包括
docs/（當前版）和docs/archive/（歷史版本快照）。
總結¶
該插件通過封裝開源知識庫，將架構設計的理論、模板與案例引入 DSH 對話流。它不包含上游內容，僅作爲對話封裝工具，幫助開發者更系統地完成從方案設計到文檔落地的過程。
- 插件主頁：https://www.skillhub.cn/plugins/LeeGuanWei-a/dsh-arch-advisor
- 源碼地址：https://github.com/LeeGuanWei-a/dsh-arch-advisor
