Fushi README

项目的 README,来自 github.com/hajisensai/Fushi。合并为一个 markdown 文件:README.md。

Fushi

Fushi logo

Platform License Flutter

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português | Русский | Tiếng Việt | ภาษาไทย | Bahasa Indonesia | Italiano | Nederlands | Türkçe | العربية

fushi.moe

Download Latest Join our Discord Sponsor on GitHub Support on Ko-fi

Platform Support

Platform Status Notes
Android ✅ Android 7.0 (API 24) or later
Windows ✅ Galgame text and voice hooking is Windows-only
macOS ✅ Apple Silicon only; Intel Macs are not supported
iOS ✅ (TestFlight) No discovery, online sources, or download center (App Store guidelines)
Linux 🔧 Build from source No prebuilt release yet; the EPUB reader needs WPE WebKit
Fushi Server 🧪 Beta (fushi-server) Headless host for Linux / Windows / macOS with a web UI — see packages/fushi_server

Design system — every platform defaults to Material 3 Expressive; a Cupertino (Apple-style) design system can be selected in Settings › Appearance › Design system; with Cupertino, the window background uses Mica on Windows 11 and vibrancy on macOS (unless the system's reduce-transparency or high-contrast setting is on).

The languages available for dictionary lookup are determined by the imported dictionaries and Yomitan transformation tables, independently of the interface language. iOS updates arrive through TestFlight a few days later than on the other platforms.

Interface Languages (17)

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil) · Русский · Tiếng Việt · ภาษาไทย · Bahasa Indonesia · Italiano · Nederlands · Türkçe · العربية

Installation

Download the latest release from the Fushi website — Android APK, Windows installer, and macOS builds (Apple Silicon only; Intel Macs are not supported) are available; iOS is installed through TestFlight. Linux has no prebuilt app release yet; build it from source. The headless Fushi Server is released separately on hajisensai/fushi-server.

Requires Android 7.0 (API 24) or higher.

Building

One-command prep (flutter pub get + apply patches), then build:

# From the repository root
bash tool/bootstrap.sh          # Windows PowerShell: .\tool\bootstrap.ps1

cd fushi
# Android
flutter build apk --release --target-platform android-arm64 --split-per-abi
# Desktop
flutter build windows --release
flutter build macos --release
flutter build linux --release
# iOS
flutter build ipa --release

# Headless server (from packages/fushi_server; use `dart build cli`, not `dart compile exe`)
dart build cli

tool/bootstrap.sh / tool/bootstrap.ps1 collapse flutter pub get and ci/apply-patches.sh into a single command. This project is locked to Flutter 3.47.6 (Dart SDK >=3.8.0 <4.0.0); earlier Flutter versions cannot build it because Material and Cupertino are consumed as the material_ui / cupertino_ui packages. Some upstream dependencies are vendored under third_party/ or patched by ci/apply-patches.sh — see docs/agent/build.md for details, including the Linux desktop build dependencies.

Tech Stack
Layer Technology
Framework Flutter 3.47.6 (Dart SDK >=3.8.0 <4.0.0), Riverpod
Platforms Android / Windows / macOS / iOS / Linux, plus a headless server
UI material_ui (Material 3 Expressive) / cupertino_ui (Cupertino)
Reader WebView paging engine (derived from the Hoshi Reader family)
Video media_kit (libmpv core) + libplacebo
Storage Drift (SQLite, WAL) + fushidicts (C++ FFI dictionary engine)
NLP Yomitan transformation tables (multilingual lemmatization) + kana_kit (kana conversion); tokenization via fushidicts FFI
On-device AI ONNX Runtime for speech recognition (subtitle generation) and manga OCR; algorithms live in fushi-subtitles
Downloads libtorrent 2.x via a C-ABI FFI bridge (external qBittorrent as fallback)
Sync Cloud backends + Fushi Interconnect (LAN, remote addresses, and an iroh P2P tunnel)
Shared engine fushi_engine — pure-Dart core shared by the app and Fushi Server
Card Creation AnkiDroid API + AnkiConnect
i18n Slang (17 languages)
Project Structure
Fushi/                      # Repository root (Melos workspace: fushi_workspace)
├── fushi/                  # Flutter app main directory
│   ├── lib/
│   │   ├── i18n/            # Internationalization (17 languages, Slang)
│   │   ├── src/
│   │   │   ├── pages/       # Pages (library pages, reader, video player, settings, etc.)
│   │   │   ├── reader/      # Reader WebView JS/CSS scripts
│   │   │   ├── media/       # Books, manga, video, audiobooks, online sources
│   │   │   ├── lookup/      # Dictionary lookup popups and overlays
│   │   │   ├── mining/      # Card creation (incl. galgame mining)
│   │   │   ├── sync/        # Cloud sync, Interconnect, media servers
│   │   │   └── models/      # Data models and state management (AppModel)
│   │   └── main.dart
│   └── android/             # Android project
├── packages/                # Dart packages
│   ├── fushi_core/          #   Database schema, preferences
│   ├── fushi_engine/        #   Pure-Dart engine shared with the server
│   ├── fushi_server/        #   Headless server CLI + web UI
│   ├── fushi_cli/           #   Desktop command-line client
│   ├── fushi_dictionary/    #   Dictionary engine bindings and importers
│   ├── fushi_anki/ · fushi_audio/ · fushi_platform/ · fushi_srs/
│   ├── fushi_torrent/ · fushi_p2p/   # libtorrent / iroh FFI bindings
│   └── …                    #   Vendored forks (inappwebview Windows/Linux, gamepads)
├── native/                  # Native sources: fushidicts, fushi_torrent, fushi_p2p (Rust), galgame_hook, …
├── services/                # Log collector and leaderboard backends (deployed separately)
├── tools/browser-extension/ # Browser lookup extension
├── third_party/             # Vendored patched packages (dependency_overrides)
├── ci/                      # Build patches and CI scripts
├── tool/                    # bootstrap / setup_worktree / bug tracker scripts
└── docs/                    # Development documentation (incl. docs/agent/ operations manual)

