状态徽章说明
AppPorts 使用胶囊形状的彩色徽章展示应用和数据目录的状态。部分徽章支持点击,可查看更详细的说明或处理建议。
应用状态徽章
链接状态
| 徽章 | 图标 | 颜色 | 含义 |
|---|---|---|---|
| 已链接 | link | 绿色 | 应用已迁移到外部存储,并已创建本地入口 |
| 锁定迁移 | lock.fill | 绿色 | 应用已链接且被 uchg 锁定,可防止自更新破坏外部副本 |
| 非锁定迁移 | lock.open | 橙色 | 应用已链接但未锁定,应用内更新可能删除或覆盖外部副本 |
| 部分链接 | link.badge.plus | 黄色 | 应用的部分组件已链接(如目录中的部分 .app) |
| 孤立链接 | link.badge.exclamationmark | 红色 | 外部存储上的应用已丢失,但本地入口仍存在 |
| 未链接 | externaldrive.badge.xmark | 橙色 | 应用位于外部存储,但尚未链接回本地 |
| 外部 | externaldrive | 橙色 | 外部存储上的应用,本地无入口 |
| 待迁出 | arrow.up.right.circle | 青色 | 本地真实应用版本高于外部存储中的同名旧副本,可迁出并替换外部旧版本 |
| 本地 | macmini | 次要色 | 普通本地应用,未迁移,无其他标签时显示 |
待迁出如何判断
AppPorts 会优先按 Bundle ID 匹配本地应用与外部应用,必要时再按规范化后的应用名称兜底。只有双方版本号可比较且本地版本更高时,才会显示「待迁出」。如果版本缺失、格式无法比较,或同名应用的 Bundle ID 不一致,AppPorts 会保持普通本地状态,避免误覆盖外部应用。
框架标签
| 徽章 | 图标 | 颜色 | 含义 | 点击说明 |
|---|---|---|---|---|
| Sparkle | arrow.triangle.2.circlepath | 青色 | 使用 Sparkle 框架自动更新 | 迁移到外部存储后,应用内更新可能导致外部副本丢失,建议使用锁定迁移 |
| Electron | atom | 靛蓝 | 基于 Electron 框架,可能支持自动更新 | 迁移到外部存储后,应用内更新可能导致外部副本丢失,建议使用锁定迁移 |
类型标签
| 徽章 | 图标 | 颜色 | 含义 |
|---|---|---|---|
| 运行中 | play.fill | 紫色 | 应用当前正在运行 |
| 系统 | lock.fill | 灰色 | macOS 系统应用 |
| 非原生 | iphone | 粉色 | iOS/iPadOS 应用(通过 Apple Silicon 运行) |
| 商店 | applelogo | 蓝色 | Mac App Store 应用 |
特殊标签
| 徽章 | 图标 | 颜色 | 含义 |
|---|---|---|---|
| 已重签名 | seal.fill | 青色 | 应用已被 Ad-hoc 重签名(迁移后出现「已损坏」时执行) |
商店标签的特殊说明
当应用满足以下条件时,「商店」标签可点击,并显示 macOS 15.1+ 原生外置安装说明:
- 应用位于外部存储的
/Volumes/{drive}/Applications/目录。 - 应用由 macOS 原生管理,App Store 可直接在该目录中执行增量更新。
数据目录状态徽章
| 状态 | 颜色 | 含义 |
|---|---|---|
| 本地 | 次要色 | 目录在本地存储,未迁移 |
| 已链接 | 绿色 | 已迁移到外部存储,本地为符号链接 |
| 待规范 | 黄色 | AppPorts 已托管该链接,但外部路径不在规范位置,建议执行「规范化」操作 |
| 待接回 | 橙色 | 外部存储上的数据仍在,但本地符号链接已丢失,建议执行「重新链接」操作 |
| 现有软链 | 蓝色 | 非 AppPorts 创建的用户自定义符号链接,可选择接管管理权 |
应用状态组合示例
一个应用可能同时显示多个徽章:
text
[已链接] [Sparkle] [运行中]含义:应用已迁移到外部存储,使用 Sparkle 自动更新框架,并且当前正在运行。
text
[外部] [商店] [非原生]含义:外部存储上的 iOS 应用(Mac 版),由 App Store 安装。
text
[孤立链接]含义:外部存储上的应用已丢失或被移除,但本地仍保留入口,需要手动解除链接。
text
[待迁出]含义:本地存在新版真实应用,外部存储中仍是旧副本。可重新执行迁移,将本地新版迁出并替换外部旧版本。
