前言¶
DSH 插件生态里，“一切皆插件”会把常用能力拆成可安装、可替换的模块。对维护本地技能目录的人来说，直接翻文件系统容易漏掉某个 workspace，也不好统一查看技能描述和正文。
dsh-skill-panel 把这类目录接入设置页，提供一个 Skills 面板，用于查看和管理全局及项目级本地技能目录。
这是什么¶
dsh-skill-panel 是一个 DSH 客户端插件，由 hexbee 维护，许可证为 MIT，package.json 版本为 0.1.1。
它解决的是本地技能目录的集中查看和管理问题：在设置页增加 Skills 面板，列出技能，并显示描述、正文和目录内容。
管理哪些目录¶
全局目录¶
插件支持全局目录：
~/.agents/skills
这个目录会受 DSH_AGENTS_HOME 影响。
项目级目录¶
插件支持项目级目录：
<workspace>/.agents/skills
该目录面向 harness 中注册的每个 workspace。
项目作用域仅通过 Host 注册的 workspace ids 寻址，浏览器不提交原始文件系统路径。
核心功能¶
面板提供以下能力：
- 在设置页添加 Skills 面板
- 查看和管理本地技能目录
- 列出每个技能，并显示描述、正文和目录内容
- 支持在当前作用域内搜索
- 支持删除技能
- 支持在系统文件管理器中打开目录
- 包含中英文文案
安装与启用¶
从 GitHub 安装到 web profile：
dsh plugin --profile web add git+https://github.com/hexbee/dsh-skill-panel.git
如果本地已有源码目录，也可以用本地路径安装：
dsh plugin --profile web add file:/path/to/dsh-skill-panel
构建与本地验证¶
从源码构建时，先安装依赖，再执行构建和测试：
pnpm install
pnpm run build
node --test tests/catalog.test.mjs
README 将构建过程描述为 esbuild bundles + tsc declarations，测试入口是 tests/catalog.test.mjs。
实现与安全边界¶
插件的 dsh.client.platform 为 web，并注入 DSH client runtime/UI/locale 相关包。
RPC 通道固定到 loopback：
authority: 'loopback'
所有变更限制在以下目录：
~/.agents/skills
<workspace>/.agents/skills
删除符号链接技能时，只断开链接，不触碰目标。
适用场景与注意¶
适合维护 DSH 本地技能目录的人使用，尤其是需要同时查看全局目录和多个 workspace 下项目级目录、搜索技能描述、删除技能或打开目录的场景。
由于插件会操作本地技能目录，并且以当前 dsh 进程权限运行，安装前应检查源码与许可证；运行时可访问的目录范围取决于启动 dsh 的进程环境。
结尾¶
dsh-skill-panel 的价值，是把分散在用户目录和 workspace 目录下的技能文件，变成设置页里可搜索、可查看、可删除、可打开的列表。
相关链接：
