dsh-skill-picker

给 DSH 的输入框加一个 ⚡ 按钮：点开是你装过的全部技能（带说明），搜一下、点一下，/技能名 就进了发送框，DSH 自己把技能加载起来执行。

English — A skill picker for the DSH Web GUI. A ⚡ button in the composer lists every installed skill with its description; picking one inserts the official /skill-name gesture into your draft, so DSH loads that skill with your message.

1、为什么要做

DSH 本来就会认 /技能名 这个手势 —— 你在消息里写 /ji-zhang 午饭 12 块，它自动加载「记账」技能来执行。官方只配了一个 / 补全，而它靠两样东西：

1. 前缀匹配 —— 你得打对技能名的开头几个字母
2. 你的记忆 —— 装了五六十个技能，谁记得住每个叫什么

于是最常见的场面是：明明装了「备份记忆」，却想不起来它叫 backup-memory，翻不到就放弃了。

2、它做什么

1. 看得见 —— 输入框旁边一个 ⚡，点开是全部技能 + 完整描述
2. 搜得到 —— 中文、拼音（jiyi / ji yi / jy）、英文都行，技能名和描述一起搜
3. 选得快 —— 最近使用靠前、可手动置顶、↑↓ + Enter 全程键盘
4. 管得了 —— 右键（手机长按）：置顶 / 关闭 / 在文件管理器中定位 / 卸载（移入备份，可撤回）
5. 到处一致 —— 置顶和最近使用在桌面端、网页端、手机之间共用同一份

它和官方 / 补全不冲突，可以同时用：记得住名字用官方，记不住用它。

3、怎么用

1. 看输入框右下角（模型选择器旁边），点 ⚡
2. 敲关键字（中文 / 拼音 / 英文），列表实时过滤；也可以直接 ↑↓ 翻
3. 点中技能（或按 Enter）—— 发送框里出现 /技能名 ，光标停在末尾
4. 接着把话说完，回车发送 —— DSH 自动加载这个技能

例子：点 ⚡ → 搜 jiyi → 点 /ji-zhang → 打上「今天午饭 12 块」→ 发送。

4、安装

4.1 三条路，按需要选一条

1. 要最新版 —— GitHub 直装（git 依赖直接拉最新 commit，不受 npm 24 小时门禁影响）

   dsh plugin --profile web add "git+ssh://git@github.com:a735624258/dsh-skill-picker.git"
   

2. 要 npm 正式版 —— 先查版本号，再按版本号装（别用裸名）

   npm view dsh-skill-picker version                      # 例如 0.5.28
   dsh plugin --profile web add dsh-skill-picker@0.5.28
   

3. 要改代码 —— clone 下来用 link 模式装

   git clone https://github.com/a735624258/dsh-skill-picker.git
   dsh plugin --profile web add link:/path/to/dsh-skill-picker
   

⚠️ 裸名安装（add dsh-skill-picker）在新版本发布后 24 小时内会被 pnpm 的 minimumReleaseAge 门禁拦下、自动落回旧版。照上面三条走就不会装错。

4.2 装完必须重启

host 路由是进程启动时加载的，只开个新标签页不生效：

4.3 网络与卸载

1. HTTPS 慢或不通 → 改用 SSH：git clone git@github.com:a735624258/dsh-skill-picker.git
2. 想让 pnpm 一律走 SSH：git config --global url."git@github.com:".insteadOf "https://github.com/"
3. dsh 被 PowerShell 执行策略挡下 → powershell -ExecutionPolicy Bypass -Command "dsh plugin --profile web add link:C:\path\to\dsh-skill-picker"
4. 卸载：dsh plugin --profile web remove dsh-skill-picker

4.4 兼容性与注意事项

1. peer 范围写得宽是故意的 —— ^0.1.0-rc.6 || >=0.2.0-rc.1 <1.0.0-0。内核包与内核锁步同版本，钉死一个小版本线会让插件在内核升级时被误拒（日志一句 skipping profile bundle，表现是 ⚡ 按钮凭空消失）
2. 技能读哪些目录 —— 项目级 <工作区>/.dsh/skills、<工作区>/.agents/skills；用户级 ~/.dsh/skills、~/.agents/skills（$DSH_AGENTS_HOME 可覆盖）；同名时项目级优先
3. 符号链接 / Junction 型技能会被跟随读取；user-invocable: false 的技能不列出（列出来点了也会被官方静默跳过）
4. 桌面端无需任何手工处理（v0.5.15 起）：官方技能 UI 在 app.asar 里还是普通目录都不影响
5. 手机端需配套 —— dsh-pocket 的「切会话不抢焦点」补丁与本插件的 window.__dshSkillPickerFocusing 豁免牌是一对，只装一边会出现「切会话抢焦点」或「插完技能光标不回」
6. 暂不支持自定义技能目录（官方 customSkillDirs）—— 欢迎 PR

