DeepLink 一键加仓库——HTML 里一个链接搞定订阅
是什么
DeepLink(深链接)是一种让 App 直接响应特定 URL 协议的机制。JsHook 注册了 jshook:// 协议,你可以在网页里加:
<a href="jshook://store?url=https://your-cdn.com/repo.json">点此订阅我的脚本仓库</a>
用户在手机浏览器里点这个链接:
- 浏览器识别到
jshook://协议 - 打开 JsHook 应用
- JsHook 解析 URL,弹出「添加仓库订阅」确认框
- 用户确认 → 自动订阅成功
实际效果
这是你在 GitHub 仓库 README、Telegram 群、个人博客里推广脚本仓库的最高效方式——用户不需要手动打开 JsHook、不需要复制粘贴 JSON URL、不需要在菜单里找添加仓库的入口。
URL 格式
jshook://store?url=<你的仓库JSON地址>
url参数指向自建仓库的 JSON(最简格式或 full format 都行)- URL 必须是公开可访问的(手机网络能加载)
- 如果 JSON URL 本身包含特殊字符(如
?、&),需要 URL 编码
示例
<!-- 最简格式 -->
<a href="jshook://store?url=https://your-cdn.com/list.json">订阅脚本仓库</a>
<!-- full format -->
<a href="jshook://store?url=https://your-cdn.com/repo.json">订阅完整仓库(含推送)</a>
URL 编码问题
如果 JSON URL 里包含查询参数:
https://your-cdn.com/api/repo?token=abc&version=2
需要对整个 URL 做 URL 编码:
jshook://store?url=https%3A%2F%2Fyour-cdn.com%2Fapi%2Frepo%3Ftoken%3Dabc%26version%3D2
托管仓库的推荐方式
GitHub + jsDelivr 是最简单的方案:
- 建一个 GitHub 仓库放你的仓库 JSON
- JSON 文件推到 main 分支
- 用 jsDelivr CDN URL 作为
url参数:
<a href="jshook://store?url=https://cdn.jsdelivr.net/gh/yourname/your-repo@main/repo.json">订阅</a>
jsDelivr 自动缓存,全球加速,GitHub 改版也不怕。
非 JsHook 用户点击怎么办
如果用户手机上没装 JsHook:
- 浏览器会显示「没有 App 能打开此链接」或类似提示
- 或者直接打开 Google Play / 夸克浏览器搜索
me.jsonet.jshook
建议在 DeepLink 旁边加一段说明文字:
<a href="jshook://store?url=...">点此订阅(需先安装 JsHook)</a>
进阶:一键订阅 + Markdown 文档
结合 full format 仓库的 markdown 字段和 push 通知,用户订阅后在 JsHook 里会看到完整的仓库介绍文档和更新日志——可以说是「一键获客」的完整链路。