dsh-memraw

dsh-memraw

给 AI 一个不会遗忘的大脑：原文全量、坐标可溯、按需取回。

dsh-memraw 是给 DeepSeek Harness 用的原文全量记忆引擎。 它把每一轮对话一字不改地写进本地 SQLite，用坐标索引让 AI 随时回读原话——不是"它记得大概"，而是"它能翻到那一句"。

为什么需要它（Why）

主流记忆方案走的是「压缩 → 摘要 → 遗忘曲线」：把长对话揉成几百字，然后丢掉原文。 代价很直接：

粗暴压缩 · dsh-memraw 细节被摘要吃掉，答"具体是哪天、哪句话"就只能编 · 原文全量落盘，session#seq 精确回读 摘要与事实都是黑盒，错了无法验证 · 摘要/切片/索引全是派生数据，可由原文重建 靠"降权/淡忘"控制体积，旧事会真消失 · 只冷归档，永不遗忘，只按需取回 每轮把记忆硬塞进上下文，token 随轮次膨胀 · 不注入，需要时用工具检索，上下文零增长

一句话：别的方案在替 AI 做减法，这个插件替 AI 保存底稿。

安装

要求：DSH 桌面端（Electron 内置 Node ≥ 22.5，提供 node:sqlite）。无任何 npm 运行时依赖。 已验证：Windows 11 + DSH 0.2.1-rc.2。

dsh plugin add dsh-memraw

装完确认：

mem_status()        → { errors: 0, sessions: N, events: M, ... }
Tool.listTools      → 应看到 11 个 mem_* 工具

数据目录：%USERPROFILE%.dsh\memraw\raw.db（Windows）／$DSH_HOME/memraw/raw.db（通用）。

升级 / 卸载：dsh plugin add 指定版本即可；数据目录独立于代码，重装不丢记忆。

本地开发：plugin_manager set_plugin 对 include:memraw 先 false 再 true 可热重载 link 安装的代码。

核心特性（Features）

1. 全量原文底座 + 坐标溯源

每个 session/event 原样写入 raw_event（只 INSERT，永不 UPDATE/DELETE）。 每条切片、摘要都携带 [start_seq, end_seq]，指回原始事件：

s=c69568d4#267-267   →   会话 c69568d4，第 267 条事件

mem_read 按坐标取回原文，引用历史时可以带上"哪场会话、哪一刻、第几条"，不靠印象。

2. 动态上下文组装

不做"每轮全量注入"，而是分层、按事件触发：

层 · 内容 · 时机 常驻 · 检索指引 + 热记忆（我是谁/用户是谁/准则） · 每个会话，内容稳定，命中缓存 首轮 · 本工作区近期摘要，或"新工作区"提示 · 新会话第一轮，仅 1 次 缺口 · 被压缩区间的原文 · /compact 后，仅 1 次 按需 · 检索到的原文片段 · 调用 mem_search 时

3. 跨工作区检索，隔离与全局自由切换

• 默认全局检索：换了工作区也能问"上个月那个项目"；
• scope: "workspace"：只看当前工作区，避免聊天区搜到代码、代码区搜到闲聊；
• workspace: ""：指定某个工作区。

每条结果带 workspace 标签与来源时间，跨区也不会混淆。

4. 超大事件截断 + 指针读取

单条事件超过 100KB 时只保存头 4000 字 + 原文指针，不把垃圾塞进上下文； 需要全文时 mem_read(session, seq, offset, length) 会回到会话日志分页拼回，逐段读完。

5. 压缩摘要，坐标绑定

/compact 发生时后台异步生成摘要（本地抽取，不调模型），标题带工作区标签：

【压缩摘要｜默认工作区】s=c69568d4#2400-2420（12 条消息）
诉求：…
结果：…
工具：edit×3、read×2

异步、幂等、失败静默降级——绝不阻塞或影响合并动作本身。

6. 条件触发的安全约束

隐私、外链、危险操作、只读、转发、保密 6 条内置规则，只在命中用户输入时注入一句极短约束，每个会话每条只注入一次。约束不塞进常驻人格。

7. 一键备份 / 恢复

mem_export 生成一致性快照（VACUUM INTO + integrity_check + sha256 + 原子改名），mem_import 校验后合并式导入，绝不覆盖本地数据。

Token 开销（重要）

本插件的设计目标之一是不吞 token。它不做逐轮注入，所以上下文不会随对话变长而膨胀：

