前言¶

使用 DSH 做本地工具链时，常见需求不只是执行一条安装命令，而是要持续发现社区插件、Skill、客户端 UI 与开发资源，并判断本机是否已安装、是否可更新、是否可卸载。直接搜索 GitHub、npm 或社区目录，容易把“资源发现”和“本机安装状态”分开处理。

下面介绍一个 DSH 社区插件面板：它在 DeepSeek Harness Web GUI 中提供入口，把浏览、搜索、收藏、已安装管理和官方 dsh plugin 安装命令放在同一个界面里。

需要说明的是，DSH 社区生态强调“一切皆插件”。这个面板属于社区插件面板，不是 DeepSeek 或幻方官方应用商店；社区目录与 DeepSeek / 幻方无官方从属关系。

这是什么¶

dsh-plugin-panel 是一个 DSH 社区插件市场面板，仓库安装来源为 Dylan37670/dsh-plugin-panel，维护者为 Dylan37670。

它在 DeepSeek Harness Web GUI 的侧边栏底部提供入口，点击后打开右侧抽屉。用户可以在抽屉中浏览和搜索社区插件、Skill、客户端 UI 与开发资源，查看中文描述、收藏条目、确认已安装状态，并通过官方 dsh plugin 命令完成安装、更新或卸载。

核心功能¶

入口与目录源¶

下面介绍面板的基本入口和目录来源。

• 侧边栏底部提供入口。
• 点击入口后打开右侧抽屉。
• 提供「精选 / 全部」双目录源。
• 支持目录缓存与手动刷新。
• 分类包括：插件 / Skill / 客户端 / 开发资源，并显示计数。

搜索、排序与中文翻译¶

面板支持以下浏览能力：

• 中英文关键词搜索。
• 排序方式包括：默认 / 星标最多 / 星标最少 / 名称 A-Z / 名称 Z-A / 最新创建 / 最早创建。
• 排序选择会持久化到设置。
• 描述中文翻译：精选条目内置人工翻译。
• 支持一键切换「中文 / EN」。
• 支持按需翻译与回退。

收藏、已安装与操作记录¶

面板会把本机状态保存在本地：

• 收藏管理持久化于 ~/.dsh/plugin-panel/state.json。
• 可筛选“只看收藏”。
• 已安装管理会读取 profile 的依赖、bundle 列表、cordis.patch.yml 用户层注册以及 ~/.dsh/skills。
• 操作记录最多保存 100 条，位于 ~/.dsh/plugin-panel/operations.json。
• 操作记录不保存命令原始输出或 API Key。

安装、更新与卸载¶

面板的安装、更新、卸载动作不直接执行任意命令，而是转发到官方 dsh plugin 命令。资料中给出的生命周期命令形式为：

dsh plugin --profile <profile> add|remove <spec>

执行前会经过以下步骤：

1. 按钮两段式确认，即需要再次点击才执行。
2. 操作前备份 profile 相关文件到：

~/.dsh/plugin-panel/backups/<时间戳>/

备份文件包括：

package.json
cordis.patch.yml
pnpm-lock.yaml

3. 调用官方 dsh plugin 命令。
4. 进行结果校验。
5. 失败时自动恢复备份。

安装来源为目录中列出的仓库 / npm 包；面板不执行任意命令，只转发到官方 dsh plugin。

语义搜索¶

面板提供语义搜索，用于在关键词搜索之外做向量语义检索。

基本配置如下：

• 搜索框右侧有「语义搜索」勾选框。
• 设置区有「嵌入模型（语义搜索）」。
• 需要配置 API Key，必填。
• 模型默认为 BAAI/bge-m3。
• API 地址默认为：

https://api.siliconflow.cn/v1

配置完成后，可点击「建立向量索引」。向量索引会缓存到：

~/.dsh/plugin-panel/vectors.json

关于 API Key 的本地保存，资料中明确：

• API Key 仅在明确点击“保存嵌入设置”后写入本地：

~/.dsh/plugin-panel/state.json

• 请求直达配置的 embeddings 端点，默认是硅基流动。
• 面板不记录 Key。

环境自检与面板自更新¶

面板还提供两类维护能力：

• 环境自检：显示 dsh CLI / pnpm 是否可用；pnpm 缺失时一键安装。
• 面板自更新：版本检查、更新面板按钮、重启提醒。
• 面板自更新遇到网络 / GitHub / pnpm 拉取类临时失败时自动重试一次。
• 失败记录保留安全错误类别，不保存原始命令输出、API Key 或令牌。

作者、教程与反馈¶

面板设置区提供作者 / 教程 / 反馈入口。资料中说明会提供抖音与 B 站主页链接，但未在所给事实中列出具体 URL，因此本文不写具体链接。

安全边界¶

面板在本地 DSH 环境中运行，会读取本机 profile、依赖、bundle、Skill 状态，并调用本机 dsh plugin 命令。资料中给出的安全边界包括：

• HTTP API 仅接受 loopback 请求。
• 安装来源为目录中列出的仓库 / npm 包。
• 不执行任意命令，只转发到官方 dsh plugin。
• 操作记录不保存命令原始输出或 API Key。
• 面板不记录语义搜索的 API Key。

