dsh-session-manager

面向 DeepSeek Harness 的会话管理插件。

English · MIT License

dsh-session-manager 给 DSH Web 界面补上完整的会话管理能力：查看全部会话与已归档会话、把归档会话恢复回原工作区、归档任意会话、两步确认删除会话、以及会话内容预览——全部在设置页完成，不改任何官方包。

解决什么问题

DSH 的「归档会话」是单向操作：侧边栏右键归档后，会话从所有视图（工作区分组、未分组、搜索、扁平列表）消失，官方既没有查看归档的入口，也没有恢复的 API——不手动改 ~/.dsh/storages/workspace.json 的话，归档的会话就等于丢了。本插件把归档变成可逆、可管理的状态，并补上磁盘上所有会话的总览：

侧边栏右键 -> 归档（DSH 原生）
  -> 会话从侧边栏消失（再也看不到）
  -> 本插件：设置 -> 会话管理 -> 归档页签
       预览会话内容、恢复（回到原工作区原位置）、
       或从硬盘删除（两步确认）
  -> 「全部会话」页签列出持久化层能读到的每个会话
     （按工作区分组，未分组的也包含在内），不会遗漏任何会话

特性

• 恢复归档会话：归档会话保留工作区账目槽位，恢复后精确回到原位置——单个、批量、一键全部均可。
• 两步确认删除：删除按钮先进入待确认状态，5 秒内需再次点击才执行；运行中的会话（agent 正在跑）由服务端直接拒绝。
• 删除全部：一次确认清掉所有可删会话（含已归档、未分组、工作区内的），跳过运行中/当前打开的会话，并逐项报告成功 / 失败 / 跳过。
• 全部会话总览：持久化层能读到的每个会话——标题、ID、创建时间、所属工作区（未分组显示 —）、状态徽标（已归档 / 活跃 / 运行中），支持归档与删除操作。
• 内容预览：点击会话标题即可展开前 100 条用户 / 助手 / 工具消息，无需打开会话。
• 磁盘占用：每个会话的占用大小与完整磁盘路径，帮你找到空间被谁吃掉了。
• 零核心修改：纯 bundle 插件（dsh.bundle patch 层），所有操作走官方服务（workspaceRegistry、sessionPersistence、sessionQuery、fs、shell 等）——不打补丁、不改官方包。
• 仅本机可访问：/dsh-sm/* 路由拒绝非 loopback 的 Host 与跨源请求（Host + Origin / Sec-Fetch-Site 双重栅栏）。

安装

# 一行安装（git 源）
dsh plugin --profile web add github:omdsh-dev/dsh-session-manager

# 重启 web 服务，然后强制刷新页面

本地开发：

dsh plugin --profile web add /path/to/dsh-session-manager

仓库随附纯 JS 的 lib/ 产物，无构建步骤，git 源安装无需在用户机器上执行任何构建。

用法

Web UI

打开 设置 → 会话管理：

• 归档会话页签（默认）：列出所有已归档会话——标题、ID、创建时间、工作目录、磁盘占用与完整磁盘路径；运行中 / 文件缺失有状态徽标。操作：恢复（单个 / 批量 / 全部）、清空归档（删除全部已归档，两步确认）、行内删除（两步确认）。
• 全部会话页签：持久化层能读到的每个会话按工作区分组（未分组会话显示 —），带已归档 / 活跃 / 运行中徽标。操作：归档、删除、删除全部（两步确认；跳过运行中/已打开的会话）。
• 点击任意会话标题即可就地预览内容（用户 / 助手 / 工具消息，前 100 条）。

架构

lib/
├── index.js   宿主端：cordis 插件（注入 webServer），挂载 POST /dsh-sm/* 路由
└── client.js  浏览器端：__ModuleLoader__ bundle，注册设置页 section
cordis.patch.yml   dsh.bundle patch 层——一行 insert 同时驱动宿主端与浏览器端

浏览器（设置页） --POST /dsh-sm/*--> 宿主端 handler
   archived/list · archived/unarchive · sessions/list · sessions/archive
   · sessions/delete · sessions/detail
   workspaceRegistry（归档集合读写）+ sessionPersistence（header/定位）
   + sessionQuery（标题/内容）+ fs/shell（大小/删除）+ agents（运行中拦截）

宿主端路由：

路由	请求体	返回
POST /dsh-sm/archived/list	{}	{ items, totalBytes }
POST /dsh-sm/archived/unarchive	{ sessionId }	{ ok, changed, archivedSessionIds }
POST /dsh-sm/sessions/list	{}	{ items }
POST /dsh-sm/sessions/archive	{ sessionId }	{ ok, archivedSessionIds }
POST /dsh-sm/sessions/delete	{ sessionId }	{ ok, deleted, sessionId, path?, reason? }
POST /dsh-sm/sessions/detail	{ sessionId }	{ id, createdAt, cwd, totalEvents, messageCount, truncated, messages }

恢复路径通过 workspaceRegistry.setState（回退到 workspace 存储域）重写持久化归档集合，保证注册表内存态与磁盘上的 global.archivedSessionIds 一致；客户端随后刷新 workspace / sessions 存储，侧边栏立即更新。

测试

node test/smoke.mjs   # 10 项宿主逻辑检查（stub 服务）

冒烟测试用 stub 服务驱动 apply(ctx)，覆盖路由挂载、loopback/Origin 栅栏、归档集合读写、删除账目清理与内容提取。端到端验证在真实 profile 上进行过（另起端口跑第二实例 + 浏览器走查恢复 / 归档 / 删除全部全流程）。

Roadmap

• 归档会话列表 / 恢复 / 删除（两步确认）
• 全部会话总览 + 归档任意会话
• 删除全部（跳过运行中/已打开）并逐项报告结果
• 会话内容就地预览
• 回收站（软删除 + 撤销窗口）
• 设置页之外的侧边栏入口
• 发布到 npm