AI Context:Markdown、token 与文件夹打包
把文档转成 Markdown、统计 token、拆分长文件,并把整个文件夹或 Git diff 打包成一个可交给任意 AI 模型的 bundle,密钥会先被脱敏。全部在你自己的电脑上本地完成,不上传任何内容,粘贴什么、交给哪个模型都由你自己决定。
AI Context 分区在你自己的电脑上为语言模型准备文件:干净的 Markdown、如实的 token 数、能放进上下文窗口的分段,或者把整个文件夹打包成一个 bundle。什么都不会被发送出去;粘贴什么由你决定。自 1FileTool 1.11.1 起提供。
Convert to Markdown
Convert to Markdown 接收 Word、Excel、PowerPoint、PDF、HTML、EPUB、CSV、JSON 和 XML,写出模型好读的 Markdown。打开 Read scanned pages 可以对没有文本层的 PDF 和图片运行 OCR;速度会慢很多。
结果出来后,Copy text 把它放进剪贴板,Ask an agent 则在 AI Chat 里打开它,交给你电脑上已有的助手。
Token Counter
Token Counter 显示一个文件要花多少 token,以及它能放进哪些模型的上下文窗口。选择与你的模型对应的 Token model:GPT-4o (o200k)、GPT-4 (cl100k)、Claude (closest match) 或 Rough (chars ÷ 4)。Claude 的分词器没有公开,所以它的计数是估算值。
Split for Context
Split for Context 把长文档拆成若干部分,每部分都不超过 Tokens per part,并从上一部分重复 Overlap 个 token,让边界处的内容不丢失上下文。拆分优先落在段落之间,其次是换行处,所以不会在句子中间断开。
Pack Folder for AI
Pack Folder for AI 把一个文件夹变成一个 bundle:文件树、每个文件的内容和 token 总数,完成后还会按 token 列出最大的那些文件。默认情况下,它遵守 .gitignore(包括嵌套的),并在写出任何内容之前脱敏私钥、云服务和 API 密钥、访问令牌、密码等机密;Respect .gitignore 和 Redact secrets 都可以关闭。
What to pack 在 Git 仓库内缩小范围:
- Everything:文件夹里的每个文本文件。
- Uncommitted changes:你改了但还没提交的内容。
- Staged changes:暂存区里的内容。
- This branch vs its base:这个分支改动的全部内容(设置 Compare against,留空则使用 main、master 或 develop)。
- Recent commits:最近 N 次提交(设置 How many commits)。
打开 Include the diff 后,统一格式的 diff 会放在 bundle 的最前面。
How much of each file 让大项目不超预算:
- Full contents:每个文件的每一行。
- Auto (full, then code maps):先放完整文件,直到 Token budget 用掉一半,之后改为大纲。
- Code maps only:只保留带行号的声明,大约是十分之一的 token。
Bundle format 可选 Markdown(默认)、XML(Claude 读得好)或纯文本。Token budget 让 bundle 在这个 token 数处停止(0 表示全部打包),Skip files over 限制单个文件的大小。Copy bundle 复制结果。
从助手调用或自动运行
你的 AI 助手可以通过 AI Access 用 filetool_to_markdown、filetool_count_tokens 和 filetool_pack_context 运行同样的任务。Convert to Markdown 是一个 监视文件夹 动作,Convert to Markdown 和 Split for Context 都可以作为 Workflow Recipes 里的步骤。Doc to Markdown 和 Pack folder for AI 是 Home 上的快捷操作,四个工具也都在菜单栏的 Tools › AI Context 下。