dsh-plugin-om

在 DSH 里应用 Observational Memory 风格的上下文管理策略

安装与启用

说明

• $DSH_HOME 缺省为 ~/.dsh
• profile描述了dsh进程的启动模式，官方的启动命令就是名为web的profile

生产使用

安装插件

dsh plugin --profile <profile> add dsh-plugin-om

对于 pnpm11+ 添加脚本失败的说明： 插件的依赖 @huggingface/transformers 自带原生构建脚本，pnpm 11 默认禁止依赖构建脚本，并会抛出异常。 把 $DSH_HOME/profiles/<profile>/pnpm-workspace.yaml 的 allowBuilds 改为 true 即可 或者使用dsh plugin --profile <profile> add dsh-plugin-om --allow-build=onnxruntime-node --allow-build=protobufjs --allow-build=sharp

安装完成后，需要重启dsh

可以通过dsh --profile <profile> --dump-config审查配置是否正确

如果需要覆盖默认配置，打开 $DSH_HOME/profiles/<profile>/cordis.patch.yml 删除里面的空数组，加入

- id: dsh-plugin-om
  config:
    thresholdRatio: 0.2
    # 其他配置参考下文

不需要重启 可以热更新

开发插件

运行pnpm dev，等待dist/index.mjs构筑完毕（本地嵌入模型可在运行时自动下载到跨版本共享目录；如需提前预下载用pnpm run download:model，已存在则跳过）

在 cordis.patch.yml 里加入

- insert:
    - id: dsh-plugin-om-dev
      name: file:///<repo>/dist/index.mjs

可以热重载

关于compaction-basic

dsh的"预设"分为两层，dsh web等同于dsh --profile web，调用的是"名为web的profile"，进程上的预设

而web-profile里定义了多个"预设agent"preset-agent 这里主要说的是preset-agent的问题

preset-agent配置里自带一个compaction-basic，会在到达阈值后做简单的摘要，与此插件冲突。

由于配置注入的顺序是层级低的覆盖层级高的，所以cordis.patch.yml对compaction-basic的禁用不会生效。

此外，这个插件位于preset-agent的定义而非额外的安装，也无法通过dsh plugin卸载。

解决方案：

• 直接改preset-agent的定义(不推荐)
• 定义不含compaction-basic的preset-agent
• compaction-basic压缩阈值是80%上下文窗口，而只需要确保OM的配置中，thresholdRatio+historyMergeRatio<0.8，理论上没到强制摘要就会被OM压缩了(默认值满足这一条件)

工作原理

1. 在未压缩的消息到达观察阈值后，进行摘要
2. 将新生成摘要追加到已有摘要后（每条压缩日志是独立的消息/块，旧块原地保留）
3. 如果摘要总长到达反思阈值，对其本身进行摘要（把全部 块拼接合并为一条）
4. 提供recall/recall-semantic两个tool进行检索

观察与反思共用同一套系统提示词（buildHistoryPrompt）：输入与输出都是合法的 块（模型消息 + index 的表达形式），先定义块、要求压缩、再给出数据源（下方 消息记录）。

压缩日志块结构

• 观察压缩只精确替换被压缩的新消息区间：旧 块保留为独立消息，新观察日志作为新块追加在其后（多块并存按序排列），历史不会随压缩次数膨胀；反思合并时才把多个块合并为一条更紧凑的摘要
• 压缩边界：消息列表中最后一个合法的 块（source 为插件，plugin 为插件标识 dsh-plugin-om；兼容旧日志的宿主 checkpoint 标记 compact）之后的消息视为未压缩；其前（含自身）视为已压缩，不重复压缩、不计入观察阈值
• 观察输入经 @xmldom/xmldom 构建为合法 块（用户消息文本/assistant 文本/reasoning 特殊字符自动转义，图片/文件以注释补充；assistant 文本与 toolcall&result 原样；系统消息——user_message 中 source.kind 非 user 的部分，如宿主注入的上下文——渲染为 空块，内容不进入压缩输入）
• 输出经 @xmldom/xmldom 解析校验：结构合法（标签匹配/闭合/单块）、不含 、index/start/end 连续（与预期覆盖区间一致），失败按 compressRetryCount 重试
• 块开标签带 tip 属性（对 AI 的提醒："当前块是历史消息的压缩产物，不要复述"）；块顶为构成逻辑注释（完整消息定义串 + 条目标签语义），消息正文不再附加前缀句

压缩卡片（消息列表中的「已压缩」展示）

插件自产的替换消息使用插件自身标记（source.plugin = dsh-plugin-om）；宿主 conversation UI 只识别内置的 compact 检查点，因此插件额外注册一个浏览器客户端 bundle（src/client/，经 dsh.client 声明、exports["./client"] → dist/client.js，由 dsh 客户端模块系统按 /plugins/dsh-plugin-om/client.js 加载），自行认领压缩生命周期事件与替换检查点，在消息列表渲染折叠式「已压缩」卡片：

• 卡片默认折叠，采用与宿主「上下文注入」卡片同款样式：同一 DisclosureRow 外壳组件 + IconBrowseOutline16 图标，行内统计与展开体样式按宿主 ContextInjectionRow 的规则注入（插件 bundle 无法引用宿主编译期哈希的 CSS Module 类名，按宿主 client bundle 的同一机制注入