Video import supports grouping by work or folder. See the video workflow and MAL/TMDB metadata with AniDB file hashing for matching and background tasks.

Optional online service setup explains bundled application identities, personal credentials, and the dismissible video setup reminder.

Privacy & Data

Fushi stores imported books, dictionaries, fonts, audiobook data, videos, reading progress, highlights, statistics, and settings in the app's local storage.

Development Activity

Development Activity

Day-to-day work lands on develop; main only receives release merges. The chart is displayed here on main but is generated from develop, so it reflects actual development rather than merge traffic.

The three lanes are the update channels the app itself offers, and each is scaled to its own peak — debug builds outnumber stable releases by two orders of magnitude, so a shared scale would flatten the other two lanes to nothing.

Lane What it counts How you get it
Debug (rolling) Successful push builds of release.yml Rolling prerelease, republished on every push
Beta v<version>-beta.<seq> prereleases Manually dispatched test build
Stable v<version> releases Latest release

The chart above is generated inside this repository (no third-party service) and refreshed daily by the Update Dev Activity Chart workflow.

Star History

GitHub stars

Star History

The chart above is generated inside this repository (no third-party service) and refreshed daily by the Update Star History workflow.

Acknowledgments

Fushi builds on the following projects and ecosystem:

Learning tools and prior art

Project Description
jidoujisho Japanese immersive learning tool
Hoshi Reader iOS Japanese reader; reader paging engine reference
Hoshi Reader Android Android native Japanese reader
hoshidicts C++ dictionary engine
Sasayaki Audiobook sync solution
Tsubasa Subtitle-to-reference timing alignment algorithm (GPL-3.0); basis for auto-aligning downloaded subtitles to embedded tracks
Yomitan Dictionary format, transformation tables, and lookup experience reference
Lapis Anki note type
AnkiDroid Android card creation integration
Ankiconnect Android Local audio and AnkiDroid interaction reference
ッツ Ebook Reader Reader, statistics, and sync compatibility reference
media_kit Flutter video playback framework (libmpv core)
Niratan Immersion language learning suite for macOS

Engines and native components

Project Description
LunaHook Galgame text hooking engine (vendored DLLs loaded by the injector)
MinHook Inline hooking library used by the galgame injector
libtorrent Built-in torrent download engine
mpv libmpv playback core behind media_kit
FFmpeg Media probing, clipping, and audio extraction
libplacebo GPU video shaders and HDR tone mapping
flutter_inappwebview WebView engine that renders the EPUB reader
ONNX Runtime On-device inference for speech recognition and OCR
iroh P2P tunnel for remote Fushi Interconnect connections
zstd · xxHash · libdeflate · glaze · unordered_dense · utf8proc · utfcpp Dictionary engine dependencies

On-device models

Project Description
sherpa-onnx Zipformer speech recognition model packages and VAD builds
ReazonSpeech k2-v2 Japanese speech recognition model
Parakeet TDT-CTC 0.6B ja Japanese speech recognition model
Kitsune Japanese speech recognition model (CC BY-NC 4.0, downloaded from its Hugging Face repository)
Omnilingual ASR Multilingual CTC speech recognition model
Silero VAD Voice activity detection model
comic-text-and-bubble-detector Manga text and speech bubble detection model
manga-panel-detector-yolo26n Manga panel detection model, trained on Manga109-s
PP-OCRv6 small det / rec · PP-OCRv6_manga Text line detection and recognition; the manga-tuned rec (trained with Manga109-s and AnimeText) powers the per-column CTC local OCR model

