前言¶
在 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 中的步骤使用:
- 打开 DeepSeek Harness,左下角齿轮进入 设置。
- 左侧导航点击 技能,进入技能管理面板。
- 用顶部搜索框按名称或场景检索;列表区分目录型/文件型、描述与字数。
- 展开卡片,拨动「模型自主调用」「用户手动调用」开关,配置即时写入磁盘。
- 需要新技能时,使用「+ 新建技能」填写英文短横线名称与描述。
技能正文与 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。