FoldRender / 指南 / 随时随地离线读你的仓库
FoldRender 指南

随时随地离线读你的仓库

FoldRender 的每个渲染器都读本地文件，就连图表和公式那一层也从 APK 自带的资源里运行，网络访问被直接封锁。所以只要你事先克隆好，航班上、隧道里、没信号的地方都还能读仓库。下面讲怎么有意地把这件事准备好，而不是到了登机口才发现。

在 Google Play 上获取免费 看看 FoldRender 能做什么

分步操作

  1. 从 Google Play 安装

    FoldRender 在 Play 商店上的名字是 FoldRender: Git Repo Reader，包名 dev.foldrender.app，免费，面向全球发行。照常安装即可 —— 不会弹出要你打开「允许来自此来源的应用」的提示，更新也会自动送达。应用声明了 minSdk 30，所以需要 Android 11 或更新的版本；如果设备低于这个版本，Play 会直接告诉你，而不是让你装上一个跑不起来的版本。

  2. 没信号之前先克隆

    这是唯一需要联网的一步。点分支图标，填 筛选，或输入 owner/repo，点 获取代码。公开仓库可以匿名克隆。在 Wi-Fi 下做，别等到站台上。

  3. 趁还有时间，让文件树列完

    大仓库第一次完整列出要很久 —— 大约 4,600 个文件这个量级，是真要等一会儿，界面上只有一个转圈，没有进度显示。列出文件是本地操作，所以离线时也会进行；只是最好在登机前就把它做完。

  4. 打开你知道会用到的文件

    打开过的文件会进入快捷标签页，在文件树里长按可以把文件固定为收藏。每个文档的滚动位置都会记住。起飞前花两分钟固定几个文件，之后半睡半醒时，才能在文件树里一下找到要看的文件。

  5. 断网，然后读

    飞行模式下：Markdown 照样渲染，源代码带高亮和行号，PDF 带页码计数和缩略图，笔记本带单元格和保存下来的输出，JSON 和 YAML 以树形打开，CSV 是表格，日志按严重级别着色，图片可以双指缩放。这些都不是远程服务；没有任何东西要来回传输。

  6. 图表和公式也照样能用

    大家通常以为这部分需要联网。其实不需要：mermaid 和 KaTeX 连同字体都打包在 APK 的资源里，负责渲染的 WebView 禁止了网络加载，它的客户端对任何不是打包资源或 data URI 的请求都返回 403。打开飞行模式，带图表的文档渲染起来没有任何变化。

  7. 离线也能搜索

    两种搜索都是本地的。查找栏搜索当前打开的文档；搜索标签页在整个工作区里 grep，按字面或正则，path:line 结果陆续出现。两者都不连接任何地方。

  8. 落地后再拉取

    重新连上网络后，Git 面板里的 Pull 按钮会更新克隆，面板标题栏显示分支以及领先和落后的提交数，你能看出远程走了多远。

FoldRender 是怎么做的

克隆下来就能用

仓库一旦在应用私有存储里，每个渲染器都从磁盘读文件。这个应用没有服务器端，渲染只在设备上进行。

离线是结构决定的，不是靠缓存

应用里唯一可能连网的部分 —— 画图表和公式的 WebView 隔离区 —— 被拒绝了两次：一次是它设置里的 blockNetworkLoads，一次是对任何非资源地址都返回 403 的客户端。没有会过期的缓存，也不需要先联网运行一次。

离线编辑时的实时重载

应用用一个带防抖的文件观察器监视打开文件所在的目录，文件一变就原地重新渲染，滚动位置不变 —— 监视目录而不是文件本身，是因为编辑器保存时是先写临时文件再重命名。在内屏的一半用终端应用编辑，另一半就能看到它重新渲染。

FoldRender 做不到什么？

如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断，这个版本能不能做你要做的那件事。

在 Android 上读仓库还有哪些办法？FoldRender 和它们比怎么样？

大家真正会用的四个应用，以及把它们区分开的那一条：仓库最后在不在手机上，到了手机上有没有东西把它渲染出来。

