常见问题
安装与授权
AppPorts 需要什么权限？
AppPorts 需要完全磁盘访问权限来读取和修改 /Applications 目录。首次启动时会引导授权，也可在系统设置 → 隐私与安全性 → 完全磁盘访问权限中手动添加。
支持哪些 macOS 版本？
最低支持 macOS 12.0 (Monterey)。macOS 15.1（Sequoia）及以上版本额外支持 App Store 应用安装到外置硬盘并原地更新。
应用迁移
迁移后应用打不开怎么办？
- 确认外部存储已连接且可访问
- 检查应用状态徽章：如果是「孤立链接」，说明外部应用已丢失，需手动解除链接
- 如果出现「已损坏」提示，右键点击应用选择「重签名」
- 如果仍无法解决，在外部应用库中选择「迁回本地」
出现「已损坏」提示怎么办？
macOS 的代码签名机制检测到应用包结构变更。解决方法：
- 在 AppPorts 中右键点击应用
- 选择「重签名」
- AppPorts 会自动备份原始签名并执行 Ad-hoc 重签名
详细机制请参阅重签名与崩溃防护。
外部存储拔掉后应用会不会崩溃？
本地入口（Stub Portal）会尝试调用 open 打开外部应用。如果外部存储未连接，应用无法启动，但不会崩溃。重新连接外部存储后即可正常使用。
迁移后能不能更新应用？
取决于应用类型：
| 应用类型 | 能否自动更新 | 说明 |
|---|---|---|
| 原生应用（无自更新） | ✓ | 正常更新 |
| Chrome、Edge（自定义更新器） | ✓ | 更新安装到本地，AppPorts 检测到版本差异后标记「待迁移」 |
| Sparkle / Electron 应用 | ✗ | 锁定后阻止应用内更新，需通过 AppPorts 迁回本地后更新 |
| App Store 应用（macOS 15.1+） | ✓ | App Store 可在外置硬盘原地更新 |
| App Store 应用（macOS <15.1） | ✗ | 需手动二次迁移 |
App Store 应用怎么迁移到外置硬盘？
macOS 15.1+：在 App Store 设置中开启「下载并安装大型 App 到独立存储盘」，选择与 AppPorts 相同的外置存储。
macOS <15.1：在 AppPorts 设置中开启「App Store 应用迁移」，手动迁移后应用更新需二次迁移。
迁移速度慢/卡住怎么办？
- 迁移至 100% 时可能会停顿一至两秒，这是在创建本地入口
- 大型应用（如 Xcode、Adobe）迁移时间较长属于正常
- 如果长时间卡住，检查外部存储连接是否稳定
- USB 2.0 接口速度较慢，建议使用 USB 3.0 及以上或 Thunderbolt
数据目录迁移
数据目录迁移后应用数据会不会丢失？
不会。AppPorts 采用符号链接策略：先将数据完整复制到外部存储，确认复制成功后才删除本地原始目录。任何步骤失败都会自动回滚。
什么情况下数据目录迁移可能导致应用异常？
- 使用文件锁或 SQLite WAL 日志的应用
- 跨符号链接时扩展属性可能丢失
- 同一 Team 下多应用共享的 Group Containers 目录
如何恢复迁移的数据目录？
在 AppPorts 的数据目录管理界面，选择已迁移的目录，点击「恢复」即可。AppPorts 会删除符号链接，将数据从外部存储复制回本地。
其他
AppPorts 会收集我的数据吗？
不会。AppPorts 完全离线运行，不收集、不上传任何用户数据。日志文件保存在本地 ~/Library/Application Support/AppPorts/ 目录下。
如何反馈问题？
请在项目 Issues 页面提交。建议附带诊断包（菜单栏 → 日志 → 导出诊断包）以加快问题定位。