第 11 章：软件下载与安装指南¶

感谢您对 ATBCmder 的关注与支持！我们提供两种便捷的安装方式，满足不同的使用偏好与场景需求。

1. Mac App Store 商店版（推荐）¶

这是最推荐普通用户选择的安装方式。ATBCmder 现已正式上架 Mac App Store！ 通过官方商店下载，可享受全自动后台静默更新、原生 macOS 应用沙盒安全保护以及最深度的系统级整合。

• Mac App Store 官方下载：在 Mac App Store 中下载 ATBCmder

2. 独立 DMG 安装包下载¶

若您无法访问 Mac App Store，或偏好直接使用独立分发版本，我们同时提供支持 Universal 双架构（Apple Silicon ARM64 与 Intel x86_64）原生构建的 DMG 磁盘映像安装包。

• DMG 安装包直接下载：点击下载最新版 ATBCmder DMG 镜像（Universal 通用双架构：Apple Silicon 与 Intel x86_64）

注意：通过 DMG 首次打开应用时，macOS 安全机制可能会提示“无法打开或未验证的应用”。只需前往 系统设置 > 隐私与安全性，点击“仍要打开”即可正常运行。

⚠️ 授予“完全磁盘访问权限”¶

ATBCmder 作为专业级双面板文件管理器，需要访问并管理您的全盘文件。为保证全部功能顺畅运行，请按照以下步骤授予权限：

1. 点击屏幕左上角 Apple 图标（），打开 系统设置（较早的 macOS 版本中为“系统偏好设置”）。
2. 在左侧或主菜单中找到并点击 隐私与安全性。
3. 向下滚动列表，点击进入 完全磁盘访问权限（Full Disk Access）。
4. 在应用列表中找到 ATBCmder 并打开右侧开关。若列表中未显示，可点击下方的 + 号按钮手动添加 。
5. 系统将提示您输入 Mac 登录密码或轻触 Touch ID 确认更改。

3. 版本更新日志 (Release Notes)¶

2.7.0 (2026-11-09)¶

• MacBook 触控板双指滑动历史导航：原生支持 MacBook 触控板双指横向滑动（Swipe Gesture）进行目录历史的“后退”与“前进”导航，具备智能防抖与位移阈值判定，带来丝滑顺畅的 macOS 原生级手势交互体验（Fixes #185, #195）
• 标签页锁定机制与相邻标签智能打开：全面对齐 Total Commander 标签锁定模式，支持“锁定此标签页（禁止改变目录）”与“锁定但允许更改目录（重置回锁定路径）”，并在标题栏以星号 * 标识（Fixes #180, #189）；新建标签页默认紧邻当前激活标签页插入打开，显著提升多路径并行操作效率（Fixes #177, #191）
• 拼音任意字符分界匹配与“仅显示匹配项”过滤模式：快速搜索拼音匹配引擎重大升级，支持在文件名的任意汉字边界处匹配拼音首字母及完整拼音，摆脱前缀匹配限制（Fixes #182, #194）；新增“仅显示匹配文件/目录”独立过滤模式选项，可在实时光标跳转与纯净过滤结果间自如切换（Fixes #178, #192）
• 显示菜单扩展与占用空间快捷键人体工学优化：“显示（Show）”菜单新增“显示所有文件 (Cmd+F10)”与“显示自定义文件/扩展名 (Cmd+F11)”命令（Fixes #181, #193）；将“计算占用空间”默认全局快捷键调整为更符合人体工程学和传统习惯的 Alt+Shift+Return，避免与系统热键冲突（Fixes #179, #196）
• App Store 沙盒云盘与终端调用安全加固：优化 OneDrive 及其他云盘在 macOS App Store 沙盒下的安全作用域书签（Security-Scoped Bookmarks）检测与授权流程（Fixes #187, #188）；沙盒环境下终端调用改为安全预填命令（Pre-fill）而不自动执行（Fixes #183, #190）；修复终端多窗口重复打开与 zsh 会话 touch 权限报错；修复打包时 Dock 图标回退问题并完善图标空值降级保护（Fixes #184, #186）

2.6.0 (2026-11-08)¶

• 语义化文件图标系统与共享单例缓存：全新设计精美的语义化 Lucide 图标集，涵盖代码、文档、媒体、数据、配置、压缩包等丰富文件类型（Fixes #166, #176）；引入高效的共享单例图标缓存机制，大幅降低高频滚动与大目录浏览时的内存与 CPU 负载，使文件面板在面对数万级文件时依然保持丝滑流畅
• 核心模块深度解耦重构与架构升级：彻底重构拆分单体庞大模块，将 fs_model.py 拆解为 fs_entry、fs_loaders、fs_icons，将 file_panel.py 拆解为表格视图、标签页及标签栏独立组件，将 main_window.py 拆解为 Mixin 扩展集，将目录同步对话框按组件解耦（Refs #130, Fixes #165, #175）；代码架构清晰度与可测试性大幅提升，彻底消除循环引用与隐式耦合
• 文件操作与数据安全防线全方位加固：全方位修复 CopyMoveWorker、StreamCopyWorker、ProcessIOEngine、NetworkTransferWorker 及提权辅助进程中的原子覆写、软链接移动防丢、同源/重叠路径覆盖校验及文件夹冲突保护（Fixes #109-#112, #122, #157, #159-#161, #170, #171）；文本编辑器采用临时文件加原子替换安全保存，归档解压前严格校验 7z/ZIP 软链接防止越界逃逸并避免覆盖目录崩溃（Fixes #164, #174）
• 全异步 UI 响应与极端场景性能优化：重型依赖与非关键模块改为惰性按需加载，启动性能显著跃升（Fixes #107）；面包屑导航、目录树加载、VFS 挂载及缩略图生成全部剥离至后台线程，彻底消除界面卡顿（Fixes #124, #126, #127, #150, #151）；目录大小计算器支持实时取消与精准计数（Fixes #158, #168），传输队列与进度弹窗支持 Esc 即刻中断退出（Fixes #163, #173）
• 视图模型一致性、选择保留与安全网络防护：排序、快速过滤与扁平视图切换时严格通过实体身份锚定并保留光标与选中状态，修复扁平视图软上限与导航失败历史回滚（Fixes #113, #114, #128, #162, #172）；敏感凭据安全存储防误擦除，防范 PBKDF2 资源耗尽与 OAuth 回调 XSS（Fixes #119-#121, #148）；SFTP 严格校验已知主机公钥（Fixes #117, #138），外部关联执行实施严格的 Shell 参数转义防命令注入（Fixes #115, #136）

2.5.0 (2026-11-05)¶

• 文本编辑器工具栏图标化重构与快捷键悬浮提示：文本编辑器（F4）顶部工具栏全面重构，将原本单调的纯文字按钮升级为现代精致的“矢量图标 + 语义 Tooltip”布局（Fixes #105, #106）；各功能按钮（保存、撤销、重做、查找、替换、编码切换等）在悬浮提示中清晰展示操作名称与键盘快捷键，大幅提升排版紧凑度与编辑效率
• 目录历史导航与标签栏菜单快捷键显式指引：文件面板“返回”与“前进”历史导航按钮 Tooltip 中显式标注对应的 Alt+Left 与 Alt+Right 键盘快捷键，并实现全量 31 种语言本地化；路径标签栏右键上下文菜单各项常用操作（新建标签页、关闭标签页、关闭其他标签页、复制标签页等）右侧直观展示全局快捷键，引导用户无缝掌握全键盘流操作
• Python 解释器退出终结安全防护与防崩溃加固：在 Python 解释器退出终结阶段（sys.is_finalizing()）引入安全短路机制，避免在模块与 C 扩展释放过程中重复执行 QThread 后台线程等待、复活及事件过滤器注销逻辑；彻底杜绝关闭应用时偶发的 SIGABRT 或底层 C++ 对象提前销毁导致的致命异常
• 特权桥接系统清理进程扫描鲁棒性加固：优化应用进程与包元数据扫描判定逻辑，彻底防止单个权限受限或非标准应用 Bundle 导致整体进程状态误判，避免将闲置应用（Idle）误标为未知状态；放宽进程枚举与 Plist 解析超时时间，保障高负载与慢速磁盘环境下的清理可靠性

2.4.6 (2026-11-03)¶