工具下载价格从哪里获取克隆到设备上渲染 PDF / Jupyter 笔记本 / Markdown编辑器或 shell
FoldRenderUS$0Google Play，全球能 —— HTTPS，公开仓库可匿名能 —— 原生 Compose 渲染器没有，有意为之：它是阅读器，不是 IDE
GitHub MobileUS$0Google Play 和 App Store不能 —— 它读的是托管在 GitHub 上的仓库只有 GitHub 自己渲染的内容，需联网可在 PR 里编辑文件
Termux + gitUS$0F-Droid 或 GitHub能 —— 真正的 git 命令行不能 —— 只有终端文本有，完整的 shell，任何命令行编辑器都能用
MGit 1.7.0 (2023)US$0只在 F-Droid能 —— 克隆、拉取、推送，HTTPS 或 SSH 密钥不能没有 —— 它自己的页面写明不带文本编辑器

价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐；Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。

FoldRender 的这些数字从哪来？

这里的每个数字都是从正式发布的版本里读出来的，或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。

常见问题

能在手机上离线读仓库吗？
能。仓库克隆下来之后，每个文件都从本地存储渲染 —— Markdown、源代码、PDF、笔记本、数据文件和图片。只有要和远程通信的 git 操作才需要联网。
没信号时 mermaid 图和 LaTeX 还能渲染吗？
能，而且不是因为缓存。mermaid 和 KaTeX 连同字体都打包在 APK 里，负责渲染的 WebView 禁止了网络加载，它的客户端拒绝任何不是打包资源的地址。它就算想取东西也取不到。
离线能搜索吗？
能。文档内查找栏和整个工作区的 grep 都完全在设备上、针对本地文件运行。
还有什么需要联网？
克隆、拉取和推送 —— 这些要和远程通信的操作。其他一切，包括所有渲染和所有搜索，都是本地的。
离线文件存在哪里？
在应用私有存储里，应用文件目录下。git 需要真正的文件系统，而存储访问框架提供不了。手机上别的任何东西都读不到那个目录，卸载应用会把它删掉。
能直接读手机上已有的文件夹，而不克隆吗？
能 —— 用「打开文件夹」授权它，它就成了一个持久保存的工作区，文件树、搜索和渲染都一样。只是没有 git 功能，所以重新联网后没有「Pull」可点。
FoldRender 多少钱？
US$0。在 Google Play 上免费，面向全球发行，版本里没有计费库，没有订阅，也没有付费档。
FoldRender 支持哪些 Android 版本？
Android 11 及以上。应用声明的 minSdk 是 30，也就是 2020 年随 Android 11 发布的 API 级别；编译和目标版本都是 API 36。它在 2025 年发布的 Galaxy Z Fold 7 上开发和测试。
FoldRender 能离线用吗？
能，只要仓库已经在设备上。克隆和拉取需要联网；从克隆下来的仓库或选中的文件夹里阅读、搜索，以及渲染 Markdown、源代码、PDF 和 Jupyter 笔记本都不需要。登录 GitHub 是可选的，只和私有仓库有关。
它和 GitHub Mobile、Termux、MGit 有什么不同？
GitHub Mobile 读的是托管在 GitHub 上的仓库，不会克隆到手机上。Termux 和 MGit 都能克隆，但克隆之后怎么渲染就交给你了 —— Termux 给你一个 shell，MGit 连文本编辑器都没有。FoldRender 通过 HTTPS 克隆，并在内屏上把克隆下来的内容渲染出来。

这些说法去哪里核对？

上面这些数字背后的一手文档，任何一条你都可以自己核对，不必听我们说。

本页最后核对于 2026-08-27。

更多 FoldRender 指南

在 Galaxy Z Fold 7 上读 Markdown在 Android 上 git clone：把仓库放到手机上，就在手机上读在 Galaxy Z Fold 7 上读 PDF，就在仓库旁边在手机上读代码，带真正的语法高亮在折叠屏上读 Jupyter 笔记本