前言¶
在 DeepSeek Harness（DSH）里用技能，常见做法是输入 / 从菜单里选，或直接敲 /技能英文名。技能一多，要记住几十个英文标识并不轻松，也未必记得每个技能是干什么的。dsh-skill-quickpick 是社区维护的客户端插件（作者 fxdfx），在输入框旁增加「技能」入口：打开按来源分组的列表，显示中文名与说明，点一项把 /技能名 插进当前草稿，不自动发送，也不覆盖你已写的内容。下面按安装、日常用法、能力与开关说明如何落地。
这是什么¶
- 名称：
dsh-skill-quickpick（npm 包名与插件市场检索名一致） - 维护者：fxdfx
- 分类：客户端（
platform: web，向 DSH 桌面/Web 客户端注入 UI） - 许可证：MIT（见 GitHub 仓库）
- 当前包版本：
0.1.0（package.json）；README 标注状态为 pre-release，适配 DSH 0.2.x - 仓库与目录： GitHub · SkillHub 目录页
一句话：用宿主已有的 skills.list（与输入框 / 菜单同源）做可视化快选，并把插入行为限定为草稿编辑，不调用 submit()。
核心能力¶
列出、分组与搜索¶
| 能力 | 说明 | 默认 |
|---|---|---|
| 列出技能 | 来自宿主 skills.list |
开 |
| 按来源分组 | 我的技能 / 项目技能 / 内置 / 其他 | 开 |
| 中英搜索 | 匹配中文名、中文说明、英文名、英文原文 | 开 |
| 防重复 | 草稿里已有 /技能名 的条目会置灰 |
开 |
组内支持拖拽调整显示顺序（写入 dsh-home 下 skill-quickpick-order.json，不改技能源文件）；排序可在「自定义 / 按使用频率 / 按名称」之间三态循环。
中文名与说明¶
显示优先级（高到低）：
- 你在面板里编辑并保存的内容
- 插件内置中文对照表
- 自动机翻缓存
- 英文原文
用户编辑写在 dsh-home/skill-quickpick-user.json；机翻缓存写在 skill-quickpick-zh.json。三层互不累加覆盖，删掉任一文件不会破坏其它层。
默认不开启自动翻译；开启后，宿主侧 POST /skill-quickpick/translate 只把技能名和描述发给模型翻译（不发正文），每个技能只翻一次并写缓存。
一键插入草稿¶
点选一项后调用 insertText 在光标处插入 /技能名；失败时回退为 setDraft 追加。插入后焦点回到输入框，可继续编辑并用回车发送。插件不会替你按发送键，也不锁定模型只能使用该技能。
默认关闭的「高风险」能力¶
面板顶部齿轮可逐项打开以下能力（默认全部关闭）：
| 开关 | 默认 | 开启后的主要行为 |
|---|---|---|
| 禁用 / 启用技能 | 关 | 改写本地 SKILL.md frontmatter 的 disable-model-invocation |
| 卸载 / 回收站 | 关 | 将技能目录移入 dsh-home/skill-quickpick-trash/，到期自动清理 |
| 自动翻译技能说明 | 关 | 按上述接口批量补中文缓存 |
| 使用统计 | 关 | 读本会话日志压缩包，统计模型加载与手动 /技能名 次数 |
关闭开关时，宿主会对写操作返回 403，不仅是在 UI 上隐藏按钮。禁用技能的「重新启用」与「全部恢复（↺ N）」在开关关闭时仍可用，避免锁死后无法解锁。
安装与启用¶
从插件市场（推荐）¶
DSH 桌面版打开 Settings → Plugins，搜索 dsh-skill-quickpick，安装。
命令行（普通 dsh web）¶
在 profile 中加入包后重启：
dsh plugin --profile <你的 profile 名> add dsh-skill-quickpick
装完后需完全退出客户端再打开：host 半边改动只有重启才生效。
SkillHub 与 DeepSeek / 幻方无官方从属关系；安装前请自行查看源码与 MIT 许可证。插件以当前 DSH 进程权限运行，开启禁用、卸载、统计等开关会读写 dsh-home 与会话日志，请只在理解风险后打开。
典型用法¶
- 重启客户端，确认插件已加载。
- 在会话输入框旁找到「技能」按钮，打开面板。
- 用搜索框按中文或英文名筛选；在分组内点选目标技能。
- 确认草稿中出现
/技能名（末尾带空格），补全参数后自行发送。
若你曾开启「禁用技能」：停用或卸载本插件前，先在面板搜索框右侧点 ↺ N（全部恢复），否则插件停止后无人再替你去掉 disable-model-invocation 标记。
需要调整中文展示时，在列表行上使用编辑入口，修改会进入 skill-quickpick-user.json，优先级最高。
适用场景与注意¶
适合谁：日常在 DSH 里频繁手动 /技能名、技能数量较多、希望用中文浏览和搜索的开发者。
不适合当作什么：不是技能市场，不能替代 DSH 自带的 / 补全；也不负责自动挑选或发送消息。
项目技能与禁用/卸载：服务端从会话日志 header 里的 cwd 推断项目根，只有 DSH 会话里出现过的项目，其 .dsh/skills、.agents/skills 才会进入可信根。内置技能（无本地可写 path）不能禁用或卸载。
卸载本插件（非卸载某个 skill）：若使用过禁用功能，先「全部恢复」；再用 DSH 插件管理卸载，或按 README 中的 dsh plugin 子命令移除（截断资料未给出完整一行，以仓库 README「卸载」小节为准）。
结尾¶
dsh-skill-quickpick 把同源技能列表做成中文快选面板，默认只做分组、搜索与草稿插入；需要治理技能库时再按需打开统计、机翻、禁用与回收站。查阅说明与提 issue 请到 GitHub 仓库，在生态里检索可到 SkillHub 目录页。
