插件港 jclzz/dsh-harbor

插件港 DSH Harbor · DeepSeek Harness 社区插件收录站

社区维护的 DeepSeek Harness（DSH）插件目录：浏览、搜索、按分类筛选、一键复制安装命令。视觉对齐官网（纯黑底、238px 大网格、唯一强调色 #4D6BFE）。

- 不人工审核：提交页粘贴仓库地址 → 实时读 GitHub 元数据 → 立即上架。
- 来源可查：每条都链回 GitHub 公开仓库，展示 Star / 许可证 / 语言 / 最近提交。
- 数据在仓库里：唯一真源是 data/plugins.json，git diff 可读可回滚，不依赖数据库。

快速开始

npm install
npm run dev # http://localhost:3000

生产：

npm run build && npm start

页面与接口

| 路径 | 说明 |
| / | 落地页：Hero + 安装卡、分类 chips、本周精选、最新上架、提交指引、贡献者墙 |
| /plugins | 插件库。?q= 搜索、?category= 分类、?sort=stars\|updated\|added\|name 排序、?view=list 列表视图、?page= 分页（全部走 URL，可分享可被收录） |
| /plugins// | 插件详情：安装命令、README 渲染、仓库信息、同分类推荐 |
| /submit | 提交表单，粘贴仓库地址即时回显 |
| /about | 收录规范、数据来源、免责声明 |
| /api/plugins | 公开只读 JSON，支持 ?category= ?q= ?limit=（CORS 开放） |
| /api/repo?full=owner/repo | 提交页的仓库预检 |
| POST /api/submit | 提交入库 |
| /badge//.svg | README 徽章，Star 数随目录同步刷新 |
| /rss.xml · /sitemap.xml · /robots.txt | 订阅与 SEO |

目录数据

data/plugins.json 是唯一真源。字段分两类：

- 机器字段（stars / forks / license / language / pushedAt / openIssues / version）由 npm run sync 覆盖写入。
- 编辑字段（name / nameZh / description / category / tags / featured / author / addedAt / submittedBy）只由人或提交表单提供，sync 永不覆盖。

所以同步脚本可以放心反复运行。

同步命令

npm run sync:dry # 只打印，不写盘
npm run sync # 刷新已有条目 + 按 scripts/curated.ts 补全
npm run sync:discover # 额外扫 GitHub dsh-plugin 话题，自动收录新仓库
npm run sync:prune # 顺带移除已归档 / 不存在的仓库

鉴权：优先用 GITHUB_TOKEN 环境变量；没设的话回落到本机 gh auth（GraphQL，每小时 5000 点，145 个仓库约 4 个请求）。不要在无鉴权的情况下跑 --discover，搜索接口未认证只有 10 次/分钟。

精选清单

scripts/curated.ts 是人工整理的收录清单：仓库地址 + 中文短名 + 中文描述 + 分类 + 精选排序。
新增一批插件时改这个文件，再跑 npm run sync。

提交是怎么落库的

1. 前端把仓库地址发到 POST /api/submit。
2. 服务端用 lib/repo-input.ts 把各种形态的输入（owner/repo、完整 URL、github:owner/repo、 git@github.com:owner/repo.git）归一成 owner/repo。
3. lib/github.ts#checkRepo 实时读 GitHub：仓库是否存在、是否归档、Star、许可证、语言、topics。
4. 校验通过后由 lib/catalog.ts#mutateCatalog 原子写入（临时文件 + rename，串行队列防并发覆盖）。
5. revalidatePath() 让首页 / 插件库 / 详情页立刻刷新。

防滥用：同 IP 每小时 5 次提交、表单蜜罐字段、描述长度上限。
重复提交同一个仓库会返回 409 并给出已有条目链接。

部署

需要可写文件系统

提交会把新条目写进 data/plugins.json，所以要么给容器挂一个卷，要么改用「提交开 PR」的变体。
HARBOR_DATA_DIR 可以指定数据目录（默认 ./data）。

docker build -t dsh-harbor .
docker run -d --name dsh-harbor -p 3000:3000 \
-v "$PWD/data:/app/data" \
-e NEXT_PUBLIC_SITE_URL=https://your-domain \
-e GITHUB_TOKEN=ghp_xxx \
dsh-harbor

环境变量

| 变量 | 默认 | 作用 |
| NEXT_PUBLIC_SITE_URL | http://localhost:3000 | 站点绝对地址，用于 canonical / OG / sitemap / 徽章 Markdown |
| GITHUB_TOKEN | — | 提交预检与同步脚本用，避免匿名限流 |
| HARBOR_DATA_DIR | ./data | 目录数据目录 |
| HARBOR_SUBMIT_PER_HOUR | 8 | 同一 IP 每小时最多提交几次 |
| HARBOR_REQUIRE_LICENSE | true | 是否强制要求仓库声明开源许可证 |
上线步骤见 DEPLOY.md（docker compose up -d --build 一把梭，Caddy 自动签证书）。

定时同步

用 cron 每天刷一次 Star 与更新时间：

17 4 * * * cd /srv/dsh-harbor && GITHUB_TOKEN=xxx npm run sync >> /var/log/dsh-harbor-sync.log 2>&1

同步后重启或等待 ISR 过期即可；页面有 30s–10min 的分级 revalidate。

项目结构

app/
layout.tsx 全局壳：字体、导航、页脚、网格背景 page.tsx 落地页 plugins/page.tsx 插件库（搜索 / 分类 / 排序 / 分页 / 视图切换）
plugins/[owner]/[repo]/ 插件详情（README 渲染 + JSON-LD）
submit/ 提交页 about/ 收录规范
api/{plugins,repo,submit}/
badge/[[...slug]]/ README 徽章 SVG
rss.xml/ sitemap.ts robots.ts not-found.tsx
components/ 导航、页脚、卡片、行、复制按钮、表单、分页…
lib/
types.ts 数据模型 categories.ts 10 个分类 + 关键词推断 catalog.ts 目录读写、查询、统计、贡献者（node:fs，仅服务端） format.ts 纯展示辅助（客户端可引用） sort.ts 排序常量 github.ts GitHub 只读访问（checkRepo / fetchReadme） markdown.ts README → 安全 HTML repo-input.ts 仓库地址解析 site.ts 站点常量 scripts/ curated.ts 人工精选清单 sync.ts 同步脚本 data/plugins.json 目录真源 design/ 设计稿与原型（不属于构建产物） research/ 同类站点架构调研

README 渲染的安全策略

README 是第三方内容，lib/markdown.ts 的流程是：marked 解析 → sanitize-html 白名单过滤（脚本 / 样式 / 事件属性 / iframe / 表单全部丢弃，链接协议限 http(s)/mailto）→ 把仓库内相对路径改写成 GitHub 或 raw.githubusercontent 的绝对地址。因此不需要额外跑浏览器沙箱。

许可证

本仓库自身的代码与数据整理成果采用 MIT 许可证。

data/plugins.json 里收录的各个插件不在此列 —— 它们的著作权与许可证归各自作者所有，以每条记录中 repoUrl 指向的仓库所声明的许可证为准。本站只做索引，不托管任何插件代码。

免责声明

非官方社区项目，与 DeepSeek 官方无隶属关系。插件著作权归各作者；本站在本机运行第三方代码这件事上不做安全背书，安装前请自行审阅源码。