dsh-skill-picker

dsh-skill-picker

技能记不住名字？官方 / 补全靠前缀记忆，装了几十个技能谁记得住？ 本插件让技能看得见、翻得到、选得快——点一下 ⚡，全部技能带描述排在你面前，搜索、点选、插入，随消息发出自动加载。

⚡ 快速安装

🤖 给 AI/安装助手的提示（按优先级执行，保证装到最新版）：

• 要最新版 / 不确定版本 → 走 GitHub 直装。git 依赖直接拉 GitHub 最新 commit，完全不受 npm minimumReleaseAge 24h 门禁影响，百分百新版：

  dsh plugin --profile web add "git+ssh://[e-mail]:a735624258/dsh-skill-picker.git"
  

• 要 npm 正式版 → 先查最新版本号，再指定版本安装（禁止裸名）：

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

• ⚠️ 禁止执行裸名安装 dsh plugin --profile web add dsh-skill-picker：新版本发布后 24 小时内会被 pnpm minimumReleaseAge 门禁拦截并自动落回旧版——照着上面两条走就永远不会装错。

一条命令装好并注入 DSH web profile，重启 dsh web（或刷新页面）即生效。HTTPS clone 受限时用 SSH 形式（见下文 安装 的网络特例）。

DSH Web GUI 的技能选择器：在输入框（composer）工具行右侧加一个按钮，点开可以搜索并点选已安装的技能，选中后把官方 /技能名 手势插入发送框——随消息一起发出，DSH 原生机制就会自动加载该技能并执行。WorkBuddy 式"把技能写进发送框"的交互，DeepSeek Harness 复刻版。

English: A skill picker for the DSH Web GUI — a button in the composer's right tool row opens a searchable list of installed skills; picking one inserts the official /skill-name gesture into the draft, so DSH's native user-invocation path loads the skill with your message.

当前版本：v0.5.27（手机端"插完技能光标不回"的配套豁免牌（window.__dshSkillPickerFocusing，配合 dsh-pocket 的「切会话不抢焦点」补丁 —— 两个补丁是一对，只装一边手机上就会复发 ✗；见 local/dsh-pocket-mobile-fix/skill-panel-fileguard-fix-2026-10-02.md）+ ⚡ 面板可管理技能：右键/长按 → 置顶 · 关闭（SKILL.md→SKILL.md.disabled，agent 也不再加载）· 定位 · 卸载（移进备份目录，从不删除，可撤回）；「已关闭」收成右下角一个入口；光标落回输入框末尾；右键菜单跟随主题且实心；面板字体与 DSH 统一（--dsw-font-family，分组小标题对齐侧栏规格）；零 emoji；提示条自动消失；搜索框无边框 32px + 面板带 data-dsh-skill-picker 标记（供 dsh-pocket 手机端放行，见 local/dsh-pocket-mobile-fix/skill-panel-fileguard-fix-2026-10-02.md）+ 「置顶 / 最近使用」在桌面端、网页端和手机之间共用同一份（存于 $DSH_HOME/dsh-skill-picker-state.json，不再各存各的 localStorage）+ / 菜单与 ⚡ 面板排序完全一致（空查询也走同一套排序，置顶排最前）+ 修掉「打 / 菜单开到下面去」（microtask 竞态：技能组必须 0 个 await 才抢得到高亮）+ 文件补丁退休（/ 增强改为运行时接管，默认不再改任何官方文件，并会自动把改过的还原）+ 模糊/拼音匹配 + ⚡ 面板置顶分组 + 搜索结果按匹配相关度排序）

为什么用它（vs 官方 / 补全）

官方内置了 / 技能补全，但它是记忆驱动的——你得先记得技能名，打 / + 前缀才能过滤出来。技能一多就抓瞎：

	官方 / 补全	dsh-skill-picker
触发	输入框打 /	输入框旁 ⚡ 按钮
查找方式	前缀记忆驱动，忘了名字就找不到	全列表浏览 + 关键字搜索，忘了名字也能翻到
中文技能	只能打名字/前缀	拼音直搜：ji yi / jiyi / jy 都能搜到「备份记忆」类中文技能（v0.3.0）
排序	固定	最近使用置顶、常用靠前
描述可见	精简	完整描述一眼看全

记得名字用官方，忘了名字用本插件——两者互补，可同时使用。

特性

• ⚡ 一键弹出全部技能（闪电图标，人人看得懂）
• / 直接补全：输入斜杠即列出全部技能，模糊搜索（技能名+描述任意匹配）+ 常用排序（v0.2.0）
• 🔤 拼音搜索：技能名和描述都生成拼音索引（全拼带空格 ji yi / 连打 jiyi / 首字母 jy），中文技能不用记字就能搜（v0.3.0）
• 🔍 实时搜索（技能名 / 描述 / 拼音都搜）
• ⌨️ 键盘导航：弹层内 ↑↓ 选择、Enter 插入、Esc 关闭，全程不碰鼠标（v0.2.2）
• 🧠 最近使用置顶、常用靠前的智能排序（WorkBuddy 同款）
• 📋 走官方宿主 skills API（与 DSH 内置 / 补全同一数据源，自动覆盖用户级+项目级技能）
• 🧩 插入官方 /技能名 手势，加载/执行走 DSH 原生机制，零 agent 侧改动
• 🎨 跟随 Web UI 主题（CSS 变量），浅色/深色自适应
• 📦 纯 client + host 双半插件（拼音库已打包进 client bundle，无额外运行时安装）

安装

# 方式一：GitHub 克隆 + link（推荐，无需发布 npm）
git clone https://github.com/a735624258/dsh-skill-picker.git
dsh plugin --profile web add link:/path/to/dsh-skill-picker

# 方式二：Git 依赖直装
dsh plugin --profile web add "github:a735624258/dsh-skill-picker"

# 方式三：发布到 npm 后（预构建安装，体验最佳）
# ⚠️ 用具体版本号安装（minimumReleaseAge 门禁会在发布后 24h 内拦截裸名，
#    自动落回旧版）——先查最新版本再指定安装：
npm view dsh-skill-picker version   # 例如 0.5.4
dsh plugin --profile web add dsh-skill-picker@0.5.4

注：已发布 npm（npm view dsh-skill-picker 可见 0.3.2），方式三可直接安装；未发布时请用方式一或方式二。 若 dsh 命令因 PowerShell 执行策略被拒（File ... cannot be loaded），用： powershell -ExecutionPolicy Bypass -Command "dsh plugin --profile web add link:C:\path\to\dsh-skill-picker"

网络特例（国内/HTTPS 受限时）：

• 方式一的 git clone 走 HTTPS 慢或不通时，改用 SSH：git clone [e-mail]:a735624258/dsh-skill-picker.git
• 方式二的 github: 简写强制 HTTPS clone；仅 SSH 可用时改用： dsh plugin --profile web add "git+ssh://[e-mail]:a735624258/dsh-skill-picker.git" （或先执行 git config --global url."[e-mail]:".insteadOf "https://github.com/" 让 pnpm 走 SSH）
• 方式三新版本发布后 24 小时内裸名会被 pnpm 的 minimumReleaseAge 门禁挡到旧版（如装到 0.2.0）；急用最新请指定版本：dsh plugin --profile web add dsh-skill-picker@0.3.1

重启 dsh web（或刷新页面加载新 bundle）后生效。

用法

• 打开任一会话，在输入框工具行右侧找到**⚡ 按钮**
• 点击弹出技能列表（可输入关键字或拼音过滤，如 ji yi 搜「记忆」）
• ↑↓ 选择、Enter 插入（或直接鼠标点选）→ 发送框自动出现 /技能名
• 继续输入你的话并发送——DSH 会识别 /技能名 手势，自动加载该技能并按其指令执行

示例：点选 duo-xuan-pi-gai 后发送框变为 /duo-xuan-pi-gai 帮我批改多选，发送后技能自动加载。也可以在输入框直接打 /duo xuan、/duoxuan 靠拼音补全选到它。

原理

DSH 的 dsh-tool-skill 在 agent/pre-step 阶段扫描用户消息中的 /kebab-case-name 手势（SKILL_GESTURE 正则），命中后把对应技能内容作为 skill-invocation 注入对话——即"用户消息里写 /技能名 就会自动加载技能"是官方既有能力，只是没有 UI。

本插件只补 UI 一层：

