javranking-extension README

The project's README from github.com/aizhimou/javranking-extension. As one markdown file: README.md.

JavRanking 浏览器扩展

English · 繁體中文

JavRanking 浏览器扩展会在你主动点击浏览器工具栏图标后,识别当前页面中的影片番号,并展示可对应的 JavRanking 榜单资料。

screenshot

安装 Chrome 或 Edge 版本

  1. 从 GitHub Releases 下载 Chromium ZIP。
  2. 将 ZIP 解压到会保留的本地文件夹。
  3. 打开 chrome://extensions 或 edge://extensions。
  4. 开启 Developer mode,选择 Load unpacked,再选择包含 manifest.json 的解压文件夹。

Unpacked extension 的更新需要手动完成:下载并解压新版后,在扩展卡片选择 Reload,或加载新的文件夹。当 GitHub 有更高版本时,扩展顶部会显示更新提醒。

Firefox 可用于 temporary development load;持久安装仍需要 Mozilla 签名的 XPI,目前尚未提供。

从源代码验证与构建

需要 Node.js 20.19 或更高版本。

npm ci
npm run compile
npm test
npm run build
npm run zip

production ZIP 会输出到 .output/。构建产物不会提交到 Git;你可以检查 tag 的源代码并自行构建,再用 Release 中的 SHA256SUMS.txt 比对文件校验和。

隐私

扩展只会在用户主动触发后读取当前顶层页面。它不会传送或保存页面 URL、页面文字、DOM 内容、番号候选或浏览活动。

它会读取 JavRanking 已发布的静态搜索索引来查找匹配项;每次打开扩展 UI 时,还会向 GitHub 公开 API 读取最新 Release 的版本号。两者都不包含任何页面或用户数据。

完整的产品、static data contract、隐私、兼容性与发布规范见 extension design document。

许可证

MIT

javranking-extension (aizhimou/javranking-extension)

Searching Database…

What is this?A browser extension that reads the JAV video code on the page you're currently viewing — only after you click its toolbar icon — and shows matching cover art and JavRanking leaderboard info for that title.
Does it work in Firefox, or only Chrome and Edge?It's built and distributed for Chromium browsers (Chrome, Edge) via a downloadable ZIP. Firefox only supports loading it temporarily for development; a persistent install would need a Mozilla-signed XPI, which isn't available yet.
Do updates happen automatically?No — since it's loaded as an unpacked extension, you have to manually download the new version, unzip it, and click Reload on the extension card (or load the new folder). The extension does show a banner in its UI when a newer GitHub release exists.
Does it read or send my browsing data?It only reads the current top-level page content, and only when you actively click to trigger it. It does not transmit or store the page URL, page text, DOM content, candidate codes, or your browsing activity.
How does it actually match a code to ranking data?It reads a static search index that JavRanking publishes, and it also checks GitHub's public API for the latest release version each time you open the extension UI — neither request includes any page or user data.
Can I verify a downloaded build matches the public source?Yes — you can check out the release tag, build it yourself, and compare the checksum of your output against the SHA256SUMS.txt file included in each GitHub Release.
Creator
aizhimou
Size
0.9 MB
Stars
907
Age
1mo
Commits · 90 Days