New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →

skillhub-plugin

Dependencies

Maintainers

Versions

Alerts

File Explorer

Advanced tools

License

Install Socket

Detect and block malicious and high-risk dependencies

Install

skillhub-plugin

DeepSeek Harness 插件：在对话中搜索、安装和管理 SkillHub 技能

latest

Source

npm

Version: 0.2.16

Version published: 2 months ago

Weekly downloads: 0

Maintainers: 1

Weekly downloads

Created: 2 months ago

Source

skillhub

DeepSeek Harness 的 SkillHub 插件。在对话中搜索技能、查看详情并安装到 Harness 可发现的 skills 目录。

最新正式版：v0.2.16 · npm · 更新日志

功能

用公开接口搜索或按分类浏览技能
在对话流中展示可点击卡片（名称、分类、下载量、简介）
详情页包含概述、版本历史、TRACE 评测；标题栏显示 AI 评分、认证发布者与安全标记
通过 zip 下载安装到本机，可指定版本；支持列出与卸载
设置页可查看已安装技能，并一键更新到 GitHub 最新 release
侧栏底部 插件广场：在聊天区打开独立面板，浏览 SkillHub 技能与 DSH 插件
对话中直接搜索 DSH 插件并展示插件卡片，支持卡片一键直装（就地进度条）、装完提示并一键重启
插件广场支持「全部 / 已安装」切换：本地只读预览已安装插件（来源 spec、版本、README）与已安装技能的 Meta 卡片（文件数、体积、更新时间）
对话中的已装技能工具卡片升级为与广场一致的 Meta 卡片
界面跟随 Harness 中英文

环境要求

Node.js 22 或更高版本
pnpm 11（见 packageManager 字段）
DeepSeek Harness Web

安装

从 npm 安装（预构建，不需要 allowBuilds）：

dsh plugin --profile web add skillhub-plugin

兼容旧包名：

dsh plugin --profile web add @cocofhu/skillhub

本地开发：

dsh plugin --profile web add /absolute/path/to/skillhub

安装后重启 dsh web，并强制刷新浏览器。dsh web 请绑定 127.0.0.1，不要监听 0.0.0.0。不要用 github:cocofhu/skillhub 安装：git 源会跑 prepare，pnpm 会要求手写 allowBuilds。npm 上的无前缀名 skillhub 是另一个项目，请用 skillhub-plugin。

使用

可以直接对 Agent 说：

找个能处理 PDF 的 skill

SkillHub 上搜一下周报

我装了哪些技能

把刚才那个卸载掉

搜个浏览器自动化的 dsh 插件

装一下第一个插件

搜索完成后对话中会显示可点击卡片；点开详情后再安装。插件卡片同样出现在对话流里，可直接点安装就地看进度，装完按横幅提示 立即重启。不要让 Agent 打印安装命令或 curl。

插件广场

侧栏底部 插件广场 在聊天区域打开独立面板（可切换插件 / 技能），不会出现在「对话 / 轨迹」标签里，也不再注入设置页。面板盖在会话列上，关掉后直接回到对话。

点插件的安装会读取 SkillHub 的 install-plan，校验仓库与 pinned commit 后，由本插件在宿主进程里执行 dsh plugin --profile web add github:owner/repo#sha（与 dsh-market 相同，不走 Agent 沙箱）。安装过程显示进度条；若 pnpm 拦截 git 源的 prepare，会写入 web profile 的 dangerouslyAllowAllBuilds 并自动重试。装完会提示重启，并提供 立即重启（同源页面即可，含轻量云等反向代理；若 dsh web 由 systemd 托管则走 systemctl restart）。已装进当前 web profile 的插件会显示「已安装」。对话里的技能搜索 / zip 安装不受影响。

已安装视图（本地只读预览）

广场两个分类页顶部都有 全部 / 已安装 切换器（带已安装计数与「本机数据 · 只读预览」旁注）。切到「已安装」后完全不请求远端，数据全部来自本机文件系统的只读接口：

插件页：枚举 web profile package.json 依赖，展示本机已安装插件的卡片（包名、来源 spec、版本、描述、已安装徽章）。github: / npm / link: 三类来源都能识别；点卡片打开抽屉，含概览与 README（Markdown 渲染，超过 64 KB 自动截断并提示），底部可卸载。非 dsh 依赖不会混入列表，只以「另有 N 个非 dsh 依赖」计数折叠提示。
技能页：以 Meta 卡片展示本机已安装技能（名称 + 已装徽章 + 版本、slug、两行描述、文件数 / 体积 / 更新时间统计行），点开为本地概览抽屉，并明确标注不浏览技能文件内容。切回「全部」恢复原有搜索状态。

对话中的 skillhub_list 工具卡片同步升级为同款 Meta 卡片，保留 详情 / 卸载 操作。

Agent 工具

