前言¶
DeepSeek Harness (DSH) 采用插件化架构,用户会安装大量的技能与插件。在默认的交互中,管理这些已安装的组件通常需要直接查看文件系统或依赖命令行。这个插件将技能和插件的可视化浏览与管理引入了 DSH 的设置界面。
它解决了组件分散、难以快速识别(特别是使用自定义名称时)以及难以批量管理插件状态(启用/禁用/卸载)的问题。
核心功能¶
技能管理¶
进入“设置 → 仓库”即可查看技能列表。插件会读取 ~/.dsh/skills 下的目录结构,解析 SKILL.md 内容。
* 自定义元数据:支持为技能设置自定义显示名、标签、简介以及 GitHub 仓库链接。
* AI 双语介绍:支持一键生成 AI 生成的介绍,并保存为双语内容(中文 / English)。内容通过特定标记分隔,客户端支持语言切换。
插件管理¶
插件列表读取 profile 的配置,支持对已安装的插件进行操作:
* 启用与禁用:操作会写入 cordis.patch.yml,与官方插件市场的状态保持一致。
* 卸载:会移除 dsh.profile.bundles 中的条目、dependencies 依赖以及 node_modules 中的对应文件。
* 内置插件保护:对于 @deepseek-ai/dsh-* 系列的内置插件,插件禁止执行启用、禁用或卸载操作。
状态管理与别名¶
- 新装提醒:首次出现的技能或插件会在列表和卡片上显示红点,点击确认即可清除。
- 日期维护:支持为每个条目维护安装或更新日期,新条目会自动填入当前日期。
- 输入别名:允许用户使用自定义显示名(别名)来调用 Skill。在输入框输入
/时,候选列表会列出带有别名的 Skill,选中后会自动替换为原始名称调用,不影响 DSH 的 kebab-case 命名规范。
安装与启用¶
使用以下命令安装插件:
dsh plugin --profile web add <your-repo-or-package>
# 本地联调示例:
# dsh plugin --profile web add link:/path/to/dsh-skill-browser
安装后,请重启 DSH。进入 设置 → 仓库 即可看到“技能仓库”与“插件仓库”两个分页。
使用流程¶
- 查看与详情:在技能列表中点击技能名称进入详情页,可以查看 Markdown 正文、文件列表及文件预览。
- 生成 AI 介绍:在技能详情页右上角点击“生成 AI 介绍”,AI 会在会话中生成双语内容并保存。刷新页面后,可通过右上角按钮切换中英文。
- 编辑元数据:在技能或插件卡片上,可以通过“重命名”、“简介”或“GitHub”字段编辑自定义信息。
- 插件管理:在插件仓库中,点击卡片右下角的按钮进行启用、禁用或卸载操作。
- 使用别名:在对话输入框输入
/,在候选列表中找到带有自定义显示名的 Skill 并选中,即可使用别名调用。
技术说明与注意事项¶
- 生效时机:所有的启用、禁用或卸载操作均为“下次启动生效”,UI 上会有相应提示。
- 运行环境:该插件使用 React 渲染,通过注入的方式挂载到“设置 → 仓库”区域,依赖 Node 内置模块,无额外运行时依赖。
- 内置插件限制:严禁尝试修改
@deepseek-ai/dsh-*系列内置插件的状态,系统会拦截相关操作。 - 生态背景:该插件由社区维护,目录与 DeepSeek 官方无隶属关系。
源码与文档¶
- GitHub 仓库:https://github.com/yustillrain/dsh-plugin-tool-repository
- 目录页:https://www.skillhub.cn/plugins/yustillrain/dsh-plugin-tool-repository
注:本文档基于 2026 年 10 月 7 日的版本编写。