dsh-session-dustbin

dsh-session-dustbin

DSH 会话纸篓 — 在左侧会话行菜单里直接删除会话（与「重命名 / 分支会话 / 归档会话」并列），并在 设置 → 插件 → 可配置 里管理已归档会话。

v0.2.0 为全新重写：旧仓库代码已全部作废，本目录可整体覆盖 Github-CJX/dsh-session-dustbin。

功能

• 左侧会话菜单删除项：会话行「⋯」菜单里在「归档会话」下方追加「🗑 删除会话」，点击后弹出 DSH 风格确认框（需勾选「我了解这会永久删除，且无法恢复」）。
• 删除链路（无需重启）：先经平台 workspaceRegistry.archiveSession() 归档（侧边栏立即收走该行）→ 删除本地会话目录 → 删除头帧缓存 → 清理 workspace.json 标记。
• 归档会话管理卡片：设置 → 插件 → 可配置 → 「会话纸篓」，列出归档会话，逐条删除。
• 只展示头帧：列表只读取平台为每个会话持久化的头帧投影（session_projcache，标题 / 创建时间 / 轮数），从不解压 session.jsonl.zstd，单条 O(1)，与对话长度无关。
• 无需查看详情：没有任何对话内容读取接口，也不提供展开查看——按需求刻意不做。

工作原理

删除顺序（缺一不可）：

删除请求
  ├─① workspaceRegistry.archiveSession(id)   内存归档 + 广播 → 侧边栏立即收行
  ├─② 删除 ~/.dsh/sessions/<项目>/<id>/     数据彻底清除
  ├─③ 删除头帧 session_projcache/<id>.json   列表不会复活该行
  └─④ 清理 workspace.json 标记（尽力而为）    运行中的 host 可能回写，列表按目录存在性过滤

目录结构

dsh-session-dustbin/
├── lib/                       # 宿主半（Node ESM）
│   ├── index.js               # 插件入口：设置命名空间 + 路由挂载
│   ├── protocol.js            # 共享常量（命名空间 / 路由 / id 校验）
│   ├── sessions.js            # 头帧读取、列表、删除（框架无关，可单测）
│   ├── routes.js              # loopback 围栏桥（ping / list / delete）
│   └── client.js              # 预构建客户端 bundle（提交以便克隆即用）
├── src/client/                # 浏览器半（rolldown 打包）
│   ├── index.ts               # 入口：locale + 设置卡片 + 侧边栏菜单注入
│   ├── DustbinCard.tsx        # 会话纸篓卡片（头帧列表 / 删除）
│   ├── sidebar-menu.tsx       # 会话行菜单注入「删除会话」
│   ├── locales.ts             # zh / en 文案
│   ├── protocol.ts            # 与 lib/protocol.js 对应的类型
│   └── dustbin-card.module.css
├── docs/                      # installation / architecture / troubleshooting
├── build-client.mjs           # 客户端构建（CSS Modules 内联 + ModuleLoader 包装）
├── sync-profile.mjs           # 一键装进 DSH profile（镜像 + 注册 + pnpm install）
├── test-host.mjs              # 宿主逻辑测试（临时目录，不碰真实数据）
├── test-mount.mjs             # 挂载测试（桩 cordis ctx）
└── smoke-client.mjs           # 客户端 bundle 冒烟（桩 loader/DOM）

开发与验证

pnpm install
node test-host.mjs      # 42 checks：头帧/列表/删除/围栏
node build-client.mjs   # 重建 lib/client.js
node test-mount.mjs     #  9 checks：设置段 + 三条路由 + 处理器
node smoke-client.mjs   # 14 checks：bundle 契约 + apply() 挂载
node sync-profile.mjs   # 装进 profile（然后重启 DSH Desktop）

样式一致性

• 卡片严格复用平台的卡片契约：外壳 / 头部 / 正文 / 页脚取自 @deepseek-ai/dsh-client-ui-settings-plugins 的 PluginCard.module.css，行 / 标签 / 胶囊 / hint 取自同包的 fields.module.css（数值逐条照抄，仅类名本地化），因此在「设置 → 插件 → 可配置」里与「终端」「agent 循环」等卡片外观一致。
• 菜单注入项深拷贝平台的「归档会话」项，图标用平台原生 IconTrashOutline16 的路径，配色与 hover 走 Menu.module.css 的 .danger 令牌（--dsw-alias-state-error-primary / --dsw-alias-interactive-bg-hover-danger）。

已知约束

• 菜单注入是 DOM 注入：平台会话菜单是 dsh-client-ui-workspace 里写死的数组，没有 slot 可扩展。注入项在菜单每次打开时重新追加；React 重渲染可能吞掉已注入节点，重开菜单即恢复。
• 会话 id 靠标题反查：会话行 DOM 不携带 id，注入项点击后通过 list 桥按标题匹配（重复标题取第一个）。
• 删除不可逆：目录 + 头帧 + 标记一并清除，卡片与菜单均带需勾选的确认框。
• 残留标记：运行中的 host 内存里仍保留已删 id，直到下次重启才彻底干净；列表按目录存在性过滤，不会显示空条目（卡片会提示「N 条归档标记已无对应数据」）。
• 不读对话内容：这是刻意设计（性能），需要看内容请用平台的会话打开功能。

安装与排障见 docs/installation.md、docs/architecture.md、docs/troubleshooting.md。