插件市场与管理

dsh-plugin-market

0326/dsh-plugin-market · ★ 9

0326

DeepSeek Harness安全可信精选插件市场

许可证
MIT
收录
2026-08-16
维护状态
active
安装方式
github
查看 manifest 检查详情
manifest 状态
未核验到
manifest 路径
-
manifest 检查
2026-08-19
生命周期脚本
未发现

manifest 静态检查只记录声明与安装脚本,不代表兼容性或安全审查。

安装

dsh plugin --profile web add github:0326/dsh-plugin-market

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

项目说明

原始 README · 正文语言:中文 · 阅读英文 README

目录
  1. 为什么做这个项目?
  2. 核心价值
  3. Discover
  4. Verify
  5. Assess
  6. Install with confidence
  7. “Verified”代表什么?
  8. 为什么安装脚本特别重要?
  9. 功能特性(当前已实现)
  10. Registry MVP
  11. Trust Layer
  12. Discovery Experience
  13. 其他
  14. 工作原理
  15. Scanner 安全边界
  16. 技术架构
  17. 快速开始
  18. 环境要求
  19. 本地开发
  20. 常用脚本
  21. 部署(GitHub Actions)
  22. 参与贡献
  23. 免责声明
  24. 相关链接
  25. License

English | 简体中文

Discover. Verify. Install with confidence.

面向 DeepSeek Harness 生态的可信插件注册、发现与安装平台。

🌐 https://dsh-plugin.market

DSH Plugin Market

Runtime Frontend API Registry Deploy

本项目面向 DeepSeek Harness 生态。DeepSeek Harness 本身处于 Developer Preview,插件规范和兼容性规则可能快速变化,本项目的扫描规则会随之演进。


为什么做这个项目?

DeepSeek Harness 的核心理念是 Everything is a Plugin。官方目前通过 GitHub dsh-plugin Topic 帮助社区发现插件。

但 GitHub Topic 只能回答:

“哪些仓库声称自己与 DSH Plugin 有关?”

它不能回答用户安装前更重要的问题:

  • 这个仓库真的是符合规范的 DSH Plugin / Bundle 吗?
  • 它和我当前使用的 DSH / Cordis 兼容吗?
  • 它最近还在维护吗?
  • 安装时会不会执行 prepare / postinstall 等脚本?
  • 它有哪些需要关注的安全和供应链风险?
  • 我应该安装哪个版本 / commit,才能和市场扫描的代码保持一致?

DSH Plugin Market 不只是 GitHub Topic 的展示层,而是把候选仓库转换为结构化、可验证、可追溯的 Plugin Registry。

核心价值

Discover

持续从 GitHub 等公开来源发现 DSH 插件候选仓库,而不是依赖人工维护一份静态清单。

Verify

自动分析插件结构,包括:

  • package.json
  • dsh.bundle.patch
  • cordis.patch.yml
  • DSH / Cordis dependencies 与 peerDependencies
  • Plugin entry / exports
  • Node.js engine
  • Client / Web platform metadata

候选仓库通过明确的生命周期逐步升级:

Candidate
   ↓
Detected
   ↓
Format Verified
   ↓
Featured (curated)

Assess

为每个插件生成独立的 Trust Profile:

Format Verification
Compatibility
Security Scan
Maintenance
Publisher Trust

例如:

✓ Format Verified
✓ Compatible with current DSH baseline
⚠ prepare script detected
✓ Active maintenance
○ Publisher not verified

Install with confidence

扫描结果绑定具体 commit SHA。对于 GitHub 安装,优先推荐安装已扫描的 commit:

dsh plugin --profile web add github:owner/repo#<scanned_commit_sha>

这样用户实际安装的代码,可以和市场展示的扫描结果一一对应。

“Verified”代表什么?

这是本项目最重要的设计原则之一:

Format Verified ≠ Safe

Format Verified 只表示仓库符合当前 Scanner 所理解的 DSH Plugin / Bundle 结构规则。

安全相关信息独立展示,包括:

  • 安装脚本;
  • 依赖风险信号;
  • Shell / process execution;
  • 文件系统 / 网络访问特征;
  • 动态代码执行等静态风险信号;
  • 后续接入的公开漏洞数据源。

即使 Security Scan 没有发现高风险信号,也不代表第三方插件绝对安全。

为什么安装脚本特别重要?

DeepSeek Harness 支持直接从 GitHub 安装插件:

dsh plugin --profile web add github:owner/repo

对于需要构建的 Git dependency,作者可能通过 prepare 脚本生成产物。允许该脚本意味着第三方代码会在安装阶段执行。

因此 DSH Plugin Market 会把以下信息作为一等信息展示:

Install scripts
Build required
Scanned commit
Recommended pinned install

而不是只展示 Stars、Language 和 License。

功能特性(当前已实现)

Registry MVP

  • GitHub dsh-plugin topic 候选发现 + 增量同步(SHA 增量 + ETag + rate-limit / 429 退避)
  • D1 Registry(6 张核心表 + 版本化迁移)
  • Scanner v1 纯函数:manifest / bundle / compatibility / security / maintenance / semver
  • Cron 定时发现 + Cloudflare Queue 异步扫描(幂等键 repo_id + sha + scanner_version)
  • 公共 API + internal API(secret 守卫)
  • 首页 / Explore / Plugin Detail / Submit 页面

Trust Layer

  • DSH / Cordis 兼容性 baseline(从 npm registry 同步,每小时 cron,缺省回退内置 baseline)
  • 安装脚本检测 + 静态安全信号 + 维护信号
  • commit 绑定的扫描历史(Versions Tab + GET /api/plugins/:owner/:repo/scans)
  • pinned-commit 安装命令(InstallCard)

