@jipika/dsh-memory
Progressive long-term memory for DSH: sharded markdown bodies under ~/.dsh/memory/topics/, with only a live-generated map (shard · keywords · count · latest date) injected into the system prompt, entries pulled on demand via grep + read — so the prompt cost stays flat however large the memory grows. Two layers (global + per-project) plus the global rule files, viewable AND editable in DSH Settings, with per-layer switches and an index/full injection toggle. v0.5.0 adds enforcement hooks: a write guard on the native tool pipeline (format/secrets/history rules, optional external command judge, deny/ask with reasons fed back to the model), post-write audit log, a read reminder when memory files are read, a mandatory discipline block, and an optional injection filter command. Zero extra LLM cost, live re-read. v0.5.1 keeps the switches in ~/.dsh/memory/settings.json — read live by the plugin and edited from the settings pane over the plugin's own route, independent of the host settings API. v0.6.0 fixes the index silently degrading to a title-less directory once memory outgrew the hardcoded 9k budget (which is why an agent could see memory injected and still never read it): the index now shrinks per-shard along a newest-N-per-shard ladder under a configurable indexBudget, adds per-shard keywords (routing hint) and latest-entry dates, ships a 'check memory before starting a task' discipline, and makes full mode read the shard bodies (auto-falling back to index when over budget) instead of the retired memory.md navigation file. v0.7.0 makes 'map' the default injection mode (shard-level map only, no entry titles): retrieval = grep the memory dir with task keywords, then read the matched line; layers with <=12 entries stay inlined; the discipline block teaches that two-step path and routes cross-shard lookups (>=3 entries / >=2 shards / >=3k body) to a subagent that returns facts + line numbers instead of raw bodies. v0.9.0 adds the card-memory layer for roleplay sessions and makes every path Windows-safe: home resolution follows os.homedir() (so an undefined or empty HOME no longer roots paths at the drive root), tool and bash paths are normalized before guard matching, and drive-letter cwds produce valid project slugs. v0.9.2 fixes retrieval ranking at scale (IDF-weighted entry scores, df=0 CJK bigram fragments excluded from the coverage gate, BM25-style length normalization, preview windows anchored on the rarest matched token instead of a fixed 240-char head cut; measured locally: shards covered per top-8 2.88->5.75, largest tie block 4.38->1.13, previews containing a matched token 67%->100%): shard-level bonuses no longer inflate every entry in that shard (they were added inside the entry loop, so all hits from one shard shared an identical score and ordering collapsed to date-then-line), a per-shard quota stops one shard from filling the whole result page, and the default scope is the current project layer (other projects' shards — 60% of the pool locally — are skipped but reported in dropped.offScopeLayers/offScopeFiles, with scope:'all' to opt back in). v0.9.3 stops query function words from being searched at all (a CJK stopword set plus Latin stopwords, judged per-token so a real word that merely contains a stopword character stays searchable) and rejects sub-2-character queries, which previously collapsed into an unfiltered whole-library substring match: on the local corpus 'the/of/...'-style Chinese stopword-only queries went from 1270 hits to 0, and a single-character query from 1459 hits to a clean rejection, while the 15-query positive suite kept 14/15 recall with per-query hit counts unchanged (ranking, IDF, length normalization, per-shard quota and preview anchoring are untouched). v0.9.4 adds the mapless injection mode: the global shard map stops living in the system prompt entirely (locally measured: 188 shards = 40364 chars injected every turn) and is replaced by a fixed 370-char pointer, while shard-level routing moves into the memory_search reply as a query-scored top-8 bridge. Measured on 10 real tasks from this machine: entry-level retrieval alone finds the right shard in 6/10, the bridge in 10/10 (the 4 tasks entries miss, the bridge returns at rank #1) because a task phrased in Chinese colloquial prose cannot literally match an English shard name, and bridge scoring only needs topic-level overlap. Injection size becomes independent of memory growth and no longer invalidates the KV prefix when a memory is written. Bridge cost averages 1378 chars and only pays on turns that actually search. Also consolidates the inject-mode whitelist, which was the same ternary chain copy-pasted in three places (host 1 + client 2), into normalizeInjectMode()/INJECT_MODES plus a probe assertion that both tables agree, and keeps the per-shard over-limit warning in the bridge because the map that used to carry it is gone.
安裝
npx -p @deepseek-ai/dsh dsh plugin --profile web add @jipika/dsh-memory說明文件
閱讀完整 README ↗dsh-memory
Progressive long-term memory for DeepSeek Harness (DSH) — memory lives as sharded plain markdown, and only a live-generated map (shard · keywords · count · latest date) enters the system prompt, so the prompt cost stays flat however large the memory grows; entries are pulled on demand with
memory_search+read(greponly for exact regex). Two layers (global + per-project) plus the global rule files, viewable and editable right in DSH Settings, zero extra LLM cost, live re-read.给 DeepSeek Harness 的渐进式长期记忆:正文是分片的纯 markdown,进系统提示词的只有 实时生成的片级地图(片 · 关键词 · 条数 · 最新日期),条目先调
memory_search取线索再read取回(grep只留给精确正则) —— 记忆再长、提示词开销也恒定。两层结构 (全局层 + 项目层)外加全局规则文件,在设置里就能查看并编辑、不产生任何额外 LLM 调用、写完即生效。
拥有:
~/.dsh/memory/**的读写、每轮提示词注入与索引生成;tools/pre-execute/tools/post-execute上的记忆写入守卫与审计日志。 冲突时:与trinity-hooks(dsh-hooks-claude-code桥)同为tools/pre-execute监听者 —— 本插件只审记忆路径,两者互不翻案;与官方 compaction 无交集。 回滚:从dsh.profile.bundles去掉@jipika/dsh-memory+ 重启应用。
它解决什么
Agent 每次会话都是失忆的。让记忆活下来通常只有两条路:
| 做法 | 代价 |
|---|---|
| 把记忆塞进系统提示词 | 需要"谁来写、写到哪、怎么注入"的一整套机制 |
| 用 LLM 从会话里提炼事实 | 每轮会话都在后台烧钱,且内容进了别人的向量库 |
本插件的取舍是:记忆就是几个 markdown 文件,注入走 DSH 原生的提示词 seam,写入由当前会话的 agent 顺手完成 —— 于是它既不花钱,也不出本机,还能被 git 跟踪、被人手编辑。
特性
- 两层:
~/.dsh/memory/topics/*.md(全局,按主题分片:用户偏好 / 环境事实 / 通用坑……)- 按工作区分级的项目层,切换项目自动切换内容。
- 零 LLM 成本:插件本身不调用任何模型,只读文件;写记忆用的是会话已经在跑的那个模型。
- 写完即生效:注册的是函数式
text,每次提示词组装都重读文件 —— 不需要重启、不需要刷新。 (对比:cordis.patch.yml里personaPrefix的!!js只在 boot 求值一次。) - 渐进式注入,记忆再长也不炸上下文:默认地图模式 —— 提示词里只有片级地图
「片名 · 条数 · 体量 · 最新日期 · 关键词」,条目标题与正文都不进提示词;agent 先调
memory_search取线索,命中行自带行号,再按行read取那一条(无命中 / 精确正则才用grep)。条目 ≤ 12 条的层(典型是项目层单文件) 仍逐条内联 —— 这类层只有几百字符,内联出来比多跑一次检索更值。 - 注入头不放动态统计(KV cache 友好):每段的头行只写档位名(
… · 地图模式。), 片数 / 条数 / 字符数一律挪到该段最后一行(``)。 因为注入段位于 system prompt 很靠前的位置,而这三个数字每写一条记忆就会变 —— 放在头行会让 整个请求前缀失去 provider 的 KV cache(实测:写一条记忆后,同款子代理委派的首轮cacheRead从 85% 掉回 0%)。挪到段尾后,一次写入只让"被改的那一片之后"失效 (同条件实测公共前缀 0 → 3875 字符)。片级统计行本身仍是动态的 —— 那是路由信息,刻意保留。 实测:58k 字符的单文件拆成 10 片后,每轮注入从 29931 → 约 6.6k 字符; 35 片 / 333 条 / 233k 字符的真实库:地图模式 7.3k 字符,索引模式 12.9k 字符。 - 四档注入方式(设置 → 记忆 →「注入方式」):
- 地图模式(默认):只给片级地图,条目靠
memory_search+ 按行read按需取 —— 注入最省, 且路由线索(片名 + 关键词)一条不少:没有它,agent 不知道自己缺什么,也就不会去查。 代价是地图随片数线性增长(实测本机 188 片 = 38885 字符 / 每轮;即便只留最新 10% 的片 也仍要 4059 字符),片一多就是每轮的固定开销。 - 无地图(
mapless,v0.9.4):赌注换到「检索时现算线索」—— 全局层的常驻地图完全不进 提示词,只留一段固定 416 字符的指针块;片级线索改由memory_search按 query 现算, 落在返回的「相关记忆片」段(top8:片名 + 关键词 + 沾词 + 最新日期 + 超建议标记)。 实测本机 10 组真实任务(同一批对照):条目级检索 6/10 找对片,桥 10/10, 且条目漏掉的那 4 组桥全部在 #1 捞回。机制差别在命中门槛 —— 条目级要求正文字面命中, 片级只要求主题命中,所以中文口语的任务措辞(「外网连回」)对上英文专名片名 (dsh-remote-access)只有后者跨得过。 ⚠ 但这 10/10 是补过词之后的数:有一组任务的落点在那片正文里、而首行关键词没写 「重启 / 生效」,桥就到不了(桥只读片名 + 首行关键词)。所以本档把一条旧纪律抬成了硬要求 —— 首行 `` 里的关键词必须覆盖「用户会怎么问这件事」的中文口语说法, 只堆英文专名和文件名不够。地图模式下漏一个词只是少一行线索,本档下它等于那片不可路由。 收益:注入量与记忆规模无关(本机整段 40416 → 1976 字符,省 95%),也不再因写一条记忆 就作废 KV 前缀。代价:桥平均 1378 字符,只在真检索那一轮付,且多一次 round-trip。 v0.9.5:目录形态的项目层在本档也收起 —— 原先「它只有几十条、几 k 字符」的假设在 WallHaven 失效(114 条 / 37,441 字符,clamp 后仍 24,000 正文 + 4,000 溢出索引,比全局地图 还贵)。现在只留一行指针(路径 + 条数 +memory_search指引),摘要仍参与检索 (layerFiles收目录里全部.md,含MEMORY.md)。实测该项目整段 28,000 → 2,146 字符, 省 92%。单文件形态的项目层不受影响(≤ 12 条逐条内联、> 12 片级地图)。 ⚠ 本档的前提是「模型会主动搜」。现有证据只是间接的(map 档下、有搜索行为的会话 91% 在 turn 1 就搜),去掉地图后的触发率没有实测。所以默认档仍是map;切到mapless后 要自己回看(~/.dsh/sessions里数memory_search的tool/call事件)。 - 索引模式:地图 + 每片最新 N 条「标题 · 行号」,超「索引预算」(默认 12000 字符,面板可调
6K/12K/18K/24K/不限制)时沿
[8,5,3,2,1]逐档收缩为每片最新 N 条,每片都保留线索 (关键词 + 最新日期 + 「更早的 M 条在第 X–Y 行」),而不是把整层压成一行「N 条;索引预算已满」。 旧行为在 27 片规模下会让所有分片同时失去标题 —— agent 因此没有任何理由去read, 表现就是「插件明明在注入,却不读记忆」。 - 全文注入:分片正文整篇进提示词,总量超过字符上限时自动回退索引模式并说明原因 (分片规模下通常都会回退)。
- 地图模式(默认):只给片级地图,条目靠
- 跨片检索交给子代理,并优先用低成本的专用检索子代理:注入的纪律块写明分级 —— 1–2 条自己
read; 要同时读 ≥3 条 / 跨 ≥2 片 / 某片正文 ≥3k 字符时派检索子代理,只让它回「事实 + 文件与行号」, 原文留在子代理的上下文里。工具表里存在subagent_memory时优先用它 —— 那是给检索挂的专属委派工具 (固定低档思考强度、工具面白名单只留read/grep/glob),没有该工具时退回通用subagent。 - 片级关键词 = 最便宜的检索线索:分片首行注释 `` 里
·(或:) 之后那段会进地图/索引,对齐 Claude Skills 用description决定「要不要加载」的思路。 memory_search词法检索工具(v0.8):注册进 Agent 工具面 —— 中文自动 bigram 切分 (「插件开发」→ 插件/件开/开发)、token 覆盖度门槛(query 足够聚焦后才要求更广覆盖)、 相关度排序 + 日期并列。纯同步文件扫描(百片毫秒级),零依赖无索引;命中行号即纪律里的 L 号。 词法层思路移植自 dsh-mnemon(MIT)。- 检索排序修复(v0.9.1):记忆长到 150+ 片 / 3000+ 条后暴露出三个结构性缺陷,都已改:
① 片级加分不再抬条目分 —— 旧实现把片名 +12 / 关键词 +7 / 每 token 片名 +4 写在条目循环
内部,与条目内容无关,于是同一片所有命中条目分数完全相同,排序退化成「日期 → 行号」;
现在片级只作同分 tie-break(
SHARD_BONUS_PHRASE/SHARD_BONUS_KEYWORD),覆盖度门槛也只由 条目正文贡献(旧片段名里的 token 能单独满足门槛,架空条目级判定)。 ② 每片限额(PER_SHARD_MAX = 2)—— 旧slice(0, limit)让一片吃掉全部名额(实测 8/8 同片); 名额铺不满时放宽回填,所以dropped.capped/dropped.backfilled要一起看,只看 capped 会误判丢失量。 ③ 作用域收窄(scope,默认current)—— 旧实现扫projects/下全部 slug,其它项目的 记忆占池 60% 却不在地图里、模型无从路由,实测 top8 能被别的项目 8/8 占满。现在默认只检全局层 + 当前cwd所属项目层;cwd取不到(探针直调、无会话上下文)自动退回全库,scope:"all"显式跨项目。 少给的结果必须可见:跳过的层/片数进scanned与dropped,并由 render 文案写明出路。 - 检索打分修复(v0.9.2 · P1):片级偏置去掉后暴露出条目分只有「整数计数」的问题(同分块反而
从 4.38 涨到 5.13),四项改动一起把区分度找回来。实测本机 8 个 query(limit=8):覆盖片数
2.88 → 5.75、最大同分块 4.38 → 1.13、预览含命中词 67% → 100%、单次耗时 30ms → 19ms。
① IDF 加权 —— 条目分 =
Σ ln(1 + N/df(t)),稀有词命中比常见词命中更值钱(N=池内条目数)。 ② df=0 的碎片剔出门槛分母 —— 中文 bigram 的跨词碎片(「磁盘空间」→「盘空」)语料里不存在, 旧版把它计入 token 数会让门槛虚高、误毙只命中 1 个真词的条目。lexicalRequiredMatchCount本体不改(既有单测仍成立),只改它的输入;query 全是碎片时门槛显式取 1。 ③ 长度归一score / (1 + SEARCH_LENGTH_B·(len/avgLen − 1))—— 命中数是「免费的」, 条目越长分数越高(实测一条 808 字符的诊断条目几乎霸榜所有 query)。b=0.5 实测最优。 ④ 锚点预览窗口 —— 旧版一律从条目开头截 240 字符,实测 48% 的预览一个命中词都没有 (90% 条目超 240 字符),模型看不出「这条为什么命中」只能整片 read。现在以命中的最稀有 token 为锚点取 ±80 窗口,窗口不在开头时用…标记;锚点在原文 indexOf 失配则降级到次稀有者。 打分改为两遍扫描(pass1 统计 df/avgLen,pass2 打分),池内驻留约 1.4MB 瞬态文本,无缓存层。 已知边界:严格门槛下不做渐进松弛兜底(本机 8 query 实测空手数为 0,未触发就不加复杂度)。 - 回合记忆栏(v0.8):每条 AI 回复底部出现「本回合记忆 · 读取 N · 写入 M」折叠条
(挂 DSH 公开的
conversation.chat.turnTail插槽),展开列出这一轮实际读取/写入了哪些 记忆文件,点击用 DSH 自带预览直达原文。数据来自 session 持久日志的增量投影 —— 不挂 事件监听,对插件激活前就存在的会话同样生效;每会话环形保留最近 50 回合。设置 → 记忆 里可关(关掉不渲染,数据照记)。 - 设置面板可读可写:DSH 设置里多一个「记忆」分栏 —— 每层一个开关,点标题即可展开正文,
还能就地把改动保存回文件(保存前自动留一份
.bak)。全局层按片一个页签;同一个分栏里 可以查看并编辑全局规则文件~/.dsh/AGENTS.md。 - 明文、可移植:就是 markdown。可以 git、可以 diff、可以手改;删掉文件即停用(段渲染为空串,
被
renderPrompt()过滤,零残留)。
增强检索与受控自动召回
保留两层 Markdown、同一个 memory_search 和原生工具/消息钩子;不做向量检索、不调用额外模型、不迁移或复制记忆库。
- 实体优先:工具名、文件名、错误码、带数字的型号和下划线/连字符/驼峰标识符不能被“配置/修改”等泛词替代。实体缺失时明确返回
anchor-missing,不返回无关事实;foo_bar_v2不是foo_bar。常见read-only等修饰语不当作强实体。最多 32 个实体、8192 字符,超过会明确拒绝而非静默丢词。 - 多路词法线索:保留原始词与中文双字兜底,补标识符变体、有限的通用中英术语/口语别名,以及条目所在章节。主题上下文只在有正文证据时补排序,不凭片名把无关正文变成事实。同片继承主题需要额外正文意图词,并且不会自动视为精确实体命中。
- 声明名称的简称:只从分片文件名/名称派生至少两段的完整后缀,例如
remote-access对应dsh-remote-access、effort-slider对应dsh-codex-effort-slider。不扫描普通正文登记简称,不丢弃版本尾缀,foo_bar仍不能匹配foo_bar_v2;多个声明名称同时符合时保留歧义。路由会注明简称对应的完整名称,不能把推断的简称当成正文精确实体。 - 自动事实认证:不再用“两个稀有双字词 + DSH 片名”认定高置信。精确实体必须在正文中出现,并有非实体的正文意图词;自然问法需要至少两份同时出现在主题上下文和正文中的独立证据。重叠中文双字片段合并计数,同一组中英别名只算一份;查询明确提出的去重、调用、加载等意图也必须有正文支持。名称简称未被本片明确声明时不自动当事实注入。结果的
recall字段给出认证结果与原因;这仍是保守的词法规则,不是语义概率。 - 原文证据:不超过 480 字符的条目完整返回;长条目返回命中位置附近的原文片段,附实际行区间和截断标记。归一化匹配映回原始字符位置,兼容全角标识符。分片桥明确标作路由,不代表已阅读或已获取事实。
- 当前项目:注入、工具和自动召回统一读取宿主
workingDirectory当前投影。旧宿主无该服务才回落初始目录;已有 Agent 但目录服务失败时,默认current不扩大为all。显式scope:"all"仍可跨项目。 - 每轮一次的候选预检:直接用户的新任务到来时,在
agent/pre-step做一次本地检索;只把最多 2 条可靠候选加入本轮动态消息,总预算 1800 字符。弱匹配不自动塞事实,明确回忆历史时才可给少量分片线索。候选是待核对的数据,不是新系统指令;不改系统提示词缓存前缀。 - 边界:问候/确认/纯算术、工具续步、子代理、角色卡、全文已注入、关闭层、取消或下游已删除的用户消息不触发额外注入。读取失败放行原有流程;不保存查询或正文缓存、不产生后台模型请求。注入的候选仍计入当前轮模型上下文 token,不能把“无额外模型请求”理解成零 token 成本。
设置仍在 ~/.dsh/memory/settings.json,两项默认值如下;面板修改其它选项不会清掉它们:
{
"searchMode": "enhanced",
"autoRecall": true
}
autoRecall:false 仅关闭自动候选,手动增强检索仍在;searchMode:"legacy" 恢复旧排序/返回格式并同时停止自动预检,作为单开关回退。目录服务修复不回退。运行中是否载入新代码,以插件 GET /dsh-memory/settings 是否返回这两项为准,刷新网页本身不保证 host 代码重载。
验证
node tests/probe.mjs
node tests/retrieval-v2.mjs
node tests/recall-policy.mjs
node tests/live-retrieval-eval.mjs --check
node tests/live-recall-quality.mjs --check
前三套是隔离 HOME 的功能回归,不触及真实记忆。后两套直接读取本机原始记忆,没有脱敏库或语料副本,不联网、不调用模型;运行前后校验原库摘要。live-retrieval-eval 冻结查询/目标条目标签,分别比较精确事实 Hit@8、MRR@8、分片路由与不存在实体负例,不把找到片名冒充找到事实;默认基线是 .rollback/retrieval-20261103-1808/index.js,支持 --baseline PATH --current PATH。live-recall-quality 固定上一轮13条自然问法、两个简称、三个未知实体,逐块核对自动候选的实际条目,能检出“带回目标同时混入无关内容”;既要求去除误召回,也保留两个正确自动正例,不能靠关闭自动召回过关。该修复对照源码默认位于 /tmp/dsh-memory-fix-before-20261104.mjs,支持 --before PATH --current PATH;快照或原始目标缺失时明确失败,不伪造基线。
本机题库的标签只适用于已核验的真实条目,不随包分发原始记忆;在其它机器缺少对应条目时明确失败,不伪造通过。大部分正例是明确原话/带上下文的标识符,不能把其命中率当作开放式语义检索或模型端到端使用率。
安装
从 npm(推荐)
已发布为 @jipika/dsh-memory,也收录在 DSH 1024Store 目录里:
dsh plugin --profile web add @jipika/dsh-memory
本插件自带 cordis.patch.yml(package.json 里声明了 dsh.bundle.patch),安装时 DSH 会自动把它
挂进 profile 的组合树,不需要手工编辑任何 profile 文件。
从源码(想改代码时)
git clone https://github.com/jipika/dsh-memory.git ~/.dsh/local-plugins/dsh-memory
然后以 link: 方式挂进 profile(以 desktop 为例):
# 1) 依赖(~/.dsh/profiles/desktop/package.json)
# "@jipika/dsh-memory": "link:../../local-plugins/dsh-memory"
# 2) 挂载(~/.dsh/profiles/desktop/cordis.patch.yml 末尾追加)
# - insert:
# - id: dsh-memory
# name: '@jipika/dsh-memory'
cd ~/.dsh/profiles/desktop && pnpm install
装完后若是
link:方式,pnpm install会重建 node_modules 链接并把 HMR 的基线路径换掉 —— 建议 重启一次 DSH(host 半在 boot 时加载)。之后改记忆、翻开关都不再需要重启。
记忆文件布局
~/.dsh/memory/topics/ ← 全局层:按主题分片(**新记忆写这里**)
├── preferences.md ← 用户偏好
├── dsh-platform.md ← 环境 / 平台事实
└── … ← 想加几片就加几片,索引自动收录
~/.dsh/memory.md ← 导航索引(人读用;注入不读它)
~/.dsh/AGENTS.md ← 全局规则(新会话注入,面板里也能编辑)
~/.dsh/memory/projects/
├── --Users-me-code-repo--/ ← 项目层:目录形式
│ ├── MEMORY.md ← 索引(同样只注入索引 + 行号)
│ ├── some-topic.md ← 主题正文,按需读
│ └── another-topic.md
└── --Users-me-other-repo--.md ← 项目层:单文件形式(同样支持)
两种形态都支持:有分片目录就按分片走,没有就回落到单文件 —— 所以从单文件迁移到分片 (或反过来)都不需要改配置。分片的片名优先取文件里的 H1 标题。
项目层两种形态的注入方式刻意不同(这点踩过坑):单文件形式的内容本身就是条目集合 (
- [日期] 事实),所以走索引化、只给标题与行号;目录形式里MEMORY.md已经是人写的 索引、其余.md是带 frontmatter 的正文段落,所以直接注入MEMORY.md正文(标题 + 链接 + 摘要,超长时仍走 clamp),另外只列出没被索引登记的正文文件 —— 顺带当索引一致性检查用。 反过来对正文再套一遍条目索引,只会退化成一张纯路径清单(实测某项目 74 篇正文被压成 14340 字符的文件列表,而MEMORY.md的摘要一条都没进来)。
从单文件迁移过来:
tools/migrate-to-shards.mjs是当时用的迁移脚本(人工语义分类 + 生成 导航文件 + 先备份),可以按自己的分类改写它。
项目层目录名由会话的 cwd 推出,规则与 DSH 自己的会话目录一致——路径里的 / 换成 -,
两端各加 --:
/Users/me/code/repo → --Users-me-code-repo--
所以 ~/.dsh/sessions/--Users-me-code-repo--/ 与 ~/.dsh/memory/projects/--Users-me-code-repo--/
是同一个项目的两份数据,一眼能对上。
记忆怎么写
由 agent 顺手写(这也是"零 LLM 成本"的来源:写入搭的是本来就跑着的会话)。建议在
~/.dsh/AGENTS.md 里放几条纪律,例如:
Memory upkeep (long-term memory):
- TWO layers, both injected on every assembly (no restart needed):
· GLOBAL `~/.dsh/memory/topics/*.md` — facts that would bite in ANY repo,
sharded by topic (each file starts with a comment saying what belongs there).
`~/.dsh/memory.md` is only a navigation index — never append memory to it.
· PROJECT `~/.dsh/memory/projects/----.md` — facts
that only hold in this workspace.
- What the prompt shows is an INDEX (shard · count · path), not the full text:
read that shard when you need the detail. Index lines carry line numbers.
- Append one line `- [YYYY-MM-DD] fact` under the matching section, in the SAME
turn you learn it. Do not batch for "later". Keep each shard small (~12k chars)
— when one outgrows that, split it by sub-topic in the same directory.
- Do NOT log narration or anything re-derivable from the repo.
- NEVER put secrets in it — both layers ride every request to the model provider.
- Record what IS true, never a removal: "X was uninstalled" is stale the moment
it is written and taxes every future session.
设置面板
设置里会出现一个「记忆」分栏,三组内容:
| 分组 | 条目 | 可编辑的文件 |
|---|---|---|
| 全局规则文件 | AGENTS.md(无开关) | ~/.dsh/AGENTS.md |
| 全局层(跨项目) | 全局记忆(带开关) | ~/.dsh/memory/topics/*.md(一片一个页签) |
| 项目层(按工作区) | 每个项目一行(带开关) | 该项目目录下的全部 .md(MEMORY.md + 主题文件) |
- 点任意一行展开:先看到只读正文,点「编辑」变成可写的编辑器,
⌘/Ctrl + S或「保存」写回文件。 - 一层里有多个文件时(项目记忆的主题文件),用页签切换;未保存的页签带
●。 - 保存是原子写(先写临时文件再 rename),改动前的内容自动留一份
.bak; 新建的文件用0600,已有文件沿用原权限。 AGENTS.md的生效时机(面板底部也写了):它在每个新会话开头注入,改完对新会话生效。- 记忆两层是每次提示词组装时实时重读的:保存后下一条消息就带上新内容,不需要重启。
- 关掉的那一层不再注入;再次开启立即重新读取文件。
- 开关存在
~/.dsh/memory/settings.json(与记忆正文同根,面板改、手改文件都即刻生效):
{
"globalEnabled": true,
"projectEnabled": { "--Users-me-code-repo--": false },
"injectMode": "map",
"indexBudget": 12000,
"maxChars": 24000
}
injectMode:map(默认,片级地图 +memory_search按需取条目)/mapless(常驻地图与 目录形态项目层的MEMORY.md索引都不注入,片级线索改由memory_search返回的「相关记忆片」 桥现算,见上)/index(地图 + 逐条标题)/full(正文整篇注入)。indexBudget:索引模式每轮注入的字符预算(0 = 不限制 → 始终全量逐条)。 超预算时按[8,5,3,2,1]逐档收缩为「每片最新 N 条」,不会整层归零。maxChars:正文上限,管两件事 —— full 模式的分片总量闸门、项目层MEMORY.md的 clamp。
钩子(v0.5.0)
「该不该写记忆 / 有没有好好读记忆」不再只靠提示词劝 —— 钩子直接挂在 DSH 原生工具管线
(tools/pre-execute / tools/post-execute,与官方 dsh-hooks-claude-code 桥同一批事件)上,
在动作发生时硬性判定:
写入钩子(write-guard,tools/pre-execute)
agent 用 write / edit 触碰记忆管辖路径(~/.dsh/memory/**、~/.dsh/memory.md、~/.dsh/AGENTS.md)时,
先跑内置规则引擎,deny 的原因会成为这次工具调用的 Error 结果、直接回到模型面前:
| 规则 | 判定 |
|---|---|
碰插件内部资产(.bak / audit.log / 记忆目录里的非 md) | deny |
往 memory.md(现役纯导航索引)写正文条目 | deny + 指路 topics/ |
新条目格式不是 - [YYYY-MM-DD] 事实(或日期非法/在未来) | deny + 给出正确格式 |
| 新增内容疑似凭据(sk- / AKIA / ghp_ / Bearer / password= 等 8 类) | deny(只报行号与模式名,不回显值) |
write 整文件覆写导致既有条目变少 | deny + 要求改追加/edit |
bash 重定向/tee/sed -i 改记忆文件 | ask(转人工确认);只认真正落盘的目标 —— 2>/dev/null、>&2 这类 fd 复制与丢向 /dev/null 不算,只读命令不会被误拦 |
| 过时陈述(「已卸载/不再使用」式)、单条超长 | allow + 审计 note |
writeGuard: "full" 时在内置规则之上再跑一个外部判定命令(writeHookCommand):
stdin 收到完整 payload JSON(tool/path/layer/oldText/newText/added/removed…),
exit 2 = 拒绝(stderr 为原因)、exit 0 + stdout JSON {decision, reason} 出决策
(兼容 hookSpecificOutput.permissionDecision)—— 所以**「这条值不值得记」的语义判断可以接任意 LLM 脚本**,
不再受提示词约束力上限的限制。决策合并取最严(deny > ask > allow),钩子故障放行不误伤。
审计与读取钩子(tools/post-execute)
- 写入审计:每次记忆写入落盘后追加一行 JSONL 到
~/.dsh/memory/audit.log(时间/工具/路径/增删行数/判定),超 2MB 自动轮转.1;落盘内容再校验一遍, 条目格式有问题时附加提醒让模型立即自修。 - 读取提醒:
read命中记忆文件时附加一条上下文:条目数/字符数、按行号引用、 禁止凭索引臆测、发现过时就地修正。
注入层约束(读取侧)
- 记忆纪律块:注入正文末尾强制附加一段「纪律」(值不值得记才写、格式、钩子会拒绝什么、按行号读)—— 提示词约束还在,但背后有钩子兜底。
- 注入过滤命令(可选,
injectHookCommand):组装好的注入文本过一遍外部命令 (stdin 进、stdout 出,失败/空输出回落原文),可做脱敏或按需裁剪。
开关
设置 → 记忆 → 「写入 / 读取钩子」区块(或手改 ~/.dsh/memory/settings.json):
{
"writeGuard": "rules", // rules(默认,内置规则)| full(规则+外部命令)| off
"writeHookCommand": "",