dsh-skill-center:在 DeepSeek Harness 里浏览与管理会话技能

前言

DeepSeek Harness(DSH)里,技能(Skill)会来自插件内嵌、项目目录与用户目录等多处根路径;模型能否通过 skill 工具加载某条技能,还取决于 frontmatter 里的调用策略。若只靠编辑器改 SKILL.md 和 YAML 头,很难一眼看清「当前会话到底能看见哪些技能、各自来自哪、开关是否生效」。

下面介绍社区插件 dsh-skill-center(npm 包名 @restregular/dsh-skill-center,插件 id 为 dsh-skill-center / skill-center)。它在 DSH 客户端侧栏提供「技能中心」面板,把浏览、作用域切换、正文阅读、调用开关、新建删除、导入导出与回收站收进同一界面。维护者为 RestRegular;分类为客户端插件。社区目录页见 skillhub.cn,源码与说明见 GitHub。

这是什么

一句话:面向 DSH 的 Skill Center 面板 —— 浏览并管理当前(或你选定的)会话作用域内可见的全部技能,无需离开应用、也无需手改 frontmatter 即可完成常见维护操作。

说明:npm 上裸名 dsh-skill-center 已被无关项目占用,本插件仅以 @restregular/dsh-skill-center 发布;安装与 bundle 配置时必须使用带 scope 的完整包名,否则可能出现宿主半边挂载、客户端半边被静默丢弃的情况(README 中有专门说明)。

核心功能

浏览与作用域

  • 列表:展示当前会话作用域内可见的每一条技能,包括插件内嵌技能;每条显示 provider、来源根路径、调用策略等信息。
  • 切换作用域:工具栏 Scope 下拉可按工作区分组浏览其他会话的技能作用域(归档与空白会话会排除)。选 Auto (current session) 时跟随主视图;选定具体会话后,列表与写入都按该会话的 cwd 与 preset 解析。若有未保存的调用开关编辑,作用域切换会被禁用,避免把暂存修改带到别的作用域。
  • 搜索与筛选:按名称或描述搜索;按 provider 来源筛选。

阅读与调用策略

  • Read body:在面板内渲染原始 SKILL.md Markdown,不必再开右侧资源窗格。
  • Invocation switches:本地即时切换 disable-model-invocation / user-invocable;点工具栏旁 Save(按钮状态:未修改 → 保存 → 已保存)后写回 frontmatter,宿主会立刻把更新后的目录推送给模型。
  • 只读保护:插件内嵌技能(如 office-docx)标为 embedded,开关与删除不可用。

新建、导入导出与删除

  • Create:在用户可写的两个根之一新建 <name>/SKILL.md;表单提供 Create / Cancel,Write to 下有说明。
  • Export / Import:Export 将选中技能包下载为 .zip(含 SKILL.md 及资源文件;扁平技能为 <name>.md)。Import skill 接受该 .zip(单层包装目录会剥掉)或单独的 SKILL.md;会拒绝路径逃逸、重名、以及缺少 frontmatter name + description 的条目。
  • Delete:将技能移到同根下的 .trash/<timestamp>-<name>,可恢复,非硬删。

回收站

工具栏 Trash 列出各受管根下的 .trash 条目及删除时间。Restore 还原到原根(若目标已存在同名技能则拒绝);详情区 Delete 在确认后永久删除。Empty trash 清空全部回收站,均有确认步骤。

交互与反馈

面板不弹出「已保存 / 已创建」类成功提示:列表变化、保存按钮三态等即反馈。仅失败时显示红色条与重试。

随包附带:skill-authoring 与 skill_create

  • 内嵌技能 skill-authoring:包内 skills/skill-authoring/ 通过 ctx.skills.registerProvider() 注册,与会话目录中其它技能一样可被模型加载;面板中显示为 embedded(只读)。内容涵盖技能根目录约定、frontmatter 契约、资源文件布局、插件内嵌技能说明,以及 templates/minimal/SKILL.md 模板。
  • 模型工具 skill_create:一次调用可在指定根下写入 <root>/<name>/SKILL.md 及资源文件,适用于会话工作区外、普通写文件工具受沙箱限制的技能根路径。写入范围与面板相同:仅四个受管根、路径校验;非 loopback 来源的写请求返回 403。

