ZASENJC/dsh-plugins-store

DSH 插件市场面向 DeepSeek Harness 生态，自动收录同时带有 dsh-plugin 与 deepseek-harness Topic 的公开项目，提供目录检索、排行榜与 公开 API。配套的 DSH Web 插件可独立安装并接入 /store 和 Agent 会话；验证结果来自固定源码 SHA 的结构检查与 Linux 隔离沙箱。

访问 DSH 插件市场（DeepSeek Harness 插件目录）

功能

• 自动收录同时带有 dsh-plugin 与 deepseek-harness Topic 的公开仓库，并排除归档仓库、Fork 和宿主应用
• 提供独立的 目录、已验证和 排行榜页面，支持搜索、分类、筛选和排序
• 排行榜支持 24 小时 Star 增速、最多 Star、最新发布和最近更新；项目详情展示分类依据、同标签项目和验证进度
• 每 30 分钟自动同步 GitHub 仓库数据
• 配套 DSH Web 插件支持通过 /store、设置页和 Agent 会话浏览市场，并在用户明确请求和确认后安装、更新或移除 Web profile 插件

安装 DSH Web 插件

以下命令安装市场自身的 DSH Web 插件：

dsh plugin --profile web add npm:dsh-plugins-store

安装完成后重启 DSH Web 并刷新浏览器。源码安装、本地构建、卸载、市场工具及 search-dsh-store skill 的完整说明见 packages/dsh-plugins-store/README.md。

项目截图

收录与验证

项目分类优先使用仓库公开的 GitHub Topics，并与站内词典和词根规则比对。标签不足时，项目会保留为“其他”或“待识别”，不会根据名称强行推断。

收录仅表示仓库同时出现在 dsh-plugin 与 deepseek-harness Topic，且未被识别为归档仓库、Fork 或宿主应用，不代表项目已经通过安装、兼容性、安全性或质量验证。目录同步模块只读取公开仓库元数据，不执行第三方代码；可选 DSH Web 插件只会在用户阅读风险提示并明确确认后发起安装。

独立验证流程先对固定 SHA 做源码特征分类，再只对分类后的待验证目录进入一次性 Linux 沙箱。沙箱无商店密钥、非 root、资源受限，安装、激活、入口导入和 apply 调用均在隔离环境中完成；失败结果带错误码进入人工复核，不会进入源码排除名单。只有绑定当前仓库 ID、SHA、DSH 版本、平台和验证器版本的通过结果才显示“已验证”；该标记不等于完整安全审计或官方背书。

商店 API

商店提供公开、只读的完整目录接口：

GET https://api.dshmk.com/

• 无需鉴权，不接收查询参数。
• 返回整个目录，不提供服务端搜索、筛选或分页；调用方应在本地处理。
• 目录约每 30 分钟刷新一次。请使用 schemaVersion 判断响应是否兼容，不要依赖仓库数组顺序。
• 生产响应允许跨域读取，浏览器插件可直接请求；命令行、Node.js 或其他服务端同样可直接调用。

使用示例

使用 curl 获取目录并读取基础信息：

curl --fail --silent --show-error \
  --header 'Accept: application/json' \
  https://api.dshmk.com/ \
  | jq '{schemaVersion, generatedAt, stats}'

在 Node.js 22+ 中筛选当前已验证的插件：

const response = await fetch('https://api.dshmk.com/', {
  headers: { Accept: 'application/json' },
})

if (!response.ok) {
  throw new Error(`目录请求失败：HTTP ${response.status}`)
}

const catalog = await response.json()
if (catalog.schemaVersion !== 1 || !Array.isArray(catalog.repositories)) {
  throw new Error('不兼容的目录响应')
}

const verifiedPlugins = catalog.repositories.filter((repository) =>
  repository.projectType === 'plugin'
  && repository.validation?.overall === 'verified',
)

响应字段

判断当前验证状态时，只应使用 repositories[].validation.overall === "verified"。status.verification、历史验证链接或曾经通过的记录不能替代当前结果。

安装消费者应读取 action 与 specifier，再由本地 DSH 环境选择 profile 并执行结构化参数。例如 DSH Desktop 应使用 desktopProfiles.current 作为 profile 真值，并把 ['add', candidate.specifier] 交给 desktopPnpm.runPlugin()。command 与 args 为普通 DSH 展示和旧消费者保留，其中可能包含 web profile；不要把 command 当作 shell 文本直接执行。确认、来源校验、超时、取消和执行结果均由消费者负责，目录 API 不接收或推断用户的本地 profile。

自动化架构

自动化主链只有三步：源码分类、增量验证、目录同步与生产发布。分类每小时自动运行，目录每 30 分钟独立刷新；验证完成后也会触发目录同步。验证没有新结果或执行失败时，发布流程继续使用最近一次成功状态，不会中断网站更新。

flowchart TB
  CLASSIFY["1. Classify plugins<br/>源码分类，不执行第三方代码"]
  VALIDATE["2. Validate plugins<br/>增量结构检查与 Linux 隔离验证"]
  SYNC["3. Sync catalog<br/>目录同步、测试构建与生产发布"]

  CLASSIFY -->|分类完成后自动触发| VALIDATE
  VALIDATE -->|验证完成后自动触发| SYNC
  SYNC -.->|最新发现快照进入下一轮| CLASSIFY

  CLASSIFY_TIMER["每小时自动分类"] --> CLASSIFY
  SYNC_TIMER["每 30 分钟自动刷新"] --> SYNC
  TOPICS["GitHub 社区项目"] --> SYNC

  SYNC --> ORIGIN["生产服务器<br/>原子版本切换"]
  ORIGIN --> CLOUDFLARE["Cloudflare"]
  CLOUDFLARE --> SITE["dshmk.com<br/>目录、已验证、排行榜、详情"]
  CLOUDFLARE --> API["api.dshmk.com<br/>公开目录 API"]
  API --> PLUGIN["DSH Web 插件<br/>/store、设置页与 Agent 工具"]

deploy-pages.yml 仅用于 GitHub Pages 预览或备用站点，不属于上述生产链路。正式网站和 API 由 sync-catalog.yml 构建并发布到生产服务器，再通过 Cloudflare 对外提供服务。

本地开发

需要 Node.js 22 或更高版本。

运行站点

npm ci
npm run dev

默认访问地址：http://localhost:4321/。

构建 DSH Web 插件

npm run build:plugin
npm pack ./packages/dsh-plugins-store

同步目录

npm run sync

同步脚本支持读取 GITHUB_TOKEN 或 GH_TOKEN。未提供 Token 时会受到 GitHub API 的较低请求限额约束。

检查与构建

npm test
npm run build

社区交流

欢迎加入 QQ 群或微信群，与社区成员交流 DSH 插件的使用、开发和生态动态。

QQ 群	微信群

许可证

项目代码采用 MIT License，可自由使用、复制、修改和分发，但必须在软件副本或主要部分中保留原版权声明与许可声明。软件按原样提供，不附带任何明示或暗示的担保。