• 系统状态与清理工具 App Store 沙盒深度适配：在严格受限的沙盒环境下，系统状态面板自动启用双模回退机制，通过 NSWorkspace 展现运行中的 GUI 应用程序，提供高保真图标与前台状态指示（Fixes #102, #104）；彻底解决沙盒下浏览器缓存深度目录遍历受阻与未知大小统计异常，准确累加已知容量并反馈真实清理状态（Fixes #101, #103）
• Finder 颜色标签规范化与 31 种语言深度本地化：引入标签规范化与本地化解析引擎（get_canonical_tag_name 与 localize_tag_name），准确剥离系统内部序号；在全量 31 种语言中完整编译收录 macOS 7 种标准色彩标签（红、橙、黄、绿、蓝、紫、灰），文件面板标签列悬浮 Tooltip 智能展示对应语言的标准名称
• 文件面板批量反选与搜索交互细节打磨：支持按住 Shift 键点击连续反选/取消选中文件，消除多选只能向外扩展的局限（Fixes #96, #99）；文件搜索对话框打开时默认自动聚焦文件名模式输入框，一键直达键盘检索（Fixes #94, #98）；修复搜索面板回车键二次触发打断检索的缺陷（Fixes #95, #97）；优化驱动器下拉框与 Tab 标签栏的布局间距
• CI/CD 构建与测试工作流现代化迁移：将 GitHub Actions 云端 macOS 测试与发布工作流运行器平滑升级至官方最新的 macos-latest，确保最新系统环境兼容与构建依赖链敏捷性，严格保留自托管 x86_64 验证矩阵

2.4.5 (2026-10-31)¶

• 未保存密码网络连接智能弹窗与会话凭据保持：全新内置网络认证对话框（NetworkPasswordDialog），支持密码明密文显隐切换与保存至系统钥匙串选项；增加凭据预检调度机制（resolve_or_prompt_network_credentials），在切换或导航至未保存密码的 SFTP / FTP / SMB / WebDAV 连接时智能拦截并弹窗引导输入，取消则安全回退；修复连接管理器保存配置时意外清空临时密码的问题，并在当前应用会话生命周期（VFSSessionCache）内安全保持凭据，免除重复输入
• 网络 VFS 虚拟面板全列点击排序与指示器双向同步：为 VfsTableModel 完整实现 sort() 排序方法，与本地文件列表对齐相同的列结构（名称、扩展名、大小、修改时间、属性），确保网络目录在排序时始终置顶；开启表头列点击排序手势（sectionsClickable），并使表头排序箭头与主菜单及快捷键排序命令保持双向实时同步
• 网络连接架构全面安全审计、错误处理与高级设置：彻底消除 VFSSessionCache.disconnect 与 VFSManager.remove_from_cache 在断开连接重入时的相互递归隐患；WebDAV 流式上传显式补全 Content-Length 请求头，保障 HTTP 响应安全关闭并在取消时主动清理临时未完成文件；加固下载、上传、删除与 Samba 挂载工作线程的状态校验与异常上下文保留；标准化网络连接配置中的高级选项（SSL/TLS 证书校验、被动模式 PASV 等），全量同步更新 31 种语言本地化字典

2.4.4 (2026-10-31)¶

• QThread 后台线程生命周期安全加固与 GC 崩溃防护：安装全局 QThread 生命周期安全防护（基于 PEP 442 对象复活机制），彻底消除后台线程（目录加载、路径探测、文件传输）在垃圾回收（GC）时因 C++ 对象提前销毁引发的 SIGABRT（QThread: Destroyed while thread is still running）致命崩溃；强化 FileSystemModel 等模块的退出清理流程（safe_qthread_cleanup），确保所有子线程安全退出
• macOS Carbon 免权限全局热键引擎与 Option 键规范化：重构 macOS 全局快捷键实现，全面切换为 Carbon RegisterEventHotKey 原生系统级 API，无需在系统设置中授予“辅助功能”（Accessibility）隐私权限即可开箱即用全局热键唤醒；彻底解决 Option 键（⌥）与系统死键、重音字符及特殊符号输入的手势冲突，规范修饰键映射并在设置中提供实时捕获与冲突检测
• macOS 打包程序坞（Dock）高清图标展示修复：修复打包为 .app 应用时在程序坞中图标边缘模糊发虚的问题；通过 AppKit 原生接口直接注入高保真图标资产，杜绝 Qt 内部优先降采样至低分辨率导致的画质损失
• macOS 12 (Monterey) 兼容性恢复与依赖约束优化：精细化调整 PySide6 依赖约束范围，严格恢复并锁定对 macOS 12 (Monterey) 的向下兼容支持，保障跨版本系统的平稳运行与纯净部署

2.4.3 (2026-10-30)¶

• 全新「最近更改文件」高级检索工具：全新内置「最近更改」系统工具与原生特权桥接指令，支持按时间跨度（1小时、24小时、7天、30天等）与最小文件大小过滤（>1MB、>10MB、>100MB、>1GB）；融合 macOS Spotlight 元数据引擎快速预热候选条目，检索结果支持实时筛选、双击或右键直达物理路径，并支持一键将选中文件批量移至废纸篓
• 剪贴板粘贴冲突安全重命名与云存储加固：粘贴文件或目录检测到同名冲突时自动追加序号后缀（如 name (1).ext）安全重命名，彻底杜绝数据意外覆盖（Fixes #92）；修复 Google Drive 虚拟驱动器探测数据丢失问题（Fixes #87, #91）；打包链路完整捆绑 Dropbox 云存储依赖库（Fixes #90）
• 全量 31 种语言本地化深度审计与专业术语统一：全面审计并精修全量 31 种语言翻译，彻底修复 PO 文件折行反斜杠转义与语法解析错误，根除残留机翻（Fixes #88, #93）；统一定义文件管理器专业术语并完善 Dropbox 等配置引导说明，重新编译全语言二进制 .mo 字典
• macOS 原生交互细节打磨与视觉精细化：全应用确认对话框按钮顺序统一遵循 macOS 规范（“是/确认”置于“否/取消”之前）；文件面板标签栏移除上下冗余发丝线，凸显卡片胶囊通透质感；修复 macOS Dock 图标因 Qt 降采样导致的模糊缺陷，增强表头列分割线对比度，修复文件加载线程退出的偶发竞态

2.4.2 (2026-10-26)¶

• 系统清理工具全面升级与按应用细粒度清理：全新支持按应用程序或按文件分类双维度清理系统缓存与日志，支持树状展开并自由勾选清理目标（Fixes #85）；分组大小精准累加并排除未知项，加入扫描权限预检与执行状态可视化反馈（已清理 0 B、失败原因及 Tooltip 提示）；工具栏与右键新增「在访达中显示」与「在面板中定位」快捷操作，支持双击直接定位物理路径；弹窗尺寸与磁盘空间分析器像素级对齐
• atbsys 特权桥接与文件系统度量安全加固：同步特权清理与应用卸载安全校验机制（Fixes #80），严格比对预定计划并保护个人与共享数据，沙盒环境下安全存储计划文件；加固磁盘占用统计与系统监测，完善硬链接、APFS 写时复制（CoW）克隆卷预检、CPU 采样与命令执行超时保护
• macOS 打包构建流程与跨架构验证加固：统一各模块版本号与构建元数据，锁定适配 macOS 12+ 的 Go 编译器与 Qt 运行时基线；修复 Universal 桥接二进制在 x86_64 宿主上的 Mach-O 切片验证逻辑，规避签名解析中的填充字节异常，构建或签名失败时严格熔断中断打包流程
• 文件面板交互增强与多语言界面精细润色：彻底修复删除文件或目录刷新后面板焦点与滚动条跳回顶部的缺陷（Fixes #81, #82），智能就近顺移焦点并完美记忆滚动位置；为文件面板右键菜单所有操作统一配置清晰的语义矢量图标（Fixes #83, #84）；修复 CSV 查看器单元格状态栏与界面生硬术语翻译，全量更新 31 种语言本地化字典

2.4.1 (2026-10-24)¶

