dsh-archive-workbench

LIMITATIONS

Known limitations

### 正在运行的会话（重要） DeepSeek Harness **没有**任何公开 API 能让一个会话从内存中退出。因此对于**本次运行中打开过、还驻留在内存里**的会话，删除文件不够 —— 它可能立刻把日志重新写回来。 插件的处理方式是： 1. 先调用官方 `archiveSession({ stopActivity: true })`，停掉它正在跑的工作并封住后续写入 2. 等它空闲（最多 `idleTimeoutMs`） 3. 再删文件 4. 删完**反复复查**（最多 `settleAttempts` 次）确认文件没有重新出现 如果文件仍然被重建，插件会**明确报错**并且**把归档状态回滚**（不会留下一个"删失败却被归档了"的会话）： > the session is still resident in this application and keeps recreating its log; restart the application and delete it again **建议**：如果要删的是"当前正在用/刚用过"的会话，**先重启一次应用再删** —— 重启后它变成冷会话，删除是干净的。 ### 找不到日志目录 如果会话在存储里存在、但在当前会话根目录下找不到对应文件夹，插件返回 **409** 并提示检查 `DSH_HOME` 或 `sessionsRoot`，而不是假装删成功。反过来，如果存储里和磁盘上都已经没有这个会话，重复删除是**幂等成功**（`alreadyGone: true`），方便脚本重试。 ### 附件不会被删除 `~/.dsh/attachments/` 里的图片/附件**不会**被删除。它们按内容哈希全局共享，多个会话可能引用同一个对象 —— 按会话去删会破坏其他会话。也正因如此，删一个会话回收的空间通常**远小于**它在附件目录里的占用。 ### 子智能体会话 子智能体（subagent）产生的会话**不会**出现在侧边栏，因此无法从 UI 删除。这是官方行为。 ---