前言¶

DeepSeek Harness（DSH）0.2 已支持在对话里用 /技能名 调用用户技能，技能文件通常落在 ~/.dsh/skills。实际使用时常见几类麻烦：技能分散在 GitHub、各 Agent 的本机目录或 ZIP 里，手动拷贝容易漏资源；来源更新后，本地改过的 SKILL.md 或脚本会被整包覆盖；停用、导出、核对「到底从哪装的」也缺少统一界面。

社区里已有若干技能管理类插件，侧重来源导入或列表展示。Very12345 维护的 dsh-skill-manager（npm 包名 @very12345/dsh-skill-manager，当前 0.4.0）定位为独立的 DSH 0.2 工作流插件：在 设置 → 技能管理 里完成安装预览、多来源导入、保留本地修改的更新，以及可回退的历史记录。下文按安装、日常用法和更新策略说明，事实均来自项目 README 与 package 信息。

这是什么¶

dsh-skill-manager 是 DSH 官方插件体系下的技能管理插件，维护者为 Very12345，在 SkillHub 目录 分类为 工作流。它不负责改写 DSH 原生的技能发现、模型策略、工具执行与审批，而是把「装什么、从哪来、本地改了什么、怎么合并更新」集中到一个设置页；界面与同集合其他插件保持紧凑字号、主题和独立 SVG 图标。

技能写入 $DSH_HOME/skills（默认 ~/.dsh/skills），保留目录内脚本、模板及二进制资源；导入期间不执行技能脚本或 hooks。插件自身的管理状态、暂存与历史位于 $DSH_HOME/very12345-skill-manager，不进入 Git。

核心功能¶

多来源安装¶

1. 在技能管理页点击 安装技能，可选 GitHub、本地文件夹 或 ZIP / Markdown。
2. GitHub 支持 owner/repo、HTTPS / SSH 仓库链接、tree 子目录链接，以及指定分支、标签、提交；链接中带 / 的分支按远端真实引用解析。需要系统 Git 和已配置的非交互凭据；SSH 需已确认主机密钥。
3. 本地 可填 DSH 所在机器的完整路径；官方桌面版可用系统目录选择器。浏览器可上传完整文件夹；ZIP / Markdown 通过文件选择上传，或以本地完整路径读取。
4. 安装前会 预览 技能名称、描述、完整文件数量、格式问题与重名项，可跳过、改名或替换；确认前不会修改技能库。
5. 安装完成后，管理的技能 显示来源、Git 提交和本地修改状态；已有技能 仅查看其他文件及宿主注册项，不自动接管。

技能商店与本机 Agent 技能库¶

• 技能商店 直接浏览 OpenAI / Codex、Anthropic / Claude、GitHub Copilot、Vercel 的公开技能目录，按名称、目录和来源筛选，每页 24 项。关键词至少两个字符时，默认「预设 + 社区搜索」会同时搜索 skills.sh，README 明确不把四个预设仓库等同于整个技能生态。显示真实元数据、来源链接及完整安装预览。
• skills.sh 社区 使用与其开源 CLI 相同的公开搜索接口，最多 50 项；非 GitHub 来源会提示并跳过。安装会核实单个技能目录，无法唯一定位时提示使用准确子目录链接。
• 目录与描述在插件 catalog-cache 下缓存 6 小时；重新读取 可检查最新目录；网络失败时显示缓存及来源错误；GitHub 接口限流时可通过 Git 读取目录索引，无需额外令牌。
• 本机技能库 读取 Codex、Claude Code、Cursor、Copilot、Gemini CLI、OpenCode、Windsurf、Qwen Code、共享 .agents/skills、Cline 旧目录、Continue、Trae 等用户技能路径，并支持 CODEX_HOME、CLAUDE_CONFIG_DIR、XDG_CONFIG_HOME；指定项目完整路径后也会读取相应项目技能目录。本机导入 复制完整技能目录，不改变源 Agent 的文件和启用状态；导入后在 DSH 中按 DSH 的调用与审批规则使用。Trae CN、Codex / Claude 插件技能、CodeBuddy / WorkBuddy 市场与插件缓存等可在「插件 / 内置」范围只读浏览，仅读 SKILL.md，不复制专属工具、二进制或私有运行时。

调用已安装技能¶

