dsh-plugin-skill-manager-gui
中文 | English
面向 DeepSeek Harness（dsh）的图形化技能管理器。在网页设置里即可新建、编辑、导入、删除 SKILL.md 技能——不用开终端，也不用手写 YAML frontmatter。
| |
|---|
| npm 包 | dsh-plugin-skill-manager-gui |
| 分类 | dsh-plugin |
| 许可证 | MIT |
功能
- 列出已管理的技能，展示描述、安装位置与调用开关。
- 新建技能：名称（kebab-case）、描述、可选的
whenToUse、安装位置、模型/用户调用开关，以及 Markdown 指令正文。
- 编辑已有技能（编辑时名称不可改，改名请删除后重建）。
- 删除，带二次确认。
- 导入 ZIP：把
<name>/SKILL.md（或 <name>.md，含嵌套资源）批量导入到一个或多个位置。
- 全局 + 工作区：可安装到本机全局根（
$DSH_HOME/skills），也可勾选 harness 已追踪的任意工作区（<workspace>/.dsh/skills）——正是内置 skill-filesystem 提供者本来就会扫描的目录，所以写入后无需重启即可被识别。
- 中英双语、跟随主题，使用 DSH 原生 UI 原子组件渲染。
安装
dsh plugin --profile web add dsh-plugin-skill-manager-gui
重启 dsh web，然后打开 设置 → 技能。
从 Git 安装会运行包内 prepare 构建脚本，pnpm ≥ 10 默认拦截，直到你放行。把 pnpm 打印的键复制进该 profile 的 pnpm-workspace.yaml 的 allowBuilds，再重跑即可。从 npm 或 tarball 安装则无需放行。
使用
-
打开 设置 → 技能。
-
点击 新建技能，填写表单、勾选一个或多个安装位置，点击 保存；或点击 导入 ZIP 批量导入。
-
技能以目录 bundle 落盘：
$DSH_HOME/skills/<name>/SKILL.md # 全局（user）
<workspace>/.dsh/skills/<name>/SKILL.md # 某个工作区
-
内置 skill 发现会在下一次扫描时拾取它——模型可通过 skill 工具加载，输入框 / 菜单也会把它列为可调用项。
工作原理
本包是一个标准的树外插件，宿主端 + 浏览器端合一的「双面」bundle：
- 宿主端（
src/index.ts）注入 webServer 与 workspaceRegistry，在 /skill-manager 下注册读写 SKILL.md 的 HTTP 路由。
- 浏览器端（
src/client/）注册 settings.section，用 fetch 调用这些路由。
线协议、安全模型与目录结构详见 docs/architecture.zh.md。
安全
变更类路由（write、remove、import）会以宿主用户权限写文件，因此仅限回环地址且要求同源——与 harness 自身特权操作使用同一道边界。只读路由（list、read、workspaces）不写文件。ZIP 导入会逐条校验条目路径，杜绝 .. 或绝对路径逃逸目标根目录。
开发
需要 Node.js 22.19+（推荐 24）与 npm。
npm install # 会触发 prepare → build
npm run typecheck # 宿主 + 客户端 tsc
npm test # vitest 单元测试（宿主技能存储）
npm run build # tsc（宿主 lib/）+ tsdown（client/client.js）
目录结构
src/
index.ts 宿主入口：在 webServer 上挂载 HTTP 路由
routes.ts /skill-manager 路由分发
skills.ts SKILL.md 文件服务（list/read/write/remove）
import.ts ZIP 导入（安全解压）
http.ts JSON + 同源 + 回环校验工具
types.ts 共享线协议类型
client/
index.ts 客户端入口：settings.section 注册
SkillManager.tsx React 设置页 UI
SkillManager.module.css
locales.ts zh / en
cordis.patch.yml bundle patch 层
tsdown.config.ts 客户端 bundle 构建（__ModuleLoader__ factory）
.github/workflows/ ci.yml + release.yml
参与贡献
见 CONTRIBUTING.md。
许可证
MIT
