skillhub-plugin
Đã xác minhskillhub-plugin · v0.2.16 · MIT · Giao diện web
DeepSeek Harness 插件：在对话中搜索、安装和管理 SkillHub 技能
Cài đặt
dsh plugin add skillhub-plugin Xác nhận layer đã áp bằng dsh --profile default --dump-config — xem hướng dẫn cài plugin.
Mã nguồn
Phát hành lên npm mà không có repository công khai. Hãy kiểm tra nội dung package trước khi cài.
Thẻ
Readme
skillhub
DeepSeek Harness 的 SkillHub 插件。在对话中搜索技能、查看详情并安装到 Harness 可发现的 skills 目录。
目录
功能
- 用公开接口搜索或按分类浏览技能
- 在对话流中展示可点击卡片（名称、分类、下载量、简介）
- 详情页包含概述、版本历史、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 安装 |
安全
安装第三方技能等于在本机落下可被 Agent 读取的文件。广场安装 DSH 插件会把第三方代码装进 web profile。请只安装已验证且你信任的来源。
漏洞请按 SECURITY.md 私下报告，不要发公开 Issue。
参与贡献
Bug 修复、测试、文档和交互优化都欢迎。提交前请阅读：
发布说明见 Releases。
许可证
SkillHub、DeepSeek 等名称归其各自所有者。本项目与它们没有从属或背书关系。