Skip to content

dsh-session-suite

Verified

@heixui/dsh-session-suite · v0.10.5 · MIT · Web UI

Session checkpoints for DSH: rewind a conversation with its files and memory, permanent session deletion, and shareable exports

Install

dsh plugin add @heixui/dsh-session-suite

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

Source

Tags

Creators

Readme

dsh-session-suite(会话套件)

为 DeepSeek Harness(DSH)提供会话检查点能力:把对话 连同工作区文件和会话记忆一起回滚到任意一条消息,永久删除会话,把会话导出成图片或单文件网页, 并且维护一套跨会话、跨工作区的长期记忆。

这是一个 DSH 插件包(Host + Web Client),对标 Trae 的会话操作体验,已在 desktop profile 上验证加载。

能力 位置
回滚到某条消息(对话 + 文件 + 记忆) 每条最终助手消息的 ↺ 按钮,输入框上方的行内确认条
删除某一轮(只动对话与记忆) ↺ 旁边的 🗑 按钮
删除选中的一段对话 会话 … 菜单 → 删除对话片段(可选轮次)
永久删除会话 会话 … 菜单 → 删除任务(二次确认弹窗)
分享选中的片段 会话 … 菜单 → 分享会话:勾选轮次后生成图片 / 网页 / Markdown / JSON / 复制文本
快照管理 会话 … 菜单 → 会话快照,以及 设置 → 会话快照
长期记忆(全局 + 工作区双库) 设置 → 长期记忆;【记住:…】;memory 工具
用 WorkBuddy / Trae 积分跑模型 不在本包内 —— 见 用 WorkBuddy 和 Trae 的积分

长期记忆

两个隔离的库(global 与按工作区划分的 workspace)、四因子重要性评分(频率 · 新近度 · 情感强度 · 独特性)、 动态衰减加冷归档、相似聚类并压缩成摘要、以及从重复标签里提炼规则型记忆。

最关键的一点:隐式记忆不会偷偷入库。每轮结束后由一次轻量模型调用提出候选,进入设置页的待确认队列, 只有你点「保留」才真正写入;而 【记住:…】 / 【新增全局记忆:…】 这类显式指令会跳过队列直接写入。

评分公式、阈值、生命周期、指令、存储结构都在 docs/long-term-memory.md。

各操作分别动到什么

操作 对话 会话记忆 工作区文件
回滚(↺) 截断到该消息 裁剪到该处 恢复到该轮快照
删除一轮(🗑) 提问 + 回答 + 中间的步骤一起移除 裁剪到该处 不动
删除对话片段 从选中的第一轮(含它的提问)截断 裁剪到该处 不动
删除任务 从磁盘移除 移除 不动(文件夹保留)

只有回滚会把文件写回去,其它删除都不碰工作区。会话日志是只追加的,所以「截断」只能是「保留前缀 + 原来的会话退休」——选中范围之后的内容会一起消失。

分享

分享弹窗会列出每一轮对话(你的提问 + 回答预览),默认全选,取消勾选即可排除。然后选输出形式:

  • 图片:把选中轮次画成一张 PNG(用 canvas 直接画,不依赖任何第三方库);
  • 网页文件:单文件 HTML,内联样式、跟随明暗主题、可直接打印成 PDF;
  • Markdown / JSON:贴进 issue 或喂给别的工具;
  • 复制文本:纯文本进剪贴板。

两种富格式都会真正渲染 Markdown,而不是原样吐出:标题、粗体/斜体、行内代码、代码块、有序/无序列表、引用、管道表格、链接。Host 侧把日志解析成带内联样式的 block(lib/markdown.js),HTML 渲染器和 canvas 渲染器吃的是同一份结构,所以网页和图片不会出现两种排版。

截图会跟着一起导出:附件不在会话日志里,Host 通过 attachments.imageHostPath 取到原文件,按预算内联成 data URL,网页因此仍是单文件。图片里截图按整卡宽度绘制(限高、保持比例);网页里每张截图是一个按钮,点开用内置查看器按原始分辨率看——页面只带一小段内联脚本,不发任何外部请求。

另外要说清楚:位图(PNG/JPG)里的图片不可能点开。需要「点开看原图」就分享网页文件,而不是导出的 PNG。

导出到底包含什么

会话日志里大部分不是对话:运行环境、技能目录、时间采样、子代理回执、工具调用,以及模型在工具之间写的过渡性说明。这些都不该进导出:

  • 只有 source.kind === "user" 的消息才算「你说了什么」,user 角色下的其它事件全部丢弃;
  • 默认勾选 只导出最终回答:每轮保留你的提问 + 最后那条答复;
  • 取消勾选则导出每个助手片段,包括工具调用之间的过程说明;
  • 富格式里永远不出现工具输出,Markdown / JSON 也走同一套取舍。

