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

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

• 宿主端（host）：/api/dsh-skill-center 路由家族（list/install/set-enabled/uninstall/trash/detail/download），通过 loopback 信任围栏提供服务。
• 客户端（client）：浏览器面板，作为设置页的一节挂载（设置 → 技能中心，注册在宿主 settings.section 槽位）。

功能

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

安装

# 单包安装：入口在宿主设置页，不再依赖 dsh-knj-menu
dsh plugin --profile web add dsh-knj-extension-center

安装后重启 dsh web（或确认 HMR），浏览器打开 http://127.0.0.1:3080： 点右上角设置 → 左侧导航「技能中心」 → 右侧内容区即技能列表。

设置页内容区宽约 516px（导航行来自 settings.section 注册，order 35，与宿主设置行并列）。旧版主区域接管与侧边栏入口已移除（center-mount.tsx / menu-entry.tsx 删除），不再与 @linxin666/dsh-client-ui-skill-explorer 类插件争用 knj.menu.item 槽位。

卸载

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

安全模型要点

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

路由表（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 字典、经 slots.inject 延迟注册 settings.section 设置行（id dsh-skill-center、order 35、label 取字典 entry.label）；SettingsSection 自建 SkillApi 并渲染 CenterApp 视图状态机（列表/详情/回收站/安装），列表头部的关闭按钮转发给设置弹窗的 close；返回合并 disposer。