admin
41e9a500d0
Adds docs/CACHE_CONTRACT.md defining the two-tier replacement for
today's single CACHE_VERSION=3 constant:
cache_schema force rebuild on mismatch (today's semantics)
id_rules mark stale, allow lazy re-extract w/o rescan
id_rules_signature sha256 over canonical text of all extraction
rule sources (regexes, normalizers, part
detectors, FC2 handling, user-config rules)
as a belt-and-braces drift check
Documents:
- new cache.json header shape
- one-shot in-place migration for legacy `version: 3` users (no
forced rescan)
- behavior matrix for the three resulting states
- extension UX: fresh / stale-by-rules amber / schema-mismatch red
- new "Re-extract IDs" action that walks files[] in place and
never touches rclone
- what counts as a rules change vs. unrelated code change
- open questions deferred to step 10 (per-remote tracking,
custom-rules signature handling, host wiring)
No code changes — step 10 implements. This commit only locks the
contract so step 10 has a single source of truth for both the
Python and extension sides.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
rclone-jav
Brave extension that extracts JAV IDs from the active page and checks them against your local rc-jav library via a native-messaging Python host.
Setup: see
INSTALL.md. This file documents how it works once installed.
Architecture
Brave tab title (e.g. "MILK-257")
─► content/background script extracts ID
─► chrome.runtime.connectNative("com.rcjav.host")
─► rcjav-host.bat → rcjav-host.py
─► python rc-jav.py --search MILK-257 --basic --no-color
─► result back through the port
─► popup / notification / badge
Long-lived port: Brave keeps the host process alive while the connection is open, so subsequent lookups don't pay Python startup cost.
Triggers (all available, enable any combination in Options)
| Trigger | Behavior |
|---|---|
| Auto-check every page load | Fires chrome.tabs.onUpdated. Badge shows hit count or ? when no JAV ID detected. Noisy. |
| Auto-check on known JAV sites | Same as above but gated by host patterns (e.g. *.javdb.com). |
| Toolbar icon popup | Click the icon → popup can run a check on the active tab. The Scan Behavior toggle gates popup auto-check. |
| Right-click context menu | "rclone-jav: check this page". Shows a desktop notification. |
| Keyboard shortcut (Alt+J) | Rebind at brave://extensions/shortcuts. |
Enable them all to compare — they don't conflict.
ID extraction
Uses site adapters, URL text, and the page title plus ID normalizers. Common title forms include:
MILK-257→MILK-257MILK257→MILK-257Some site - MILK-257 [4K]→MILK-257
Search behavior
By default the extension passes --quick to rc-jav (single-ID live rclone lsjson --include, ~1–2s, fresh data, no cache). Uncheck Use --quick mode in options to use the cache (faster on warm cache, may be stale).
Files
manifest.json MV3 manifest
background.js service worker, native-messaging port, triggers
content.js page extraction, element picker, and in-page overlays
popup.html / .css / .js click-the-icon UI
options.html / .js trigger toggles + known-site patterns
icons/ extension icons
host/
rcjav-host.py native messaging host (length-prefixed JSON)
rcjav-host.bat shim so the manifest path is stable
install-host.ps1 writes the manifest into Brave's NM dir
register-host.bat prompts for ID, calls install-host.ps1
com.rcjav.host.json generated by install-host.ps1 (UTF-8 no BOM)
logs/ host logs and delete audit log
state/ scan progress state
docs/
INSTALL.md setup guide
README.md this file
EXTENSION_ID.md extension ID stability notes
Security
- The host manifest's
allowed_originsis pinned to your extension ID. Only that extension can connect. - No network ports opened.
- Host only spawns
python rc-jav.py …; no shell, no arbitrary code execution.
Troubleshooting
Quick reference — full troubleshooting in INSTALL.md.
- Badge
?→ no JAV ID in title. - Badge
!→ host error. Readhost\logs\rcjav-host-stderr.log. - "host unreachable" → re-run
install-host.ps1, fully restart Brave.