Zhihu++ Swift

面向 iPhone 和 iPad 的第三方知乎客户端。iOS 客户端使用 Swift、SwiftUI 与 UIKit 原生实现，不链接 Kotlin Multiplatform Shared.framework，也不依赖 Compose、CocoaPods、Swift Package 或第三方二进制框架。

[!IMPORTANT] 本项目不是知乎官方产品，与知乎及其关联公司不存在隶属、授权或背书关系。项目依赖非公开接口，知乎服务端的变化可能随时导致部分功能失效。

特别感谢原项目

本项目基于 zly2006/zhihu-plus-plus（在新窗口打开） 发展而来。原作者 zly2006 以及所有上游贡献者完成了产品方向、知乎接口探索、内容模型和大量基础能力；没有这些长期积累，就不会有这个原生 Swift 版本。

请优先关注、Star 并支持原项目（在新窗口打开）。本 Swift 版本的问题不应转交给上游维护者处理。

本仓库是 2026 年 7 月制作的修改版。纯 Swift iOS 实现与迁移改造由 OpenAI Codex 完成，继续保留原项目的版权与开源许可。应用图标亦基于原项目素材制作，具体归属见 THIRD_PARTY_NOTICES.md（在新窗口打开）。

维护说明

这是一个按当前需求生成的社区项目，欢迎 Fork 后按照自己的需要进行二次修改和维护。

本仓库后续不承诺：

• 修复已知或未来出现的 Bug；
• 增加、移植或维护新的 Feature；
• 适配知乎接口、iOS 或 Xcode 的后续变化；
• 回复 Issue、接受 Pull Request 或提供安装支持。

代码按现状提供，请在使用、修改或分发前自行审查和测试。

系统要求

运行

项目	要求
最低系统	iOS / iPadOS 16.0
推荐系统	iOS / iPadOS 26 或更高版本，可使用完整的系统 Liquid Glass 效果
翻译能力	需要 iOS / iPadOS 18 或更高版本，并取决于系统翻译资源可用性
设备	Xcode Target 支持 iPhone 与 iPad；当前主要验收设备为 iPhone

iOS 16–18/25 会使用系统提供的兼容样式；iOS 26+ 才会启用 Liquid Glass 等新系统效果。部分能力还取决于设备硬件与权限，例如相机扫码、Face ID / Touch ID、照片保存和语音朗读。

构建

项目	要求
开发环境	macOS + 完整版 Xcode 26 或更高版本
SDK	iOS 26 SDK 或更高版本
Swift	Swift 5 language mode
签名	Apple Account、可用的 Development Team 与唯一 Bundle Identifier

已知验证环境为 Xcode 26.6、iOS SDK 26.5。仅安装 Command Line Tools 无法完成 iOS App 构建。

当前原生能力

• SwiftUI 原生首页、关注、热榜、日报与搜索；
• 原生问题、回答、文章、想法与个人主页；
• 评论与楼中楼、投票、收藏、分享、图片预览和评论图片选择；
• 收藏夹、浏览历史、应用内通知、写回答与发布想法；
• WKWebView 登录与风控验证、Keychain 账户存储；
• AVFoundation 扫码授权、Photos 图片保存、系统分享；
• LocalAuthentication App 锁；
• Core Spotlight、App Intents / Shortcuts、前台朗读与系统翻译能力检测；
• iOS 26+ 原生 Liquid Glass 样式。

功能状态以当前源码为准。旧版 Zhihu++ 在 Android、Desktop 或 KMP 中存在的能力，不代表本 Swift 客户端已经实现。

构建与安装

通过 SideStore 安装与更新正式版

一键添加到 SideStore（在新窗口打开）

也可以在 SideStore 的来源页面手动添加：

https://raw.githubusercontent.com/kangyun1994/zhihu-plus-plus-swift/main/sidestore-source.json

更新源只需添加一次。首次从来源安装后，后续正式版本会随 GitHub Releases（在新窗口打开） 发布，并通过同一来源在 SideStore 中显示更新。正式 IPA 始终使用 com.github.zly2006.zhplus.ios，可以在现有正式版上更新；请勿为更新版改用不同的 Bundle Identifier，否则 iOS 和 SideStore 会将其视为另一个 App。

