yangdongzhen590/dsh-knj-extension-center

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

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

功能

安装

# 一条命令同时安装插件与菜单宿主 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/<name>/；重名时默认拒绝，用户明确选择「覆盖」才将旧版本移入回收站后安装。
• 客户端 zip 预览与宿主校验镜像一致（kebab-case、单一顶层目录、<name>/SKILL.md、description 非空、8MB 上限），不上传前先做本地校验。
• 详情正文经 markdown-lite 转义后注入 DOM（escape-first，XSS 安全）。
• 客户端装配整体包 applyGuard：任何失败降级为 console.warn，不拖垮宿主 GUI；菜单项注册经 slots.inject 延迟到 knj.menu.item 槽位声明后再执行（宿主对未声明槽位注册会 throw），入口随 knj-menu 生命周期折叠。

路由表（host）

开发

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。