• 表头交互重构与 macOS Finder 风格列分割线：文件列表水平表头引入全新的 DividerHeaderView，在各列间绘制纵向居中的半透明发丝分割线，无需生硬边框即可清晰界定列边界；全面重构 HeaderResizeCursorController 表头列宽调节控制器，设定 8px 宽容命中容差并彻底隔离排序点击与拖拽手势，消除调节时的光标闪烁与手势冲突，大幅提升拖动手感
• 设置对话框样式防抖与取消逻辑性能优化：优化偏好设置对话框退出与撤销逻辑，仅当用户在实时预览中切实更改了主题时才在点击「取消」后执行样式回滚；彻底避免未修改主题时触发全应用样式表重新解析与全部控件重复重绘计算，消除弹窗关闭时的界面瞬时卡顿
• 高清应用图标更新与 macOS 打包构建链路修复：更新更高清精细的官方 Logo 图像资产；修复 macOS DMG / PKG 及 Nuitka 生产构建脚本中对 AppIcon.icns 的误清理问题，支持从 .app/Contents/Resources/ 标准路径自适应探测图标，确保安装打包后程序坞（Dock）与访达（Finder）中的高清图标完好展示

2.4.0 (2026-10-23)¶

• 文件面板标签栏升级为 macOS 原生卡片式胶囊设计：路径标签栏全面重构为独立圆角卡片造型，增加底槽背景与发丝分割线，修复边框粗细不一致与边界裁剪问题；建立双面板焦点分级指示（活动面板高亮蓝胶囊，非活动面板中性灰），丰富锁定标签、家目录与搜索结果等语义矢量图标；统一 28px 高度规格并与驱动器选择框像素级基线对齐（Fixes #78, #79）
• 文本查看器与编辑器中文及多语言编码智能识别：全新内置智能编码探测模块（encoding_utils），结合 BOM、chardet 概率分析与高频字符集统计，彻底根除查看器（F3）与编辑器（F4）打开 GBK / GB18030 / Big5 / Shift-JIS / EUC-KR 等非 UTF-8 文本时的乱码问题，保障加载与保存编码一致
• 架构深度瘦身与安装包体积大幅削减：彻底移除 opencv-python-headless 重型依赖（剥离 70MB+ 依赖包），使用 Pillow 与平台原生 CoreImage 算法重构图像处理与水印消除引擎；清理打包流程中的衍生转码动态库（libtesseract、libx265 等），显著降低 DMG 与 App 安装包体积和内存占用
• 核心功能安全审计与全流程稳定性加固：彻底杜绝同路径或跨 VFS 复制同一物理文件导致的源文件意外清空隐患；文本编辑器严格保护符号链接原位并完善只读权限提示，修复多字节字符与 Emoji 查找替换同步问题；增强命令行 cd 相对路径与特殊字符转义解析；修复批量重命名冲突、校验和取消即时响应、7z 解包鲁棒性与图像扫描行对齐崩溃

2.3.9 (2026-10-22)¶

• 默认视觉主题精致化与现代界面体系重构：引入语义化外观令牌（Semantic Tokens）与对比度排版规范，自适应跟随系统明暗外观；恢复经典彩绘图标与双面板经典蓝色风格，统一直观清晰的当前行、文件标记与半透明悬停高亮；全尺寸展开默认工具栏并支持原生折叠溢出，升级时安全保留用户自定义工具栏配置；驱动器选择栏适度加宽，恢复绿色磁盘容量指示条并精准区分未知容量；默认收起语义命令栏，书签弹窗严格限定于面板内部，统一底部状态栏与快捷键气泡
• 归档文件多语言编码智能识别与 ZIP 条目提取：彻底修复非 UTF-8 编码归档（如 GBK / GB18030 / CP936 等）在压缩与解压时的中文文件名与目录名乱码缺陷（Fixes #74）；浏览与解压 ZIP 文件时整合智能内码探测机制；正式支持直接在 ZIP 虚拟文件面板中多选条目并执行复制提取操作
• 目录同步对话框自适应宽度约束与稳定性加固：为目录同步窗口设定合理的最大宽度限制，防止大量差异文件比对时表格无限制横向撑宽破坏界面布局（Fixes #76）；加固跨架构（ARM64 / x86_64）及高分辨率屏幕下的比对与同步稳定性
• 无障碍 (a11y) 增强与右键终端快捷入口：为主工具栏所有操作赋予语义化无障碍名称并提供完整的键盘导航支持；文件面板右键菜单新增「打开系统终端」快捷入口，一键直达当前工作目录；全套优化控件与容量状态文本同步更新 31 种语言本地化翻译

2.3.8 (2026-10-20)¶

• 文件面板交互全面升级与视觉分级：重构文件行渲染代理，引入半透明悬停高亮与圆角边界，彻底区分鼠标划过（Hover）与文件选中（Selection）视觉样式（Fixes #72）；优化右键菜单触发，消除弹出延迟且右键操作不丢失已有选中（Fixes #60）；右键上下文菜单新增「新建文件」（Shift+F4）与「新建文件夹」（F7）快捷入口，全流程支持 31 种语言（Fixes #61, #70）；路径切换后自动重置文件选中状态，避免跨目录操作误触（Fixes #67）
• 底部命令行回车唤醒系统终端与路径导航增强：在底部命令行输入任意系统命令后按回车，可自动调用系统默认终端（Terminal.app / iTerm2）并在当前工作路径下立即执行（Fixes #63）；支持直接输入相对/绝对目录或 cd 命令无缝切换面板路径，全面支持空格与特殊字符安全转义
• 全生命周期深度内存治理与系统监控环形缓冲区：通用查看器（F3）、文本编辑器（F4）及所有模态对话框均配置 WA_DeleteOnClose 并在关闭时执行确定性显式销毁，根除窗口反复打开时的内存累积；国际化广播接入 WeakMethod 避免长生命周期引用循环，解除磁盘分析树循环依赖并引入 QIcon LRU 缓存；系统状态监控与 AtbSys 桥接引入 120 样本定长环形缓冲区与就地控件复用，消除高频刷新下的内存抖动
• 工具栏配置覆写修复与沙盒状态栏引导对齐：修复在配置选项中编辑中间工具栏时可能导致新增按钮被配置覆写丢失的问题（Fixes #62）；对齐沙盒完全磁盘访问（FDA）状态栏提示与主配置菜单行为，确保指引一致

2.3.7 (2026-10-16)¶

• macOS 运行时模块依赖补齐与应用退出稳定性加固：补齐平台与日志模块中缺失的 os、sys 和 traceback 导入，彻底根除非测试独立运行环境下触发的 NameError 隐患；重构主窗口关闭流程（closeEvent），移除冗余的信号断开逻辑，确保应用退出时完全平稳，杜绝偶发 SIGSEGV 段错误
• 完全磁盘访问 (FDA) 引导交互精简与防御性回退：优化权限引导窗口，在支持原生拖拽授权的环境下智能隐藏多余的设置跳转按钮，以单一拖拽交互为主入口，并在检测到权限生效后即时更新为「已授予完全磁盘访问权限 ✓」状态；新增健壮的防御性回退机制，在原生拖拽面板呼出异常时自动恢复设置按钮，保障任何场景下的授权通畅

2.3.6 (2026-10-16)¶

• Nuitka 编译器锁定与 Apple Silicon (ARM64) 崩溃根除：在构建与 CI 流水线中锁定稳定版 Nuitka 4.2.2，彻底规避 Nuitka 4.3 探测机制在 PySide6/Shiboken 下引发的编译对象悬垂释放（SIGSEGV / EXC_BAD_ACCESS）；在冒烟测试（smoke_test.py）中新增 Qt 信号槽与编译器 freelist 内存完整性断言；规范全平台打包脚本参数，确保本地与 CI 环境二进制产物高度一致
• macOS 15 Sequoia 窗口与托盘生命周期深度加固：重构系统托盘窗口还原、激活（activate_app）与 Dock 栏图标切换逻辑，杜绝 WindowServer 在无头或测试环境下分派非法 FocusWindowEvent 导致的段错误；妥善隔离并回收 pynput 全局热键监听线程，防止后台线程泄漏与 OS 级 CGEventTap 钩子悬挂；完善退出清理机制，安全重置剪贴板以防止静态 QMimeData 析构异常
• 自动化测试与 CI 流水线效率提升：彻底消除托盘及主窗口测试在 pytest 退出时的偶发崩溃，完善 Offscreen 平台下的测试适配；优化 CI 工作流，文档更新自动跳过全量打包，显著加快开发与发布验证效率

2.3.5 (2026-10-15)¶

