会话清理 · Session Cleaner

DeepSeek Harness Web 侧栏的会话清理插件：在会话行 ... 菜单中永久删除会话，并用侧栏的全局开关一键显示 / 隐藏全部已归档会话。

A DeepSeek Harness Web sidebar plugin: permanently delete a session from its row ... menu, and show / hide all archived sessions with one global sidebar switch.

功能

删除会话

• 侧栏任意会话行 → ... → 删除会话（红色危险项）。
• 二次确认后，Host 会：
  1. 若该会话正在运行，先停止它的 Agent（最多等待 8 秒；停不下来则拒绝删除且不改动任何内容）；
  2. 从工作区归属、置顶集合、归档集合中移除该会话；
  3. 删除 $DSH_HOME/sessions/<project>/<session-id>/ 下的会话日志目录；
  4. 删除投影缓存 $DSH_HOME/storages/session_projcache/sessions/<session-id>.json（以及派生的搜索索引，存在时）；
  5. 通知所有已连接的浏览器移除该行。
• 删除不可撤销，删除前请确认不再需要该会话的历史记录。
• DSH 打开过的会话（包括当前主视图里的会话）也可以直接删除，无需重启：Windows 上日志文件以 FILE_SHARE_DELETE 打开、写锁是内核信号量而非文件锁，因此打开状态下也能移除；删除当前会话后客户端会自动新建一个空会话。只有在运行中的 Agent 无法在限时内停止时才会拒绝（提示先停止该会话的工作）。
• 会话 ID 支持 DSH 的完整形态：session-<uuid>、旧版 sess_<uuid> 与子代理的裸 <uuid>。

全局显示 / 隐藏归档会话（侧栏开关）

• 侧栏面板列表里、「自动化任务」下方有一个 归档会话 开关（button[role="switch"]，右侧胶囊开关，一眼可见当前状态），默认关闭（隐藏全部归档会话）。
• 点一下开关即切换：显示归档会话 → 所有工作区（含「未分组」）的已归档会话一次性全部显示；隐藏归档会话 → 一次性全部隐藏。只点一次即可，不再需要进每个工作区的 ... 菜单逐个切换。
• 状态保存在浏览器 localStorage（键 dsh.session-cleaner.archived-visible，'1' = 显示，'0'/缺省 = 隐藏），刷新/重启后保持；旧版按工作区保存的 dsh.session-cleaner.workspace-archived 会被自动清理。
• 隐藏不依赖 React 重渲染：插件用注入的 CSS + 行属性（data-session-cleaner-archived-hidden）在归档行渲染的第一帧前就隐藏它，列表重新渲染/虚拟滚动不会让隐藏的归档行重新出现；当开关关闭时，即使手动把内置筛选切到「全部对话（显示已归档）」，插件也会把筛选拉回「隐藏已归档」。
• 已归档会话行保持内置的灰色样式与「取消归档」菜单；打开开关显示出来后即可正常取消归档。
• 折叠的工作区分组不会渲染会话行——展开对应工作区分组后即可看到其归档会话。折叠侧栏时开关行会收成图标（胶囊状态仍可见）。

安装

远程安装（推荐，其他人也适用）：DeepSeek Harness Desktop →「插件」页 →「添加插件」， 输入 npm 包名（或等价的 GitHub 仓库地址），确认后 完全退出并重启应用：

@estelle-ge/dsh-plugin-session-cleaner
# 等价写法（从 GitHub 仓库安装同一个插件）
github:gcggcg/dsh-plugin-session-cleaner

插件不需要构建步骤：安装后 Host 入口 index.js 与浏览器 bundle client.js 会被直接加载。 dshopen 市场收录后也可在 https://dshopen.org/zh/plugins/@estelle-ge/dsh-plugin-session-cleaner/ 查看。

Desktop 的 profile 由 Electron 应用独占管理，dsh plugin --profile desktop ... 会被拒绝。 其余安装方式按环境选择：

# Desktop（本地开发）：退出应用后，在 <DSH_HOME>\profiles\desktop\package.json 的
#   dependencies 加 "@estelle-ge/dsh-plugin-session-cleaner": "link:<本仓库绝对路径>"，
#   并把它追加到 dsh.profile.bundles；然后在 profile 目录用应用自带的 pnpm 执行
#   `pnpm install`（或直接使用「插件」页的安装功能），重新打开应用。
#   注意：<DSH_HOME> 默认是 %USERPROFILE%\.dsh；如果应用设置了 DSH_HOME
#   环境变量（部分安装/测试环境会用一个独立的数据目录），插件必须装到
#   **该目录**下的 profiles\desktop，否则重启后不会出现。

