技能中心yangdongzhen590/dsh-knj-extension-center

dsh-knj-extension-center（技能中心 · Skill Center）

DSH 技能中心插件：按区域浏览已加载的 skill、从 zip 安装新技能、管理（启用/禁用模型可调用、卸载入回收站、回收站恢复/彻底删除、搜索）。

- 宿主端（host）：/api/dsh-skill-center 路由家族（list/install/set-enabled/uninstall/trash/detail/download），通过 loopback 信任围栏提供服务。
- 客户端（client）：浏览器面板，挂载到主区域（center column），入口注册在侧边栏 knj-menu 区的「技能中心」行。

功能

| 功能 | 说明 |
| --- | --- |
| 浏览 | 按 系统内置（bundled）/ 用户技能（user-dsh）/ 运行时注册（runtime）三个区域分组展示；标题、描述、可调用徽标（模型/用户）、软链接徽标 |
| 搜索 | 服务端 ?q= 搜索技能名称/描述，200ms 防抖，IME 合成期间暂停 |
| 详情 | 点击卡片进入详情：frontmatter 代码块 + 正文预览（markdown-lite，转义优先）；用户技能显示路径、模型可调用开关、复制路径、卸载。bundled/runtime 无文件路径，详情不可打开、只读 |
| 安装 | 上传 zip（≤8MB）：本地解析预览（单一 /SKILL.md、kebab-case 名称、description 必填）→ 确认信息 → 完成；重名冲突弹窗支持「覆盖（旧版入回收站）」 |
| 启停 | 模型可调用开关改写 disable-model-invocation（仅文件技能） |
| 卸载 | 移入可恢复回收站（非永久删除） |
| 下载 | 用户文件技能导出为 .zip；系统内置/运行时技能不提供下载 |
| 回收站 | 恢复 / 彻底删除 / 清空；restore 409（原路径被占用）等失败内联展示 |

安装

一条命令同时安装插件与菜单宿主 dsh-knj-menu（已声明为 npm 依赖，版本自动配套）
dsh plugin --profile web add dsh-knj-extension-center dsh-knj-menu

安装后重启 dsh web（或确认 HMR），浏览器打开 http://127.0.0.1:3080：
侧边栏 knj-menu 区出现「技能中心」入口 → 点击替换主区域为技能列表。

与 @linxin666/dsh-client-ui-skill-explorer 类插件的共存：挂载按包名隔离（mountOnce），入口均注册在 knj.menu.item 槽位，会并列显示。

卸载

dsh plugin --profile web remove dsh-knj-extension-center

安全模型要点

- 所有 REST 路由仅绑定 loopback 信任围栏（host webserver 注入），浏览器同源访问；每个非 2xx 响应转为 ApiError 携带宿主 { error } 文本。
- 卸载是移入回收站而非删除；回收站清空/彻底删除才做永久删除，且需确认。
- 安装目标固定 ~/.dsh/skills//；重名时默认拒绝，用户明确选择「覆盖」才将旧版本移入回收站后安装。
- 客户端 zip 预览与宿主校验镜像一致（kebab-case、单一顶层目录、/SKILL.md、description 非空、8MB 上限），不上传前先做本地校验。
- 详情正文经 markdown-lite 转义后注入 DOM（escape-first，XSS 安全）。
- 客户端装配整体包 applyGuard：任何失败降级为 console.warn，不拖垮宿主 GUI；菜单项注册经 slots.inject 延迟到 knj.menu.item 槽位声明后再执行（宿主对未声明槽位注册会 throw），入口随 knj-menu 生命周期折叠。

路由表（host）

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | /api/dsh-skill-center/list | 分组技能列表；?q= 搜索、?level= 过滤 |
| GET | /api/dsh-skill-center/detail | ?name= 原始详情（frontmatter + body） |
| GET | /api/dsh-skill-center/download | ?name=&path= 下载用户技能 zip 包 |
| POST | /api/dsh-skill-center/install | zip base64 安装；{ overwrite } 覆盖 |
| POST | /api/dsh-skill-center/set-enabled | { name, path, enabled } 模型可调用开关 |
| POST | /api/dsh-skill-center/uninstall | { name, path } 卸载入回收站 |
| GET | /api/dsh-skill-center/trash/list | 回收站条目 |
| POST | /api/dsh-skill-center/trash/restore | { trashPath } 恢复 |
| POST | /api/dsh-skill-center/trash/purge | { trashPath } 彻底删除 |
| GET | /api/dsh-skill-center/health | 健康检查 |

开发

npm.cmd run build      # tsc(host) + tsdown(client bundle) → lib/
npm.cmd test           # vitest（node + jsdom）
npm.cmd run typecheck  # tsc --noEmit

客户端装配入口 src/client/index.ts：apply(ctx) 依次注册 locale 字典、挂载主区域视图（CenterApp 视图状态机：列表/详情/回收站/安装）、经 slots.inject 延迟注册 knj-menu 侧边栏入口；返回合并 disposer。