• Google Drive 与 Dropbox 云存储原生集成与 OAuth 2.0 授权：全新支持 Google Drive（gdrive://）与 Dropbox（dropbox://）双云盘虚拟文件系统；连接管理器新增云存储专属配置页与图标，支持自定义 Client ID / Client Secret 并提供浏览器一键式 OAuth 2.0 快捷授权；优化流式上传下载快速通道、存储配额（Quota）缓存与目录懒加载机制，连接成功后自动保存配置
• 钥匙串凭据集中安全管理与高强度加密导入/导出：整合系统钥匙串命名空间，彻底消除启动时的多余权限提示，加固授权凭据与许可证的本地持久化；新增连接凭据与密码的加密导出/导入功能，支持设置强密码加密打包并跨设备安全迁移；全流程适配 31 种语言交互
• Nuitka 运行稳定性加固与 Zip 流式压缩优化：修复打包二进制环境下偶发的启动崩溃缺陷，完善 CI 流水线对独立打包工件的自动化冒烟测试覆盖；优化归档系统的 Zip 流式压缩读写机制，防止面板刷新时数据被冲刷，增强后台线程安全性
• 文件排序稳定性提升与云存储配置指南更新：修复文件夹优先排序与自然大小写排序测试中的偶发竞态问题（Fixes #58）；官方用户手册第 6 章详细增补 Google 与 Dropbox 云存储 API 凭据申请、OAuth 组织域名验证及防警告操作图文指引

2.3.4 (2026-10-13)¶

• 沙盒权限引导重构与单一按钮极简授权：恢复并整合用户主目录（~）与 /Volumes 外置存储的权限授予流程，打造全新的「一键授权」工作流；引入智能路径提升机制，自动将深层子目录访问请求提升至用户目录或驱动器根目录并持久化安全作用域书签，彻底根除 macOS 沙盒环境下的重复授权弹窗
• 标准对话框按钮原生翻译与 31 语种多语言深化：实现 _GettextQtTranslator 翻译器，通过 gettext 统一接管并准确翻译 Qt 标准按钮（如“是/否/确定/取消/保存/放弃/应用/关闭/打开/重置”），自动剥离快捷键加速符；为首选项各配置页（工具栏、快捷键、收藏标签、自动刷新等）及连接管理器、队列查看器等对话框全面补充动态语言重载（retranslate_ui）；完善并编译全部 31 种语言的本地化词典与 .mo 文件，新增自动化国际化测试用例

2.3.3 (2026-10-10)¶

• 压缩归档体系全面升级与独立分别打包：归档对话框新增「为每个选定项创建独立归档文件」选项，支持一键批量将多个选中的文件或文件夹分别单独压缩；针对大文件（≥1MB）引入流式读写进度追踪，提供平滑精准的百分比进度；支持线程安全的文件冲突处理（覆盖、跳过、自动重命名），强化批量错误容忍度并安全处理软链接与死链；同步更新 31 语系翻译
• 系统托盘唤醒与 macOS 全局热键深度加固：完善托盘唤醒窗口几何记忆，精准恢复隐藏前的位置、尺寸与最大化状态；托盘右键菜单不再干扰主窗口层级；重构 macOS 全局唤醒/隐藏热键，通过虚拟键码规范化 Option 变音键并在主线程缓存按键上下文，彻底解决 macOS Sequoia 后台线程断言异常；偏好设置支持实时动态切换最小化到托盘行为
• 驱动器选择器与磁盘容量提示升级：驱动器工具栏全面优化，直接呈现原生磁盘卷标（Volume Labels）与硬件磁盘图标；悬浮气泡提示全面丰富，清晰展示挂载路径、文件系统格式、可用空间及总容量统计
• Nuitka 构建打包体系与自动化冒烟测试：打包脚本全量补充 --include-package=atbcmder，彻底根除因对话框按需懒加载导致的打包后运行时 ModuleNotFoundError；新增无头 --smoke-test 自动化验证流程，并在 DMG、App Store 安装包与 CI 流水线构建后自动执行冒烟测试，确保发布包零缺陷稳定运行
• 多语言官方产品落地页全面上线：正式上线现代化官方产品介绍主页，配备智能语言路由器（支持中/英/日/韩等多语系无缝切换），全方位展示双面板双流操作、原生 macOS 体验与核心功能矩阵

2.3.2 (2026-10-07)¶

• PySide6 运行时内存深度治理与 macOS 堆内存主动压缩：为重型次级对话框引入惰性代理加载机制（_make_lazy_dialog）与 PEP 562 模块懒导出，大幅缩减应用常驻内存；Cocoa 调用全量包裹 objc.autorelease_pool()，彻底根除 Finder 颜色标签轮询导致的内存缓慢堆积；集成 Darwin 原生 malloc_zone_pressure_relief 机制，在闲置与窗口关闭时主动压缩堆空间并归还系统；缩略图并发线程限制为 4 个并优化图标缓存，全面消除内存峰值
• F3 查看器与 F4 编辑器光标可见性及自动焦点修复：彻底修复打开文件查看器与编辑器时光标丢失、无法直接输入的问题，窗口激活时自动将键盘焦点绑定到文本缓冲区；恢复清晰可见的 1px 闪烁光标（caret），解耦查看器与编辑器的光标配置并支持在通用查看器中通过快捷键 F6（cm_ShowCaret）动态切换光标显隐
• 资源生命周期加固与文档更新：为通用查看器对话框配置 WA_DeleteOnClose 属性，确保窗口关闭时彻底析构并释放底层图形资源；同步更新用户使用指南与文档配图

2.3.1 (2026-10-06)¶

• 沙盒权限引导体验深度优化与智能窗口避让：在请求完全磁盘访问权限（FDA）并打开系统设置时，引导弹窗将自动调整尺寸并智能停靠于屏幕左侧，与 macOS 居中偏右打开的「系统设置」窗口完美并列显示、互不遮挡，操作流程更加一目了然
• 清晰步骤指引与权限生效提示：全面重构引导说明文案，提供清晰直观的 1-2-3-4 步骤指南（列表中定位或手动添加、打开开关、退出并重启应用），并突出提醒完全磁盘访问权限需重启生效，避免困惑
• 全语言词典与 31 语系翻译同步：全面更新专业术语库（Glossary），重新编译并同步所有 31 种支持语言的 .po 与 .mo 语言包，确保全球用户享受精准、友好的引导体验

2.3.0 (2026-10-05)¶

• macOS Finder 原生色彩标签与实时同步：深度集成 macOS Foundation API，在文件列表中呈现原生色彩圆点标签列；支持按 Finder 原生色彩顺序智能排序，并通过 2 秒视口轮询实现与系统色彩标签的毫秒级实时同步；偏好设置提供自适应显隐开关，颜色名称全量支持本地化
• 目录同步功能全方位跃升（cm_SyncDirs）：全面重构目录同步面板，解决 UI 状态死锁并新增独立同步错误报告对话框（SyncErrorsDialog）；新增一键目录互换、双向删除（OP_DELETE_BOTH）、竖线 | 通配符排除语法、实时统计、CSV 导出、选区子菜单与“在 Finder 中显示”；窗口尺寸与列宽实现持久化记忆
• Apple HIG 毛玻璃交互式富文本提示卡片：全新构建中央提示注册表架构，引入 80% 半透明毛玻璃卡片（完美自适应 macOS 浅色与深色主题）；覆盖工具栏、分割条、导航控件、底部 Fx 功能键栏及高频对话框，智能集成 macOS 快捷键徽标并抑制重复的原生 Qt 提示
• macOS 快捷键规范全契合与冲突自动消除：快捷键文案与符号全面契合 macOS 原生约定，菜单与工具栏快捷键严格同步；彻底消除 1 对 1 快捷键历史冲突，并在选项界面、注册表与 XML 存储层引入自动去重机制，保障键盘流操作的极速响应
• 全界面 31 语系 100% 精修与演示系统扩充：全界面 31 种语言达成 100% 翻译覆盖率与复数形式精准校对；通用文件查看器（F3）新增“以文本模式打开”按钮，长文件名截断时支持智能悬浮预览；演示脚本扩充涵盖快速筛选、批量重命名、透明归档 VFS、目录同步与树形视图的全景展示

2.2.0 (2026-10-03)¶

