❓ FAQ
22 个常见问题 · 6 个分类
📖 基础
DSH Radar 是什么？
给 DeepSeek Harness（DSH）生态的 npm 插件打 S/A/B/C/D 雷达评分的开源观察站。让选插件不再靠玄学——持续客观评测、兼容矩阵、配方库、横评，一站搞定。
和 DeepSeek 官方有关系吗？
没有。社区项目，由一线 DSH 开发者维护。已通过邮件告知 DeepSeek 团队，等回复。
评分算法靠谱吗？
完全基于公开数据（npm registry + GitHub API），无人工黑箱。完整算法在 scripts/lib/score.mjs，欢迎 PR 改进。
数据怎么保证真实？
每周一 GitHub Actions 自动跑 npm search + metadata + GitHub API，所有 JSON 都 git-tracked 可审计。可以手动跑 `node scripts/build-data.mjs` 重现。
⚙️ 技术
技术栈是什么？
抓取脚本：纯 Node 18+ 内置 fetch（零 npm 依赖）。静态站：Astro 5 + 纯 CSS（无 Tailwind）+ 手写 SVG 雷达图。部署：任意静态托管。
为什么不用数据库？
没必要。数据完全 git-tracked，所有页面都是 build-time 生成。零服务器、零 CDN 成本、SEO 满分。
搜索为什么是客户端的？
711 个插件摘要只有 ~260KB，inline 到 HTML 完全可以。客户端搜索零服务器成本、即时响应、可分享 URL（/search?q=...）。
为什么用 Web3Forms 而不是 Formspree？
Web3Forms 完全免费无限提交（Formspree 免费层 50/月）。配置也更简单：一个 access_key 就够。
🎯 使用
怎么选插件？
按 S/A/B/C/D 排序 → 看雷达图避开短板 → 查兼容矩阵 → 参考实战配方。完整教程见 /tutorials/getting-started。
升级 DSH 会让插件炸吗？
rc 版经常炸。升级前必查每个插件详情页的兼容矩阵，看 Changelog，看踩坑 Wiki。
怎么订阅每周变化？
RSS / Atom / JSON Feed（/feeds/ 下）任选；或邮件订阅（/subscribe 表单）。去中心化、零注册。
团队怎么用？
DSH Radar 完全免费，数据公开。任何人都可以直接使用，不存在付费墙。
🤝 贡献
怎么贡献配方？
编辑 data/recipes.json，加一条 JSON；标题+任务+插件+为什么+tip。提交 PR。详见 /tutorials/contribute-recipe。
怎么贡献踩坑？
编辑 data/potholes.json，加一条；包含 dsh_version/symptom/cause/fix/source。提交 PR。
怎么修正评分？
在 GitHub Issues 提：(1) 插件名 (2) 建议分数 (3) 理由。或直接 PR 改 scripts/lib/score.mjs 的公式。
插件作者怎么自荐？
不需要。GitHub owner / npm publisher 自动聚合成 /authors/[handle] 主页。看你的插件排名。
🔒 隐私
DSH Radar 上报我的访问数据吗？
不。默认零追踪。不接 GA / Plausible / Umami / Cloudflare Analytics。承诺：不卖数据、不接广告。
Web3Forms 会追踪我吗？
不会。只有你点提交时才会发请求到 web3forms.com（用来转邮件）。浏览页面完全本地。
GitHub Pages 会追踪我吗？
GitHub 自身可能会记录 IP（这是 Pages 的事），但 DSH Radar 代码本身不打点。
💰 商业
可以商用吗？
可以。MIT 协议，data/ 目录随便用。免费版已涵盖个人 / 小团队需求。
团队版定价？
DSH Radar 完全开源免费。如需企业定制（私有部署、白名单系统、数据报告），可通过 /subscribe 联系。
可以定制吗？
可以。整个仓库开源，自己改 / 二次分发都行。企业版可定制部署。
💬 还有问题？
在 GitHub Issues 提问，或发邮件到 hello@dsh.pub。