dsh-session-trash
为 DSH Web GUI 添加会话删除与回收站
会话菜单一键移入回收站，在统一面板中恢复或彻底删除
支持保留天数、删除确认与到期自动清理，设置融入原生界面
简体中文 | English
功能
- 会话行菜单：在「…」菜单中添加「移入回收站」和「彻底删除」。
- 回收站面板：查看已删除会话，支持恢复、逐条永久删除和清空。
- 侧边栏入口：回收站有内容时显示绿色状态点，不显示数字角标。
- 原生设置分区：配置暂存、保留天数、确认提示和到期自动清理。
- 列表同步：按精确会话 ID 隐藏已删除条目，并处理日志已删除但仍留在列表中的会话。
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 上游项目无官方隶属关系。
No comments yet. Be the first to write one.