dsh-skill-panel
A Skills button for the DeepSeek Harness sidebar: one click lists every skill the current session can use — with a Chinese one-liner, where it comes from, and what it does. Click a row to copy its /name invocation.
> 给 DeepSeek Harness 侧边栏加一枚「技能」按钮：点开就是当前会话可用的全部 skill，带中文说明、来源和最近使用，点一行把 /名字 复制到剪贴板。
功能
| 中文说明 | 每个 skill 配一句中文解释（lib/zh.json），界面显示为「中文名｜一句话说明」，英文原文降为次要行 |
| 中文搜索 | 搜索框同时匹配 名称 / 中文标题 / 中文说明 / 英文描述，敲「表格」也能找到 office-xlsx |
| 键盘操作 | ↑ ↓ 选择、Enter 复制、Esc 关闭；鼠标悬停同步高亮 |
| 最近使用 | 复制过的 skill 自动置顶（最多 3 个，存 localStorage），带「最近」标记 |
| 来源可见 | 每条标注来自 .dsh/skills、.agents/skills 还是插件自带，完整路径在 hover 提示里 |
| 翻译进度 | 底部显示「已翻译/总数」，提醒你还有哪几个没写中文 |
| 跟随主题 | 颜色全部走 --dsw-alias-* 主题 token，深浅色自动切换 |
数据走官方 skills/list Remote，所以看到的目录与输入框里敲 / 得到的候选完全一致。
安装
需要 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
脚本只做三件事：把包复制到 \plugins\、在 \node_modules\ 建 junction、在 profile 的 package.json 里登记 dependencies 与 dsh.profile.bundles。
然后重启 DeepSeek Harness。 bundles 是启动期的组合，热加载只对已在运行的 entry 生效。
卸载：.\uninstall.ps1。
手动安装（不想跑脚本）
$p = "$env:USERPROFILE\.dsh\profiles\desktop"
Copy-Item . "$p\plugins\dsh-skill-panel" -Recurse
cmd /c mklink /J "$p\node_modules\dsh-skill-panel" "$p\plugins\dsh-skill-panel"
# 然后在 $p\package.json 里：
# dependencies 加 "dsh-skill-panel": "file:./plugins/dsh-skill-panel"
# dsh.profile.bundles 末尾加 "dsh-skill-panel"
加中文说明
打开 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 相同：外层只注册工厂，模块体在首次物化时才执行，不需要构建步骤，改完重启即生效。
踩过的坑（都写进代码注释了）
- 点开就卡死（0.1.1）：把 store 快照放进了加载 effect 的依赖数组。失败 → 状态回退 → 依赖变化 → 再请求 → 再失败，微任务永远排不空，整个渲染进程被占满。修法：加载 effect 只依赖
open/sessionId，用requestedRef保证每次打开最多自动请求一次。 cannot get property "remote" without inject（0.1.2）：Cordis 只注入inject里列出的名字。访问ctx.remote.skills时，remote和remote.skills两个都要声明。- bundle id 必须等于包名：不一致会自动重试一次，变成重复注册，整个 web boot 失败。
测试
npm install
npm test
test/render.mjs— 用react-dom/server渲染按钮test/interact.mjs— jsdom 真交互：打开 → 中文说明 → 中文搜索 →↑/Enter复制 → 最近使用 →Esc关闭（20 条断言）test/storm.mjs/test/storm2.mjs— 失败路径回归：skills/list报错时一次点击只能发 1–2 次请求，不许自我重试
License
MIT © 2026 maomaobishop
