Overview
dsh-memory-refine
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
- **命令通道是兜底,不是主路。** 面板默认走插件自己的本地 HTTP 路由(`POST /memory-refine/ui`),**不经过命令总线**,所以正常使用时对话视图里不会出现 `memory-refine · {...}` 记录。只有在路由不可用时才回退到 `/memory-refine` 斜杠命令,留下一对 `command/run` / `command/done` —— 这时面板顶部会挂一条红色警告,告诉你发生了降级。这组事件**不进模型历史、不烧 token、不污染取料素材**。 - 面板在「一个会话都没打开过」时无法确定会话 id,会提示先打开一个会话。 - **`memory_history` 的耗时只有一次实测,不是基准。** 本机冷扫 29 场 / 2967 条索引 / 2557ms(2026-10-27,一次观测)。分词 + 倒排 + 打分在 62 万字规模是 0.1 秒量级(CPU 侧微基准),瓶颈在 `readSurface` 背后的全量读盘 + 回放校验,而那条路径在插件进程外没有入口、测不了。所以工具描述里不承诺任何耗时,返回里的 `elapsed_ms` 才是每次自己的实测值;同一份 README 也不写「1 秒内」这种话。 - **`memory_history` 看不到被压缩掉的历史。** 这是设计如此,不是缺陷:它只读当前表层。要旧原文得走宿主的 `readEvent`。也因此它说「没搜到」比记忆文件说「没记过」更弱 —— 别把它的沉默当成「没聊过」。 - **注入事件在两条路上都会被检查,但计数没去重。** `user/message` 与 `agent/inbox/spliced` 的 `inserted[]` 各查一次。2026-10-27 实测 497/497 条 `inserted` 都带 source、且没有注入 kind,所以统计是对的;**若宿主将来把注入事件放进 `inserted`,会出现重复计数**。 - **`goal` / `tool-goal` 进不进,取决于用途。** 取素材时保留(要知道这场在忙什么),查原话时排除(那是宿主替用户写的,不是用户的话)。所以对同一段会话,两个工具看到的"用户消息"条数本来就可以不同,这不是计数错。整条保留意味着素材里会出现宿主口吻的段落,是已知代价。 - **陌生来源只留痕,不拦。** 名单外的 `kind` 一律放行,名字记进统计的 `unknownKinds`。宿主将来新增注入类时,第一次会漏进来——那行统计是唯一的预警,看到陌生名字就把它加进名单。 - 只在 **Windows** 上验证过。