工具	作用
`skillhub_search`	搜索或浏览技能，并展示卡片
`skillhub_install`	按 slug 安装；可传 `version`
`skillhub_list`	列出已安装技能
`skillhub_uninstall`	卸载本地技能目录
`skillhub_plugin_search`	搜索或浏览 DSH 插件，并展示插件卡片（支持 `query` / `category` / `sort` / `limit` / `offset` 翻页，已安装标注）
`skillhub_plugin_install`	用户点名后按 `owner` + `name` 安装 DSH 插件（同一 install-plan 校验链），装完提示重启 dsh web

配置

打开 设置 → 插件 → 插件配置 → SkillHub：

项	说明
API 地址	默认 `https://api.skillhub.cn`
安装目录	默认 `$DSH_HOME/skills`（通常是 `~/.dsh/skills`）
搜索结果上限	每批返回的卡片数量，默认 12

标题栏有更新按钮：会查询 GitHub 最新 release，并用 dsh plugin add github:cocofhu/skillhub#vX.Y.Z 安装。更新后请重启 dsh web 并强制刷新。若当前是本地 link: 开发安装，更新会改成 GitHub release 安装。

保存后立即生效。配置写入 Harness 用户目录下的 skillhub.json，不会进入 git。

也可通过 cordis.patch.yml 设置默认值：

- id: skillhub
  config:
    skillsDir: ~/.dsh/skills
    maxResults: 12

安装完成后，新对话即可被 dsh-skill-filesystem 发现。该目录有文件监视，多数情况无需重启 Harness。

数据与网络

插件只请求 SkillHub 公开 HTTP API，并把技能包写到配置的 skills 目录。图标经本机插件服务转发。自定义 API 地址应只指向你信任的服务。

用途	请求
搜索 / 浏览	`GET /api/skills`
技能详情	`GET /api/v1/skills/{slug}`
版本历史	`GET /api/v1/skills/{slug}/versions`
TRACE 评测	`GET /api/v1/skills/{slug}/evaluation`
内容签名	`GET /api/v1/open/skills/{slug}/versions/{version}/signature`
安装包	`GET /api/v1/download?slug={slug}&source=dsh`
DSH 插件类目	`GET /api/v1/plugins/categories`
DSH 插件目录	`GET /api/v1/plugins`
插件安装计划	`GET /api/v1/plugins/{owner}/{name}/install-plan`

上游请求有超时；技能 zip 安装会拒绝路径穿越，并要求解压结果含 SKILL.md。技能包来自第三方，插件不执行其中的代码。广场安装 DSH 插件会在本机执行 dsh plugin add，写入当前 web profile。

开发

git clone https://github.com/cocofhu/skillhub.git
cd skillhub
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm test:coverage
pnpm build

源码在 src/，构建输出到 lib/。lib/ 不进版本库，安装或发布时由 prepare 生成。

文件	作用
`src/host.ts`	Cordis 入口：工具注册、systemPrompt、settings
`src/local-api.ts`	本机 `/skillhub` HTTP（搜索、安装、广场、详情、更新）
`src/client.js`	搜索卡片、详情弹窗、设置页、插件广场、已安装视图
`src/api.ts`	搜索与技能卡片映射
`src/plugin-market.ts`	DSH 插件目录查询与 install-plan 安装
`src/installed-plugins.ts`	已安装插件枚举与 README 只读预览（web profile）
`src/markdown.ts`	README Markdown 安全渲染（白名单 HTML，仅 http(s)/mailto/# 链接）
`src/dsh-cli.ts`	复用当前 dsh 进程执行 `dsh plugin add`，解析 pnpm ndjson 进度
`src/ndjson.ts`	pnpm `--reporter=ndjson` 进度解析
`src/restart.ts`	同源一键重启当前 dsh web（含反向代理）
`src/install.ts`	zip 下载、解压、安装 / 卸载
`src/skill-detail.ts`	版本历史与 TRACE 评测
`src/unzip.ts`	zip 解压（含 data descriptor）
`src/self-update.ts`	查询并安装 GitHub 最新 release
`src/config-store.ts`	默认值与 `skillhub.json`

修改 Host（src/*.ts）后需要重启 dsh web。修改 Client（src/client.js）后复制到 lib/client.js 并强制刷新即可。

更完整的约定见 CONTRIBUTING.md。

故障排查

现象	处理
页面停在 Loading plugins	确认 `pnpm build` 成功，重启 `dsh web` 后强制刷新
`cannot get property "locale" without inject@skillhub`	升级到含此次修复的版本；重启 `dsh web` 并强制刷新
搜索卡片未出现	开新对话，确认 `skillhub_search` 已加载
安装失败 / `unexpected end of file`	确认能访问 download 接口；本插件按中央目录解压 zip
装了但 Agent 看不见	确认装到 `$DSH_HOME/skills` 或项目 `.dsh/skills`，并新开对话
找不到插件市场	点侧栏底部插件广场；重启 `dsh web` 并强制刷新
广场点安装失败	确认当前是 `dsh web` 拉起的进程，且 web profile 可写
设置里点更新失败	确认能访问 `api.github.com`，且 web profile 可执行 `dsh plugin add`
pnpm 拒绝 `prepare`	广场安装会自动写入 `dangerouslyAllowAllBuilds`；自装 SkillHub 请用 `dsh plugin add skillhub-plugin`，不要从 git 安装