Safe Haven 开发者徽章嵌入，badge.svg 一行代码加到 GitHub README

什么是开发者徽章

Safe Haven 为每个进了目录的应用提供了"Get it on Safe Haven Store"徽章图片——类似 Google Play 的 "GET IT ON Google Play" 徽章、F-Droid 的 "Get it on F-Droid" 徽章。开发者可以把它嵌入到：

• GitHub README / GitLab README
• 开发者的网站
• 博客文章
• 社交媒体（部分平台）

徽章既是"宣传"也是"入口"——用户点一下直接跳应用在 Safe Haven 的页面。

两种格式

徽章有 SVG 和 PNG 两种格式，分别在 在线商店域名/badge.svg 和 在线商店域名/badge.png。

SVG 格式推荐用于 README 和博客——矢量图，缩放不失真，加载快。PNG 用于 SVG 不支持的场景。

GitHub README 里怎么放

标准 Markdown 写法：方括号里写徽章名和 SVG 徽章图片地址，圆括号里写应用的公开页面地址（域名 + /app/ + 包名）。这样一行代码就能生成一个可点击的徽章按钮，点开跳到应用在 Safe Haven 的详情页。

如果你对 Markdown 嵌入图片链接还不熟悉，直接参考 Safe Haven 自己的 GitHub README 即可，里面有完整示例。

深链接（Deep Link）

v2.0.8 起，点开徽章链接会触发深链接逻辑：

• 手机上已安装 Safe Haven 客户端 → 自动唤起客户端 → 跳到对应包名的应用详情页
• 手机上未安装 Safe Haven 客户端 → 打开浏览器 → 落到 Web 前端的该应用页面

深链接的体验：用户不会在浏览器里绕一圈再跳回 Safe Haven，点击即直达目标页面。

徽章和其他商店徽章可以共存

一个应用同时在多个商店上架是常见的。README 里可以把多个商店的徽章并排放在一起（Google Play、F-Droid、Safe Haven 等）——Safe Haven 徽章不会和其他商店徽章冲突。每个商店的徽章格式可以在各自商店的帮助文档里找到，Safe Haven 徽章按上面的格式嵌入即可。

什么时候适合加徽章

Safe Haven 目前收录量还不大（早期项目），很多应用不会出现在 Safe Haven 目录里。加徽章的前提是：

1. 你的应用已经在 Safe Haven 目录里了
2. 你是应用的已验证开发者（通过了 .safehaven 文件握手）
3. 你愿意引导用户来 Safe Haven 下载

如果应用还没进 Safe Haven 目录，先注册应用条目、放 .safehaven 文件、提交 APK。扫描通过后应用进公开目录，徽章的链接才会有效（点击跳到真实页面而不是 404）。

徽章和应用删除

如果应用从 Safe Haven 目录移除了（Removed 状态），store.colourswift.com/app/{packageName} 页面可能变成 404 或跳转到首页。开发者需要手动更新 README 里的徽章链接——Safe Haven 不会主动通知。

徽章样式定制

Safe Haven 的徽章是固定样式，没有自定义选项（颜色、大小、语言）。和 Google Play、F-Droid 等大商店一样，徽章样式由商店统一规定，开发者只能用现成的。