README.md

July 8, 2026 · View on GitHub

小程序雷达

AI 驱动的小程序生态选型与风险评估工具，把微信小程序开发资源转化为可筛选、可评估、可对比的技术雷达。

本 README 由 data/resources.yaml 自动生成。请不要手工编辑资源列表。

当前能力

  • Radar：按推荐状态、风险等级、资源类型、分类和适用场景浏览小程序生态资源。
  • Quick Search：全站快速搜索资源和跳转常用命令。
  • Export：按当前筛选导出资源 JSON 或 CSV，Admin 可上传 Blob 快照。
  • Compare：对比 Taro、uni-app、原生小程序等核心方案。
  • Advisor：配置模型后调用 OpenAI-compatible API 生成选型建议；未配置或校验失败时自动回退规则结果。
  • Weekly：生成生态周报快照，后续由 Vercel Cron 定时更新。
  • Doctor：扫描小程序项目结构、框架依赖和配置风险，输出体检报告，可选上传 Blob 快照。
  • Admin：查看部署健康、集成配置、资源规模和关键运维端点。

数据概览

当前数据集中包含 236 个小程序生态资源。README 不再展开完整 awesome 列表，完整资源请通过 Radar 页面、API 或导出能力查看。

分类资源数
官方文档6
工具43
插件13
组件64
后端SDK组件2
Demo106

核心样例

完整数据入口：

  • Radar 页面：/radar
  • 资源 API：GET /api/resources
  • 详情 API：GET /api/resources/[id]
  • 导出 API：GET /api/export/resources?format=json|csv
  • 静态 JSON：public/api/resources.json

本地运行

npm install
npm run dev

生产构建：

npm run build

常用任务：

npm run check
npm run integrations:verify
npm run integrations-verify:test
npm run db:import:test
npm run db:verify
npm run db-verify:test
npm run enrich -- -- --limit=30 --no-persist
npm run enrich:test
npm run resources-api:test
npm run radar-url:test
npm run export-api:test
npm run compare-api:test
npm run alternatives:test
npm run score
npm run score-trace:test
npm run operation-log:test
npm run task-lock:test
npm run site-url:test
npm run ai:summarize -- -- --no-persist
npm run production-readiness:test
npm run ai-output:test
npm run security:test
npm run secret-exposure:test
npm run admin-api:test
npm run cron-routes:test
npx miniprogram-radar ai-summarize --limit=20 --dry-run --json
npx miniprogram-radar enrich --limit=10 --dry-run
npx miniprogram-radar health --out=health.md
npx miniprogram-radar import --dry-run --json
npx miniprogram-radar resources --type=framework --status=adopt --format=csv --out=resources.csv
npx miniprogram-radar resources --format=json --upload --out=resources.json
npx miniprogram-radar compare --ids=github-com-nervjstaro,github-com-dcloudiouni-app --out=compare.md
npx miniprogram-radar score --out=score.md
npm run weekly -- -- --no-persist
npx miniprogram-radar weekly --out=weekly.md
npm run weekly:test
npx miniprogram-radar advisor "React 团队做电商小程序，应该选 Taro 还是原生？"
npx miniprogram-radar advisor "React 团队做电商小程序，应该选 Taro 还是原生？" --prompt --out=advisor-prompt.json
npm run advisor:test
npm run doctor -- ./my-weapp
npx miniprogram-radar doctor ./my-weapp
npm run doctor -- ./my-weapp --upload
npm run doctor:test
npm run cli:test
npm run deploy:check
npm run mvp:check
npx miniprogram-radar verify --json
npm run vercel:preflight -- https://your-project.vercel.app
npm run production:bootstrap -- https://your-project.vercel.app
npm run vercel-preflight:test
npm run production-bootstrap:test
npm run deployment:verify -- https://your-project.vercel.app
npm run deployment-verify:test
npm run mvp-check:test
npm run smoke

部署环境变量

