Skip to content

dsh-session-butler

Verified

dsh-session-butler · v0.3.0 · MIT · Web UI

Session management for DeepSeek Harness: browse, filter, inspect, batch-manage and trash sessions across workspaces, with read-only agent tools.

Install

dsh plugin add dsh-session-butler

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

会话管家 · dsh-session-butler

npm CI license

DeepSeek Harness 的会话管理插件:给已归档的会话一个列表,给会话行一个真正的删除。

DSH 已经能改名、置顶、归档、分叉;归档之后没有地方查看,也没有删除入口。会话管家补上这两块:设置里多一个「已归档的聊天」分区,会话行多一项「删除会话」。

已归档的聊天

你会得到

  • 已归档的聊天(设置 → 已归档的聊天):按项目分组、搜索、取消归档、永久删除、全部删除。
  • 删除会话(会话行 ... 菜单):确认一次就删掉,没有回收站第二步。
  • 级联删除子代理:删主会话时可选带走它的子代理会话;普通 fork 不受影响。
  • 给模型用的工具:列出、查看、新建、分叉会话(session_butler_list / detail / new / fork),破坏性操作不开放给模型。

安装

在 DSH 的 插件 页搜索 dsh-session-butler 安装,或者:

dsh plugin --profile web add dsh-session-butler

装完重启一次 dsh web。Host 半的新代码只有重启后才生效,Client 半刷新页面即可。

从本仓库源码安装(需要先 pnpm install && pnpm run build):

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

使用

入口 做什么
设置 → 已归档的聊天 看已归档会话,按项目分组、搜索;取消归档;永久删除;全部删除
设置 → 会话管家 插件配置,改完立即生效
会话行 ... → 删除会话 确认后永久删除该会话

删除是怎么做的

确认之后直接删,不留回收站页面。删除前会检查这个会话还能不能安全删:

  • 没被 DSH 加载的会话:立即删除,目录和日志一起清掉。
  • 仍被 DSH 加载的会话:拒绝删除,并说明原因——还在跑就先停掉;只是被加载就安全重启 DSH 后再试,重启后不要重新打开它。插件不会为了删除去停任务、改归档状态或动文件。
  • 其他进程正在写:拒绝,提示先关掉占用它的进程。

级联删除只沿 subagent 走,普通 fork 及其子会话不会被带走;确认框里会写明这次会删几个子代理会话。

配置

设置 → 会话管家,四项:

字段 默认 说明
trashRetentionDays 30 回收站条目的保留天数(CLI trash/restore 用),0 表示不按时间过期
liveSettleTimeoutMs 3000 等待宿主释放会话的毫秒上限,超时即拒绝
cascadeSubagents true 删除时是否连带子代理会话
inlineMenuEnabled true 是否在会话行菜单里显示「删除会话」

配置文件里还有 permanentDelete,只用于 CLI 的 purge(需要输入完整 session id),GUI 删除不受它限制。

兼容性

需要 DSH >=0.2.1-rc.2 <0.3.0-0(由顶层 engines.dsh 判定)。缺少 workspaceRegistry、sessionTitle 等服务的 headless / ACP 组合下,插件会降级而不是崩溃:命令和工具仍可用,设置页分区不出现。

开发

pnpm install
pnpm run verify       # typecheck + build + 67 个单元测试 + npm pack 契约
pnpm run test:e2e     # 真实 dsh web 组合 + Playwright 浏览器

产物两半:lib/index.js(Host,apply(ctx, config))和 lib/client.js(Web Client,由宿主模块加载器注入)。

发布走 tag,由 GitHub Actions 用 npm trusted publishing 发布并附 provenance:

git tag v0.2.3 && git push origin v0.2.3

文档

  • 使用说明:每个入口的细节和安全边界
  • 架构:Host/Client 两半、删除管线、HTTP 桥
  • 决策记录:为什么是现在这个形态
  • 测试:单元测试与两层真实环境验证

许可证

MIT