需求拆解
用户在 Finder 中选中文件或文件夹后按空格，应用需要快速识别类型、读取必要信息，并生成只读预览界面。
Quick Look 扩展
Quick Preview 的实现思路
Quick Preview 扩展 Finder 的空格预览体验。开发重点是把文件夹、压缩包和 Markdown 等内容转成清晰的只读预览，同时遵守 macOS 沙盒和 Quick Look 扩展的生命周期。
技术方案
项目使用 Swift、SwiftUI 和 Quick Look Extension。预览入口由 QLPreviewingController 承接，再把数据交给 SwiftUI 视图展示。
实现边界
只在用户主动触发预览时读取本地内容，不上传文件，不提供评论、分享、发布或云端转换服务。
主要模块
- 文件识别：区分文件夹、Markdown、压缩包等预览类型，避免无关文件进入错误流程。
- 权限处理：使用安全作用域访问读取用户选择的本地文件，预览结束后释放资源。
- 渲染层：使用 SwiftUI 组件展示目录结构、文本内容和文件元信息。
- 诊断层：记录预览成功、失败和加载耗时，便于排查扩展生命周期问题。
