dsh-skills-manager:DSH 本地技能可视化管理面板

前言

在 DeepSeek Harness(DSH)里,Skills(技能)是智能体获得领域能力、执行规范与自定义工具流的主要载体,文件通常落在 ~/.dsh/skills(或通过 $DSH_HOME 指定的目录)。日常维护却多半要靠资源管理器或终端翻目录,改调用策略要手改 YAML Frontmatter,预览和复制 Prompt 也不顺手。若希望在不破坏原有注释与格式的前提下,集中查看、检索、编辑技能并调控「模型自主调用」与「用户手动调用」,daha1216/dsh-skills-manager 在 DSH 设置中心提供原生风格的「技能」管理面板,面向上述流程做可视化封装。

这是什么

dsh-skills-manager(仓库 daha1216/dsh-skills-manager)由维护者 daha1216 发布,分类为 客户端 插件,采用 MIT 协议。它在 DSH 设置里嵌入技能管理界面:扫描本地技能、即时搜索、在线预览与编辑、策略开关落盘,并配合回收站与写前备份降低误操作风险。社区目录页:skillhub.cn 插件条目。

核心功能

技能概览与检索

插件自动扫描技能根目录(默认 ~/.dsh/skills,支持 $DSH_HOME 与符号链接)。同时识别两种布局:Bundle 目录型 <name>/SKILL.md 与 Flat 单文件型 <name>.md。列表展示描述、有效性、指令字数统计与最近修改时间;搜索框可按技能名称、描述或 whenToUse 做模糊过滤。

调用策略可视化

每张技能卡片可独立切换:

  • 模型自主调用:关闭后智能体不会在规划推理时自动匹配该技能(底层写入 disable-model-invocation: true)。
  • 用户手动调用:控制是否允许用户在对话中 @ 或工具面板显式调用(底层写入 user-invocable)。

策略变更采用无损写入:仅更新目标字段,YAML 中未知元数据、自定义注释、CRLF 与块标量结构尽量原样保留。

预览、编辑与新建

展开卡片可查看 Markdown 渲染后的 SKILL.md 正文,并提供复制指令。内置轻量编辑器可改 Frontmatter 与正文,支持 Ctrl/Cmd + S 保存、Esc 退出;含修改冲突检测(乐观锁)与未保存离开确认。右上角「+ 新建技能」可按 kebab-case 名称与描述生成初始骨架。

与本地文件系统联动

工具栏可打开技能根目录;单技能卡片可打开对应 Bundle 目录(通过系统文件管理器,Linux 下为 xdg-open)。页面提供打开全局配置的入口。

安全与界面

删除技能时移入 <root>/.trash/ 回收站,非直接物理删除;保存前在 <root>/.backups/ 写入带时间戳快照。HTTP API 限制为本地 Loopback 或受信主机,并做同源与 JSON 请求体校验。界面跟随 DSH 官方 Design Tokens,支持 zh / en 语言切换;README 记载 v0.3.1 对深色模式对比度做了重构。

宿主侧 REST 接口前缀为 /skills-manager/api,涵盖列表、读取、保存、策略、打开目录与软删除等路径(详见仓库 README 中的 API 表)。

安装与启用

前置条件:本机已安装并配置带 dsh CLI 的 DeepSeek Harness 环境。package.json 要求 Node.js >=22。

推荐通过 Profile 从 GitHub 远程源安装。下面命令来自项目 README:

# 安装到 DSH 桌面端
dsh plugin --profile desktop add github:daha1216/dsh-skills-manager

# 若在 Web 独立服务中使用
dsh plugin --profile web add github:daha1216/dsh-skills-manager

安装或更新后,需完全退出并重启 DSH 桌面端(Web 部署则重启 dsh 进程并刷新浏览器),以便宿主模块与客户端 Bundle 生效。更新时重新执行上述 add 命令即可。

典型用法

经过上面的安装与重启,可按 README 中的步骤使用:

  1. 打开 DeepSeek Harness,左下角齿轮进入 设置。
  2. 左侧导航点击 技能,进入技能管理面板。
  3. 用顶部搜索框按名称或场景检索;列表区分目录型/文件型、描述与字数。
  4. 展开卡片,拨动「模型自主调用」「用户手动调用」开关,配置即时写入磁盘。
  5. 需要新技能时,使用「+ 新建技能」填写英文短横线名称与描述。

技能正文与 Frontmatter 规范与 DSH 惯例一致,例如:

---
name: my-skill
description: 简明扼要地说明这个技能提供什么专业能力
whenToUse: 什么时候触发(可选)
disable-model-invocation: false
user-invocable: true
---

# 技能正文

这里是注入给模型的详细系统指令、规范与示例...

适用场景与注意

适合经常在本地增删改 Skills、需要快速关闭高成本技能的模型自动调用、或要在 UI 里预览/复制 Prompt 的 DSH 用户。插件以当前 dsh 进程权限读写技能目录与配置,安装前宜阅读 GitHub 仓库 源码与 MIT 许可证;社区目录与 DeepSeek / 幻方无官方从属关系,属 DSH「一切皆插件」生态中的第三方扩展。

仓库提供基于 Node.js 原生 Test Runner 的测试,README 记载 21 项测试通过,本地可执行:

node --test "test/*.test.mjs"

结尾

dsh-skills-manager 把本地技能的生命周期收拢到设置中心:扫描、搜索、策略开关、在线编辑与安全删除/备份在同一面板完成,减少手改 YAML 带来的格式风险。目录页:https://www.skillhub.cn/plugins/daha1216/dsh-skills-manager;源码与文档:https://github.com/daha1216/dsh-skills-manager。

羽毛球分组比赛记分
小程序二维码

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

小夜