软件简介
PaperRss 是一款现代纸感 RSS 阅读器(macos)，拥有简约舒缓的沉浸式界面、双语翻译可配置的AI功能，一切把控在阅读者手里。
没有sticky的聊天机器人或者LUI，PaperRss主张主动阅读，并提供克制的AI功能，让一切润物细无声。
Reading First, AI Second
_本项目灵感启发自另一款优秀的开源RSS预读器 NetNewsWire_
📢 项目还在持续迭代中，使用过程可能会遇到问题，但每一次反馈都会让PaperRss变得更好，感谢理解
核心亮点
- 沉浸式杂志模式与拟真折纸翻页：全新双页排版编排（Balanced Duo），智能提取文章大图画报；基于 Metal 着色器的拟真卷曲与折纸翻页动效，搭配真实翻页音效与底部导读滑轨。
- 沉浸式纸感阅读：适合长文的衬线排版、明暗主题与稳定的三栏导航，支持列表与杂志多视图无缝流体切换。
- 存储治理与自动淘汰机制：支持配置历史文章保留期限（180天/1年/永久），未读与星标绝对永久保留，墓碑防幽灵机制与空闲磁盘深度整理。
- 渲染引擎与数学公式（LaTeX）：重构富文本准备引擎，原生集成 MathJax 排版与公式防转义保护，完美呈现学术长文。
- 按需 AI 摘要：所有功能完全可以选用，如果你不喜欢AI，干掉它；或者在需要的时候按下V键
- 划词翻译、解释与提问：结合文章上下文理解所选文字。
- 自由模型接入：支持按供应商保存 OpenAI 兼容接口、DeepSeek 与 Google Gemini API Key；摘要、双语和三种划词能力可分别选择模型，切换配置不会隐藏已有 AI 产物。
- 多账户接入：支持本地账户与 FreshRSS / Miniflux 服务，提供双向未读/星标同步。
AI 服务配置
在“设置 → AI 功能”中，“供应商与模型”只管理 OpenAI 兼容接口、DeepSeek、Google Gemini 或自定义端点的连接、API Key 与模型目录；远端模型经多选确认后才加入配置。“功能配置”分别为摘要、双语翻译、划词翻译、解释和提问设置开关与模型。Google Gemini 使用官方 OpenAI-compatible 地址 https://generativelanguage.googleapis.com/v1beta/openai，需要填入 Gemini API Key。
旧版本的单一 AI 配置会在首次启动时绑定到五项功能，原有 API Key、模型、开关和自定义 Prompt 都会保留；旧配置键仍保留用于兼容回滚。API Key 只保存在本机应用偏好，不参与 iCloud 同步。
真实界面
沉浸式纸感阅读
AI 全文摘要
划词解释与翻译
AI 模型配置
多账号接入
下载与安装
稳定版 v1.4.1（Build 33） 新增「文章阅读」自定义快捷键，并优化杂志模式方向键就近导航与翻回位置恢复，建议所有用户升级。详情见 更新记录。
Beta v1.4.2-beta.1（Build 34）：新增 Miniflux 账号接入，使用 Miniflux「设置 → 集成」的 Google Reader 凭据同步订阅、分类、文章与双向已读/星标状态，与 FreshRSS 账号并存。下载测试版。
从 Releases 下载最新的 .dmg 安装包，打开后将 PaperRss 拖入 Applications 文件夹即可使用。
📝 备注：签名问题已解决——所有产物均经过 Developer ID 签名与 Apple 公证，首次打开不会再出现「无法验证」提示。接下来版本更新会加快，敬请谅解。
Homebrew
要求 macOS 14+，支持 Apple Silicon 与 Intel Mac。首次安装：
brew install --cask ohmyangboy/tap/paperrss以后升级：
brew update
brew upgrade --cask --greedy ohmyangboy/tap/paperrssPaperRss 支持应用内更新，因此使用 --greedy 将其纳入 Homebrew 升级检查。
已通过 DMG 安装？先退出 PaperRss，再执行以下命令，由 Homebrew 替换并管理应用，订阅、阅读记录和设置会保留：
brew update
brew install --cask --force ohmyangboy/tap/paperrss此命令安装 tap 中的稳定版；如果正在使用更新的 beta 版，请勿执行，以免降级。
Tap 与安装说明：ohmyangboy/homebrew-tap。
curl 脚本安装
无需 Homebrew。先退出 PaperRss，再执行：
curl -fsSL https://ohmyangboy.github.io/PaperRss/install.sh | bash脚本从 GitHub 获取最新稳定版，校验 SHA-256、应用签名与 Gatekeeper 后安装到 /Applications。再次执行同一命令即可更新；保留订阅、阅读记录与设置，并拒绝覆盖版本号更新的应用。已通过 Homebrew 安装的用户请继续使用 brew upgrade。
仅下载校验、不安装：
curl -fsSL https://ohmyangboy.github.io/PaperRss/install.sh | bash -s -- --dry-run如需安装到个人应用目录，在命令末尾使用 bash -s -- --app-dir "$HOME/Applications"。脚本随官网发布，并自动跟踪 GitHub 稳定版，无需每次更新安装链接。
从源码构建
构建环境要求：Xcode 26.0+（源码使用 macOS 26 SDK 的 glassEffect 等 API）、Swift 6.0 工具链、可安装 Xcode 26 的 macOS 主机（macOS 15.6+）。应用产物本身仍支持在 macOS 14.0+ 运行。
git clone https://github.com/ohmyangboy/PaperRss.git
cd PaperRss
swift build -c release日常开发与验证：
./scripts/dev.sh # 构建并启动 App
./scripts/dev.sh --isolated # 临时数据目录隔离运行，不影响正在使用的实例
./scripts/verify.sh --core # Swift 单元与回归测试（完整分级见脚本注释）或在 Xcode 中打开 PaperRss.xcodeproj，选择 PaperRss scheme 与 My Mac 后运行。
二次开发注意：
- 工程提交了原作者的签名 Team（
DEVELOPMENT_TEAM）。请在 Xcode 的 Signing & Capabilities 中改成自己的 Team；命令行构建也可用CODE_SIGNING_ALLOWED=NO跳过签名。 build/、.build/缓存会记录绝对路径；移动仓库目录后请先执行./scripts/clean.sh --apply（./scripts/clean.sh为预览）再构建。
赞赏与反馈
如果 PaperRss 改善了你的日常阅读体验，欢迎使用微信扫码赞，支持独立开发与持续维护。
或者点个免费的 star，这能让作者开心一整天 ;D
感谢每一位热爱独立软件与专注阅读的读者。
问题、功能想法与代码改进请提交到 GitHub Issues。或者在社交媒体留言～
交流信息也可以随时发送邮件至 [email protected]。
隐私、内容与第三方软件
PaperRss 是本地优先而非“完全离线”的客户端：订阅和正文缓存默认保存在本机；刷新 Feed、同步 FreshRSS / Miniflux、加载原网页或图片、检查更新以及用户主动使用 AI 功能时，客户端会直接连接相应第三方服务。AI 功能可能按具体操作发送全部或部分文章内容，请在使用前审查所选模型服务商的条款。
开源协议
PaperRss 基于 GNU General Public License v3.0 开源。
贡献者 Contributor
特别感谢：
感谢所有为 PaperRss 提供问题报告、详细反馈和宝贵建议的朋友，是大家的参与让 PaperRss 不断变得更好。❤️
赞赏名单
也感谢每一位通过赞赏支持 PaperRss 的朋友。
预览随网站部署自动更新，点击图片查看最新完整名单（图片缓存可能稍有延迟）。
Star History