# fish_read_windows

**Repository Path**: OrgXxxx/fish_read_windows

## Basic Information

- **Project Name**: fish_read_windows
- **Description**: 基于python3的windows摸鱼阅读器
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 摸鱼阅读器 v1.0.2

一款轻量级 Windows 桌面端隐蔽阅读器，支持在任何应用上方悬浮显示，适合在工作间隙悄悄阅读电子书。

## 功能特性

- **隐蔽阅读** — 透明置顶无边框窗口，可调节透明度
- **老板键** — 默认 `Ctrl+Shift+X` 一键隐藏/显示窗口
- **多格式支持** — TXT（自动编码检测）、EPUB（含图片）、MOBI、PDF（页面渲染，支持书签分章）
- **智能分章** — 自动识别中文章节标题（`第X章`、`Chapter N` 等）
- **阅读记忆** — 自动保存阅读进度，下次打开恢复上次位置
- **快捷操作** — 键盘翻页、Ctrl+滚轮调节字号/PDF缩放、拖放打开文件、缩放百分比指示器
- **最近阅读** — 托盘菜单查看历史阅读记录，支持跳转、单条删除、清空全部
- **系统托盘** — 关闭窗口后最小化到托盘，不影响后台运行
- **布局配置** — 通过托盘菜单自定义背景颜色/透明度、文字大小/颜色/透明度、PDF 内容透明度，支持实时预览
- **自动阅读** — 自动滚动阅读，可调速度，支持快捷键开关，滚到底自动切章
- **章节列表** — 标题栏一键查看章节列表，快速跳转
- **公众号留言** — 通过托盘菜单查看公众号二维码，反馈问题或建议

## 快速开始

### 环境要求

- Python 3.13+

### 安装与运行

```bash
# 克隆项目
git clone https://gitee.com/OrgXxxx/fish_read_windows.git
cd fish_read_windows

# 安装依赖
pip install -r requirements.txt

# 运行
python main.py
```

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl+Shift+X` | 老板键：隐藏/显示窗口 |
| `Ctrl+Shift+A` | 自动阅读开关 |
| `←` / `→` | 上一章 / 下一章 |
| `↑` / `↓` | 向上 / 向下滚动 |
| `Ctrl+O` | 打开文件 |
| `Ctrl+滚轮` | 调节字号（TXT/EPUB/MOBI）或缩放（PDF） |

## 配置说明

配置文件位于 `config/settings.json`，首次运行后自动生成：

| 键 | 默认值 | 说明 |
|----|--------|------|
| `hotkey` | `"ctrl+shift+x"` | 老板键组合 |
| `font_size` | 14 | 基础字号 |
| `font_family` | `"Microsoft YaHei"` | 字体 |
| `text_color` | `"#333333"` | 文字颜色 |
| `text_opacity` | 100 | 文字透明度（0-100） |
| `bg_color` | `"#ffffff"` | 背景颜色 |
| `bg_opacity` | 78 | 背景透明度（0-100） |
| `title_bg_color` | `"#f0f0f0"` | 标题栏背景颜色 |
| `title_bg_opacity` | 90 | 标题栏背景透明度（0-100） |
| `title_text_color` | `"#666666"` | 标题栏文字颜色 |
| `title_text_opacity` | 100 | 标题栏文字透明度（0-100） |
| `title_font_size` | 12 | 标题栏文字大小 |
| `title_bar_visible` | `true` | 是否显示标题栏 |
| `opacity_normal` | 0.8 | 活动窗口透明度（0-1） |
| `auto_save_interval` | 3000 | 自动保存间隔（毫秒） |
| `auto_read_enabled` | `false` | 是否开启自动阅读 |
| `auto_read_speed` | 3 | 自动阅读速度（1-10） |
| `auto_read_hotkey` | `"ctrl+shift+a"` | 自动阅读快捷键 |
| `pdf_scale` | 1.5 | PDF 渲染缩放因子（Ctrl+滚轮调节，范围 0.5~4.0） |
| `pdf_content_opacity` | 100 | PDF 内容透明度（0-100，布局配置中调节） |
| `window_width` | 300 | 窗口宽度（自动保存） |
| `window_height` | 120 | 窗口高度（自动保存） |

## 项目结构

```
main.py                      # 程序入口
├── core/                    # 数据与解析层
│   ├── reader_engine.py     # 格式分发与 TXT 解析
│   ├── bookmark.py          # 阅读进度管理
│   └── parsers/
│       ├── epub_parser.py   # EPUB 解析（支持图片）
│       ├── mobi_parser.py   # MOBI 解析
│       └── pdf_parser.py    # PDF 解析（页面渲染为图片）
├── ui/                      # 界面层
│   ├── main_window.py       # 主窗口
│   ├── title_bar.py         # 自定义标题栏
│   ├── hotkey_manager.py    # 全局热键管理
│   └── settings_dialog.py   # 布局配置对话框
├── assets/                  # 资源文件
└── config/                  # 运行时配置（自动生成）
```

## 依赖

| 库 | 用途 |
|----|------|
| [PySide6](https://doc.qt.io/qtforpython-6/) | Qt6 GUI 框架 |
| [chardet](https://github.com/chardet/chardet) | 文本编码自动检测 |
| [pynput](https://github.com/moses-palmer/pynput) | 全局键盘监听 |
| [ebooklib](https://github.com/aerkalov/ebooklib) | EPUB 解析 |
| [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/) | HTML 解析 |
| [PyMuPDF](https://pymupdf.readthedocs.io/) | PDF 解析与页面渲染 |
| [Pillow](https://python-pillow.org/) | PDF 内容透明度处理 |

## 版本历史

| 版本 | 更新内容 |
|------|----------|
| v1.0.2 | 支持 PDF 阅读（书签分章、页面渲染）、PDF 内容透明度可调、PDF 缩放（Ctrl+滚轮）+ 缩放指示器、窗口大小自动记忆、最近阅读记录管理、首次启动欢迎引导 |
| v1.0.1 | 智能分章（支持更多格式）、自动阅读、章节列表、优化大文件性能、UI 优化 |
| v1.0.0 | 初始发布，支持 TXT/EPUB/MOBI、老板键、布局配置 |

## 许可证

本项目仅供学习交流使用。