GitHub - joeseesun/qmreader-ios: 专注中文长文、翻译与乔木改写的原生 iOS 阅读器 | Native iOS reader for Chinese long-form reading, translation, and Qiaomu rewrites. · GitHub
|最后更新: 2026-8-24
URL
github.com/joesees...ader-ios
Status
Like
Saved
Aug 24, 2026 06:44 AM
链接
notion image
中文 | English
QMReader iOS 阅读外观
专注中文长文、翻译与乔木改写的原生 SwiftUI 阅读器。 A native SwiftUI reader for Chinese long-form reading, translation, and Qiaomu rewrites.
iOS Build
iOS 17+
SwiftUI
MIT License
已验证： ReaderLogicTests: PASS；Xcode 26.2 无签名构建与 Apple Development 真机签名构建通过；0.5.0 已安装至 iPhone 15 Pro。

这是什么

QMReader iOS 是 QMReader 的轻量原生客户端。它把 RSS 文章、中文翻译和“乔木改写”放进一个安静、快速、可离线回看的阅读界面，重点解决三件事：
  • 先看到可读的中文改写，而不是先闪出英文原文。
  • 用原生导航、缓存、下拉刷新和频道历史缩短等待。
  • 用真正会切换的中文字体、行距、页边距和纸面背景改善长文阅读。

核心能力

能力
你得到什么
改写优先列表
首页与频道只展示已经完成乔木改写的文章
原生频道历史
单独进入来源，继续加载历史消息
三种阅读内容
在原文、系统翻译和乔木改写之间切换
阅读外观
字号、三档行距、三档页边距、五种背景即时预览
五款开源中文字体
霞鹜文楷、霞鹜文楷 TC、朱雀仿宋、思源宋体、文津宋体随 App 分发
缓存与刷新
首屏优先读缓存；下拉刷新不清空当前列表
站内分享
分享 QMReader 的 canonical 改写页，原文链接仍可单独打开
链接加入
长按文章中的链接，可提交给 QMReader 抓取和改写

最快开始

然后在 Xcode 中：
  1. 打开 QMReader Target → Signing & Capabilities。
  1. 选择你自己的 Apple Development Team。
  1. 如果 ai.qiaomu.qmreader 已被占用，把 Bundle Identifier 改为你自己的反向域名。
  1. 选择 iOS 17+ 模拟器或已开启 Developer Mode 的 iPhone，点击 Run。

命令行验证

阅读体验

  • 背景：自动、暖纸、素白、护眼、深夜。
  • 字体：系统苹方 + 五款 OFL 中文字体。
  • 排版：15–24pt 字号、三档行距、三档页边距、多级标题节奏。
  • 辅助功能：Dynamic Type、VoiceOver、Reduce Motion、44pt 触控区。
背景放在字号之后，打开面板即可看到；字体卡片直接用对应字体渲染“山高水长”，避免“设置显示已切换、正文仍然没变”。
顶部分享按钮生成 https://rss.qiaomu.ai/articles/<slug>--<id>/rewrite 站内链接；更多菜单中的“在 Safari 打开原文”才使用源站 URL。

数据与架构边界

层
职责
SwiftUI App
列表、频道、阅读器、缓存、收藏/已读状态、系统分享与刷新反馈
rss.qiaomu.ai
RSS 数据、文章详情、翻译、乔木改写和链接抓取
本机存储
URLCache、文章快照、已读/收藏和阅读外观设置
当前公开版本默认连接 https://rss.qiaomu.ai。若要连接自己的兼容后端，需要同时修改：
  • QMReader/APIClient.swift 中的 baseURL
  • QMReader/ArticleShare.swift 中的 ArticleShareLink.baseURL
长按“加入乔木阅读”会把目标 URL 发送到 QMReader 服务端进行抓取；请不要提交私密链接。

内置字体与许可证

App 内置五款 SIL OFL 1.1 字体。为控制真机开发安装体积，霞鹜文楷、霞鹜文楷 TC 与朱雀仿宋使用 GB2312/Big5 阅读子集；生僻扩展字由 iOS 自动回退系统字体。完整来源、版本和许可证见 字体说明。
代码采用 MIT License，字体继续遵循各自的 SIL OFL 1.1 许可证。

已知限制

  • 这是源码发布，不提供 App Store 或公开签名 IPA；真机运行需要你自己的 Apple Development Team。
  • 当前版本以 Xcode 26.2、iOS 17 最低部署目标完成验证。
  • 系统翻译桥接只在 iOS 18+ 可用；其他系统仍可阅读原文和服务端改写。
  • 后端地址目前通过代码配置，还没有 App 内自定义服务器界面。
  • 五款中文字体会增加约 45 MB 的未压缩 App 体积。

贡献与安全

欢迎聚焦阅读体验、可访问性、缓存、频道和兼容后端的贡献。提交前请阅读 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md。安全问题请按 SECURITY.md 私下报告。

关于向阳乔木

QMReader 来自向阳乔木的日常 AI 阅读与内容工作流实践：关注的不是信息堆积，而是怎样更快得到可信、可读、可复用的中文理解。
  • 微信公众号：向阳乔木推荐看

English

QMReader iOS is a native SwiftUI client for QMReader, built for long-form reading with Chinese translations and Qiaomu-style rewrites.

What you get

  • A rewrite-first feed that avoids flashing short English originals before Chinese content is ready.
  • Native source history, pull-to-refresh, caching, read/favorite state, and system sharing.
  • Original, system-translation, and Qiaomu-rewrite reading modes.
  • Five paper themes, adjustable type size/line spacing/margins, and five bundled OFL Chinese fonts.
  • Internal canonical share links while keeping the original-source URL available separately.

Run it

Select your Apple Development Team and use your own Bundle Identifier when running on a physical device. The deployment target is iOS 17.

Boundaries

The app fetches feed, article, translation, and rewrite data from https://rss.qiaomu.ai. Submitting a link sends that URL to the QMReader backend. Reading preferences, read/favorite state, and cached snapshots stay on the device.
This repository ships source code only—there is no public signed IPA or App Store build. System Translation requires iOS 18+. To use a compatible self-hosted backend, update the base URLs in APIClient.swift and ArticleShare.swift.
The app code is MIT licensed. Bundled fonts retain their upstream SIL OFL 1.1 licenses; see font provenance.
Maintained by 向阳乔木 / Joe · @vista8 · @joeseesun
Loading...