SideStore 检查到新版本后会下载 GitHub Release 中的未签名 IPA，并使用设备上的 Apple Account 重新签名安装。版本更新与 SideStore 的日常签名刷新是两件事：添加来源 用于发现新版本，7 天签名有效期仍由 SideStore 按其正常流程刷新。

从源码构建

克隆仓库并打开 Xcode 工程：

git clone https://github.com/kangyun1994/zhihu-plus-plus-swift.git
cd zhihu-plus-plus-swift
open iosApp/iosApp.xcodeproj

首次构建前可以运行只读预检：

./iosApp/scripts/preflight.sh

在 Xcode 的 Signing & Capabilities 中选择自己的 Development Team，并将 Bundle Identifier 改为自己可用的唯一值，然后选择模拟器或已信任的设备运行。

如需生成供 SideStore 重新签名的未签名 IPA：

BUNDLE_ID=com.example.zhihuplusplus.swift \
  ./iosApp/scripts/build-sidestore-ipa.sh

产物位于：

build/iosApp/sidestore/ZhihuPlusPlus-SideStore.ipa

Apple Account、密码、签名证书、Provisioning Profile 和设备配对文件都不应提交到仓库，也不应提供给构建脚本之外的第三方。

更多签名与导出说明见 iosApp/README.md（在新窗口打开）。

隐私说明

• 当前 Swift Target 未实现项目自有遥测；
• 登录 Cookie 存储在系统 Keychain 中，不应写入源码或日志；
• 客户端会直接访问知乎及内容所需的网络服务，实际数据处理同时受对应服务条款与隐私政策约束；
• 请勿在公开 Issue、日志、截图或测试数据中提交 Cookie、Token、手机号、邮箱、设备标识或其他个人信息。

开源许可

Copyright © 2024–2026 zly2006 and contributors.

本项目是 zly2006/zhihu-plus-plus（在新窗口打开） 的修改版，整体继续采用 GNU Affero General Public License v3.0 only（AGPL-3.0-only）。完整条款见 LICENSE（在新窗口打开）。

如果分发 IPA 或其他目标代码，应同时以 AGPL v3 要求的方式提供该版本的完整对应源码，并保留版权、修改说明、许可与无担保告知。建议每个二进制 Release 对应一个源码 Tag，并在下载位置提供该 Tag 的源码链接。

本软件不提供任何明示或暗示的担保；使用、修改和分发风险由使用者自行承担。“知乎”及相关标识归其权利人所有。

Zhihu++ Swift v0.3.1

首页与热榜

• 修复未登录状态下热榜加载失败的问题，改用支持游客访问的移动端热榜接口。
• 优化首页频道栏定位：推荐和日报优先贴近对应边缘，中间频道保持居中。
• 为频道栏首尾保留与标题、内容一致的水平边距，避免选中推荐时紧贴屏幕边缘。

海报分享

• 使用知乎主题蓝完善海报配色，并统一标题、正文、引用和辅助信息的视觉层级。
• 将 Zhihu++ 图标和原文二维码移至海报顶部，扫码入口更醒目。
• 支持展示回答、文章、想法及评论作者头像；头像不可用时显示文字占位。
• 精简互动信息，只保留赞同/点赞与评论数量，不再重复展示“回答、文章、想法、视频”等内容类型。

分享入口

• 回答、文章和想法的分享菜单统一仅保留“复制链接”和“分享内容海报”。
• 移除重复的系统链接分享和 Markdown 复制、分享入口。

SideStore 正式更新

本版本提供未签名 IPA：

ZhihuPlusPlus-0.3.1-unsigned-final.ipa

• 版本：0.3.1 (5)
• Bundle ID：com.github.zly2006.zhplus.ios
• 最低系统：iOS / iPadOS 16.0
• 文件大小：3,873,247 字节
• SHA-256：b7f6be04c1d8fda090a1d76ac5683da1a66112ff23e6bb23160631afb974bfad

发布前已完成 354 项 Simulator 测试，全部通过。

Zhihu++ Swift v0.3.0

推荐与首页

