每一步进展，
都有时间可循。

认证修复提交通过原生与安装包检查

精确主线提交通过 CI，生成经过验证的 0.2.5_2026.10.13 开发安装包，解决此前原生构建阻塞。

• 63 项核心测试与 27 项离线 AppKit 测试通过，其中 13 项连接认证测试覆盖布局、凭据生命周期、回滚和辅助入口校验。凭据存储测试使用模拟存储，并非真实 macOS 钥匙串访问。
• 原生版本管理与旧构建清理回归、arm64 Release 编译、原生图标编译、磁盘映像验证及应用拷贝后签名检查通过；独立 lrzsz 检查通过本机字节通道完成双向 100 MiB 与多文件 SHA-256 校验。
• 真实密码登录、钥匙串权限提示、重试和多因素认证仍待验收，真实 JumpServer 的 sz 恢复、鼠标交互与 Finder 安装也未完成验收。安装包仅作 ad-hoc 签名，未做 Developer ID 公证或公开发布。

精确主线工作流、原生测试结果与安装包验证产物 · b896fdf · CI #38274766829

认证模块导出修复进入主线

原生认证辅助接口显式导出给 Swift，修复导致上一轮构建停止的符号缺失问题。

• 改动导出既有 SSH 父子进程校验接口，没有绕过安全检查；安装、连接表单与密码认证源码改进继续保留在主线。
• 此节点记录源码修复；成功的原生与安装包验证单独记录在后续 CI 节点中，不代表公开发布。

主线认证头文件导出差异 · b896fdf

新增认证提交遇到原生构建阻塞

0.2.4_2026.10.12 主线提交在原生编译阶段失败，本次未生成经过验证的安装包。

• 编译器无法解析新增 SSH 认证流程调用的辅助函数，完整原生测试、Release 编译、签名与 DMG 验证未完成。
• 原生版本管理与旧构建清理回归在编译停止前通过；独立 Linux 核心与互通任务也通过。这些结果不代表原生认证或 macOS 钥匙串访问验证通过。
• 上一版 0.2.3 仍是最后一个通过原生 CI 验证的安装包，其成功记录不能套用到本次新提交。Mac 实机验收与公开发布仍待完成。

精确主线工作流与原生编译失败记录 · c4a9cf8 · CI #38274238338

安装、连接表单与密码认证改进进入主线

主线加入构建副本清理、单实例启动、固定连接表单与钥匙串密码认证的源码实现。

• 打包改动用于清理临时开发副本并区分安装镜像与已安装应用，同时保留既有连接数据。
• 连接表单增加密码、私钥和兼容旧配置的终端交互模式。源码实现使用 macOS 钥匙串保存密码；真实登录、权限提示、重试和多因素认证尚未验收。
• 此时间记录源码提交，不代表原生验证成功；后续 CI 节点记录了本次构建失败。

主线提交差异与安装、认证实现说明 · c4a9cf8

构建兼容性修复通过原生验证

精确主线提交通过 CI，并生成经过验证的 0.2.3_2026.10.12 开发安装包。

• 原生 macOS 回归确认：即使 PATH 中优先出现不兼容的 date 命令，显示版本、纯数字版本和版本元数据输出也不受影响。
• 51 项核心测试与 14 项离线 AppKit 测试通过，arm64 Release 编译、原生图标编译、磁盘映像验证及应用拷贝后签名检查也通过。
• 独立 lrzsz 检查通过双向 100 MiB 与多文件 SHA-256 校验，覆盖中文文件名和同名文件保护；检查使用本机字节通道，不是真实 JumpServer 会话。
• 安装包仍仅使用 ad-hoc 签名，未公证或公开发布。真实 JumpServer 的 sz 恢复、鼠标交互和 Finder 安装仍待验收；密码保存尚未实现。

精确主线工作流与原生版本、构建及安装包日志 · 99e9463 · CI #38268048582

macOS 同名 date 命令构建修复进入主线

版本生成改为直接调用 macOS 系统 date 工具，避免 PATH 中的 GNU date 导致构建中断。

