Skip to content

状态徽章说明

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 会保持普通本地状态,避免误覆盖外部应用。

框架标签

徽章图标颜色含义点击说明
Sparklearrow.triangle.2.circlepath青色使用 Sparkle 框架自动更新迁移到外部存储后,应用内更新可能导致外部副本丢失,建议使用锁定迁移
Electronatom靛蓝基于 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
[待迁出]

含义:本地存在新版真实应用,外部存储中仍是旧副本。可重新执行迁移,将本地新版迁出并替换外部旧版本。

最近更新