dsh-engramory-recall 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 本项目的所有重要变更都记在这里。格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.5.2] — 2026-10-15
+
+### 文档
+
+- README 加一节「不用信这段话，两分钟自己验一遍」：把写入闸门的四条实地探针（索引超限、库外同名文件、文件名不合规、含凭据）连预期原话和实测结论一起写进去。唯一卖点值得一个能当场复现的验法。
+
 ## [0.5.1] — 2026-10-15
 
 ### 修复

package/README.md

@@ -245,6 +245,21 @@
 **边界**：`guard` 只拦 `write` / `edit` 工具调用，`bash` 重定向它看不见。它是正路守卫，
 不是沙箱；兜底靠体检器定时扫（真实抓到过两篇绕过闸门的裸 markdown）。
 
+#### 不用信这段话，两分钟自己验一遍
+
+闸门跑在宿主进程里，验法就是在你的 agent 会话里让它做下面四件事 —— 全部走普通的 `write` / `edit` 工具，不需要装任何东西：
+
+| 让它做 | 你会看到 |
+|---|---|
+| 往 `MEMORY.md` 追加 130 行（凑到 203 行） | 拒绝：**「这次写入会把索引 MEMORY.md 顶过上限（203 行 > 200）」** |
+| 在记忆库外（比如项目目录里）写一份同名、同样 203 行的 `MEMORY.md` | 放行（闸门只认配置的那一个库） |
+| 往库里写 `bad-name.md` | 拒绝：**「文件名不合规。必须是 \<user\|feedback\|project\|reference\>-\<小写slug\>.md」** |
+| 写一篇带 `api_key: sk-…` 的笔记 | 拒绝：**「疑似含真实凭据（OpenAI 风格密钥）」** |
+
+作者实测（0.5.1 / 2026-10-15 / 库 63 篇、索引 73 行）：四条全中，两次被拒的写入**磁盘上零字节变化** —— 被拒后索引与操作前逐字一致。
+
+这就是它跟别家最本质的一处不同：别人的记忆预算卡在**注入**上（超了就少喂几段给模型），这里卡在**写入**上 —— 索引文件本身长不到超限，所以「超限的部分静默不再被召回」在这个库里不会发生。
+
 ### 体检器（`doctor.js`）
 
 纯静态、只报告不动手。12 项检查：库不可读、索引指向不存在的文件、孤儿笔记、索引重复、

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-engramory-recall",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Local BM25 auto-recall, fail-closed write guard, static doctor and a memory panel for the Engramory markdown store — no network, no model, no daemon.",
   "keywords": [
     "dsh",