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
