Repository navigation
English (default) · 展开查看完整中文说明 · 日本語の全文は下を展開してください。
简体中文 · 欣阅 1.3.1
更清晰的阅读界面，更顺畅的页面准备。欣阅 1.3.1 优化详情与导航面板、进度条和多书拖动预览，并改进可随机访问压缩源的后台加载。
本次更新
- 详情与 Topic 面板： 增加固定标题和关闭按钮，调整工具栏间距与详情内容宽度。关闭按钮无常驻边框，悬停和按下时提供更清晰的反馈。
- 更协调的半透明界面： 调整面板、菜单项、操作按钮和选中状态的底色与细边框。Topic 选择器保留白色底色，与灰色切换开关区分。
- 更清楚的阅读进度： 统一阅读器、书籍卡片和详情页的已读／未读配色。阅读器滑块手柄加长至 22 × 10 px，上下控制栏采用统一半透明底色与细分隔线。
- 缩略图选区： 图片和页码作为完整选区，修正交互高亮的上、左、右留白，让悬停和选中反馈更一致。
- 多书自定义排序： 浮动预览改为紧凑的封面与标题扇形卡片，显示选择数量并保持稳定的指针偏移。
- 后台加载调度： 对已确认支持随机访问的非固实压缩源，限量并发准备页面和缩略图，优先处理当前可见内容。快速跳页或关闭后淘汰过期请求，避免旧结果重新显示。固实、能力不明的压缩源及 PDF 保持原有串行准备策略。
- 使用文档： 补充完整中文、日文手册，澄清标签创建和不同系统的存储路径。
- Windows 文字排版： 修正省略文字标签在字体行距小于完整行框时少分配 1 px 的问题，保留完整文字高度，不放大面板或控件。
- 图片格式兼容： 旧版 Qt 无法加载原生解码库时，在后台使用已有的 Pillow 解码并预缩放，修复 Ubuntu ARM64 的 WebP 阅读、缩略图与封面预览。
下载与安装
在本页底部的 Assets（附件） 中选择适合系统的安装包：
| 系统 | 安装包 | 要求 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+，不提供 Intel 版本 |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
基于 Ubuntu 22.04 构建 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
基于 Ubuntu 22.04 构建 |
SHA256SUMS 提供安装包校验值；build-info.json 记录版本、实际构建提交和逐平台构建来源。Linux 包并不保证兼容所有发行版。
macOS 首次启动： 打开 DMG，把 JoyRead 拖进应用程序文件夹，再从该文件夹启动。应用使用 ad-hoc 签名，未经过 Apple 公证。如果系统提示无法验证应用，在确认下载来源后：
- 点击**「完成」**，不要点击「移到废纸篓」。
- 打开苹果菜单 → 系统设置 → 隐私与安全性。
- 在**「安全性」**中找到 JoyRead 被阻止的提示。
- 点击**「仍要打开」**，按提示确认或验证身份。
安装新副本后可能需要再次确认。如果 Launchpad 尚未显示，请先从「应用程序」直接打开。
Windows： 运行 EXE 安装程序。安装包没有受信任的代码签名；如果出现 SmartScreen 提示，确认来源后选择**「更多信息 → 仍要运行」**。
Ubuntu： 在下载目录打开终端，按架构选择命令。图形安装器可能卡在“正在准备”，请使用 APT：
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.1-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.1-linux-arm64.deb升级与兼容性
从 1.3.0 升级不新增数据库迁移，保留书库、合集、标签、自定义排序、封面、阅读进度和每本书的阅读设置。建议升级前备份书库。预加载默认仍为前 4／后 8；Windows 后台模式及自动空闲清理默认保持开启。支持 ZIP/CBZ、7z/CB7、RAR/CBR 和 PDF，EPUB 仍未启用。
验证
四平台在构建 38928032902中分别先测试发行配置，再构建安装包；使用同一冻结源提交 4847ff1ddecf0bb8281670b6741c7ab8f28145c1 和 Python 3.12.9，EPUB 门控保持关闭。
| 平台 | 测试通过 | 跳过 | 安装包状态 |
|---|---|---|---|
| macOS arm64 | 2024 | 12 | DMG 构建成功 |
| Windows x64 | 2015 | 21 | EXE 构建成功 |
| Linux amd64 | 2026 | 10 | DEB 构建成功 |
| Linux arm64 | 2026 | 10 | DEB 构建成功 |
两个 Ubuntu 安装包均通过 APT 安装、隔离书库启动和 WebP Reader 首帧烟测；amd64 的 289 个、arm64 的 288 个 ELF 文件均满足 glibc ≤ 2.35。四份安装包的版本、架构、完整构建提交和 SHA-256 均已核对，逐平台来源保存在 build-info.json。
独立回归 CI的五个任务全部通过，另覆盖 Ubuntu 24.04 和 macOS 的 EPUB 额外依赖配置。本机最终 125% 离屏 UI 及图片链路检查为 145 项通过；这些自动化结果不替代桌面手动验收。
手动验收：维护者于 2026-10-20 确认 macOS、Windows、Ubuntu 三端测试均通过。 CI 使用离屏环境，与桌面手动验收分开记录。1.3.1 作为稳定版发布。
已知限制
极大尺寸的渐进 JPEG 页面在解码时仍可能明显增加进程内存。预缩放与缓存预算正常，进一步的内存优化已列为低优先级后续工作。
欣阅使用 GPL-3.0-only 许可证。
日本語 · ジョイヨミ 1.3.1
読書画面を見やすく、ページの準備をよりスムーズに。ジョイヨミ 1.3.1 では、詳細・ナビゲーションパネル、進行バー、複数冊のドラッグ表示を調整し、ランダムアクセス可能な圧縮元のバックグラウンド読み込みを改善しました。
更新内容
- 詳細・Topic パネル： 固定の見出しと閉じるボタンを追加し、ツールバーの余白と詳細領域の幅を調整しました。閉じるボタンの枠は常時表示せず、ホバーと押下の表示を明確にしました。
- 半透明の配色を調整： パネル、メニュー項目、操作ボタン、選択状態の背景と細い枠線を整えました。Topic セレクターは白い背景を保ち、グレーの切り替えスイッチと区別します。
- 進行状況を見やすく： リーダー、本のカード、詳細画面で既読・未読の配色を統一しました。リーダーのつまみを 22 × 10 px に広げ、上下の操作バーには均一な半透明背景と細い区切り線を使用します。
- サムネイルの選択範囲： 画像とページ番号を一つの範囲として扱い、上・左右のハイライト余白を揃えてホバー・選択表示を改善しました。
- 複数冊のカスタム並べ替え： ドラッグ中は表紙とタイトルだけのコンパクトなカードを扇状に表示します。選択数を示し、ポインターからの位置を安定させました。
- バックグラウンド読み込み： ランダムアクセスを確認できた非ソリッド圧縮元では、ページとサムネイルの準備を制限付きで並列実行し、表示中の内容を優先します。素早い移動や終了で古くなった要求を取り下げ、以前の結果が再表示されるのを防ぎます。ソリッド圧縮、アクセス能力が不明な圧縮元、PDF は従来の直列準備を維持します。
- 使い方の文書： 中国語・日本語の完全なマニュアルを追加し、タグ作成と各 OS の保存先を明確にしました。
- Windows の文字配置： ベースライン間隔が行全体の高さより短い場合に、省略表示ラベルの高さが 1 px 足りなくなる問題を修正しました。パネルや操作部を拡大せずに、文字に必要な高さを確保します。
- 画像形式の互換性： 古い Qt でネイティブコーデックを読み込めない場合は、既存の Pillow でバックグラウンドのデコードと事前縮小を行います。Ubuntu ARM64 の WebP 読書、サムネイル、表紙プレビューを修正しました。
ダウンロードとインストール
ページ下部の Assets（添付ファイル） から、お使いの OS に合うパッケージを選んでください：
| OS | パッケージ | 要件 |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+、Intel 版なし |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
Ubuntu 22.04 でビルド |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
Ubuntu 22.04 でビルド |
SHA256SUMS はパッケージのチェックサム、build-info.json はバージョン、実際のビルドコミット、各環境のビルド情報です。Linux 版はすべてのディストリビューションとの互換性を保証しません。
macOS の初回起動： DMG を開き、JoyRead をアプリケーションへドラッグして、そこから起動します。ad-hoc 署名を使用し、Apple の公証は受けていません。確認できないアプリという警告が出た場合、入手元を確認したうえで：
- **「完了」**をクリックします。「ゴミ箱に入れる」は選びません。
- アップルメニュー → システム設定 → プライバシーとセキュリティを開きます。
- **「セキュリティ」**で JoyRead のブロック通知を探します。
- **「このまま開く」**をクリックし、必要に応じて確認・認証します。
新しいコピーでは再承認が必要になることがあります。Launchpad に見当たらない場合は、アプリケーションフォルダから直接開いてください。
Windows： EXE インストーラーを実行します。信頼されたコード署名がないため、SmartScreen が表示された場合は入手元を確認して**「詳細情報 → 実行」**を選びます。
Ubuntu： ダウンロード先でターミナルを開き、アーキテクチャに合うコマンドを実行します。GUI インストーラーは「準備中」で停止する場合があるため、APT を使用してください：
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.1-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.1-linux-arm64.deb更新と互換性
1.3.0 からの更新では新しいデータベース移行はありません。蔵書、コレクション、タグ、カスタム順序、表紙、読書位置、本ごとの設定を保持します。更新前の蔵書バックアップを推奨します。先読みは引き続き前 4／後 8 ページが初期値です。Windows のバックグラウンドモードと待機中の自動メモリ解放も初期設定で有効です。ZIP/CBZ、7z/CB7、RAR/CBR、PDF に対応し、EPUB は引き続き無効です。
検証
4 対象ではビルド 38928032902で出荷構成をテストしてからパッケージを作成しました。固定のソースコミットは 4847ff1ddecf0bb8281670b6741c7ab8f28145c1、Python は 3.12.9 です。EPUB のゲートは無効のままです。
| 対象 | テスト成功 | スキップ | パッケージの状況 |
|---|---|---|---|
| macOS arm64 | 2024 | 12 | DMG ビルド成功 |
| Windows x64 | 2015 | 21 | EXE ビルド成功 |
| Linux amd64 | 2026 | 10 | DEB ビルド成功 |
| Linux arm64 | 2026 | 10 | DEB ビルド成功 |
Ubuntu の両パッケージは APT インストール、独立した蔵書での起動、WebP Reader の初回フレームのスモークテストを通過しました。amd64 の 289 個、arm64 の 288 個の ELF ファイルは、すべて glibc ≤ 2.35 を満たします。4 パッケージのバージョン、アーキテクチャ、完全なビルドコミット、SHA-256 を照合済みです。対象ごとのビルド情報は build-info.json に保持しています。
独立した回帰 CIも 5 ジョブすべて成功し、Ubuntu 24.04 と macOS の EPUB 追加依存関係構成も確認しました。ローカルでの最終 125% オフスクリーン UI・画像処理の検証は 145 テスト成功です。これらの自動検証はデスクトップの手動確認を代替しません。
手動確認：2026-10-20 に、メンテナーが macOS・Windows・Ubuntu の全環境でテスト成功を確認しました。 CI はオフスクリーン環境で実行し、デスクトップの手動確認とは別に記録します。1.3.1 を安定版として公開します。
既知の制限
非常に大きなプログレッシブ JPEG のページでは、デコード中にプロセスのメモリ使用量が大きくなる場合があります。事前縮小とキャッシュ予算は機能しており、追加のメモリ最適化は優先度の低い今後の項目です。
ジョイヨミは GPL-3.0-only で提供されます。
JoyRead 1.3.1
A clearer reading interface and smoother page preparation. JoyRead 1.3.1 refines Detail and navigation panels, progress indicators, and multi-book drag previews, and improves background loading for random-access archives.
What's improved
- Detail and Topic panels: fixed title/close rows, refined toolbar spacing, and more room for Detail content. Close buttons keep a borderless resting state with clearer hover and pressed feedback.
- Balanced translucent surfaces: refined backgrounds and thin borders for panels, menu items, action buttons, and selection states. The Topic selector retains its white background, distinct from gray switches.
- Clearer reading progress: matching read/unread colors across the Reader, book cards, and Detail. The Reader handle is now 22 × 10 px; top and bottom controls use uniform translucent backgrounds with subtle separators.
- Thumbnail selection: images and page numbers share one selection area, with aligned top/left/right highlight insets and more consistent hover and selected states.
- Multi-book custom sorting: compact cover/title cards form a fan while dragging, with a selection count and a stable pointer offset.
- Background loading: confirmed random-access, non-solid sources use bounded concurrent page and thumbnail preparation, favoring visible content. Rapid navigation and closing retire obsolete requests so stale results cannot reappear. Solid archives, unknown-access sources, and PDFs retain their existing serial preparation policy.
- Documentation: complete Chinese and Japanese manuals, with clearer tag-creation instructions and platform-specific storage paths.
- Windows text layout: elided labels retain a full font line box when baseline spacing is shorter, preventing a one-pixel shortfall without enlarging panels or controls.
- Image-format compatibility: when an older Qt build cannot load a native codec, existing Pillow codecs decode and pre-scale in workers, restoring Ubuntu ARM64 WebP reading, thumbnails, and cover previews.
Download and install
Choose the package for your platform from Assets at the bottom of this page:
| Platform | Installer | Requirements |
|---|---|---|
| macOS · Apple Silicon | JoyRead-1.3.1-macos-arm64.dmg |
macOS 13+; no Intel build |
| Windows · x64 | JoyRead-1.3.1-windows-x86_64-setup.exe |
Windows 10/11 x86-64 |
| Ubuntu / Linux · amd64 | JoyRead-1.3.1-linux-amd64.deb |
Built on Ubuntu 22.04 |
| Ubuntu / Linux · arm64 | JoyRead-1.3.1-linux-arm64.deb |
Built on Ubuntu 22.04 |
SHA256SUMS contains installer checksums; build-info.json records the version, actual build commit, and per-target provenance. Linux packages do not imply compatibility with every distribution.
macOS first launch: open the DMG, drag JoyRead into Applications, and launch it there. The app is ad-hoc signed and not Apple-notarized. If macOS says it cannot verify the app, after verifying your download source:
- Click Done, not Move to Bin.
- Open Apple menu → System Settings → Privacy & Security.
- Find the JoyRead blocked-app notice under Security.
- Click Open Anyway, then confirm/authenticate as prompted.
A new copy may require approval again. If Launchpad does not show it, open it directly from Applications first.
Windows: run the EXE installer. It has no trusted code signature; if SmartScreen appears, verify the source before choosing More info → Run anyway.
Ubuntu: open a terminal in the download folder and choose your architecture. The graphical installer may remain at “Preparing”, so use APT:
# amd64 / x86-64
sudo apt install ./JoyRead-1.3.1-linux-amd64.deb
# arm64
sudo apt install ./JoyRead-1.3.1-linux-arm64.debUpgrade and compatibility
Upgrading from 1.3.0 adds no database migration. Your library, collections, tags, custom order, covers, reading progress, and existing per-book settings are retained. Back up your library before upgrading. Preloading still defaults to 4 previous / 8 following pages. Windows background mode and automatic idle memory cleanup remain enabled by default. ZIP/CBZ, 7z/CB7, RAR/CBR, and PDF remain supported; EPUB remains disabled.
Validation
Each target passed shipping-configuration tests before packaging in build 38928032902. All four installers use frozen source commit 4847ff1ddecf0bb8281670b6741c7ab8f28145c1 and Python 3.12.9, with the EPUB gate disabled.
| Target | Tests passed | Skipped | Package status |
|---|---|---|---|
| macOS arm64 | 2024 | 12 | DMG built successfully |
| Windows x64 | 2015 | 21 | EXE built successfully |
| Linux amd64 | 2026 | 10 | DEB built successfully |
| Linux arm64 | 2026 | 10 | DEB built successfully |
Both Ubuntu packages passed APT installation, isolated-library startup, and a WebP Reader first-frame smoke check. All 289 amd64 and 288 arm64 ELF files meet glibc ≤ 2.35. Installer versions, architectures, full build commits, and SHA-256 hashes have been verified; build-info.json retains per-target provenance.
All five jobs in the separate regression CI also passed, adding Ubuntu 24.04 and macOS with EPUB extra dependencies. Final local 125% offscreen UI and image-pipeline checks passed 145 tests. These automated checks do not replace manual desktop acceptance.
Manual acceptance: the maintainer confirmed successful desktop testing on macOS, Windows, and Ubuntu on 2026-10-20. CI runs offscreen and is recorded separately from manual desktop acceptance. 1.3.1 is published as a stable release.
Known limitation
Extremely large progressive-JPEG pages can still cause high process memory use during decoding. Pre-scaling and cache budgets are working; further memory tuning is a low-priority follow-up.
JoyRead is licensed under GPL-3.0-only.