5、它是怎么做到的

[客户端]  输入框旁的 ⚡ 按钮
             ↓ 取技能列表（先官方 skills API，失败回退宿主扫描）
[宿主]    技能目录 → 名字 + 描述
             ↓ 你点选
[客户端]  把 "/技能名 " 追加进发送框
             ↓ 发送
[DSH]     agent/pre-step 认出 /技能名 手势 → 加载技能 → 执行

本插件只补 UI 这一层，加载与执行走 DSH 官方既有机制（dsh-tool-skill 扫描用户消息里的 /kebab-case-name），不碰 agent、不改官方代码。

1. 列表两条路 —— 优先走官方宿主 skills API（remote.skills.list，与官方 / 补全同源、自动含用户级 + 项目级），不可用时回退到宿主扫描路由
2. / 菜单的模糊 + 拼音（v0.5.15 起）—— 运行时接管官方触发源，一个文件都不动。原因：官方不允许注册同名 / 源（重名直接抛错），而改官方文件在 app.asar / pnpm 硬链接 / 悬空软链下会静默失效
3. 技能管理路由有三道闸 —— 必须带 x-dsh-skill-picker: 1 自定义头；客户端只报技能名、路径由宿主自己查；路径必须恰好落在已知技能根的一层之下。「卸载」从不删除，只移进 $DSH_HOME/skill-backups/
4. 出错不拖垮 —— 插槽缺失时静默跳过，扫描失败返回空列表，状态同步失败退化成纯本地

6、开发

npm install                                    # 装依赖
npm run build                                  # src/ → lib/（client bundle 必须打成 __ModuleLoader__ 握手）
dsh plugin --profile web add link:$PWD         # link 模式装进 web profile，改源码即生效
node --test                                    # 测试

⚠️ 改完源码必须 npm run build：lib/client.js 是构建产物，ESM 源码不能直接当 client bundle 加载（DSH web shell 要求 window.__ModuleLoader__.load({ id, factory }) 握手格式），否则启动报 loaded without registering "dsh-skill-picker"。

dsh-skill-picker/
├── package.json            # dsh.bundle.patch + dsh.client 声明 + 兼容性表
├── cordis.patch.yml        # bundle patch：把插件行插进 web profile
├── build.mjs               # esbuild 构建：host ESM + client CJS
├── locale/                 # 官方插件页显示的名字与说明（en 为锚点，zh 为中文）
├── src/
│   ├── index.js            #   host：技能目录路由 + agent 引导段
│   ├── skill-ops.js        #   host：关闭 / 开启 / 定位 / 卸载 / 撤回
│   ├── patch-ui-skill.js   #   host：旧文件补丁（默认关闭）+ 自动还原
│   ├── dir-entry.js        #   目录项读取（跟随符号链接 / Junction）
│   └── client/
│       ├── index.jsx       #   client：⚡ 面板（搜索 / 分组 / 排序 / 右键菜单）
│       ├── slash-source.js #   client：`/` 菜单的运行时接管
│       ├── shared-state.js #   client：跨端共享的置顶 / 最近使用
│       └── session-view.js #   client：会话身份与工作区 cwd
├── lib/                    # 构建产物（勿手改）
├── test/                   # node --test 用例（8 个文件）
└── docs/                   # 截图

测试最近一次结果：88 用例 / 87 通过 / 1 跳过 / 0 失败（跳过那条需要 Windows 建符号链接的权限）。

locale/ 是给官方看的：插件页和「设置 → 内置插件」用 meta.title / meta.description 显示名字与一行说明，并且搜索框认这两个字段。官方拿 en.json 当目录锚点，所以两个文件都得有 —— 只放 zh.json 会被整份忽略；exports 里也要放行 ./locale/*，否则解析器取不到。

更新日志

最近 3 个版本：

• v0.5.29 —— 官方插件页显示「技能选择器」+ 中文说明，可用中文搜到
• v0.5.28 —— 新置顶的技能排到「置顶」分组的最前面
• v0.5.27 —— 手机端「插完技能光标不回」的配套豁免牌

各版本说明（版本速览 + 13 个版本的详细说明）见 CHANGELOG.md。

MIT License · LICENSE