DSH Skills Manager

统一管理本机与项目技能，从 GitHub 安装、预览更新并备份回退

简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português

更新日志 · 开源协议

DSH Skills Manager 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。

功能概览

把散落在本机和项目中的技能集中到 DSH，无需在多个 Agent 目录间来回查找。

• 多视图集中管理：提供「全局技能」、「项目技能」、「发现」与「回收站」四大工作区视图，支持搜索、状态筛选与来源折叠。
• 按来源仓库浏览：可切换目录或仓库视图，依据安装记录、锁文件和技能元数据识别来源；没有可靠来源的技能显示为「来源未知」。
• 广泛的生态兼容：覆盖 DSH、公共 Agent、Codex、Claude Code、Copilot、Cursor、Google Antigravity、Windsurf、Qoder、Trae 等 20+ 工具与 CLI 环境，统一管理且不侵入第三方文件。
• 分类整理与拖拽归类：支持在各来源内创建分类文件夹、拖拽技能卡片归类排序、批量添加技能，并支持分类级一键启停。分类元数据独立保存，不改动物理文件。
• 公共市场与仓库订阅：内置「发现」中心，一站式浏览 ClawHub 热门榜单与 skills.sh 技能市场，支持公开 GitHub 仓库订阅、增量更新检测与版本备份回退。
• 创建与自由导入：新建技能，或导入 ZIP、文件夹与 SKILL.md，可精准写入用户全局目录或指定工作区项目目录。
• 宽屏阅读与正文复制：760px 宽屏自适应详情弹窗，等宽字体代码高亮排版，支持垂直自由拉伸与一键复制 Markdown 正文。
• 回收站与防误删保障：DSH 技能删除后优先移入回收站，支持完整保留安装身份与更新历史的安全恢复。
• 自定义来源目录：外部 Agent 来源可以在面板里改读取位置，不移动任何文件；DSH 与公共 Agent 仍由宿主配置。
• 技能 Token 成本估算与实时汇总：在技能列表中直观展示简介近似 Token 徽标，并在状态栏实时统计随目录常驻系统提示词的 Token 总开销；精准区分仅手动调用、已停用与被覆盖技能，详情弹窗提供简介与正文的完整拆分与加载说明。

界面预览

全局技能：

项目技能：

技能仓库与发现：

截图展示核心功能面板，包含全局技能、项目技能与技能发现仓库。采用无损 WebP 格式。

安装

需要已安装并能正常运行 DeepSeek Harness。以下命令使用 web profile，请按实际环境替换。

插件安装支持 npm registry、本地构建的 .tgz 包和 GitHub。GitHub 与 npm 都包含可直接运行的 lib。改动源码后，提交前请先运行构建。

让 Agent 帮你安装

把这段话发给能够操作本机终端的 Agent：

请把 @michengai/dsh-skills-manager 最新版安装到我的 DSH web profile，使用官方 npm 源，安装后确认生效并告诉我如何重新加载。

手动安装

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-skills-manager@latest --registry=https://registry.npmjs.org/

安装后重启 DSH 并刷新页面，打开「设置 → 技能」即可使用。如需更新，请在宿主插件管理中更新，或重新执行安装命令。

• 1.4.7 已验证兼容 DeepSeek Harness 0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5、0.2.2-rc.1、0.2.2-rc.2、0.2.2-rc.3。
• 宿主支持范围：DeepSeek Harness 0.2.x 全系列（>=0.2.0-rc.1 <0.3.0-0），自动支持后续全部 0.2.x RC 版本，同代宿主升级无需重复等待发版。早期版本与 0.3.0 代际破坏性更新由版本门拦截。仍在使用 0.1.x 的，请安装插件 1.1.23，不要装 @latest。
• 反向代理部署：支持将 DSH 部署在带路径前缀的反向代理后面（如 /app/dsh/），插件 API 统一自动按页面基址（document.baseURI）相对解析。

插件配置与可选开关

插件遵循 DSH 官方扩展配置规范，配置项位于：

主界面侧边栏「插件」→ 点击 Skills Manager 详情页（对应宿主 plugins.bundle.config 槽位）。

此处提供原生配置项：

1. 侧边栏入口 (sidebarEntry)

• 默认状态：关闭（false）
• 功能说明：在宿主左侧主导航栏的「插件」下方增加常驻的 「技能」 图标入口。
• 生效效果：
  • 开启后，在侧边栏点击即可直达技能管理中心，并在主工作区以 960px 居中版心（对齐官方插件管理与市场规范）展开完整大面板，彻底告别在设置弹窗狭窄视口内滚动的局限；
  • 关闭后安全注销侧栏槽位；
  • 无论是否开启侧栏入口，DSH 原有的「设置 → 技能」入口始终保留，两处界面数据与状态 100% 实时同步。

使用指南

