dsh-engram
在终端中运行以下命令:
dsh plugin install skepsun/dsh-engram
将以下提示词粘贴到 DeepSeek Harness 对话框中:
从 https://github.com/skepsun/dsh-engram 克隆或安装 dsh-engram 插件后,执行 dsh plugin install skepsun/dsh-engram 命令,再重启 dsh web 即可在原生设置面板中看到注入的 [ENGRAM]/[ESR] 记忆索引与 ESR 看板。
插件介绍
长期记忆插件在 DeepSeek Harness 生态里有一个共同盲区:写入路径上挂一个 LLM 做摘要,召回时又把原始文本整段塞进上下文,每个会话都为蒸馏和膨胀买单。dsh-engram 走的是相反的路线——intake 层用纯模式匹配捕获有意义的信号(带 commit message 的 git 里程碑、关键文件编辑、重复报错、失败测试),热路径上零模型调用,纯管道操作(静默 commit、git push)则被刻意排除。写入磁盘之前,一个确定性的 secret redactor 先剥掉 API key、JWT、Bearer token 和各类云厂商凭据,敏感文本不可能落盘。
召回遵循"检索不等于注入"原则。提示词组装阶段注入一个紧凑的 [ENGRAM] 符号索引(默认 700 字符、约 175 token、每条记忆一行),并在整个会话内冻结,保持请求前缀字节稳定以复用 KV-cache。真正需要细节时,agent 调用 engram_recall 或 engram_detail,由进程内 BM25(TF·IDF、标签加权、轻度时间衰减)对候选池排序,附带实体邻域表;近似的重复报错会被 revival 机制合并而非堆叠;零命中时回落到 DSH 自带的跨会话全文索引,再兜底为对近期日志的有界子串扫描。记忆之间还支持 supersedes / contradicts 语义——被替代的旧行被降权并移出索引块,但永不硬删除。失败→修复闭环观察同一命令签名:当它终于跑通,旧报错自动标记 resolved,召回呈现的是修复而非陈旧故障。
任务侧,ESR 协议赋予每项工作 draft → active → stable 生命周期,stable 必须携带真实证据(artifact、evaluation 或 memory reference),非 URL artifact 还须在工作区磁盘上实际存在才能过闸。任务挂载在实体节点上,依赖边作为一等公民写入关系图谱;全屏看板与力导向图视图嵌入 DSH 原生设置面板。会话结束时若仍有未闭环 todo,自动沉为 ESR draft 而非凭空消失。上下文 GC 则用机械驱逐加再取指针取代 DSH 有损的 LLM 摘要压缩:被驱逐的回合若含 engram/ESR 锚点,仅替换为一行指向 engram_detail 或 [ESR] 块的指针;无锚点的回合才走有界叙述。适合谁?跑长会话、多工具调用、对 token 账单敏感、希望记忆安静地待命而非主动灌入上下文、并且坚持"没有证据就不能宣布完成"的开发者。
使用场景
- 长会话中反复出现的报错被自动捕获,修复成功后旧故障标记 resolved 不再污染召回
- 跨会话的工作决策、commit 里程碑和文件编辑被有界索引保留,新会话按需召回而非整段注入
- 上下文 GC 驱逐多余回合时,含记忆锚点的行替换为一行再取指针,避免 LLM 摘要丢信息
适合人员
- 跑多工具长会话、对 token 账单敏感的开发者
- 希望记忆静默待命、召回时才进入上下文的精细控制者
- 坚持任务必须有证据才能宣告完成、不接受口头闭环的工程实践者