• 主工具栏视觉与人机工效大升级：主工具栏图标升级至 38px、栏高优化为 42px，杜绝图标挤压变形，在高分辨率 Retina 屏上带来更舒适的点击命中体验；按钮图标全面换装 Apple HIG 风格的灵动渐变色彩并提升对比度，主工具栏与中部分割条尺寸层级更加和谐
• 偏好设置全链路贯通与代码编辑器配置修复：全面贯通界面字体缩放（Font Zoom）、压缩归档默认参数、编辑器自动缩进、查看器文本换行宽度等此前脱节的设置项；修复内置代码编辑器（CodeEditorWidget）制表符宽度（tab_size）与缩进规则，确保配置即时准确加载
• 全局内存治理与性能深度优化：重构图标与文件元数据缓存层，针对复杂视图与重量级组件引入按需惰性初始化；强化组件销毁与生命周期弱引用管理，消除潜在内存泄漏，确保长时间运行超大目录浏览依然轻快顺畅
• 模态弹窗关闭防假死与目录树焦点稳定：修复归档压缩（ArchiveDialog）与文件分割合并（SplitLinkDialog）关闭时的偶发模态挂起假死问题；在树形视图（Tree View）模式切换与操作时无缝保持当前标签页的键盘焦点
• Nuitka 打包体系优化与运行崩溃防范：优化独立应用程序与 DMG 打包脚本，显著降低构建内存开销与安装包体积；清理编译参数，彻底消除因测试模块动态加载导致的运行时崩溃隐患

2.1.0 (2026-10-02)¶

• 驱动器栏与标签页 Apple HIG 全面焕新：驱动器盘符栏（Drive Bar）与路径导航按钮深度重构为 Apple 风格无边框控件；路径面包屑栏（Breadcrumbs）与文件标签页升级为 Apple HIG 柔和色调材质（Tonal Surfaces），界面现代质感与操作流畅度全面跃升
• 现代步进器、胶囊气泡与分页组件升级：数值微调框（QSpinBox/QDoubleSpinBox）重构为 macOS HIG 一体化内置步进器；引入苹果风格半透明胶囊悬浮提示（Capsule Tooltip）并优化为图标下方智能对齐；偏好设置分页与工具栏图标全面适配 HIG 规范
• 双面板工具栏图标与缩略图层级优化：垂直中部分割工具栏新增“使目标面板等于源面板（cm_TargetEqualSource）”专用图标；修复缩略图视图中选中角标（Checkmark Badge）显示层级，确保清晰置顶呈现；修复图片编辑器状态栏缩放按钮偶发溢出
• 全球 31 种语言本地化与术语全量精修：全面核对并统一 31 种支持语言的界面术语、菜单提示及对话框文案，彻底消除漏译与不规范译名，打造一致、专业、母语级的全球化体验
• 开发工具链与自动化工程优化：规范化并引入项目专用多语言提取与编译工作流（atb-python-i18n），优化辅助工具令牌解析与测试环境隔离，保障自动化发布流水线的高可靠性

2.0.0 (2026-09-28)¶

• 🎉 ATBCmder 2.0 架构成熟与重大里程碑：标志着全新现代化双面板文件管理器架构全面成熟，深度融合经典双面板高效键盘流操作与 macOS 原生体验，带来更强性能、极致稳定与现代设计
• 全界面 31 种语言深度全球化本地化：权限引导流程与原生“拖拽即授权”悬浮面板（Drag-to-Grant Panel）现已支持全部 31 种语言的纯正母语本地化；重新编译全量 .mo 词典并加入自动化多语言回归测试，为全球用户提供无障碍使用体验
• 完全磁盘访问“拖拽即授权”极致体验：基于原生 Cocoa NonactivatingPanel 打造独立拖拽面板，无需激活窗口直接拖拽图标至系统设置即可快速授予完全磁盘访问权限（FDA）；引导弹窗自动贴靠系统设置，授权成功后支持从容“退出并重新打开”，彻底消除焦点打扰与强制倒计时
• 双面板操作流与人机交互全方位打磨：支持双击中部分割条/工具栏一键 5:5 黄金比例重置面板宽度或高度；主工具栏默认集成系统状态监控胶囊并提供快速关闭按钮与全局右键配置菜单；深度完善文件夹混排模式（Mixed）确保全列即时生效
• 现代文本编辑与高性能系统维护套件：内置编辑器全面支持 macOS 标准 Home/End 与 Smart Home 智能首字符跳转；底层深度整合 Go 原生 atbsys 系统引擎，支持 64 位大文件安全计量清理与应用残留深度卸载

1.9.9 (2026-09-27)¶

• 全盘访问权限“拖拽即授权”与交互革新：推出基于原生 Cocoa NonactivatingPanel 的独立拖拽悬浮窗，不抢焦点直接拖动图标至系统设置即可快速授予完全磁盘访问权限（FDA）；引导弹窗自动吸附至系统设置旁，权限授予后支持平滑“退出并重新打开”，彻底消除生硬的强制重启与焦点打扰
• 双面板 5:5 比例快速均分与中部分割条优化：双击双面板中间工具栏或分割条即可瞬间将双面板宽度（或上下高度）精准重置为 50:50 等分，附带多语言动态提示；修复多语言订阅计数与鼠标指针泄漏，优化查看器及弹窗界面细节
• 文本编辑器按键体验升级（Home/End 与智能行首）：内置文本编辑器完美支持 macOS 标准 Home 与 End 行首/行尾跳转；引入 Smart Home 智能逻辑，首次按 Home 键跳至首个非空白字符，再次按键跳至行首零位
• 工具栏系统状态胶囊便捷管理与右键菜单：主工具栏默认开启系统状态胶囊，新增快捷关闭（×）按钮；新增工具栏右键上下文菜单，随时一键切换工具栏各功能组件与系统状态显示
• 文件夹混排模式深度对齐与渲染性能提速：彻底完善文件夹混排排序规则（sort_folder_mode = mixed），确保在所有列排序下文件与目录完全交错排列并即时生效；剔除样式表伪字体声明消除 CoreText 字体解析开销，优化新手引导卡片对齐与原生菜单穿透防护

1.9.8 (2026-09-24)¶

• 系统工具大文件计量修复与应用卸载增强：修复清理字节数超过 2GB 时 Qt 32 位整型信号溢出及 64 位精度丢失问题；应用卸载器新增显示应用安装日期并支持按时间排序，全面提升大体积垃圾清理与卸载分析体验
• Mac App Store 沙盒合规加固与真实目录透传：向底层 atbsys 引擎透传真实用户主目录（real_home），确保沙盒环境下精准扫描与清理用户残留文件；全面加固提权、终端启动与脚本接口以严格符合 App Store 审核规范
• 偏好设置布局控制与路径收藏夹修复：在常规设置中新增主界面组件布局开关（与主题管理器及主窗口实时联动），默认收起顶部工具栏系统状态胶囊以保持清爽界面；修复路径收藏夹（Directory Hotlist）设置页下拉框空白问题并支持界面语言动态重译
• 多语言术语统一与语言选择器优化：将“Directory Hotlist”中文译名统一规范为“路径收藏夹”，并在偏好设置语言选择器中采用“母语名称 + 当前语言译名”双语展示，方便跨语言快速识别与切换
• 钥匙串授权静默保持与流式复制稳定性提升：保留 macOS 钥匙串（Keychain）既有访问控制列表（ACL）并消除启动时的冗余写入，避免重复弹出系统钥匙串密码授权框；修复 StreamCopyWorker 信号触发时序，消除流式文件复制完成时的竞态隐患

1.9.7 (2026-09-23)¶

• 偏好设置运行时即时热生效：全量支持文件操作、文本编辑器、通用查看器、快速搜索与过滤、标签页管理、文件列表图标显示、排序规则等 7 大设置页面的修改即时生效，无需重启应用；新增文件夹排序模式配置，支持文件夹置顶、文件置顶与混排模式
• 目录同步安全加固与体验对齐：全面审计目录同步（Sync Dirs）功能并对齐经典 Double Commander 交互逻辑；强化双向对比状态检查与安全防护，杜绝非对称文件同步风险
• 超长文件名智能悬浮气泡：新增列表项目智能提示气泡，仅在列宽不足文件名发生截断时灵敏显示，完整文件名保持零干扰；优化中日韩（CJK）全角字符宽度测算，消除宽字符排版检测误差
• 双面板操作流与人机交互优化：右键压缩与解压的目标路径默认自动设为对侧面板（Peer Directory），对话框默认聚焦“开始”按钮；优化删除确认弹窗按钮位置与回车响应；恢复双面板中间分栏工具栏按钮手型光标
• Mac App Store 沙盒主目录与全盘访问加固：引入 real_home 机制精准解析沙盒环境下的真实用户主目录与常用目录（Hotlist）；修复全盘访问权限（FDA）检测误判，授权后自动关闭引导弹窗；系统状态监控改用 Mach host statistics 适配沙盒环境

