dsh-engramory-recall 0.12.3 → 0.12.4

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 本项目的所有重要变更都记在这里。格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.12.4] — 2026-10-15
+
+### 修复
+
+- **`npm run bench:embed -- --real` 之前根本跑不起来**：生成的一次性提供方模块用了默认导入，
+  而参考提供方只有命名导出 ⇒ 每条查询都记成 `load-error`，质量列直接掉到 0。改成 namespace 导入。
+  （用本机假 embeddings 服务把 `--real` 那条完整路径跑通了才发现 —— 也就是说，**这条文档里写着的
+  一条命令，之前只有真去接端点的人才会撞上**。）
+
+### 新增
+
+- `bench:embed` 支持 `--timeout <ms>`（默认 20000）：给端点的预算，**超时降级为词面结果而不是报错**。
+  实测：服务端每次慢 1.5 秒 + 预算 800 ms ⇒ 每次检索 p50 = 805 ms（预算被当真），
+  全列 `timeout×20`、质量退回词面基线。
+
 ## [0.12.3] — 2026-10-15
 
 ### 新增

package/README.md

@@ -758,6 +758,10 @@ export ENGRAMORY_EMBED_MODEL=text-embedding-3-small
 真库那半边要显式加 `--store ~/memory/engramory` —— 加了就意味着**你的笔记片段会发给那个端点**，
 所以默认不开。
 
+`--timeout <ms>`（默认 20000）是给这条端点的预算：**超时即降级为词面结果**，不是报错。
+拿本机慢服务自证过：服务端故意每次慢 1.5 秒、预算给 800 ms ⇒ 每次检索 p50 卡在 805 ms
+（预算被当真了），结果全列 `超时/失败 = 20（timeout×20）`，质量列退回词面基线 —— 端点在抖也不会拖死检索。
+
 假向量（哈希向量 = 最坏提供方）跑出来的两组数字，正好把上面那张融合表变成实测：
 
 | 卷子 | 词面 hit@1 / hit@4 | 假向量 + `trust` | 假向量 + `rrf` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-engramory-recall",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "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",