dsh-plugin-om

为 DSH 提供 Observational Memory 风格的上下文压缩和原文召回。

功能

• 自动压缩主会话历史，并在摘要过大时再次合并
• 通过工具循环生成摘要，保留用户消息、系统消息和未压缩内容
• 保留工具加载与手动加载的 skill 原文，并在压缩前再次确认
• 使用 recall 按消息序号回看原文，使用 recall-semantic 进行本地语义检索
• 记录压缩过程、耗时和 token 用量
• 压缩会话记录显示在子智能体列表，随父会话 Session 日志一起下载
• 在浏览器中显示压缩结果、错误和降级警告

安装

要求 DSH 0.2.0-rc.2 或更高版本。

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

重启 DSH 后检查配置：

dsh --profile <profile> --dump-config

pnpm 11 安装失败时，在 profile 的 pnpm-workspace.yaml 中设置 allowBuilds: true，或允许 onnxruntime-node、protobufjs 和 sharp 构建。

配置

在 WebUI 插件侧边栏打开 dsh-plugin-om 行配置页，或编辑 $DSH_HOME/profiles/<profile>/cordis.patch.yml。配置支持热更新，$DSH_HOME 默认为 ~/.dsh。

- id: dsh-plugin-om
  config:
    observeThresholdTokens: 35000

配置项	默认值	说明
observeThresholdTokens	35000	观察压缩阈值
reflectThresholdTokens	40000	摘要合并阈值
tailMessageCount	20	触发后保留的完整消息数
compressMaxTokens	模型默认值	单轮生成上限
compressProvider	会话路由	压缩 provider，需与 compressModel 同时配置
compressModel	会话路由	压缩模型，需与 compressProvider 同时配置
compressReasoningEffort	模型默认值	思考等级
compressSkipReasoning	true	是否忽略 reasoning
rateLimitWaitMs	60000	429 后的等待毫秒数，0 表示不等待
modelDir	DSH 共享目录	嵌入模型目录
omEnabled	true	是否启用自动压缩
recallEnabled	true	是否启用原文召回
semanticRecallEnabled	true	是否启用语义召回
debug	开发环境启用	是否输出步骤日志

较小的观察阈值更早节省上下文，较大的阈值提供更多摘要信息。只有 reasoning 包含关键决策时才需将 compressSkipReasoning 设为 false。

机制说明与成本计算器可估算不同配置的 token 成本。

开发

运行 pnpm dev 自动构建，并在 cordis.patch.yml 中加载本地 bundle：

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

语义召回首次使用时自动下载嵌入模型，也可运行 pnpm run download:model 预下载。

命令	作用
pnpm dev	监听并构建
pnpm check	检查类型、lint、测试和构建
pnpm test	运行测试
pnpm run download:model	预下载嵌入模型
pnpm run release	检查并发布新版本

文件地图

cordis.patch.yml                 # bundle patch，dsh plugin add 后作为组合层插入插件行
src/
├── index.ts                     # 打包入口：注册 recall 工具并接线 pre-step 自动压缩
├── config.ts                    # 配置默认值与宽松合并，未知键忽略、非法值回退默认
├── constants.ts                 # 共享常量：插件标识、history 标签、完整消息定义、格式说明注释
├── degrade.ts                   # 挂载失败降级上报：console 外部输出与 om/warning 会话事件
├── om-event.ts                  # om 事件借用通道：feedback/record 信封的编解码与读写
├── types.ts                     # type-only：宿主类型再导出与领域类型
├── utils.ts                     # 零依赖工具函数：文本渲染、主会话判定、路由解析
├── json-schema.ts               # zod schema 到工具 wire 参数 JSON Schema 的转换
├── logger.ts                    # 插件日志门面，step 按 debug 开关过滤
├── rate-limit.ts                # 全局 429 限流冷却门，进程级共享状态
├── log-index.ts                 # 完整消息索引与渲染，recall 与压缩共用同一套编号
├── recall.ts                    # recall 工具：按完整消息 index 区间回看
├── recall-xml.ts                # 完整消息到 CDATA 包裹 XML 条目的渲染，recall 系工具共用
├── recall-output.ts             # recall 输出契约：{ text, images } 与 render 投影
├── semantic-recall.ts           # recall-semantic 工具：本地嵌入语义检索
├── embedding.ts                 # 本地 ONNX 嵌入：懒加载、批量、运行时按需下载编排
├── model-download.ts            # 模型下载原语：URL、跳过判定、原子落盘
├── compress-view.ts             # 压缩视图：观察与反思区间到统一条目序列的投影与渲染
├── compress-tools.ts            # 压缩工具状态机：getHistory/compressHistory/completeCompression 与最终块构建
├── compress-loop.ts             # 工具压缩循环：多轮请求、工具执行、限流、失败判定与统计
├── compaction-log.ts            # 压缩会话记录落盘：循环对话消息组与压缩统计子会话
├── compress.ts                  # 两级自动压缩：观察、反思、失败传播与生命周期事件
└── client/                      # 浏览器客户端 bundle：压缩卡片与插件行配置
    ├── index.ts                 # 注册卡片、渲染器与行配置槽
    ├── om-config-controller.ts  # 宿主配置表单、草稿和原子保存
    ├── OmConfigCard.tsx         # 十四项双语配置控件
    ├── definition.ts            # 压缩卡片定义：生命周期事件、检查点替换与警告事件
    ├── OmCompactionCard.tsx     # 压缩结果与错误卡片
    ├── OmWarningCard.tsx        # 功能降级警告行
    ├── format.ts                # 统计数字紧凑格式化
    └── locales.ts               # 中英文文案
models/                          # 嵌入模型目录
scripts/                         # 下载和发布脚本
tests/                           # 服务端、客户端与集成测试
web/                             # 机制说明与成本计算器站点
    ├── src/model.ts             # 成本模型
    └── src/components/          # 页面组件与 UI 原语
.agents/skills/agent-workflow/SKILL.md # 仓库开发工作流
.github/workflows/web-deploy.yml # GitHub Pages 部署工作流