Local File Reader：浏览器端代码库打包工具，为LLM提供完整项目上下文

Local File Reader是一款纯浏览器运行的代码库打包工具，旨在解决开发者向LLM提供完整项目上下文的痛点。其核心价值在于：零服务器依赖保障代码隐私，智能过滤与压缩优化输出文本，支持自然语言/CLI/视觉三种交互模式，帮助突破Token限制并提升LLM对项目结构的理解效率。

问题背景

与LLM协作开发时，开发者常面临逐个复制文件效率低、易触Token上限的问题。

项目信息

• 原作者/维护者：maksim-sterkis
• 来源平台：GitHub
• 原始链接：https://github.com/maksim-sterkis/local-file-reader
• 发布时间：2026年6月15日

多阶段处理流水线

1. 括号平衡控制：自动修正不匹配括号
2. Token保护层：隔离文本字符串与路径
3. 语义提取：基于Compromise.js提取动词意图
4. 递归AST解析：映射逻辑结构优先级
5. 意图路由：分「查看」或「保留/删除」分支

交互模式

1. 自然语言指令（ask:前缀）：如"ask: keep only .js files"
2. 标准CLI命令：如".html remove"或"keep .ts"
3. 实时视觉过滤：如"config"（包含）、"-mock"（排除）、">100kb"（大小筛选）

智能忽略机制

自动规避node_modules、.git、dist等大容量依赖目录

精细化压缩

可配置移除注释、删除空行、修剪多余空格

文件标记

识别二进制文件（图片/PDF等）或>1MB大文件并标记

实时监控

动态显示预估输出大小，帮助控制Token规模

使用步骤

1. 打开index.html（无需服务器）
2. 拖放项目目录到暂存区
3. 筛选目标文件
4. 选择压缩参数
5. 编译并下载输出文件
6. 上传至LLM平台

部署

支持静态托管（GitHub Pages、Vercel、AWS S3等），依赖浏览器API与CDN

1. 内存限制：多GB代码库可能导致浏览器崩溃
2. 二进制限制：强制编译会产生乱码
3. 正则边界：注释移除可能误识别复杂字符串
4. 浏览器兼容性：需支持HTML5 File API与ES6+的现代浏览器（Chrome/Edge/Firefox/Safari）

Local File Reader代表LLM时代新型开发工具范式，是弥合开发者与LLM上下文鸿沟的桥梁。纯浏览器架构兼顾隐私与便捷性，自然语言交互降低使用门槛。对团队而言，它解决了"给AI看什么"的基础问题，当LLM理解完整项目结构时，代码建议、重构与bug修复的准确性将显著提升。