dsh-memory_rollout

为 DeepSeek Harness (DSH) 提供的 Codex 式会话持久记忆。 English README

早期版本（0.1.x），51/51 测试通过、已进入候选观察期，欢迎反馈。

解决什么问题

DSH 的每个会话都从零开始。你开一个新会话，Agent 不知道上一轮定了什么、你偏好什么、踩过哪些坑。dsh-memory_rollout 给 Agent 一份有组织、只在必要时才写的持久记忆：事实、偏好、决策、项目笔记能跨会话活下来，并在需要时被想起、给出来源。

项目功能

• 一会话一草稿 — 每个符合资格的会话由 Stage 1 生成或追加证据草稿（rollout_summaries/<sessionId>.md，类似子 AGENTS.md）；Agent 也可在压缩前显式保存关键要点。
• 分层披露 — memory_summary.md（注入提示）→ MEMORY.md（可搜索注册表）→ 少量相关草稿 / 笔记。grep 友好，不做全量扫描。
• 克制被动 — 自动生成只处理符合资格的会话；手动新增、修改或遗忘长期记忆，仅在用户显式请求时执行；快速记忆通道（≤4–6 步）决定何时查记忆，不淹没上下文。
• 幂等整合 — 指纹 + 水印，无变化则不重复整合（不浪费 token）。
• 6 个用户工具 — memory_remember / memory_recall / memory_forget / memory_note / memory_integrate / memory_precompact，另有 2 个 memory__* 内部调度工具。
• 浏览器管理页 — 「记忆库 / Memory」页浏览摘要、注册表、草稿、笔记，可改配置、导入导出记忆。

管线基本描述

会话结束/闲置 → 持久入队 (Stage 1)
  → 提炼候选记忆 + append-only 证据（草稿 + source_ref）
  → Phase 2 全局整合 + 版本化发布（current 原子切换 / 旧版可回退）
  → 分层读取（总纲 → 注册表 → 少量草稿/证据）
  → remember / forget / supersede 进入统一变更流，再整合成权威版本

约束：无信号会话不产出脏记忆；失败不伪装成成功；秘密在入口 / 模型 / 落盘三处脱敏；引用指向真实内容，否则诚实 unverified；当前用户指令与 AGENTS.md 高于记忆。

安装

版本 0.1.9。npm registry 尚未正式发布（dsh plugin add dsh-memory_rollout 需要包先被发布到 registry），因此「可兑现」的安装路径是 GitHub 仓库 / 本地 tgz。

方式 A：GitHub / 本地 tgz（已兑现，推荐）

# 直接从仓库装（开发/自用）
git clone git@github.com:Bionic-forest/dsh-memory_rollout.git
pnpm add ./dsh-memory_rollout

# 或用 `npm pack` 生成的 tgz 装
pnpm add ./dsh-memory_rollout-0.1.9.tgz

方式 B：npm registry（未发布，暂不可用）

# 需先把包发布到 npm registry 后此命令才可兑现
dsh plugin --profile web add dsh-memory_rollout
pnpm add dsh-memory_rollout

dsh.bundle manifest 会自动把本插件挂进 profile。手动安装（任一种方式之后）在 profile 的 cordis.yml（或 cordis.patch.yml）加一行：

- id: dsh-memory_rollout
  name: dsh-memory_rollout

要求 DSH 基座 0.1.1-rc.2 或更新（peerDependencies 声明 ^0.1.1-rc.2）。插件把 sessionQuery 声明为必需服务（由 DSH 基座提供）——基座未挂载它则加载失败、自动记忆（Stage 1 来源读取）被禁用。

使用

让 Agent 记住事情，或自己写：

memory_remember(content="用户偏好…", tags=["pref"])   # → 长期记忆（带来源 sessionId）
memory_note(slug="fix-x", content="…")               # → 临时 note（用户显式要求时）
memory_integrate()                                    # → 幂等整合 summary/MEMORY.md
memory_precompact(content="要留的关键要点")          # → 压缩前防丢信息（草稿 + 持久队列）

当涉及先前会话时，Agent 跑一次快速记忆通道：扫注入总纲 → 搜 MEMORY.md → 打开 1–2 个相关草稿 → 无命中即停。memory_recall(query="…") 是显式搜索入口。

配置

插件暴露一个 schemastery 配置 schema。完整参数表：

设置页可在运行时编辑，改动持久化到 <ds_home>/dsh-memory_rollout.settings.json，下次启动重新应用（优先于 cordis.patch.yml）。memoryRoot 只读。

参考

本插件的记忆模型与 LLM 提炼提示词改编自 openai/codex 的记忆系统（Apache License 2.0）——面向 DeepSeek Harness 的独立重实现，未逐字分发其源码。同时改编自 flymysql/dsh-memory（MIT），即本插件脱胎的原始「跨会话记忆库」。详见 NOTICE 的署名。

协议

MIT（见 LICENSE）。

设置文件 / Settings file

• 位置：/dsh-memory_rollout.settings.json（不在 memories/ 里 ⇒ 导出/导入不会带上它）。
• 格式：{ "version": 1, "savedAt": "", "values": { …仅设置页可编辑的字段… } }。旧版裸对象格式仍可正常加载（向后兼容）。
• 优先级：settings.json（设置页写的运行时 overlay）优先于 cordis.patch.yml。因此若你在 patch.yml 里手工写过同名值，重启后那些值会重新生效 —— 「恢复默认」只清 overlay，不改宿主层的 patch.yml。
• 一键还原：「恢复默认」先把 overlay 备份为 dsh-memory_rollout.settings.json.pre-reset（同族只留最新 1），再删除 overlay，让代码 schema 的默认值重新生效（本会话即时生效、重启后同样生效）。删不掉时接口如实返回失败，不假装成功。

The settings page writes this overlay, which takes precedence over cordis.patch.yml. "Restore defaults" backs it up to …settings.json.pre-reset and deletes it so the schema defaults apply again; it never touches your patch.yml.