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.6 已验证兼容 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）。

来源	全局目录	环境变量	项目目录
DSH	~/.dsh/skills	DSH_HOME	<project>/.dsh/skills
公共 Agent	~/.agents/skills	DSH_AGENTS_HOME	<project>/.agents/skills
CC Switch	~/.cc-switch/skills	—	—
Codex	~/.codex/skills	DSH_CODEX_HOME	<project>/.codex/skills
Claude Code	~/.claude/skills	DSH_CLAUDE_HOME	<project>/.claude/skills
Gemini	~/.gemini/skills	DSH_GEMINI_HOME	<project>/.gemini/skills
OpenCode	~/.config/opencode/skills	DSH_OPENCODE_HOME	<project>/.opencode/skills
Cursor	~/.cursor/skills	DSH_CURSOR_HOME	<project>/.cursor/skills
Copilot	~/.copilot/skills	DSH_COPILOT_HOME	<project>/.github/skills
Windsurf	~/.codeium/windsurf/skills ~/.windsurf/skills	DSH_WINDSURF_HOME DSH_WINDSURF_USER_HOME	<project>/.windsurf/skills
Trae	~/.trae/skills	DSH_TRAE_HOME	<project>/.trae/skills
Trae CN	~/.trae-cn/skills	DSH_TRAE_CN_HOME	<project>/.trae-cn/skills
OpenClaw / Clawdbot	~/.openclaw/skills ~/.clawdbot/skills	DSH_OPENCLAW_HOME DSH_CLAWDBOT_HOME	—
Roo	~/.roo/skills	DSH_ROO_HOME	<project>/.roo/skills
CodeBuddy	~/.codebuddy/skills	DSH_CODEBUDDY_HOME	<project>/.codebuddy/skills
WorkBuddy	~/.workbuddy/skills	DSH_WORKBUDDY_HOME	<project>/.workbuddy/skills
Qoder	~/.qoder/skills	DSH_QODER_HOME	<project>/.qoder/skills
Qoder CN CLI	~/.qoder-cn/skills	DSH_QODER_CN_HOME	—
Qoder CN	~/.lingma/skills	DSH_LINGMA_HOME	<project>/.lingma/skills
Google Antigravity	~/.gemini/config/skills	DSH_ANTIGRAVITY_HOME	<project>/.agents/skills

不扫描普通项目根目录的 <project>/skills，避免把仓库的发布资源当作 Agent 技能。OpenClaw / Clawdbot 仅保留上表中的用户级来源。Qoder CN CLI 的项目技能在 <project>/.qoder/skills，显示为 Qoder。Qoder CN IDE 使用 Lingma 目录。不存在的外部来源目录不会显示。 外部 Agent 来源（CC Switch、Codex、Claude Code 等）可以在来源行直接改读哪个目录，保存后立即生效。覆盖保存在 ~/.dsh/skills-manager/roots.json，优先级高于 DSH_<AGENT>_HOME；手工编辑该文件需重启 DSH。DSH 与公共 Agent 是宿主的扫描路径，不在此处开放，需要整体搬迁时请改 DSH_HOME / DSH_AGENTS_HOME。目录必须已存在，且不能与其它来源重叠；自定义目录失效时来源会保留在列表里，方便改回默认。

自定义来源（清单外的 Agent）

表里没有的 Agent 不必等插件发版：通过顶栏 ➕ 菜单打开「来源目录…」，点「添加来源」，填它的技能目录即可。自定义来源与外部只读来源同构——只扫描不写入、不改动第三方文件，支持分组、拖拽归类、来源级与分类级启停；显示名默认取目录名，也可以自己填。

如果一个 Agent 用多个子 profile（多账号、多工作区）各自维护一套技能，填产品总目录再点「扫描子目录」：插件会向下找两层内所有含 SKILL.md 的 skills 目录，列成候选，每条显示为「产品名 / 子目录名」并标注技能数量，确认后一次登记。扫描只产生候选，不会自动登记；与已有来源重叠的候选会被标出并禁止登记。

登记信息写在 roots.json 的 customSources 段，与目录覆盖共用同一个文件。移除登记只删除这条记录，磁盘上的技能文件保持原样。上限 32 个自定义来源。

Agent 预设模式（Agent Presets）

插件自动发现 DSH 中包含专属技能目录的 Agent 预设模式，并稳定归位于全局技能列表末尾：

• 官方内置预设（如创造模式）：随包内置的技能严格保持只读浏览，支持查看详情，不提供无意义开关且不改动宿主内置文件；
• 自定义预设模式：您在 DSH 中自行创建的自定义模式（通过 customSkillDirs 配置了专属技能目录），支持与全局技能完全一致的管理能力——包括启停单个技能或整组开关（实时拦截宿主调用）、整理分类与添加备注、在「创建技能」「导入」「仓库 / 市场安装」弹窗中直接选择目标预设模式写入，以及卸载删除至回收站和原路径恢复。与全局技能目录重叠的预设路径将被安全拦截以防误删；配置为相对路径的预设出于防写偏安全考虑，自动以「只读（相对路径）」模式展示（配置为绝对路径即可开放完整管理）。

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

插件	你可以用它做什么
Codex UI	整理项目与会话、搜索任务、跳转对话轮次
Agency Agents	按任务选择并召唤专业角色
Skills Manager	管理本机与项目技能，从仓库安装、更新和回退
Archive Manager	搜索、恢复或清理已归档会话
IM Connect	从消息平台下任务、收回复
Automation	按计划执行任务，查看每次运行的结果
BTW	在当前上下文中临时旁问，不打断主任务
Simplify	用 /simplify 整理 Git 改动范围内的代码
PUA	引导 Agent 在失败时换方法、查原因，并在完成前验证结果
Code Review	用 /review 发起独立 Agent 代码审查，在当前会话接收报告
Codex Pet	通过桌面宠物查看会话提醒、处理工具审批和问题回答

反馈与贡献

遇到问题或有建议，欢迎提交 Issue。请附上 DSH 与插件版本、复现步骤；界面问题可附完整截图。

源码位于 src，使用严格 TypeScript，保留现有插件架构。开发时执行 npm run typecheck 检查类型，npm run build 生成运行产物，npm run verify 执行完整回归与打包验证。GitHub 与 npm 都包含可直接运行的 lib。改动源码后，提交前请先运行构建。打包前仍会自动检查类型并构建，npm 安装包仍包含所需 JavaScript 产物。CI 在 Node.js 22.19.0 和 24 上执行完整验证，代码改动也会自动触发受支持宿主兼容矩阵。欢迎提交改进。

从源码制作测试包时，使用项目固定版本的 pnpm 安装依赖，执行 npm run verify，再执行 npm pack。用 dsh plugin --profile web add <package.tgz> 安装生成的 .tgz，重启 DSH 并刷新页面。打包时不要使用 --ignore-scripts，否则会跳过构建钩子。

许可证

Apache License 2.0