1.9.6 (2026-09-21)¶

• 图片编辑器新增自定义尺寸缩放模式：图片编辑器的图像调整对话框新增“自定义尺寸（Custom Size）”模式，支持直接输入宽高目标像素数值，并提供一键锁定/解锁等比例缩放功能，极大提升了图像裁切与尺寸调整的精确度
• Mac App Store 沙盒安全与审核合规加固：严格遵守 Apple 审核指南 2.4.5(v) 与 2.5.2 规范，在沙盒模式下移除引导用户授权系统根目录访问的选项，并屏蔽对外部进程的强制终止（SIGKILL/SIGTERM）UI 与调用，杜绝沙盒越界风险与拒审隐患
• 工具栏自适应溢出与差异比较器稳定性：主工具栏新增自适应溢出收纳处理，在小屏或紧凑窗口下自动将超出宽度的操作按钮归入更多菜单，避免布局挤压；修复 Diff 差异比较器在 macOS x86 环境下的偶发响应停滞
• 30 种语言菜单本地化补全：为顶部菜单栏“工具（Tools）”及相关命令完成全量 30 种语言的深度本地化翻译
• 界面性能与 CI/CD 流程优化：消除文本面板组件残留以大幅提升主题切换与重绘速度；持续集成支持参数化切换自托管/云端 ARM64 runner，并为构建产物上传下载增加自动重试与退避机制

1.9.5 (2026-09-19)¶

• Mac App Store 辅助可执行文件沙盒继承与合规加固：为 Contents/MacOS/ 下的所有辅助可执行程序（如 atbsys 等系统工具二进制）引入专用的子进程沙盒权限配置（com.apple.security.app-sandbox 与 com.apple.security.inherit），使辅助进程严格遵循并继承主应用程序的 App Sandbox 安全策略，彻底解决提交 Mac App Store 时的沙盒合规性审核要求
• DMG 发行包辅助程序强化运行时（Hardened Runtime）签名：全面为 DMG 独立发布版本中的所有 Mach-O 辅助可执行文件启用 Hardened Runtime（--options runtime）并注入对应权限配置，确保所有子程序严格符合 Apple Developer ID 签名与自动公证（Notarization）规范
• 打包结构精简与签名合规性测试：自动移除多余的内部资源二进制目录以优化应用包结构并杜绝审核隐患；新增多项辅助进程权限与打包签名集成测试，全面保障自动化发布流水线的可靠性

1.9.4 (2026-09-19)¶

• 全新 ATBSys 系统工具与维护套件：深度集成原生系统维护工具箱，主工具栏常驻系统状态胶囊（实时 CPU、内存、磁盘及网络速率监测，支持右键暂停/刷新频率调节/隐藏及偏好设置切换），全新系统状态面板（完整硬件指标监控与高负载进程右键终止/强制杀死管理），磁盘空间分析器（Treemap 矩形树图层级可视化、表头交互排序、一键定位/移动到废纸篓及 CSV/TXT 分析报告导出），两阶段安全系统清理器（安全扫描与深度清理缓存、日志、应用残留，新增 Homebrew、CocoaPods、Docker 分类与 ~/.config/mole/whitelist 白名单保护），以及应用残留深度卸载器
• 高性能 Go 原生引擎与安全审计日志：底层采用轻量高效的 Go 原生独立二进制 atbsys 桥接引擎，基于异步 QProcess 进行非阻塞通信，支持 Universal Binary 通用架构并全面集成至自动化打包与 CI 流水线；所有系统清理与软件卸载操作均自动记入结构化安全审计日志，兼顾极速性能与操作可追溯性
• 交互式新手引导扩展至 27 步：入门教程全面升级并新增系统工具与维护套件实操教学；重构菜单高亮定位引擎，实现 macOS 原生菜单栏跨语言高精度几何对齐与无缝引导
• 全球 30 种语言深度本地化与官方文档完善：ATBSys 全套系统工具、状态胶囊菜单、设置项及新手教程全面实现 30 种语言精准本地化；官方英文用户指南新增第七章《Chapter 7 System Tools & Maintenance》完整使用手册
• 界面细节优化与打包加固：加宽状态栏胶囊与网速标签，彻底解决高吞吐传输时的速率文字截断问题；优化状态胶囊右侧吸附布局与快捷键解绑同步机制；完善打包脚本中对单架构与通用架构动态库及二进制注入的安全校验

1.9.3 (2026-09-17)¶

• 通用查看器 .ini 配置文本预览：在 F3 通用查看器与快速查看（Ctrl+Q / ⌘Q）中增加对 .ini 配置文件的纯文本原生预览支持，无需启动外部编辑器即可即时查看配置文件内容
• 应用商店打包与动态库签名加固：针对 Mac App Store 及 DMG 发行打包自动化构建并注入 libATBLicenseKit.dylib 到 Contents/Frameworks/ 目录；增加动态库独立代码签名与公证支持，增强运行时 Frameworks 相对路径动态定位，并安全处理通用架构（Universal Binary）合并
• 新手引导引擎稳定性修复：解决常用目录（Hotlist）教学步骤中的超时与状态滞留问题，在切换步骤时即时重置状态标记，并解绑废弃的事件监听信号以彻底杜绝信号泄漏

1.9.2 (2026-09-17)¶

• StoreKit 2 原生授权与试用系统：内置基于 Swift StoreKit 2 的 Mac App Store 授权与买断体系，支持本地日历天试用计数、收据离线验证与购买恢复；主工具栏集成授权徽章与买断付款墙；全面兼容 macOS 12+ (Apple Silicon 与 Intel 双架构)
• 底部 Shell 命令行与终端联动：底部输入框支持直接执行 Shell 命令行指令并调用系统终端（Terminal / iTerm2）；支持 Tab 补全文件名与路径，纯 cd 命令直接导航面板
• 目录同步重构与行内词级 Diff：目录同步升级为经典 7 栏对比视图，集成双击 Diff 比较并消除非对称同步风险；文件差异比较器新增行内词级/字符级差异高亮与首尾差异快捷跳转
• macOS 原生储存空间对齐与网络 VFS 加固：驱动器总容量与可用空间计算完全对齐 macOS 系统设置的“储存空间”显示规范；网络 VFS（SFTP/FTP/Samba/WebDAV）加固保活、自动重连与 FTPS 支持；托盘图标更新为极简单色自适应风格

1.9.1 (2026-09-14)¶

• 新手教程新增快速搜索教学：交互式引导系统扩展至 25 步，新增快速搜索与即时过滤（⌘S / Ctrl+S）实操环节，主菜单“命令”新增快速搜索入口，并优化覆盖层的无缝过渡与自动清理
• CI 自动化构建与依赖加固：发布打包流水线中恢复 ebooklib 依赖以确保完整支持 EPUB 预览；优化工作空间自动清理机制，防止构建缓存与权限冲突

1.9.0 (2026-09-13)¶

• 全新新手交互式引导系统：内置 24 步交互式入门教程，首次启动提供友好欢迎弹窗（可随时通过“帮助 → 新手教程”重温）；配备聚光灯镂空高亮遮罩、自适应浮动卡片、菜单路径与原生快捷键双提示，轻松掌握双面板核心工作流
• SFTP 网络安全性重大升级：废除不安全的主机密钥自动接受策略，全面引入 TOFU (首次使用信任) 安全验证机制；连接未知 SFTP 服务器时自动弹出 SHA-256 安全指纹确认对话框，有效抵御中间人攻击 (MITM) 并安全保存至 known_hosts
• macOS 原生快捷键与导航优化：修复 Command+Up（返回上级目录）与 Command+Shift+F1（缩略图视图）在特定键盘修饰键下的冲突，全面采用 macOS 原生符号（⌘、⌥、⌃、⇧）统一快捷键指引
• 核心性能与构建体系优化：优化语义模板匹配与补全响应效率；重构 GitHub Actions 自动化发布流水线并强化 AppKit 沙盒防崩溃保护