写入位置:用户根与项目根

新建表单只提供两个用户级写入目标(默认 User Agents skills):

选项 路径 适用范围 说明
User Agents skills ~/.agents/skills($DSH_AGENTS_HOME/skills) 所有项目 跨 Agent 约定;其它扫描该目录的工具也能看到
User DSH skills ~/.dsh/skills($DSH_HOME/skills) 所有项目 仅 DSH;rank 400,同名时覆盖 ~/.agents/skills(rank 500)

项目级根 <projectRoot>/.dsh/skills(rank 100)与 <projectRoot>/.agents/skills(rank 200)不在表单中列出,但 API 与 skill_create 可通过 rootId 使用;同名时项目内副本优先于用户目录副本。

安装与启用

运行环境:Node >= 22.13.0(见 package.json)。许可证:MIT。

从插件市场(图形界面)

  1. 打开侧栏 Plugins。
  2. 搜索 @restregular/dsh-skill-center 并安装。
  3. 重启宿主(或重新加载 profile),以便宿主半边挂载。

手工安装

在 DSH profile 目录内执行(例如 ~/.dsh/profiles/desktop):

pnpm add @restregular/dsh-skill-center

将包加入 profile 的 bundle 列表后重启:

// <profile>/package.json
{
  "dsh": { "profile": { "bundles": [/* … */ "@restregular/dsh-skill-center"] } },
  "dependencies": { "@restregular/dsh-skill-center": "^0.3.11" }
}

包自带 cordis.patch.yml,一般无需手改 loader:会插入宿主插件(id: skill-center)与客户端半边。侧栏「技能中心」排在「插件」下方(sidebar.panellist 的 order: 1)。

卸载:从 bundle 与 dependencies 中移除该包,然后重启。

典型用法

  1. 日常查看:安装并重启后,点侧栏 Skill Center,在列表中选中技能,用 Read body 阅读 SKILL.md。
  2. 调整模型/用户是否可调用:在详情区拨动 model invocable / user 开关,确认无误后点 Save。
  3. 对照别的会话:在 Scope 中选择目标会话,核对该项目或 preset 下可见技能集合,再切回 Auto (current session)。
  4. 备份与迁移:对选中技能 Export 得到 .zip;在另一环境 Import skill 导入(注意重名与 frontmatter 要求)。
  5. 误删恢复:打开 Trash,对条目 Restore;确认不再需要时再永久删除或 Empty trash。

若安装重启后侧栏仍无「技能中心」,README Troubleshooting 建议依次检查:bundle 是否包含完整包名、依赖是否装在 profile 的 node_modules、客户端模块是否以 @restregular/dsh-skill-center 注册等。

适用场景与注意

适合谁:经常在 DSH 里调试 Agent 技能、需要看清「会话可见技能全集」、或希望少用手改 frontmatter 的开发者。

生态说明:DSH 主张「一切皆插件」;skillhub.cn 等社区目录独立于 DeepSeek / 幻方,并非官方应用商店。

安全与权限:插件以当前 dsh 进程权限运行,写操作限定在已存在的受管技能根内。安装前请自行阅读 源码仓库 与 MIT 许可证,确认符合你的环境与合规要求。

结尾

dsh-skill-center 把会话技能的浏览、作用域对照、调用策略、生命周期(含回收站)和包级导入导出集中到 DSH 客户端一侧,并附带 skill-authoring 与 skill_create 方便人与模型协作写技能。需要安装或细节时,以仓库 README 为准:

  • 目录页:https://www.skillhub.cn/plugins/RestRegular/dsh-skill-center
  • GitHub:https://github.com/RestRegular/dsh-skill-center
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