IceWhaleTech/filens

这是什么？

核心功能

• 01命令行本地读取并搜索 PDF、Office、表格、扫描件和图片。
• 02搜索嵌套压缩包，无需模型即可提取关键原文。
• 03查找重复文件和相似图片。
• 04输出文本、JSON、Markdown、HTML、CSV、YAML、XML 等格式。
• 05在浏览器中预览 Office、iWork、PDF、CAD、3D、RAW 和 360° 文件，无需服务器。
• 06提供 npm 包、Vue 组件以及可离线打开的单文件 HTML 导出。

适用场景

• 为 AI Agent 提供本地文档的原文、搜索结果和可引用的段落。
• 在 Web 应用中嵌入文档、CAD 或 3D 预览，无需转换后端。
• 在没有苹果应用的平台上预览 Keynote、Pages 或 Numbers 文件。
• 在目录树中查找重复文件和相似照片。

快速上手

1. 1

   使用 npm 全局安装完整版 CLI

   npm install -g filens-cli
2. 2

   以 JSON 格式读取 PDF

   filens 'read "report.pdf" as json'
3. 3

   为文件生成离线浏览器预览

   filens preview report.pdf

使用前须知

• !Windows 和 Linux 原生运行仍待验证。
• !自然语言请求只能识别有限的一组意图。
• !完整版 CLI 内置 OCR 模型，安装体积约 31 MiB。

收录于专题

标签

常见问题

filens 是什么？

开源的本地文件预览与 Agent CLI，可读取、搜索、OCR 和预览 300 多种格式的文件。 filens 包含两个部分。Agent CLI 基于 Rust 开发，可在本地读取 PDF、Office 文档、表格、扫描件和图片，搜索目录及嵌套压缩包，提取带页面坐标的关键原文，查找重复文件和相似图片，并输出文本、JSON、Markdown、CSV 等格式。完整版内置基于 RapidOCR 的 OCR，轻量版可之后再添加。

filens 可以免费使用吗？用的什么许可证？

filens 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

filens 还在维护吗？

活跃维护中。filens 最近一次提交是在 2026年11月5日。

filens 适合用来做什么？

为 AI Agent 提供本地文档的原文、搜索结果和可引用的段落。 在 Web 应用中嵌入文档、CAD 或 3D 预览，无需转换后端。 在没有苹果应用的平台上预览 Keynote、Pages 或 Numbers 文件。 在目录树中查找重复文件和相似照片。

filens 怎么安装和运行？

使用 npm 全局安装完整版 CLI: npm install -g filens-cli 以 JSON 格式读取 PDF: filens 'read "report.pdf" as json' 为文件生成离线浏览器预览: filens preview report.pdf

在哪里获取 filens？

源代码和安装说明在 GitHub 上：https://github.com/IceWhaleTech/filens