• 保留既有构建入口、按提交递增的版本号及 Asia/Shanghai 提交日期，不修改用户的 PATH 或终端设置。
• 新增显示版本、纯数字版本与元数据输出的原生 macOS 回归；验证结果单独记录在后续 CI 节点中。本提交没有改变终端或文件传输行为。

仅涉及版本生成与回归测试的主线提交差异 · 99e9463

整合主线通过原生与 DMG 验证

精确主线提交通过 CI，并生成经过验证的 0.2.2_2026.10.12 开发安装包。

• 51 项核心测试与 14 项离线 AppKit 测试通过，随后 arm64 Release 编译、原生图标编译、hdiutil 映像验证及应用拷贝后签名检查通过；此前图标打包阻塞已解决。
• 独立 lrzsz 上传下载通过 100 MiB 与多文件 SHA-256 检查；这些本机协议检查不代表真实 SSH 或 JumpServer 验收。
• 0.2.2 依据 main 的首父提交历史计算，不能与其他分支的安装包直接按数字排序。此私有 CI 产物仅为 ad-hoc 签名，未公证，也不是公开版本。
• 真实 JumpServer 的 sz 恢复、鼠标交互与 Finder 安装仍待验收；密码保存尚未实现。

精确主线工作流、原生构建日志与验证 DMG 产物 · 57980ec · CI #38262575902

产品改进整合进入主线

在原有主线基线上，通过 38 文件整合提交纳入已开发的产品改进。

• 包含 sz 收尾代码修复、终端交互与查找、主题与品牌、与官网一致的系统自适应图标，以及确定性 DMG 打包。
• 此处为整合提交的记录时间，不是 PR 合并或推送事件时间；验证结果见后续 CI 节点。

主线整合提交与文件差异 · 57980ec

新图标候选版遇到打包阻塞

最新开发提交加入跟随系统变化的 Dock 图标与统一安装入口。原生测试及 Release 编译通过，但图标打包失败。

• 51 项核心测试、14 项离线 AppKit 测试通过，独立协议互通任务也通过；这些检查不代表真实 SSH 或 JumpServer 验收。
• 原生资源编译器在打包时拒绝图标格式。本次提交未生成验证 DMG；此前通过验证的 0.2.5 安装包仍属于历史开发候选产物。
• 本次提交尚未合入 main，也未公开发布。密码保存与 sz 收尾修复的真实 JumpServer 验收仍待完成。

最新候选工作流与原生打包日志 · 6ab2086 · CI #38261039524

最新候选版通过原生与 DMG 检查

开发分支再次通过完整原生构建，安装包版本为 0.2.5_2026.10.12。

• 51 项核心测试与 11 项离线 AppKit 测试通过；独立 lrzsz 对端通过本机字节通道完成双向 100 MiB SHA-256 校验。
• CI 实际生成 Docklark_0.2.5_2026.10.12_arm64.dmg，并验证磁盘映像校验与应用拷贝；仍是 ad-hoc 开发签名安装包，未做 Developer ID 公证。
• 最新提交增加审查工具，没有新增应用行为；应用变更仍与 91dc644 一致，尚未合入 main，真实 JumpServer 下载验收仍待完成。

候选分支原生构建与独立协议工作流 · 9171b96 · CI #38259334994

主分支新增独立 DMG 脚本

在既有 0.1.0 应用基线上新增打包脚本。

• 本次 main 提交仅改动打包脚本，不包含候选分支的品牌、终端交互、sz 修复或自动版本管理。
• 随后主分支工作流于 21:54（UTC+08:00）通过，但只运行既有应用检查，未执行这个新 DMG 脚本；其打包结果尚未验证。

主分支提交差异与工作流范围 · 7fd496f · CI #38258630632

首个日期版本候选安装包验证通过

修正快捷键路由与无界面测试假设后，候选版原生工作流通过。

• 51 项核心与 11 项离线 AppKit 测试、arm64 Release 构建及独立 lrzsz 双向 100 MiB 检查通过。
• 工作流实际构建并校验 Docklark_0.2.4_2026.10.12_arm64.dmg；这是 CI 开发候选产物，不是公开或已公证版本。

候选打包实现后的原生 CI · 91dc644 · CI #38253110162

加入拖拽安装 DMG 与日期版本

