OpenDock

OpenCode 插件目录与排行榜 —— 自动收录、自动排名、自动更新

opendock.net · 提交插件 · 报告问题

---

它解决什么问题

现有的 OpenCode 插件发现方式都是人工维护的 awesome-list：更新滞后、无法比较、 看不出哪些已经废弃。OpenDock 每天从 npm 与 GitHub 重新抓取全量数据， 给出多维度排名和明确的健康度提示——没有需要人工维护的列表。

• 1500+ 插件 —— 来源是 npm 上带 opencode-plugin 关键词的全部包
• 五个排行榜 —— 综合评分、星标、本周飙升、下载量、最新收录
• 健康度徽章 —— 已归档 / 半年未更新 / 缺少文档 / 无协议
• 一键安装配置 —— 每个详情页提供可复制的 opencode.json 片段
• 双语站点 —— 中英文界面与 SEO（hreflang、JSON-LD、RSS）
• 纯静态 —— 无后端、无数据库、无追踪

工作原理

npm 全量搜索 ──▶ GitHub 元数据 ──▶ 评分 & 健康度 ──▶ 静态数据集 ──▶ Astro 构建
 (keyword)      (GraphQL 批量)     (score.mjs)      plugins.json    3148 页
                                        ▲
                              每日 03:00 UTC 自动重跑

评分算法、分类规则、健康度判定全部是公开代码，见下方「目录结构」。

技术栈

框架	Astro 7（静态输出 + ClientRouter 软导航）
交互	React 19 island（仅 /plugins 与分类页的搜索筛选水合）
样式	Tailwind CSS v4 + shadcn/ui 设计令牌
搜索	Fuse.js —— 页内筛选，以及全站 ⌘K 命令面板（索引按需加载）
部署	Vercel
数据刷新	GitHub Actions 每日 cron

本地开发

pnpm install
pnpm dev

数据快照已提交在仓库里，克隆后即可直接起服务，无需任何 token。

重新抓取数据

pnpm data        # 全量抓取（约 10–20 分钟）
pnpm data:dev    # 只抓 120 个包，快速验证管线

抓取结果缓存在 .cache/（20 小时过期），中断后重跑只补缺失的部分； 强制全量重抓加 --fresh。

下载量是可选增强数据：单次请求最多 10 秒，月/周下载量各有 3 分钟预算。 超时、限流或部分响应会保留缓存或上次已提交快照里的下载量（不把失败记成新鲜的 0）； 首次发现且没有历史值的包才回退到 0。日志会汇总更新、缓存、保留及不可用数量。 --fresh 会绕过请求缓存，但在下载接口故障时仍保留已提交快照中的历史值。

pnpm test         # HTTP 超时、重试、下载回退与预算回归测试
pnpm check        # 类型检查
pnpm build        # 静态构建

抓取脚本需要 GitHub token 才能用 GraphQL API。本地自动读取 gh auth token， CI 里用 GITHUB_TOKEN。没装 gh 的话手动导出：

export GITHUB_TOKEN=ghp_xxx

目录结构

scripts/
  fetch-plugins.mjs      抓取管线入口
  lib/categories.mjs     分类规则（改这里调整分类）
  lib/score.mjs          评分算法与健康度判定
  lib/http.mjs           带重试的 fetch / GraphQL / 并发控制
data/
  curated.json           人工层：精选、黑名单、分类覆盖
  history.json           每日星标快照，用于计算增长（自动生成）
src/
  data/plugins.json      生成的数据集（自动生成）
  data/readme/*.md       各插件 README（自动生成，独立文件避免拖慢构建）
  lib/plugins.ts         类型定义 + 排序视图
  lib/readme.ts          README 渲染与消毒
  components/            UI 组件
  pages/                 路由

调整数据

想改什么	改哪里
分类规则	scripts/lib/categories.mjs
排名权重	scripts/lib/score.mjs
精选 / 拉黑 / 手动修正某个包	data/curated.json

{
  "featured": ["oh-my-opencode-slim"],    // 首页精选
  "include": ["some-package"],            // 强制收录（即使没有关键词）
  "blocklist": ["spam-package"],          // 永久排除
  "overrides": {                          // 覆盖自动推断的字段
    "some-package": { "category": "memory", "title": "更好的名字" }
  }
}

改完重跑 pnpm data。

部署

推到 GitHub 后在 Vercel 导入即可，框架会被自动识别为 Astro。 唯一需要改的是 astro.config.mjs 里的 site 字段——canonical URL、 sitemap 和 RSS 都由它派生。

数据刷新走 .github/workflows/refresh.yml：每天 03:00 UTC 重新抓取、 验证构建、提交快照，提交本身会触发 Vercel 重新部署。

已知偏差

• monorepo 星标继承 —— 发布自大型 monorepo 的包会继承整个仓库的星标，数字虚高
• 飙升榜需要历史 —— 增长指标靠对比每日快照，刚上线时是空的
• 只覆盖 npm —— 纯本地插件无法被自动发现

详见站内 /about 页。

协议

MIT

src/data/ 下的数据快照来自 npm 与 GitHub 的公开元数据， 各插件的 README 与代码版权归其各自作者所有。

---

_{OpenDock 是社区项目，与 OpenCode 官方无隶属关系。}