# Web / TUI profile（CLI 管理）
dsh plugin --profile web add @estelle-ge/dsh-plugin-session-cleaner
dsh plugin --profile web add link:<本仓库绝对路径>     # 本地开发

安装/更新后需要完全退出并重启 DeepSeek Harness Desktop（或刷新 Web 页面）让浏览器端 bundle 重新加载。

兼容性

• DSH >=0.2.1-rc.3 <0.3.0-0（内置 workspace 菜单与 Session 存储布局按该版本实现）。
• Host 端只使用 Node 内置模块与 DSH 既有服务（webServer、connection、sessionPersistence、workspaceRegistry、sessions、agents），不引入新的运行时依赖。
• 浏览器端通过 dsh.bundle + exports["./client"] 加载，与 @deepseek-ai/dsh-client-ui-workspace 的 slot 契约配合。

实现说明

• 删除入口使用官方 slot sidebar.workspaces.session.menu.item（order: 500，danger）。
• 删除通过 Host 的受认证路由 POST /api/session-cleaner/delete 完成；该路由复用 connection.requestRejection() 的 Host/Origin/Cookie 校验，并在任何破坏性操作前停止运行中的 Agent、检查残留活动（workspace/session-activity）。
• 归档开关是官方 sidebar.panellist（面板列表）下方的一行自绘 React 行：先读取实时面板行的 CSS Modules 类名以匹配外观，再插入到「自动化任务」行之后；归档筛选通过 WorkspaceBrowser 暴露的 store actions 驱动（setArchivedFilter），并以后备的「视图选项」菜单点击路径兜底。
• 全局归档可见性由插件接管：开关打开时筛选为 show（所有工作区归档会话可见），关闭时筛选为 default 并隐藏所有归档行；一帧级 guard 属性保证隐藏从不闪烁。

已知限制

• 已打开但空闲的会话被删除后，Host 内存里的 Session 对象仍会保留到重启（DSH 没有公开的释放接口），但磁盘日志不会重建、侧栏行会立即消失；只有仍停在旧标签页里并继续写入该会话的极端情况可能写入失败。发布版参考实现同样有此限制。
• 删除正在运行该会话 Agent 的操作会先停止 Agent；若限时内停不下来则整次删除中止（不删任何内容）。
• 插件开启期间会接管内置归档筛选：开关关闭时，「视图选项 → 全部对话（显示已归档）」不再显示归档会话；这是「默认隐藏」需求的直接结果。要看/取消归档某个归档会话，先打开侧栏的归档开关。
• 侧栏开关行的注入依赖内置面板列表的 DOM 结构（nav 面板行 + 本地化标签）；DSH 大版本升级后可能需要适配。
• 折叠的工作区分组不会渲染其会话行，展开后才能看到该工作区的归档会话。

仓库结构

client.js            浏览器端 bundle：删除会话菜单 / 确认弹窗 / 全局归档会话开关
index.js             Host 入口（转出 src/host/plugin.js）
src/host/            Host 端：认证路由、会话删除、路径编码
locale/              插件市场元数据（中/英）
icon.svg             插件图标
smoke.mjs            无浏览器冒烟测试
test/host/           Host 单元测试（node:test）
test/e2e/            隔离 DSH Web 实例 + Playwright E2E / DOM 侦察
DESIGN.md            设计与团队契约（不随包发布）

开发

node smoke.mjs                 # 静态/模块冒烟测试（清单、词典、slot 注册、Host 入口）
npm test                       # Host 单元测试（node:test，44 项）
npm run setup:e2e              # 一次性：准备隔离实例（playwright-core + 会话种子 + profile）
npm run test:e2e               # 隔离 DSH Web 实例 + Playwright 端到端（11 项：冷/热会话删除、归档显示/隐藏等）
npm run test:desktop           # 可选：真实 Desktop 外壳（dsh-app://app）9 项检查，缺少打包应用时自动 SKIP

E2E 使用打包版 DSH 的 CLI 以 Node 身份启动第二个 Web 实例（私有 DSH_HOME 位于 .tmp-test/home，不触碰 ~/.dsh 与正在运行的 GUI），详见 docs/dom-recon.md 与 test/e2e/。

npm run test:desktop 会以独立 --user-data-dir 与独立 DSH_HOME 启动第二个 Desktop 实例（真正的 dsh-app://app 页面），复现/验证「打开过的会话也能删除」和「侧栏归档开关一次点击 显示/隐藏全部归档会话」；它只读用户真实 profile 并复制到 .tmp-test/，绝不触碰正在运行的 Desktop 应用。

许可证

MIT