@kira905/dsh-butler-archive

LIMITATIONS

已知限制

1. **恢复后要重启一次 DSH** 才能看到会话回到侧边栏。插件已经把 `workspace.json` 里的 `archivedSessionIds` 标记摘掉，但主进程运行中的内存 registry 不同步。 2. **删除不可撤销**：不进回收站、没有 undo。请先用「预览」确认内容。 3. **归档目录的批次约定**：归档根下按批次目录组织（`<批次时间戳>/<会话 id>/`）， 这是主流的归档脚本约定；若你的会话直接平铺在归档根下，插件会把它当批次名处理、 可能列不出来。可用 `archive.manifestFile` 配合批次清单（`[{from,to,mb,ageD}]`）改善恢复定位。 4. **恢复目标目录推导**依赖 `cwd → sessions 项目 key` 的规则；三者都取不到 cwd 时 落到 `archive.unknownCwdKey`（默认 `_no-cwd`），会话能恢复但可能显示在「未知工作目录」分组下。 5. **会话日志格式是主包私有格式**，可能随主包升级变化（见第五节末）。 6. **元数据兜底要解头部若干帧**（`archive.headerFrames`，默认 8）：只有会话头的帧很小， 所以成本可忽略；但若某会话前 8 帧里都没有 `user/message`，列表里标题会显示为会话 id 兜底值。 7. **自动归档只处理「目录里放着数据文件的会话」**：不负责判断会话是否重要，只按 「未活跃时长 + 回合闭合 + 非空壳」三条机械判据筛选，请先长期用试跑模式观察候选名单。 8. **未做 i18n 全语种覆盖**：内置 `zh` / `en`，其余语言回退 `en`。 ---