前言¶
在 DeepSeek Harness(DSH)里用技能,常见做法是手打 /技能名,或从文档里复制路径。技能一多,很难快速找到「这次任务该用哪一条」,也缺少「这一轮到底调了哪些 skill」的直观反馈。桌面端输入框旁本来可以有一颗「技能」按钮;维护者 AlLHHH 把这套交互拆成独立插件 dsh-skill-palette(README 里也叫 SkillMate / 技能助手),用分类、搜索、收藏和中文说明把选 skill 和写进输入框连成一步,并在回答末尾标出本轮用到的技能。
这是什么¶
dsh-skill-palette 是 DSH 的客户端类插件:在会话输入框右侧提供「技能」按钮,点开是全部技能的清单;选一项会在光标处插入 /技能名(带尾随空格),由 DSH 渲染成蓝色 chip。包名 dsh-skill-palette,当前版本 0.1.4,许可证 MIT。目录页:skillhub.cn/plugins/AlLHHH/dsh-skill-palette;源码与说明:github.com/AlLHHH/dsh-skill-palette。
核心功能¶
下面按 README 已写明的行为归纳,不超出资料范围。
浏览与插入¶
- 按用途分类:设计、写代码、审查、写东西、视频、办公文件、逆向、通用八个桶,外加「其他」。分类表是手写的;新技能未归类时,按名称和描述里的关键词自动进桶,都不中才进「其他」。
- 搜索:可匹配技能名称、英文描述、中文说明、分类名。
- 最近使用:保留最近 24 条,每用一次顶到最前。
- 收藏:每行右侧 ☆ / ★;收藏页里每用一次自动置顶。
- 图钉:钉住后点技能不收起面板,可连续选多个;未激活为灰色描边,激活为蓝色描边。
- 点选即写入输入框:插入
/技能名,不走剪贴板复制。
回答下方的 skill 展示¶
每条回答末尾可显示一行小胶囊(例如 /systematic-debugging),鼠标悬停可看中文说明;一轮未用技能则不显示。显示位置可在设置里改:回答下方 / 输入框右边 / 两者 / 不启用(默认回答下方)。
中文说明与翻译¶
内置约 90 个常用技能的中文一句话说明。新技能没有说明时,面板顶部会出现「N 个技能还没有中文说明」和「翻译 N 条」按钮;点击后用「设置 → 模型」里选的默认模型翻译,结果写入 <dsh home>/skill-zh.json,之后不重复翻。翻译只把技能名和英文描述发给模型,不发对话、不发文件、不记日志。
设置页(设置 → 技能助手)¶
- 增强 skill 的使用率:在系统提示里加一段「先匹配技能再动手」(默认开,约 90 token/次)。
- 显示会话调用 skill 的位置:见上文四种选项。
- 翻译相关:缺中文提示、立即翻译所有缺中文的技能、新技能自动翻译;界面会提醒会消耗 token。
- 底部显示当前版本与「检查更新」(只读 registry,10 分钟内复用同一次结果,不会自动下载安装)。
安装与启用¶
官方安装方式如下。
# npm
dsh plugin add dsh-skill-palette
# 从 GitHub 装
dsh plugin add github:AlLHHH/dsh-skill-palette
插件自带 cordis.patch.yml,装进 profile 后会自动插入 skill-picker 一行,无需手改配置。装完后刷新页面,或在「应用菜单 → 重启应用」。
环境要求:DSH >= 0.2.0-0;README 写明实测桌面版 0.2.1-rc.3。客户端通过 window.__ModuleLoader__.load 与 slots(conversation.input.right、settings.section、conversation.chat.turnTail)接入;宿主提供翻译、增强开关、版本检查等 /api 路由,依赖 connection、llm、agentDefaultModel、systemPrompt 等服务——缺某项时仅对应功能不可用,不会拖垮启动。
典型用法与自检¶
确认插件在工作¶
- 看输入框右边是否有「技能」按钮;点开标题为「技能 · N」,N 应等于已装技能总数(
~/.dsh/skills/*/SKILL.md加上技能包内置入口)。 - 新技能是否出现:在
~/.dsh/skills/下新建目录并放入SKILL.md(frontmatter 至少含name和description),重新打开面板应多一行;面板开着时最多约 60 秒自动刷新。 - 翻译:对新技能点「翻译 N 条」,成功后该行显示中文,且
~/.dsh/skill-zh.json多一条记录。请求走POST /api/dsh-skill-palette/skill-zh,用已配置的默认模型,无需另填 key;失败会在按钮旁写出原因(例如未选默认模型)。 - 版本:设置页底部「检查更新」向 registry 查询
latest标签。
日常操作¶
需要某类能力时,点「技能」→ 按分类或搜索找到条目 → 单击插入 /技能名 → 照常发送。若要连续插入多个 skill,先打开图钉再点选。回答完成后,在默认配置下于回答下方查看本轮用到的 skill 胶囊。
适用场景与注意¶
适合:本地技能数量较多、希望按任务类型浏览而非死记命令;需要中文说明或批量补译;希望在对话里看见「这一轮用了哪些 skill」的开发者。
已知限制(来自 README):中文说明表手写,新技能需按钮翻译或提 issue 补表;翻译一次最多 40 条,客户端按 20 条一批串行,模型返回非 JSON 时整批失败;分类靠关键词,个别技能可能落在不理想的桶;「检查更新」不自动安装。
安全与权限:插件在当前 DSH 进程权限下运行,安装前建议阅读仓库源码与 MIT 许可证,确认翻译与增强提示等行为符合你的环境策略。社区目录 skillhub 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-skill-palette 把「选 skill → 写进输入框 → 看见本轮调用」串成一条线,并附带分类、收藏、搜索与可选的中文翻译。需要安装或 issue 时,见 GitHub 仓库 与 SkillHub 目录页。