Windows 与 Android 小说、漫画下载、翻译和阅读客户端
青卷使用 Flutter 构建 Windows 与 Android 客户端。书库、下载、翻译和任务统一由现有 Linux FastAPI 后端管理，电脑和手机都不安装、打包或启动本地 Python 后端。
项目仍在持续开发。网站规则变化时，部分下载功能可能暂时失效。请只保存你有权访问的内容。
- 从常见小说、漫画网站导入作品
- 导入本地
TXT、DOCX、EPUB和PDF - 下载章节并查看任务进度
- 使用 OpenAI 兼容接口翻译小说和漫画
- 导出
TXT、DOCX、EPUB、PDF或图片压缩包 - 阅读原文和译文，保存阅读进度
- 使用设备系统 TTS 听书
- 支持亮色、深色和跟随系统主题
目前支持番茄小说、哔哩轻小说、Kakuyomu、Syosetu、Novel18、Pixiv、Webtoon、拷贝漫画、动漫之家、 18Comic、Bika 等站点，也支持导入 Legado / 阅读 App JSON 书源。
| 平台 | 支持范围 | 安装包 |
|---|---|---|
| Windows | Windows 10 / 11 x64 | QingJuan-v<版本>-windows-x64.zip |
| Android | Android 8.0（API 26）或更高版本 | QingJuan-v<版本>-android.apk |
| Linux | x86_64、systemd、Python 3.11+ 服务端 | 原生部署脚本 |
Windows 和 Android 只是远程客户端，必须连接 Linux 服务端；Windows ZIP 不包含旧版 PyInstaller 本地后端。
先在 Linux 服务器执行：
sudo mkdir -p /opt/qingjuan
sudo git clone https://github.com/Tavre/QingJuan.git /opt/qingjuan/app
cd /opt/qingjuan/app
sudo bash deploy/linux/install.sh
sudo qingjuan-info安装脚本会自动识别服务器的 Tailscale、WireGuard 或局域网 IP。安装完成后，sudo qingjuan-info 会显示
FastAPI 地址和连接 Token。公网服务器请使用 --url https://你的域名 指定已配置反向代理的 HTTPS 地址。
从 Releases 下载对应平台的安装包：
- Windows：完整解压 Windows x64 ZIP，运行
qingjuan.exe。 - Android：下载 APK，在手机或平板确认来源后安装。
首次打开 Windows 或 Android 客户端后：
- 打开 设置 → 后端连接。
- 填写服务器显示的“FastAPI 地址”和“连接 Token”。
- 点击 保存设置。
FastAPI 地址不要添加 /api/v1。公网访问必须使用 HTTPS，不要直接暴露公网 HTTP 端口。
常用服务器命令：
# 查看状态
sudo systemctl status qingjuan-backend --no-pager
# 查看日志
sudo journalctl -u qingjuan-backend -f
# 更新后端
sudo bash /opt/qingjuan/app/deploy/linux/update.sh
# 卸载并保留书库数据
sudo qingjuan-uninstall需要连同书库一起永久删除时，直接运行
sudo qingjuan-uninstall --purge-data，不要先执行普通卸载。
- Linux 数据保存在
/var/lib/qingjuan - Windows 与 Android 只保存界面偏好和平台安全存储保护的连接 Token
- 更新或迁移前请先备份 Linux 数据目录
- 不要公开连接 Token、翻译 API 密钥、Cookie、数据库和下载内容
- 连接建议使用局域网、Tailscale / WireGuard；公网访问必须使用 HTTPS
开发环境、项目结构、测试和发布规范见开发文档。本地常用构建命令：
# Windows x64 远程客户端
./tool/build_windows.ps1
# Android Release APK
flutter build apk --release.github/workflows/ci.yml 在 Pull Request、推送到 main / master（包括 PR 合并）以及手动触发时运行：
- Flutter 格式、分析和测试；
- Python Ruff 与 Pytest；
- Linux 部署脚本与原生后端冒烟测试。
只有这 3 个 CI 门禁全部成功后，工作流才会并行构建 Windows x64 与 Android Release 产物，并上传到该次
Actions 运行的 Artifacts。推送与 pubspec.yaml 版本一致的 v<版本> 标签时，发布工作流会进一步生成
Windows ZIP、签名 Android APK 和对应 SHA-256，并上传到 GitHub Releases。
欢迎提交 Issue 或 Pull Request。提交代码前请移除密钥、账号和个人数据。
- GitHub：Tavre/QingJuan
- QQ 群：
1074882763 - 安全问题请使用 GitHub 的 Security → Report a vulnerability 私密报告
本项目使用 GNU GPL v3 许可证。
感谢所有贡献者，以及 Flutter、FastAPI、RapidOCR、
fluent_ui、fanqie-assistant 等开源项目。