TreeFinder

TreeFinder 是一个 macOS 原生 SwiftUI 文件管理器。它不是网页应用，不需要本地 Web 服务。

构建

./scripts/build-macos.sh

构建产物：

build/TreeFinder.app

运行

open build/TreeFinder.app

应用默认打开当前用户的 Home 目录，也可以在顶部工具栏选择新的根目录。

已支持

• 左侧树状展开目录
• 多 Tab 浏览，每个 Tab 保留自己的路径、搜索、视图和预览状态
• 中央列表 / 网格视图
• 常见文件类型使用不同图标与颜色区分，常见编程语言使用语言 logo 风格徽标
• 顶部地址栏支持输入绝对路径跳转，也支持上一级、回根目录、刷新
• 当前目录递归搜索
• 显示 / 隐藏隐藏文件
• 新建文件夹、新建文件、重命名
• 删除移动到 macOS 废纸篓
• 文本、图片、音频与视频预览
• 在 Finder 中显示选中项目
• 构建时自动生成 macOS 高质感 .icns 应用图标
• 右键文件夹可用 Open with CLI 启动 claude、codex、coco
• CLI 会在外部终端中运行：默认优先 iTerm2，没有 iTerm2 时使用系统 Terminal，也可以在菜单中显式选择
• CLI 启动时会通过登录交互式 zsh 加载用户 shell 环境，避免 GUI App 缺少终端 PATH 导致命令找不到
• TUI 交互、字体、全屏、快捷键、输入法等能力由 iTerm2 / Terminal 原生提供

快捷键

• Command + T：新建 Tab
• Command + W：关闭当前 Tab
• Command + ← / →：切换上一个 / 下一个 Tab，支持首尾循环
• Command + N：新建文件
• Command + Shift + N：新建文件夹
• Command + O：打开选中项目
• Command + Return：重命名
• Command + Delete：移到废纸篓
• Command + R：刷新
• Command + Option + R：在 Finder 中显示
• ↑ / ↓：在中间区域移动选择
• ←：返回上一级
• →：进入选中的文件夹

预览性能

单击文件只会选中并展示基础信息，不会自动读取内容。需要查看内容时，点击右侧详情面板的「预览」按钮；文本文件会异步、分块读取首段内容，并对常见编程语言、JSON、YAML、Markdown、HTML、CSS 等做轻量语法高亮。图片会在详情面板内展示；音频与视频使用系统 AVKit 播放器预览，优先支持 macOS 原生音视频格式。双击、右键菜单或 Command + O 才会真正打开文件。