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