1.8.0 (2026-09-11)¶

• 通用架构安装包支持：支持 x86_64 与 ARM 架构通用安装包
• 自动化构建流水线：支持通过 GitHub Actions 自动构建与打包
• 智能文件关联与外部应用支持：新增独立文件关联管理系统（extassoc.xml），支持按扩展名自定义打开动作、外部编辑器与查看器；集成智能回退机制与“打开方式”选择，无缝兼容 macOS 原生应用
• 超大文件传输与 64 位溢出防护：彻底修复进度信号与文本面板滚动条中的 32 位整型溢出问题，全面保障 2GB 以上超大文件在挂载卷与网络驱动器间的稳定传输与准确进度显示
• 全能查看器退出层级统一：重构查看器 ESC 快捷键响应机制（搜索栏 → 过滤框 → 全屏 → 关闭窗口），消除快捷键冲突并优化多文件切换与资源回收
• 界面即时动态本地化：底部功能按键栏（F3～F8）支持在语言切换时即时重新翻译，无需重启应用生效

1.7.0 (2026-09-06)¶

• 全能文档与媒体预览器：新增 Office 预览套件（Excel 表格虚拟懒加载、Word 文档分页与图片渲染、PowerPoint 幻灯片卡片视图）；新增 SQLite、Markdown 大纲、Jupyter Notebook、字体、压缩包、音频等 8+ 种格式预览；支持 GB 级超大文本文件秒级流式无限滚动
• 双向文件差异比较器：全新内置侧边双向 Diff 工具，支持逐行/行内字符高亮、差异块一键合并、撤销编辑与编码无损保存
• 搜索系统全面重构：默认支持模糊子串与正则搜索；新增“导入到列表面板 (Feed to ListBox)”标签页功能；优化海量结果批量流式渲染，彻底消除 UI 卡顿
• 文件操作与核心传输加固：解决跨设备移动重复弹窗确认与传输队列死锁问题；属性对话框新增文件创建时间；默认启用居中垂直工具栏并优化活动面板视觉指示

1.6.2 (2026-09-03)¶

• 鼠标框选与选择交互增强：列表视图与缩略图视图全新支持鼠标拖拽框选多选（Rubberband Drag Selection），并支持点击空白区域快速取消选择
• 全局窗口快捷键与多键录制：新增可自定义的全局窗口呼出/隐藏快捷键；修复快捷键设置中无法正确录制 4 键组合快捷键的问题
• macOS 托盘与 Dock 恢复修复：修复应用隐藏至系统托盘后从 Dock 图标点击无法正常还原主窗口或显示空白窗口的问题
• 稳定性加固与核心健壮性提升：修复多线程与对象生命周期中的潜在崩溃，加固 VFS 虚拟文件系统并全面优化测试稳定性

1.6.1 (2026-08-27)¶

• macOS 原生 UI/UX 全面重构：深度遵循 Apple HIG 设计规范，优化深浅色主题调色板、Finder 风格面板高亮、卡片式 ToolTip 与平滑过渡动画
• 矢量图标引擎与现代控件：内置 SF Symbols 风格矢量图标生成器，重构驱动器按钮、面包屑导航与下拉控件，全面支持高分屏自适应
• 交互与布局升级：多重重命名对话框重构为双栏布局并新增重名实时冲突检测；缩略图视图支持 Cmd + 滚轮 动态无级缩放；新增统一的空状态提示组件

1.6.0 (2026-08-27)¶

• 双分发渠道流水线：支持面向独立官网分发 (DMG) 与 Mac App Store 商店版的双轨自动化构建体系
• 商店版合规与菜单适配：在 App Store 版本中自动隐藏外置更新检查入口，确保严格符合 Apple 审核规范；独立分发版继续保留手动更新入口
• 二进制合规补丁：内置 itms-services 专用二进制扫描与安全修复工具，彻底解决 Qt/PySide6 构建产物通过 App Store Connect 自动化验证时的私有协议拦截问题

1.5.6 (2026-08-22)¶

• 标签页独立视图模式：每个标签页支持独立的视图配置（平铺模式 Flat View / 树形模式 Tree Mode），切换标签页自动同步显示状态并在会话中完整持久化
• 智能文件打开与系统回退：新增多层级文件类型检测器（魔数/MIME/扩展名），内置支持的文档与媒体无缝调用内置查看器，未支持的文件格式自动回退至系统默认程序打开

1.5.5 (2026-08-21)¶

• 应用更新检查策略优化：默认禁用启动时的自动联网检查更新，改为纯手动触发检查（通过菜单栏 帮助 -> 检查更新...），提升软件启动速度并优化离线使用体验

1.5.4 (2026-08-21)¶

• 焦点高亮与选择状态优化：彻底修复双面板切换时非活动面板残留焦点框的问题；优化跨面板移动文件后的选择项重置逻辑，防止残留选区导致误操作

1.5.3 (2026-08-19)¶

• 面包屑级联子菜单交互优化：精确对齐多级子目录菜单展开时的高亮行垂直高度，消除多层级穿透时的位置偏移与跳动，极大提升快捷目录浏览体验

1.5.2 (2026-08-19)¶

• 启动与版本说明修复：修复每次启动应用时重复弹出“版本说明”对话框的问题；增强配置系统 Config.get 默认值处理，确保仅在首次运行或版本升级后展示新特性提示

1.5.1 (2026-08-19)¶

• 多语言版本说明支持：新增 7 种主流语言 ReleaseNotes（繁中/日/韩/德/法/俄/西），实现多级智能回退解析与动态自动发现
• 打包签名机制优化：重构 macOS 签名脚本与时间戳重试策略，优化 Mach-O 二进制文件签名流程，彻底解决构建限流与签名失败问题

1.5.0 (2026-08-17)¶

• 全局会话持久化 (Session Manager)：实现应用级别的会话状态保存与恢复机制，无缝恢复上次关闭时的所有左右面板标签页、目录路径、展开模式 (Flat/Tree View)、面板比例及多显示器窗口位置
• 配置导入与导出：新增全局配置与数据 一键导出/导入 ZIP 功能，方便设备间数据迁移
• 图片编辑器增强：新增自定义图像尺寸调整 (Resize) 功能，支持按比例缩放锁定及预设分辨率快速缩放

1.4.9 (2026-08-17)¶

• 全新内置图片编辑器：支持图像裁剪缩放、精细旋转、多级滤镜调整，并引入基于 OpenCV 的 AI 去水印及图像修复 (Inpainting) 功能
• 高级图片查看器增强：全面支持动态 GIF 播放，新增图像平移、缩放、旋转、EXIF 属性查看以及幻灯片自动播放功能
• 搜索集成优化：深度集成 macOS 原生 Spotlight 搜索引擎，实现文件秒搜并优化了搜索结果的焦点定位

1.4.8 (2026-08-16)¶

• 国际化 (i18n) 全面深化：完成界面、F3 查看器与 F4 编辑器的多语言全面审计与补充翻译，极大改善了音视频播放器及各类预览控件的本地化体验
• 快速查看器 (F3) 优化：完善轻量级 EPUB 阅读器 (SimpleEpubPanel) 的外链跳转与循环搜索逻辑；精简 PDF 阅读器工具栏，移除冗余的旋转按钮

1.4.7 (2026-08-16)¶

• 音视频播放器增强：大幅度优化内置媒体播放器的交互体验与稳定性
• 编译系统重构：重命名 BUILD_EPUB 环境变量为 BUILD_WEBENGINE，解耦轻量级打包逻辑
• 安装包依赖修复：确保轻量版 DMG 安装包也始终内置 ebooklib，保障后备电子书阅读器 (SimpleEpubPanel) 的可用性

1.4.6 (2026-08-16)¶

• 内置轻量级 EPUB 阅读器 (SimpleEpubPanel)：新增无需依赖 WebEngine 的后备电子书阅读引擎，支持章节跳转与搜索，并提供 --epub-reader 命令行参数强制指定阅读引擎
• 面包屑菜单交互重构 (BreadcrumbFolderMenu)：完全重构面包屑下拉菜单为单列滚动样式，并支持无限级联子菜单直达，彻底解决多级菜单展示重叠与鼠标焦点锁定问题

1.4.5 (2026-08-15)¶

