# file-lens

**Repository Path**: lifedever/file-lens

## Basic Information

- **Project Name**: file-lens
- **Description**: Non-destructive view layer for any folder on macOS · macOS 文件夹的非破坏性视图层
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileLens

<div align="center">

<img src="icons/icon.png" width="220" alt="FileLens" />

### FileLens

**只看不动你的文件。**
给 macOS 任意文件夹加一层标签分组视图，原文件始终保持原位。

![Latest](https://img.shields.io/github/v/release/lifedever/file-lens?label=Latest&color=brightgreen&style=flat-square)
![platform](https://img.shields.io/badge/platform-macOS%2014%2B-blue?style=flat-square)
![license](https://img.shields.io/badge/license-MIT-green?style=flat-square)
![stars](https://img.shields.io/github/stars/lifedever/file-lens?style=flat-square)

[⬇ **下载最新版**](https://github.com/lifedever/FileLens/releases/latest) | [💖 **赞助**](https://www.lifedever.com)

[English](README.md)

---

</div>

## FileLens 是什么？

你的 `~/Downloads` 里堆了几百个 `.dmg`、截图、PDF，长期未整理。同类工具大致两种思路：物理搬运型（Hazel，规则配置出错时回滚困难）、或者功能太弱（Finder 智能文件夹只能搜索，无法成体系地分组）。

**FileLens 不移动文件，仅在 App 内为每个文件打标签，按你定义的维度（类型 / 文件名 / 大小 / 时间）分组展示。** 原文件始终位于原始路径，不会被移动、重命名或修改。FileLens 唯一会触发的物理文件操作是"移到废纸篓"，且仅在你主动点击时执行。

<p align="center">
  <img src="web/screenshot-3.png" alt="FileLens 截图" width="800">
</p>

## 功能特性

- 🏷 **自动打标签** —— 14 条内置规则（文件夹 / 安装包 / 图片 / 截图 / 大文件 / 长期未动……）+ 自定义规则
- 📁 **多文件夹** —— 监听任意多个文件夹，每个文件夹有独立规则集；右键文件夹可单独设置递归 / 深度 / 排除项
- ⚡ **FSEvents 实时更新** —— 新下载的文件立刻出现并自动打标签
- 🔍 **两种视图** —— 图标（⌘1，右下角滑块调大小）、列表（⌘2，按时间自动分组）
- 👁 **原生交互** —— 快速预览（Space）、拖出、在 Finder 中显示（⌘R）、移到废纸篓（⌘⌫）
- 🎨 **原生 macOS 体验** —— 系统文件图标、与 Finder 对齐的快捷键、浅色 / 深色 / 跟随系统
- 🌐 **中英双语**开箱即用
- 🛡 **非破坏性承诺** —— 任何规则都不会移动、重命名、修改你的文件

## 安装

[**↓ 下载最新版 DMG**](https://github.com/lifedever/FileLens/releases/latest)

| Mac | 下载文件 |
|---|---|
| Apple Silicon（M1/M2/M3/M4） | `FileLens-X.Y.Z-arm64.dmg` |
| Intel | `FileLens-X.Y.Z-x86_64.dmg` |

把 `FileLens.app` 拖进 `/Applications`。因为是 ad-hoc 开发签名，首次打开 macOS 可能提示"应用已损坏"。一次性修复：

```bash
sudo xattr -rd com.apple.quarantine /Applications/FileLens.app
```

之后从启动台正常打开即可。

## 快捷键

| 操作 | 快捷键 |
|---|---|
| 快速预览 | `Space` |
| 用默认 App 打开 | `⌘↩` |
| 在 Finder 中显示 | `⌘R` |
| 移到废纸篓 | `⌘⌫` |
| 切换详情栏 | `⌘I` |
| 搜索 | `⌘F` |
| 切换视图（图标 / 列表） | `⌘1` / `⌘2` |
| 设置 | `⌘,` |

## 自己编译

环境：macOS 14+、Xcode 15+、[xcodegen](https://github.com/yonaskolb/XcodeGen)、[librsvg](https://gitlab.gnome.org/GNOME/librsvg)。

```bash
brew install xcodegen librsvg
git clone https://github.com/lifedever/FileLens.git
cd file-lens
xcodegen generate
./Scripts/dev.sh                       # Debug 编译并打开
./Scripts/release.sh 0.1.0 arm64       # 打 Release DMG（或 x86_64 / universal）
```

## 技术栈

macOS 14+ · SwiftUI + AppKit · SwiftData · QuickLookThumbnailing · FSEvents

## License

[MIT](LICENSE) © lifedever

---

## ☕ 捐助

如果 FileLens 为你节省了时间，欢迎请杯咖啡支持继续迭代：

- **赞助 / 捐赠**：<https://www.lifedever.com>
- **支付宝 / 微信**：见仓库主页二维码

或者直接为仓库点 ⭐，对独立开发者是不小的鼓励。