• 新增 App/Web 两种推荐源，可在设置中切换；两种来源均支持过滤推广内容。
• 推荐刷新数量支持设置为 6～20 条。客户端每次请求 10 条并循环拉取，第一批有效内容返回后立即更新页面。
• 优化并发刷新：刷新过程中忽略重复下拉，回顶刷新会中断旧任务并重新开始。
• 冷启动优先展示上次缓存的推荐内容，超过一小时后自动后台刷新；缓存按账号和推荐源隔离。
• 修复推荐、关注、热榜和日报的刷新状态、更新时间、触感反馈及加载提示不一致的问题。
• 优化瀑布流布局，作者、赞同和评论信息统一左对齐，并根据图片比例选择右侧缩略图或横向大图。
• 完善想法、动图、多图和视频内容在瀑布流中的展示，并支持长按屏蔽问题作者。

内容与媒体

• 新增想法原生详情页，修复正文乱码、图片及互动数据展示异常。
• 新增 GIF 动图播放与系统原生视频播放器，播放失败时可回退到网页。
• 改进多图预览、动图浏览、图片裁切和对齐。
• 内置 KaTeX 资源，改善回答和文章中的数学公式渲染。
• 扩展富文本解析，完善标题、引用、嵌套列表、代码块、公式、图片、视频和链接的显示。

评论与分享

• 点击评论直接进入回复状态，仅点击“共 X 条回复”时打开楼中楼。
• 评论支持长按或左滑进行回复、复制和分享；楼中楼在外层列表中统一收起。
• 优化评论输入栏、回复对象提示、操作按钮尺寸和键盘收起逻辑。
• 修复最热/最新排序表现及楼中楼预览不一致的问题。
• 新增长图海报分享，支持回答、文章、想法和评论，并包含作者、互动数据、原文二维码和 Zhihu++ 标识。
• 评论海报突出评论内容，仅保留上级内容的简要摘要；选择图片分享时不再附带额外链接。

搜索、链接与落地页

• 修复键盘“搜索”按钮无响应的问题；打开搜索页时自动聚焦输入框并唤起键盘。
• 修复搜索加载状态布局，并新增“搜索 TA 的创作”原生搜索。
• 新增知乎专题和专栏原生落地页，支持标题、简介、统计数据、混合内容及分页。
• “收录于 XXX”优先进入原生专栏或专题页面。
• 修复专栏请求 403、分页一直处于 Loading 以及加载分隔线宽度异常的问题。
• 新增外部页面打开方式设置，可选择应用内浏览器或系统默认浏览器。
• 新增剪贴板知乎链接识别，可原生打开回答、文章、问题、想法、用户、专题、专栏和搜索链接。
• 优化日报内容路由；无法原生解析时提供明确错误和网页回退，不再停留在 Cancelled 状态。

个人主页与多账号

• 个人主页扩展回答、文章、动态、收藏、提问、想法、专栏和关注等内容。
• 移除列表右侧多余箭头，扩大整行点击区域。
• 粉丝和关注改为打开独立列表页，不再替换个人主页当前内容。
• 修复个人主页切换标签时页面高度和滚动位置跳动的问题。
• 新增多账号本地管理，可保存、切换和删除非当前账号。
• 新增账号使用独立登录会话，避免直接复用当前账号的网页登录状态。
• 账号凭据保存在系统 Keychain，并兼容迁移旧版本账号数据。
• 切换账号时同步重置推荐、关注、热榜、日报、通知及相关缓存；退出登录只移除当前账号。

导航、通知与设置

• 底部导航统一为“首页、收藏、账号”，搜索保持为右下角独立入口。
• 首页右上角并排展示创作和通知按钮；存在未读通知时显示提示点。
• 优化通知已读状态、分类读取及账号切换后的未读数量同步。
• 新增推荐源、刷新数量、信息密度、摘要行数、图片展示方式及默认分享动作设置。
• 新增可选的性能诊断日志，记录脱敏后的网络、刷新、分页和路由耗时。
• 诊断日志不记录账号凭据、正文、评论或搜索词；单份最多 15 MB，保留最近 5 份，支持查看、分享和删除。
• 调整触感反馈档位时可立即预览对应反馈强度。