• 全新代码查看器 (F3)：支持百种语言语法高亮、大文件动态跟随 (Tail)、正则表达式搜索及行号显示
• 全新代码编辑器 (F4)：内置编码/换行符动态转换、安全原子写入、缩进调整与查找替换功能
• 全局外部拖拽 (Drag & Drop)：支持将文件或压缩包内的深层文件，直接无缝拖拽至桌面或第三方应用 (例如 VSCode / Sublime)

1.4.4 (2026-08-15)¶

• 界面可读性增强：全面放大菜单栏、按钮、提示框与设置界面的字体字号，提升视觉舒适度
• 游标交互修复：修复调整窗口边缘、面板分割线及表格列宽时鼠标调整指针(Cursor)丢失的问题
• Mac 原生控件修复：解决部分组件(QComboBox下拉框、QGroupBox标题)在 macOS 下背景发黑或溢出的显示异常

1.4.3 (2026-08-14)¶

• 全新 macOS 原生交互风格 (Aqua Blue Theme)：新增专属主题并设为默认，引入交互式面包屑导航 (支持级联子目录直达)、Mac 风格存储容量条 (修复大容量溢出显示) 及圆角胶囊选择高亮
• 界面细节深度打磨：重构标签页关闭按钮布局，修复命令行输入框重叠问题，并为所有主题(明/暗/经典)统一下巴栏背景、分割线与面板边框
• 国际化与升级支持：完成全项目 i18n 多语言翻译覆盖审计；自动更新模块新增对 AList/OpenList 聚合网盘分享协议的支持

1.4.2 (2026-08-13)¶

• 智能语义过滤器增强：支持更多常见文件扩展名解析与单复数匹配，并全面支持多语言 (i18n)
• 语义搜索体验优化：采用真实的进度条替换等待光标，优化按回车键触发补全与执行的交互逻辑
• 核心语义解析优化：修复目标类型推断与关键词过滤逻辑，提升自然语言搜索准确性

1.4.1 (2026-08-13)¶

• 全局代码质量审查与深度重构 (批次 A-D)
• 安全增强：修复可能存在的路径遍历等安全隐患
• 并发与性能优化：改善后台任务线程安全与执行效率
• 架构优化：提升核心组件的稳定性与资源管理

1.4.0 (2026-08-12)¶

• 深度修复 VFS 网络模块：包括多编码支持、协议驱动修复、链式压缩包挂载支持与传输冲突修复
• 完善应用自动升级模块：修复证书验证、安装包验证与界面集成问题
• 版本更新提示优化：自动更新时展示完整的版本历史日志

1.3.9 (2026-08-12)¶

• 新增内置 EPUB 电子书阅读器 (F3 快速预览)
• 新增应用自动升级检测与提示机制
• 修复 VFS 文件冲突处理时的进程卡死问题

1.3.8 (2026-08-08)¶

• 树状视图 (Tree View) UI 优化
• 深度重构基于 fsspec 的网络集成
• 优化非法文件字符的处理逻辑

1.3.7 (2026-08-06)¶

• 网络 VFS 引擎重构：基于 fsspec 深度重构网络文件系统（FTP/WebDAV/SMB），实现异步目录加载 VfsTableModel、流式传输 StreamCopyWorker、远程新建/重命名/删除/覆盖冲突提示，以及 F3/F4 远程预览与编辑
• 系统托盘与全局热键：支持最小化到系统托盘、全局快捷键 (Option+Cmd+H) 切换托盘、macOS Dock 图标动态显隐与原生模板图标适配
• LLM 配置与 AI 语义过滤：新增 default_llm.xml 配置单例与结构控制，集成 AI 语义过滤器及选项设置页面
• 快捷键与导航增强：常用列表弹窗及文件面板全面支持 PageUp / PageDown / Home / End / Fn 导航快捷键
• 国际化 i18n 补充：全面封装 VFS 错误提示、快速查看面板与托盘菜单的多语言翻译与 Catalog 编译

1.3.6 (2026-08-04)¶

• 网络 VFS 增强：优化 FTP 编码自动检测 (UTF-8/GBK/Makefile 动态更新)、传输降级与 Socket 重置；解决 FTP 连接超时及响应错位问题
• WebDAV 与 SMB 修复：修复 WebDAV/SMB 根路径剥离、子目录异常日志传播、连接异常及虚拟文件系统图标/标签标题显示
• 缩略图视图导航：实现缩略图网格视图 (Thumbnail View) 2D 键盘方向键平滑导航
• 国际化与代码质量：修复 zh_CN/zh_TW 语言包中“关闭标签页”翻译损坏问题，完成全代码库审查优化与安全硬化

1.3.5 (2026-08-03)¶

• 快速查看面板：实现快速查看功能 (cm_QuickView, Cmd+Q/Ctrl+Q)，支持多格式预览、文件属性兜底展示、左右对称翻转、显示菜单集成与完整 i18n 多语言
• 快速查看组件：新增 QuickViewContainer 与 QuickViewPropertiesWidget 容器集成至文件面板
• 界面细节修复：修复浅色主题下标签页头部对齐及选项设置对话框页面挤压的问题

1.3.4 (2026-08-02)¶

• 文件面板界面：新增 Shift+PageUp / Shift+PageDown 批量选择文件功能
• 文件操作修复：修复 F5 复制与 F6 移动文件/目录的相关缺陷
• 构建与打包脚本：修复多张证书匹配歧义错误，给签名加上时间戳并优雅处理 macOS 公证状态

1.3.3 (2026-08-01)¶

• 核心传输引擎：实现 ProcessTransferWorker 实时传输速度与剩余时间 (ETA) 准确计算
• 权限与沙盒机制：分离 macOS 沙盒机制与完全磁盘访问权限 (Full Disk Access) 逻辑流程
• 构建打包脚本：更新打包脚本配置，支持 1.3.3 DMG 签名构建

1.3.2 (2026-08-01)¶

• 修复 Nuitka 独立打包与 App Store 模式下传输子进程冻结/无法启动的问题
• 代码审查 Skill：增加 i18n 多语言完整性审计检查规范

1.3.1 (2026-08-01)¶

• 修复 macOS 沙盒下因 os.access 校验导致误判“完全磁盘访问权限已授予”的问题
• 修复并发后台任务状态交错干扰问题
• 补充无回收站删除确认对话框中批量操作复选框的中文翻译
• 增加与更新代码审查优化审计 Agent Skill

1.3.0 (2026-08-01)¶

• 核心传输引擎：实现跨进程隔离的文件传输引擎 (ProcessTransferWorker & ProcessIOEngine)，彻底解决大文件/Samba 传输阻塞 UI 主线程问题
• 传输性能优化：加入 10Hz IPC 频率限速控制与 macOS F_NOCACHE 文件缓存优化，显著降低 GUI 卡顿与 CPU/内存占用
• 架构与并发重构：完成 4 阶段代码审查修复、安全硬化、并发互斥锁与底层引擎重构
• 界面与细节修复：修复 Shiboken C++ 对象销毁异常、水平双面板布局切换与后台进度指示器信号断开问题

1.2.0 (2026-07-30)¶

• 实现全局 I/O 进程池 (IoWorkerPool)，隔离阻塞式文件系统 I/O 防止 GUI 卡顿
• 配置文件版本控制：支持 XML 根节点读写 app_version，增加配置自动迁移 Runner 机制
• 拖拽与剪贴板：集成 macOS Finder 原生桥接，支持文件拖放及剪贴板状态机
• 路径展开：新增 expand_path 工具，支持 ~、$VAR、%VAR% 及 %COMMANDER_PATH%
• 常用列表：实现独立 HotlistConfig 单例配置管理及内置默认常用列表

1.1.0 (2026-07-29)¶

• 修正发布日志添加顺序，确保按最新时间倒序排列在 Release Note 标题下方
• 修正版本管理脚本，增加对 default_config.xml 中 System/LastVersion 节点的同步更新
• 快捷键：为标签切换添加 Meta+Tab 与 Meta+Shift+Tab 默认快捷键
• 收藏标签：增加自动迁移与清理主配置中的旧收藏标签数据
• 文件查看器：优化大文件加载性能与内存占用

1.0.1 (2026-07-22)¶

修正了沙盒环境下，无法正常预览文本文件的问题

1.0.0 (2026-07-18)¶

TotalCommander MacOS移植版的初始实现。