[client]  ⚡ 按钮 → fetch('/dsh-skill-picker/skills')
                    ↓
[host]    扫描用户级 $DSH_HOME/skills + 项目级 <cwd>/.dsh/skills 等 → 技能目录（name + description）
                    ↓
[client]  点选 → inputActions.setDraft(draft + '/技能名 ')
                    ↓
[DSH]     agent/pre-step 识别手势 → 自动加载技能 → 执行

• client 半：注册到官方 conversation.input.right 插槽（composer 工具行、发送按钮左侧的控件位），技能列表优先走官方宿主 skills API（remote.skills.list——与 DSH 内置 / 补全同源，会话作用域，自动含用户级/项目级技能），失败时回退到 host 扫描路由；插入文本走框架输入机的 inputActions.setDraft（单一路径，撤销/草稿持久化自动处理）；最近/常用排序 + 拼音索引（pinyin-pro）在 client 侧生成，按技能缓存

与官方 / 补全的关系（v0.4.0 起：增强，而非并列）

v0.2.0–0.3.4：插件注册了一个独立的 / 候选源（skill-fuzzy），与官方 ui-skill 源并列——菜单里出现两个技能分组，搜索行为相互独立（冲突风险、视觉重复）。这条路已被官方堵死：inputTriggers.registerSource 对 (trigger, name) 有唯一性硬检查，重名直接抛 slash source "/skill" is already registered。

v0.4.0–v0.5.13：改为给官方 @deepseek-ai/dsh-client-ui-skill 包的 candidates 打文件补丁——候选逻辑从 skill.name.startsWith(query)（前缀匹配）换成调用插件注入的全局函数 window.__dshSkillPickerFuzzy（fuzzysort 模糊 + pinyin-pro 拼音 + 最近/常用排行）。v0.5.1 起由 host 端每次启动自动应用（另加 order: 2→-1：技能组排在命令组之上），首次修改前自动备份 .bak。代价是极度依赖"那个文件是一个可写的普通文件"——打包桌面端（app.asar 内）、pnpm 硬链接、迁移后悬空的软链，任一情况都让它静默失效。

v0.5.15 起（首选路径）：改用运行时接管，不碰任何文件。官方的 inputTriggers 服务把源注册表放在实例字段 live.sources 上，里面就是活源对象；而斜杠菜单是每次调用现取 source.candidates：

// 注意：sources() / all() 不在服务上，它们在每个会话 controller 的 roster 里。
// InputTriggerService 的成员只有：inject, live, constructor, registerSource, sessionOf, sessions
const source = ctx.inputTriggers.live.sources.find((s) => s.trigger === '/' && s.name === 'skill')
const original = source.candidates
source.candidates = async (projection, args) => rank(await original(projection, { ...args, query: '' }), args.query)
source.order = -1                                    // 技能组排在命令组之上
const onPick = source.onPick                         // 选中记账
source.onPick = (args) => { track(args?.candidate?.name); return onPick.call(source, args) }

⚠️ 这里踩过的坑（0.5.14 未发布版本）：我最初把它写成 ctx.inputTriggers.sources('/')。那个 { sources, all } 确实存在，但它属于每个会话 controller 内部的 roster 对象，不在服务上——于是查找永远返回 undefined，接管静默地什么都没做。现在 findSkillSource() 按 live.sources → sources() → all() → roster.* 依次尝试，并有回归测试锁死真实形状。

关键点：官方 candidates 返回的是已映射的展示项、且已被官方自己的匹配器过滤过，所以必须用空查询问它要全量（rankByName(items, "") 原样返回全部），再自己排序。官方规则全部继承（userInvocable 过滤、子智能体会话排除、「仅用户可调用」文案）。文件补丁保留为旧内核兜底，两条路同时存在时不会打架（运行时接管始终以空查询取全量，不会双重过滤）。

效果：官方「技能」分组仍是唯一一个 / 技能列表，只是匹配与排序被升级；⚡ 面板与 / 菜单共用同一个 rankPickerItems，因此匹配结果和显示顺序完全一致。接管成功时，⚡ 面板底部会显示 「/ 增强：运行时接管」 徽标 —— 一眼就能看出它到底有没有生效（这正是 0.5.14 那次翻车最该有的东西）。

手动兜底（旧流程，v0.5.15 起已不再需要）：把官方包拷到 profiles/web/local/dsh-client-ui-skill/，profile package.json 加 "@deepseek-ai/dsh-client-ui-skill": "link:…"，pnpm install 后重启 DSH。仅当你的内核连 inputTriggers 服务都不提供时才还需要它。

更新日志

