技能星图面板 XHXnb123/dsh-plugin-skill-panel

dsh-plugin-skill-panel

给 DeepSeek Harness 的 Web GUI 加一颗「🧩 Skills」胶囊：点开是一张星图，本机全部技能是盘上的星点，按用途分成六段弧线。点一颗星就能看它的描述、把调用语塞进输入框，或者直接发出去。

星图面板

它长什么样

- 同心刻度环 + 十字准线：背景是天文图录的网格，不承载信息，只给盘面一个坐标感。
- 六段弧线 = 六个用途：写作与润色、设计与视觉、文档与办公、工程与规划、运营与内容、诊断与维护。每段一色，段名常显在弧外侧（中文大字 + 英文小字 + 该类条目数），弧本身加粗到 2px、两端带封口点，是盘面上最重的一层标注。
- 星点颜色 = 装在哪儿：金 = 项目级 .dsh/skills，象牙 = 用户级 ~/.dsh/skills，青 = 随应用内置，淡蓝 = ~/.agents/skills。
- 图例条：搜索框下面那排 chip（写作 3 / 设计 2 / 办公 7 …），点一下只看这一类，再点回到全部。
- 中心「19 SKILLS」：当前盘上有多少个可调用项。
- 搜索时：命中的节点跳到前景、名字直接长在盘上，标题变成 SKILL ATLAS · 2/19。
- 悬停：节点放大并发光，名字浮出来。

选中一颗星

点中一颗星后，底部换成它的信息条：名字、来源、两行描述，以及「执行 / 插入 / 看 / 取消」。被选中的星会持续发光，它所在的弧线也会提亮。

三个按钮

| 按钮 | 行为 |
| 执行 | 把 使用 skill \<名字>\ 完成任务：<输入框里已有的话> 组合成一轮对话，直接发送。输入框为空时退化为"只插入前缀"；只有前缀没有需求时提示先补需求，不会发半截话。 |
| 插入 | 只写进输入框，你自己补需求再回车。 |
| 看 | 直接预览该技能的 SKILL.md 正文。 |
| 取消 | 取消选中，回到提示态。 |

调用语已经存在时（比如你刚点了另一个技能的执行），只替换前面的技能名，不会把前缀越叠越长。

安装 / 卸载

安装（会把包 link 进配置档，并把包名追加到 dsh.profile.bundles） & "<dsh 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "<插件目录>"

卸载 & "<dsh 安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-plugin-skill-panel

装完重启一次 DeepSeek Harness（宿主在启动时给页面生成插件清单，刷新页面不足以加载新的 client 半身）。

结构

| 文件 | 作用 |
| src/index.mjs | 宿主半身：apply(ctx) 里向 webServer 注册 4 条 JSON 路由 |
| src/scan.mjs | 扫描器：发现技能根目录、解析 frontmatter、去重合并 |
| src/client.js | 客户端半身：React 组件挂在 shell.overlay slot 上，盘面是手写 SVG |
| cordis.patch.yml | 插件自带的补丁，声明 - id: skill-panel 插入条目 |
| smoke.mjs | 宿主侧冒烟测试（mock ctx 调 apply，验证路由与数据） |
| verify-starmap.py | 用 playwright 在 web 配置档实例里验证星图：节点数、弧数、选中卡片、插入输入框、搜索、分类筛选 |
| verify-starmap.py | playwright 验证星图客户端：节点数、弧数、选中卡片、插入输入框、搜索、分类筛选 |
| design-demos/ | 视觉探索留下的候选稿：六个列表方向（dir-1..3 完整版）与三个星图方向（g1 知识图谱 / g2 星图 / g3 径向树），最终选了 g2 |

分类怎么定的

盘面上的六段弧是用途分类，按下面的优先级判断，没有额外元数据：

1. 名字查表：humanizer-yu / natural-chinese / paper-humanizer → 写作；huashu-design / huashu-art-motion → 设计；office → 办公；diagnose-windows-sandbox-acl → 诊断；tencent-channel-community / wechat-oa-style → 运营；domain-modeling / grill → 工程。
2. 描述关键字兜底：出现 docx / xlsx / pptx / excel / powerpoint 归办公，出现 写 / 润色 / 文案 / humaniz 归写作，出现 设计 / 视觉 / 动画 归设计，出现 频道 / 公众号 / 运营 / community 归运营，出现 诊断 / debug 归诊断。
3. 都认不出来的归「工程与规划」。

这是启发式，不是技能自己声明的分类。新增技能如果落错段，去 src/client.js 的 CATEGORY_BY_NAME 加一行就行。

数据来源与扫描规则

只认一层深度：<root>/<name>/SKILL.md 或 <root>/<name>.md；frontmatter 里的 description / whenToUse / name 被解析。

根目录按优先级：

| rank | 来源 | 路径 | 星点颜色 |
| 100 | project | 当前 workspace 的 .dsh/skills（workspace 列表读自 ~/.dsh/storages/workspace.json） | 金 #C9A227 |
| 400 | user | ~/.dsh/skills | 象牙 #E8E2D0 |
| 500 | agents | ~/.agents/skills | 淡蓝 #9FB6D4（暂无数据时不画） |
| 600 | bundled | <安装目录>/resources/runtime/office-skills 等随包资源 | 青 #6FA8A0 |

同名 skill 高级别覆盖低级别；某个来源一个 skill 都没有时，对应弧线不画。

HTTP 路由

| 方法 | 路径 | 说明 |
| GET | /skill-panel/list | 全部 skill + roots + errors |
| POST | /skill-panel/refresh | 强制重扫 |
| GET | /skill-panel/read?name=<名字> | 返回该 skill 的 SKILL.md 正文（只在扫描结果白名单内读，512KB 上限） |
| GET | /skill-panel/health | 存活探针 + 上次扫描时间 |

排障

- 改了 src/.mjs 不生效：cordis 不会卸载已 apply 的宿主插件，plugin remove 后重新 add 也不会重新 import。必须重启 DeepSeek Harness。客户端（src/client.js）改完刷新页面即可。
- 胶囊被别的浮卡挡住：vault-memory 的知识库浮卡占右下角，本插件胶囊定位在 bottom: 200px、面板在 bottom: 150px 避让。
- 星点挤成一坨：节点按组均布在弧线上，同名组超过 12 个时会挤，用搜索缩范围。
- dsh --profile web 里 host 路由全 404：web profile 下第三方插件的 webServer 路由不生效（vault-memory 同样 404），不是本插件的问题；验证客户端时用 playwright 拦截 /skill-panel/ 返回 fixture 数据（见 verify-starmap.py）。

开发自检

node smoke.mjs # 宿主侧：路由注册、分组、read、路径穿越拦截
node test-scan.mjs # 纯扫描器输出（无需宿主）
python verify-starmap.py "http://127.0.0.1:<port>/?token=<token>" # 客户端星图（需 playwright + 一个 web profile 实例）