DSH Plugins Marketplace

DSH Plugins

Plugins

/

Sessions & Messages

/

dsh-session-manager

d

dsh-session-manager

Manifest valid

DeepSeek Harness Plugin: Single Session Deletion, Lock Protection, Recycle Bin Buffering, and Recovery

UI (client)hasBundlePatch

dsh-session-manager(会话删除管理)

@psyduck25/dsh-session-manager · npm · MIT

dsh plugin add @psyduck25/dsh-session-manager

包名带 @psyduck25/ 作用域:无作用域的 dsh-session-manager 在 npm 上已被其他作者占用。 装好之后在设置页里看到的仍然是「会话删除管理」,包名不影响界面。

DSH 本身没有「删除单个会话」:左侧列表只能归档会话,要真正清掉一条只能连整个工作区一起删。 这个插件补的就是这一块——按工作区列出所有会话,锁住不想删的,其余走「二次确认 → 删除缓冲站 → 到期真删」。

设置 → 会话删除管理。

English summary — DSH can archive a session but cannot delete just one; the only way to clear a session for good is to delete its whole workspace. This plugin lists every session by workspace with a lock toggle and a delete button, asks for confirmation, then moves the log into a recycle bin so the row disappears from the left list. Sessions stay recoverable for a configurable window (24 h by default, 0 = delete immediately) and are really removed when it expires. Requires DSH >=0.2.2-rc.3. Install with dsh plugin add @psyduck25/dsh-session-manager. See docs/DETAIL.md for the full picture.

能做什么

  • 按工作区分组列出所有会话,带工作区名称、路径、会话标题、最后活动时间;正在运行的会话和日志缺失的会话都有标记。
  • 锁定:点锁定后该行的删除和迁移都变灰,服务端也会拒绝(不是只靠界面禁用)。再次点击解锁。
  • 迁移到别的工作区:每行一个下拉框,列出当前 DSH 的所有工作区;选中后行内弹出确认条,确认即迁。 这是真迁移——磁盘上的日志目录会搬到新工作区对应的项目目录,会话头里的 cwd 也一起改写, 否则 DSH 下次按 cwd 过滤时会把你搬过的会话摘掉。详见下面的「迁移到底做了什么」。
  • 删除要二次确认:点删除先在行内展开确认条,写明这个会话会进缓冲站、多少小时内可回档;缓冲时长为 0 时确认文案直接说「无法撤销」。
  • 删除缓冲站:二次确认通过的会话落到页面底部,同时从左侧工作区列表消失。
  • 回档:缓冲期内点「回档」恢复原样——日志文件搬回原目录、解除归档,所以标题、位置、工作区归属都不变。
  • 缓冲时长可自定义:默认 24 小时,填 0 就是二次确认后立即彻底删除。范围 0–720 小时。
  • 到期真删:宿主的定时器(每分钟巡检,启动 2 秒后先清一次上一轮的欠账)把到期条目的日志文件删掉、解除工作区归属、清空归档集合。

两段式删除具体做了什么

进入缓冲站时做两件事,各自解决一半问题:

  1. 归档:写进工作区归档集合,推一帧让左侧列表刷新,同时挡住这个会话后续被唤醒。
  2. 把日志文件搬进回收站:从会话目录移到 $DSH_HOME/session-manager/trash/<会话>/。 列表来自存储层的会话清单,文件不在了就没有这一行——即使你开着「显示归档会话」也看不见它。
阶段对会话做的事对左侧列表
进入缓冲站归档 + 日志搬进回收站会话彻底消失(不是变灰)
回档日志搬回原目录 + 解除归档会话回到原来的位置
彻底删除回收站目录整个移除 + 摘掉工作区归属会话彻底不存在

工作区登记里的那个 id 自始至终没被删过,所以回档不用猜位置,原样恢复。

真正删除只在这个会话自己的目录里动以 session. 开头的文件;目录空了才一并删掉, 其余文件(比如你手工放进去的备份)一个都不碰。

如果进入缓冲站时这个会话还开着(Windows 上文件被占用搬不动),操作会直接失败并告诉你原因, 不会出现「显示已删但还在列表」的半截状态。到期时如果删不掉,条目标成 「已到期,等待清理:原因」,下一次巡检或下一次启动 DSH 再重试。

缓冲站里每行还有 彻底删除:点一下先展开一行确认(「彻底删除」紧挨着「回档」, 误点的代价是日志直接没了,所以照样要确认一次),确认后立即销毁日志,不等到期。

迁移到底做了什么

DSH 的工作区归属不是一个可以随便改的字段,它完全由会话头里的 cwd 推算:

// @deepseek-ai/dsh-workspace
get sessionIds() {
  return this.record.sessionIds.filter((id) => this.host.candidateMatches(id, this.record.path))
}