• v0.5.27：给「插完技能把光标放回输入框」加一张豁免牌 —— 配套 dsh-pocket 手机端新补丁「切会话不抢焦点」。起因：手机端装上那个补丁后，它把程序自己抢的焦点一律退回 ✗ —— 而本插件的 focusComposer() 正是程序主动聚焦（这正是它的意义所在），于是「插完技能光标不回来」复发。修法：focusComposer() 在 editor.focus() 之前写一个时间戳 window.__dshSkillPickerFocusing = Date.now()，那个拦截器看到 1.2 秒内的时间戳就放行 ✓（用时间戳而不是布尔，是因为紧随其后还有一次 60ms 的守卫重定位 —— 一次设值同时覆盖两次聚焦）。⚠️ 两个补丁是一对：只装一边，手机上就会复发 ✗。完整背景与两侧补丁全文见 local/dsh-pocket-mobile-fix/skill-panel-fileguard-fix-2026-10-02.md。
• v0.5.26：四个细节修复 + 八个追加修复（全部是国豪实机挑出来的）：① 选完技能光标先是不回来、② 回来了但落在开头、③ 右键菜单在浅色主题下看不清、④ 深色主题下半透明；追加 ⑤ 提示条不再常驻、⑥「已关闭」改成右下角一个入口、⑦字体统一到 DSH 自己的 UI 字体、⑧分组小标题对齐 DSH 规格 + 去掉 emoji、⑨修「已关闭的技能还出现在主列表里」、⑩行内那个置顶针也删掉（改走右键菜单，至此面板零 emoji）、⑪底部那句提示改成一行短的并永久保留、⑫搜索框改成"模型选择器那个"样式（无边框）、⑬面板加 data-dsh-skill-picker 标记（配合 dsh-pocket 的手机端"文件守卫"放行 —— 那是个独立插件的 bug，详见 local/dsh-pocket-mobile-fix/skill-panel-fileguard-fix-2026-10-02.md）。① 光标不回输入框：他的原话 点了按钮然后选了 skill，skill 的名字确实落到聊天框里了，但是没有光标闪烁，意味着我还要点一下聊天框才能继续打字；但如果你是通过输入斜杠、在出来的列表中点击 skill，那它是有闪烁光标的。根因：点技能行时焦点落在了那个按钮上，随后面板关闭、按钮卸载 → 焦点掉回 body，于是输入框有内容但没光标；官方 / 菜单没这问题，因为整个过程焦点一直在 composer 里。修法：pick() 之后用一个版本无关的 DOM 兜底把焦点还回去 —— 从 ⚡ 自己的节点向上最多 8 层找到包含编辑器的祖先并 focus()；放在 requestAnimationFrame 里执行，等面板卸载 + React flush 完。② 光标落到了开头：他紧接着截图指出 /coding 的光标在斜杠前面。根因：给 contenteditable 调 focus() 而不给选区时，规范就是把光标放开头 —— 我上一版正是只 focus、没摆选区。修法：显式把 Range 塌缩到末尾（等价于"鼠标点在这行末尾"，官方编辑器会同步 DOM 选区），并在 60ms 后带守卫地再补摆一次（只在输入框仍聚焦时才动，免得覆盖用户刚点的别处）—— 防的是富文本编辑器 focus 后又把自己的选区重置回去。⚠️ 再调一次 setDraft 是没用的：文字没变它会直接 return，光标永远不动。实测：光标位置 15 / 15（= 文字长度）→ 末尾 ✅；直接键入 XYZ → /backup-memory XYZ ✅。③④ 菜单配色（改了三次才对，过程值得记）：他先在网页端（浅色主题）发现字看不清，再在桌面端（深色主题）发现背景是半透明的。第一次错：背景用了 --dsw-alias-bg-elevated + 深色兜底 —— 实测这个变量在 DSH 里根本不存在，所以深色兜底永远生效，而文字用的是存在且跟随主题的 --dsw-alias-label-primary → 浅色主题下 深底深字，对比度实测 1.25。第二次错：改用官方语义变量 --dsw-specific-menu —— 它存在，但在深色下是 #43454a73（alpha 0.45），那是配合 DSH 自己的背景模糊用的；我没加模糊，于是对话内容直接透过菜单 ✓ 被他抓个正着（他的截图给了决定性证据：同一屏上面板实心、菜单半透明）。最终修法：背景改用面板自己用的那个变量 --dsw-specific-tip（两个主题都是实心 ✓），并加 backdropFilter: blur(8px) 当保险；文字/悬停仍走主题变量。实测（这次专门量"透明度"这个属性本身，因为前两轮就是没量它才来回翻车）：浅色 → 面板与菜单同为 rgb(245,246,247)、alpha=1、对比度 17.46；深色 → 同为 rgb(53,54,56)、alpha=1、对比度 11.57 ✅。顺带：右键菜单之前完全没有 hover 反馈，这次补上了（和面板行同一套做法）。⑤ 提示条常驻不消失：他问 这个消息停留得也太久了吧，多少秒啊你 —— 提示条是 toast，本该自己消失，我漏了超时。修法：普通成功提示 2.6 秒自动消失；带「撤回」的（卸载）给 10 秒，因为撤销它等于撤掉唯一一条退路；面板重新打开时清空（上次的提示已经过期）。验证教训：我自己的探针先报"10.27 秒"、又报"产物里没这个数字"，两次都是我的检查写错了（探针在提示条消失后误抓到了「⏻ 已关闭」分组标题；检查条件写死 10000 而 esbuild 把它印成了 1e4）—— 他说"我测了其实对的"，是他对的。先怀疑自己的量具，再怀疑代码。 ⑥「已关闭」从常驻分组改成右下角一个入口：他的原话是 它应该跟我红方平齐，放在靠右下角的位置 + 点击后里面显示的都是所有已关闭的 skill + 在已关闭的 skill 列表中右键可以像刚刚一样弹出列表 + 不然你这个"已关闭"是不是有点太占地方了，它一直显示的话。修法：底部那行改成 justify-content: space-between —— 左边是操作提示（切到已关闭视图时提示也会随之变成「右键 = 开启 / 定位」），右边是一个小胶囊 ⏻ 已关闭 N；点它整个列表切换成已关闭视图（搜索框同样能过滤它，走同一个 matchRank），再点一次变 ← 全部技能 切回来；视图里右键/长按弹同一个菜单（对已关闭的技能只给「开启 / 定位」，不给「置顶 / 卸载」）。面板每次打开重置回全部视图（免得它停在上次的视角里）。顺带删掉了没人用的 actionSpanStyle。实测（真浏览器，用一个自己建的假技能走完整条路）：全部视图 → 胶囊显示 ⏻ 已关闭 1 且右对齐 ✓、已关闭的技能不在主列表里 ✓；点胶囊 → all=false / listsClosed=true / listsNormal=false、提示变成「右键 = 开启 / 定位（手机长按）」✓；右键 → 菜单恰好是 /zz-view-selftest、⏻ 开启、📂 在文件管理器中定位 ✓；点开启 → 该行消失 ✓。测试后验证过磁盘：只剩他自己 8-13 关的 web-design-guidelines 一条，64 个技能一个没动。⑦ 字体统一：他的要求是 我想你用和右下角选择模型里的英文和中文一样的字体，这样才显得跟 DSH 比较统一。先量再改（避免又猜）：把模型选择器 DeepSeek V4.1 Flash 和面板里每处文字的 fontFamily/size/weight/lineHeight 全读出来对比，结果字体族本来就一样（都是继承 DSH 的 --dsw-font-family），真正不一致的是技能名那一处——它被我刻意写成了 --ds-font-family-code（等宽代码字体），当初的理由是"/技能名 看起来像命令"。另外面板行还落在浏览器给 <button> 的默认字号 13.3333px 上（不是我声明的）。修法：新增 FONT_FAMILY = var(--dsw-font-family, …) 并在面板根、搜索框、行、名称、描述、状态行、菜单全部显式声明（不再靠继承碰运气），字号对齐 composer 的节奏（正文 14px / 行高 22-24px、次要文字 12px）；ui-monospace 依赖清零。实测：模型选择器 14px / 400 / line-height 24px、面板技能名 14px / 400 / 22px、搜索框 14px、描述与页脚 12px ✅。教训：我第一版探针又量错了元素（抓到了外层容器而不是 nameStyle 那个 span），所以第一次得出结论"字体本来就一样"——量要对准真正落到属性上的那个元素。⑧ 分组小标题 + 去掉 emoji：他继续追问 这两个也是吗？感觉看着不像啊。就是这个小标题，还有，我感觉这图标没必要吧。加图标，那前面一团火，这种图标看着不像 DSH 的风格。照旧先量再改：拿 DSH 自己的分组标题（侧栏「工作区」）当基准，测出我那个小标题是 11px / 600 / letter-spacing 0.44px，而 DSH 是 14px / 400 / normal —— 又小又粗还带字距，这就是"不像"的全部原因；改完两者逐项一致（连颜色都是同一个 rgb(129,133,140)）。图标全部去掉：分组标题的 📌/🔥/🗂️、右键菜单的 📌/⏻/📂/🗑、底部入口的 ⏻ 全部改成纯文字（分组标题本来就是标题，DSH 的标题也是纯文字）。唯一保留的是行尾那个置顶针（📌/📍）—— 它是有功能的开关（点一下置顶），只有置顶的行才亮。后来他也把这一条否掉了：那个置顶的按钮也不需要了吧，毕竟右键它就能有置顶 —— 于是行内那个针也删了，置顶/取消置顶只走右键菜单（「置顶」分组本身就说明了哪些被置顶）。至此整个面板零 emoji（实测 anyEmojiInPanel: false），行内只剩名称 + 描述。⑪ 底部提示的最终形态：他先说 这句话感觉有点影响美观，因为它和上面的都对不齐，而且它又显示不完全 —— 于是对齐 + 缩短，并做成"用过一次右键就永久隐藏"（localStorage 标记）。他看完之后改主意：我感觉你变成这一行就不错，那你就可以永久留着了，因为它一直显示很短，可以留着 —— 于是撤掉一次性逻辑，永久显示「右键可管理 · 手机长按」（已关闭视图里是「右键可开启 · 手机长按」）。实测：连开三次（含用过菜单之后、整页刷新之后）提示都在、aligned: true（左边与行文字对齐 = 列表 6 + 行 10 的 margin-left:16px）、truncated: false（不再出现「手机…」）✅；那一版的一次性标记已从代码删净（showHint/RC_HINT_KEY 0 命中）。⑫ 搜索框：他的要求 我这个搜索框能不能变成这个模型搜索的样式？我感觉确实可以跟 DSH 去统一一下。这次没能量到基准 —— 模型选择器里那个搜索框不是 <input>（三次探针分别在 input 列表、占位符匹配、全元素扫描里都找不到它），所以按他两张截图的视觉差异改：去掉那 1px 边框（透明边框以保持几何不变），保留淡填充；因为无边框就没有焦点提示，补上聚焦时一圈细环（boxShadow: 0 0 0 1px，用 React 的 onFocus/onBlur 实现 —— 内联样式写不了 :focus）。实测：失焦 border: 1px solid rgba(0,0,0,0) + 背景 rgba(38,49,72,0.06) + 无环；聚焦背景升到 0.1 + 一圈 0 0 0 1px；尺寸始终 324×36，不会跳动 ✅。后来他又微调高度：改成30看看，就是行高减个六 → 再加回3吧 → 32吧。关键坑（值得单独记）：前两个数字根本没生效 —— 面板是 flex-direction: column + max-height 的容器，输入框作为 flex 子元素被压缩到了 21px，所以不管写 30 还是 33 渲染出来都是 21（他"看不出变化"正是这个原因，我还只改了数字）。直到给输入框加 flex: none，声明的 height 才第一次真正生效 —— 在 flex 容器里改子元素高度，先确认它没被 flex-shrink 吃掉。最终实测 height: 32px ✅。⑨ 关闭的技能还出现在主列表里（他报的，严重）：我不是关闭了吗？这列表里居然还有他。先排除最常见的嫌疑：全盘搜 web-design-guidelines 的副本 —— 没有第二份，磁盘上就那一个目录、且确实是 SKILL.md.disabled（他自己 8-13 关的）。根因：取列表有两条路 —— 官方 skills API，和「本地扫描」兜底；为了「已关闭」视图能工作，我的扫描器是故意会返回 disabled 条目的，但前端把两条路的返回值当成了同一种形状 ✗ → 关掉的技能就从兜底那条路混进了主列表。修两层：① 扫描结果里 disabled === true 的直接不进主列表；② 主列表再按名字排除所有已关闭的技能 —— 这是唯一的构建点，不管数据来自哪条路都兜得住。实测（用他真实的那个技能验，不造数据、不写任何文件）：主列表 mentionCount: 0 ✅、在主列表里主动搜 web-design 仍是 0 ✅、底部入口显示 已关闭 1 ✅、「已关闭」视图里恰好出现 1 次 ✅；测试后复验磁盘：仍关闭的只有他这一条、技能数 64 不变。全量 npm test：88 tests / 87 pass / 0 fail
• v0.5.25：修 ⚡ 面板的弹出位置：改成贴窗口右边缘，不再横跨正文——国豪反馈：我感觉点这个按钮，列表出现的位置不太好。如果再靠右显示就好了。根因：面板原本是 position: absolute; right: 0，贴的是 ⚡ 按钮自己的右边缘 —— 而 ⚡ 挨着模型选择器、离输入框右边缘还有 200 多像素，所以面板被"右对齐"到那个位置，于是往左横跨半个屏幕、压住对话正文。修法：改成 position: fixed + right: 24px（贴窗口右边缘），纵向偏移仍由 ⚡ 按钮的 getBoundingClientRect() 量出来（打开前就量好，避免第一帧跳一下）。实测（真实浏览器里量的坐标，不是目测）：面板右边缘 x=1488、窗口宽 1512 → 距右边 24px ✅；改之前它右边缘只会落在 ⚡ 按钮那里（x≈1083）。全量 npm test：88 tests / 87 pass / 0 fail
• v0.5.24：删掉面板底部那两个徽标（「本地扫描」/「/ 增强：运行时接管」）——国豪的反馈：确实有了，不过本地扫描和增强感觉没必要啊，感觉有点占地方，有点多余。他说得对：它们是"给排障的人看的"，不是给用户看的，却常驻占掉两行。但没有直接丢掉 —— 「插件一切正常」和「插件压根没在跑」在界面上一模一样，这正是 issue #14 的教训，所以信息搬到了不占地方的两处：① ⚡ 按钮的 tooltip（鼠标悬停才显示，如 选择技能（插入 /技能名 到发送框）　·　列表来自本地扫描　·　/ 增强：运行时接管）；② 控制台一行（面板每次打开打印一次：技能条数 + 列表来源 + / 增强是否真的生效）。顺带把已经没人用的 sourceBadgeStyle / sourceBadgeTextStyle 一并删除。全量 npm test：88 tests / 87 pass / 0 fail
• v0.5.23：⚡ 面板里可以直接管理技能了：关闭 / 开启 · 定位 · 卸载（可撤回）——起因是国豪视频评论区有人问"能加一个管理 skill 功能吗？实现删除、加、启动、关闭等操作"。查证结论：官方没有任何技能管理界面（把 asar 里 289 个官方包全扫了一遍，没有禁用/卸载技能相关代码；评论里说的"专门的插件"指的是 find-skills 那种搜索+安装的 skill，只解决"加"），所以这块是真空白。交互方式（国豪的主意，比我的第一版好）：动作不占行内 UI，而是右键技能行弹出一个小菜单（置顶 / 关闭 / 定位 / 卸载），手机则长按 500ms 弹同一个菜单（滑动即取消，长列表滚动不会误触）；行内只留一个 glyph（📌/📍，兼作"已置顶"状态指示）。踩到的 UI 坑：关闭监听最初挂在捕获阶段，会在菜单项自己的 onClick 之前就把菜单关掉 → 点了没反应；改成冒泡阶段 + 菜单自身 stopPropagation。①「关闭」是真关闭，不是障眼法：读了官方 dsh-skill-filesystem 的判定逻辑 —— 一个技能 = 目录下有 SKILL.md（大小写严格），或技能根下的顶层 .md。所以关闭就是把 SKILL.md 改名成 SKILL.md.disabled：provider 直接看不见它，agent 也不再加载，要回来只需改回名字。②「卸载」从不删除：移进 $DSH_HOME/skill-backups/<时间戳>-<名字>/（旁边写 manifest.json 记原路径），面板里出现「撤回」；skill-ops.js 里一个破坏性文件调用都没有，而且有一条结构性回归测试盯着这件事（注释里出现过破坏性调用的名字都会让它红 —— 这是它第一次触发时教我的）。跨盘无法 rename 时直接报错，绝不退化成"复制+删除"。③ 三道安全闸（这些路由不需要鉴权就能到达，所以不是可选项）：请求必须带 x-dsh-skill-picker: 1 自定义头（跨站表单 POST 设不了自定义头，CORS 预检 host 也不应答）；客户端只报技能名，路径由 host 自己查（⚡ 面板主数据来自官方 API，那套 DTO 不保证带 path；而且浏览器说了不算）；路径必须恰好落在已知技能根的一层之下（../ 逃逸、根目录本身、技能内的文件、任意绝对路径全部拒绝）。④ 一个必须补的洞：官方 skills/list 不会返回已关闭的技能 → 关掉之后就再也找不到、开不回来了；所以面板额外拉一次 host 扫描，单独渲染「⏻ 已关闭」分组专门用来开回来。⑤ 真机端到端实测（用我自己建的假技能，全程只动它一个）：关闭后磁盘上 SKILL.md→SKILL.md.disabled ✓、扫描仍能列出它且 disabled:true ✓（这是"能开回来"的前提）、开启还原 ✓、卸载后原位置消失而备份里 SKILL.md+manifest 完整 ✓、backups 能列出 ✓、restore 回原位 ✓、不带自定义头 → 403 ✓、name 塞 ../../../Windows/System32 → 404 ✓、GET → 405 ✓；测试后你的技能数一个没变、备份目录零残留。回归测试：新增 test/skill-ops.test.mjs 13 例（路径闸 9 种情形、关闭/开启往返、重复关闭拒绝、开启未关闭的拒绝、卸载后原位置消失但备份完整且 manifest 正确、撤回后再占用时拒绝覆盖、备份原路径被改成根外后不可撤回、备份 id 不允许带路径、"模块里不存在破坏性调用"、无 manifest 的杂目录被忽略、备份目录必须落在 DSH_HOME 下）。全量 npm test：88 tests / 87 pass / 0 fail
• v0.5.22：「置顶 / 最近使用」改成两端（乃至手机）共用一份——起因是国豪发现"桌面端和网页端的置顶不一样"，并当场质疑"不就读同一个配置吗，要一个小时？"。他是对的，而且根因就是"读的不是同一个配置"：localStorage 按源（origin）隔离，桌面端是 dsh-app://app、网页端是 http://127.0.0.1:3080、手机连上去又是第三个源 —— 同一份数据被存了三遍，所以在桌面端钉的技能网页端永远看不到。修法（约 40 行 host + 一个客户端模块，不是重写数据层）：host 侧新增 /dsh-skill-picker/state（GET 取 / PUT 存），存到 $DSH_HOME/dsh-skill-picker-state.json（写用 temp+rename，原子）；客户端新增 src/client/shared-state.js，把这份母本镜像进 localStorage，于是渲染期的同步读取一行都不用改（原来的数据路径是同步的，改成异步要动一大片 —— 这个顾虑没必要）。细节：① 每次 savePinned/saveUsage（含 / 菜单里的选中记录）都会自动回推；② 插件启动时 + ⚡ 面板每次打开时都会拉取，所以另一端改了立刻能看见；③ 首次同步用并集、之后才跟随（关键，实测中发现的坑）：host 端 ?migrate=1 会把收到的状态与已有状态合并再返回；客户端用一个 dsh-skill-picker:shared-synced 标记区分"这台还没同步过"。没同步过且本地有数据 → 走并集迁移（绝不覆盖）；同步过 → 直接采纳文件（所以"在 A 端取消置顶"能真的传播到 B 端）。为什么必须有这一步：如果首次也直接采纳，那么哪台客户端先启动，文件就被它写成什么样，后面启动的那台就会丢掉自己独有的钉子 —— 桌面端 3 条、网页端 2 条的情况下，网页端先起就会把桌面端的 ji-zhang 吃掉。端到端实测时正是这条被暴露出来的；④ 文件不存在 / 为空而本地有数据时，推送而不是覆盖为空；⑤ 全程 best-effort：host 不可达时行为和以前完全一样（纯本地），绝不会因为同步失败把选择器弄坏。回归测试：新增 test/shared-state.test.mjs 7 例（拉取即镜像、缺文件时以本机播种并带 migrate=1、迁移返回的并集被本地采纳、远端为空时不把本机数据清成空、推送内容正确、host 失败时一律返回 false 且不抛、同步后会广播事件让界面重读）。全量 npm test：72 tests / 71 pass / 0 fail
• v0.5.21：文件补丁正式退休：默认不再改官方文件，并自动把改过的还原回去——起因是国豪发现同一件事桌面端对、网页端不对，并直接怀疑到"之前魔改过"。查证结果：他猜对了。 两端加载的官方 @deepseek-ai/dsh-client-ui-skill 根本不是同一份：桌面端从 app.asar 取（打包只读，永远是原版），网页端从 ~/.dsh/profiles/node_modules/ 取共享那份 —— 而那份被本插件的老文件补丁改过（实测：__dshSkillPickerFuzzy×2、order: -1，旁边躺着 .bak）。这个差异为什么会让排序看起来不一样：补丁把官方 candidates 改成走 window.__dshSkillPickerFuzzy，而它返回的已经是「置顶+使用热度」排好序的列表；我的包装层再做一次排序时，groupByPinned 把「🗂️ 全部」分组的输入顺序保留下来（同热度时的稳定排序）——于是网页端的「全部」是使用热度序、桌面端是字母序。根因级别的问题：文件补丁自 v0.5.15 起已是纯冗余 —— 它只做三件事（技能组置顶 order: -1、模糊+拼音匹配、onPick 记使用），而运行时接管三件全都自己做了。它却仍在改用户的官方包，还让两个 profile 对同一个文件产生分歧。修法：① 新增 revertUiSkillPatches()，启动时只针对"仍带我们标记"的文件从 .bak 还原（用 temp+rename，绝不动 pnpm 硬链接的共享 inode；幂等）；② 文件补丁改为默认关闭，只有显式设 DSH_SKILL_PICKER_FILE_PATCH=1 才走旧的自愈路径（给"触发源注册表里没有 live sources 可接管"的老内核兜底）。本机已实测还原：共享那份 lib/client.js 现在 __dshSkillPickerFuzzy=0、order: 2、hash 与 .bak 完全一致。全量 npm test：65 tests / 64 pass / 0 fail
• v0.5.20：/ 菜单的空查询也走排序，「置顶」技能排到最前面（与 ⚡ 面板一致）——国豪指出：按 ⚡ 按钮时列表是「📌 置顶（3）」在前、再「📁 全部（57）」，但直接打 / 出来的却是纯字母序、置顶不在前面，两边排序不一样。根因：包装层对空查询做了短路 —— if (query === '') return cached / if (query === '' || ...) return everything，即"空查询把官方列表原封不动返回"。而 ⚡ 面板走的是 rankPickerItems(items, '')，它会先 groupByPinned(...) 把置顶提到最前。于是同一个数据源、两套排序。 修法：去掉空查询短路，空查询也交给 rank() —— rankPickerItems(items, '') 本就设计为"空查询 = 全部条目、按面板顺序（置顶优先）"，所以两边从此同源同序。顺带发现一条假通过的测试：旧的 an empty query returns the official result untouched 里 rank 是故意抛错的，而 rank 一抛错就被包装层的 try/catch 兜住、仍然返回官方列表 —— 也就是说那条测试测的是兜底路径，不是它声称的语义，所以它在新行为下照样"通过"。已改写为正面断言：空查询必须调用 rank，且置顶技能排第一。全量 npm test：65 tests / 64 pass / 0 fail
• v0.5.19：修掉 v0.5.17 里"预热走错了路"的 bug（0.5.18 因 npm 发布延迟被误判为"卡住"，实际已发布；两者代码逐字节相同）—— 上一版已经把胜负手找对了（技能组要 0 个 await 才抢得到高亮），但它预热时调的是官方 source.warm()：warm() 只预热官方模块自己的缓存，插件自己的 itemCache 依然是空的 → 菜单打开那次仍然未命中、仍然 await 官方、仍然比命令组多一跳、仍然输。这一条是从运行诊断里确认的：{"mode":"runtime","installed":true,"took":"candidates+order+onPick"} 与 {"servedFromCache":false,"sessionId":"session-de1f2494-…","primed":true,"count":71} —— 即"接管装上了、缓存也被填过，但菜单那次仍是 servedFromCache:false"。修法：预热改为走插件自己的包装路径（一次空查询 candidates），一次调用同时填满两层（包装层写快照 + 官方层自然预热）。另：缓存热重载后不再被清空，所以重载后的第一次打开也是命中。桌面端已实测确认修好。回归测试：新增一条直击要害的用例 —— 官方取数故意慢 60ms，预热后菜单调用必须在 30ms 内返回；另把"预热走官方 warm()"这条反例锁死（断言不会只调 warm()）。全量 npm test：65 tests / 64 pass / 0 fail
• v0.5.18（从未发布到 npm）：修复内容与 0.5.19 完全相同，但版本号因 npm 暂存槽位冲突（E409 Cannot publish over previously staged version）无法发布，改用 0.5.19。教训：npm 上"已 staging"的版本号会被占住且 npm stage list 看不到，直接换号最快。
• v0.5.17：修复「打 / 时菜单开到下面去、高亮不在第一条技能」——症状是输入一个 /，菜单滚到底部、高亮停在命令组（添加 / 文件 或 指令 / compact）上，而不是停在最上面第一条技能。根因：官方斜杠菜单的高亮是一条「谁先就绪谁拿高亮、拿到就粘住」的规则 —— highlight = validHighlight(旧高亮, groups) ?? firstHighlight(groups)，firstHighlight 取的是第一个「已就绪」分组的第一条；随后 scrollIntoView({ block: "nearest" }) 把高亮滚进视野。本插件为了让技能组排在最上面把它的 order 从 2 改成 -1，于是命令组一旦先就绪，高亮就落在它身上、而它现在被压在技能组下面 → 菜单往下滚去够高亮。关键：这是 microtask 跳数的比赛，不是网络快慢 —— 「已就绪的 promise」await 一次就是一个 microtask；实测三种写法的胜负（技能组在 roster 里排第一，命令源至少一层 await）：| 写法 | 先就绪 | |---|---| | 包装层 await 官方 candidates（2 跳） | 命令组 ❌ | | 不 await，但返回官方那个 promise（adoption 仍要多跳） | 命令组 ❌ | | 命中自己的缓存，0 个 await 直接返回 | 技能组 ✅ | 所以光"提前预热"没用（0.5.16 就是这么改的、也是这么失败的：即使目录已热，我们仍比命令组多一跳）。修法：插件自己按 Session 缓存一份完整展示列表（itemCache），candidates 命中缓存时不 await 任何东西直接返回 —— 它返回的 promise 在调用点就已 resolve，.then 的 microtask 排在命令组之前，从构造上稳赢；未命中才走官方取数并写缓存。缓存由 warmSlashSkill(sessionId)（⚡ 组件挂载 / 会话切换）预热，且每次命中都在后台刷新一次，所以最多"落后一次打开"。同时修掉 0.5.16 引入的三个缺陷：① 预热在组件挂载时执行，而那时接管还没装好（接管带重试），依赖项又不变 → 预热从未真正跑过；现在把请求存起来，由 wrapSkillSource() 落地时一次性消费。② pendingSessionId 粘住不消，会让下一次安装去预热一个过期会话；现在改为"消费即清"，并在撤销接管时清除。③ 缓存最初存的是官方返回数组的引用（测试里 list.push() 直接把缓存改了）→ 现在存 slice() 快照。注意：order: -1（技能组置顶）保留 —— 它是这个 bug 的「放大器」而不是原因，且是早先明确要的特性。另记一笔查证过程：截图里那个「添加 / 文件」一开始认不出是谁，后来在 dsh-client-ui-commands 的词条里翻到 "section.add": "添加" —— 它和「指令」是同一个命令源的两个分区，不是第二个来源。回归测试：test/slash-source.test.mjs 增至 25 例（新增：命中缓存不再回官方取数、后台刷新会在下次打开补齐新技能、缓存命中仍走排序、会话之间缓存不串、接管落地前提出的预热请求不丢、缓存存快照而非引用；另加 beforeEach 清模块级状态，避免用例互相污染）。全量 npm test：65 tests / 64 pass / 0 fail（1 skip 是 Windows 建文件符号链接需权限那条）
• v0.5.16（仅推 GitHub、从未发 npm）：同一条 bug 的第一次尝试，未修好 —— 只加了「提前预热技能目录」，没有解决"我们比命令组多一跳"这个真正的胜负手，因此现象照旧。保留这条记录是因为它的失败本身是结论：在 microtask 竞争里，"数据取好了"和"我们的 promise 更早 settle"是两件事。
• v0.5.15：/ 菜单增强改为「运行时接管」，彻底不碰文件（对应 issue #14）——这一版把插件最脆的那根线拔掉了。背景：让 / 支持模糊 + 拼音，v0.4.0 起的做法是改写官方 @deepseek-ai/dsh-client-ui-skill/lib/client.js 这个文件。但"那个文件是不是一个可写的普通文件"完全不由插件决定：打包桌面端把它放在 resources/app.asar 里（只能读、不能就地写）、pnpm 把它硬链接进共享 store、Desktop → NEXT 迁移后共享根的软链整批悬空——任一情况都让补丁静默失效（更糟的是它还会"成功"地给一份没人在用的副本打上补丁，日志看着一切正常）。新做法：官方 @deepseek-ai/dsh-client-ui-input-trigger 把源注册表放在服务实例字段 live.sources 里，里面就是活源对象，而斜杠菜单是每次调用时现取 source.candidates（不是注册时抓一份引用）——所以插件可以在运行时把官方那个源的 candidates 接管，自己接管匹配，一个文件都不用动，app.asar / 硬链接 / 软链三种形态一次全解决。两个必须讲清的技术点：① 不能注册同名源——registerSource 对 (trigger, name) 有唯一性硬检查（重名抛 slash source "/skill" is already registered），这正是 v0.2.0–0.3.4 那条"平行源"路线被官方堵死的原因，也是后来才被迫去改文件的由来；接管已有源才是门开的地方。② 必须用空查询向官方要全量——官方 candidates 返回的是已映射的展示项，而且已被官方匹配器过滤过，模糊查询要匹配的技能根本不在里面；用空查询调用则 rankByName(items, "") 原样返回全部，官方可见性规则（userInvocable 过滤、子智能体会话排除、「仅用户可调用」文案）也都已由官方代码先执行过。本版修正（0.5.14 是个只推了 GitHub、从未发到 npm 的中间版）：① 0.5.14 把源注册表当成 ctx.inputTriggers.sources('/') —— 那个 {sources, all} 实际属于每个会话 controller 内部的 roster，不在服务上，于是查找永远 undefined、接管静默地什么都没做；现在按 live.sources → sources() → all() → roster.* 依次尝试，并用回归测试锁死真实形状（InputTriggerService 的成员只有 inject, live, constructor, registerSource, sessionOf, sessions）。② 接管失败不再是静默的：放弃时打 console.warn 指向 #14，接管成功时 ⚡ 面板底部显示「/ 增强：运行时接管」徽标 —— 一眼就能看出到底有没有生效。顺带：⚡ 面板与 / 菜单现在共用同一个 rankPickerItems()，两处匹配结果与排序不可能再不一致；文件补丁保留为旧内核兜底（两条路不打架：运行时接管始终以空查询取全量）；启动告警里指向已关闭 issue #9 的链接改为指向 #14。回归测试：test/slash-source.test.mjs 共 15 例（真实 live.sources 形状、roster 形状、无关源跳过、只取 (/,skill)、服务缺失/getter 抛错时降级、空查询取全量、空查询不排序、排序抛错仍返回官方列表、顺序接管与还原、onPick 接管且保留官方返回值、tracker 抛错不吞官方返回、dispose 还原且清标记、重复接管为 no-op、非源对象忽略、冻结源不抛错、模式徽标状态、迟到注册的重试安装、永不出现时告警放弃）。全量 npm test：58 tests / 57 pass / 0 fail（1 skip 是 Windows 建文件符号链接需权限那条）
• v0.5.13：适配 DSH 0.2.0 线（对应 issue #13、#11、#9）——这一版修的是三件不同的事，但它们有一个共同的教训：插件"没坏"和"没在跑"长得一模一样。
  • ① 内核加载门不再拒载（issue #13）：peerDependencies 里六项 @deepseek-ai/dsh-* 全钉在 ^0.1.0-rc.6，semver 上界是 <0.2.0-0，于是 DSH 0.2.0-rc.1 / rc.2 启动时直接 skip 掉整个插件（dsh: skipping profile bundle "dsh-skill-picker"），⚡ 按钮凭空消失、没有任何其它症状。关键点是：这不是"真不兼容"，是"声明过度"——dsh-app-boot 的 evaluatePluginCompatibility() 是拿内核版本去逐项比对 @deepseek-ai/dsh* 的 peer 范围，而这些包与内核锁步同版本（实测 dsh / dsh-app-boot / dsh-client-locale / dsh-client-ui-slots / dsh-host-webserver / dsh-skill / dsh-system-prompt / dsh-client-ui-skill 全是同一个号），所以钉住一个小版本线 = 内核每跳一版就必然误拒一次。现在改为 ^0.1.0-rc.6 || >=0.2.0-rc.1 <1.0.0-0：0.1.x / 0.2.x 及以后所有 0.x 都能加载，到 1.0.0 才需要重新确认。真正的"已验证"信号交还给 dsh.compatibility.dshReleases 兼容表（本版补上 0.1.7-rc.1、0.2.0-rc.1、0.2.0-rc.2）
  • ② 项目级技能不再消失（issue #11，由 @Arcobalneo 定位并提交 PR #12）：0.1.7 起 ⚡ 面板静默丢掉整个项目级技能层（<workspace>/.agents/skills 里的技能一支都不出现，用户级正常，无报错无 warning）。两条取数路同时退化：主路 remote.skills.list 的 gate 读 props.session?.sessionId，而 session scope 插槽给的是框架标准 prop sessionId、没有 session 对象 → 这条路一次都没发过请求；兜底路用 ctx.sessions.list.getSnapshot().current 定位当前会话，而 0.1.7 的 store 状态是 { ids, byId, phase, projectionsBySession }、没有 current 游标 → currentCwd 恒为 '' → 请求退化成不带 ?cwd= → 只扫用户级。修法是把"会话身份 + 工作区 cwd"收敛到新模块 src/client/session-view.js，两路都只依赖座位自己的标准 props。本版在其之上补了一处：props.useSessions 座位在 0.1.2 / 0.1.5 内核上可能不存在，那样 cwd 会退化回空串——所以把旧的 ctx.sessions.list.current 取值保留为次级来源，仅在标准 props 取不到时使用，避免"修了 0.1.7、砸了 0.1.5"
  • ③ 桌面端补丁目标不再静默打偏（issue #9）：候选路径新增活动桌面安装树（<resources>/app/node_modules/@deepseek-ai/…，从 Electron 的 process.resourcesPath 推导，解除安装的 desktop 构建就此命中，无需再靠 profile 里的软链）。同时把最坑的静默变成自诊断：打包型桌面构建把官方技能 UI 放在 resources/app.asar 里，asar 只能读、不能就地写，而只要 profile 没有把该包 link: 到本地副本，真正被服务的就是 asar 里那份——此时老代码会"成功"地给一堆 profile 副本打补丁（patched: [...]，看起来一切正常）却对用户毫无影响。现在这种情况会明确 console.warn 指出「补丁已打，但打的不是你实际在用的那份」以及该怎么救
  • 回归测试：新增 test/desktop-paths.test.mjs 6 例（无 Electron 环境下惰性、命中解除安装树、真正打上三个补丁、打包场景必须告警、profile 有重定向时保持安静、零目标时指向 issue #9）。全量 npm test：40 tests / 39 pass / 0 fail（1 skip 是 Windows 建文件符号链接需权限那条）
