dsh-plugin-workspace-archive

LIMITATIONS

Known limitations

- **「删除工作区」立即归档，「目录缺失」要等几秒**，这不是不一致：目录缺失是一次 `stat` 的观测，可能抖（网络盘、改名中途），所以要等确认窗口（默认 3 秒）；而「删除工作区」是官方注册表的权威变更，且**本次运行中见过这条登记**，所以立即动手。插件刚启动、注册表还没铺完时不会走这条快路（那时"不在清单里"和"被删了"分不清），会退回确认窗口。 - **归档 / 恢复只认它记过账的会话**：若"删除 → 重新添加"发生在插件没运行的时候，它只认得台账里最后一次快照 —— 快照里有的成员会被挂回，更早散掉的不会（这类可以由启动时的**归位**补上，前提是 cwd 仍等于该工作区路径）。 - **挂回分组 ≠ 取消归档**：`attach` 只动工作区成员表，从不碰归档集合。 - **归位只跑一次**（启动后延迟 5 秒）：之后新出现的孤会话要等下次重启。 - **跨工作区迁移做不到**：需要在离线改写会话日志的 header，官方没有这个通道；而且即使改写成功，官方也**没有公开入口**去重建它在内存里缓存的会话 header ⇒ 必须重启 DSH 才生效。⇒ 这是一条**上游能力缺口**，本插件**不提供**该功能。完整的探索记录（机制、实测证据、为什么做不到）见 [docs/plan-session-migration.md](docs/plan-session-migration.md) —— 该目录**不随 npm 包发布**。 - 不做会话删除、不删文件夹、不做跨机器同步。 - 目录被**改名**等于换了一个路径：挂回时官方会校验 cwd，对不上时插件只记日志、不改数据。