FoldRender 指南
FoldRender 常见问题
这些是 FoldRender 各篇指南里反复出现的问题，汇总到一页，每个用一段话回答。每个问题都在某一篇指南里有完整的解答 —— 下面的卡片里有链接 —— 这里的每个回答都只限于已发布版本实际做到的事：在干净设备上验证过的四种格式、验证过和没验证过的 git 路径，以及应用有意不去做的事。
FoldRender 做不到什么？
如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断，这个版本能不能做你要做的那件事。
- 本页的中文还没有按现版应用更新，有些步骤和界面名可能对不上，请以英文版为准。页面提到的干净设备验证用的是更早的版本。
- 这里的回答只是摘要；每篇链接的指南都有完整的操作步骤和它自己的限制清单。
- 验证状态照实写出，不打马虎眼：Markdown、源代码、PDF 和 Jupyter 笔记本渲染是在干净设备上验证过的四种；提交、推送和 diff 查看器已随版本发布，但没有验证过。
- FoldRender 是一个阅读器 —— 没有编辑器，没有终端，不能构建，不能批注 —— 没有哪个常见问题的回答会说成别的样子。
在 Android 上读仓库还有哪些办法？FoldRender 和它们比怎么样？
大家真正会用的四个应用，以及把它们区分开的那一条：仓库最后在不在手机上，到了手机上有没有东西把它渲染出来。
| 工具 | 下载价格 | 从哪里获取 | 克隆到设备上 | 渲染 PDF / Jupyter 笔记本 / Markdown | 编辑器或 shell |
|---|
| FoldRender | US$0 | Google Play，全球 | 能 —— HTTPS，公开仓库可匿名 | 能 —— 原生 Compose 渲染器 | 没有，有意为之：它是阅读器，不是 IDE |
|---|
| GitHub Mobile | US$0 | Google Play 和 App Store | 不能 —— 它读的是托管在 GitHub 上的仓库 | 只有 GitHub 自己渲染的内容，需联网 | 可在 PR 里编辑文件 |
|---|
| Termux + git | US$0 | F-Droid 或 GitHub | 能 —— 真正的 git 命令行 | 不能 —— 只有终端文本 | 有，完整的 shell，任何命令行编辑器都能用 |
|---|
| MGit 1.7.0 (2023) | US$0 | 只在 F-Droid | 能 —— 克隆、拉取、推送，HTTPS 或 SSH 密钥 | 不能 | 没有 —— 它自己的页面写明不带文本编辑器 |
|---|
价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐；Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。
FoldRender 的这些数字从哪来？
这里的每个数字都是从正式发布的版本里读出来的，或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。
- 价格：在 Google Play 上 US$0，面向全球发行。这个版本里没有计费库，没有订阅，也没有可升级的付费档。
- 当前版本：以 Google Play 页面上显示的版本为准。本页不重复写版本号，否则从发版到下一次网站更新之间它就是错的。这里的数字最后核对于 2026 年 8 月 27 日。
- 最低 Android 版本：
minSdk 30，也就是 2020 年随 Android 11 发布的 API 级别；编译和目标版本都是 API 36。 - 语法高亮：识别 65 种语言，覆盖 89 种文件扩展名，按词法对整个文件着色。
- 读取上限：单个文件最多读 32 MB，超过就标为截断；工作区全局搜索跳过大于 1.5 MB 的文件，找到 500 处匹配后就停下，不会把整栏刷满。
- 参考设备：Galaxy Z Fold 7，2025 年发布 —— 8 英寸内屏，合上时厚 8.9 mm，电池 4,400 mAh，三星标称视频播放最长 24 小时。
- 来龙去脉：Git 自 2005 年公开，所以这个应用读的磁盘格式已有 21 年历史；三星 2019 年推出第一代 Galaxy Fold，Android 有了 7 年真实的折叠屏硬件可以适配。
- 技术栈：界面用 Jetpack Compose，它的 1.0 于 2021 年发布；运行的系统从 2016 年起就支持分屏多窗口。
常见问题
- FoldRender 免费吗？
- 免费。它在 Google Play 上免费 —— 没有应用内购买，也没有广告，商店页面上这两行都没有 —— 名字是 FoldRender: Git Repo Reader，包名 dev.foldrender.app。Android 版只能从 Google Play 获取；网站上不提供 APK。
- 它需要哪个 Android 版本？
- Android 11 或更新的版本 —— 应用声明的 minSdk 是 30，如果设备低于这个版本，Play 会直接告诉你，而不是让你装上一个跑不起来的版本。
- 读公开仓库需要 GitHub 账号吗？
- 不需要。匿名克隆公开的 HTTPS 仓库在干净设备上验证过：粘贴地址，点 Clone，别的什么都不用。只有私有仓库才需要账号或令牌。
- 能编辑文件或代码吗？
- 不能。应用里哪里都没有编辑器。FoldRender 负责打开、渲染、搜索和导出；任何东西它都改不了一个字。
- 能从手机上提交和推送吗？
- 控件在这个版本里 —— 提交信息输入框、推送勾选框、提交 N 个文件按钮 —— 但没有人把它们完整跑通过，所以没有哪篇指南会告诉你它们能用。而且也没有编辑器，所以应用里没有改动可提交。目前受支持的 git 闭环是克隆加阅读。
- 克隆下来的仓库放在哪里？
- 在应用私有存储里，应用文件目录下的一个 repos 目录 —— git 需要真正的文件系统，而 Android 的存储访问框架提供不了。应用不申请存储权限，别的应用也读不到这个克隆。
- 能离线用吗？
- 能，只要内容已经在设备上。每个渲染器都读本地文件，图表和公式由 APK 自带的 mermaid 和 KaTeX 渲染，负责渲染的 WebView 禁止了网络加载 —— 打开飞行模式，阅读不受任何影响。只有远程 git 操作需要联网。
- FoldRender 是基于 WebView 的查看器吗？
- 不是。渲染用的是原生 Jetpack Compose。应用里只有两种 WebView：给 mermaid 和 KaTeX 用的隔离区，以及 HTML 文件查看器，两者都禁止网络加载。
- 哪些格式验证过？
- 四种：Markdown、源代码、PDF 和 Jupyter 笔记本 —— 在干净设备上验证过。应用里的其他渲染器（JSON/YAML/TOML 树形、CSV 表格、图片、HTML、日志）是根据已发布的版本描述的。
- 克隆一个大仓库之后，文件树为什么这么慢？
- 第一次列出要遍历整个仓库，大约 4,600 个文件这个量级时要很久，只显示一个转圈 —— 没有百分比，没有文件计数。它最终会完成；缺少进度提示是一个已知的毛糙之处。之后的浏览是按需加载的，每个目录在你展开时才列出。
- 能打开手机上已有的文件夹吗？
- 能 —— 「打开文件夹」会通过 Android 文件夹选择器授权一个目录，授权在重启后依然有效，文件树、类型标记、搜索和渲染一应俱全。只是没有 git 功能；那只留给 FoldRender 自己克隆的仓库。
- 能在 PDF 里搜索吗？
- 不能。查找栏只在以文字为主的格式里出现 —— Markdown、Jupyter 笔记本、JSON/YAML/TOML、CSV、源代码、日志、纯文本。PDF 靠页码计数和点一下就能跳转的缩略图条来导航。
- 支持 SSH 远程地址吗？
- 不支持。FoldRender 里的 git 只走 HTTPS —— ssh:// 或 git@ 地址用不了。托管平台要的凭据是个人访问令牌，令牌用 Android 硬件密钥库里的 AES-GCM 密钥加密。
- 能把文档转成 PDF 或者分享出去吗？
- Markdown 和 Jupyter 笔记本可以。「导出」面板提供三种：打印 / 存为 PDF（走 Android 打印框架）、一个自包含的 HTML 文件（字体、公式和图表都以 data URI 内嵌），以及一张整页的 PNG。其他格式没有导出。
- 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。