参考 .env.example。

  • DATABASE_URL：可选，配置后资源导入、采集信号、Advisor 会话和周报会写入 Postgres。
  • SITE_URL / NEXT_PUBLIC_SITE_URL：可选，配置生产站点根地址，用于生成 canonical sitemap 和 robots 地址。
  • CRON_SECRET：建议配置，用于保护 /api/cron/*。
  • ADMIN_TOKEN：建议配置，用于保护 /admin 和 /api/admin/*。
  • GITHUB_TOKEN：可选，提高 GitHub 采集额度。
  • OPENAI_API_KEY：可选，用于真实 AI Advisor；未配置或模型输出校验失败时使用规则建议。可使用 OpenRouter API key。
  • OPENAI_API_URL：可选，OpenAI-compatible endpoint，默认 https://api.openai.com/v1；使用 OpenRouter 时配置为 https://openrouter.ai/api/v1。
  • OPENAI_MODEL：可选，主模型，默认 nvidia/nemotron-3-ultra-550b-a55b:free。
  • OPENAI_FALLBACK_MODEL：可选，备用模型，默认 qwen/qwen3-next-80b-a3b-instruct:free。
  • BLOB_READ_WRITE_TOKEN：可选，用于上传周报快照、资源导出快照和 Doctor 报告。
  • UPSTASH_REDIS_REST_URL、UPSTASH_REDIS_REST_TOKEN 或 Vercel Marketplace 自动注入的 KV_REST_API_URL、KV_REST_API_TOKEN：可选，配置后用于 Advisor 缓存和分布式限流；未配置时使用内存限流兜底。
  • OPERATION_LOG_RETENTION_DAYS：可选，运行日志保留天数，默认 30 天。
  • VERCEL_TOKEN、VERCEL_PROJECT_ID、VERCEL_ORG_ID：可选，用于非交互 Vercel CLI 部署或 preflight；通过 Vercel GitHub 集成部署时可以不配置。

部署检查

  • 健康检查：GET /api/health
  • 数据库验证：EXPECT_DATABASE=1 npm run db:verify
  • GitHub/Blob/Redis 验证：EXPECT_GITHUB=1 EXPECT_BLOB=1 EXPECT_UPSTASH_REDIS=1 npm run integrations:verify
  • 运维控制台：GET /admin
  • 生产就绪 API：GET /api/admin/readiness，需 ADMIN_TOKEN。
  • 项目体检：GET /doctor、POST /api/doctor
  • 资源维护 API：PATCH /api/admin/resources/[id]
  • 资源导出 API：GET /api/export/resources?format=json|csv
  • 周报 API：GET /api/weekly
  • 周报 RSS：GET /weekly.xml
  • 站点地图：GET /sitemap.xml
  • Robots：GET /robots.txt
  • AI 摘要 API：GET /api/ai-summaries
  • 密钥暴露扫描：npm run secret-exposure:test
  • Vercel 部署前置检查：npm run vercel:preflight -- <production-url>；严格模式：EXPECT_VERCEL_DEPLOY=1 npm run vercel:preflight -- <production-url>
  • MVP 收口检查：npm run mvp:check；严格上线模式：EXPECT_MVP=1 EXPECT_SITE_URL=1 EXPECT_OPENAI=1 npm run mvp:check -- <production-url>
  • 生产初始化计划：npm run production:bootstrap -- <production-url>；执行迁移、导入和线上验证时追加 execute，最终收口可追加 expect-vercel-deploy、expect-mvp 和 expect-site-url，计划阶段会列出缺失生产变量；执行模式按顺序运行，任一步失败会跳过后续步骤。配置 CRON_SECRET 后会自动 dry-run 验证 Cron 授权链路；配置 ADMIN_TOKEN 后会自动验证 Admin readiness 授权读取。
  • Vercel 生产验证 workflow：.github/workflows/verify-vercel.yml，可手动输入 Production URL，或在 Vercel Production deployment_status 成功后自动执行；可用 GitHub Variables EXPECT_VERCEL_DEPLOY、EXPECT_MVP、EXPECT_DATABASE、EXPECT_BLOB、EXPECT_UPSTASH_REDIS、EXPECT_SITE_URL、EXPECT_OPENAI 控制严格验收，并用 SITE_URL/NEXT_PUBLIC_SITE_URL、OPENAI_API_URL、OPENAI_MODEL、OPENAI_FALLBACK_MODEL、VERCEL_PROJECT_ID、VERCEL_ORG_ID 配置生产项目上下文；VERCEL_TOKEN、ADMIN_TOKEN、CRON_SECRET、RADAR_GITHUB_TOKEN、OPENAI_API_KEY、BLOB_READ_WRITE_TOKEN 和 Redis REST 变量（UPSTASH_REDIS_REST_URL/UPSTASH_REDIS_REST_TOKEN 或 KV_REST_API_URL/KV_REST_API_TOKEN）放 GitHub Secrets。
  • 采集 Cron：GET /api/cron/enrich
  • 周报 Cron：GET /api/cron/weekly
  • 生产验证：VERIFY_CRON_SECRET=<CRON_SECRET> VERIFY_ADMIN_TOKEN=<ADMIN_TOKEN> npm run deployment:verify -- <production-url> 可 dry-run 验证授权周报 Cron，并验证 Admin readiness 授权读取。

QQ交流群

数据维护