candidateMatches 只认「会话头 cwd 的 realpath == 工作区 path」,attachSession 在写入前 也会显式校验并在不匹配时抛错。而 cwd 又决定了日志文件在磁盘上的位置:

$DSH_HOME/sessions/<projectKey(cwd)>/<会话 id>/session.v4.jsonl.zstd

所以「把会话挪到另一个工作区」必然包含两件磁盘操作,少一件都不成立:

  1. 改写会话头里的 cwd。日志是多帧 zstd,会话头在第 1 帧。插件只重压第 1 帧, 后面的帧原样保留——文件其余部分一个字节都不动。
  2. 把会话目录搬到新 cwd 对应的项目目录。

顺序是刻意安排的:先复制、再验证、最后才删原件。副本要能读回新的 cwd、 且帧数和原件一致,才算成功;任何一步失败都会清掉半成品,原会话保持原样。

需要重启 DSH 才看得到效果:工作区的内存索引是启动时建立的一次性快照, 它不会感知磁盘上的 cwd 变了。所以迁移成功后左侧列表暂时不变;插件会把这个会话记进 pending,下次启动时自动补登记,不用你再点一次。

权限不够时:插件不去偷偷改权限,而是把「要做什么」和「源目录 / 目标目录的真实路径」 摆在一个对话框里,由你决定——重试,或者「只改变归属」。

「只改变归属」为什么不生效:cwd 没变,DSH 下次按 cwd 过滤时会把它摘掉、 放回「未分组」。这是 DSH 的设计,不是插件偷懒。插件会把这件事如实告诉你, 而不是让你以为迁移成功了。

被锁定的会话不允许迁移,这条和删除一样由宿主校验。

数据放在哪

$DSH_HOME/session-manager/state.json(默认 ~/.dsh/session-manager/state.json):

{
  "version": 1,
  "settings": { "bufferHours": 24 },
  "locks": ["session-…"],
  "buffer": [
    {
      "sessionId": "session-…",
      "title": "…",
      "workspaceId": "…",
      "workspaceTitle": "DSHdev",
      "deletedAt": 0,
      "expiresAt": 0,
      "originalDir": "…\\sessions\\--…--\\session-…",
      "files": ["session.v4.jsonl.zstd"],
      "pending": false,
      "note": "",
      "noteDetail": ""
    }
  ]
}

回收站目录 $DSH_HOME/session-manager/trash/<编码后的会话 id>/ 里放搬过去的日志文件, 外加一份 meta.json 记录原目录和文件清单——state.json 万一丢了也能靠它还原。

写入是「先写临时文件再替换」的原子写。文件损坏时退回默认值,不会让插件起不来。

接口

全部是本机 loopback 的 HTTP 路由(非本机请求一律 403):

路由作用
POST /api/dsh-session-manager/state拉全量数据(顺带补搬老条目、巡检一次缓冲站)
POST /api/dsh-session-manager/settings{ bufferHours } 或 { reset: true }
POST /api/dsh-session-manager/lock{ sessionId, locked }
POST /api/dsh-session-manager/delete{ sessionId, title, workspaceId, workspaceTitle }
POST /api/dsh-session-manager/restore{ sessionId }
POST /api/dsh-session-manager/purge{ sessionId },缓冲站里立即彻底删除
POST /api/dsh-session-manager/adopt{ sessionId },把未分组会话按 cwd 挂回工作区
POST /api/dsh-session-manager/migrate{ sessionId, workspaceId, mode },mode = preview / full(默认)/ registrationOnly

「未分组」里的会话可以用「归位」挂回工作区

现象:左侧「未分组」下面堆着一些会话,可它们的目录明明就是某个工作区的目录。

原因:DSH 的工作区登记只在启动时按目录把会话归并一次,之后新建的会话不会被收进去。 工作区里那个 id 没被登记,左侧就只能把它算作「未分组」。

处理:插件会算出每个未分组会话的 cwd 属于哪个工作区,在行上显示 「它的目录属于 XXX」并给一个「归位」按钮。点一下就走 Workspace.attachSession() 把它登记进去(该方法自己校验 cwd 必须解析到该工作区目录, 所以不会挂错),左侧随下一帧就能看到它回到正确的分组里。

只对「目录恰好等于某个已登记工作区」的会话提供归位;目录没有对应工作区的 会话不会出现这个按钮。