The manga panel detection model and PP-OCRv6_manga are trained with the Manga109-s dataset (Matsui et al. 2017; Aizawa et al. 2020), whose terms require this use of the dataset to be clearly indicated. PP-OCRv6_manga (Apache-2.0) is additionally trained with the AnimeText dataset, which is licensed CC BY-NC-SA 4.0; the app downloads that model from its Hugging Face repository and does not redistribute it.

Content sources and integrations

Project Description
Mihon Manga source extension ecosystem
Aniyomi Anime source extension ecosystem (extensions-lib 14–16 hosted by the same runtime)
M-Extension-Server Manga extension runtime for desktop (vendored, MPL-2.0)
Mangayomi Mihon / Aniyomi extension adaptation reference
LNReader Light novel source plugin ecosystem
Jellyfin · Emby · Plex Media servers browsable from the video library
asbplayer Streaming subtitle bridge reference for the browser extension
Shoko Server Anime identification and scraping architecture reference
ReinaManager Galgame library information architecture reference
AniDB Anime, episode, and file identity
MyAnimeList (via Jikan) Anime metadata
TMDB Supplementary metadata and artwork
VNDB Visual novel metadata
Jimaku Japanese subtitle source
OpenSubtitles Subtitle source

This application uses TMDB and the TMDB APIs but is not endorsed, certified, or otherwise approved by TMDB.

License

Distributed under the GNU General Public License v3.0. See LICENSE for details.

Maintainer

Fushi is maintained by hajisensai. Website: fushi.moe. Contact: [email protected]. If Fushi helps you, you can support development, distribution and maintenance through GitHub Sponsors or Ko-fi.


English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português | Русский | Tiếng Việt | ภาษาไทย | Bahasa Indonesia | Italiano | Nederlands | Türkçe | العربية

Fushi (hajisensai/Fushi)

正在搜索数据库…

886 ·GitHub
这是什么?Fushi 是一套沉浸式语言学习工具,内置 EPUB 阅读器、视频字幕查词、有声书同步和一键 Anki 制卡功能。你可以在阅读、看视频或听音频时随时查词,并直接把单词发送到记忆卡片中。
这个应用在各个平台上都一样吗?不同系统的功能有区别吗?Fushi 是同一款应用,支持 Android、Windows、macOS 和 iOS(也可以通过源码在 Linux 上构建),但功能有所不同:视觉小说(galgame)的文本和语音挂钩功能仅限 Windows 使用;由于 App Store 的规则,iOS 版本不包含发现、在线资源和下载中心功能。
我的手机或电脑需要什么条件才能运行它?Android 需要 7.0(API 24)或更高版本;macOS 版本仅支持 Apple Silicon 芯片,不支持 Intel 芯片的 Mac。从源码构建时,需固定使用 Flutter 3.47.6,Dart SDK 版本需为 >=3.8.0。
在选择设备之前,有哪些平台相关的限制需要了解?macOS 版本仅支持 Apple Silicon;由于 App Store 的规则,iOS 的 TestFlight 版本没有发现、在线资源或下载中心功能;Linux 目前没有预编译的应用,并且其 EPUB 阅读器需要 WPE WebKit。
我的书库和阅读数据会怎样?你导入的所有内容(包括书籍、词典、字体、有声书数据、视频、进度、高亮和统计数据)都保存在应用的本地存储中。只有在你进行设置后,才会启用云同步(Google Drive、OneDrive、Dropbox、WebDAV、FTP、SFTP、Fushi Server);匿名的每日使用数据上报(不包含书库或阅读数据)可以在设置中关闭。
一键 Anki 制卡实际上是做什么的?在阅读、观看或收听时查词,Fushi 可以直接将卡片发送到 AnkiDroid 或已配置的 AnkiConnect 地址,省去手动复制粘贴制卡的步骤。
什么是 Fushi Server?Fushi Server(一个独立项目,hajisensai/fushi-server)是适用于 Linux、Windows 或 macOS 的测试版无界面版本,带有网页界面。你可以将书库托管在服务器上,而无需在本地运行完整的应用。
Windows 独有的 galgame 挂钩功能是如何运作的?在 Windows 上,Fushi 使用内置的 LunaHook 引擎和 MinHook 挂接到视觉小说的文本和语音中,提取对话用于查词和制卡;其他平台不支持此功能。
语音识别和漫画 OCR 是在设备上运行的吗?有声书同步和漫画检测会在设备端使用内置的 ONNX Runtime 模型,例如 sherpa-onnx 和 PP-OCRv6。但除非你在设置中切换为设备端模型,否则默认的漫画 OCR 引擎是 Google Lens,它会将页面图片发送给 Google。
大小
1.5 GB
星标
886
时长
7个月
提交 · 90 天