开发分支加入 Docklark.app / Applications 双图标安装包，以及按提交确定的版本号。

• 显示版本采用 x.x.x_yyyy.mm.dd；修订号依据 first-parent 提交历史递增，日期使用 Asia/Shanghai。同一提交重建时版本不变。
• 打包加入原生 hdiutil 校验及应用拷贝、签名检查；此时实现位于候选分支，检查结果见后续 CI 节点。

候选分支打包与版本管理提交 · 91dc644

加入原生交互与 sz 恢复候选实现

新开发分支加入 Docklark 品牌、外观控制、终端交互、查找及定向 ZMODEM 收尾修复。

• 加入关于信息、提供的应用图标、系统/浅色/深色外观及统一连接编辑器，并保留既有连接配置。
• 加入选中复制、中键单次粘贴、绑定会话的右键操作及当前/全部标签查找；原生快捷键路由在后续提交中修正。
• sz 改动只放宽完整文件校验与 ZFIN 交换后的结束阶段，保留 CRC、长度校验及未完成传输保护；真实 JumpServer 恢复尚未验收。
• 初期原生构建与快捷键测试失败，在后续绿色 CI 节点前得到修正；密码保存与跟随系统变化的应用图标仍未完成。

开发分支实现与变更说明 · c0df5c6

下一步：产品打磨与传输恢复

已记录下一轮需求；本轮应用修复尚未得到验证。

• Docklark 名称、应用图标、关于信息与跟随系统外观。
• 简化连接设置、密码保存支持，以及 sz 结束后终端卡住的问题。
• 当前打磨分支仅增加源码快照工作流；归档成功不等于原生应用构建通过。

需求记录；分支状态核查于当日 19:00（UTC+08:00） · 83c89ef

拖拽上传可用；sz 结束仍会卡住

实机反馈确认拖拽上传可用；sz 下载的文件已到达本地，但传输结束后终端仍卡住。

• 终端恢复仍是待修复缺陷。文件到达不代表下载全流程或文件完整性检查已经通过。

用户真实环境操作反馈

主分支通过原生构建与协议检查

整合后的 main 提交已通过原生 macOS 工作流。

• 47 项原生 XCTest：43 项核心测试、4 项离线 AppKit 测试；arm64 Release 构建与本地 ad-hoc 签名验证通过。
• 独立 lrzsz 对端通过本机字节通道完成双向 100 MiB 哈希校验及同名保护检查。
• 这些是 CI 与离线检查，不代表真实 SSH / JumpServer 传输验收、Developer ID 正式签名或公证。

Native macOS build and core tests · e8ede8e · CI #38231569612

0.1.0 联合验收版进入主分支

五项首版功能已在源码中整合交付，并补齐测试报告与联合验收说明。

• 连接保存、分组、搜索与收藏；持久化快捷命令；标签与独立窗口。
• 同会话 ZMODEM 上传下载、拖拽上传、进度、同名保护与取消处理。
• 这是待验收的源码交付，尚未发布公开安装包或公开版本。

主分支交付提交与验收文档 · e8ede8e

工作空间与传输实现加入开发分支

开发分支加入原生 ZMODEM、持久化连接与命令配置、多标签及工作空间。

• 后续测试与修复补充传输安全、独立互通、离线生命周期、紧凑标签及超大配置保护。

实现提交；之后随 0.1.0 进入 main · bc7c6c3

记录 Mac 实机连接验证结果

直连 SSH，以及登录 JumpServer 后进入目标服务器，已获实机反馈确认可用。

• 此时间为验收反馈写入仓库的时间，并非测试执行时间；该基线不覆盖之后新增的传输功能。

基于用户反馈的原型验收记录 · 1839664

原生 SSH / JumpServer 原型合并

首个连接原型与本地 macOS 构建流程进入 main。

• 原生 AppKit 窗口与终端会话建立连接基线；在这个时间点，ZMODEM 与持久化工作空间尚未加入。

原型合并提交 · 4f5cfc5

建立项目与首版范围

启动 Apple Silicon SSH 工作空间项目，将 JumpServer 与同会话文件传输列入首版目标。

初始项目规格提交 · d5d023a