上下文冷库 DreamRift/dsh-memory-context-lab

dsh-memory-context-lab

面向 DeepSeek Harness 的会话级上下文管理插件（v3 单引擎）。它把会话历史持续摄入每会话隔离的影子库，在每一步按当前用户输入检索历史、把命中要点回注到上下文；已完成的回合或步骤可以压缩成一条可恢复的回执，从而在不丢失原文的前提下控制上下文增长。

插件只改模型可见的投影，不改写 DSH 的 append-only 会话日志与命令审计。原始历史始终留在会话日志里，回执可按凭证恢复。

当前源码版本 0.14.0-beta.44（测试版）。

功能

- 全历史摄入：每个 agent/pre-step 把新增的 user / assistant / tool call / tool result 归一化写入本会话隔离库（后台异步，不阻塞首字）。
- 按需回注：以人类本回合输入为查询词检索历史，命中足够时生成有字符上界的回注包，追加到本步消息批次末尾；每回合只注入一次。
- 两种归档时机：
- 按轮归档：回合结束后压缩已完成回合，适合长程多轮；
- 按步归档：同一回合内实时压缩已完成且不在工作集的旧步骤，适合长步数任务，受上下文占用闸门控制。
- 可恢复：每次压缩生成带记录 ID / 原序号的回执；/memory-lab restore [序号|all] 按回执正文定位并恢复原文。
- 保护边界：当前回合/步骤、未完成工具对、插件回执、pin 记录与最近读取租约不会被压缩。
- T1 / T2 双后端：默认本地 Node store + 词法索引（T1）；检测到 @furongjun1999/dsh-memory 0.9.10 且 Python 可用时，按会话启动独立 MDCG_ROOT 的隔离 MCP（T2），检索融合本地与隔离灵枢；T2 不可用时如实回 T1。
- 图形入口：composer 工具行 chip + 弹层控制本对话启用/回注/计划/模式/条数；全局参数在插件设置页。
- 可观测：/memory-lab status | t2 | history | working-set | file-status 只读查看摄入、索引、归档、T2 与回注观测。

0.14.0-beta.44 更新（相比 beta.43）

- 归档选择器适配真实宿主的 tool/result 形状（callId 在 data.message.toolCallId / data.message.source.callId），修复工具会话里按轮/按步归档不生效。
- 按步归档遇到 step 1 内的用户消息时跳过该前导整步，不再阻断后续步骤。
- autoRestore 读取当前全局设置；停用恢复不再使用建库时快照。
- 新增 surface.lastArchiveAt，状态行/切模式确认/投影可感知按步归档；按步归档不写回合级 lastArchiveEndSeq。
- status 的「下一次归档」与真实执行共用冷却闸门；control.json 损坏按会话默认失败关闭；数字参数只接受十进制整数。
- 工具结果脱敏补充 AWS / GitHub / Slack / Google / Stripe / JWT 常见格式。
- probe:host 改为宿主契约源码探针；T2 环境解析支持 $DSH_HOME/profiles/*。

完整历史见 CHANGELOG。

兼容性

| 项 | 要求 |
| DSH Desktop | 0.2.x（按 app.asar 内 agent/pre-step / commands.register / session.append 契约实现） |
| Node.js | ≥ 22.19 |
| T2（可选） | @furongjun1999/dsh-memory 0.9.10 + Python；未安装时自动走 T1 |
| 工具集 | 不增删任何模型可见工具；不改写 DSH 日志 |

安装

从 Releases 下载 dsh-memory-context-lab-<版本>.tgz，加入 DSH profile 的依赖并安装：

cd "$DSH_HOME/profiles/<profile>"
pnpm add "file:/path/to/dsh-memory-context-lab-0.14.0-beta.44.tgz"

或把 tgz 路径写进 profile 的 package.json 后执行 pnpm install。安装后重启 DSH，服务端半才会加载新版本；客户端半在页面刷新后重新装配。

也可以从源码打包：

npm pack

使用

唯一命令是 /memory-lab：

/memory-lab status 摄入位点/库健康/本对话/回注/T2 /memory-lab on|off 本对话启用/停用 /memory-lab inject on|off 本对话自动回注 /memory-lab mode 按轮归档|按步归档|仅回注 /memory-lab set|unset limit <1-20> 本对话条数覆盖 /memory-lab set|unset gate <0-95> 本对话按步归档闸门 /memory-lab planfirst on|off|approve /memory-lab now|compact|dry-run 归档/摘要/预览 /memory-lab history|working-set 列凭证/当前工作集 /memory-lab restore [序号|all] 恢复回执 /memory-lab pin|unpin <ID>、pins 保护/取消保护 /memory-lab forget preview|apply|undo|status <ID…> /memory-lab export|adopt|adopt-from /memory-lab file-status|verify <ID|all> /memory-lab t2 [backfill [N]|backfill cancel|backfill status|cleanup] /memory-lab recall <词> | read <ID> /memory-lab help

设置

设置页在 插件 → dsh-memory-context-lab，包含 bundle 详情页与组件行配置两个槽位。字段：

| 字段 | 默认 | 说明 |
| enabled | true | 新会话默认回注；本对话可单独关闭 |
| fullHistory | true | 新会话默认按轮归档；关闭后默认按步归档 |
| planFirst | false | 计划期间暂停归档与自动回注 |
| autoRestore | true | 停用/手动恢复时是否还原回执 |
| limit | 10 | 单次回注条数（1–20） |
| packMinScore | 0.5 | 装包阈值；0 表示不过滤 |
| previewChars | 160 | 每条命中首部字符数（40–4000） |
| queryMaxChars | 512 | 查询词只取用户消息前 N 个字符 |
| coolingGate | 20 | 按步归档的上下文占用闸门（0–95） |

工作原理

- 摄入：agent/pre-step 之后异步读取本步新增事件，批量写入会话隔离库；断点持久化，重放不双计。
- 归档：选择连续的活动面 span → 生成回执 → 写 archive-intent → 宿主 surfaceOp.replace → 追加 voucher；失败不推进位点，崩溃按 intent 对账。
- 隔离：数据根 $DSH_HOME/.memory-context-lab/v3/sessions/<会话隔离键>/；每会话一个写锁（15s 心跳 / 60s TTL / stale 接管）；T2 只写本会话 t2-mdcg/。
- 失败关闭：读不到或损坏的状态文件按默认或失败处理，不用 0 冒充未知；写锁、索引与账本都有损坏可见的失败路径。

安全与隐私

- 工具结果与工具参数在摄入前做凭据形态脱敏（Authorization、api_key、token、password、AWS/GitHub/Slack/Google/Stripe/JWT 等）；脱敏是本地副本与导出的保护层，DSH 的 append-only 日志仍保留原文。
- forget 是逻辑遗忘：记录不再可按 ID 回读、不出现在索引/导出/T2 镜像中；正文仍保留在本地记录文件里以支持 undo，宿主日志也有原文。需要物理擦除请删除对应会话数据根。
- T2 使用独立 MDCG_ROOT、独立令牌与策略，不读写正式灵枢根。
- 插件不隐藏或屏蔽工具，不改写 DSH 日志；所有归档都可通过 voucher 恢复。

开发与测试

npm test # 全量套件
npm run test:all # 逐文件汇总，失败不中断
npm run probe:host -- --asar "<DSH>/resources/app.asar"
npm run t2:smoke # 需要 dsh-memory；无环境时按设计 SKIP/退出

要求 Node.js ≥ 22.19。测试使用临时数据根，不写正式灵枢根。

许可

MIT。见 LICENSE。