同一轮里的多个助手片段会合并成一张卡片,只有工具调用、没有正文的步骤直接丢弃,不会导出成一堆空标签。

真正的「在线链接」需要一台服务器托管内容;这个包用可离线打开的网页文件来替代,而不是生成一个只有本机能打开的链接。

安装

从 npm 安装:

dsh plugin --profile desktop install @heixui/dsh-session-suite

发布用的是带作用域的包名,因为不带作用域的 dsh-session-suite 在 npm 上属于另一个项目 (chc-1986/dsh-session-suite),不是这个。作用域只是 npm 上的包身份——插件 id、存储目录、 bundle 名仍然是 dsh-session-suite,所以旧版本留下的数据照样能找到。

从本仓库检出目录安装:

# 从本仓库检出目录安装
dsh plugin --profile desktop install .

或者让运行中的 Harness 安装(plugin_manager 就是这样做的):

plugin_manager({ action: 'install_bundle', target: 'D:/path/to/dsh-session-suite' })

安装后刷新页面即可。整个套件只有一个 Host 行(session-suite),配置写在 cordis.patch.yml;Client 部分由 package.json 的 dsh.client 字段自动发现。

回滚是怎么实现的

DSH 的会话日志是只追加的,而且是唯一事实来源,所以回滚不能删除事件。套件把它做成一次原子的三段式操作:

  1. 保护:先给工作区和记忆账本拍一个临时 undo 快照(10 分钟有效)。
  2. 对话:sessionController.fork({ sessionId, atSeq }) 把事件前缀完整分叉成新会话(边界包含该消息、 沿用同一个 cwd 与 agent preset)。
  3. 文件:恢复该轮开始时记录的快照——改过的文件写回、轮次里新建的文件删除、会话开始前就存在的文件不动。
  4. 记忆:裁掉晚于目标序列的记忆条目。
  5. 退休:把原会话归档(侧边栏隐藏,日志保留),整个过程不销毁任何数据。

「撤销回滚」会把这五项全部还原:文件、记忆、被归档的会话,以及分叉出来的子会话。

快照在磁盘上