核心操作	操作方式
检索技能	切换「全局技能」或「项目技能」页签，按来源分组折叠/展开，或使用顶部搜索框与状态筛选器。
阅读技能	点击技能行右侧「查看详情」，在 760px 宽屏弹窗中阅读 SKILL.md 正文及诊断信息，支持一键「复制正文」。
控制启停	点击技能行右侧开关，切换其在 DSH 中的调用状态；仅影响 DSH 智能体执行，绝不改动第三方源文件。
更换外部来源目录	点击顶栏 ➕ 菜单中的「来源目录…」或在来源行点「修改技能目录」，输入或浏览目录后保存；「恢复默认」回到默认位置。只改本插件读哪里，不移动文件，外部来源仍只读。
整理分类与排序	在来源内点「新建分类」，拖拽抓手（⋮⋮）跨分类移动或调整技能顺序；开关分类可整组启停其成员技能。
创建与导入	点击顶栏 ➕ 菜单中的「创建技能…」或「导入技能…」，并排选择写入目标（用户目录或已登记工作区项目目录），系统自动核对安全路径。
发现与安装	切换到「发现」页签，浏览 ClawHub 热榜或搜索 skills.sh 目录，或点击「添加仓库」订阅公开 GitHub 仓库。
仓库技能更新	点击「刷新」，再点击「查看更新」预览文件 Diff 差异，确认后自动创建本地备份并完成更新。
版本回退	对存在备份的技能点击「恢复上一版」，预览差异并确认恢复。
回收与防误删	删除的 DSH 技能自动进入「回收站」，可随时完整恢复或永久删除。

按来源仓库分组

技能列表可在默认的「按来源目录」和「按来源仓库」之间切换。仓库视图按来源目录、仓库、仓库内目录展示技能；不能确定来源的技能显示为「来源未知」。来源依次读取本插件安装记录、目录锁文件和技能元数据，不根据目录名猜测。

仓库视图只改变浏览方式，不移动技能文件；技能启停、详情等操作仍可使用。创建分类、调整归类和拖拽排序请切回来源目录视图。

技能管理四大板块

1. 全局技能（Global Skills）
   • 集中展示当前电脑上所有 Agent 目录下的全局技能（跨项目通用）。
   • 支持按来源启停、按分类组织；当不同来源存在同名技能时，自动遵循优先级遮盖并给出来源提示。
2. 项目技能（Project Skills）
   • 顶部下拉选择当前 DSH 已登记的工作区目录，下方展示该项目所属的 Agent 技能。
   • 仅扫描并管理所选工作区；项目级同名技能优于全局副本生效。
3. 发现（Discover）
   • 公共市场：集成 ClawHub 热门下载榜与 skills.sh 全球技能库，输入关键字即可检索全球开源技能，一键完成多副本安装；
   • GitHub 仓库订阅：输入 GitHub 仓库地址，整仓扫描技能清单，支持增量版本比对、本地修改保护与更新备份。
4. 回收站（Trash）
   • 存放从 DSH 或公共 Agent 来源中删除的技能副本，保留原始安装位置与关联信息。
   • 误删技能可一键恢复回原目录，彻底杜绝意外丢失。

技能命名与 Frontmatter 规范

DeepSeek Harness 宿主加载机制对技能标识符遵循规范命名约束：

• 名称格式：宿主严格要求技能名称必须为 ASCII 小写字母、数字与连字符构成的 kebab-case 格式（如 my-custom-skill）；
• 中文技能目录自救：您的技能文件夹名称可以继续使用直观的中文名称（如 文案排版/），只需在其 SKILL.md 的 YAML frontmatter 中显式声明合法的英文 name 即可被宿主正常加载和调用：

  ---
  name: copy-formatting-helper
  description: 微信公众号与多平台文案排版辅助工具
  ---
  
  # 技能正文内容...
  

• 界面智能诊断：若本地存在缺少英文 name 的纯中文技能，管理器会在界面明确给出「宿主不支持此技能名称格式，无法启用」的诊断指引，并允许停用清理历史脏记录。

仓库与安装边界

• 仓库区「刷新」仅检查已订阅技能仓库内容更新，不自动覆盖本地；如需更新插件自身，请在宿主插件管理中更新或执行安装命令。
• 仓库安装可以写入用户目录下的 DSH skills 或公共 Agent（~/.agents/skills，可用 DSH_AGENTS_HOME 覆盖），也可以写入已登记工作区的 <项目根>/.dsh/skills。选择器显示实际配置路径，并禁用不安全路径；缺少的目录仅在确认安装后创建。不能安装到 Codex、Claude 等其他 Agent 目录。
• 所有仓库来源统一走 Git 按需检出：只下载包含 SKILL.md 的技能目录，仓库首页配图等无关内容不参与下载（指定子目录可进一步缩小范围）；本机没有可用 Git 时无法添加仓库，会直接提示先安装 Git。
• 更新前检测本地修改，覆盖必须明确确认；历史备份不自动清理，可随时恢复上一版。

支持的 Agent 目录

~ 表示用户主目录，<project> 表示已登记工作区的项目根。表中为默认路径；设置了对应环境变量时，以配置为准。环境变量覆盖对应 Agent 的主根目录，插件会在其目录下扫描 skills 文件夹（即 <环境变量值>/skills）。

This is the beginning of the README. Read the rest at the original. Read the full README ↗