@heixui/dsh-session-suite 0.3.4 → 0.4.1

package/README.md

@@ -345,6 +345,45 @@ anything, and it never deletes real content.
 as symptom → root cause → fix. Read it before changing the snapshot, compaction,
 memory, or export paths.
 
+`docs/memory-architecture.md` maps the memory engine against the standard
+two-layer agent-memory design, with measured numbers rather than claims — including
+the parts that are deliberately not built and why.
+
+## What changed in 0.4.1
+
+A sidebar entry, plus three fixes for things that looked functional but were not.
+
+| Area | Before | Now |
+|---|---|---|
+| Where to find it | Settings → Snapshots / Long-term memory, three steps away | A **sidebar entry** opens everything in place; the three duplicate Settings sections are removed |
+| Memory count | Panel said 17, Settings said 51 — one question, two answers | The panel walks **every registered workspace**; each figure states what it counts |
+| Archive restore | Clicked, nothing happened, the mark on disk never changed | Fixed an argument-shape mismatch between the two Host services; restore now takes effect |
+| Long lists | The panel clipped its content; the wheel did nothing | The panel scrolls |
+
+**Why the counts disagreed (the real 0.4.0 defect):** long-term memory has a *global*
+store plus one store per workspace. `longterm.list` without a `cwd` returns only the
+global store (17 rows); with a `cwd` it returns global plus that workspace. The panel
+has no workspace of its own, so it showed the 17. It now enumerates every registered
+workspace instead.
+
+## What changed in 0.4.0
+
+The memory engine was reorganised; the session features are unchanged.
+
+| Area | Before | Now |
+|---|---|---|
+| Duplicate memories | One topic occupied 7 of 46 entries | Maintenance is idempotent (verified across 6 passes); existing duplicates merged into cold storage |
+| Resident layer | 2 flat entries mixed into the "relevant" block | Up to 5 topic cards, in their own labelled section |
+| Episodic memory | Absent | `kind: 'episode'` with time, context, and outcome; decays twice as fast |
+| Dense reranking | Implemented but off, weight unverified | **Optional, off by default**, weight calibrated by measurement (MRR 0.535 → 0.760 on 8 paraphrased queries, recall unchanged) |
+| Privacy | Scope only | `public` / `internal` / `secret`; credentials auto-detected; `secret` never injected or exported |
+| Implicit queue | Keyword gate dropped 7 of 10 valid candidates | Gate removed; an empty queue now states why it is empty |
+
+**Embedding is optional and adds no download by default.** Lexical retrieval alone is
+the default behaviour; installing a model adds cross-lingual and paraphrase recall.
+See `docs/memory-architecture.md` for the measured effect and
+`tools/download-embedding.mjs` for the deliberate, explicit install path.
+
 ## Limits
 
 * Rewinding does not rewrite the durable log; it forks at the target message and archives the old session. That

package/README.zh.md

@@ -157,13 +157,49 @@ tools/              自测脚本与预清理脚本（不随插件打包）
 docs/               需求与 API 笔记
 ```
 
+## 0.4.0 改了什么
+
+本次重构的是记忆引擎，会话相关功能未变。
+
+| 方面 | 改前 | 改后 |
+|---|---|---|
+| 重复记忆 | 46 条里同一主题占 7 条 | 维护幂等（连续 6 轮验证）；存量重复已合并进冷库 |
+| 常驻层 | 2 条扁平记忆，混在「相关」区块里 | 最多 5 张主题卡片，独立分区标注 |
+| 情景记忆 | 没有 | `kind: 'episode'`，带发生时间、情境、结果；衰减加倍 |
+| dense 重排 | 实现了但默认关，权重未验证 | **可选，默认关**；权重经实测校准（8 条改写查询 MRR 0.535→0.760，recall 不变） |
+| 隐私分级 | 只有 scope | `public`/`internal`/`secret`；凭据自动识别；secret 永不注入、永不导出 |
+| 隐式队列 | 关键词闸门误杀 7/10 合法候选 | 闸门已移除；空队列会说明原因 |
+
+**embedding 是可选增强，默认不下载任何东西。** 不装模型就是纯词法检索，功能完整；装了才有跨语言与改写召回。
+实测效果与安装方式见 `docs/memory-architecture.md` 和 `tools/download-embedding.mjs`。
+
+## 0.4.1 改了什么
+
+新增侧边栏入口，并修掉三个「看起来能用、实际没生效」的问题。
+
+| 方面 | 改前 | 改后 |
+|---|---|---|
+| 入口位置 | 只能在 设置 → 会话快照 / 长期记忆 里找，三步才能到 | **左侧栏「会话套件」图标**，点开即用；设置页那三个重复入口已移除 |
+| 记忆总数 | 面板显示 17，设置页显示 51 —— 同一句话两个数 | 面板遍历**所有已登记工作区**，与设置页一致；每个数字都写明统计口径 |
+| 归档恢复 | 点了没反应，磁盘上的标记纹丝不动 | 修了参数签名（两个 Host 服务的入参形状不同），恢复真正生效 |
+| 长列表滚动 | 面板内容被裁掉，滚轮无效 | 面板可滚动 |
+
+**为什么数字会不一样（0.4.0 的真实缺陷）**：长期记忆分「全局库」和「各工作区的库」。
+`longterm.list` 不带 `cwd` 时只返回全局库（17 条），带上 `cwd` 才是全局 + 该工作区。
+面板没有工作区概念，于是只显示了全局那 17 条。现在面板不带 `cwd` 时会遍历所有已登记工作区。
+
 ## 测试
 
-两个自测脚本都在临时目录里跑，不会碰真实的 DSH 数据。
+全部自测脚本都在临时目录里跑，不会碰真实的 DSH 数据。
 
 ```bash
-node tools/selftest.mjs          # 快照 / 忽略规则 / 恢复 / 淘汰 / 记忆
-node tools/selftest-rollback.mjs # 回滚 / 撤销 / 删除消息 / 分享 / 永久删除
+node tools/selftest.mjs                    # 快照 / 忽略规则 / 恢复 / 淘汰 / 记忆
+node tools/selftest-memory-dedupe.mjs      # 维护幂等，重复不再生成
+node tools/selftest-resident-cards.mjs     # 常驻卡片分组与预算
+node tools/selftest-episode-memory.mjs     # 情景记忆类型与衰减
+node tools/selftest-memory-privacy.mjs     # 隐私分级与导出过滤
+node tools/selftest-implicit-queue.mjs     # 隐式候选不再被误杀
+node tools/probe-dense-rerank.mjs          # dense 重排的实测对比（需要模型）
 ```
 
 ## 已知边界