%DSH_HOME%/storages/dsh-session-suite/
  sessions/<sessionId>/index.json        # 检查点索引
  sessions/<sessionId>/manifests/*.json  # 路径 -> {hash, size, mtime}
  sessions/<sessionId>/blobs/<ab>/<hash> # gzip 压缩的文件内容,按内容寻址
  memory/<sessionId>.json                # 会话记忆账本
  memory/_global.json                    # 跨会话长期记忆
  undo/<id>.json                         # 回滚撤销包
  • 增量:manifest 只记录路径与哈希,相同内容只存一份;未变化的文件靠上一份 manifest 的 (size, mtime) 指纹直接跳过,不再读取。
  • 配额:每个会话保留最近 10 个自动检查点;锁定的一律保留;临时撤销包不占配额,10 分钟后清理。
  • 忽略清单:node_modules、.git、缓存、构建产物、日志、锁文件、二进制文件都不记录;config.ignore 可追加自定义规则。
  • 上限:单文件超过 2 MiB、单次超过 4000 个文件会跳过,避免拖慢对话。

配置

- insert:
    - id: session-suite
      name: dsh-session-suite
      config:
        keep: 10               # 每个会话保留的自动检查点数量
        autoCheckpoint: true   # 每轮开始时自动拍快照
        maxFileBytes: 2097152
        maxFiles: 4000
        sweepIntervalMs: 300000
        ignore: []             # 追加的忽略规则

目录结构

index.js            Host 半部:注册路由、按轮拍快照、清理定时器
client.js           Client 半部:菜单行、消息操作、确认条、弹窗、设置页
lib/api.js          受保护的 Fetch 路由(POST api/session-suite)
lib/service.js      会话操作:rollback / undo / delete / share / deleteMessage
lib/checkpoints.js  内容寻址的增量快照存储
lib/memory.js       会话记忆账本(支持按序列裁剪)
lib/share.js        会话日志 → Markdown / 文本 / JSON
locale/{en,zh}.json 插件管理器的展示信息与文案
tools/              自测脚本与预清理脚本(不随插件打包)
docs/               需求与 API 笔记

0.4.0 改了什么

本次重构的是记忆引擎,会话相关功能未变。

方面 改前 改后
重复记忆 46 条里同一主题占 7 条 维护幂等(连续 6 轮验证);存量重复已合并进冷库
常驻层 2 条扁平记忆,混在「相关」区块里 最多 5 张主题卡片,独立分区标注
情景记忆 没有 kind: 'episode',带发生时间、情境、结果;衰减加倍
dense 重排 实现了但默认关,权重未验证 可选,默认关;权重经实测校准(8 条改写查询 MRR 0.535→0.760,recall 不变)
隐私分级 只有 scope public/internal/secret;凭据自动识别;secret 永不注入、永不导出
隐式队列 关键词闸门误杀 7/10 合法候选 闸门已移除;空队列会说明原因

embedding 是可选增强,默认不下载任何东西。 不装模型就是纯词法检索,功能完整;装了才有跨语言与改写召回。 实测效果与安装方式见 docs/memory-architecture.md 和 tools/download-embedding.mjs。

0.4.1 改了什么

新增侧边栏入口,修掉几个「看起来能用、实际没生效」的问题,并把界面上说不清的数字说清楚。

方面 改前 改后
入口位置 只能在 设置 → 会话快照 / 长期记忆 里找,三步才能到 左侧栏「会话套件」图标,点开即用;设置页那三个重复入口已移除
记忆总数 面板显示 17,设置页显示 51 —— 同一句话两个数 面板遍历所有已登记工作区;每个数字都写明统计口径,并给出分工作区明细
归档恢复 点了没反应,磁盘上的标记纹丝不动 修了两个 Host 服务参数形状不一致的问题,恢复真正生效
快照数量 预算 10 张,列表却有 16 张,无从解释 区分「自有 10 张」与「继承 6 张」,继承项打徽章并说明为何不计入预算
隐式提取模型 只能选「关闭」和「用当前模型」,看不到自己配的模型 从 Host 的 llm 服务枚举真实可用模型;默认关闭,不选就不消耗 token
长列表 配置区被五十条记忆挤到看不见 列表独立滚动,配置区始终可见
会话记忆 一个从未写入的残缺区块,旁边就是 dsh 自带的轨迹 已移除 —— 轨迹是权威且不可改,手写笔记只会误导

关于记忆总数为什么会有多个数字:长期记忆分「全局库」和「各工作区的库」。 longterm.list 不带 cwd 时只返回全局库,带上才是全局 + 该工作区。面板没有工作区概念, 于是只显示了全局那部分。现在面板会遍历所有已登记工作区,并在界面上直接列出每个库的条数。

测试

全部自测脚本都在临时目录里跑,不会碰真实的 DSH 数据。

node tools/selftest.mjs                    # 快照 / 忽略规则 / 恢复 / 淘汰 / 记忆
node tools/selftest-memory-dedupe.mjs      # 维护幂等,重复不再生成
node tools/selftest-resident-cards.mjs     # 常驻卡片分组与预算
node tools/selftest-episode-memory.mjs     # 情景记忆类型与衰减
node tools/selftest-memory-privacy.mjs     # 隐私分级与导出过滤
node tools/selftest-implicit-queue.mjs     # 隐式候选不再被误杀
node tools/selftest-memory-conflicts.mjs   # 矛盾对只入队,绝不自动裁决
node tools/selftest-pain-distill.mjs       # 失败轮自动提炼教训,去重且封顶
node tools/selftest-p2p3-wiring.mjs        # 两个功能每一层都真的接上了
node tools/selftest-surface-shadow.mjs     # 就地回退标记绝不会被当成用户提问
node tools/probe-dense-rerank.mjs          # dense 重排的实测对比(需要模型)

0.10.5 改了什么

排查「删了会话,用 @ 还能看到」时确认:@ 的候选来自 DSH 内核 sessionPersistence.list()(只扫真实 .jsonl.zstd 日志),不读本插件数据, 所以删除日志文件后 @ 本来就不会再列。但同一轮排查确实挖到两类真残留:

残留 数量(本机实测) 影响
storages/session_projcache/sessions/ 里无日志的孤儿缓存 23 个 / 4.0 MB 占磁盘,旧版本删除路径留下的
workspace.json 里指向已删会话的死 id 11 个(archivedSessionIds 11、工作区 sessionIds 3) 别的插件仍能把幽灵 id 解析出来

根因是 #purgeSession 末尾的 #unarchive() 只清归档标记,而 workspace.json 的其它数组、以及 Host 之后写回的 id 都清不掉。

已做的两件事:

  1. 本机存量已清理并备份:删 23 个孤儿缓存、从注册表移除 11 个死 id; 27 个真实会话日志和它们的缓存一条没动。备份在 D:\AI sandbox\dsh-sandbox\_cleanup-backup-20261111-2113。
  2. 删除能力增强:新增 lib/cleanup.js(纯函数,可单测)
    • deleteSession 末尾额外 purgeRegistryId()(按 id 清所有数组)+ 只针对本 id 的缓存清理
    • 两个新 action sweepGhostCaches / purgeRegistryGhosts,默认 dry-run, 设置页「清理会话残留」按钮两步确认,可清历史孤儿
    • 判定保守:缓存只在没有任何会话日志时才算孤儿;单会话删除绝不扫别人的缓存
    • 15 项新自测 + 一条 wiring 断言固定住接线

@ 的行为没变也不该变——它归内核管。这版清的是我们自己的删除尾巴。

0.10.4 改了什么

0.10.3 的 Markdown 导出实测发现一个真问题:侧边栏面板拿不到 cwd(runtime.resolveCwd() 返回空),于是导出只有全局库 69 条,工作区记忆整节是空的,但文件看起来完整—— 比报错更危险。

  • 改为导出全部已登记工作区,每个工作区单独一节,不依赖调用方提供 cwd
  • 同名路径的多个 hash 条目合并,不再出现重复章节
  • 头部写明「全部 N 个」,末尾仍报 secret 隐藏数
  • 实测:207 条(原 69)、6 个工作区、隐藏 2 条 secret

顺带把「长期记忆」页拉宽:.dss-panel 760→1120、.dss-section 720→1080, 消除宽屏下两侧大片空白。

0.10.3 改了什么

对照 zilliztech/memsearch 做的两项「可迁移性 / 可观测性」补强,不引入任何外部依赖。

① 记忆可导出为纯 Markdown(longterm.exportMarkdown / longterm.exportMarkdownFile)

以前的 longterm.export 是给「分享给别人」用的 JSON,只导 public;而库里绝大多数条目默认是 internal,拿它当个人备份几乎是个空文件。新的导出是给拥有者自己看的:

  • public / internal 都导出,secret 永不出现(连 id 和占位名都不写,只报总数)
  • 热库和冷归档都带上,换机器不会静默丢掉归档条目
  • 每段标注日期、隐私级、archived / pinned、标签;纯文本,可进 git、可喂给别的 Agent
  • 明确写了「不是回导入格式」——本插件不提供从 Markdown 反向写库,避免误以为双向同步
  • 渲染器是纯函数(lib/memory-markdown.js),10 项单测固定住 secret 排除、计数、转义等契约

设置页「可迁移的记忆快照」一键下载。实测本机真实库导出 125 条、隐藏 1 条 secret。

② 失败可见(longterm.status 的三个诊断进设置页)

longterm.status 早就返回 recall / install / extraction,但界面只显示了 pain, 所以「召回重建失败、钩子没装上、提取没跑」三种状态从外面看都是「没有记忆」。新增一张 「记忆子系统状态」卡片,把这三件事直接说出来。

顺带修了一个接线缺陷:LONGTERM_ACTIONS 是显式白名单,新增两个 longterm.* action 时如果 不登记,关掉 longTermMemory 后会绕过守卫打到 undefined 引擎。现在 selftest-p2p3-wiring.mjs 会扫描所有 case 'longterm.*' 并断言它们都在白名单里——这条断言就是这次加出来的。

已发布为 @heixui/[email protected]。

0.10.2 改了什么

一个修复,针对只有「另一个插件就地回退」时才会出现的缺陷。

DSH 的事件日志是只追加的:回退删不掉事件。所以 dsh-purge-community 的做法是追加一条空的 user/message,带 surfaceOp 去替换一段 seq 区间,由渲染层把被覆盖的部分藏起来。这条记录 source.kind === 'user'(它确实是以用户身份写的)、content: []。

本项目所有走 seq 的路径都排除了「非 user 来源」,却从没检查过一条 user 消息有没有内容, 于是装上 purge 之后:

位置 之前 现在
「重发这一轮」 lastUserTurn 返回标记所在的轮次,对话框答「第 N 轮不是由你发的提问开始的」——指向一个根本不存在的轮次 跳过标记轮,找到真正的最后一条提问
「删除到此为止」 previousUserSeq 返回标记的 seq,切点整体晚一轮 切点只来自真实提问
导出头部 回退标记、压缩检查点都被算进条数,头部声称的用户消息比正文里能看到的多一条 summarize 只数真实提问
导出正文 curateEvents 放行标记,renderMarkdown 于是输出一个空的 ### User 标题 控制记录不再进入任何投影

判定看形状而不看插件名:surfaceOp.op === 'replace' 能抓住任何一家用同一套写法的实现, rewind- 的 id 前缀只是老版本的补充信号。lib/util.js 里的 isUserPromptEvent 现在是这 四处共用的一条断言;纯图片提问仍然算数——没有文字的一张截图也是提问。

同时装两套回退仍然不是好主意,但理由在另一处(两者对文件和记忆的处理不一致),那是配置选择, 不是 bug。事件形状由 node tools/selftest-surface-shadow.mjs 固定住。

0.10.1 改了什么

0.10.0 上线后对着真实记忆库审计发现的五个缺陷,全部有实测证据。

方面 之前 现在
跨 store 矛盾 扫描在「每个 store 的循环内部」,所以全局规则与工作区规则互相矛盾时,两条都注入同一个提示词、且永不入队(实测:相似度 0.737,两侧都注入,队列为空) 扫描额外把全局库与各工作区库对比;裁决时把输的一方写回它自己所在的 store
队列读取 conflicts(cwd) 用工作区过滤共享队列文件后把过滤结果写回,于是「不是我的」被当成「已失效」——在任一工作区打开记忆页,就删掉其他所有工作区待裁决的矛盾(实测 1 → 0) 只清理本次真正检查过的条目,其他工作区的原样写回
教训里带凭据 失败信息里回显 sk-… 会让整条提炼出的教训被标 secret,而 secret 永不注入——教训(防止该错误的知识)消失了,凭据却留在库里 捕获时脱敏成 [已脱敏],教训保持可注入
解析不到工作区 remember({scope:'workspace'}) 没有 cwd 会抛错,hook 捕获后只记日志,教训静默丢失 回退到全局库——一条到处都适用的教训本就该放那里
每轮开销 痛苦轮 hook 在每次 turn/end 重读并重解析整个会话日志:4 万事件实测 JSON 解析 186ms,而检测只要 1.15ms 只读最后一轮窗口,开销降低 94%

另有两个小的:自查纠错线索仍会误伤散文(「实际上全部生效了…算错了」);反转裁决后旧赢家同时带 supersededBy 和 frozen,让一条已退役的记忆看起来像被用户钉住的。

0.10.0 改了什么

两个功能出自同一个毛病:记忆库对错误的东西很自信。

方面 之前 现在
互相矛盾的记忆 被纠正的旧观念原样留在库里,和新观念一起注入,模型只能按新旧掷硬币 成对检测后入队,由人来选哪条为真;输的那条标 superseded,赢的冻结
纠错被吞 长记忆只改一个从句,相似度 0.88 就会走「重复」分支:旧说法被强化,新说法被静默丢弃 反极性的近重复不再被吞,两边都留在库里交给队列裁决
失败的轮次 一轮搞砸了什么都不会留下——模型当时正在救火,最不会写教训 从该轮自己的事件日志自动提炼教训,按失败主题去重,每库封顶 12 条
聚类 矛盾对会被合并成一句「必须…;绝不…」 待裁决的矛盾对不聚类;教训也不聚类
密钥误标(P2a) 光出现「密钥 / token / secret」就算凭据,实测 8 条误标全部是误判,被静默封存 只认凭据实体(前缀、分隔符、17 位号、卡号、手机号、邮箱)

为什么矛盾不自动裁决。 「同主题、反极性」同样能匹配:被撤回的旧观念、加了条件的规则、计划与实情。检测器分不清这三种,猜错就等于悄悄改写用户的信念。所以检测自动,裁决留给人。

立场是按从句比的,不是按整条。 真实记忆有 100–300 字、包含多个从句;实测本库 64 条活跃记忆里有 29 条同时含「要求」和「否定」,所以「这条是不是在禁止」对它们没有答案。第一版遇到这种就放弃判断,45 个人造矛盾里漏掉 20 个。改成按句号/分号切句、逐句比对后,改一个从句就能被发现,其余部分不必变。

为什么教训提炼不调模型。 本套件试过七次「每轮后台调一次小模型」,一次都没触发过,其中一次直接把 Host 搞崩;而且它对每一轮都要花钱,包括没出问题的那些。改成读该轮自己的事件日志:不调模型、不联网、不花 token,这才让它有资格每轮都跑。

已知边界

  • 回滚不改写日志,而是「分叉到目标消息 + 归档原会话」。这是只追加日志支持的唯一形态,也正是撤销能够成立的原因。
  • 快照覆盖的是文件,不覆盖外部副作用:数据库状态、运行中的进程、网络调用都不在其中。
  • 跨会话记忆是本套件自己的账本(memory/),不是 DSH 内核能力;因为由套件拥有,所以能一起回滚。
  • HTTP 路由受 DSH Connection 保护(Host/Origin 校验 + 浏览器会话),只有已鉴权的 Web GUI 能访问。

许可证

MIT。