dsh-layered-memory
给 DeepSeek Harness（DSH） 的四层记忆插件：
| 层 | 存什么 | 怎么写 | 怎么用 |
|---|---|---|---|
| 核心层 | 身份、根本人设、安全边界、授权规则 | 默认只读；只能走 layered_core 提案 + 用户授权 |
作为系统硬约束注入，不参与普通检索 |
| 内隐层 | 稳定偏好、表达风格、行为策略、技能倾向 | 主模型用 layered_store(layer=implicit) 观察；证据够了才由本地反射晋升 |
作为风格先验注入，不陈述为事实 |
| 外显长期 | 重要事件、事实、约定 | layered_store(layer=explicit) 或短期显著片段晋升 |
每轮按相关度召回摘要；layered_search 查细节 |
| 短期 | 最近对话、任务中间状态 | 自动写入，TTL 过期 | 只注入显著片段；过期前可晋升为候选 |
四层之外有两个横切能力：审计（audit.jsonl）和遗忘调度（TTL、衰减、归档、回收站、删除传播）。
它不调用额外的模型，不额外要 key。反射、检索、遗忘都是本地确定性逻辑；只有主模型自己决定调用工具时才会产生正常的工具调用开销。
安装（桌面版，推荐）
DSH 桌面版没有 dsh CLI 时，最稳的是用 profile 的 cordis.patch.yml 直接加载插件文件。DSH 支持在 patch 的 insert 里写绝对路径（会转成 file:// URL）。
先备份（
$DSH_HOME换成你的 DSH home，桌面版常见D:/dsh-data）：cp "$DSH_HOME/profiles/desktop/cordis.patch.yml" "$DSH_HOME/profiles/desktop/cordis.patch.yml.bak-$(date +%Y%m%d-%H%M%S)"在
$DSH_HOME/profiles/desktop/cordis.patch.yml末尾追加：# === 分层记忆（dsh-layered-memory）=== - insert: - id: layered-memory name: '/absolute/path/to/dsh-layered-memory/lib/index.js'Windows 路径用正斜杠即可，例如
'D:/tools/dsh-layered-memory/lib/index.js'。重启 DSH。首次启动会自动创建
$DSH_HOME/layered-memory/。打开
$DSH_HOME/layered-memory/core/persona.md等三个文件，填入核心人设与边界。插件只读这些文件，不会自动改写。
也可以用环境变量
LAYERED_MEMORY_HOME单独指定数据目录。
用 GitHub 安装（可选）
仓库：https://github.com/yinling2024/dsh-layered-memory
dsh plugin --profile desktop add github:yinling2024/dsh-layered-memory
或者手动克隆后，按上面的 profile patch 方式加载：
git clone https://github.com/yinling2024/dsh-layered-memory.git
装完重启 DSH。
Linux / 服务器
插件零外部依赖，复制整个目录到服务器，然后在对应 profile 的 cordis.patch.yml 里加同样的 insert（绝对路径），重启 DSH 即可。
工具
| 工具 | 作用 |
|---|---|
layered_store |
写外显长期（事件/事实）或内隐倾向（偏好/策略/技能）。外显支持 factKey：同一键只保留最新，旧条目标 superseded 但保留可审计 |
layered_search |
按「相关度 + 新近 + 重要度 + 置信度」检索外显记忆；空 query 时用当前用户消息 |
layered_forget |
删除一条外显记忆：默认进回收站 30 天，hard=true 彻底删除 |
layered_core |
list / propose / apply / rollback。apply 和 rollback 必须 confirm: "APPLY" |
layered_status |
各层条数、待批准提案、数据目录、当前配置 |
核心层变更协议
- 用户明确说「改核心人设」；
- 模型调用
layered_core(action="propose", file="persona", content="...")； - 模型把返回的 diff 给用户看；
- 用户明确授权后，模型才调用
layered_core(action="apply", proposal_id="corep_...", confirm="APPLY")； - 写入前自动备份到
core/versions/，可用rollback回滚。
提案默认有 30 秒冷却：刚生成的提案不能立刻 apply，强制中间过一次用户确认。可以在 config.json 的 core.applyCooldownSeconds 调整；设为 0 会取消这道时间门（不建议）。
数据目录
<DSH_HOME>/layered-memory/
config.json # 所有可调项
audit.jsonl # 追加式审计（谁在何时改了哪层）
core/
persona.md # 核心人设（只读）
boundaries.md # 安全边界（只读）
authorization.md # 授权规则（只读）
proposals/ # 核心变更提案
versions/ # 每次 apply/rollback 前的备份
explicit/
manifest.json # 外显记忆索引（标题/类型/重要度/状态/来源）
entries/ # 记忆正文 markdown
archive/ # 衰减归档
trash/ # 回收站（默认 30 天）
implicit/
implicit.json # 内隐参数 + 候选证据 + 每日更新计数
short-term/
<session>.json # 每会话短期缓冲（TTL）
diag.log # 插件诊断日志
外显记忆的元数据在 manifest.json，正文是普通 markdown，可以直接打开看。手工改正文/元数据后建议重启 DSH（检索索引有内存缓存）；日常写入走工具即可。
同一个 profile 里如果已经有
dsh-fish-memory、dsh-memory之类的注入式记忆插件，建议只留一套常驻注入，避免同一段记忆被重复塞进上下文、白花 token。
配置
config.json 首次启动自动生成。常用项：
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关；false 时插件不注册工具、不注入 |
prompt.coreMaxChars |
6000 |
核心层注入上限 |
prompt.implicitMaxChars |
900 |
内隐层注入上限 |
prompt.hint |
true |
是否注入一小段「你可以用这些工具」的提示 |
prompt.recallMaxChars |
900 |
每轮长期召回上限 |
prompt.shortTermDigest |
true |
是否注入显著短期片段 |
recall.topK |
5 |
每轮最多召回几条 |
recall.minScore |
0.28 |
召回分数门槛 |
recall.alwaysFacts |
2 |
每轮固定带几条高重要度语义事实（0 关闭） |
shortTerm.ttlMinutes |
30 |
短期 TTL |
shortTerm.maxItems |
40 |
每会话短期上限 |
shortTerm.autoCandidate |
true |
显著短期片段自动进外显候选 |
implicit.minEvidence |
3 |
内隐晋升所需证据数 |
implicit.minDays |
2 |
证据至少跨几天 |
implicit.dailyUpdates |
3 |
内隐每日最多更新几个参数 |
implicit.maxStep |
0.05 |
单次置信度变化上限 |
explicit.candidateBelow |
0.5 |
低于这个重要度的新记忆先进候选 |
explicit.archiveAfterDays |
120 |
低重要度记忆多久后归档 |
explicit.trashDays |
30 |
回收站保留天数 |
core.applyEnabled |
true |
是否允许核心层 apply/rollback |
core.applyCooldownSeconds |
30 |
提案生成后多久才允许 apply |
调低 prompt.recallMaxChars / recall.topK / recall.alwaysFacts 可以省 token；alwaysFacts 是每轮常驻的，最影响成本。
设计边界
- 内隐记忆不能改核心：内隐参数只影响「怎么表达、怎么偏好」，不改变身份、安全边界、授权规则；核心层只能走显式提案。
- 不是所有对话都写：外显写入靠工具或显著短期片段；短期过期即丢，只有显著片段会晋升。
- 遗忘不是一刀切：短期 TTL；外显先降权、归档、回收站，最后硬删除；用户明确「忘掉」时走
layered_forget。 - 冲突有规则：外显同
factKey新值取代旧值（旧值保留）；内隐冲突按作用域和证据处理，用户纠正立即降权；与核心冲突的写入拒绝。 - 审计可追：所有写入/取代/删除/核心变更都进
audit.jsonl。 - 不额外调模型：没有后台 LLM 调用；只有主模型主动调用工具时才有开销。
自测
cd dsh-layered-memory
node --test test/*.test.js
测试覆盖：外显写入/检索/去重/事实键取代、回收站与硬删除、内隐证据反射与用户纠正、核心提案/冷却/APPLY 门控/回滚、短期 TTL/候选晋升、mock DSH 装配。
兼容性
- 实测目标：DSH 0.2.1-rc.3（
@deepseek-ai/dsh-tools/dsh-system-prompt同版本）。 - 使用 DSH 的
systemPrompt.section/context、tools.register、agents.list、agent/inbox/inserted、agent/turn-stopping、ctx.interval。 - 不依赖
@deepseek-ai/*包，因此不需要改 profile 的pnpm-lock.yaml，也不会覆盖 DSH 的依赖闭包。
No comments yet. Be the first to write one.