DeepSeek Harness 插件

WilShi/dsh-skill-station

Star 数 ★ 1 下载量(近 30 天) 1,373 分类 技能包 收录于 2026-08-22 npm dsh-skill-station

侧边栏技能站:扫描 Claude/Codex/Cursor/Gemini 技能目录一键导入,管理全局与项目技能(启停、回收站),支持拖拽文件夹、zip 包与本地路径(不限大小)安装。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-skill-station

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:WilShi/dsh-skill-station

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

DeepSeek Harness 的技能库、导入器与公开技能市场。

ci

English | 中文

技能站把 Agent 能用的技能收进一个页面:列出 DSH 家目录、共享 agents 目录和每个工作区下的全部技能;从 Claude Code、Codex CLI、Cursor、Gemini CLI 的现有技能库一键导入;也可以通过拖拽文件夹、ZIP、本地路径或公开 Agent Skills 市场安装新技能。公开市场不需要账号或令牌,入口在浏览器界面里,而凭据、网络请求和文件写入始终留在 Host 侧。

目录

截图

技能市场

技能市场页:skills.sh 结果列表,带安装、目标根目录、冲突策略和版本选择

浏览 skills.sh 目录或按关键词搜索,选择目标根目录与冲突策略,再用版本选择器一键安装。

安装结果

安装完成的市场技能,显示本地路径与 SHA-256

安装完成后,面板会给出技能的本地目录和规范归档的 SHA-256;同一个摘要会写进技能旁的 .dsh-skillhub.json。

技能库

技能库页:两个已安装技能、启停开关和逐项操作

技能库按根目录分组。可以切换模型调用、查看详情、分配场景标签、导出 ZIP,或把技能移入回收站;宿主内置技能只读展示。

截图来自本地 harness 调用真实 Host API 渲染,市场数据是 skills.sh 的线上数据。界面支持中文和英文,这几张截图使用中文界面。

功能

技能库

  • 按作用域分组列出所有可写根目录下的技能:$DSH_HOME/skills(通常是 ~/.dsh/skills)、~/.agents/skills,以及每个工作区的 <workspace>/.dsh/skills 和 <workspace>/.agents/skills。宿主内置技能单独成组,只读展示。
  • 按名称和描述搜索;详情视图展示解析后的 frontmatter、完整的 SKILL.md 正文,目录型技能还有文件树。
  • 直接编辑文本文件(包括 SKILL.md);保存后返回重新解析的元数据,列表状态保持准确。
  • 通过改写 frontmatter 里的调用开关(disable-model-invocation、user-invocable)启停技能,目录型 bundle 和扁平 <name>.md 都支持。
  • 把任意技能导出为以技能名命名的 ZIP;重新导入该压缩包即可还原目录结构。
  • 运行发现诊断,按宿主加载器的严格规则检查非法 YAML、缺少 name 或 description、非 kebab 名称、旧式 camelCase 开关键,并支持就地修复不规范的前置元数据。
  • 用受校验的向导新建技能,生成合法的 kebab-case SKILL.md。
  • 用场景标签给技能分组(例如「工程」「设计」);归属关系保存在 ~/.dsh/skill-station/scenes.json。
  • 删除只是移入可恢复的回收站;可以恢复条目,也可以显式清空回收站。

从其他 Agent 导入

  • 只读扫描 Claude Code、Codex CLI、Cursor、Gemini CLI 使用的技能库,绝不修改来源目录。

  • 默认扫描位置:

    Agent 用户级目录 工作区目录
    Claude Code ~/.claude/skills .claude/skills
    Codex CLI ~/.codex/skills .codex/skills
    Cursor ~/.cursor/skills .cursor/skills
    Gemini CLI ~/.gemini/antigravity/skills、~/.gemini/skills .gemini/skills
  • 可以导入到全局根目录,也可以导入到当前选中工作区的项目根目录。

  • 同名冲突支持跳过、改名、替换三种策略。改名会同步改写 frontmatter 里的 name,避免导入副本遮蔽原技能;替换会先把旧版本移入回收站。

  • 宿主技能 watcher 会发现新文件,导入后无需重启 DSH。