已知限制

  • 会话标题来自日志里的标题事件;从未生成过标题的会话显示「未命名」。
  • 迁移要重启 DSH 才会在左侧列表生效:工作区索引是启动时的快照,不感知磁盘上 cwd 变了。 迁移成功后插件会把它记进 pending,下次启动自动补登记。
  • 迁移拒绝正在跑的会话(日志正在被追加,这时搬文件会丢对话),也拒绝缓冲站里的会话。
  • 迁移只搬这个会话自己的目录;工作区目录本身、以及会话里引用的其他文件都不动。
  • 正在运行的会话删不掉:插件会先拒绝(running),等那一轮结束再删。
  • 打开着但没在跑的会话是「推迟搬运」的:先归档让它从列表消失,等它退出内存后 由巡检补搬日志文件;stopActivity: true 只是停掉它的活动,并不会替你保存正在跑的回合。
  • 卸载插件不会动已经写下的 state.json 和回收站里的文件,也不会自动搬到别处; 想彻底清干净就删掉 $DSH_HOME/session-manager/。
  • 回收站里的日志是完整文件,不是压缩包:清空回收站之前它会一直占着磁盘。
  • 打开着的会话是「推迟搬运」的:归档先让它从列表消失,等它退出内存后由巡检补搬日志文件。

左侧列表可能残留一行(这是 DSH 客户端缓存,不是插件没删干净)

现象:彻底删除之后,左侧列表里仍然能看到那一行,通常挂在「未分组」下面; 点进去还会报 历史加载失败: session "…" not found (session/not-found)。

原因:DSH 的客户端把会话清单和投影缓存在内存里,只在收到事件时增量更新。 插件删除会话时,宿主侧是真的删干净了:

  • 日志目录已不存在
  • ~/.dsh/storages/workspace.json 里已经摘掉这个 id
  • ~/.dsh/session-manager/trash/ 里也没有它
  • 宿主的会话列表里查不到它

但已经渲染出来的那一行要等客户端重新拉一次清单才会消失, 而 DSH 没有为「会话被外部删除」发事件,所以它就一直挂在那儿。

处理:用页面顶部「刷新界面」卡片里的 刷新界面 按钮。它调用 globalThis.location.reload(),让客户端重新拉一次会话列表——DSH 自己在升级提示里、 ui-settings-general 的 reloadPage 就是这么做的。

桌面版正式安装包的「应用」菜单里没有「刷新页面」这一项(源码里它包在 ...development ? [...] : [] 里,只有开发模式才出现),所以这个按钮是插件补上的入口。 按钮不可用时(页面不能自我刷新)会提示改用 F12 打开开发者工具后按 Ctrl+R。

同理,如果你开着「显示归档会话」开关,被归档但还没补搬文件的会话会变灰 留在原位置——灰色是 DSH 对归档会话的正常表现,不是插件的问题。 等它退出内存、巡检把日志搬进回收站之后,这一行才会真正消失。

Comments

Loading…

Similar plugins

dsh-sessions-manager

by TOBYCAI

DSH 会话管理插件:设置面板 + 侧边栏双入口,归档/恢复/跨工作区移动/软删进回收站;回收站可恢复·批量清空·7/30/90 天自动清理,按标题·会话 ID·工作区搜索,带磁盘与血统详情;已适配 DSH 0.1.5(v3 日志,被打开着的会话支持排队移动)。Session Manager for DeepSeek Harness — archive/restore/move/trash lif

Sessions & MessagesManifest valid

★ 40

↓ 1.7k/wk

MIT

JavaScript

Nov 14, 2026

dsh plugin --profile web add dsh-sessions-manager

by BakaCirno233

DSH plugin: permanently delete cold sessions from a Settings page (设置 -> 会话管理).

Terminal & ClientsSessions & MessagesManifest valid

★ 0

MIT

JavaScript

Oct 26, 2026

dsh plugin --profile web add dsh-session-delete

by SunshineR04

Settings-page manager for archived DeepSeek Harness sessions: restore an archived session to its previous workspace position or permanently delete it (direct physical deletion, no backup layer). Adds

Sessions & MessagesManifest valid

★ 1

↓ 3.8k/wk

MIT

JavaScript

Oct 10, 2026

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

by Ansellwan

为 DeepSeek Harness 侧栏会话补充官方缺失的「删除会话」:运行中置灰、二次确认、真删除。 A DeepSeek Harness plugin adding the missing Delete-session action to the sidebar.

Terminal & ClientsSessions & MessagesManifest valid

★ 7

↓ 589/wk

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-session-clean

by drscrewdriver

DSH Web 插件:会话管理台(原名 dsh-session-steward)—— 活跃/归档会话统一管理(浏览、筛选、收藏、批量归档/取消归档/清理),外加四门会话体检;入口自适应顶栏工具行或底栏。不含搜索/索引、不依赖 DRS(搜索在 dsh-search-index)。

Sessions & MessagesManifest valid

★ 2

MIT

TypeScript

Nov 18, 2026

dsh plugin --profile web add dsh-manage-session

by zhezhi33

Two-stage session deletion for DSH on Windows: move a conversation to the recycle bin and restore it to its original sidebar slot; deletion confirmed in two steps to prevent deleting files by mistake,

Development & InfrastructureSessions & MessagesManifest valid

★ 2

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-session-recycler