• v0.5.12：修复 user-invocable: false 的技能仍出现在 ⚡ 面板（对应 issue #10）——面板取数有两条路：① 官方宿主 API（remote.skills.list）在服务端就过滤好了（dsh-api-session-controller 的 skill-catalog 里是 .filter(isUserInvocable)，且它的线上 DTO SkillEntry 只带 modelInvocable、根本不带 userInvocable）；② 本插件自己的兜底扫描路由（/dsh-skill-picker/skills，面板底部显示「本地扫描」徽标那条）只读 name / description，完全没读调用策略 —— 这就是 0.1.7 线（官方客户端 UI 包重构、兜底路径被触发）下面板会列出 user-invocable: false 技能的原因。危害不止"多显示一条"：点选后插入的 /技能名 手势会被 dsh-tool-skill 的 !isUserInvocable(skill) 静默跳过——用户以为选中了，实际什么都没发生。修复：host 兜底扫描新增 frontmatterBoolean() / isUserInvocableSkill()，按官方 dsh-skill-filesystem 的 parseInvocationPolicy 完整对齐语义 —— 接受 YAML 布尔与不分大小写的 true/false、yes/no、on/off、1/0；显式 false 不列出；非法拼写或遗留键（userInvocable / modelInvocable / disableModelInvocation）整条丢弃（官方也是丢整条，而不是静默放行）；disable-model-invocation: true 只影响模型面，/ 与面板照常列出。client 侧三个取数点（官方 API / 兜底 fetch / 喂给 / 的模糊匹配器）都加了 isUserFacingSkill() 守卫，同时认平铺 userInvocable 与嵌套 invocation.userInvocable，防内核将来更换协议形状。新增 6 个 npm test 回归用例：user-invocable: false 隐藏、true/省略保留、全部 false 拼写、非布尔值丢弃、遗留键丢弃、disable-model-invocation: true 仍列出
• v0.5.11：修复「补丁已就位也每次启动都打印 ui-skill patch report」（对应 issue #8）——healUiSkillPatches() 返回的 report.files 是逐目标文件的报告数组：只要扫描到 ≥1 个目标文件就有一项，与这一轮是否真的改动过无关；而打印守卫用的正是 report.files.length > 0，等于把「找到目标」当成了「发生了变更」，于是补丁早已 up-to-date 也每次启动都打印一行 [dsh-skill-picker] ui-skill patch report: {…}。这行虽然只是 console.log，但形态上落在启动日志第一行、长得像告警，很容易被误判成插件出问题（#8 就是这么来的），还会淹没真正需要关注的 noop / errors。现在改为按「这一轮到底发生了什么」判定：① 已是最新且无错 → 完全安静；② 仅在确实改过文件（patched 非空）时打印报告，且只报这一轮真正动过的文件 + 全部错误；③ 锚点未命中（noop 非空）单独 console.warn——它的语义是「官方实现又换了形态、增强没打上」，与 issue #7 的静默失效同类，不能再被淹没；④ 新增 DSH_SKILL_PICKER_LOG=debug 显式开关，需要完整报告（含 skipped）时按需打开。新增 7 个 npm test 回归用例：已就位时静默、无目标不重复报、真改动打一行、noop 转 warn、仅错误转 warn、改动+错误合并一行、debug 开关
• v0.5.10：修复全局安装下 / 补全增强静默失效（对应 issue #7）——uiSkillClientPaths() 原先只枚举两个位置：profiles/<profile>/local/dsh-client-ui-skill 与 profiles/<profile>/node_modules/@deepseek-ai/dsh-client-ui-skill。但用全局 npm i -g @deepseek-ai/dsh 安装时，官方包位于共享根 profiles/node_modules/@deepseek-ai/dsh-client-ui-skill（readdir(profiles) 只会给出 node_modules 和 web 两个条目，两个候选全部落空），于是 found = []、两个补丁一次都没跑——而且完全无声：{"files":[],"errors":[]} 与「补丁都已应用、全部 skipped」在输出上一模一样，用户和排查者都看不出补丁根本没生效，表现成「插件一切正常、技能列表能用，就是拼音/模糊搜索是坏的」。修复四件事：① 候选新增共享根（不属于任何单个 profile，放在循环外采集）；② 每个 profile 额外走一次 Node 自身解析 createRequire().resolve() 兜底，未枚举到的布局也能命中（按 realpath 去重，不会重复打补丁）；③ 跳过 profiles/node_modules 这个假 profile 条目；④ found.length === 0 时 console.warn 大声报出——这个静默正是 issue #7 里最坑人的地方。另修写入方式：由原地 writeFile 改为临时文件 + rename——pnpm 安装的包是硬链接到共享内容寻址 store 的，原地写会连带改动 store 里的同一份（影响其他使用同版本的项目），rename 只替换目录项、不动共享 inode，顺带获得写入原子性（中断的启动不会留下半截文件）。新增 6 个 npm test 回归用例：共享根、profile local、profile node_modules、共享根+profile 去重、无任何安装、profiles 目录缺失
• v0.5.9：修复符号链接 / Junction 型技能查不到（对应 issue #6）——扫描技能目录时 readdir 的 Dirent 走的是 lstat 语义：Windows 下符号链接和 Junction 都报告 isDirectory() === false / isSymbolicLink() === true，于是链接型技能（如 ~/.agents/skills/neat → D:\repos\icraft-toolkit\skills\neat）在第 79 行的目录过滤里被静默 continue 掉。现在链接条目改用 stat（跟随链接）判定真实类型：链接型技能与普通目录完全一视同仁，断链或指向普通文件的链接安全跳过（不再抛错、也不占用列表）。四个扫描根（~/.agents/skills、~/.dsh/skills、项目级 .agents/skills / .dsh/skills）与 profile 枚举路径全部受益；新增 npm test（node --test）回归用例：普通目录、链接目录、链接+普通混排、断链、无 SKILL.md 的链接、项目级链接技能
• v0.5.7：搜索结果按匹配相关度排序——⚡ 面板与 / 补全统一：名字开头匹配 > 名字包含 > 描述 > 拼音，置顶/最近使用只做同级次序；同时过滤掉纯粹"字母分散"的子序列噪音（如搜 svg 不再混入 deepseek/openviking 等恰好含 s-v-g 分散字母的技能）。svg → svg-diagram 稳居第一
• v0.5.6：AI 安装指引升级为「GitHub 直装优先」——快速安装部分改为给 AI/安装助手的优先级决策树：①要最新版/不确定 → git+ssh GitHub 直装（git 依赖拉最新 commit，天然绕过 npm 24h 门禁，百分百新版）；②要 npm 正式版 → 先 npm view 查版本再指定 @版本 安装；③禁止裸名安装（24h 内会落回旧版）
• v0.5.5：安装指引升级（AI 友好）——README 快速安装改为「先 npm view dsh-skill-picker version 查版本号 → 再 add dsh-skill-picker@版本号 指定安装」，并给 AI/安装助手显式提示：新版本发布后 24 小时内裸名安装会被 minimumReleaseAge 门禁拦截并自动落回旧版，必须指定版本号才能装到最新
• v0.5.4：斜杠选技能后 ⚡ 面板同步变「最近使用」——修复双列表状态不同步：斜杠路径的 usage 记录此前只写 localStorage、面板组件不会刷新（React state 挂载后不再重读），现在 trackPick 写入后会广播 usage-updated 事件，⚡ 面板实时重读；面板每次打开时也强制刷新 usage。两条路径的选择现在双向同步
• v0.5.3：官方 / 列表与 ⚡ 面板排序同步——搜索时 fuzzysort 只决定「哪些技能入围」，入围后的显示顺序统一按 ⚡ 面板规则（置顶 → 最近使用 → 常用 → 其余）；之前 / 列表按匹配分数排序、⚡ 面板按使用记录排序，同一技能在两个列表的相对位置不一致；候选上限 12 → 30
• v0.5.2：官方 / 菜单选技能也记录使用记录——自愈补丁新增第三个 patch（pick-tracking）：官方 ui-skill 的 onPick 会调用插件的 window.__dshSkillPickerTrack，斜杠选中的技能与 ⚡ 面板点选一样进入「最近使用」排序（之前只有按钮路径记账，斜杠路径不记账）
• v0.5.1：host 端自愈补丁——每次 DSH 启动自动扫描所有 profile 的官方 ui-skill 包（local 副本或 npm 安装），自动应用两个升级补丁（order: 2→-1 技能组排到命令组之上；candidates 前缀匹配→模糊+拼音匹配），首次修改前自动备份 .bak，幂等且 DSH 升级覆盖官方包后自动重打。安装本插件即可获得官方 / 补全的完整增强，无需手动改文件（旧版 v0.4.0 的手动 patch 流程退役）
• v0.5.0：⚡ 面板置顶分组 + 修复 alpha.5 草稿丢失 bug
  • 新增手动置顶：面板按「📌 置顶 → 🔥 最近使用 → 🗂️ 全部」分组展示（浏览时显示分组标题，搜索时折叠为置顶优先的单一列表）；每条技能右侧 📍 按钮一键置顶/取消，置顶顺序固定、持久化到 localStorage；/ 补全候选同步置顶优先
  • 修复严重 bug：DSH alpha.5 重构后 conversation.input.right 插槽不再提供 input 快照，点选技能时误走「事件回调内调用 useInput hook」分支（违反 React 规则，抛错被吞 → 草稿读空 → 覆盖用户已输入的内容）。改为渲染期把最新草稿同步到 ref，点击回调只读 ref——追加永远基于真实草稿
