Github-CJX/dsh-session-dustbin

README 摘要

dsh-session-dustbin DSH 会话纸篓 — 归档的会话像丢进纸篓的纸：随时翻出来看内容，不要了连文件一起倒掉，删除即时生效、无需重启。 在设置 → 插件 → 可配置 增加「会话纸篓」卡片： - 归档会话纸篓 ：列出已归档会话，展开可 查看对话内容 （从会话日志解码，多帧 zstd 兼容） - 删除会话 ：活跃与归档会话均可删除——先归档（侧边栏即时消失）再删文件（数据彻底清除）， 无需重启 - 恢复归档 ：一键把归档会话恢复为活跃会话 - 侧边栏快捷删除 （实验性）：会话行「…」菜单注入「🗑 删除对话」，DSH 风格确认框 工作原理 - 列表状态实时读取平台 workspaceRegistry 内存服务（归档/恢复立即反映），磁盘 /.dsh/storages/workspace.json 为兜底 - 会话内容从 /.dsh/sessions/ / /session.jsonl.zstd 多帧 zstd 逐帧解码（兼容 rc.7 追加式日志格式） - 所有操作走 loopback 围栏 桥（ /api/dsh-session-dustbin/ ），仅本机浏览器可访问 - 删除链路 ： workspaceRegistry.archiveSession() （内存广播，侧边栏立即收走）→ 删除会话目录 → 清理 workspace.json 标记；列表读取时过滤目录已不存在的会话，标记残留不会显示 已知约束 - 活跃会话的事件日志未完整落盘（关闭才 flush）→ 只能查看 归档 会话全文；活跃会话只列出不读内容 - 删除不可逆（会话目录 + 标记一并清除），卡片与侧边栏均带 DSH 风格确认框（需勾选「无法恢复」才能确认） - 删除后重启前，DSH 侧边栏的归档分组可能残留一个点不开的空条目（平台无移除归档标记的 API；插件列表不受影响，重启后彻底干净） - 侧边栏注入为实验性：React 重渲染可能吞掉注入项（下次打开菜单重新注入）；会话定位按标题反查，重复标题取第一个 仓库结构 开发 架构细节见 docs/architecture.md，安装见 docs/installation.md，排障见 docs/troubleshooting.md。

分类