场景 · 频率 · 量级 常驻检索指引 · 每会话常驻 · ≈ 450 字符（约 300 token），稳定命中缓存 热记忆 · 仅你主动写入 · 几十 ~ 几百字 新会话引导 · 每会话 1 次 · ≤ 150 字 压缩缺口补全 · 每次压缩 1 次 · ≤ 4000 字符（gapChars 可配） 压缩摘要 · 压缩时后台 · 0（本地抽取，不调模型） 检索结果 · 仅调用工具时 · 默认 top 8，每条截断 900 字 每轮注入 · 无 · 0

对比：若每轮硬塞 3000 token 记忆，100 轮就是 30 万 token 的冗余；本插件常态只多出一次性引导和按需检索，聊多久都不会自己涨。

工具（11 个）

工具 · 类别 · 作用 mem_search · 核心 · 检索原文；默认全局，scope:"workspace" 限本区，workspace 指定区；返回带坐标、工作区、时间的片段 mem_read · 核心 · 按坐标回读事件；offset/length 分页；超大事件从会话日志现读拼回 mem_status · 核心 · 库状态：路径、会话/事件/切片数、错误、最近补全与摘要 mem_list_sessions · 核心 · 最近会话列表、覆盖水位、缺口起点 mem_note · 核心 · 把一条事实/结论落盘（可带原文坐标） mem_hot · 核心 · 写/改常驻热记忆（soul / user / rules / criteria） mem_export · 核心 · 一键备份（快照 + manifest + sha256） mem_import · 管理 · 合并式导入备份，校验校验和，不覆盖本地 mem_digest · 管理 · 为任意区间生成/列出带坐标摘要 mem_synonym · 管理 · 查看/扩充近义词词典 mem_policy · 管理 · 查看/扩充条件触发的安全约束

配置

写在 DSH 的 cordis.patch.yml 中 memraw 条目的 config 下：

key · 默认 · 说明 dir · $DSH_HOME/memraw · 数据目录 oversizeBytes · 102400 · 单事件超过它只留头 + 指针（按字节） chunkChars / chunkCharsMax · 1600 / 3000 · 切片目标/上限 backfill · true · 激活时补齐历史会话（按行数判断，允许乱序） guide · true · 是否挂常驻检索指引 gapRefill / gapChars · true / 4000 · 压缩后补原文、单次补多少字 autoDigest · true · 压缩时后台生成带坐标摘要 bootstrap · true · 新会话首轮注入「近期上下文 / 新工作区」提示 workspaceLabels · {} · 工作区目录 → 标签覆盖（默认用宿主标题/目录名）

没有 token 预算配置：因为不做每轮注入，不需要给记忆块分配比例。

数据与架构

$DSH_HOME/memraw/
  raw.db                 # 原文 + 切片 + FTS + 摘要 + 热记忆 + 规则
  backup/<timestamp>/    # raw.db + manifest.json（含 sha256）

表 · 作用 raw_event · 原文底座，只追加 session_meta · 会话元信息、采集水位、压缩缺口 chunk + chunk_fts · 按轮切片 + FTS5（中文单字/二元词 + 词典扩展） digest · 压缩摘要 / 手工事实（带坐标） hot / policy / synonym · 热记忆、安全约束、近义词 assembled_log · 观测：补全与首轮引导记录

索引与摘要全部可由 raw_event 重建；chunker 升级时自动丢弃切片并重放原文。

已验证与边界

已实测：安装、采集、跨区检索、原文回读（含 171KB 超大事件分页拼回）、压缩摘要、条件约束、备份导出、合并导入、npm 安装。

尚未实测 / 限制：

• 压缩缺口补全只在运行中的会话触发（压完不再进入的会话只靠摘要 + 检索召回）；
• 换机导入未做端到端验证；
• 与 meow-memory 的去重是规则级（标源 + 提示），不是逐条内容比对；
• 目前仅在 Windows + DSH 0.2.1-rc.2（Electron / Node ≥22.5）验证。

开发

plugins/dsh-memraw/
  index.js          # 插件入口：钩子、工具、注入策略
  lib/store.mjs     # SQLite 存储、检索、摘要、备份
  lib/text.mjs      # 分词、FTS 表达式、内容抽取
  cordis.patch.yml  # bundle 插桩

• 本地 link 安装后用 set_plugin 关开热重载，不必重启；
• 改完先跑离线 harness（stub Cordis ctx），再上真机。

License

MIT © 2026 dsh-memraw contributors