随处安装

  • 把技能文件夹拖进面板、用文件选择器挑选文件夹、拖入或选择 ZIP,或粘贴 Host 本机上已有文件夹的绝对路径。
  • ZIP 在 Host 侧解压;symlink 条目会被拒绝,所有路径在写入前都会校验。
  • 浏览器安装会先校验、在目标根目录内暂存,再用原子 rename 落到最终位置。暂存或 rename 失败时会清理暂存目录,并从回收站恢复被替换的技能。
  • 本地路径安装是磁盘到磁盘的流式复制,适合带 vendored 依赖树的大技能。

公开技能市场

  • 默认对接 skills.sh:通过公开 sitemap 发现目录、通过公开搜索 API 做关键词搜索、从 GitHub 仓库归档安装。
  • 市场身份沿用来源自身的唯一性规则,并成为安装后的技能名:skills.sh 用 owner--repo--skillId(例如 anthropics--skills--pdf,安装为 anthropics-skills-pdf)。
  • 其他后端只需改配置:OpenClaw 注册表、静态 JSON 目录,或部署方自带的企业 Skill Hub。界面、安装管线、冲突策略和来源记录完全一致。
  • 下载类技能支持跳过和替换两种冲突策略;改名会被拒绝并返回 409,因为归档自身已经定义了身份。
  • 每个市场技能都带来源记录:provider、上游身份、版本、归档 SHA-256 和安装时间。

环境要求

  • 支持插件机制的 DSH Web profile(0.2.x 系列)。本包 peer 依赖 @deepseek-ai/cordis ^4.0.5 与 0.2.1 的客户端 shell 包。
  • Node.js 22.19 以上(22.x 系列),或 Node.js 24。
  • DSH 支持的操作系统均可。路径遵循 DSH 约定,并识别 $DSH_HOME。

安装

把 bundle 加进你实际运行的 profile,然后重启该 profile:

dsh plugin --profile web add dsh-skill-station
# 重启 profile(例如 dsh web,或重新打开 Desktop)

需要移除时:

dsh plugin --profile web remove dsh-skill-station

这是一个标准 DSH bundle:cordis.patch.yml 会插入 Host 行来挂载 API,并插入 client 行来注册侧边栏按钮和设置分区;profile 会一直保留该插件,直到你主动移除。

DSH Desktop 同样按 profile 管理插件。如果你启动的 profile 里还没有技能站,用 --profile desktop(或你的 Desktop 构建实际使用的 profile 名)把同一个 bundle 装进去即可;已经内置该 bundle 的构建不需要额外安装。

安装后,从侧边栏底部的技能站按钮打开面板,或进入「设置 → 技能站」。

使用技能站

面板有五个标签页,顶部还有工作区选择器。选择器决定管理哪个工作区的项目根目录;全局根目录始终可用。

标签页 作用
技能库 浏览、搜索、启停、查看、编辑、导出、诊断、打标签;新建技能。
Skill 市场 浏览已配置的市场、按关键词搜索、选择目标根目录与版本,安装单个技能。
导入技能 扫描外部 Agent 技能库,勾选候选项,按冲突策略导入。
安装技能 拖入文件夹、选择文件夹、上传 ZIP,或粘贴本地绝对路径。
回收站 恢复已删除的技能,或清空回收站。

可写根目录(技能库按此顺序展示):

作用域 根目录
全局(用户) $DSH_HOME/skills,默认 ~/.dsh/skills
共享(用户) ~/.agents/skills
工作区 <workspace>/.dsh/skills
工作区(共享) <workspace>/.agents/skills

技能要么是目录型 bundle(<name>/SKILL.md 加附属资源),要么是直接放在根目录下的单个 Markdown 文件(<name>.md)。删除技能时,它总是先被移入 ~/.dsh/skill-station/trash。

技能市场

skills.sh(默认)

skills.sh 是一个公开的 Agent Skills 目录。它没有提供「一次列出全部技能」的 JSON,所以 Host 使用它公开暴露的三个入口:

环节 请求 说明
发现 GET /sitemap.xml → GET /sitemap-skills-N.xml 最多 4 万个技能页,首次浏览时解析,缓存 10 分钟
搜索 GET /api/search?q=... 关键词搜索;结果行带仓库、技能 id 和安装次数
归档 GET https://codeload.github.com/<owner>/<repo>/zip/HEAD 技能内容来自仓库自身的归档

同一个技能 id 只在单个仓库内唯一,所以 skills.sh 身份保留三段坐标:owner--repo--skillId。SKILL.md 的 name 必须是 kebab-case,因此身份会被投影成合法名称,安装为 anthropics-skills-pdf 而不是 anthropics--skills--pdf。安装请求始终指定一个精确身份;Host 会校验下载到的归档确实发布了该技能,对格式合法但并不存在的身份返回 404 NOT_FOUND。

其他后端

配置 后端 发现 下载 身份
market.mode: skills-sh(默认) skills.sh sitemap 分片或搜索 GitHub 仓库归档 owner--repo--skillId
market.mode: registry clawhub.ai 游标目录或搜索 注册表 ZIP 端点 owner--slug
market.mode: catalog 静态 JSON 文档 单个目录文档 GitHub、npm 或直链归档 条目 id
market.provider: htsc 部署方提供的企业 Skill Hub 部署方 API 不可变版本 ZIP 部署方技能名

静态目录默认读取 https://awesome-dsh-plugin.com/plugins.json。切换后端只是配置变化;面板、安装管线和安全检查共用同一套实现。

企业 Skill Hub

运行自有 Skill Hub 的部署,可以设置 market.provider: htsc 并填写只由 Host 读取的 skillHub 配置块,接入按组织授权的目录。本构建不内置任何默认 Hub 地址:base URL、Bearer 令牌和环境都必须由部署方提供。没有有效 Hub 配置时,市场页会给出可操作的不可用状态,技能库、导入和本地安装仍然正常工作。

冲突与来源记录

  • 跳过:保留已存在的技能不动;替换:把旧技能移入回收站后安装新归档。
  • 下载类安装不支持改名(409):市场归档自带身份,改名后的副本将不再对应来源。
  • 每次安装都会在技能旁写入 .dsh-skillhub.json:schema 版本、provider、市场身份、版本、归档 SHA-256 和安装时间。替换已安装的市场技能需要匹配的来源记录;本地技能或其他来源的技能不会被覆盖。

配置

市场默认零配置即可使用。下面所有字段都是可选的,写在 profile 配置中该插件的配置行下:

plugins:
  dsh-skill-station:
    # 替换内置的外部 Agent 扫描列表(可选)。
    sources:
      - id: claude
        label: Claude Code
        userDirs: ['~/.claude/skills']
        projectDirs: ['.claude/skills']
    # 浏览器上传请求体上限,单位字节(64 MiB)。
    maxBodyBytes: 67108864
    market:
      # external(默认)或 htsc(部署方提供的企业 Skill Hub)。
      provider: external
      # skills-sh(默认)、registry 或 catalog。
      mode: skills-sh
      baseUrl: https://skills.sh
      catalogUrl: https://awesome-dsh-plugin.com/plugins.json
      npmRegistry: https://registry.npmjs.org
      maxPages: 8
      timeoutMs: 15000
      maxAttempts: 3
      catalogCacheTtlMs: 600000
    # 只由 Host 读取,不会下发到渲染进程;仅 htsc 需要。
    skillHub:
      baseUrl: https://skillhub.example.com/ai_skillhub_service
      apiToken: <部署方令牌>
      userId: <部署方用户身份>
      environment: uat
