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 的会话日志是只追加的,而且是唯一事实来源,所以回滚不能删除事件。套件把它做成一次原子的三段式操作:
- 保护:先给工作区和记忆账本拍一个临时 undo 快照(10 分钟有效)。
- 对话:
sessionController.fork({ sessionId, atSeq })把事件前缀完整分叉成新会话(边界包含该消息、 沿用同一个cwd与 agent preset)。 - 文件:恢复该轮开始时记录的快照——改过的文件写回、轮次里新建的文件删除、会话开始前就存在的文件不动。
- 记忆:裁掉晚于目标序列的记忆条目。
- 退休:把原会话归档(侧边栏隐藏,日志保留),整个过程不销毁任何数据。
「撤销回滚」会把这五项全部还原:文件、记忆、被归档的会话,以及分叉出来的子会话。
快照在磁盘上
%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 都清不掉。
已做的两件事:
- 本机存量已清理并备份:删 23 个孤儿缓存、从注册表移除 11 个死 id;
27 个真实会话日志和它们的缓存一条没动。备份在
D:\AI sandbox\dsh-sandbox\_cleanup-backup-20261111-2113。 - 删除能力增强:新增
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。