更新日志
按版本查阅变化；已停用功能另有历史归档。
这里记录各版本当时的变化。历史条目中的功能可能已经停用，不应直接当作当前操作步骤。 当前正文按 2.0.0（build 50）整理；旧功能的行为、版本和替代方法保存在历史功能归档。
v2.0.0
以下依据当前 2.0.0 build 50 的代码与界面整理；版本号不代表已在下载渠道发布。
- 微信账号支持全部迁移或仅媒体拆分迁移，数据库与配置可保留本机；切换方式前需完整还原。
- 支持加密 APFS 目标，为新数据卷独立设置密码，可选保存到本机钥匙串；未保存时需手动解锁。
- 增加外盘应用索引排除与大小缓存刷新，减少重复搜索入口，并能核对缓存时间。
- 新增“任务中心”，统一查看应用、数据、工具和自选目录任务，支持加入后台、暂停、继续、取消及历史管理；资源冲突的任务排队处理。
- 总体进度改为包含各阶段的估算，当前目录单独显示准备、扫描、复制、校验、切换和收尾；多目录任务不再用总体百分比代替当前阶段。
- 异常处理区分重试、稍后处理和保留旧副本；应用异常另提供明确确认的结束任务及不做内容校验的强制回迁。
- 新增整块外置盘弹出入口，先暂停自动挂载再请求 Finder 弹出；重新插入设备后恢复自动挂载。
- 数据迁移或迁回期间，更新后的原生 macOS 启动入口会提示等待，减少误打开；不能覆盖直接启动真实应用等其他方式。
- 目标盘能力提示说明无法保存的应用文件属性，可从提示打开对应帮助页；普通应用与容器挂载迁移的存储要求分别说明。
- 调整数据扫描和小文件复制的并发读取，保留内容校验、入口切换前检查与安全清理；不承诺所有存储上的固定提速。
- 延续迁移与手动签名分离、外盘保存官方原包，以及所有系统停用登录自动重签的方式；补齐新增界面的多语言提示。
操作说明：任务中心 · 异常恢复 · 弹出外盘 · 启动保护
v1.9.1（开发阶段记录）
以下保留此前 1.9.1 build 31 开发阶段的变更记录，这些行为已由 2.0.0 延续：
- 应用数据列表默认隐藏不可迁移的锁定结构，可打开“显示锁定目录结构”查看原因；状态统计支持筛选，个人目录快捷入口单独标识，不再计入应用数据大小或提供迁移操作。
- 迁移进度分别显示准备、复制、校验和收尾等阶段。复制百分比到达 100% 后，仍需等待整次操作完成；长时间没有进展时会显示最后活动信息。
- 数据迁移与手动重签名分开，迁移不再自动附带签名操作。
- 手动重签前的完整官方原包自动保存到外盘可见的
AppPorts Backups文件夹，附中英文说明；无需选择新位置，没有合适外盘时在修改正式应用前停止。内盘应用操作时仍需临时空间。 - 旧内盘有效原包在条件满足时自动迁出，冗余原包和失效旧记录按核验结果清理；仍有恢复价值或来源不明的材料继续保留，外盘离线不视为备份丢失。
- 签名菜单随状态变化：已重签的应用保留“恢复原始签名”，隐藏重复重签入口；恢复官方状态后重新显示符合条件的重签操作。
- 所有 macOS 版本停用开机自动重签名，并移除常驻设置卡。打开 AppPorts 时处理旧登录任务，仅清理失败时显示重试。
- 加强复制核验和容器结构保护，在切换或清理前再次检查数据状态。
- 保留经核对的原始应用恢复材料，区分“签名已替换”与“签名待检查”，通过修复面板处理旧迁移。
- 修复官方原包验签失败后仍可能继续重签的问题；校验失败或超时会停止。改进签名中断后的恢复，避免已撤回的操作被后台继续提交，或对已完成操作重复重签。
相关内容：迁移数据 · 签名原包 · 升级与修复 · 旧版自动签名归档
v1.9.0
- 容器数据默认采用挂载迁移：符合条件的数据进入未加密 APFS 专用卷，接到原目录，保留应用签名。
- 默认限制沙盒应用重签，保留需要确认风险的经典模式，并提供旧签名检查、完整备份与修复入口。
- 增加准备情况和迁移前检查，说明权限、安装位置、外盘格式、加密及空间要求。
- 改善登录和插盘后的数据接回，核对真实挂载位置；等待时间仍取决于磁盘和系统授权。
- 完善还原、备份和清理失败后的处理，改进数据目录树、行内操作、弹窗、本地化及项目支持入口。
- 当时在 macOS 27 上停用登录自动重签；1.9.1 开发版进一步在所有系统停用。
查看 v1.9.0 发布。当时保留的迁移后重签与早期登录任务行为现已归入历史功能说明。
v1.8.0
新功能
- 新增自定义本地扫描目录：「Mac 本地应用」标题栏新增「+」按钮，可添加额外的本地应用扫描目录。适用于 JetBrains Toolbox、Steam 等将应用安装在非
/Applications目录的工具。添加的目录会持久保存，并自动监控文件变化（#48）。 - 新增 Stub Portal 版本自动同步：外置硬盘上的应用通过 App Store 更新后，本地 Stub Portal 的版本信息会自动同步更新，并刷新 macOS Launch Services 缓存，「打开方式」菜单不再显示旧版本号（#50）。
- 新增工具目录识别：支持 Gradle（
~/.gradle）、Android 开发数据（~/.android）和 Flutter/Dart Pub 缓存（~/.pub-cache）（#49）。 - 新增目录迁移：可在「目录迁移」标签中添加任意用户文件夹，将大型项目、模型、素材库或工具缓存迁移到外部存储，并支持接回和还原（#54）。
- 新增受保护应用迁移预警：迁移 App Store 应用或 root 归属应用前，会提示这类应用可能因权限不足无法自动删除或替换，并建议先通过 Finder 手动迁移后再创建链接（#55）。
改进
- 应用扫描性能优化：每个应用的 Info.plist 读取次数从 7 次降低到 1 次（通过内存缓存），整体扫描速度显著提升。
- 扫描超时保护：codesign 子进程新增 10 秒超时，避免大型应用签名检查卡死导致扫描挂起。
- 目录体积计算安全上限：递归计算应用体积时新增 50 万文件数量上限，防止 Electron 等超大应用包无限遍历。
- 扫描过程可追踪：扫描循环新增逐应用 TRACE 日志，便于定位扫描卡在哪个应用。
- 数据目录扫描精准匹配：修复 bundle ID 后缀提取逻辑，过滤 app、com、org 等通用词汇，避免误匹配系统容器目录导致扫描变慢。
- 工具目录接回检测更完整：本地工具目录缺失但外部存储规范位置仍有受管目录时，会显示「待接回」；切换外部存储会自动刷新工具目录状态。
- 本地化与无障碍完善：应用/数据目录/自定义目录状态、排序与筛选标签、设置开关和状态徽章会更稳定地跟随当前语言，并提供更明确的辅助功能标签。
- 应用体积改为会话级缓存，减少刷新后重新显示「计算中」或体积丢失的情况（#55）。
- 数据目录迁移回滚更安全：创建链接前先把本地源目录改名为隐藏安全备份；创建链接或清理备份失败时会尽量保留本地备份和外部副本，避免两端数据同时丢失（#54）。
修复
- 修复 Trae 等应用扫描极慢的问题 — bundle ID 中的通用后缀
app导致~/Library/Containers/下大量不相关目录被误扫描。 - 修复外置硬盘应用通过 App Store 更新后，本地 Stub Portal 版本信息不更新、「打开方式」菜单显示旧版本的问题。
- 修复点击刷新按钮不会触发 Stub Portal 版本同步的问题。
- 修复数据目录接回或规范化时可能把外部普通文件当作目录处理的问题；现在会拒绝普通文件并保留原文件。
- 修复多行弹窗正文在部分语言下回退显示中文的问题，并补全俄语界面翻译；Stub Portal 的「外部存储未连接」系统弹窗也会按系统语言显示（#55）。
v1.7.0
新功能
- 新增「待迁出」状态：当本地真实应用版本高于外部存储中的同名应用时，AppPorts 会标记为「待迁出」，提示可将本地新版迁移到外部存储并替换旧副本。
- 新增数据迁移重签名确认：迁移应用容器内数据前，可选择是否在迁移完成后自动对关联应用执行 Ad-hoc 重签名，以降低容器数据迁移后应用无法识别数据、提示异常或启动异常的风险（#44）。 此处记录旧版行为，自动签名流程现已停用，见归档。
界面改进
- 顶部工具栏重排：应用页和数据目录页切换按钮改为更紧凑的图标 + 文本样式，减少空间占用。
- 数据目录页操作栏优化：「工具目录 / 应用数据」切换、迁移后重签名开关、恢复原始签名按钮和刷新按钮统一放入顶部工具栏。 此处记录旧版行为，自动签名流程现已停用，见归档。
- 应用状态徽章新增「待迁出」，方便识别本地版本高于外部旧副本、可以迁出替换的应用。
- 数据目录迁移重签名确认弹窗完成本地化，标题、正文和按钮会跟随当前语言显示。 此处记录旧版行为，自动签名流程现已停用，见归档。
改进
- 应用迁移安全策略增强：外部目标已存在时，仅在目标被识别为 AppPorts 管理的旧入口、旧迁移残留，或当前应用处于「待迁出」状态时，才会自动清理并继续迁移。
- 数据目录恢复校验增强：不再使用目录大小接近作为自动恢复依据，必须完整匹配 AppPorts metadata 后才会自动接回或恢复。
- 应用数据扫描更稳定：快速切换应用时，旧扫描任务结果不会覆盖当前选中应用的数据目录列表。
- 管理员命令和 AppleScript 转义增强：路径包含引号、反斜杠、空格或中文时，Finder 删除和管理员修复权限命令会更安全地处理。
- 本地化完善：修复切换语言后部分帮助内容、提示弹窗和数据迁移确认内容仍显示中文或翻译不完整的问题，并补齐所有支持语言的相关翻译（#43）。
修复
- 修复数据目录迁移可能将外部真实目录误判为可恢复目标的问题。
- 修复应用迁移时可能错误删除外部同名真实应用的问题。
- 修复外部旧 AppPorts portal / 旧迁移残留无法被稳定识别和清理的问题。
- 修复路径包含特殊字符时 AppleScript 或管理员命令可能构造错误的问题。
- 修复应用数据迁移流程中，后台迁移或迁移后重签名可能读取到已切换应用的问题。 此处记录旧版行为，自动签名流程现已停用，见归档。
- 修复「待迁出」状态未在应用列表中显示状态徽章的问题。
v1.6.2
- 新增：开机自动重签名功能。每次用户登录时，自动对签名已失效的已迁移应用执行 Ad-hoc 重签名，无需手动操作。默认开启，可在设置中关闭。 此处记录旧版行为，自动签名流程现已停用，见归档。
- 改进：Stub Portal 改用原生 Mach-O 二进制启动器替代旧版 bash 脚本，修复通过 Finder 双击关联文档无法打开外部应用的问题（#42）。
- 改进：优化关于页布局，内容区域改为可滚动布局，解决窗口尺寸不足时内容被截断的问题。
- 修复：原生 Stub Portal 被误识别为普通本地应用的问题。
- 修复：迁回本地时无法正确清理原生 Stub Portal 的问题。
- 修复：链接回本地时应用壳被当作完整应用处理的逻辑漏洞。
- 修复：AutoResignInstaller 安装失败时静默成功的问题。
v1.6.1
- 修复：数据目录迁移后的自动重签名现在会正确签名外部真实应用，而非本地壳（Stub Portal）。 此处记录旧版行为，自动签名流程现已停用，见归档。
- 修复：重签名和签名恢复操作现在会正确解析已链接应用的真实路径。
- 修复：已链接应用的「已重签名」状态检测现在能正确识别外部真实应用的签名状态。
- 优化：日志输出增加结构化错误码和关联路径信息。
v1.6.0
- 迁移后的应用不再显示快捷方式箭头角标。
- 自动更新应用迁移后，不再因更新破坏外部副本。
- 新增应用签名管理功能，解决迁移后出现「已损坏」提示的问题。
- 外部存储拔出后，应用列表会以红色状态提示「孤立链接」。
- macOS 15.1+ 用户可直接将 App Store 应用安装到外部存储。
- 数据目录迁移更安全：防止误迁移系统目录，中断后可自动恢复。
- 扫描和大小计算更快，列表不再反复跳动。
- 复制文件到外部存储更稳定，不再因中断报错。
- 应用状态标签重新设计，信息更丰富，点击可查看详情。
- 应用列表刷新后不再丢失选中状态，数据目录支持树形展示。
- 优化界面细节，包括搜索、排序、分组卡片和图标加载等。
- 新增火星文语言选项。
- 更新自动化测试。
v1.5.5
- 支持 macOS 12 及以上的操作系统
- 新增火星文语言
v1.5.0
- 新增 macOS 15.1+ App Store 应用外置安装支持
- 新增自动重签名功能（数据目录迁移后自动执行） 此处记录旧版行为，自动签名流程现已停用，见归档。
- 新增
LocalizationAuditTests本地化审计测试 - 改进 Stub Portal 的 Info.plist 生成逻辑
- 修复部分应用迁移后 Launchpad 图标丢失的问题
v1.4.0
- 新增数据目录树形视图
- 新增工具目录识别（30+ 种开发工具）
- 新增诊断包导出功能
- 改进自更新检测（Chrome、Edge 等自定义更新器）
- 修复迁移中断后的自动恢复机制
v1.3.0
- 新增数据目录迁移功能
- 新增代码签名管理（备份/恢复原始签名）
- 新增 Sparkle 和 Electron 应用自动检测
- 改进锁定迁移保护（
chflags uchg） - 修复 Finder 中角标显示问题
v1.2.0
- 新增 Stub Portal 迁移策略（替代 Deep Contents Wrapper）
- 新增 iOS 应用迁移支持（Mac 版 iOS 应用）
- 改进批量迁移性能
- 修复部分应用还原后无法启动的问题
v1.1.0
- 新增多语言支持（20+ 种语言）
- 新增应用套件目录迁移（如 Microsoft Office）
- 改进外部存储离线检测
- 修复 Deep Contents Wrapper 策略的符号链接穿透问题
v1.0.0
- 首个正式版本
- 支持应用迁移至外部存储（Deep Contents Wrapper / Whole App Symlink）
- 支持应用还原和链接管理
- 支持 FolderMonitor 实时监控文件系统变化