配置项 默认值 含义
maxBodyBytes 67108864 浏览器请求体大小上限,单位字节。
sources Claude Code、Codex CLI、Cursor、Gemini CLI 只读扫描的外部技能库。该列表会替换默认值,而不是追加上去。
market.provider external external 使用公开市场,htsc 使用部署方 Skill Hub。
market.mode skills-sh 公开市场形态:skills-sh、registry 或 catalog。
market.baseUrl 随 mode 变化 市场根地址;skills-sh 默认 https://skills.sh,registry 默认 https://clawhub.ai。
market.catalogUrl https://awesome-dsh-plugin.com/plugins.json catalog 模式读取的目录文档。
market.npmRegistry https://registry.npmjs.org 解析目录里 npm 包条目的 registry。
market.maxPages 8 每次浏览 registry 目录时翻取的页数。
market.timeoutMs 15000 单次网络请求超时,单位毫秒。
market.maxAttempts 3 可重试目录请求的尝试次数。
market.catalogCacheTtlMs 600000 目录缓存时长(10 分钟)。
skillHub.baseUrl — 部署方提供的 Skill Hub 服务根地址。
skillHub.apiToken — Hub 的 Bearer 令牌,只存在 Host 侧。
skillHub.userId — 部署方未注入时可显式指定的用户身份。
skillHub.environment — dev、sit、uat 或 prd。
skillHub.allowInsecureUat false 是否允许 UAT Hub 使用明文 HTTP。
skillHub.timeoutMs 10000 单次 Hub 请求超时,单位毫秒。
skillHub.maxAttempts 3 可重试 Hub 请求的尝试次数。
skillHub.maxResponseBytes 67108864 从 Hub 读取的响应大小上限。
skillHub.backoffBaseMs 500 Hub 请求的初始重试退避。

Hub 部署也可以通过环境变量 SKILLHUB_BASE_URL、SKILLHUB_API_TOKEN、SKILLHUB_ENV、SKILLHUB_USER_ID 提供这些值,而不写进配置行。配置和环境变量都由 Host 进程读取;渲染进程只会收到一个「市场是否已配置」的状态对象。

实现方式

Host 与 Client 分界

