Overview
dsh-memory-core
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- **召回是词面匹配**,不是语义检索;改写幅度大的查询会漏。 - **语料主题高度单一时召回会失灵**:某个 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 缓存撑)。 - **脱敏是模式匹配**,只覆盖常见凭证形态,不认识的密钥格式仍可能漏过。 - 召回内容一律按不可信数据处理;但模型仍可能被其中的话术影响,这是概率问题,不是开关问题。
