dsh-skill-panel:DeepSeek Harness 侧边栏技能面板

前言

在 DeepSeek Harness(DSH)里写智能体时,技能(skill)是组合能力的最小单元。但默认侧边栏只提供一个输入框,敲 / 会列出候选,却没有统一的入口可以快速浏览当前会话可用的所有技能、它们的用途,更别提一键复制 /名字 来调用了。

dsh-skill-panel 在 DSH 侧边栏底部放了一个「技能」按钮,点击后弹出列表:展示当前会话可用的所有 skill,附带中文说明、来源和最近使用记录,按一行即可把 /名字 复制到剪贴板。它走的是 DSH 官方 skills/list Remote,所以列表与输入框里 / 得到的候选完全一致。

插件定位

这是一个客户端插件,为 DeepSeek Harness 的侧边栏增加技能浏览与快捷调用能力。由 maomaobishop 维护,安装在用户配置目录下的 plugins 与 node_modules 中,不依赖构建步骤,改完重启即可生效。

核心功能

  • 中文说明:每个 skill 在 lib/zh.json 里配一条中文解释,界面显示「中文名|一句话说明」,英文原文降为次要行。
  • 中文搜索:搜索框同时匹配名称 / 中文标题 / 中文说明 / 英文描述,敲「表格」也能找到 office-xlsx。
  • 键盘操作:↑ ↓ 选择、Enter 复制、Esc 关闭;鼠标悬停同步高亮。
  • 最近使用:复制过的 skill 自动置顶(最多 3 个,存 localStorage),带「最近」标记。
  • 来源可见:每条标注来自 .dsh/skills、.agents/skills 还是插件自带,完整路径在 hover 提示里。
  • 翻译进度:底部显示「已翻译/总数」,提醒你还有哪几个没写中文。
  • 跟随主题:颜色全部走 --dsw-alias-* 主题 token,深浅色自动切换。

安装与启用

需要 DeepSeek Harness(桌面端或 dsh web)+ Windows PowerShell。

git clone https://github.com/maomaobishop/dsh-skill-panel.git
cd dsh-skill-panel
.\install.ps1                 # 装进 desktop profile
.\install.ps1 -Profile web    # 或 web profile

安装脚本会做三件事:把包复制到 <profile>\plugins\、在 <profile>\node_modules\ 建立目录链接、在 profile 的 package.json 里登记 dependencies 与 dsh.profile.bundles。

然后重启 DeepSeek Harness。 bundles 是启动期的组合,热加载只对已在运行的 entry 生效。

卸载:.\uninstall.ps1。

加中文说明

打开 lib/zh.json,按 skill 名加一条:

{
  "skills": {
    "my-skill": { "title": "中文名", "summary": "一句话说清它干什么、什么时候该用。" }
  }
}

改完点面板右上角的「↻」即可生效,不用重启——词典由宿主路由 GET /skill-panel/dictionary 每次现读文件。没写中文的 skill 会退回英文描述,不会报错。

实现方式

  • Host(lib/index.js):占一条 Loader row,并提供 GET /skill-panel/dictionary 把 lib/zh.json 发给面板。
  • Client(lib/client.js):在 sidebar.footer.action 插槽里画按钮,向上弹出浮层。

客户端是手写的 lazy-CJS 工厂(window.__ModuleLoader__.load({ id, factory })),格式与官方发布的 client bundle 相同:外层只注册工厂,模块体在首次物化时才执行,不需要构建步骤,改完重启即生效。

适用场景与注意

  • 适合需要频繁浏览、搜索和复制 skill 名称的 DSH 开发者,尤其是维护多个 skill 或希望统一中文说明的场景。
  • 插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。

结尾

dsh-skill-panel 把技能目录从输入框下拉中解放出来,用统一的列表与中文说明降低认知负荷,适合 DSH 侧边栏的日常使用。

  • 目录页:https://www.skillhub.cn/plugins/maomaobishop/dsh-skill-panel
  • GitHub:https://github.com/maomaobishop/dsh-skill-panel
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye