dsh-agent-memory

Name: dsh-agent-memory
Availability: InStock
Author: TindalosKorone

DSH 跨会话长期记忆插件：零运行时依赖、输出可自算自证、请求级隔离（CC BY-NC-SA 4.0）

Introduction

给 DSH Agent 用的跨会话长期记忆：四个工具（memory_remember / memory_recall / memory_expand / memory_prune）把值得留下的结论写进一份人类可读的 NDJSON 文件，下次会话按需召回。

注意：没有「按话题自动召回」。 自动进上下文的只有一行索引（条数 + 条件规则 + 标签锚点）和一条稳定规则；记忆正文不会自动注入，要内容必须由模型显式调用 memory_recall（再按 id 调 memory_expand 取正文）。那条规则是提示，不是保证。

按 1 → 2 → 3 走：clone 到本地 → 构建产物 → 用命令装进 profile。

克隆到本地

git clone https://github.com/TindalosKorone/dsh-agent-memory.git
cd dsh-agent-memory

构建产物

pnpm install        # 取 TypeScript 等 devDependencies（本包运行时零依赖）
pnpm run build      # 等价 node node_modules/typescript/bin/tsc -p .

lib/ 是 tsc 产物且已随包入库；只安装、不改源码时，这一步可跳过。

安装进 profile
```
dsh plugin --profile <profile> add /绝对路径/dsh-agent-memory
```
把 <profile> 换成目标 profile（如 web）。装完重启 DSH —— 插件在 boot 时载入，不重启不会出现。

只想用、不打算改代码的话，也可以跳过 clone 直接一行装远端：dsh plugin --profile <profile> add github:TindalosKorone/dsh-agent-memory。

或者，让你的 agent 按 docs/install.md 安装 —— 那份文档写全了三种方式、profile 侧软链、路径与验证步骤。

memory_remember：写一条。kind 四选一（fact / lesson / preference / pointer），title 单行 8..120 字符，tags 1..12 个，source 非空；scope 可选（建议 project:<名>，省略 = global，非空单行 <= 64 字符）。
memory_recall：按查询召回索引，每条一行 10 列 id | kind | title | tags | graph | via | rel | cov | match | score。 limit 默认 5、最大 50，且是硬显示上限；scope 可选：不传 = 不过滤（与过去完全一致），传了 = 只返回该 scope 或 global 的记录（global 永远包含），表头回显 ;scope=<值>，结构化 rows 另带 scope 字段（打印行仍是 10 列）。 match 由 rel、两个阈值与内容量闸门共同判定（复算口径见契约 §5）；多样性启用时 score 不能仅由 rel/graph 复算。库规模离标定点过远时表头会提示重标，实际重跑用 pnpm run calibrate -- --write。
memory_expand：拿 recall 回的 id 取正文（L2）。
memory_prune：同 kind 同标题合并（留最新、累加 hits），再按 pruneScore = decay(ts)*(1+hits) 从低到高淘汰；dryRun: false 才真删。

完整列语义、打分常数、写入协议与闸门见 docs/recall-contract.md。

装完工具不出现、插件卡在 PENDING、lib/ 没构建、注入行为不变、库在哪与怎么备份 —— 这些排查步骤已移到 docs/troubleshooting.md。

本插件参考了 lioensky/VCPToolBox 的记忆系统设计（该项目同样采用 CC BY-NC-SA 4.0）。