Overview
@kira905/dsh-butler-archive
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known 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`。 ---