DSH 0.2 原生支持输入 / 后从菜单选技能，或在消息里写 /技能名。本插件补充 $技能名 入口：在调用模型前从当前 Agent 技能目录加载完整正文，以原生 skill-invocation 上下文注入，不依赖模型主动调用 skill 工具。

示例（README 原文）：

/ppt-master 请将这个 PDF 制作为 12 页可编辑 PPTX

或：

$ppt-master 请将这个 PDF 制作为 12 页可编辑 PPTX

指令前后使用空白分隔；技能详情页提供两种指令的复制按钮。与 DSH 命令重名时仍沿用 DSH 命令优先级，可用 $技能名 明确指定技能。重复 $技能名 或混用 / 与 $ 时，本轮正文只加载一次。停用或格式不合规的技能不能调用；规范要求 SKILL.md 含 YAML name 和 description。

更新与回退¶

• 检查更新 可预览单个技能；同一来源多个技能时，同源更新 只读一次来源，逐项选择要更新的技能。
• 按文件比较安装基线、本地版本、来源新版：本地单独修改或新增的文件保留；双方都修改的文件须选择保留本地或使用来源。
• 来源删除文件时显示移除项；被本地修改的文件不会静默丢弃。来源移除整个技能时，当前安装保留并提示，不自动卸载。
• 每次安装、替换、更新、启停、移除都会记录历史，历史与回退 可恢复；若后续内容已变化，回退会先拒绝覆盖。
• 停用通过在管理目录内 SKILL.md / SKILL.md.disabled 物理切换实现。ZIP 或无持续路径的上传来源更新时需重新导入新版并处理重名；本地路径与 GitHub 来源可直接检查更新。

安装与启用¶

通过 DSH 官方插件安装入口添加，README 给出的地址为：

https://github.com/Very12345/dsh-skill-manager

Git URL 安装直接使用仓库提交的 lib/，无需安装阶段构建脚本。更新插件后需重启宿主。环境要求：Node.js ≥ 22.19；从 GitHub 安装需系统 Git 与非交互凭据。

安装后在 DSH 设置 → 技能管理 使用。开发与验证基线为 Windows、DSH 0.2.0-rc.2；实现为跨平台 Node / Git，README 注明 Linux / macOS 尚未实机联调。

典型用法流程¶

1. 在 设置 → 技能管理 打开页面。
2. 需要从社区选技能：打开 技能商店 或 skills.sh 搜索（至少两个字符），预览后安装。
3. 需要从本机其他 Agent 迁入：在 本机技能库 选择对应 Agent 或项目路径，导入完整目录到 DSH。
4. 需要从仓库安装：点击 安装技能 → GitHub，填入 owner/repo 或带子目录 / 分支的链接，在预览里处理重名后确认。
5. 对话中使用：沿用 /技能名，或按详情页复制 $技能名 前缀加载完整技能正文。
6. 来源有更新：检查更新 或 同源更新，在文件级冲突里选择保留本地或采用来源，必要时在 历史与回退 恢复。

适用场景与注意¶

适合谁： 经常在 DSH 里维护一批用户技能、需要从 GitHub / 商店 / 本机 Codex·Cursor·Claude 等目录批量迁入，且希望在更新时保留本地改动的开发者。

范围与限制（README 明确）： 目前管理 DSH 用户技能目录；项目 / Agent 分配不在此版本。系统与其他提供方技能仅查看。ZIP 为普通 UTF-8 文件名的 stored/deflate，不支持加密、分卷、ZIP64 和符号链接。本地 / GitHub 读取和 ZIP 展开总量上限 256 MiB，单文件 64 MiB、最多 25,000 个文件；浏览器上传 ZIP 上限 64 MiB。插件以 当前 DSH 进程权限 读写本机路径与 Git；安装前应自行查看 GitHub 源码 与 MIT 许可证及打包组件的 NOTICE。

SkillHub（skillhub.cn）是社区插件目录站点，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库为准（截至资料抓取时 GitHub 星标为 0）。

结尾¶

dsh-skill-manager 把 DSH 用户技能的安装、商店与本机导入、显式 $技能名 加载，以及带本地修改保护的更新和回退，收拢到同一设置页；技能执行与审批仍由 DSH 原生服务负责。若要安装或阅读完整说明，可访问 SkillHub 目录页 与 GitHub 仓库。