shelfry

自动化

• refresh：定时刷新已发布条目的星标 / 最后提交 / 最新版本
• enrich：给草稿补全中文介绍、标签、封面
• readme：给历史条目补抓 README
• discover：按 GitHub 搜索规则自动发现新项目，进草稿箱
• 没有 LLM Key 时退化为规则抽取；没有 GitHub Token 时退化为页面解析，仍然可用

技术栈

本地开发

# 1. 依赖
npm install

# 2. 环境变量
cp .env.example .env
# 修改 DATABASE_URI 指向你的 PostgreSQL，并填 PAYLOAD_SECRET

# 3. 建库（示例）
createdb shelfry

# 4. 启动（首次启动 Payload 会自动建表）
npm run dev

# 5. 写入示例数据（可选）
npm run seed

打开：

• 前台
• 后台

npm run seed 会创建管理员 [email protected] / admin123456，上线前务必改密码。

环境变量

后台怎么用

导入一个 GitHub 项目

1. 打开 /admin → 软件条目 → 新建
2. 只填「GitHub 地址」，例如 https://github.com/ollama/ollama
3. 直接点保存
4. 系统会抓取仓库信息，生成中文介绍、标签、功能清单、安装命令
5. 检查后把状态改成「已发布」

已有条目的信息过时了，勾选「重新抓取 GitHub」再保存即可。

自动发现

后台 → 站点设置 → 采集与 AI，添加搜索规则，例如：

topic:macos-app stars:>1500 pushed:>2025-01-01
topic:mcp-server stars:>500

开启「自动发布」后，超过星标阈值的项目会直接发布，其余进草稿箱。

定时任务

接口：GET /api/cron/sync?task=refresh|enrich|discover，请求头 x-cron-secret: $CRON_SECRET。

宝塔计划任务配置见 deploy/baota/crontab.txt。

目录结构

src/
  app/
    (site)/              前台页面（首页 / 平台 / 分类 / 详情 / 搜索 / 合集 / 投稿）
    (payload)/           Payload 后台与 REST/GraphQL 路由
    api/                 自定义接口（search / seed / submit / cron / health）
  collections/           Payload 集合定义
  globals/Settings.ts    站点配置
  components/            前台组件 + 后台品牌组件
  lib/                   GitHub 抓取、AI 富化、查询、评分
scripts/                 seed / sync 辅助脚本
deploy/baota/            宝塔部署脚本、Nginx、PM2、计划任务、图文手册
docs/screenshots/        截图

部署

详见 deploy/baota/README.md：从装 Node/PG 到上线、备份、更新的完整步骤。

内容与合规

• 元数据来自 GitHub 公开 API 与 README，中文介绍为改写摘要，不整篇搬运。
• 图标、截图、商标归原作者所有，页面标注来源并提供下架入口（/dmca）。
• 建议配置 GitHub Token，既提升配额也避免触发匿名限流。

License

代码可用于个人或商业项目。收录内容的版权归各项目作者所有。

内容由编辑整理，部分信息来自 GitHub 与项目官网，版权归原作者所有。发现错误？报告问题