FoldRender / 指南 / 在手机上读整个 GitHub 仓库
FoldRender 指南

在手机上读整个 GitHub 仓库

这是 FoldRender 真正做完了的那条路:匿名克隆一个公开仓库,然后从同一棵文件树里读它的每一个文件 —— Markdown、源代码、Jupyter 笔记本、PDF。这条路已在干净的设备上跑过。下面是逐步的操作,慢的地方也照实写出来,并直说 git 这一半做到哪里为止。

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

分步操作

  1. 从 Google Play 安装

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

  2. 克隆仓库

    点顶栏里的分支图标打开 Git 面板。把一个 HTTPS 地址粘贴到 Clone an HTTPS repository URL 输入框里 —— 占位文字给出了预期的格式 https://github.com/you/repo.git —— 然后点 Clone。对公开仓库来说这就是全部:不要账号,不要令牌,不用登录。只支持 HTTPS;不支持 SSH 远程地址。

  3. 等第一次列出文件树

    FoldRender 会把克隆下来的仓库作为工作区打开,并开始列出文件。在一个大约 4,600 个文件的仓库上,这一步要很久,而且只显示一个转圈 —— 没有百分比,没有文件数,也没有预计时间。它最终会完成。中小型仓库很快;只有在大仓库上才会感到缺了进度提示。

  4. 从 README 开始

    文件标签页就是文件树,每一行都有类型标记,并且会按 .gitignore 隐藏文件,所以第三方依赖目录和构建产物不会碍事。点 README.md。展开时,文件树留在左边,文档在右边渲染;合上时,文档占满屏幕,按返回键就回到文件树。

  5. 读代码

    源文件会对整个文件做词法高亮,带行号,文件上方那一行显示识别出的语言和行数,长行可以用换行开关处理。JSON、YAML、TOML 和锁文件以可折叠的树形打开,带可复制的路径导航;CSV 以可排序、表头冻结的表格打开;日志按严重级别着色;PDF 有页码计数和点一下就能跳转的缩略图条;Jupyter 笔记本显示单元格、执行计数和保存下来的输出。

  6. 在整个仓库里查找

    搜索标签页在整个工作区里 grep —— 按字面或正则,结果以 path:line 行的形式陆续出现,每行附一行预览,点一下就在那一行打开。它遵守 .gitignore,跳过二进制文件和大约 1.5 MB 以上的文件,最多 500 处匹配,到上限时搜索结果上方会标出「(已截断)」。在手机上,这就是「读一个仓库」和「划一个仓库」的区别。

  7. 记住读到哪里

    每个文档的滚动位置都会保存,重新打开时恢复。快捷标签页收集你打开过的文件;在文件树里长按可以把文件固定为收藏 —— 在一个陌生的代码库里,你反复回去看的那两三个文件值得这样做。

  8. 查看仓库状态

    回到 Git 面板,每个克隆都有一个小按钮;标题栏显示当前分支、领先和落后的提交数,以及「· 干净」或「· N 处改动」。下面是 Pull、浏览文件、本地分支按钮,以及最近的提交列表,显示每个提交的短 id 和作者。

FoldRender 是怎么做的

仓库里的所有文件,一个阅读器

Markdown、大约六十种语言的源代码、JSON/YAML/TOML、CSV/TSV、包括 SVG 在内的图片、PDF、HTML、日志和 Jupyter 笔记本,都从同一棵树、在同一栏里打开。在设备上验证过渲染的是 Markdown、源代码、PDF 和 Jupyter 笔记本。

按内容选渲染器,而不是按文件名

每种格式都是一个无状态的渲染器,同时根据文件名、MIME 类型和魔数(文件开头的特征字节)给文件打分,得分最高的胜出。一个没有扩展名、但以 %PDF 或 <svg 开头的文件,照样会交给对的渲染器。

为展开的屏幕而做

窗口够宽,或者设备确实处于半开状态时,会出现双栏 —— 左边文件树,右边文档;合上时收成一栏,按返回键就回到文件树。配置变化由 Activity 自己处理,而不是被销毁重建。

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 的这些数字从哪来?

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

常见问题

能在手机上浏览和阅读一整个 GitHub 仓库吗?
能,而且这正是在干净设备上验证过的那条路:匿名克隆一个公开的 HTTPS 仓库,然后在双栏的文件树和文档视图里读每一个文件。已确认能渲染的有 Markdown、源代码、PDF 和 Jupyter 笔记本。
我需要 GitHub 账号吗?
公开仓库不需要。匿名克隆什么都不用填。私有仓库需要个人访问令牌,或者 GitHub 的设备码登录。
克隆并列出一个大仓库要多久?
克隆本身就是一次普通的 HTTPS git clone。拖慢的是第一次列出文件树 —— 在一个大约 4,600 个文件的仓库上,要在一个没有进度提示的转圈后面等很久。它会完成,只是没什么可看。
这是代码编辑器吗?
不是。没有编辑器,没有终端,也不能构建。FoldRender 只负责打开、渲染、搜索和导出仓库里的内容。
能在飞机上读仓库吗?
能,只要已经克隆下来。每个渲染器都读本地文件,就连渲染 mermaid 和 KaTeX 的隔离区也完全从 APK 自带的资源里运行,并且禁止网络加载。只有要和远程仓库通信的 git 操作才需要联网。
克隆下来的仓库存在哪里?
在应用私有存储里,应用文件目录下的一个 repos 目录 —— git 需要真正的文件系统,而存储访问框架提供不了。应用不申请存储权限,其他应用也读不到它。
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 指南