• v0.4.0：单列表模糊搜索——不再注册独立 / 候选源，改为 patch 官方 ui-skill 的 candidates（模糊+拼音注入，官方列表是唯一来源，无并列列表、无搜索冲突）；实测 /jiyi → 官方「技能」组 backup-memory 排第一
• v0.3.4：适配 DSH 0.1.2-alpha.5 —— 技能列表改用官方 remote.skills RPC（alpha.5 将 rc.x 的 connection.api.skills 改名），/ 补全与 ⚡ 面板统一「官方 RPC → host 扫描兜底」；dsh.client.inject 声明 dsh-client-ui-input-trigger（alpha.5 装载器只给声明了提供者的插件暴露 inputTriggers 服务）。修复 alpha.5 下 / 模糊/拼音搜索失效（实测 /jiyi → backup-memory）
• v0.3.3：兜底扫描对齐官方全部技能根——补扫 user-agents 层（~/.agents/skills，含 DSH_AGENTS_HOME），扫描顺序与官方 rank 一致（项目级优先于用户级）；走兜底时 ⚡ 面板显示「本地扫描」来源徽标便于排障（对应 issue #5）
• v0.3.2：安装文档修正——实测三种安装方式并补网络特例（HTTPS 受限改 SSH、npm 新版本 24h 内被 minimumReleaseAge 门禁挡旧版的规避方法）
• v0.3.1：README 顶部新增一键快速安装命令（dsh plugin --profile web add dsh-skill-picker）与 npm 版本/许可徽章
• v0.3.0：拼音搜索——/ 补全与 ⚡ 面板的搜索目标加入技能名/描述的拼音全拼（带空格+连打）与首字母索引，中文技能可拼音直搜（如 ji yi →「备份记忆」）
• v0.2.2：⚡ 弹层键盘导航（↑↓ 选择、Enter 插入、Esc 关闭）；按钮盒 28×28 → 24×24，闪电图标 16px（对应 issue #1、#4）
• v0.2.1：声明兼容 DSH 0.1.2-alpha 系列
• v0.2.0：注册为 / 补全候选源（fuzzysort 模糊匹配 + 最近/常用排序，排序规则与 ⚡ 面板统一）
• v0.1.0：初版——⚡ 按钮弹窗搜索点选技能

