观察式记忆 AntonyLang/dsh-memory-observer

dsh-memory-observer

为 DeepSeek Harness 会话提供后台观察式记忆。

智能体会话一长，历史一压缩就断了线：摘要的摘要的摘要。这个插件改成边干活边做记忆，模型因此能留住关键决策、约束和理由，不用谁再触发一次慢吞吞的「记住这个」步骤。

它是 elpapi42/pi-observational-memory 里那套思路的独立 DSH 实现，围绕 DSH 自己的扩展点搭建：按智能体注入的系统提示词段落、宿主存储域、同源设置 API，以及压缩接缝。

turn/end
│ (source tokens since the last observation reach the threshold)
▼
observer ──▶ observations ──▶ reflector ──▶ reflections
│ │
└──── active memory rendered into the system prompt
│
memory_recall (id ──▶ exact source events)

你能得到什么

- 观察记录：每轮结束后悄悄记下决策及其理由、约束、偏好、已验证的结果、未完成的工作、精确标识符。
- 反思：从这些观察里提炼出持久事实，让会话跨过多次压缩仍然不跑偏。
- 不污染对话。 插件从不追加会话事件；记忆以系统提示词段落的形式送到模型面前，所以 fork、resume、replay 和压缩都照常工作。
- 有源可查的回溯。 每条记录都带 12 字符 id；memory_recall 工具会返回它背后的原始源事件。
- 真正的设置页。 设置 → 观察式记忆 / Observational Memory，可以调节奏、预算、工作模型和行为，带实时状态和一键重置。不用改 YAML。
- 压缩更快。 dsh-compaction-basic 要摘要时，直接渲染准备好的记忆，省掉又一次漫长的模型调用。
- 持久化。 记忆和覆盖项存在 DSH 存储域里，插件重载或应用重启都能恢复。

安装

从 npm 安装（推荐）：

dsh plugin add dsh-memory-observer

或者在 DSH 会话里用 bundle 管理器：

plugin_manager install_bundle { target: "dsh-memory-observer" }

从本地检出安装：

plugin_manager install_bundle { target: "E:\\path\\to\\dsh-memory-observer" }

bundle 会插入一行（observational-memory），并启用随附的 compaction-basic 引擎，这样准备好的记忆层才有压缩流程可用。如果这个配置档必须保持无压缩，把 cordis.patch.yml 里最后一条 compaction-basic 删掉即可；记忆层和 memory_recall 不受影响，照常工作。第一次装完客户端部分后，刷新一次 Web 页面，设置区块才会注册。

设置

设置页注册在 Settings 面板中，涵盖以下内容：

- 节奏 — 观察/反思阈值、注入阈值、启动延迟
- 记忆预算 — 观察池、观察/反思上限、来源字符数、worker 输出上限
- Worker 模型 — 服务商、模型 id、推理强度
- 行为 — 暂停后台工作、快速压缩、调试日志、子代理
- 状态 — 已跟踪会话、观察/反思计数、worker 状态、最近一次错误

保存的值存放在 observational_memory_settings 存储域中，并立即生效。Reset to row config 会清除这些覆盖值，回退到插件行的 config。

配置参考

| 键 | 默认值 | 含义 |
| enabled | true | 是否挂载插件（需重新加载）。 |
| passive | false | 停止主动后台工作；已准备好的记忆和召回仍然可用。 |
| observeAfterTokens | 8000 | 两次观察器运行之间间隔的表面 token 数。 |
| reflectAfterTokens | 12000 | 两次反思运行之间间隔的表面 token 数。 |
| injectAfterTokens | 0 | 请求压力超过该值时注入记忆；0 = 只要有记忆就注入。 |
| maxObservations | 80 | 活跃观察上限；最旧的条目移入归档索引。 |
| maxReflections | 20 | 渲染层的反思上限。 |
| observationPoolTokens | 2400 | 渲染进提示词的观察 token 预算。 |
| maxSourceChars | 36000 | 每次观察器运行的转录字符数（取最新的片段）。 |
| agentMaxTokens | 2500 | 单次记忆 worker 调用的输出上限。 |
| debounceMs | 1200 | 一轮结束后、后台工作启动前的静默延迟。 |
| fastCompaction | true | 用已准备好的记忆提供压缩摘要。 |
| includeSubagents | false | 单独跟踪子代理会话。 |
| debugLog | false | 每次观察器/反思器运行写一行宿主日志。 |
| model | 会话模型 | 可选的 worker 路由：{ provider, model, reasoningEffort }。关闭或尽量降低推理——推理繁重的 worker 可能在输出 JSON 之前就耗尽全部输出上限。 |

验证

- /om-status 报告计数器和来源 token 时钟；/om-view 打印渲染后的记忆块。
- memory_recall 注册为按智能体使用的工具。
- 会话当前的 system/message 包含 ## Observational memory。
- 记忆持久化在 observational_memory 中，覆盖值持久化在 observational_memory_settings 中（桌面端位于 ~/.dsh/storages/*.json）。

限制

- worker 使用会话模型，除非 model 覆盖它；池修剪是确定性的（最旧优先），不由模型驱动。
- 快速压缩仅在加载了压缩后端、并以 purpose: "compaction" 调用会话模型时才会启用。
- 记忆是派生状态；会话日志仍是事实来源。
- /om-status 和 /om-view 命令界面通过标准注册表；渲染后的外观不在自动化测试覆盖范围内。

许可证

MIT © AntonyLang。见 LICENSE。