中文版

eHunter

Provide scroll mode and book mode for a better reading experience.

Preview

Use on iPhone and iPad

eHunter can run on iPhone and iPad. See the guides below:

CN: Link EN: Link JP: Link

Implementation Overview

eHunter creates a new node on the original page and mounts Vue to that node. Content crawling/parsing is handled by fetch-based logic. The architecture isolates platform-specific behavior from reader UI logic, making migration to other comic platforms easier.

Install

Tampermonkey/userscript: openuserjs

Run

1. Run npm install, then npm run dev for development mode.
2. Run npm run build-prod to generate the userscript build.

Project Architecture

The current project is based on Vite + Vue 3 + TypeScript, with two main goals:

1. Inject a reader UI into target site pages.
2. Keep platform parsing logic and reader rendering logic layered for maintainability and extension.

Main directory responsibilities:

|-eHunter
  |-src
  |  |-main.ts               // Entry: initialize and mount app (currently test mounting by default)
  |  |-config.ts             // Runtime config
  |  |-platform/             // Platform layer (site detection, initialization, service factory)
  |     |-detector.ts        // Host/environment detection
  |     |-initializer.ts     // Platform initialization flow
  |     |-factory.ts         // Platform service creation
  |     |-eh/                // EH/EXH implementation
  |     |-nh/                // NH implementation
  |     |-base/              // Cross-platform base capabilities (request, queue, retry)
  |
  |-core
  |  |-App.vue               // Reader root component
  |  |-components/           // View layer: book mode, scroll mode, thumbnails, top bar, dialogs
  |  |-service/              // Business services (album data, download, retry policy)
  |  |-store/                // State management (app state, event bus, i18n, layout preference)
  |  |-model/                // Domain models (layout, book spread, thumb expand)
  |  |-utils/                // Utilities
  |  |-style/                // Global styles and theme variables
  |
  |-public/                  // Static assets
  |-dist/                    // Build output
  |-specs/                   // Feature/design specs
  |-misc/                    // Docs and supporting materials

Simplified call flow: main.ts -> platform initialization (detect site + create platform services) -> core reader mount -> component rendering/interaction -> service/store coordinate data loading and state updates.