FileAssistant

FileAssistant 是一款 macOS 菜单栏应用程序，旨在帮助用户快速分析文件内容，判断文件是否可以安全删除，提升文件管理效率。通过结合本地指纹分析、网络搜索和AI智能分析，为用户提供全面的文件信息和建议。

演示和教程视频

https://www.bilibili.com/video/BV1DV8C67E4C/

主要功能

1. 智能文件分析

• 本地指纹收集：获取文件的详细信息，包括文件类型、大小、UTI、下载来源、所属应用等
• 网络搜索：使用必应搜索引擎查找文件相关信息
• AI分析：通过GLM大语言模型提供智能分析，判断文件用途和是否可删除
• 本地规则库：基于内置规则快速判断常见文件类型

2. 文件夹分析

• 递归扫描：智能扫描文件夹内容，支持深度限制
• 统计信息：显示文件类型分布、大小统计
• 风险评估：为每个文件/文件夹提供风险等级和删除建议
• 交互式界面：可展开/折叠文件夹，查看详细分析

3. 用户界面

• 菜单栏应用：不占Dock空间，轻量运行
• 分析窗口：显示详细的文件分析结果
• 设置窗口：配置API Key和其他参数
• 多窗口支持：同时分析多个文件

4. 快速操作

• 右键菜单：在Finder中右键文件选择"用FileAssistant分析"
• URL Scheme：支持 fileassistant:// 协议，可与其他应用集成
• 批量分析：支持多文件同时分析

技术架构

核心组件

• AppDelegate：应用程序委托，管理菜单栏、网络监测和窗口
• FingerprintCollector：收集文件的本地指纹信息
• Crawler：网络爬虫，使用必应搜索文件相关信息
• GLMClient：与智谱AI API通信的客户端
• Analyzer：整合本地指纹、网络搜索和AI分析结果
• RuleBase：本地规则库，快速判断文件类型
• FolderAnalyzer：文件夹分析引擎

技术特点

• 本地处理优先：所有文件分析在本地完成，保护用户隐私
• 智能缓存：避免重复分析，提高响应速度
• 流式响应：实时显示AI分析结果
• 模块化设计：清晰的代码结构，易于维护和扩展

兼容性

• 操作系统: macOS 13.0 及以上版本
• 架构: Apple Silicon (M1/M2/M3) 和 Intel Mac
• 内存: 最少 512MB 可用内存
• 磁盘空间: 约 10MB 安装空间

安装和使用

安装步骤

1. 下载并构建应用

   # 克隆仓库（如果适用）
   # 或者下载源代码包
   
   # 构建应用
   ./build.sh

2. 安装应用

   ./install.sh

3. 配置 API Key

   • 在菜单栏中找到 FileAssistant 图标
   • 点击图标并选择"设置…"
   • 填入您的智谱 API Key（免费注册获取）

使用方法

基本使用

1. 点击菜单栏中的 FileAssistant 图标
2. 选择"选择文件进行分析…"或"分析文件夹"
3. 查看分析结果，了解文件用途和是否可删除

快速操作

1. 在 Finder 中选择文件
2. 右键点击选择"用 FileAssistant 分析"
3. 应用将自动分析文件并提供分析结果

文件夹分析

1. 在菜单栏中选择"分析文件夹"
2. 选择要分析的文件夹
3. 查看文件夹的详细分析报告，包括文件类型分布和删除建议

自行构建

环境准备

1. 安装 Xcode 命令行工具

   xcode-select --install

2. 获取源代码

   # 克隆仓库
   git clone <repository-url>
   cd FileAssistant

构建步骤

1. 执行构建脚本

   ./build.sh

   此脚本将自动：

   • 检查系统版本兼容性
   • 验证 Swift 编译器可用性
   • 选择适当的 macOS SDK
   • 编译主程序
   • 创建应用程序包结构
   • 签名应用程序

2. 构建产物

   • 构建完成后，应用程序将位于 build/FileAssistant.app
   • 可以通过 ./install.sh 安装到系统

自定义签名

如果需要使用自定义签名证书：

1. 创建开发者证书
2. 在构建脚本中修改 SIGN_ID 变量
3. 确保证书在钥匙串中可用

隐私和安全

数据安全

• 本地处理：所有文件分析均在本地设备完成，不会上传到服务器。AI仅帮助整理从Internet基于文件指纹相关性搜索到的信息，你的文件内容不会暴露。
• API Key 保护：API Key 仅在本地使用，不会传输或存储到第三方服务器
• 最小权限原则：应用仅请求必要的系统权限

权限说明

• 文件访问：仅在用户主动选择文件时读取文件内容，不会扫描整个系统
• 网络访问：仅用于与智谱 AI API 通信，传输必要的分析请求和结果
• 菜单栏权限：仅在菜单栏显示状态图标，不收集用户行为数据

数据收集

• 无遥测：应用不收集任何用户使用数据或遥测信息
• 无分析：不包含第三方分析或追踪代码
• 日志记录：本地错误日志仅用于调试，不会上传或共享

应用特性

• 轻量级：应用体积小，资源占用少
• 非侵入式：作为菜单栏应用运行，不影响系统正常使用
• 快速响应：优化的文件分析算法，提供即时反馈
• 智能缓存：避免重复分析，提高响应速度
• 多语言支持：使用Swift编写，支持macOS 13+系统

常见问题

Q: 应用无法启动？

• 检查系统版本是否符合要求（macOS 13.0+）
• 确认已正确安装 Xcode 命令行工具
• 尝试重新构建应用

Q: 文件分析不准确？

• 确保网络连接正常
• 检查 API Key 是否正确配置
• 尝试分析不同类型的文件进行对比

Q: 如何卸载应用？

• 直接从 /Applications 或 ~/Applications 删除 FileAssistant.app
• 清除相关配置文件（如有）

开发信息

• 开发语言: Swift
• 构建工具: Swift 编译器 + Xcode Command Line Tools
• 包格式: macOS .app 应用包
• 签名方式: Apple 代码签名

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

---

© 2026 HighspeedG2304. All rights reserved.