@local/dsh-session-dustbin

Readme

# dsh-session-dustbin

**DSH 会话纸篓** — 归档的会话像丢进纸篓的纸：随时翻出来看内容，不要了连文件一起倒掉，删除即时生效、无需重启。

![plugin type](https://img.shields.io/badge/plugin-host%20%2B%20client-blue) ![license](https://img.shields.io/badge/license-MIT-blue) ![tests](https://img.shields.io/badge/tests-22%20checks-green)

<img width="1264" height="801" alt="image" src="https://github.com/user-attachments/assets/1b6eac82-df7f-4b33-962a-9fac70ef6d9b" />

<img width="1264" height="801" alt="image" src="https://github.com/user-attachments/assets/a5665b63-4d64-4eb1-a0f2-6ba5fb225405" />

在设置 → 插件 → 可配置 增加「会话纸篓」卡片：

- **归档会话纸篓**：列出已归档会话，展开可**查看对话内容**（从会话日志解码，多帧 zstd 兼容）
- **删除会话**：活跃与归档会话均可删除——先归档（侧边栏即时消失）再删文件（数据彻底清除），**无需重启**
- **恢复归档**：一键把归档会话恢复为活跃会话
- **侧边栏快捷删除**（实验性）：会话行「…」菜单注入「🗑 删除对话」，DSH 风格确认框

## 工作原理

- 列表状态实时读取平台 `workspaceRegistry` 内存服务（归档/恢复立即反映），磁盘 `~/.dsh/storages/workspace.json` 为兜底
- 会话内容从 `~/.dsh/sessions/<项目>/<id>/session.jsonl.zstd` 多帧 zstd 逐帧解码（兼容 rc.7 追加式日志格式）
- 所有操作走 **loopback 围栏**桥（`/api/dsh-session-dustbin/*`），仅本机浏览器可访问
- **删除链路**：`workspaceRegistry.archiveSession()`（内存广播，侧边栏立即收走）→ 删除会话目录 → 清理 workspace.json 标记；列表读取时过滤目录已不存在的会话，标记残留不会显示

## 已知约束

- 活跃会话的事件日志未完整落盘（关闭才 flush）→ 只能查看**归档**会话全文；活跃会话只列出不读内容
- 删除不可逆（会话目录 + 标记一并清除），卡片与侧边栏均带 DSH 风格确认框（需勾选「无法恢复」才能确认）
- 删除后重启前，DSH 侧边栏的归档分组可能残留一个点不开的空条目（平台无移除归档标记的 API；插件列表不受影响，重启后彻底干净）
- 侧边栏注入为实验性：React 重渲染可能吞掉注入项（下次打开菜单重新注入）；会话定位按标题反查，重复标题取第一个

## 仓库结构

```
dsh-session-dustbin/
├── lib/                        # 宿主侧（Node ESM，零 cordis 工具依赖）
│   ├── index.js                # 插件入口：设置段 + 路由挂载
│   ├── routes.js               # loopback 围栏桥（list / get / delete / unarchive）
│   ├── sessions.js             # workspace.json 读写 + 会话枚举/内容/删除/恢复
│   ├── zstd.js                 # 多帧 zstd 解码（rc.7 追加式日志格式）
│   ├── protocol.js             # 与客户端共享的路径/命名空间常量
│   └── client.js               # 预构建客户端 bundle（提交以便克隆即用）
├── src/client/                 # 客户端（浏览器侧，rolldown 打包）
│   ├── index.ts                # 入口：settings.plugin.item keyed 卡注册
│   ├── SessionAdminCard.tsx    # 会话纸篓卡片（列表/内容/删除/恢复）
│   ├── sidebar-inject.tsx      # 实验性：侧边栏会话菜单注入「删除对话」
│   ├── locales.ts              # zh / en 文案
│   └── session-card.module.css
├── docs/                       # installation / troubleshooting / architecture
├── build-client.mjs            # 客户端构建脚本
├── sync-profile.mjs            # 同步插件到 profile（清拷贝 + 重装 + 校验）
├── smoke-client.mjs            # 客户端冒烟测试
├── test-sessions.mjs           # 宿主逻辑测试
└── cordis.patch.yml            # profile bundle 注册补丁
```

## 开发

```bash
node test-sessions.mjs          # 宿主逻辑测试（临时目录，不碰真实数据）
node build-client.mjs           # 重建客户端 bundle
node smoke-client.mjs           # 客户端冒烟
node sync-profile.mjs           # 同步到 profile（file: 实体拷贝），然后重启 DSH
```

架构细节见 [docs/architecture.md](docs/architecture.md)，安装见 [docs/installation.md](docs/installation.md)，排障见 [docs/troubleshooting.md](docs/troubleshooting.md)。