兼容性与注意事项

• 技能来源：优先走官方宿主 skills API（connection.api.skills.list——与 DSH 内置 / 补全完全同一个数据源，会话作用域，自动覆盖全部官方目录）；官方 API 不可用时自动回退到内置扫描。两条路都支持 DSH_HOME 环境变量。
• 兜底扫描范围：与官方 dsh-skill-filesystem provider 的默认根完全同源——项目级 <workspace>/.dsh/skills、<workspace>/.agents/skills，用户级 ~/.dsh/skills、~/.agents/skills（$DSH_AGENTS_HOME 可覆盖），同名时按官方 rank 项目级优先。走兜底时 ⚡ 面板底部显示「本地扫描」徽标。
• 链接型技能：技能目录里的符号链接 / Junction会被跟随读取（v0.5.9 起，对应 issue #6），链接型技能与普通目录一视同仁；断链、指向普通文件的链接静默跳过，不影响其它技能。
• 暂不支持：自定义技能目录（官方 customSkillDirs 配置）——需要的话欢迎 PR。
• 失败保护：client 端用 ctx.slots.inject（等 conversation.input.right 插槽声明存在才注册，插槽缺失时静默跳过，不会拖垮启动）；host 端路由 try/catch，扫描目录不存在时返回空列表而非报错。
• 依赖版本：peer 范围声明为 ^0.1.0-rc.6 || >=0.2.0-rc.1 <1.0.0-0（v0.5.13 起）——DSH 的启动加载门会拿内核版本逐项比对 @deepseek-ai/dsh* 的 peer 范围，而内核包是锁步同版本的，钉死单个小版本线会让插件在内核每次升级时被误拒（skipping profile bundle，表现为 ⚡ 按钮消失、无其它症状）。真正的"已验证到哪一版"以 package.json 的 dsh.compatibility.dshReleases 为准；要回退只需 dsh plugin --profile web remove dsh-skill-picker。
• 桌面端（Electron）：v0.5.15 起不再需要任何手工处理。/ 菜单的模糊/拼音升级改为运行时接管官方源（见上节），因此官方技能 UI 是放在 resources/app/node_modules/…（未打包构建）还是 resources/app.asar 里（打包构建，只能读不能写）都不影响——app.asar、pnpm 硬链接、迁移后悬空的软链一律免疫。
  • 内核若不提供 inputTriggers 服务，插件自动退回旧的文件补丁路径；该路径的候选顺序是：共享根 profiles/node_modules/… → 各 profile 的 local/ 与 node_modules/ → 活动桌面安装树 <resources>/app/node_modules/…。
  • 旧路径失效时（补丁打在了没人在用的副本上）启动日志会明确告警，v0.5.14 起指向 issue #14；对应的手工自救法是把官方包复制到 profiles/<profile>/local/dsh-client-ui-skill，并在 profile 的 package.json 里加 "@deepseek-ai/dsh-client-ui-skill": "link:…"。