Discovery Experience

  • Capability taxonomy + Plugin Type 双维度(详情展示 + 筛选)
  • 高级筛选(capability / pluginType / compatibility / risk / verified / search / sort)
  • Featured(internal 置顶接口 + 首页区块)/ Trending / New & Verified / Popular
  • Registry 统计(GET /api/stats:candidates / verified / updated-this-week)
  • Publisher 页(GET /api/publishers/:owner + /publisher/:owner)
  • SEO / OpenGraph / Twitter meta
  • AI Search(可选增强,后置,不阻断主体)

其他

  • 中英文双语(i18n,浏览器语言自动检测)
  • 亮 / 暗主题切换(持久化,无首屏闪烁)
  • 插件预览图:GitHub Open Graph 集成 + 扫描期回填(README 首图兜底,绑定 commit)
  • 骨架屏(Skeleton)加载状态

工作原理

GitHub dsh-plugin Topic / Submit
              │
              ▼
        Candidate Discovery
              │
              ▼
       GitHub REST API
              │
      ┌───────┴────────┐
      │                │
      ▼                ▼
Repository         Commit / Tree
Metadata              Files
      │                │
      └───────┬────────┘
              ▼
        Static Scanner
              │
      ┌───────┼──────────┐
      ▼       ▼          ▼
   Format  Compatibility Security
      │       │          │
      └───────┼──────────┘
              ▼
        Trust Profile
              │
              ▼
      Cloudflare D1 Registry
              │
              ▼
        dsh-plugin.market

自动更新链路:

Cloudflare Cron(每小时)
      ↓
Discover new / changed repos
      ↓
Cloudflare Queue
      ↓
Static Scan
      ↓
D1

项目不会通过高频爬取 GitHub HTML 页面获取数据。

Scanner 安全边界

v1.0 坚持一个原则:

Never execute untrusted plugin code.

Scanner 只通过 API 读取和静态分析源码/配置,不会:

npm install third-party repo
pnpm install third-party repo
run prepare / postinstall
execute plugin entry
execute repository shell scripts

对于无法静态判断的内容,结果明确标记为 Unknown,而不是猜测为安全。

技术架构

Frontend        React 19 + TypeScript + Vite 7 + Tailwind CSS 4 + daisyUI 5
API             Hono 4
Runtime         Cloudflare Workers
Registry        Cloudflare D1(SQLite)
Scheduling      Cloudflare Cron Triggers(每小时)
Scan Jobs       Cloudflare Queues
Source          GitHub REST API
Test            Vitest(scanner / discovery / curation 单测)

详细架构、数据模型、扫描规则和分期方案请阅读:

技术方案 v1.0 · 开发计划 · 设计语言

快速开始

环境要求

  • Node.js 20+
  • 一个 Cloudflare 账户(本地开发 D1 不需要;部署需要)

本地开发

安装依赖:

npm install

配置本地 secret(仅浏览可省略;发现/扫描需要):

cp .dev.vars.example .dev.vars

创建并迁移本地 D1 数据库:

wrangler d1 migrations apply DB --local

本地启动:

npm run dev

常用脚本

npm run build        # tsc -b && vite build && 清理构建产物中的 secret
npm run check        # 类型检查 + 构建 + wrangler deploy --dry-run
npm run lint         # eslint
npm test             # vitest(scanner 纯函数单测)
npm run cf-typegen   # 修改绑定后重新生成 worker-configuration.d.ts
npm run deploy       # 部署到 Cloudflare Workers

GITHUB_TOKEN 与 INTERNAL_API_SECRET 为 Worker secret(本地可用 .dev.vars),禁止提交到仓库或暴露给前端。发现与扫描需要 GitHub Token;仅浏览注册表只需要 D1 数据库。

部署(GitHub Actions)

推送到 main 会通过 .github/workflows/deploy.yml 自动部署。该 workflow 会幂等地创建 Cloudflare Queue 与 D1 数据库、注入 database_id、应用 D1 迁移,并执行 wrangler deploy。

需要的 GitHub 仓库 secret:

  • CLOUDFLARE_API_TOKEN — 具有 Workers Scripts: Edit、D1: Edit、Workers Queues: Edit 权限的 Cloudflare API Token。
  • CLOUDFLARE_ACCOUNT_ID — 你的 Cloudflare 账户 ID。

Worker 运行时 secret(一次性配置,禁止提交):

wrangler secret put GITHUB_TOKEN        # worker 调用 GitHub API 所用的 GitHub PAT
wrangler secret put INTERNAL_API_SECRET # 守卫 /api/internal/* 接口

参与贡献

我们欢迎任何形式的贡献:报告问题、改进文档、完善扫描规则、新增前端功能等。

  1. Fork 本仓库并创建特性分支。
  2. 开发前请阅读 技术方案 与 开发计划,遵守 Scanner 安全边界。
  3. 提交前运行 npm run check 与 npm test。
  4. 提交 Pull Request。

核心原则:

GitHub = Source of Truth for Code

DSH Plugin Market
= Source of Truth for Plugin Metadata & Trust Signals

我们不托管插件、不复制第三方发布体系,也不试图替代 GitHub / npm。我们的职责是:

GitHub 告诉你哪些仓库声称自己是 DSH Plugin;DSH Plugin Market 告诉你它到底是什么、是否兼容,以及安装前你应该知道什么。

免责声明

DSH Plugin Market 是社区项目,不是 DeepSeek 官方产品,也不代表 DeepSeek 对第三方插件的审核或背书。

所有 Verification、Compatibility 和 Security 结果都基于特定 Scanner 版本、特定时间和特定 commit 的自动化分析,只作为安装决策的辅助信息,不能替代源码审查或其他安全措施。

相关链接

License

MIT

版权所有 © 2026 0326