前言¶
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
