Huo-yang/dsh-session-trash

dsh-session-trash

为 DSH Web GUI 添加会话删除与回收站

会话菜单一键移入回收站，在统一面板中恢复或彻底删除

支持保留天数、删除确认与到期自动清理，设置融入原生界面

= 24" />

简体中文 | English

安装 ·
界面预览 ·
开发 ·
贡献指南 ·
更新记录

功能

- 会话行菜单：在「…」菜单中添加「移入回收站」和「彻底删除」。
- 回收站面板：查看已删除会话，支持恢复、逐条永久删除和清空。
- 侧边栏入口：回收站有内容时显示绿色状态点，不显示数字角标。
- 原生设置分区：配置暂存、保留天数、确认提示和到期自动清理。
- 列表同步：按精确会话 ID 隐藏已删除条目，并处理日志已删除但仍留在列表中的会话。

DSH 原生“删除工作区”只移除工作区登记，保留项目目录和会话日志；本插件负责会话级回收站与物理清理。删除工作区不会批量删除其中的会话，恢复时原工作区若已不存在，会话将显示在“未分组”中。

界面预览

会话菜单

在会话的「…」菜单中直接移入回收站或彻底删除。

会话菜单中的移入回收站与彻底删除操作

回收站面板

集中查看已删除会话，并执行恢复、永久删除或清空回收站。

包含恢复、永久删除、设置和清空操作的会话回收站

会话删除设置

在 DSH 原生设置界面中配置回收站、保留天数、确认提示和自动清理。

DSH 会话删除设置页面

兼容性

| 项目 | 当前范围 |
| --- | --- |
| DSH | 面向 0.1.5-rc.x；锁定依赖包含 0.1.5-rc.2，未保证所有版本兼容 |
| 界面 | DSH Web GUI；菜单识别依赖中文「归档会话」文案 |
| Node.js | 开发基线为 Node.js 24，本地验证版本为 24.11.0 |
| 包管理器 | pnpm 11.19.0，由 packageManager 固定 |
| 系统 | Windows 已做本地隔离验证；GitHub CI 配置覆盖 Windows / Linux，远端结果待运行 |

菜单与工具栏使用 DOM 注入，部分身份识别依赖 React 内部结构，上游升级后需要重新验证。英文 README 不代表插件界面已完整支持英文。

安装

前提：已安装 DSH。推荐从项目的 GitHub Releases 页面下载对应版本的 dsh-session-trash-.tgz，并按同页 SHA256SUMS.txt 校验文件。

将下载的压缩包直接交给 DSH 安装，无需手工解压：

dsh plugin --profile trash add "C:\Downloads\dsh-session-trash-0.1.1.tgz"

仅当该 profile 尚未配置 Web GUI 时，再添加 Web 插件，然后启动 DSH：

dsh plugin --profile trash add "@deepseek-ai/dsh-web-app@0.1.5-rc.2"
dsh --profile trash --port 3080

打开 DSH 输出的访问地址，并按提示使用访问令牌。发布包通过 GitHub Release 提供，不发布到 npm。源码目录安装见开发。

删除与恢复

| 操作 | 行为 |
| --- | --- |
| 移入回收站 | 默认只记录索引，日志保持原位，可以恢复 |
| 关闭暂存后点击移入回收站 | 先明确确认永久删除，再发送永久删除请求 |
| 会话菜单中的彻底删除 | 始终确认；成功后清理日志和工作区关联 |
| 清空回收站 | 逐条处理，失败项保留并显示原因 |
| 到期清理 | 启动时检查一次，此后每 30 分钟检查 |
| 恢复 | 确认日志仍在，或将完整暂存目录搬回原位置后，再移除索引 |
| 删除工作区 | 遵循 DSH 原生行为，只移除工作区登记；不会触发会话批量删除 |

删除请求携带固定意图：确认期间另一页面修改策略，不会把软删除升级成永久删除。删除当前会话时，会尽可能先切换到另一条可用会话。

如果已经开始物理删除，日志可能不完整，插件会拒绝自动恢复并保留条目供重试删除；不会提示虚假的恢复成功。软删除仅对启用插件的 Web 客户端隐藏条目，其他客户端仍可能看到日志。

默认设置

| 设置 | 默认值 |
| --- | --- |
| 暂存 | 开启 |
| 保留时间 | 30 天；0 表示永久保留，最大 3650 天 |
| 移入回收站前确认 | 关闭 |
| 清空 / 回收站逐条永久删除确认 | 开启 |
| 自动清理到期会话 | 开启 |

$DSH_HOME/
├── sessions/                         原始会话日志
└── storages/
├── dsh_session_trash.json         策略、回收站索引和删除进度
└── dsh_session_trash_files/       永久删除过程中的暂存目录

路径与清理间隔当前由代码设定；运行时删除策略通过设置分区修改。

开发

源码目录仍可用于本地安装：

pnpm install --frozen-lockfile
pnpm run check
$pluginPath = (Get-Location).Path
dsh plugin --profile trash add "$pluginPath"

本地 profile、测试数据、构建目录和发布产物均不纳入版本管理。

pnpm test                  # 仅运行隔离测试，不连接真实 DSH
pnpm run test:handlers     # Host 端点行为
pnpm run test:store        # 文件操作、恢复与并发
pnpm run test:client       # 探测调度与菜单处理
pnpm run docs:check        # 文档本地链接检查
pnpm run typecheck         # 项目 TypeScript 检查，当前 checkJs=false
pnpm run build             # 生成 Host / 浏览器产物
pnpm run release:prepare   # 在 dist/ 生成 tgz、校验和与发布清单
pnpm run check             # 执行上述默认验证和构建

typecheck 尚未启用完整 JavaScript 类型检查，不能替代行为测试。真实实例测试需要单独配置，不会由 pnpm test 或 CI 自动运行。

.github/                   CI、Issue 与 PR 模板
docs/                      架构、测试与截图说明
scripts/                   构建、校验和测试脚本
src/host/                  索引、策略、HTTP 端点
src/client/                菜单、回收站、设置和列表同步
lib/                       构建生成，不纳入版本管理

更多信息：架构说明 · 测试指南 · 贡献指南。

卸载

dsh plugin --profile trash remove dsh-session-trash

卸载不会自动删除回收站数据。移除插件后，原位保留的软删除会话可能重新出现；处理索引或暂存目录前，应先确认是否还有需要恢复的数据。

许可证

MIT。本项目是第三方插件，与 DSH 上游项目无官方隶属关系。