选择 Vault
选一个你掌控、会备份的位置。Vault 保存 Swob 会话包、索引和组织元数据；改变位置不是改变原客户端目录。
01 · QUICK START
先保住历史，再继续工作。
Swob 把各家 AI 编程客户端的本地会话汇到一个由你控制的 Vault。下面是从零到第一次续接的最短路径。
macOS current main本地优先约 3 分钟
1. 下载与安装
- 下载当前稳定版
从官网或 GitHub Releases 下载与你 Mac 芯片对应的 DMG。稳定版和 current main 的功能边界以官网标注为准。
- 首次打开未签名应用
如果 macOS 拦截，在系统设置 → 隐私与安全性中确认打开。不要从不明镜像下载。
2. 首启动三步
排除来源
取消勾选的 harness 将不显示、也不备份。以后可在设置里调整；排除不是“隐藏筛选”，而是数据边界。
延长保留期
发现 Claude Code 时，建议把本地会话保留期从默认值延长。它降低源文件被自动清理的风险，但不能替代 Vault 备份。
3. 第一次 Resume
- 在左侧选择会话
先核对来源、项目和最后更新时间。旧 ID 会尽量解析到最新的物理续接会话。
- 点击 Resume
默认走该来源可验证的终端命令；下拉菜单里只展示支持的桌面入口。
- 看清降级提示
“打开客户端”不等于“跳到指定会话”。尤其 ZCode 目前只能打开 App/工作区，Swob 会明确提示不能直达历史会话。
恢复前的安全边界
源文件缺失时，只有实际点击 Resume 才允许进入受控复活流程；复制命令和审计保持只读。
