Memory Console · 记忆控制台

给 DeepSeek Harness 的上下文记忆控制台：按任务阶段看清模型装了什么，并主动收起、移出、恢复。
只改模型视图，聊天记录与会话日志永远保留。

---

为什么做这个

长会话里，模型上下文是一个黑盒：

• 到底哪一段在吃 token？是工具输出，还是早期闲聊？
• 现在该继续聊，还是该收起早期内容？
• 收起之后模型还"记得"什么？还能恢复吗？
• 一次收几段、收哪几段，会不会把关键约束收掉？

大多数"记忆插件"解决的是"存更多"；Memory Console 解决的是"管得住"： 把上下文切成可理解的任务阶段，让"收起 / 移出 / 恢复"变成一次可预览、可撤销、可审计的操作。

---

界面

右侧栏「记忆」面板

_{右侧栏面板：构成环、上下文压力、增长曲线与建议队列}

• 任务阶段：按真实的人类任务切分。系统注入、技能目录、编队/子代理通知会自动归组，不再是一堆看不懂的碎片；
• 构成环：系统提示 / 用户消息 / 助手消息 / 工具结果 / 注入通知 / 已收起 六类占比，悬停联动图例与说明；
• 上下文压力条：已用 vs 窗口、可收起区间、自动折叠线，一眼判断"该不该收"；
• 上下文增长图：按阶段累计的折线，绿点标记收起发生的位置；
• 建议队列：「⚡ 5 段建议收起」一键选择，但绝不自动执行；
• 多选 + 批量收起：确认后逐段独立写入官方 compaction 事务；
• 查看摘要 / 恢复：已收起阶段可展开摘要、随时还原原文。

全屏「记忆中心」

_{全屏记忆中心：左侧主会话列表，右侧同一套记忆控制台}

• 左侧：主会话列表（打开中的可直接管理，历史会话只读）；
• 右侧：同一套记忆控制台，适合跨会话盘点；
• 子代理/编队会话默认隐藏，避免一次团队任务刷出几十条。

批量收起

_{勾选多个任务阶段，一次确认、逐段独立收起}

• 勾选后可看到「已选 N 段 · 合计 X tokens」；
• 确认后每段各自写一次官方 compaction 事务，互不影响；
• 每段都能单独恢复。

收起之后：折叠行、摘要与恢复

_{收起后聊天里出现官方“上下文已压缩”折叠行；面板里可展开摘要、随时恢复原文}

• 收起前会预览：这一段多大、模型将看到什么摘要、省多少 token；
• 收起后阶段标记为「已收起」，可查看摘要或一键恢复；
• 原文始终保留在会话日志，恢复后上下文会重新变大。

---

核心概念

概念	含义
任务阶段	从一条人类消息开始，到下一次人类消息之前的所有内容（含工具调用、子代理通知、系统注入）
收起（fold）	用一个摘要替换该阶段的模型视图；聊天里出现官方折叠行；原文仍保留，可恢复
移出（remove）	用一个短占位替换该阶段；模型完全看不到原文；同样可恢复
恢复（restore）	把该阶段原文重新放回模型视图
可收起	任务阶段且 ≥1200 tokens（避免"摘要比原文还大"）

两者都只改模型视图，不改聊天记录、不删会话日志。

---

安全设计

收起不是"删聊天记录"，而是写 DSH 官方的 compaction（上下文压缩）事务：

compaction/start      { compactionId, turn: null }
compaction/summary    { summary, shadowedRange, shadowedSeqs, shadowedTokenCount, provider, model }
user/message          surfaceOp = replace, source.kind = 'compact-checkpoint'
compaction/end        { compactionId, turn: null }

• 完整括号：四个事件在同一同步块写入，重启后可正常 replay；
• 写前体检：日志里已有 compaction 结构问题时拒绝写入；
• 失败收尾：中途失败补写带 error 的 compaction/end，日志仍可加载；
• 系统头保护：不折叠 system 提示；不切开未完成的 tool-call/result；
• 可恢复：原文始终在会话日志；
• 摘要语义化（规则抽取，零额外模型调用）：用户请求、关键决定/约束、涉及文件、运行命令、工具使用次数。

早期版本曾只写 compaction/summary 而缺少 start/end，导致重启后会话无法加载。 该问题已修复，并由测试用真实官方 replay oracle 覆盖，防止回归。

---

快速开始

安装

从 npm（推荐）：

dsh plugin --profile desktop add dsh-memory-console

从本地目录（开发时）：

dsh plugin --profile desktop add /path/to/plugin/memory-console

也可以在 DSH Web 的插件管理器里选择 install_bundle，目标填插件目录的绝对路径。 安装后打开会话右侧栏的「记忆」标签；左侧面板列表可打开「记忆中心」全屏页。

环境要求

• DeepSeek Harness 0.2.1-rc.2（Desktop / Web profile 验证）
• 无需额外依赖；client.js 已随仓库提供，安装即用，不需要构建

开发

cd plugin/memory-console
node scripts/build-client.mjs   # 修改 src/client/*.js 后生成 client.js
npm test                        # 10 项单元测试（无第三方依赖）

需要额外验证时，可运行 pm run test:harness`（依赖本机已安装的 DSH 与真实会话日志，普通用户不需要）。

---

命令（面板的快捷方式）

命令	作用
/mem report	阶段列表与占用
/mem dryrun <n>	预览收起（含模型将看到的摘要）
/mem fold <n> --yes	收起单段
/mem remove <n> --yes	移出模型视图
/mem restore <id>	恢复原文
/mem status	本插件操作记录
/mem diag	依赖与 compaction 事务体检

日常操作建议直接用面板，命令只作为快捷方式与排障入口。

---

架构

plugin/memory-console/
  index.js                  # Host 入口
  client.js                 # Client bundle（由构建脚本生成）
  src/
    host/
      plugin.js             # 注册命令 + RPC 路由
      commands.js           # /mem 各子命令
      phases.js             # 会话 surface → 任务阶段（切分、统计、摘要抽取）
      compaction.js         # compaction 事务：preflight / 括号写入 / 失败收尾 / 体检
      surgery.js            # 收起、移出、批量、恢复
      rpc.js                # 面板 HTTP 路由 /api/memory-console
      text.js               # 展示与 token 估算
    client/
      10-core.js            # 常量、格式化、HTTP API 封装
      20-components.js      # 构成环、压力条、增长图、阶段行、预览
      30-app.js             # 右侧栏面板、全屏记忆中心、注册逻辑
  test/                     # 单测 + 官方 invariant/harness 集成测试
  scripts/build-client.mjs  # src/client → client.js

• Host 侧是标准 ESM 模块；
• Client 侧浏览器不能相对 import，构建脚本把 src/client/*.js 顺序组装进 __ModuleLoader__ 的 factory；
• 面板数据走插件自己的 POST /api/memory-console HTTP 路由，不依赖 WebSocket RPC。

---

已知限制

• 只支持打开中的（live）会话进行收起/恢复；历史冷会话在记忆中心只展示、不可管理；
• 自动折叠线为估算值（依据请求 header 的 maxTokens 与 64k headroom，默认窗口 1,048,576）；
• 摘要为规则抽取，不做额外模型调用（LLM 语义摘要作为后续可选项）；
• 仅在 DSH Desktop/Web profile 验证，CLI/headless 未测。

---

Roadmap

• 固定（pin）阶段与"永不自动收"保护
• 可选 LLM 语义摘要（默认关闭，显示成本预估）
• 任务级 A/B 实验：主动管理 vs 放任自动折叠（token / 准确率 / 延迟）
• 中英文界面
• 冷会话只读分析

---

License

MIT