开发

# 安装依赖（提供 esbuild / fuzzysort / pinyin-pro）
npm install

# 构建（源码 src/ → 产物 lib/；client 半自动包 __ModuleLoader__ 握手）
npm run build

# 安装到 web profile（link 模式，改源码即生效）
dsh plugin --profile web add link:$PWD

# 语法自检（产物）
node --check lib/index.js
node --check lib/client.js

⚠️ 改完源码必须 npm run build：lib/client.js 是构建产物，ESM 源码不能直接作 为 client bundle 加载——DSH web shell 要求 client bundle 以 window.__ModuleLoader__.load({ id, factory }) 的 CJS 握手格式注册，否则启动报 loaded without registering "dsh-skill-picker" via __ModuleLoader__.load。 构建脚本（build.mjs）会通过 esbuild 的 banner/footer 自动注入这段握手。

目录结构：

dsh-skill-picker/
├── package.json        # dsh.bundle.patch + dsh.client 声明 + build script
├── cordis.patch.yml    # bundle patch：把插件行插入 web profile
├── build.mjs           # esbuild 构建：host ESM + client CJS(__ModuleLoader__握手)
├── src/
│   ├── index.js        # host 半源码：/dsh-skill-picker/skills 路由 + prompt section
│   └── client/
│       └── index.jsx   # client 半源码：conversation.input.right 插槽组件
├── lib/                # 构建产物（勿手改，`npm run build` 生成）
│   ├── index.js
│   └── client.js
└── README.md

依赖

• host：@deepseek-ai/cordis、@deepseek-ai/dsh-host-webserver、@deepseek-ai/dsh-skill、@deepseek-ai/dsh-system-prompt
• client：@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-slots、react、pinyin-pro（拼音索引，打包进 client bundle）

License

MIT