修复与稳定性

• 修复历史记录未及时收录最新浏览内容，以及下拉、分页 Loading 无法结束的问题。
• 修复从推荐页返回后列表回到顶部、频道栏状态异常的问题。
• 修复关注频道布局和频道切换动画与其他频道不一致的问题。
• 修复动态内容、收藏及个人主页部分模块点击区域过小的问题。
• 修复通知、推荐缓存及用户数据在多账号之间串用的问题。
• 补充推荐、账号、搜索、媒体、通知、专题/专栏、个人主页和富文本解析相关测试。

SideStore 正式更新

本版本提供未签名 IPA：

ZhihuPlusPlus-0.3.0-unsigned-final.ipa

• 版本：0.3.0 (4)
• Bundle ID：com.github.zly2006.zhplus.ios
• 最低系统：iOS / iPadOS 16.0
• 文件大小：3,886,488 字节
• SHA-256：30367aed549f28cc615b261203b5fc66cdcc8646f8001ba19d0c3ac601b46e5a

已添加项目 SideStore 来源的用户会在来源刷新后看到本版本，并可直接覆盖升级现有正式版。

Zhihu++ Swift v0.2.0

主要更新

• 首页整合推荐、关注、热榜和日报频道，支持横向滑动与点按频道切换，并保留各频道原有信息密度和滚动状态。
• 首页频道超过一小时未访问后，重新进入会先回到顶部再刷新；顶部显示“尚未更新”“刚刚更新”或相对更新时间。
• 再次双击首页标签可回到当前频道顶部并刷新。推荐流首次加载、刷新和后续翻页均请求 40 条。
• 优化首页展开/收起标题、频道选择器、顶部操作区和底部标签结构；搜索成为独立系统标签，并完善进入与再次选择时的焦点行为。
• 新增可配置的触觉反馈与反馈力度，在频道切换、刷新完成、回答切换、图片切换和完成式关闭等明确交互节点提供反馈。
• 重做评论与回复交互：回复使用原生 Sheet 呈现，支持边缘滑动关闭、滑动回复、复制评论、图片选择和更清晰的加载/失败状态。
• 优化回答横向切换与图片浏览手势；系统边缘返回保持最高优先级，非边缘手势继续用于回答切换。

修复与稳定性

• 修复从推荐流进入回答后返回时列表错误回到顶部、标题收起状态不同步的问题。
• 修复存在上一回答时，从屏幕系统边缘右滑难以返回的问题；系统返回不额外触发自定义触感。
• 提高推荐、关注和搜索响应对非内容推广卡、结构化描述及异常作者字段的兼容性。
• 改进分页、并发刷新和重试期间的状态隔离，避免非当前频道后台加载或旧请求覆盖新结果。
• 完善日报、文章、回答、评论和应用内链接的原生导航与返回路径。

SideStore 正式更新

本版本提供未签名 IPA：

ZhihuPlusPlus-0.2.0-unsigned-final.ipa

• 版本：0.2.0 (3)
• Bundle ID：com.github.zly2006.zhplus.ios
• 最低系统：iOS / iPadOS 16.0
• 下载来源：GitHub Release v0.2.0
• 文件大小：2,840,557 字节
• SHA-256：794dac479967282b55f3f4f1fd69db25ad76313951637b6ae5ca23231515b28b

可以在项目 README 中一键添加 SideStore 更新源。来源只需添加一次；后续正式版发布时， SideStore 会读取来源中排在最前的版本，下载对应 GitHub Release IPA 并提示更新。 这不会取代 SideStore 的 7 天签名刷新：版本源负责发现新版，SideStore 仍负责使用用户自己的 Apple Account 重新签名、安装和日常刷新。

致谢

感谢 Vetiver（V2EX 客户端） 与 MNGA（在新窗口打开） 在横向频道切换、更新时间表达和重新进入后的刷新节奏方面带来的交互设计启发。 本项目是在自身 SwiftUI / UIKit 架构中独立实现这些体验，没有复制上述项目的代码。

同时感谢 zly2006/zhihu-plus-plus（在新窗口打开） 及其贡献者长期积累的产品方向、知乎接口探索和内容模型。