安装与启用¶

从 GitHub 安装¶

在已安装 DSH CLI 的环境中，使用资料给出的官方插件命令安装：

dsh plugin --profile web add github:Dylan37670/dsh-plugin-panel

这条命令会把仓库安装到 web profile。

安装或更新后，需要重启 DSH Web GUI。重启后，侧边栏底部会出现“插件面板”。

从源码挂载¶

如果是开发者从源码构建，资料给出的步骤如下：

git clone https://github.com/Dylan37670/dsh-plugin-panel.git
cd dsh-plugin-panel
npm install
npm run build && npm test
dsh plugin --profile web add .
dsh --profile web --dump-config | grep plugin-panel-market

前四步用于克隆仓库、安装依赖、构建并运行测试。dsh plugin --profile web add . 用于把本地源码挂载到 web profile。最后一条命令用于检查配置中是否出现 plugin-panel-market。

重启要求¶

安装或卸载后，需要重启 GUI 才会加载或卸载插件本体。这是 DSH 的 bundle 机制要求。

在重启前，面板自身仍可继续浏览。

典型用法¶

浏览与筛选¶

先做以下操作：

1. 重启 DSH Web GUI。
2. 点击侧边栏底部的“插件面板”。
3. 在右侧抽屉中切换「精选 / 全部」目录源。
4. 选择分类：插件 / Skill / 客户端 / 开发资源。
5. 输入中英文关键词搜索。
6. 选择排序方式，例如名称 A-Z、最新创建、最早创建。
7. 收藏感兴趣的条目，并切换“只看收藏”。

使用语义搜索¶

如果需要语义检索，按下面步骤配置：

1. 找到搜索框右侧的「语义搜索」勾选框。
2. 打开设置区中的「嵌入模型（语义搜索）」。
3. 填写 API Key。
4. 保持或修改模型，默认为 BAAI/bge-m3。
5. 保持或修改 API 地址，默认为：

https://api.siliconflow.cn/v1

6. 点击「建立向量索引」。
7. 等待本地生成并缓存：

~/.dsh/plugin-panel/vectors.json

之后输入搜索词，面板会进行向量语义检索。

安装、更新或卸载一个条目¶

在面板中点击目标条目的安装、更新或卸载按钮后，会先进入两段式确认。确认后，面板会执行以下流程：

1. 备份当前 profile 的关键文件：

package.json
cordis.patch.yml
pnpm-lock.yaml

备份位置为：

~/.dsh/plugin-panel/backups/<时间戳>/

2. 转发到官方 dsh plugin 命令。资料中给出的命令形式为：

dsh plugin --profile <profile> add|remove <spec>

3. 校验结果。
4. 如果失败，自动恢复备份。

维护者重建目录¶

如果维护目录数据，资料给出的命令如下：

npm run build
node scripts/build-catalog.mjs --reset
node scripts/validate-catalog.mjs catalog/catalog.json
GITHUB_TOKEN=<token> node scripts/build-catalog.mjs

第一条先执行构建。第二条用于全量重建目录数据。第三条用于校验生成的 catalog/catalog.json。最后一条带 GITHUB_TOKEN 的命令用于在已提供 token 的情况下执行目录构建。

适用场景与注意¶

适合谁用¶

这个面板适合以下使用场景：

• 使用 DSH Web GUI，希望在一个界面内浏览社区插件、Skill、客户端 UI 与开发资源。
• 需要中英文关键词搜索，或需要语义搜索。
• 需要收藏常用条目，并查看本机已安装状态。
• 希望通过官方 dsh plugin 命令完成安装、更新或卸载，而不是手动复制多条命令。
• 需要查看 dsh CLI 与 pnpm 的本地环境状态。

安装前注意¶

下面这些注意事项来自资料或通用安全要求：

• 面板在本地 DSH 环境中运行，会访问当前 profile、依赖、bundle、Skill 状态，并调用本机 dsh plugin 命令。安装前应检查源码、目录来源和许可证。
• 资料中未明确具体许可证类型；使用前请自行查看仓库中的许可证信息并确认。
• 所给资料中版本编号表述不完全一致，例如出现 v6.16、0.6.16、v0.6.16 等表述。本文不写具体版本号；安装或更新前请以仓库当前信息为准。
• 安装或卸载后需要重启 DSH Web GUI，插件本体才会加载或卸载。
• 面板 HTTP API 仅接受 loopback 请求。
• 操作记录最多 100 条，不保存命令原始输出或 API Key。
• 语义搜索的 API Key 只在明确保存后写入本地，并且面板不记录 Key。
• 社区目录是独立社区资源，不是 DeepSeek 或幻方官方应用商店。

结尾¶

dsh-plugin-panel 的价值，是把社区资源浏览、中文检索、收藏、已安装状态和本地 dsh plugin 生命周期放在同一个 Web GUI 抽屉里。它没有绕过官方插件命令，而是把发现、确认、备份、执行和回滚串成一个可检查的流程。

GitHub 仓库：

https://github.com/Dylan37670/dsh-plugin-panel

社区目录页 URL 未在所给事实中明确列出，因此本文不写具体目录页地址。