DeepSeek Harness (DSH) 插件生態中,dsh-arch-advisor 負責在運行時拉取架構知識庫。與之對應的離線版本 dsh-arch-advisor-offline 將這些知識打包進插件本體。它依賴 awesome-architecture 開源知識庫(教程、模板、案例,中英雙語),在運行時不需要任何網絡訪問。適合完全斷網或對網絡訪問有嚴格限制的環境。
安裝與啓用¶
使用官方命令安裝該插件:
dsh plugin --profile web add github:LeeGuanWei-a/dsh-arch-advisor-offline
安裝完成後重啓 DSH 會話即可使用。工具名均帶有 _offline 後綴,確保其可與在線版工具共存。
核心功能¶
插件內置 7 個工具,提供從知識檢索到架構設計的完整能力:
arch_roadmap_offline:提供知識庫總覽與學習路徑。arch_search_offline:支持目錄關鍵詞檢索。arch_read_offline:讀取特定內容,支持目錄預覽、全文閱讀以及中英文切換。arch_ask_offline:將用戶的想法映射到相關的教程、模板和案例。arch_design_offline:提供分步引導式的架構設計流程。arch_docs_offline:生成開發文檔規範(如架構、PRD、HLD、LLD、DBD)。arch_version_offline:管理文檔版本規範。
典型用法¶
在對話中,插件會根據指令自動調用上述工具。常見的交互邏輯如下:
- 如果需要設計方案或思路:先通過
arch_ask_offline將想法映射到知識庫中的教程、模板或案例,再根據需要使用arch_design_offline進行分步設計。 - 如果需要生成文檔:使用
arch_docs_offline獲取文檔骨架,並配合arch_version_offline進行版本管理。 - 在斷網環境下,直接詢問架構相關問題,工具仍能正常響應。
內容與更新¶
插件內容來源於 MIT 許可的開源知識庫 awesome-architecture,包含 40 篇教程、31 個模板、6 個案例(中英雙語)。
內容在打包時被固定,運行時零網絡依賴。當上遊內容更新後,需要重新安裝或更新插件以獲取最新快照。
系統要求¶
安裝前請確保環境滿足以下條件:
- 需要運行
@deepseek-ai/cordis版本 4.0.1 或更高。
總結¶
dsh-arch-advisor-offline 適合需要穩定、離線架構諮詢能力的場景。它通過將知識庫打包進插件,解決了運行時網絡依賴問題,並且工具名設計使得其可以與在線版共存。
- 作者:LeeGuanWei-a
- 許可證:MIT
- 源碼:GitHub