Skip to content

Latest commit

 

History

History
36 lines (24 loc) · 2.11 KB

File metadata and controls

36 lines (24 loc) · 2.11 KB

Userscripts

A collection of production-grade browser userscripts (compatible with Violentmonkey/Tampermonkey) designed for high reliability and maintainability across modern SPAs.

Prerequisites

Requires Violentmonkey (or a compatible userscript manager):

Standard Project Structure

Every userscript resides in its own subdirectory:

  • RESEARCH_LOG.md: Rigorous documentation of the target site's DOM structure, robust selectors, and visual heuristics. Used to ensure longevity against UI updates.
  • [name].user.js: The source code following a strict component separation (CONFIG, STYLES, UTILITIES, LOGIC, ORCHESTRATION).
  • README.md: User guide containing configuration mapping and quick-install links.
  • tests/ (Optional): Testing infrastructure (e.g., Playwright) to verify logic against mock environments.

Directory Inventory

Directory Description
huggingface Hugging Face Heart & Date Filter: Filter models/datasets by last modified date, auto-unheart/heart toggle, non-blocking toasts.
perplexity Perplexity Enhancements: Keeps preferred model active, auto-approves action cards, and enables GitHub connector.
toppreise Toppreise.ch Suite: Best price highlighting, discount heatmap, negative text filter, hierarchical category exclusion, and price alarm automation.
fastlog-watcher Fastlog Watcher: Real-time event and log stream monitor (under development).

Shared Tooling

  • bump_version_precommit.py: Universal pre-commit hook script that automatically increments @version patch numbers for any staged *.user.js file and syncs adjacent README.md install links before committing.
  • venv/: A shared Python virtual environment utilized by individual projects for automated extraction (agent-assisted) and end-to-end validation.