状态徽章说明

AppPorts 通过胶囊形状的彩色徽章显示应用和数据目录的当前状态。点击部分徽章可查看详细说明。

应用状态徽章

链接状态

徽章	图标	颜色	含义
已链接	link	绿色	应用已迁移到外部存储并创建了本地入口
锁定迁移	lock.fill	绿色	已链接且被 uchg 锁定，防止自更新破坏外部应用
非锁定迁移	lock.open	橙色	已链接但未锁定，应用内更新可能删除外部应用
部分链接	link.badge.plus	黄色	应用的部分组件已链接（如目录中的部分 .app）
孤立链接	link.badge.exclamationmark	红色	外部存储上的应用已丢失，但本地入口仍存在
未链接	externaldrive.badge.xmark	橙色	应用在外部存储但未链接回本地
外部	externaldrive	橙色	外部存储上的应用，本地无入口
本地	macmini	次要色	普通本地应用，未迁移，无其他标签时显示

框架标签

徽章	图标	颜色	含义	点击说明
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 创建的用户自定义符号链接，可选择接管管理权

应用状态组合示例

一个应用可能同时显示多个徽章：

[已链接] [Sparkle] [运行中]

含义：应用已迁移到外部存储，使用 Sparkle 自动更新框架，当前正在运行。

[外部] [商店] [非原生]

含义：外部存储上的 iOS 应用（Mac 版），由 App Store 安装。

[孤立链接]

含义：外部存储上的应用已丢失或被移除，但本地仍保留入口。需要手动解除链接。