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