概览
dsh-memory-core
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **召回是词面匹配**,不是语义检索;改写幅度大的查询会漏。 - **语料主题高度单一时召回会失灵**:某个 2-gram 在几乎所有条目里都出现时 idf 趋近 0,总分被 `minScore` 地板拦掉。主题分散的档案不受影响。 - **150ms 是目标预算,不是硬实时保证**:`recall(cfg, query, deadline)` 把 deadline 贯穿冷启动加载、索引构建和候选扫描;循环每 64 步检查一次,超时就熔断返回已算出的部分结果,并废弃没建完的索引缓存。它**不能**抢占正在执行的一次同步 `readFileSync`——Node.js 单线程上,同步 I/O 一旦开始就没法从外部打断。所以准确的说法是「计算阶段协作式检查 + 主动熔断」,不是「整条链严格不超过 150ms」。真遇到超大单文件或慢磁盘,单次同步读取本身就可能吃掉整个预算。整条链路是同步内联检查,用 `Promise.race` 包裹是伪超时、救不回时间。 - **导航与摘要都是规则抽取**:主题取标题、摘要取首句,不保证语义完整;后台总结只处理对话文件,且必须在空闲窗口里才跑。 - **固化目前是规则抽取**(`fact` 取小节标题)。`status` / `supersedes` 已经真正参与召回——`active` 以外的记录不进候选池,且 `supersedes` 关系优先于状态字段。但**系统不会自己判断两条记忆是否冲突**:新决策落盘后,仍要手动把旧记录标成 `superseded`,或在它上面填 `supersedes`。LLM 事实提取与自动冲突识别没做。 - **`source_id` 是 `dialogue:行号`**,对话记录被编辑后行号会整体漂移。状态表因此同时按**内容签名**(完整内容的 sha1 前缀,没有截断)对齐,行号对不上时按签名兜底。改内容(不只是挪位置)会让签名也变,那条记忆回到未标记状态——这是有意的:内容变了就是另一条记忆。 - **档案超过 200 KB 时**要考虑上真正的索引(当前靠 mtime 缓存撑)。 - **脱敏是模式匹配**,只覆盖常见凭证形态,不认识的密钥格式仍可能漏过。 - 召回内容一律按不可信数据处理;但模型仍可能被其中的话术影响,这是概率问题,不是开关问题。