本包由同一个 bundle patch 挂载两半:

  • Host(src/):Cordis 函数插件,名称 dsh-skill-station,inject webServer,在 ctx.effect() 内注册一条前缀路由 /skill-station/api,随插件卸载。它负责解析可写根目录、从磁盘枚举技能、校验每次写入是否落在根目录内,并执行所有网络访问。
  • Client(src/client/):一个浏览器 bundle,形态是 DSH Web shell 的 window.__ModuleLoader__.load({ id, factory }),其中 factory 是 CommonJS 闭包,react、react-dom、@deepseek-ai/* 从 shell 的模块表解析。它注册两个 slot:sidebar.footer.action(打开抽屉的按钮)和 settings.section(同样的面板内嵌到设置页),并注册中英文词典。

渲染进程只通过本地 API 与 Host 通信,永远拿不到市场归档、上游响应体、技能根之外的文件路径或 Skill Hub 令牌。

HTTP API

所有路由位于 /skill-station/api 下并返回 JSON。变更类请求必须同源,POST 请求体必须声明 application/json。

方法 路由 用途
GET /roots 工作区与已配置的外部来源
GET /skills 按根目录分组的技能,以及宿主注册表视图
GET /skill 单个技能的元数据、正文和文件树
GET /file 技能内的单个文本文件
GET /export 下载单个技能的 ZIP
GET /diagnose 会被宿主加载器忽略的技能及原因
GET /scenes 场景标签归属
GET /trash 当前回收站条目
GET /market/status 市场 provider 与配置状态
GET /market/skills 市场目录或关键词搜索
POST /scan 扫描外部 Agent 技能库
POST /import 导入选中的外部技能
POST /upload 安装拖入或选择的文件集
POST /upload-zip 安装上传的 ZIP 归档
POST /market/install 安装单个市场技能
POST /toggle 启停技能
POST /delete 把技能移入回收站
POST /trash-restore 恢复回收站条目
POST /trash-empty 永久清空回收站
POST /scenes/assign、/scenes/unassign 修改场景标签
POST /save-file 保存编辑过的文件
POST /repair 修复不规范的前置元数据
POST /scaffold 通过向导新建技能

安装管线

所有安装、导入和市场下载都走同一条路径:

  1. 校验。 解析传入的 SKILL.md,要求 kebab-case 的 name 和非空 description;在严格的宿主加载器看到文件之前,先修复常见的真实世界 frontmatter 损坏(例如 description 里未加引号的冒号)。
  2. 确定名称。 应用冲突策略:跳过、改名(仅导入)或经回收站替换。
  3. 暂存。 把完整文件集写入目标根目录内的隐藏 .staging-<uuid> 目录,逐项检查路径包含性、单文件大小和总大小。复制时跳过 symlink,归档中出现 symlink 直接拒绝。
  4. 复核。 重新读取暂存区里的 SKILL.md,确认元数据合法后才改动目标位置。
  5. 提交。 用一次原子 rename 把暂存目录移到目标路径。
  6. 回滚。 如果替换操作已把旧技能移入回收站,之后任何一步失败都会恢复回收站条目,并清理暂存目录。

归档规范化

不同市场返回的形态不同:GitHub 仓库归档、注册表 ZIP、npm tarball 或直链归档。在归档进入安装器之前,Host 会把它重建为规范形态:

  1. 解码 ZIP 或 gzip 压缩的 tarball,丢弃绝对路径、.. 段、控制字符和 Windows 设备名的条目。
  2. 去掉唯一的顶层文件夹,然后按 skills/<skillId>/SKILL.md、<skillId>/SKILL.md、最浅层 SKILL.md 的顺序定位技能目录。skills.sh 模式要求身份匹配,因此发布不出该技能的归档会被拒绝,而不是装进一个无关的模板。
  3. 只保留该技能根目录下的文件,重新生成一个以技能目录为根的 ZIP,并在根 SKILL.md 的 name 与市场身份不一致时改写它。
  4. 限制归档规模(5,000 个条目、单文件 32 MiB、总计 64 MiB),再交给普通安装管线。

安全模型

  • 仅同源。 所有变更请求和所有 /market/* 请求必须来自同源或非浏览器调用;跨源 Origin 会在任何工作开始前被 403 拒绝。
  • 仅 JSON。 未声明 application/json 的 POST 请求会被 415 拒绝,从而挡住简单的跨站表单提交。
  • 路径包含。 每个写入目标都会规范化并检查是否落在对应根目录内。上传路径拒绝绝对路径、..、反斜杠、控制字符和 Windows 设备名;文件查看与保存被限制在技能目录内。
  • 不跟随 symlink。 目录复制、导出和归档解码会跳过或拒绝符号链接,技能根目录本身必须是真实目录。
  • 有界的工作量。 默认请求体上限 64 MiB。浏览器 ZIP 解压上限为 10,000 个条目、总计 256 MiB;安装文件单文件上限 64 MiB、总计 256 MiB。市场归档更严格:5,000 个条目、单文件 32 MiB、总计 64 MiB。文件查看在 512 KiB 处截断,就地编辑上限 2 MiB。
  • 令牌隔离。 Skill Hub 令牌只从 Host 配置或环境读取,永远不会被序列化进客户端 bundle 或渲染进程响应;市场错误会映射成稳定、脱敏的错误码。
  • 身份校验。 市场归档必须确实发布了请求的技能身份;安装来源记录也会在替换时校验,避免不同 provider 互相覆盖。
  • 诚实的信任边界。 公开市场对所有人开放,上游只有自动审核。记录的 SHA-256 只是对重建归档的本地完整性校验,不是签名,也不是信任判断。启用前请审阅第三方技能说明。DSH 技能本身就是可执行的指令和资源。

实测证据

0.2.1 的 Host API 在真实 HTTP 服务器和真实网络(skills.sh 搜索与 codeload.github.com 归档)上跑过,$HOME 隔离到临时目录:

检查项 结果
Host API 端到端套件 22 / 22 用例通过,70 条断言,0 失败(Node.js 22.22.3,darwin-arm64)
真实关键词搜索 GET /market/skills?keyword=pdf 1.7 秒返回 6 条;首条 anthropics--skills--pdf(测试时 222,304 次安装)
真实安装 anthropics/skills 的 pdf 归档(4,317,426 B,543 个条目)8.0 秒安装完成:写入 13 个文件(12 个技能文件加来源记录),SKILL.md 8,101 B
内容来源 12 个 payload 文件中 11 个与 GitHub 归档逐字节相同;SKILL.md 仅 frontmatter 的 name 行不同,归一化该行后与上游一致;磁盘上没有多余文件
生命周期 关闭、打开、删除、回收站、恢复全部返回 200;恢复后 SKILL.md 的 SHA-256 不变,回收站为空
反向用例 未知技能 404、跨源请求 403、非 JSON 类型 415、非法分页或参数 400、未知根目录 400、下载改名 409
身份校验 格式合法但未发布的 skills.sh 身份会被 404 NOT_FOUND 拒绝
隔离性 真实 ~/.dsh 在运行前后逐字节一致

测试 harness 从源码重新构建 Host API,用真实 node:http 请求驱动,并对照单独下载的上游归档核对落盘内容。网络耗时因机器和线路而异;上面的计数和摘要来自该次运行。

目录结构

.
├── src/
│   ├── index.ts             # Host 插件入口:挂载 HTTP 路由
│   ├── api.ts               # 路由分发、请求校验、安装编排
│   ├── external-market.ts   # skills.sh / registry / catalog 客户端与归档规范化
│   ├── skillhub.ts          # 企业 Skill Hub 客户端(令牌只在 Host 侧)
│   ├── roots.ts             # 可写根目录、路径包含、磁盘枚举
│   ├── scanner.ts           # 只读的外部 Agent 技能库扫描
│   ├── importer.ts          # 冲突策略、暂存安装、回滚
│   ├── zip.ts               # 上传 ZIP 解码与大小限制
│   ├── frontmatter.ts       # YAML frontmatter 解析、修复、开关、改名
│   ├── diagnose.ts          # 按宿主加载器规则做发现诊断
│   ├── export.ts            # ZIP 导出
│   ├── trash.ts             # 回收站清单、恢复、清空
│   ├── scenes.ts            # 场景标签持久化
│   └── client/              # 浏览器 bundle:entry、App、MarketTab、api、locales、styles
├── docs/screenshots/        # market.png、install.png、library.png
├── scripts/                 # build-client.mjs、verify-client.mjs、smoke.mjs
├── tests/                   # Vitest 规格
├── cordis.patch.yml         # 激活插件行的 bundle patch
├── MARKET.md                # 市场 provider 参考
├── DESIGN.md                # 架构说明
└── .github/workflows/ci.yml # Node 22/24 构建、测试、冒烟

开发

npm install
npm run build     # Host TypeScript、客户端 bundle 与 bundle 形态校验
npm test          # Vitest 单元与组合测试
npm run smoke     # 启动构建产物并逐项调用所有端点

仓库不带 lockfile,因此 CI 使用 npm install 而不是 npm ci。构建产物写入 lib/,该目录已被 git 忽略;客户端构建会被包装成 window.__ModuleLoader__.load,并由 scripts/verify-client.mjs 把关(banner、插件 id、shell 模块是否 external、以及在沙箱里试跑 factory)。npm run typecheck 只做类型检查,不产出文件。

CI 使用 Node.js 22/24 矩阵:安装、构建、单元测试、构建产物冒烟测试。

已知限制

  • 公开市场不提供上游签名。本地摘要能发现归档被改动,但不能证明是谁构建的;启用技能前请审阅第三方说明。
  • 下载类技能不能在安装时改名(409);需要不同名称时,先卸载或重命名已有技能。
  • 浏览器上传必须经过 JSON 请求体,超大技能建议改用本地路径安装。
  • 企业 Skill Hub 需要部署方提供配置;没有配置时市场页会显示不可用,但本地技能库和导入功能不受影响。
  • 市场后端是第三方服务,可能调整接口或限流;429 会作为错误返回,目录缓存 10 分钟。
  • 记录的 SHA-256 覆盖的是重建后的归档。安装时会重建归档,因此这个摘要代表该次安装的完整性记录,而不是可复现的上游摘要。

许可证

MIT

致谢

  • skills.sh —— 默认市场使用的公开 Agent Skills 目录。
  • clawhub.ai —— OpenClaw 注册表后端。
  • awesome-dsh-plugin.com —— 默认静态目录。
  • DSH 团队提供的宿主技能注册表、Web 服务、slot 与本地化 API。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。