前言¶

DeepSeek Harness (DSH) 的生态强调“一切皆插件”，但在会话持久化与侧边栏管理上，通常缺乏直观的 Web 界面工具。用户需要频繁整理归档会话、筛选特定工作区或清理回收站，手动操作容易造成数据残留或遗漏。该插件旨在为 DSH Web 端提供一套完整的会话管理方案，解决归档浏览、工作区筛选、回收站维护以及失效记录清理的问题。

是什么¶

哦鲸鲸会话管理插件是一个 DeepSeek Harness 专用的 Web 插件，开源项目，许可证为 MIT。它提供了查看归档会话、管理回收站、按工作区筛选以及清理失效记录的功能，通过清理三层记账（归档集、工作区记账、投影检查点）来确保侧边栏数据的干净与一致。

安装与启用¶

在已配置好 DSH Web 插件环境的目录下，执行以下命令安装：

dsh plugin --profile web add ./dsh-session-manager

核心功能¶

插件主要包含以下功能模块：

会话浏览与管理：查看归档会话列表，支持查看最后一问一答的预览。支持将归档会话恢复到侧边栏。
视图筛选：自动识别 DSH 已注册的工作区，支持按工作区筛选；支持按时间筛选（最近一天 / 最近七天 / 更早）。
数据刷新：提供下拉或按钮手动刷新，首次加载后不会自动覆盖旧数据。
回收站操作：支持单个或批量将会话移动到回收站；支持单个或批量恢复回收站会话；支持单个或批量彻底删除；支持一键清空回收站。
维护工具：清理失效记录，扫描并移除孤儿会话以及失效的归档 ID、工作区记账和投影缓存。

使用流程与语义¶

删除流程：删除操作默认将数据移入回收站。清空回收站后，数据将彻底删除且不可恢复。
清理失效记录：这是一个兜底维护功能。它扫描祖先已不存在的孤儿子会话（移入回收站，可恢复），以及无法再解析到会话的失效记账数据。即使会话是被插件之外的路径删除的，也可以通过此功能扫干净残留。

技术细节与路由¶

插件通过 HTTP 路由提供管理接口：

GET /session-manager/archives          # 查看归档会话
GET /session-manager/workspaces        # 查看工作区列表
GET /session-manager/trash             # 查看回收站列表
POST /session-manager/trash            # 移动到回收站 (Body: { ids: string[] })
POST /session-manager/unarchive        # 取消归档 (Body: { ids: string[] })
POST /session-manager/restore          # 恢复回收站会话 (Body: { ids: string[] })
POST /session-manager/purge            # 彻底删除 (Body: { ids?: string[] })
POST /session-manager/cleanup          # 清理失效记录

在删除逻辑上，插件会连带子代理会话（parentSession 血缘）一起移入回收站，防止子会话日志留在磁盘上。删除操作同时清理三层记账：归档集、每个工作区的会话记账以及持久化投影检查点。任何一层残留都会导致已删除的会话重新出现在侧边栏。

注意事项¶

正在打开的会话不能删除。
插件不修改会话日志内容。
删除会连带子代理会话一起移入回收站。
清理失效记录会移除孤儿会话，但允许恢复。

资源¶

GitHub: https://github.com/133563825as-ai/oha-whale-session-manager
生态目录: https://www.skillhub.cn/plugins/133563825as-ai/oha-whale-session-manager

哦鲸鲸会话管理插件

前言¶