textfold - 把任意长文本折叠成可缩放的分层地图

textfold 是一个把长文本「折叠」成可缩放地图的工具。它的思路是：同一份文本，按你需要的信息密度提供五个档位——从只给几个词的主题卡片，到逐字保留的完整原文。你粘贴一个链接或拖入一个文件，文本会以分节地图的形式打开，逐级放大或缩小，每一档都由你已有的模型生成，而原文的句子始终保留在下面。它适合需要大量阅读论文、报告、网页与文档的人，也适合想把 AI 助手冗长回复压缩成可扫读结构的开发者。

维护者与状态

项目由 chenxiachan 维护，仓库创建于 2026-10-04，最后一次提交在 2026-10-15，最新 release 为 v0.10.7（2026-10-15）。截至 2026-10-16，仓库获得 256 个星标。项目采用 Apache-2.0 许可证。

主要能力

以下能力来自项目自述，未经本站实测。

据项目说明，textfold 的核心是五档折叠级别。第一档 Full 保留段落原文；第二档 Brief 取该段一到三句关键句，仍是作者原话；第三档 Key 给出该段的要点及理由，由 AI 基于 Brief 句子生成；第四档 Takeaway 用一行概括该节的主干；第五档 Topic 只留几个词，整篇文本变成一张分节卡片地图。项目强调，模型写出的每一行都会被标注出来，并锚定到它所依据的作者原句上。

在阅读体验上，README 中称：缩放时保留的文字会滑动到新位置，其余文字淡出；可以停在中间档、回退，或单独打开某一段；可以并排打开论文或 PDF 的原始页面，每个段落显示它在原页上的位置；可以选中一段向 AI 提问，回答按「先短答、再证据、每条引用所在段落」的结构给出；高亮与页边笔记会随缩放保留，并与页面一起保存。

输入来源方面，项目自述支持粘贴网页链接、arXiv、PubMed Central、bioRxiv、medRxiv、Wikipedia、GitHub 仓库地址，也支持拖入 PDF、Word、PowerPoint、Excel、EPUB、HTML、CSV、图片、Markdown 与纯文本文件。它还能读取 Zotero 库：据项目说明，textfold 通过本机已运行的 Zotero 应用通信，不需要账号或密钥，也不会改动库内容，需要在 Zotero 7 的「设置 › 高级 › 允许本机其他应用与 Zotero 通信」中开启。此外，项目称支持十二种语言，逐句翻译，公式保持排版。

面向 AI 助手输出，项目提供 Claude Code 与 Pi 的插件：在 Claude Code 中按 1 到 5 切换回复的详细程度，据项目说明不会改写模型原话。项目还提供命令行入口 python3 -m textfold get，让 agent 或脚本按档位逐级读取文档，先看地图再决定是否把整篇文本放进上下文；另有 python3 -m textfold export 用于导出页面。

使用入口

仓库地址：https://github.com/chenxiachan/textfold；项目官网：https://chenxiachan.github.io/textfold/。

据项目说明，可以直接下载 macOS（Apple silicon 或 Intel）或 Windows 桌面应用，运行所需组件（含 Python）已打包在内。也可以安装 Python 包，用于自己的流程：

python3 -m pip install textfold
python3 -m textfold serve

随后打开 http://localhost:3017。项目称需要 Python 3.9 或更新版本，macOS 自带的版本即可。首次使用时需要连接一个模型：如果本机已有 Claude Code、Codex 或 Pi，项目会自动发现并使用；也可以点击使用 ChatGPT 计划（需要 Node.js），或通过 OpenRouter 一键授权使用免费模型，或在设置中填入 Anthropic、OpenAI、DeepSeek、Qwen、Zhipu GLM、Kimi、MiniMax、Google、Ollama 或任意 OpenAI 兼容端点的 API key。

从源码运行的方式，据 README 为：

git clone https://github.com/chenxiachan/textfold.git
cd textfold
python3 -m pip install -r requirements.txt
python3 -m textfold serve

Claude Code 插件的安装方式，据项目说明为：

claude plugin marketplace add chenxiachan/textfold
claude plugin install textfold@textfold

项目称该插件需要 Claude Code 2.1.287 或更新版本，可在终端或桌面应用的 Code 标签页中使用。

许可与限制

项目采用 Apache-2.0 许可证。据项目说明，该许可证覆盖的是 textfold 自身的代码；分享生成的文件时，需要遵守原文的条款，原文条款显示在标题下方。

已知限制与前置条件（均来自项目自述）：需要 Python 3.9 或更新版本；需要连接一个模型才能生成折叠层；使用 ChatGPT 计划作为模型来源时需要 Node.js；扫描版 PDF 需要安装 PDF 引擎 MinerU（约 3.4 GB，从落地页一次性安装）才能完整读取；没有 HTML 版本的 arXiv 论文会从 PDF 读取，其他仅有 DOI 的条目需要 Europe PMC 上有开放全文；Zotero 集成需要在 Zotero 7 中手动开启本机通信权限。阅读内容默认保存在系统应用数据目录中，与桌面应用共享；从源码运行时则保存在克隆目录内。