功能定位：为什么需要“层级保留”导出
SafeW 的加密保险库（Encrypted Vault）不仅存私钥，还把链上凭证、NFT 原图、合约 ABI 等按“链/项目/日期”多级文件夹收纳。当用户需要向会计、审计或 DAO 财务面板批量提交资产清单时，如果 CSV 只有扁平条目，后期对账必须人工反推目录，耗时且易错。2026-04 版本起，SafeW 在桌面端加入“Keep Directory Structure”开关，可把完整层级写进 CSV 的 path 列，一次性解决“扁平导出”带来的追溯难题。
前置检查：版本、权限与空间
1. 版本：桌面端需 ≥7.4.0（菜单 Help → About 可见）。移动端暂不支持批量导出，仅可单条分享。
2. 权限：保险库必须已解锁（生物识别或主密码）。若启用 MPC 多签，需要本地私钥片完整，否则导出按钮置灰。
3. 空间：经验性观察，十万条记录含缩略图路径约 1.2 GB，建议预留双倍磁盘作为临时缓存。
最短操作路径（Windows / macOS / Linux）
Windows 10/11
- 主界面左侧栏点 Vault → 右上角“⎘”图标 → Export Batch。
- 弹窗中格式选 CSV；右下“Advanced”展开 → 勾选 Keep Directory Structure。
- Encoding 下拉选 UTF-8-BOM（默认 Excel 可识别）。
- 选输出目录，例如 D:\exports\，点 Start；等待进度条 100% 后，同级生成 safew_export_日期_time.zip 与 .csv 双文件。
macOS 13+
- 菜单栏 File → Export → Batch CSV。
- 同样勾选 Keep Directory Structure；若后续要用 Numbers 打开，建议编码选 UTF-8（无 BOM）。
- 输出路径避免 iCloud Drive 实时同步目录，经验性观察大文件易触发重复上传冲突。
Linux（deb 或 AppImage）
- 标题栏 ⋮ → Export → Batch CSV。
- 若通过 CLI 调用，示例：safew --vault-export --format=csv --keep-tree --out=/home/user/exports/；命令行同样支持 --encoding=utf-8。
核心设置项拆解
| 设置项 | 作用 | 不勾选后果 |
|---|---|---|
| Keep Directory Structure | 在 CSV 新增 path 列，如 ETH/DeFi/2026-05/aave_ vault.json | 仅输出文件名，丢失层级，不利于对账 |
| Include Thumbnail | 同目录生成 160 px 缩略图，方便人工识别 NFT | 体积增大约 25%，若只关心地址可关闭 |
| Encoding | UTF-8-BOM 兼容 Excel；UTF-8 通用；GB18030 仅国内旧系统 | 乱码风险，需二次转码 |
例外与副作用：何时不该一键导出
1. 保险库含“零知识地址”且勾选明文导出时，CSV 会暴露接收链与金额，虽然不含私钥，但可能降低匿名集；若用于公开报告，应改用 KYT 合规报告通道（Settings → Compliance → Generate KYT Report）。
2. 当文件夹层级深度 ≥7 级，Windows 资源管理器在 260 字符路径限制下会出现“文件名过长”警告；缓解办法：导出到盘符根目录，或在 Settings → Advanced → Long Path Support 开启实验选项（需 7.4.1b+）。
3. 同时运行第三方索引工具（Everything、Alfred）时，大批量写入可能触发实时扫描，CPU 占用短时升高；可在导出前暂停索引服务，或把输出目录加入排除列表。
验证与回退：如何确认数据完整
快速校验
- 打开 CSV，筛选 path 列，确认含“/”或“\”分隔符即代表层级。
- 随机抽 10 条，在 SafeW 内搜索文件名，核对地址、余额、备注三字段一致。
- 若发现缺失，检查保险库是否“部分离线”——即某些链仅保存在冷分片；需先同步后再导出。
回退方案
SafeW 每次批量导出都会在临时目录保留 JSON 中间文件 48 小时，路径见日志（Help → Debug → Open Log Folder → export_tmp）。若 CSV 被误删，可重新压缩上传至 SafeW 的“Import → Restore from Cache”恢复，无需重新扫描链上数据。
性能与成本实测
测试环境：Windows 11 + Ryzen 7 7840U + 32 GB RAM，保险库含 5.3 万条记录，启用缩略图。导出耗时约 90 秒，峰值内存 1.8 GB，最终 ZIP 1.05 GB；关闭缩略图后耗时降至 55 秒，体积 410 MB。经验性观察，瓶颈主要在磁盘 IO 与缩略图编码，若使用 PCIe 4.0 SSD，时间可再缩短 15% 左右。
与第三方协同：最小权限原则
部分用户会把 CSV 直接喂给 Google Sheets 做透视表，需先删除含“privateKey”或“mnemonic”列（即使导出时已默认隐藏）。若通过 API 上传到内部 ERP，建议启用“一次性读令牌”——在 SafeW Settings → API → Scoped Token 只勾选 vault:read，有效期 6 小时，降低泄露风险。
故障排查 3 步法
现象：导出按钮灰色不可点
可能原因：① 保险库未解锁 ② 本地分片缺失 ③ 链正在全量同步
验证：看标题栏是否显示“Lock”图标；点击 Settings → Sync Status，若任一链进度条低于 100%，等待完成再试。
现象：CSV 中文乱码
处置：重新导出，编码选 UTF-8-BOM；若已发送给对方，可用 Notepad++ 转“以 UTF-8-BOM 编码保存”。
现象：压缩包无法解压，提示头损坏
原因：导出时磁盘满或防病毒拦截临时文件。
验证：查看日志末行“write errno=28”即磁盘空间不足；清理后重新导出即可。
适用 / 不适用场景清单
| 场景 | 是否推荐 | 理由 |
|---|---|---|
| 个人年度税务申报 | ✔ | 层级保留方便与交易所 PDF 对账 |
| DAO 万人空投 | ✔ | 可快速筛选“NFT 类/ERC20 类”分文件夹发放 |
| 高频量化策略实时日志 | ✘ | 每分钟上千笔，CSV 体积膨胀，应改用 API 流式推送 |
| 合规机构需 SHA-256 摘要 | ✘ | 应使用 SafeW 官方 KYT 报告，含签名与时间戳 |
最佳实践 6 条
- 导出前先创建“年度-月份”子目录，避免不同期文件混淆。
- 命名规则：safew_链名_用途_YYYYMMDD.csv，方便 Shell 批量处理。
- ≥10 万条记录分片导出，每片 3 万条，降低 Excel 104 万行溢出风险。
- 把 CSV 与 ZIP 同时写入加密外置硬盘，形成“双介质”冷备份。
- 上传云端前，用 7-Zip “加密文件名”二次打包，防止对象存储元数据泄露。
- 每季度抽查 1% 记录做哈希对比，确保备份未被静默损坏。
FAQ（结构化数据）
移动端能否批量导出？
暂不支持。iOS/Android 仅提供单条“分享-CSV”选项；若需完整层级，请使用同一账户登录桌面端后导出。
导出时提示“Path too long”怎么办？
把输出目录改到盘符根目录，如 D:\，并在 Settings → Advanced 打开 Long Path Support（7.4.1b+）。
能否自动定时导出？
官方未提供计划任务。可在系统任务计划程序调用 safew --vault-export 命令，并配合 --quiet 参数实现无人值守，但需确保保险库已预先解锁。
收尾：下一步行动
如果你正面临季度对账、DAO 财务披露或冷备份合规检查，现在就可以在桌面端 SafeW 里按本文步骤一键导出带层级的 CSV。导出后，先用 10% 抽样核对，再按“年度-链-用途”命名归档，即可在审计来临时 5 分钟内提供完整证据包。下次更新前，SafeW 官方日志显示团队正调研“增量导出”以缩短二次备份时间，届时可关注 Release Note 并验证是否支持你的场景。