dsh 插件是什么？DeepSeek Harness 插件生态全览：dsh plugin 类型、结构与三种获取方式
dsh 插件（DSH plugin）是运行在 DeepSeek Harness 里的扩展组件，以 npm 包分发、挂载在 profile 之下，能为 DSH 增加界面、会话、记忆、工具等能力。整个生态由宿主 DeepSeek Harness、插件市场 DSH Plugin Hub 和 npm / GitHub 上的插件仓库三部分组成——本文把「是什么、有哪些类型、从哪获取、怎么装」一次讲清，并附常见问题排查表。
概览：dsh 插件生态的三个层次
dsh 插件不是孤立存在的，它活在「宿主 + 市场 + 仓库」三层生态里。 理解这三层，就知道插件从哪来、装到哪去（来源）：
| 层次 | 角色 | 典型例子 |
|---|---|---|
| 宿主层 | 提供运行环境与插件加载机制 | DeepSeek Harness（dsh） |
| 市场层 | 人工精选插件、做成应用内插件中心 | DSH Plugin Hub |
| 仓库层 | 插件本体的存放处 | npm registry、GitHub |
三层协作：仓库里放着插件源码与包，市场把它们筛选编排成可浏览的目录，宿主负责把选中的插件装进 profile 并加载。
dsh 插件是什么：给 DSH 加能力的小组件
dsh 插件遵循官方插件开发规范，npm 包分发，装进 profile 后由宿主加载。 与 DeepSeek Harness 的关系是「宿主 + 插件」：DSH 提供底座，插件扩展能力。一个插件通常包含（来源）：
- 插件入口：声明入口文件与依赖；
- 能力实现：界面组件、工具调用、会话逻辑等；
- profile 挂载：安装时写入当前 profile 的依赖，宿主启动时加载。
工作流程：写代码 → 打包成 npm 包 → 发布到 npm / GitHub → 用户用 dsh plugin add 装进 profile → 宿主启动加载 → 界面出现新能力。装上插件后，重启 dsh web 并刷新页面即可看到新能力；卸载则从 profile 移除依赖。
dsh 插件有哪些类型：四类为主、标签细分
按功能划分，dsh 插件主要分四类，市场里还有更细的主题标签。 常见分类（来源）：
| 类型 | 干什么 | 典型场景 | 例子方向 |
|---|---|---|---|
| 界面与体验 | 改造 DSH 界面与交互 | 插件中心、状态栏增强 | 侧边栏工具、主题增强 |
| 会话与消息 | 增强对话能力 | 聊天增强、消息处理 | 快捷指令、消息格式化 |
| 记忆与上下文 | 提供长期记忆 | 记忆插件、上下文管理 | 会话记忆、知识注入 |
| 工具能力 | 接外部工具 | 联网搜索、文件处理 | 搜索插件、文档处理 |
插件市场浏览时可按分类筛选，每张卡片带主题标签、已验证徽章与 Star/Fork，帮助你判断哪个类型适合自己。
从哪里获取 dsh 插件：三条渠道
获取插件有三条路：市场一键装、命令装 npm 包、命令装 GitHub 源码。 各渠道展开：
渠道一：插件市场一键安装（推荐）
装好市场插件后，全程点按钮，不用记命令，人工审核来源更稳。 操作步骤：
- 先安装 DSH Plugin Hub 市场插件（见下文「装第一个插件」）；
- 打开 DeepSeek Harness Web UI → 设置 → 插件中心；
- 搜索或按分类浏览，找到目标插件；
- 点卡片上的安装，在确认弹窗核对插件名、来源仓库与将执行的命令；
- 确认后自动安装，进度完成后刷新页面生效。
渠道二：npm 包命令安装
知道包名就能装，来源可溯、依赖自动处理。 操作步骤：
# 从 npm registry 拉取指定包名的插件
dsh plugin --profile web add <包名>
包名拼错会提示 404，可用 npm view <包名> 提前确认存在；配置过 npm 镜像会自动生效。
渠道三：GitHub 源码命令安装
市场没收录、或想追源码的插件用仓库地址。 操作步骤：
# github: 前缀 + owner/repo
dsh plugin --profile web add github:owner/repo
前置条件是本机能访问 GitHub（网络受限时需配置代理）；个别仓库缺构建产物时可能装完不生效，改装 npm 版或反馈作者。
装第一个插件：三分钟上手
从零到装好第一个插件，四步走。 操作步骤：
- 启动 DSH：执行
npx @deepseek-ai/dsh web，完成 web profile 初始化； - 安装插件市场：
dsh plugin --profile web add dsh-plugin； - 重启 dsh web，打开设置 → 插件中心；
- 选一个插件点安装，确认后等待完成，刷新页面生效。
装完后，插件中心顶部导航的已安装数量会 +1，插件生态的第一站就打通了。
装不上或用了有问题？常见问题与解决
插件相关的问题，先看是「装不上」还是「用不了」，再对症处理。 常见问题清单：
| 问题 | 可能原因 | 解决办法 |
|---|---|---|
dsh: command not found | 未全局安装、npx 缓存问题 | 用 npx @deepseek-ai/dsh 前缀执行，或 npm install -g @deepseek-ai/dsh |
| 安装报 404 | 包名拼错、镜像源滞后 | npm view <包名> 确认存在，切换 npm 镜像重试 |
| 安装超时 | 网络慢、GitHub 访问受限 | 换 npm 镜像；GitHub 源配置代理 |
| 装完不生效 | 没重启、装错 profile | 重启 dsh web 并刷新；核对 --profile 与环境一致 |
| 装完宿主报错 | git 源缺构建产物 | 改装 npm 版，或在 DSH Plugin Hub 安装 |
| 不知道装什么 | 插件太多无从下手 | 按分类筛选 + 看 Star/验证徽章，从人气高的开始 |
| 卸载后想找回 | 已移除依赖 | 重新用原渠道再装一次即可 |
| 版本不兼容 | 插件与本版 DSH 不匹配 | 更新插件到新版本，或固定 DSH 版本 |
总结速查
一句话：dsh 插件 = 装在 DeepSeek Harness 里的扩展组件，生态是「宿主 + 市场 + 仓库」三层，获取走「市场一键 / npm 命令 / GitHub 命令」三条渠道。 四个提醒：
- 来源优先市场：人工审核过的插件更稳，来源不明的 GitHub 仓库安装前要核对确认弹窗；
- 装进 profile：插件按 profile 隔离，
--profile web装的就是 web 环境专用； - 随时可卸：不想要了在已安装列表点卸载即可，不影响
$DSH_HOME下的数据； - 装完重启验证：重启 dsh web 并刷新，插件新能力才会出现。
来源：dshplugin/dsh-plugin-hub、dsh CLI README、dsh-plugin.org 插件中心
常见问题
dsh 插件（DSH plugin）是给 DeepSeek Harness（DSH）增加能力的扩展组件，按官方插件规范开发，通过 npm 包分发。装上后可以给 DSH 加界面功能、会话能力、记忆与上下文、工具调用等新特性。
三部分：一是宿主 DeepSeek Harness（提供运行环境）；二是插件市场 DSH Plugin Hub（人工精选、每日更新的目录）；三是 npm 与 GitHub 上大量插件仓库，用 dsh plugin add 命令安装。
按功能分主要有四类：界面与体验（改 UI）、会话与消息（增强对话）、记忆与上下文（长期记忆）、工具能力（联网搜索、文件处理等）；市场里还细分出更多主题标签，浏览时可分类筛选。
三条渠道：插件市场一键安装最省事；知道包名直接 dsh plugin --profile web add <包名> 从 npm 安装；或用 github:owner/repo 从 GitHub 源码安装。市场渠道有人工审核，来源更稳。
先跑通 DSH 本体（npx @deepseek-ai/dsh web 启动一次），再装插件市场：dsh plugin --profile web add dsh-plugin，重启后在设置 → 插件中心里挑一个已收录插件点安装即可。
来源
- dshplugin/dsh-plugin-hub GitHub 仓库· GitHub
- dsh CLI README· deepseek-ai
- dsh-plugin.org 插件中心· dsh-plugin.org