🐱 知乎-- (Zhihu Minus Minus)

Important
🚧 项目声明：本项目目前核心功能基本稳定，但仍有不完善之处；知乎 API 的变动也可能导致部分功能失效。

欢迎提交 Issue、Pull Request 或 Fork 参与改进。也可以看看其他客户端：

https://github.com/zhihulite/Hydrogen

https://github.com/zly2006/zhihu-plus-plus

一款轻量、无广告的第三方知乎客户端，支持 Android 与 iOS。

✨ 特性

纯净浏览：推荐、热榜、关注、同城和知乎日报，支持全站与用户内容搜索。
舒适阅读：支持折叠回答卡片与左右切换回答两种浏览模式（一些地方是两种推荐流）。
双栏浏览（试验）：对大屏的适配尝试，在“设置 → 外观与阅读 → 双栏布局（试验性）”切换“启用双栏布局”即可即时切换单栏与双栏。
自由定制：自定义主题色、深浅色模式和阅读背景。
内容筛选：过滤广告与营销内容，支持关键词、正则屏蔽。
创作互动：写回答、文章，发想法、提问题，支持评论、赞同、收藏。
个人内容：管理创作、收藏夹与浏览历史，查看用户主页和专栏。
账号切换：支持多账号，也可用游客模式免登录浏览。游客可阅读接口公开返回的回答正文（折叠回答卡片模式时游客可以看到更多）。
更新与隐私：应用内检测新版，Android 支持下载安装；崩溃报告和匿名统计可随时关闭。

📸 界面预览

搜索

问题详情

夜间模式

关注更新

段落交互

📦 下载与安装

🤖 Android

你可以直接前往 GitHub Releases 下载最新的 APK 文件进行安装。

Note
请留意 APK 文件名。GitHub Release 会提供 arm64-v8a、armeabi-v7a、x86 和 x86_64 四个单 ABI APK；arm64-v8a 是默认验证过的主包，其余 compat-* 包目前主要用于兼容设备和模拟器，未完成完整实机验证。应用内更新会根据设备 ABI 选择匹配附件。

也可以从源码构建：

git clone 本仓库。
安装环境（参考下方的 快速开始）。
生成原生工程并运行本地 EAS 构建：

npm run prebuild
eas build --platform android --profile preview --local

本地 EAS 构建需要 Expo Token；如果启用了 telemetry，还要准备对应的 Firebase 配置文件和 Sentry 环境变量，详见数据统计与错误上报。

Windows 无法运行 eas build --local，请使用 Windows 本地构建指南中的 Gradle 流程。

🍎 iOS

本应用不会在 App Store 上架。 GitHub Releases 会提供未签名 IPA；需要用户自行处理签名和安装环境。

当前原生配置的 iOS 最低版本为 16.4。Release 中的 IPA 未签名，不能直接当作可安装成品使用。

使用 SideStore 或 AltStore Classic 时，可以添加以下订阅源，从源中安装并在侧载工具内更新应用：

https://github.com/huamurui/zhihu-minus-minus/releases/latest/download/altstore-source.json

该地址会在首次包含 altstore-source.json 的正式 Release 发布后生效，并跟随最新正式版本更新；临时构建和草稿 Release 不会更新公开源。适用于普通 IPA 侧载，签名和续期仍由侧载工具处理。源格式与兼容说明见 AltStore 官方文档和 SideStore 官方文档。

如果你有 mac，可以试试自己打包：

git clone 本仓库。
安装环境（参考下方的 快速开始）。
使用自己的 Apple ID 在 Xcode 中进行签名并编译到真机。

npm run prebuild -- --platform ios
(cd ios && pod install)
npx expo run:ios --configuration Release --device

如果 npx expo run:ios 在较新的 Xcode 上无法完成签名或安装，建议打开生成的 ios/*.xcworkspace，在 Xcode 中选择自己的 Team 后直接 Build。

🚀 快速开始

完整的环境、原生重建、调试和测试说明见开发指南，Windows 构建及其他专题见文档目录。

本项目使用 Expo SDK 58、React Native 0.88、React 19.3，涉及到一些原生库，推荐使用 Development Build 进行开发。

基础环境：

Node.js 24.x、npm（与 .nvmrc、CI 一致）；
Android：JDK 17、Android SDK、ADB 或模拟器；
iOS：macOS、Xcode 26.4 或更高版本、CocoaPods；
EAS CLI 仅在使用 EAS 构建时需要。

安装依赖

npm ci

npm run prebuild

android/ 与 ios/ 是生成物且不会提交到仓库。修改原生依赖、config plugin、原生配置或 app.json 后需要重新运行 prebuild；只修改 TypeScript/样式时通常不需要。从 SDK 55 更新的本地工程需先保留必要的本机签名或环境配置，再执行 npm run prebuild -- --clean，重新编译并安装 Development Build；完整升级步骤见开发指南。

运行 Android（需要 ADB 或模拟器环境）

npm run android

运行 iOS（需要 Mac 且安装 Xcode）

npm run ios

提交前验证

npm run check

npm run check 会依次执行 TypeScript、Biome、全部测试和富文本 fixture 分析。全仓只读检查也可单独运行 npm run lint；需要应用 Biome 修复时使用 npm run lint:fix，并逐项复核改动。

富文本模块的目录约定、fixture 与专项命令见 src/features/rich-content/README.md。更多开发约定见 DEVELOPMENT.md；面向自动化开发者的维护规则见 AGENTS.md。

🔐 登录说明

由于知乎 API 的安全性限制（X-ZSE-96 等），目前采用 WebView 自动拦截方案：

打开应用 -> 进入“我的” -> 点击登录按钮。
在弹出的登录界面完成登录。
升级首次读取会迁移旧明文账号，保留已有账号。保存或密钥失败时可在“我的”页重试；只有明确确认“清除本地账号”才清除所有账号。存储与设备恢复边界见账号保存与恢复。

🤝 贡献与声明

免责声明: 本项目仅供学习交流使用，不建议用于商业用途。
License: GPL-3.0 license

👥 贡献者 (Contributors)

Version: v0.9.5 | Last Updated: 2026-10-24

zhihu--