前言¶
DeepSeek Harness (DSH) 采用插件化架构。在使用过程中，直接操作文件或配置往往会导致“文件已启用”与“当前会话可用”状态混淆，且难以统一管理 Skill 的生命周期。dsh-skill-manager 通过官方扩展点介入设置页面，在不修改 Harness 核心流程的前提下，提供了一套独立的 Skill 管理方案。
是什么¶
dsh-skill-manager 是一个非侵入式的 Skill 生命周期管理器插件。它由用户 mhdfy1988 维护，旨在管理官方文件系统 Skill 提供器支持的用户技能目录，解决 Skill 安装、更新、卸载过程中的状态追踪与文件管理问题。
核心功能¶
- 会话可用 Skill 查看：在“设置 → 技能”页面，通过官方
skill.list接口查看当前选中会话实际可调用的 Skill。 - 本地安装：支持从本地文件夹或 ZIP 包安装包含
SKILL.md的 Skill。 - 生命周期管理：对由管理器安装的 Skill 执行更新、启用、停用和卸载操作。
- 状态分区显示：界面将“会话可用 Skill”与“管理器拥有的用户 Skill”分开展示，避免混淆文件启用状态与实际调用结果。
- 安全操作机制：
- 安装拒绝同名覆盖。
- 更新前自动备份旧版本，再替换新版本。
- 卸载将文件移入管理器回收区，不直接永久删除。
- 低侵入性：官方文件系统 Skill 提供器负责热刷新；普通 Skill 操作不修改 Profile，也不强制要求重启 Harness。
安装与启用¶
插件通过官方 dsh plugin 流程安装。安装完成后需重启 Harness。
dsh plugin --profile web add D:\deepseek\dsh-skill-manager\artifacts\dsh-skill-manager-0.1.4.tgz
重启 dsh web 后，进入“设置 → 技能”即可看到管理界面。
典型用法¶
Skill 包格式¶
Skill 包可以是文件夹或 ZIP，必须包含 SKILL.md。SKILL.md 中需声明 name 字段（小写 kebab-case），安装后的目录名会统一为 name。
示例结构：
my-skill/
├─ SKILL.md
├─ references/
└─ scripts/
SKILL.md 示例¶
---
name: my-skill
description: 何时使用这个技能
---
# 使用说明
...
适用场景与注意¶
适用对象：需要频繁管理、测试或维护自定义 Skill 的 DSH 开发者或管理员。
重要边界：
1. 管理范围：管理器仅拥有带 .dsh-skill-manager.json 标记的 Skill 目录。项目 Skill、手工安装的用户 Skill（位于 <DSH_HOME>\skills）、.agents Skill、预设内置 Skill 以及其他插件提供的 Skill 均不属于此管理器。
2. 状态优先级：页面上“当前会话可用技能”直接复用官方结果，只读展示；“用户目录已启用”仅表示文件存在，不保证在会话中胜出（项目或预设中的同名 Skill 可能按官方优先级覆盖）。
3. 插件安装：管理器插件本身仍通过官方流程安装、更新或移除，安装后需重启 Harness。
4. 第一版限制：暂不支持 GitHub 地址安装、在线市场、自动更新源、图形化恢复界面、跨历史会话批量枚举及管理任意插件。
结语¶
dsh-skill-manager 为 DSH 插件生态提供了一个轻量级的 Skill 管理工具，通过清晰的分区和安全的生命周期操作，简化了 Skill 的维护工作。更多细节可参考项目主页或使用手册。
- 项目主页：GitHub
- 插件目录：skillhub.cn
