dsh-memory-archive
vv5v5/dsh-memory-archive
Memory archive and prompt viewer for DeepSeek Harness: read back what compaction folded out of context - browse past sessions or Tavern playthrough archives (summary, original text, state) with full-text search - and inspect the prompt each turn actually sent, listing every assembled system section with its order, character count, offset, hash and mutability, plus an assembly map, registry export, and honest diagnostics when a section is empty or its log cannot be read. Optionally provisions a roleplay agent preset.
설치
dsh plugin --profile web add github:vv5v5/dsh-memory-archiveREADME
dsh-memory-archive · 记忆库
不发明记忆，只把 DSH 已经压掉的东西重新变得「取得到」。
DSH 的上下文压缩（compaction-basic）本来就在把旧内容折叠出模型可见面。
本插件不重写压缩、不重写摘要、不建第二份存储、不改 DSH 本体一行，只补三件事：
- 取用 —— 被折叠的内容一直都在会话日志里，缺的是一个够得着的入口（面板 / 检索 / 每轮注入）；
- 如实标注 —— 每条内容标明它此刻是
current（还在模型可见面）/shadowed（已被压出上下文）/log-only（本来就不上面）； - RP 的那一小套 —— 剧情笔记写入、最近几楼、第一轮保留、角色卡后处理指令、RP 专用压缩后端与压缩后收纳。
配套的两个独立插件（都是可选的，本仓库不含它们的代码）：
pmp-dsh-tavern（角色卡 / 世界书 / 周目 / ST 预设）与
dsh-anima-rag（向量 + BM25 检索、回响、向量面板那半边）。
它现在能干什么（如实标注）
| 能力 | 状态 |
|---|---|
| 记忆库面板：摘要 / 原文 / 剧情大纲 / 向量 四档 + 设置 | ✅ |
| 提示词查看器：每次模型请求真正发出的全文（system 段地图、段级偏移、点开看该段正文、消息流） | ✅ |
剧情笔记写入：memory_write 工具，写进本会话周目的 .roleplay-memory/（⛔ 只写周目目录） | ✅ |
预部署资料：把要预置的文件放进工作区根 .roleplay-memory/ ⇒ 新周目开局就读得到（只读、所有周目共享；见下） | ✅ |
每轮注入：mt:memoryProtocol · mt:memoryHome · rp:firstRound · mt:lastFloors | ✅ |
| 角色卡后处理指令（PHI）：从 system 段挪成「玩家消息之后」的一条 user 消息（默认开） | ✅ |
RP 压缩后端：中文归档指令（mt-compaction-rp.js，由本仓库生成、挂进预设目录） | ✅ |
| 压缩后自动收纳 + 孤儿清理（摘要进库、账本防重、被删切片的对账与隔离） | ✅ |
| OOC 两席：输入栏的「OOC」前缀按钮 + 划词「质疑」 | ✅ |
一个 skill：rp-assistant（带三份可查资料，见下） | ✅ |
自带的 RP 预设：preset/（组装 + 模块 + 压缩后端），node preset/install.mjs --apply 铺到预设目录 | ✅ 可选，随包发布；模块从本仓现场取 ⇒ 预设与插件不各自漂移 |
两种根：会话模式（零依赖）/ 工作区模式（需 pmp-dsh-tavern） | ✅ |
| 预设生成 / 写入面（detect · apply · rollback · provision · backups · pack） | ⛔ 已退役（2026-09-19 用户口径：「不用保持了」）—— 预设目录现在自己维护，本插件不再替你改 |
状态子系统（state-bridge 子包 + state:card 段 + 5 个状态工具） | ⛔ 已剥离（2026-09-20）—— 状态改由周目笔记 state.md 承载，模型按文件开头写的要求自己维护 |
安装
# 从 GitHub
dsh plugin --profile <你的 profile 名> add github:vv5v5/dsh-memory-archive
# 或本地目录（开发用）
dsh plugin --profile <你的 profile 名> add ./dsh-memory-archive
装完重启一次宿主：浏览器半侧的 bundle 是宿主启动时组装的。
附带的 RP 预设（可选）
本包自带一份「角色扮演」预设（preset/：组装文件 + 几个模块 + RP 专用压缩后端）。
它的描述里写明「由 dsh-memory-archive 提供」 —— 预设列表里同名的那份是社区预设，认描述就能分开。
它不会自动生效（DSH 的预设是文件系统型的），要铺一次：
node <profile>/node_modules/dsh-memory-archive/preset/install.mjs # dry-run：先看会写什么
node <profile>/node_modules/dsh-memory-archive/preset/install.mjs --apply # 真写（默认 roleplay 目录）
细节、依赖与限制见 preset/README.md。
本包没有构建步骤 ——
lib/里就是可直接运行的 JS（react由 DSH 平台的模块 seed 表提供）。
依赖
| 功能 | 依赖 |
|---|---|
| 记忆库（会话模式）/ 提示词查看器 / 工具与注入 | 零依赖 —— 原版 DSH 纯净环境即可用 |
| 工作区模式、剧情笔记目录、剧情大纲、向量页签的体检行 | 需要 pmp-dsh-tavern（可选，未装时相关入口置灰并说明原因） |
检索注入（anima:memory）、回响、向量页签的动作 | 需要 dsh-anima-rag（可选） |
两者在 package.json 里都是 optional peer，不会被强制安装。
两种根模式
记忆库要能在两种环境里用，而它们的「根」根本不是同一种东西 —— 所以根是一个可切换的模式：
| 会话模式（默认） | 工作区模式 | |
|---|---|---|
| 根 | 一条手动选定的 DSH 会话 | Tavern 工作区里某个周目的 archive/ |
| 数据来源 | DSH 自己的会话事件日志（精确读，不触发索引重建） | 归档文件（floors/ summaries/ .roleplay-memory/） |
| 能看到 | 该会话的全部事件，含已被压缩出上下文的那些 | 归档契约覆盖的那些：原文 / 摘要 / 剧情笔记 |
| 依赖 | 无 | pmp-dsh-tavern |
「手动选择」是刻意的 —— 「哪条会话算记忆」是用户的语义判断，不做自动推断。
面板
侧边栏底部两个入口：记忆库（齿轮）与 Agent 编辑器（只读检视组装）。输入栏里还有两席（OOC）。
记忆库 → 四档 + 设置
- 摘要 —— 按楼序拼接成长文，从头读到尾；
- 原文 —— 按需懒加载：每条的
surface如实标记（current/shadowed/log-only），未发给模型的楼层如实标注； - 剧情大纲 —— 本会话周目
.roleplay-memory/里的笔记（index.md/state.md/characters.md/world.md…），内容需手动确认才展开；展开后两处落点各一行（本会话周目目录 / 跨周目共用那份），各自标「在 · N 份」或「还没有」，并各带一个按钮：打开文件夹/创建并打开（周目目录还没建 ⇒ 先建再开）/打开工作区根（共用那份还没建 ⇒ 打开工作区根让你自己放，⛔ 我们不替社区预设建目录）； - 向量 —— 本库（
dsh-memory）的体检行 + 两行库（向量 / BM25，各带⚠缺失/ 重建 / 删除）+ 一个「参与检索」开关；动作走一张请求单，由dsh-anima-rag在该周目会话的下一轮开始前执行，回执写回来（lib/vector-panel.js）； - 设置 —— 根模式与根选择、向量检索 API（向量模型与重排模型各一套「接口地址 / 模型名 / 密钥」，两个密钥都只写不读、可各自清空）、提示词模板（压缩指令 / 收纳占位）、各项开关。
会话、周目、角色都显示真名而不是 id；三级回退（title → 周目反查 → 8 位截断 id）各级如实标注来源，
任何情况下都不显示完整 UUID。
Agent 编辑器（只读）
当前会话所用 preset 的段 / 插件 / order 清单（每项一句「谁注入 · order · 作用」）、段级偏移、 「面板值 vs preset 实际值是否一致」（不一致就明说「面板改了也不会生效」）。v5 起零写入，连备份目录都不建。
每轮往提示词里注了什么（RP）
★ 口径：会话优先，认不出来的会话当新会话（2026-09-20）。「哪个周目」按这个会话在 Tavern
catalog.json/timeline.json 里归入的那个算；认不出（新开的会话还没被 Tavern 认领 / 不是 Tavern 的会话）
⇒ 没有周目：下面凡是要"某个周目"的，一律不注入，memory_write 也直接报错。
会话若同时被两个周目引用 ⇒ 判给它是 rootSessionId 的那个（顺序无关）；两个都不是根才按 catalog 顺序。
面板里那个「工作区根」只是查看用的视图（手动选根看别的周目照旧），⛔ 不决定注入写哪儿。
顶栏会并排显示两件事：当前根：…（视图）+ 本会话：…（生效；未归入时是红字）。
★ 预部署（新周目开局就带上下文）：把要预置的文件（角色设定 / 世界书 / 写作规矩一类）放进
工作区根下的 <工作区根>/.roleplay-memory/ —— <memoryHome> 段会把它列出来（只读），
模型开局就读得到；⛔ 它不是写的地方（各周目的笔记仍只写自己周目目录，免得串味）。
为什么只能提前放到这儿：周目目录名里带新建时才知道的 UUID（playthrough-<uuid>）。
| 段名 | 作用 | 开关（插件 config.json） |
|---|---|---|
mt:memoryProtocol | 告诉模型什么时候该主动去检索历史 | 常开 |
mt:memoryHome | 告诉模型剧情笔记写在哪个目录 | 常开 |
rp:firstRound | 把第一轮原文钉住（每轮在场、永不进可压区间） | keepFirstRound.enabled |
mt:lastFloors | 本会话上下文还短时，把本档案最近几楼的原文当历史喂进去 | lastFloors.enabled · count · maxChars |
anima:memory | 检索到的历史（<recalledMemories> + <immediateHistory>）—— 由 dsh-anima-rag 填 | 见那个插件 |
| （PHI） | 角色卡的后处理指令：从 system 段挪成玩家消息之后的 user 消息 | phiAsMessage.enabled，默认开 |
★ PHI 是唯一一处故意写进会话历史的注入（其余全走「不写历史」的缝）：因为 DSH 的 system 段无法实现文末注入， 只能拿 user 消息模拟。代价是它在每轮之间会积累 ⇒ 提示词查看器里标红显示、不计楼层，记忆库不收录它。
配置存在哪
<DSH_HOME 或 ~/.dsh>/dsh-memory-archive/config.json
权限 0600（里面有 API 密钥）、原子写（临时文件 + rename）、读坏不崩（回落默认值并如实报错）。
密钥只在本机：不进 git、不进日志、不经任何响应体回显（宿主只回 keySet 与末 4 位提示）。
主要键：rootMode · root · retrieval{url,model,key,rerankUrl,rerankModel,rerankKey,chatEnabled} · prompts{compaction,placeholder,compactionJailbreak}
· keepFirstRound · echo · lastFloors · memoryWrite · phiAsMessage · autoCollect · summarize · v3。
宿主接口
全部为同源 HTTP，两条前缀路由在宿主启动时同步注册（ctx.effect 管生命周期，热重载不留野路由）：
| 前缀 | 内容 |
|---|---|
/dsh-memory-archive/api | 配置读写、会话精确读、/templates（提示词模板）、/sessions、/session/events、/collect/*（收纳）、/playthrough/*（周目目录与打开文件夹）、/vector/state + /vector/action（向量页签）、/retrieval/test（向量与重排各发一次最小请求）、/agent + /agent/card(s)（装配只读检视与角色卡阅读）、/sections*（段表与正文） |
/dsh-memory-archive/prompt | 提示词查看器的数据面：/health、/api/sessions、/api/session、/api/part |
拿不到的服务一律降级并说明（ok:false + 可读 code），⛔ 不抛、⛔ 不 500、面板不白屏。
设计要点
完整思路见 docs/DESIGN.zh.md。四条：
- 能用原生机制就用原生机制 —— 「隐藏旧楼层」= surface
replace遮蔽，而 append-only 事件日志是真相源 ⇒ 任何遮蔽都可逆； - 不建第二份存储 —— 压缩只是把内容移出模型可见面，没从日志或索引里删掉。缺的从来不是存储，是取用；
- 注入只走「不写历史」的缝 —— 只用
systemPrompt.section()与system-prompt/assemble瀑布；⛔ 不用systemPrompt.context()（它是 durable user-role 快照，长对话里等于每轮追加一条）； - 一件事只有一个写者 —— 向量库归
dsh-anima-rag（面板只读状态 + 写请求单）；预设目录归用户（本插件已退役写入面）；剧情笔记归模型（走memory_write）。
已知限制（如实）
| # | 限制 | 说明 |
|---|---|---|
| 1 | surface 可能为 null | 平台版本不同或读取路径降级时如实填 null，绝不猜测 |
| 2 | 工作区模式依赖 pmp-dsh-tavern | 未安装时相关入口置灰并说明，不会崩溃 |
| 3 | 本插件不生成摘要 | 摘要由压缩产出（RP 压缩后端写 compaction/summary），本插件只把它收进库 |
| 4 | 「压缩指令」保存的是文本 | 它由预设目录里的压缩后端读取（mt-compaction-rp.js，用 _materialize-preset-modules.mjs 铺盘） |
| 5 | 状态不再有独立子系统 | 由周目笔记 state.md 承载，模型自己维护；⛔ 没有优先级更高的"状态工具" |
| 6 | 向量库的写入动作要等一轮 | 面板点动作 = 写一张请求单，由 dsh-anima-rag 在下一次装配执行（面板会显示进度与回执） |
| 7 | 未归入周目的会话什么都拿不到 | 口径如此（⛔ 不继承上一轮的绑定）：笔记路径、最近几楼、回响、检索、最近总结全停，memory_write 报可读错。先在 Tavern 里给它开/选一个周目（经 Tavern「与 X 新开周目」开的会话从一开始就有周目）。顶栏与「向量」档都会如实标出来 |
开发
npm run check # node --check lib/index.js && node --check lib/client.js
lib/index.js—— 宿主半侧：配置存储 + 同源 HTTP API + 每轮注入 + 自动收纳 + skill 注册；lib/client.js—— 浏览器半侧：工厂形式 CJS，只require('react')，无 JSX、无需构建；lib/prompt-viewer.js—— 提示词查看器宿主半侧；lib/vector-panel.js—— 向量页签宿主半侧（读状态快照 / 写请求单）；preset-modules/—— 挂进预设目录的那几个模块的源（含由生成器产出的压缩后端）；skill/rp-assistant/—— 那一个 skill 的正文与资料。
改完记得：_sync-plugin-deploy.mjs --apply（同步到部署副本）→ 换进程重启 → 自检台全量跑一遍。
许可与署名
- 许可证：Attribution-NonCommercial 4.0 International（CC BY-NC 4.0），SPDX 标识符
CC-BY-NC-4.0； 完整法律文本与 NOTICE 见LICENSE。 - Copyright (c) 2026 dsh-memory-archive contributors
移植来源与署名（按上游要求保留）
| 项目 | 内容 |
|---|---|
| 原项目 | anima-rag |
| 原作者 | Ellinav |
| 原项目地址 | https://github.com/Ellinav/anima-rag |
| 原项目许可 | Attribution-NonCommercial 4.0 International（CC BY-NC 4.0） |
| 移植许可 | 经原作者 Ellinav 许可后移植 |
场景限制（移植许可的条件）
- 仅限个人学习与非商业性用途；
- 禁止闭源商用，禁止转为付费插件/服务；
- 不重新分发任何预置私域数据。
第三方许可与出处
- 派生自：DeepSeek Harness 官方
compaction-basic（压缩指令模板取自其summarize钩子） —— MIT，Copyright (c) 2026 DeepSeek；本作品中该部分保留原始 MIT 声明。 - 移植/派生自：
anima-rag（作者 Ellinav） —— CC BY-NC 4.0；本作品随之整体以 CC BY-NC 4.0 授权。 - 互操作/致谢（⛔ 是互操作，不是派生）：
pmp-dsh-tavern、dsh-anima-rag—— 均为 MIT；本作品不包含它们的任何代码，只与其配合工作。