WTM：macOS 本地大模型文件清单工具

WTM（What the Model）是一款 macOS 原生应用，专门用于盘点本地存储的大语言模型文件。它能识别已安装的模型、定位文件路径、统计磁盘占用、检查下载是否完整，并按来源（provider）归类元数据。

当前能力范围

• Ollama manifest 与 blob 清单
• Hugging Face 模型缓存与未完成下载识别
• 在用户选定目录中保守扫描 GGUF 与 Safetensors 文件
• 对 MLX-LM 存储进行结构化校验，仅在用户明确授权的目录中进行，不安装 MLX 运行时
• 每次启动从 provider 文件重建内存中的归一化清单
• 提供搜索、按来源/状态过滤、本地文件详情与 Finder 定位
• 支持多模型清理预览，标注依赖保留、冲突与保守的回收估算
• 支持 macOS 废纸篓手动删除，以及 Hugging Face 文件与 Ollama API 删除
• 阻止被占用或正在加载的模型，清理后做定向重扫，并保留可清除的本地审计记录

安全与权限设计

• 扫描前需用户对每个来源单独授权
• 与官方 GitHub Releases 进行每周一次隐私友好的版本比对，但不自动安装更新、不打开 shell、不自动化 Terminal、不下载模型
• 应用本体执行严格隔离：未签名的 llama.cpp 启动需身份绑定审批；停止操作仅作用于 WTM 自身进程
• 日志在应用内脱敏；运行时工具定义采用 schema 校验，默认禁用导入，导出内容已脱敏
• 菜单栏提供被动状态显示，独立于「登录时启动」开关

安装与构建

应用要求 macOS 15 及以上、Apple Silicon。可从 GitHub Releases 下载对应 DMG，并通过同目录下的 sha256 校验文件验证签名后拖入 Applications。项目同时准备了 Homebrew Cask 的 tap 配置，发布后可通过 brew install --cask wtm 安装，但当前仍以手动安装为主。开发构建需 Xcode 26.3 及 Swift 6，签名与 Apple Developer Team ID 通过本地 .env.local 配置，且不会被纳入 Git。

发布与扩展

稳定版仅通过精确的 vMAJOR.MINOR.PATCH tag 在受保护的 release Environment 中生成，工作流会完成签名、公证、装订、挂载与复制后再发布到 GitHub Release。应用每周至多校验一次官方稳定通道，下载仍指向 GitHub Release 页面，安装保持手动。若要新增 provider 或工具，需先阅读公开的扩展指南与适配器指南，数据定义与编译适配器的能力与审核要求不同。

项目以 Apache License 2.0 开源，测试用 fixture 为占位数据，不含任何模型权重。