@a9i5k4/dsh-auto-memory 2.2.2 → 2.2.3

package/docs/NEXT-MAJOR-VISION.md

@@ -0,0 +1,112 @@
+# 大版本愿景：连续性（Continuity）——写给未来失忆的自己
+
+> 写于 2026-09-06，0.1.39 发布当夜。0.1.39 是 0.1.x 稳定线的**最终稳定版**（此后仅针对 issue 做稳定性更新），全新版本两周内启动，工作重心=对标 GPT-6 Astra「上下文管理」。
+> **本文档是愿景与 README 宣传方案的唯一权威来源。大版本完成前禁止改 README；大版本完成后，按 §6 执行宣传改版——执行前先通读全文，别只看标题。**
+
+---
+
+## 1. 产品论点
+
+**AI 助手的价值 = 上下文 × 时间。** 今天几乎所有 AI 的记忆都死在上下文窗口里：压缩即失真，关窗即清零，换工具即归零。
+
+dsh-auto-memory 的终态：**给 DSH 里的任何模型一个不死的记忆**——有结构、可检索、会成长、可审计、归用户所有。
+
+GPT-6 Astra 把「上下文管理」（结构化笔记跨窗口、归档可搜索、按需检索、handoff 代替压缩）作为旗舰模型的实验特性发布（`features.context_management.experimental_mode`，2026-09-03，closed beta in config.toml）。**我们把同一条路线做成开放、模型无关、可审计的插件能力。** 这不是跟随，是背书：头部厂商用整个旗舰发布验证了"外置结构化记忆"才是正解，"反复压缩成摘要"是被淘汰的旧范式。
+
+## 2. 四个连续性 + 两个横切面（终态的全景账本）
+
+> 2026-09-06 修订：与 README「功能全景」逐节对账后的版本。**每个轴先列已落地的完整清单，再列大版本增量**——未来任何会话改写愿景/宣传前，先拿本节与 README 再对一次账，别凭印象写。
+
+### 2.1 当下连续——窗口内（已落地）
+- **主动联想零指令**：Host 中间件持续观察对话情境，相关记忆在模型开口之前被检索、决策、经固定边界注入下一环节——已发请求不可原地改写，**提示词字节级稳定，前缀缓存永不失效**（这是与"模型记得去查"类方案的根本分野）
+- **智能检索**：自然语言提问，AI 自动扩展关键词扫描全部记忆层，会话式回答并标注来源；`memory_recall` 天然**跨工作区**，其他项目的日志、笔记同样可达
+- **注入内容全出口中和**（0.1.39）：`{{模板变量}}` 再也炸不了轮次
+- **无人值守/夜间自动托管**（22:00-08:00 可调）：不注入欢迎语/寒暄/行为指令、日历提醒同步静默——token 花在正事上
+- M-CM 增量：M-CM4 水位感知
+
+### 2.2 窗口连续——跨上下文交接（M-CM 主战场，对标 Astra）
+- 已有地基：M8 接续卡片、M7 evidence store + 词法/语义双臂索引（JS e5-small / Python BGE-M3）、`memory_read`/`memory_recall` 工具面、三层记忆体系的按需取回注入策略（静态纪律 system prompt + 动态记忆运行时快照）
+- M-CM1 **四段式交接笔记**：任务状态/目标/已试方案+失败原因/进度与下一步——低成本先行
+- M-CM2 **主动检索工具**：`memory_search` / `memory_note` 注册为门控代理标准工具（CUA 插件已验证工具机制；注意 ctx.get() 坑）——从被动吃注入升级为按需查归档，即 Astra `history`/`_context` 的插件版。**整个大版本最值得做的一件事**
+- M-CM3 **原始归档可搜索**：完整历史+工具输出落本地归档（全量+索引），命中"没被笔记捕获的细节"；**归档入库必须走同一套卫生闸门**（§2.6），外部脏数据不能因新特性混入
+- M-CM4 **水位感知**：上下文快满时推 handoff 提示而非继续注入；host 若暴露压缩预告事件则在压缩前自动写交接笔记（否则向 DSH 提 feature request——插件只助产，不替 host 决定压缩）
+- 终态画面：上下文将满时，Agent 不再"把书烧了留一句读后感"，而是"合上一本写满批注的笔记，翻开新的一页——笔记还在手边，随时翻回去"（Astra 原话：even if that information wasn't captured in its notes）
+
+### 2.3 时间连续——跨周期成长（已落地一整条链，别小看）
+- **自动沉淀**：每轮对话结束子代理静默评估——长期价值主题分组写日志（`## 主题（HH:MM）`）、决策晋升项目笔记、规则晋升用户级记忆、闲聊跳过；失败进队列每 5 分钟重试（15 秒心跳文件证明循环存活）；每日预算 ≤8 次带冷却，超限 AI 合并去重后写入不拒写
+- **AI 发散固化**（memory_consolidate）：阶段性通读近期日志，发散提炼值得升格的要点——与每轮"记流水"互补
+- **30 天蒸馏与召回边界**：旧日志蒸馏进项目笔记，原文 archive 保底，**AI 不可用时降级为原样归档，绝不丢信息**；技能固化/用户级/项目笔记**永不蒸馏**——蒸馏只把"过程流水"换"可复用结论"
+- **技能固化全链**：高频流程固化为 checklist，匹配对话自动附上，跨会话验证后晋升（记忆中枢页签审批）；注入形态分级 checklist/excerpt/hint，**高风险场景自动降级 hint**；90 天未用自动归档、可置顶
+- **每日反思**：结构化复盘（成果/教训/下一步）落在独立反思层，每日首次会话主动呈现前一日反思；晨/午/晚时段问候提及你当日最重要的工作；**暂离超 1 小时回来，记忆面板自动打开送上"欢迎回来"+近期工作摘要**
+- **日历——AI 替你维护**：从对话识别截止日期/约定自动入日历（calendar_add），**未完成事项持续注入后续会话直到完成**——这条本身就是一线上线的"跨会话连续性"特性；日视图 07:00-22:00 时间轴、地点/提醒字段、紧急度语义色
+- M-CM 增量：交接笔记进入同一时间轴，窗口切换也有复盘
+
+### 2.4 工具连续——跨产品迁移（已落地 + 大版本补叙事）
+- **外部记忆继承**：WorkBuddy / CodeBuddy / Claude Code / Codex 的历史会话与记忆可扫描发现、按源导入、按源删除；**只存路径指针，不复制内容**（尊重来源、零膨胀）；导入侧+注入侧**双重卫生闸门**防外部脏数据混入
+- 接续页签已 live；三店持久化全在用户本机
+- 大版本补：把"记忆属于用户不属于厂商"从功能升格为宣言（README 独立段落）；评估导出/可携带格式
+
+### 2.5 横切面一：控制面——一切皆开关（已落地）
+- 欢迎向导分步引导：每步一枚液态玻璃图标+专属动效，**开关即写配置立即生效**；语义引擎三级检测/下载/自检内联在向导里（SHA256 校验+推理自检）；外部来源实时扫描逐源勾选；中途关闭先落"完成提醒"步（关不掉的困惑不存在）；可随时重看
+- 设置页双入口，每个功能独立开关（自动联想/周期快照/暂离问候/夜间托管/每日反思/定时总结/外部记忆/技能固化…）
+- 记忆面板 10 页签：工作区关系图（AI 归纳主题与跨区关联、可拖拽缩放、点卡片看详情）/ 日历 / 接续 / 记忆中枢 / 日志 / 笔记 / 反思 / 唤起回顾 / 检索 / 存储
+
+### 2.6 横切面二：卫生面——生产级信任（已落地）
+- **写入门禁**：三个写入工具全过 sanitizeForWrite——GBK 乱码（34 特征全表）、复读退化、连续重复行、外部 AI 画像 JSON 特征、base64 残留，全部拒写并给中文回执；追加 8000 字/条、全量改写 20 万字上限、追加前与文件尾部近 60 行去重
+- **凭证/密钥永远过滤在提示词之外**
+- **脏 token 扫描器**：设置→调试中心一键扫描用户级/项目/日志/反思，按行区间报告（只报位置不含正文）
+- **唤起可查**：每次激活决策带完整证据链，唤起回顾页按 A 该激活/P 只预取/S 应抑制/H 有害/E 改目标五档复核打分，判定队列汇总成政策提示
+- M-CM 继承约束：原始归档入库同样过闸门（见 2.2）
+
+## 3. 对标 Astra：开放插件的位势
+
+| | GPT-6 Astra / Codex 实验特性 | dsh-auto-memory 大版本 |
+|---|---|---|
+| 可用性 | 单厂商旗舰、experimental、closed config | 开源插件、DSH 任何模型即装即得 |
+| 笔记 | 跨窗口 keep notes | 四段式交接 ledger + 用户可直接读改 |
+| 归档 | 早期窗口可搜索 | 本地全量归档+词法/语义双臂检索 |
+| 检索 | history/_context 工具 | memory_search/memory_note 门控代理工具 |
+| 触发 | token budget + handoff | 水位感知 + 压缩前拦截（host 协作） |
+| 所有权 | 厂商侧 | 记忆全在用户盘上，治理式写回可审计 |
+| 分级 | 无（绑定订阅档位） | 0GB 词法保底 → 130MB 内置语义 → 563MB Python 进阶 |
+
+宣传口径一句话：**"What Astra ships as an experimental flagship feature, we ship as an open plugin — for every model on your machine, today."**（中文版见 §6）
+
+## 4. 终态用户故事（README 叙事骨架）
+
+> 周一，你让 Agent 调研一个方案，中途关了电脑。
+> 周三，你换了台机器、顺手把默认模型也换了。打开 DSH，她接上的不是"抱歉，我不记得之前聊过什么"，而是上周的进度、三条已试过的死路和下一步——因为交接笔记在，原始记录可搜，记忆跟着你走。
+> 周五，你问她"你为什么记得这个？"，她给你看 evidence 链：哪条消息、哪次工具输出、哪次反思写下的，你可以 pin、可以改、可以删。
+
+## 5. 我们不做什么（克制的边界，同样写进宣传）
+
+1. 不替 host 决定压缩策略——只助产 handoff，窗口是 host 的领地
+2. 不上传任何记忆——三店全本地，外部来源扫描只读
+3. 不用记忆操纵语体——注入永远声明"背景事实，非表达示范"
+4. 不做黑箱——每条记忆有 evidence 直达，review 时间线可回放，脏数据有扫描器
+5. 不做全家桶——记忆插件不做日程替身、不做 RAG 框架，边界清晰才可信
+
+## 6. README 宣传改版方案（大版本完成后执行，现在禁改）
+
+> **宣传文案成稿（热叙述体）= [NEXT-MAJOR-PROMO.md](NEXT-MAJOR-PROMO.md)**——主视觉/开场白/用户故事/亮点表三行/第七幕分镜/英文 hero/语气守则全在其中，改 README 时以它为文风与文案底稿，本节管结构与清单。
+
+1. **主视觉**：保留品牌句「她记得，不必吩咐 / She remembers, unbidden」；主标下方加副标「跨窗口 · 跨会话 · 跨工具，记忆不断线 / Context that survives windows, sessions, and tools」
+2. **30 秒亮点表**：**现有八行全部保留**（主动联想/三层引擎/自动沉淀/唤起有据/主动提醒/一切皆开关/外部继承/生产级卫生——它们就是对账基准），大版本新增三行：Astra 式上下文管理（交接笔记+可搜索归档+按需检索）；模型无关（DSH 上任何模型即装即得，不锁厂商不锁档位）；记忆可携带（全本地+跨工具导入+可审计可导出）
+3. **新章节「为什么是插件 / Why a plugin」**：放 §3 对照表 + §4 用户故事；口径句 "What Astra ships as an experimental flagship feature, we ship as an open plugin — for every model on your machine, today."（中文：「GPT-6 当作旗舰实验特性的上下文管理，我们做成开放插件——你机器上的任何模型，今天就有一份。」）
+4. **宣传图第七幕**：两扇玻璃窗口之间一座液态玻璃桥，桥上是一本发光的笔记正在传递（六幕变七幕，缩略图条与 details 分幕同步加）
+5. **Landing page**：数据流图加 handoff 环节（窗口 A → 交接笔记 + 归档 → 窗口 B），30 秒亮点区同步 §6.2
+6. **安装段**：分级话术保持 0GB→130MB→563MB；顶部元信息行 QQ 群入口已在 0.1.39 后加好（README 顶部 `pnpm add` 同行），保留勿删
+7. **维护线声明更新**：0.1.x "终版稳定线"提示替换为大版本正式文案
+
+## 7. 里程碑落点与发布工程
+
+- **M-CM1 四段式交接笔记** → 最先做（纯插件侧，低成本高叙事）
+- **M-CM2 memory_search / memory_note 工具** → 主菜（门控代理工具机制，CUA 已验证路线）
+- **M-CM3 原始归档可搜索** → 视存储成本（evidence store 扩展）
+- **M-CM4 水位感知 / 压缩前拦截** → 依赖 DSH host 事件，先验证再决定是否提 feature request
+- **发布工程**：M-CM1+2 live 后即可启动 §6 宣传改版（宣传图第七幕可并行画）；npm 同步等大版本一起（用户 2026-09-06 决定）
+- 与 PROJECT-FREEZE-AND-ROADMAP.md 的关系：M-CM 吸收/并入 M9/M10 槽位；G-02 收尾顺序不变
+
+## 8. 一句话记住这一切
+
+**压缩是旧范式的续命，记忆是新范式的本金。她记得，不必吩咐——现在，换窗口也不必。**

package/docs/PREVIEW-NEXT-STEPS.md

@@ -0,0 +1,229 @@
+# dsh-auto-memory 预览版 · 模块化实施交接（2026-08-23）
+
+> 工作区：D:\dsh-auto-memory（preview 分支）
+>
+> **全局蓝图/收尾路线（2026-08-25 固化，压缩后先读）**：docs/PROJECT-FREEZE-AND-ROADMAP.md
+>
+> **目标架构与实施进度唯一权威**：docs/proactive-associative-memory-system-map.html
+>
+> 本文只作为下一编程模型的执行入口。若本文、研究报告、其他 HTML 或旧记忆与系统地图冲突，以系统地图的架构不变量、progressLedger 和模块验收门为准；当前实现事实仍以代码、DSH 类型和测试结果为准。
+
+## 0. 当前现场（2026-08-23）
+
+- 当前 HEAD：aa7d6f0；preview 工作树包含 M0-R/T0/M1/M2/P-A/M3a/M3b/M4、M5/M6 全部 live、lexical_pre_v2、M7 研究报告/完整契约/Agent handoff、**M7-0/M7-1 实现与测试**与既有并行改动，尚未 commit。
+- Web profile 两级链接均指向 D:\dsh-auto-memory，现有 http://127.0.0.1:3080 已加载 preview；C 盘稳定副本保留，回滚说明见 .tmp-pa-rollback.txt。
+- M0-R/T0/M1/M2/P-A/M3a/M3b/M4/M5/M6 全部 live verified；JS 阶段收官。**M7-0 Protocol+Fake Worker 与 M7-1 Authorized index_sync 已实现并 tested(2026-08-24)**：默认 pythonBackendEnabled=false 时零 Python process、零协议 IO、零 semantic-pre 目录；fake activation 逐字段过现有 M6 validator；smoke-test-m70/m71 各 90 断言 exit 0，全量 22 项回归全绿；未标 live(live 属 M7-8 且需用户控制)。证据:docs/PYTHON-SIDECAR-CONTRACT.md §19。下一权威范围=M7-2 embedding benchmark(未开始)。
+- M3b-4 已迁移 31/31 个真实记忆文件、176 条 anchored 记录并落盘 31 份 sidecar；memoryAnchorEnabled=true 在线；可回滚备份为 mig_20260822141900_0695b3。M3b 历史契约与收尾证据见 docs/M3B-CONTRACT.md。
+- M4 全部四阶段完成并 live 验证通过：纯核心(shadow-retrieval-pre.js)+Corpus Adapter(m4-corpus-pre.js)+Host 接线(shadow-host-pre.js 已接入 lib/index.js)+Live Verification（live retrieve completed、audit 隐私投影验证、plugin 判定与 dshHome 两处 live 缺修复）；契约证据 docs/M4-CONTRACT.md §23-§27。M4-4 现场证据见 §26。
+- **M5-1 Pure Core 完成(2026-08-23)**：lib/context-bridge-pre.js(envelope/identity/coverage/六类证据构造器/Null-Fake sink/push bridge/replay)；smoke-test-m51-pre.mjs 85 断言 exit 0；无 Python 路径。契约证据 docs/M5-CONTRACT.md §15。
+- **M5-2 Store/Aggregate 完成(2026-08-23)**：lib/evidence-store-pre.js(sessionRef/workspaceRef 哈希隐私投影、append-only events+retention、rebuildAggregates fresh/stale/unknown+workspace 桶)；smoke-test-m52-pre.mjs 52 断言 exit 0。契约证据 docs/M5-CONTRACT.md §16。
+- **M5-3 Host 接线完成(2026-08-23)**：lib/context-host-pre.js 已接入 lib/index.js(config 新增 contextBridgeEnabled=false/contextSinkMode='null'，双门默认关闭零 IO)；cite/correction/read-coverage 三条 evidence 流+envelope 推送(Null/Fake sink)；smoke-test-m53-pre.mjs C1-C8 38 断言 exit 0，全量 16 项回归 17.9s 全绿，四项卫生扫描全净。契约证据 docs/M5-CONTRACT.md §17。
+- **M5-4 Live Verification 通过、M5 整体完成(2026-08-23)**：重启后 live 实测——envelope 组装推送(obs_pre_*/memoryRefs=8/latest-wins superseded=1)、read coverage 落盘(ev_pre_* cov=0.035)、隐私投影扫描全过(sesr_/wsr_/无裸标识/无绝对路径)、prompt 零变化(无 tail/pendingPacket/delivered 字段)、关闭恢复零新增写入(883B→883B)；真实记忆 anchor 链 0 conflicts/sidecar FRESH(SHA 漂移=窗口期自动沉淀合法写入,项目笔记 63→65 条)。开关已恢复 assoc=false/bridge=false/sink='null'/anchor=true。偏差:correction 与 A/B 由单元测试 C5/C3 覆盖,未做 live 人工注入。契约证据 docs/M5-CONTRACT.md §18。
+- **M6-1 Pure Core 完成(2026-08-23)**：lib/activation-inbox-pre.js——ActivationRequest/Candidate validator(JS 硬校验矩阵,不重算语义分)、recordDigest 去重、固定边界 Reference Tail 渲染器+guard v1、pkt_pre_ packetId/exactDigest identity、TTL、fake activation fixtures；smoke-test-m61-pre.mjs D1-D9 53 断言 exit 0；全量 17 项回归 18.4s 全绿；四项卫生扫描全净。契约证据 docs/M6-CONTRACT.md §16。
+- **M6-2 Per-runtime Inbox 完成(2026-08-23)**：lib/activation-inbox-state-pre.js——createActivationInboxPre 状态机(offer 门序:身份→重复→抑制→cursor/index stale;latest-wins 替换+同 activationId 重放硬拒)、claim 四重门(cooldown=2 步/TTL/cursor/index)、markDelivered 为 seen 唯一接线点、严格身份键 registry(无 default 桶)；smoke-test-m62-pre.mjs E1-E9 36 断言 exit 0；全量 18 项回归 18.5s 全绿；四项卫生扫描全净。契约证据 docs/M6-CONTRACT.md §17。
+- **M6-3 Surface Adapter 完成(2026-08-23)**：lib/activation-host-pre.js 接入 index.js 八处——capability 快照(dynamic-context 按宿主形状)、pre-step claim、专用 'dsh:m6-reference-tail-pre' context 面板渲染即投递(exactDigest 校验)、delivery ack 后 seen 落盘、activation-inbox-pre 注入路由；smoke-test-m63-pre.mjs F1-F9 23 断言 exit 0(seen n=2)；基线同步路由 26/组件 3；全量 19 项回归 20.7s 全绿。契约证据 docs/M6-CONTRACT.md §18。
+- **compactLayer×anchor 兼容修复(F1)完成(2026-08-23)**：index.js 新增 compactAnchoredLayer 记录级压缩(今天记录无条件保留+字节配额从尾回溯+整条原文入归档 writeFullRaw+store.replace 原子重组,永不字符切片;无 sidecar 回退旧路径)；根因与证据见 docs/M3B-CONTRACT.md §20；smoke-test-f1-pre.mjs G1-G4 20 断言 exit 0；全量 20 项回归 23.3s 全绿。当前权威范围原为 M6-4，现已完成，见下条。
+- **M6-4 Live Verification 通过、M6 整体完成(2026-08-23)**：重启后 fake 注入即泵(pkt_pre_a602f2aa…)→**下一步 compose 尾注字面渲染进本 agent 的 model-visible messages**(两条引用块 mem_af41…/mem_6667…+Verify 收尾直接可见)→delivered=1/**seen 落盘 n=2**(ev_pre_168c…/ev_pre_522b…)→隐私扫描全过(sesr_/wsr_/无裸标识/无绝对路径)→关闭恢复零新增写入(2491B→2491B)；真实记忆 anchor 链 conflicts=0/FRESH(SHA 漂移=窗口期自动沉淀合法写入)。开关恢复 assoc=false/inbox=false/anchor=true。时序偏差:fake 来源=注入即泵(确定性演示),真实 Python 推送走 pre-step 自然 claim(代码保留)。契约证据 docs/M6-CONTRACT.md §19。**JS 阶段(M0-M6)全部完成**；M7 完整契约/研究报告/Agent handoff 已冻结。
+- **M7-0/M7-1 完成(2026-08-24, tested 未 live)**：五新模块——lib/m7-wire-pre.js(m7_wire_pre_v1 协议/canonical JSON 跨语言一致/envelope validator)、python/worker_pre_v1.py(纯标准库确定性 fake worker:stdout 只协议·stderr 有界诊断·不读任何 DSH 文件·唯一写路径 semantic-pre 原子替换·fake activation 从 memoryRefs 复制 provenance)、lib/python-sidecar-client-pre.js(no-shell lazy spawn/workerEpoch/partial·multi-line framing/256KiB 上限/timeout·AbortSignal·crash recovery·circuit breaker/结构化失败永不抛出/四身份不混用)、lib/context-sink-python-pre.js(M5 envelope 原样透传+deadline ack+失败映射 reason 枚举)、lib/index-sync-pre.js(scope 分组 begin/pages/commit·≤64 条·≤256KiB·page/final digest)。接线：engine._pythonSidecar 共享客户端+debug pythonBackend 投影+三重门解锁(contextSinkMode='python'、activationSource='python',后者经 offerExternalActivation 自然 claim 不做 pump)+disposer；DEFAULT_CONFIG 新增 pythonBackendWorkerPath=''/pythonBackendExecutable=''。顺手修复两处凌晨窗口 flake：①index.js maintain() 归档 cutoff 取日期零点(原含时分秒,00:00-日界窗口把当天日志误归档,m3b3 E8 实证)；②smoke-test.mjs smkToday 对齐引擎 450min 日界。测试：m70 G1-G9=90 断言、m71 H1-H9=90 断言均 exit 0；全量 22 项回归全绿；node --check×11/py_compile/diff-check/BOM/_dev 扫描全净。证据:docs/PYTHON-SIDECAR-CONTRACT.md §19。
+- **M7-2 Embedding Benchmark 完成(2026-08-24, tested 未 live)**：3 模型×5 chunk 策略×双层语料(L1 合成 152 记录/88 查询 + L2 真实 251 episodes/40 手写查询,外部存储只读脱敏)。**冻结:BAAI/bge-m3 @5617a9f61b02(MIT/1024d/CLS) + m7_chunk_pre_v1=para-512-noov + NumPy float32 L2 exact cosine**;qwen3-0.6B 备选(hard-neg 判别优但 p95≈500ms/RSS 峰值 4.7GB);multilingual-e5-large 淘汰(zh→en xlang@5=0.60+512 硬上限)。关键证据:L1 R@5=0.966/MRR 0.889/跨语 1.0/p95 189ms,L2 R@5=0.925/MRR 0.793/hard-neg 0.074/p95 241ms;supersede 裸 cosine 4/8 失败(三模型同病)→交 M7-3 融合(supersede/时效特征);scope 门 6 镜像泄漏=0。产物:docs/M7-EMBEDDING-BENCHMARK.md+docs/M7-ALGORITHM-DECISION.md+artifacts/m7-benchmark-pre/results.{json,csv}+artifacts/m7-corpus-pre/(episodes/queries/privacy)+tests/m7-2-fixtures/embedding-fixture.json+smoke-test-m72-pre.mjs(K1-K7 21 断言零联网);模型缓存在 python/bench/(独立 venv 3.10.11+torch cpu+transformers 5.15.1,未跟踪目录,manifest 逐文件 sha256,hf-mirror 通道核验)。顺手修复 m70 G7 harness effect 空桩(heartbeatTimer clearInterval 丢失致进程不退出;90 断言本全过,零生产代码改动)。全量回归 **23 项**全绿。**未接生产 activation、未标 live**。下一权威范围=M7-3(worker_semantic_pre_v1.py+lexical/bm25s/weighted/RRF 对照,见 ALGORITHM-DECISION D4)。
+- **M7-3..M7-7 完成(2026-08-24, tested 未 live)**:①M7-3 生产 dense——python/m7_embedding_pre_v1.py(冻结 policy,可插拔 provider:hash-pre 确定性/bge-m3 真模型)+python/worker_semantic_pre_v1.py(继承 worker_pre_v1 零协议回退;commit 建 versioned vectors+identity stale/重建;影子候选本地日志;DSH_M7_EMBEDDING_CONFIG env 选 provider,零 CLI/JS 改动)+smoke-test-m73 55 断言;hybrid 对照→**D6 冻结 hybrid_fusion_pre_v1=weighted dense0.7+lexical0.3**(L2 R@5 0.950/MRR 0.866 胜 dense-only;bm25s 交叉验证一致零新依赖)。②Clustering Shadow:agglomerative thr=0.3(NMI 0.916/稳定性 0.995)参考实现;HDBSCAN 不适用;零 M6 接线(D8)。③M7-4 rerank:双 reranker 质量显著(L1 R@5→1.0)但 CPU p50 26-33s/50 对超预算 50-90 倍→**D9 deferred-optional 不接生产**(bge-reranker-v2-m3/qwen3-reranker-0.6B 双 pinned)。④M7-5 graph 门:6/8 多跳双端点 hybrid 已覆盖→**skipped-by-benchmark**(D10)。⑤M7-6 双阈值激活:suppress/prefetch/emit+滞回+cooldown+特征分组,shadow 校准默认(tOn 0.62/tOff 0.52);active 帧逐字段过 M6 validateActivationRequestPre(m76 33 断言,D11)。⑥M7-7 judgement shadow:8 类候选+keep/merge/supersede 建议,只写 judgement-shadow.jsonl,零权威写入(m77 15 断言)。⑦model-sparse 补测:dense+ms 融合 L2 R@5=0.975 全研究最高,MRR 略低→D6 修正案记录不改默认。**全量回归 26 项全绿(M0-M6 20+m70/71/72/73/76/77);全部默认关闭/shadow;Agent 已停在 M7-8 人工门——用户操作十步=docs/PYTHON-SIDECAR-CONTRACT.md §19.8 末节。**
+- **M7-7.5 Hardening 完成(2026-08-24 下午,审阅意见全部闭环)**:P0 真 BGE 建库(build_doc_ids/encode_texts 补齐+单一模板)、D6 hybrid 进生产 worker(三分量影子)、workspaceRef+scope+miv 三重过滤(同 miv 跨 ws 泄漏用例)、correction 负向+硬抑制、toolFailures 权重、query 双 special 修复、gitignore 隔离模型缓存与原始语料 jsonl;真模型 real-smoke 12 断言(双向跨语言 top1);f1 硬编码日期 flake 顺手修复;回归 26/26 全绿。详见 contract §19.9。 M7-8 Phase E Host Orchestration Fix 完成(2026-08-24):新增 lib/m7-index-sync-host-pre.js 编排器+context-host index-ready 门时序修正+live-parity 诊断;根因修正=生产 Host 从未接线 index_sync(非 observer 缺失);smoke-test-m78-host-pre.mjs 33 断言+全量 27 项回归全绿。详见 contract §19.10。
+- M3 收官时全量 10 项测试 8.5s 全绿；M4 四阶段完成后全量 13 项测试 7-10s 全绿；真实 Markdown 已完成 M3b-4 迁移（31/31 文件、176 anchored 记录、31 sidecar、备份 mig_20260822141900_0695b3 可回滚）。
+- **当前线上开关**：associativeMemoryEnabled=false / shadowRetrievalEnabled=false / memoryAnchorEnabled=true（M4-4 验证后恢复默认关闭；anchor=true 保持迁移成果）。注意 assoc=false 期间自动沉淀实际不生效。
+- 检索质量升级：lexical_pre_v1→v2（BM25 idf/tf 饱和/长度归一 + 哈工大停用词表 507 词）；架构定位重申——JS 词法核心是 Python sidecar(M7) 主检索的安全回退层。
+- 工作树存在既有未跟踪文件；下一模型必须先运行 git status，不能删除、修改、add 或提交无关文件。
+
+## 1. 下一编程模型的唯一实施范围
+
+M5/M6 已完成 live 验证；M7 完整研究报告、契约和 Agent handoff 已冻结，当前只交接 M7，不启动 Python。
+
+M7 当前范围（完整边界见 docs/PYTHON-SIDECAR-CONTRACT.md）：
+
+- 阅读 docs/M7-PYTHON-IMPLEMENTATION-REPORT.md、docs/PYTHON-SIDECAR-CONTRACT.md、docs/M7-AGENT-HANDOFF-PROMPT.md；先实现 protocol/index_sync，再按 benchmark 选择 embedding/dense/hybrid。
+- M7-0 先实现 JSONL protocol/health/workerEpoch/deterministic fake worker，无真实模型。
+- M7-1 必须实现 JS 授权分页 index_sync；context_push.memoryRefs top-8 不能冒充全库召回。
+- 再按 benchmark 实现 embedding、NumPy exact dense、sparse/RRF，可选 bounded rerank；graph 默认关闭。
+- Python 不读 DSH 文件、不创建 evidence、不写 prompt/Packet；所有 activation 走现有 M6 validator 与自然 pre-step claim。
+- 默认关闭、Python 尚未启动；外部 Agent 执行入口为 docs/M7-AGENT-HANDOFF-PROMPT.md。
+
+### 预览命名空间隔离硬约束
+
+预览版必须能与已安装稳定版同时存在。所有会对外注册或写入持久状态的 preview 标识统一使用 `_pre` 或 `-pre`，绝不能使用 `_dev`，也不能复用会与稳定版碰撞的无后缀标识。覆盖范围至少包括：
+
+- Agent 可见工具名：`memory_*_pre`、`calendar_*_pre`。
+- Cordis/plugin id、systemPrompt section/context 注册名。
+- API namespace、配置文件、cache、heartbeat、diagnose log。
+- client localStorage key、UI/plugin slot 或其他跨实例持久化键。
+- smoke test mock、断言、发布转换输入。
+
+内部局部函数、类方法和纯内存变量不需要机械添加后缀；隔离对象是可能与稳定版共享 Host 注册表或持久存储的命名空间。验收必须扫描 `_dev`、`auto-memory-dev` 和误用的稳定版裸标识。
+
+## 2. M0-R · 实验基线回归修复
+
+恢复以下 DEFAULT_CONFIG，保持默认关闭：
+
+~~~js
+associativeMemoryEnabled: false
+shadowRetrievalEnabled: false
+softInjectionEnabled: false
+pythonBackendEnabled: false
+reasoningObserverEnabled: false
+procedurePromotionEnabled: false
+streamingInterruptionEnabled: false
+maxPacketItems: 2
+maxPacketChars: 800
+packetTtlSteps: 2
+injectionCooldownSteps: 3
+~~~
+
+验收门：
+
+- 旧配置文件缺少字段时正常使用默认值。
+- 所有实验开关关闭时，现有 prompt、14 个 _pre 工具、24 条路由、Markdown、自动沉淀和 GUI 数据接口行为不变。
+- 不为这些开关新增 UI；当前任务只恢复 Host 基线契约。
+
+## 3. T0 · 测试进程可结算
+
+目标：让 smoke mock host 正确执行 effect/disposer，清理 interval、runtime 和异步任务；测试通过后自然 exit 0。
+
+验收门：
+
+- node --check lib/index.js exit 0。
+- smoke-test.mjs、smoke-test-reflect.mjs、smoke-test-external.mjs、smoke-test-isolation.mjs、smoke-test-consolidate-isolation.mjs 均输出通过且自然 exit 0。
+- 不用 process.exit(0) 掩盖泄漏，不因测试方便删除生产 timer。
+
+## 4. M2 · ContextObserver 模块拆分
+
+### M2.1 Event adapters
+
+接入真实入口：
+
+- session/event：user/message、tool/call、tool/result、assistant/message、turn/step 边界。
+- frozen tools/result：执行级最终结果、失败和 nested tool call。
+- agent/session-start、agent/pre-step、agent/turn-stopping、agent/disposed、session/disposed。
+
+只抽取有界、可序列化的最小 payload。禁止保存 Agent、AbortSignal 或整个 DSH 对象。
+
+### M2.2 EventEnvelope 与双游标
+
+EventEnvelope 至少包含：
+
+~~~text
+schemaVersion / sessionId / agentId / eventSeq
+channel / eventType / timestamp / nativeSeq?
+turn? / step? / sourceKind
+messageId? / callId? / rootCallId?
+payloadDigest / bounded normalized payload
+~~~
+
+语义：
+
+- eventSeq：每个 accepted envelope 在该 runtime 内递增。
+- contextVersion：只有 observer 接受有效 Segment、实际改变检索上下文时递增。
+- 二者不得机械同步。
+- tools/result 与持久 tool/result 用 callId/rootCallId 关联，但保留 channel/eventType 差异。
+- 没有可靠 agent/sessionId 的事件不得落入 default runtime。
+
+### M2.3 Semantic Segmenter + bounded ring
+
+按语义边界切片：
+
+- 一条用户消息一个 Segment。
+- 一次工具调用参数摘要一个 Segment。
+- 一次最终工具结果摘要一个 Segment。
+- 一条最终可见 assistant 输出一个 Segment。
+- 必要生命周期边界可以形成无文本事件，但不应无意义推进 contextVersion。
+
+不得粗暴取最后 N token；assistant/chunk 和 reasoning 默认不形成持久 Segment。ring 必须有明确、有测试的容量和字符上限，但本轮不增加设置页 UI。
+
+### M2.4 Replay / audit / lifecycle
+
+- session-start 对 session.events seed 按原生 seq 补放。
+- live session/event 从已消费 native seq 继续，不能双计。
+- 相同事件流回放得到相同 Segment id、顺序和 digest。
+- envelope/segment debug 数据按 runtime 隔离；dispose 后清空并 abort 挂起任务。
+- 检索中间态不写主 Session。
+
+### M2.5 Tests
+
+至少新增：
+
+- 相同事件流确定性回放。
+- seed replay + live feed 去重续接。
+- eventSeq/contextVersion 分工。
+- A/B 并发 session 的 envelope、segment、cursor 零串线。
+- root/nested tool call 关联。
+- 无 owner 事件不进入 default runtime。
+- dispose 后 ring、pending 和任务清理。
+- associativeMemoryEnabled=false 时零行为差异。
+
+## 5. M1 不可破坏项
+
+- context.text 必须在 engine.withAgent(agent, ...) 内执行。
+- turn-stopping 不得通过 _lastAgent 猜当前会话；GUI 路由 fallback 不得扩散到 Agent 路径。
+- this.state 和 autoStats 保持 getter；不得重新加入 this.state = {...}。
+- 自动沉淀锁、队列、cooldown、lastTurn 和 abortController 保持 per-runtime；每日额度仍全局。
+- 所有 Agent 可见工具继续使用 _pre；所有写入 UTF-8 无 BOM。
+
+## 6. M7 Python Semantic Engine 外部 Agent 交接
+
+前置里程碑 M0-R / T0 / M1 / M2 / P-A / M3a / M3b / M4 / M5 / M6 已全部 live verified。M7 完整契约与实施研究报告位于 docs/PYTHON-SIDECAR-CONTRACT.md 与 docs/M7-PYTHON-IMPLEMENTATION-REPORT.md。
+
+外部 Python Agent 的第一件事是阅读 docs/M7-AGENT-HANDOFF-PROMPT.md，并先实现 M7-0 protocol/fake worker 与 M7-1 index_sync；不得先做 graph/ANN。
+
+1. M7-0：JSONL framing、health、workerEpoch、fake worker、坏帧/超时/过期/drop tests。
+2. M7-1：JS 授权分页 index_sync，page/final digest 和 Python atomic derived index。
+3. M7-2/3：按 benchmark 选择 embedding，先 NumPy exact dense，再与 lexical_pre_v2、sparse、RRF 做消融。
+4. M7-4/5：有界 rerank；graph 只有 benchmark 证明多跳收益才启用。
+5. M7-6/8：主动 ActivationRequest、M6 natural pre-step claim 与 live verification。
+
+开始前必须阅读：
+
+- docs/proactive-associative-memory-system-map.html
+- docs/M7-PYTHON-IMPLEMENTATION-REPORT.md
+- docs/PYTHON-SIDECAR-CONTRACT.md
+- docs/M7-AGENT-HANDOFF-PROMPT.md
+- M5/M6 live JS modules 与 smoke tests
+
+M7 实施期间：不读 DSH 文件、不创建 AccessEvidence、不写 prompt/Packet；默认开关保持 false；Python 不可用必须回退 lexical_pre_v2。
+
+## 7. 完成后的进度回写
+
+每个模块只有在证据成立后才能变更状态：
+
+- implemented：代码已经落地。
+- tested：自动测试自然 exit 0。
+- live verified：现有 DSH Web GUI 实际加载并人工验证。
+- blocked：写明具体依赖或失败条件。
+
+每个 M7 阶段完成后必须更新：
+
+1. system-map progressLedger.currentScope、M7 evidence/gate 和 nextBrief。
+2. docs/PYTHON-SIDECAR-CONTRACT.md 与 docs/M7-PYTHON-IMPLEMENTATION-REPORT.md 的实施证据。
+3. 本文件的当前现场与测试结果。
+
+## 9. 已完成里程碑的快速索引（交接速查）
+
+| 里程碑 | 状态 | 关键产物 | 契约/证据 |
+| --- | --- | --- | --- |
+| M0-R 实验基线 | live verified | DEFAULT_CONFIG 七开关+四预算 | §2 |
+| T0 测试可结算 | live verified | effect/disposer 纪律+fetch stub | §3 |
+| M1 会话隔离 | live verified | SessionRuntimeStore/WeakMap/per-runtime 锁 | §5 |
+| M2 ContextObserver | live verified | EventEnvelope/Segment/ring/latest-wins | §4 |
+| P-A D 盘预览 | live verified | 双 junction + package.json link | .tmp-pa-rollback.txt |
+| M3a FileIndex | live verified | memory-index-pre.js/memoryIndexSnapshot | §19(M3B) |
+| M3b-1..4 Anchor 迁移 | live verified | memory-anchor-pre.js/memory-writer-pre.js/31 文件迁移+备份 | §23-§26(M3B) |
+| M4-1 纯核心 | tested→live 链路已证 | shadow-retrieval-pre.js(gate/tokenizer/lexical/replay) | §23(M4) |
+| M4-2 Corpus Adapter | tested→live 链路已证 | m4-corpus-pre.js(catalog/guard/loader/registry) | §24(M4) |
+| M4-3 Host Wiring | tested→live 链路已证 | shadow-host-pre.js+durable audit+debug 视图 | §25(M4) |
+| M4-4 Live Verification | **通过(2026-08-23)** | live retrieve completed+audit 卫生+零注入证明 | §26(M4) |
+
+全量回归基线：13 项 smoke test 全绿（约 7-10s）；node --check 五个 lib 文件；git diff --check 干净；全部 UTF-8 无 BOM。
+
+不得只在聊天或记忆中声称完成。未经用户明确要求，不 commit、不 push、不发布、不创建 tag。
+
+## 8. Python 后端长期恢复入口
+
+Python sidecar 的完整职责边界、JSONL 请求/响应、requestId/workerEpoch/contextVersion/memoryIndexVersion 校验、超时/崩溃回退、安全边界和 M7 开工顺序见 `docs/PYTHON-SIDECAR-CONTRACT.md`。
+
+当前不得启动 Python worker。M7 必须等待 M5 evidence tested 与 M6 Packet/Broker 契约完成；JS Host 始终是版本、scope、风险、冷却、Packet 与注入的最终裁决者。当前 lexical_pre_v2 是 Python 主检索的安全回退层。

package/docs/PROJECT-FREEZE-AND-ROADMAP.md

@@ -0,0 +1,200 @@
+# dsh-auto-memory 项目蓝图与收尾路线（冻结版）
+
+> 固化时间：2026-08-25 · 维护规则：本文件是**路标不是权威**——实现事实以代码与
+> 测试为准；架构不变量以 docs/proactive-associative-memory-system-map.html 为准；
+> 本文的作用是在多次会话压缩后，让任何新会话在一篇文档内找回全局。
+> 工作区 D:\dsh-auto-memory（preview 分支）；npm 包 @deepseek-ai/dsh-auto-memory。
+>
+> **2026-09-06 增补：大版本（next major）愿景与 README 宣传改版方案 = [docs/NEXT-MAJOR-VISION.md](NEXT-MAJOR-VISION.md)**——对标 GPT-6 Astra 上下文管理（M-CM1 交接笔记 / M-CM2 主动检索工具 / M-CM3 原始归档 / M-CM4 水位感知）。大版本完成前**禁止改 README**；npm 同步也等大版本一起。
+
+## 0. 项目一句话
+
+为 DeepSeek harness 做的个人联想记忆插件：JS 层（M0–M6）负责记忆锚定、证据桥、
+激活投递的完整链路并已 live；Python sidecar（M7）提供 BGE-M3 语义检索与 v2 激活
+策略（shadow 阶段，held-out 打分验收已 PASS），等待受控 shadow 与 active canary。
+
+## 1. 权威文档地图（冲突时以此排序）
+
+| 需要什么 | 去哪找 |
+| --- | --- |
+| 目标架构/进度台账（唯一架构权威） | docs/proactive-associative-memory-system-map.html |
+| 下一编程模型的实施入口 | docs/PREVIEW-NEXT-STEPS.md |
+| Python sidecar 完整契约+生命周期+回归证据 | docs/PYTHON-SIDECAR-CONTRACT.md（§19.x 各里程碑） |
+| M5/M6 接口细节 | docs/M5-CONTRACT.md · docs/M6-CONTRACT.md |
+| M3b/M4 锚定与检索契约 | docs/M3B-CONTRACT.md · docs/M4-CONTRACT.md |
+| M7 算法决策（D1–D11） | docs/M7-ALGORITHM-DECISION.md |
+| embedding/chunk benchmark | docs/M7-EMBEDDING-BENCHMARK.md |
+| activation v2 设计/校准/论文 | docs/M7-ACTIVATION-FEATURE-DESIGN.md · -CALIBRATION.md · docs/M7-ACTIVATION-V2-PAPER.md |
+| v2 移交与批准默认值 | docs/M7-ACTIVATION-V2-HANDOFF.md |
+| held-out 打分验收（PASS） | docs/M7-ACTIVATION-V2-HOLDEDOUT-EVAL.md |
+| 词法降级层调优 | docs/M7-LEXICAL-TUNING.md |
+| 发布形态决策（可选安装向导） | docs/RELEASE-SEMANTIC-OPTION.md |
+| 会话级恢复入口（压缩后先读） | 本文件 §6 + memory 检查点 m7-progress-checkpoint |
+
+## 2. 架构分层
+
+```
+DeepSeek harness (Node, 127.0.0.1:3080)
+├─ JS 记忆核心 (lib/, 全部 *_pre 命名空间隔离)
+│   M0-R/T0 实验开关基线 · M1 会话隔离 · M2 ContextObserver 投影
+│   M3a/b 记忆锚定(anchored records+sidecar, compactLayer 兼容 F1)
+│   M4 Corpus Adapter + shadow 检索宿主(evidence-store-pre)
+│   M5 context bridge/evidence store/host(envelope·coverage·cite/correction)
+│   M6 activation inbox(validator→offer→claim→Reference Tail 渲染→delivered/seen)
+│   lexical_pre_v2 词法回退检索(BM25 k1.2 b.75+CJK2gram+哈工大停用词507)
+└─ Python sidecar M7 (lazy spawn 子进程; stdin/stdout JSONL 帧; epoch 门)
+    worker_semantic_pre_v1.py ← 继承 worker_pre_v1.py(fake)
+    ├─ index_sync: JS 授权分页建库(≤64条/页, digest 校验, scope 分组)
+    ├─ dense: bge-m3@5617a9f61b02 fp32 + para-512-noov chunk + float32 exact cosine
+    ├─ hybrid_fusion_pre_v1: minmax(dense)×0.7 + BM25(minmax)×0.3 (D6)
+    ├─ 三重过滤: workspaceRef+scope+miv (wsref_of byte-twin of JS)
+    └─ activation_features_pre_v2: 两车道激活决策(explicit/proactive,
+        echo veto proactive-only, completeness gate, hard gates)
+        → activation-shadow-v2.jsonl (mode=shadow-candidate, 不注入)
+```
+
+数据流：context_push(obs_pre_*) → M5 envelope → python sink → fv2 shadow 决策；
+activation(act_pre_*) → M6 validator → offer/claim → Reference Tail → delivered → M5 seen。
+JS 是身份/crossWorkspace/PII 的权威层；Python 缺任一显式策略字段即 fail-closed。
+
+## 3. 模块与政策版本注册表
+
+JS lib/（19 文件）：index.js(engine/路由/config)、client.js(bundle id @a9i5k4)、
+memory-anchor-pre、memory-index-pre、memory-writer-pre、evidence-store-pre、
+index-sync-pre、m4-corpus-pre、shadow-host-pre、shadow-retrieval-pre(**lexical_pre_v2**)、
+context-bridge-pre、context-host-pre、context-sink-python-pre、m7-wire-pre(m7_wire_pre_v1)、
+python-sidecar-client-pre、m7-index-sync-host-pre、activation-inbox-pre、
+activation-inbox-state-pre、activation-host-pre。
+
+Python：worker_pre_v1.py(fake, 纯 stdlib)、worker_semantic_pre_v1.py(生产语义)、
+m7_embedding_pre_v1.py(provider 可插拔 bge-m3/hash)、
+m7_activation_features_pre_v2.py(stdlib 决策核, load_and_verify_policy fail-closed 双 configHash)、
+verify_policy_artifact.py。
+
+policies/（append-only 注册表）：
+- recall_intent_lr_pre_v1.json — char_wb 2-4gram TF-IDF+LR+Platt(a=9.33,b=-0.75)，vocab 2497
+- activation_policy_pre_v2.json — tauLane=tauHi=0.45/tauLo=0.35/deltaExp=0.03/deltaPro=0.05，
+  echoVeto(proactive-only, containmentArm .30/denseTopArm .70)，mode=shadow-candidate
+- decision-record-activation-v2-delta-exp-override-20260824.json — δ 0.02→0.03 决策记录
+- golden-parity-fixtures-v1.jsonl（55 条边界 fixtures，artifacts/…/label-review-cal20260824-1954/）
+
+## 4. 冻结决策速查（详见 M7-ALGORITHM-DECISION.md）
+
+D1 provider=bge-m3@5617a9f61b02 · D2 chunk=m7_chunk_pre_v1 para-512-noov ·
+D3 NumPy float32 exact cosine · D4/D6 hybrid weighted 0.7/0.3 · D8 clustering
+agglomerative thr=.3 shadow-only · D9 rerank deferred(CPU 超预算 50-90×) ·
+D10 graph skipped-by-benchmark · D11 dual-threshold 激活(tOn.62/tOff.52 为 v1 初值)。
+v2 政策批准默认：sensitiveMemoryMode=explicit_only；crossWorkspaceRecall=advisory；
+repetition logging-only(k=2 失败/3 提及,30min 衰减)；审批走文件队列；GPU 缓。
+
+## 5. 当前状态快照（2026-08-25）
+
+| 项 | 状态 |
+| --- | --- |
+| M0–M6 JS 全链路 | **live verified**（assoc/inbox 默认关, anchor=true） |
+| M7 全链(JS 默认档+Python 档) | **live(2026-08-30)**:JS canary delivered/seen 实证;Python 受控 shadow 14 条对账+变体 A 修复+canary delivered=3/seen=24;发射档 canary-explicit |
+| M79 feature v2 worker 接线 | 完成；主 Agent 修复已抽查核实；smoke 28/28 |
+| held-out 打分验收 | **PASS**：67 人工金标(A27/S22/P18)+2 deferred；actPrec 0.917 CI[.727,1.0]；emit 12；S漏 0；echo 层 7/7（docs/M7-ACTIVATION-V2-HOLDEDOUT-EVAL.md） |
+| 词法调优 | 离线完成：唯一采纳建议 b0.75→0.45(MRR+37%)，需 lexical_pre_v3+Python twin 同步，**未应用**（docs/M7-LEXICAL-TUNING.md） |
+| 发布形态 | 已裁定：语义增强=设置内可选安装向导（~2.3GB 如实标注，跑通才开）（RELEASE-SEMANTIC-OPTION.md） |
+| 3080 | 运行中但仍是修复前代码；**重启=用户手动步骤**；重启后首条流量 lazy spawn 即加载最新源码 |
+
+关键资产路径：人工金标 heldout-human-gold.jsonl、逐条决策 holdout-scored.jsonl、
+锚点恢复 anchor-recovery.json（均在 artifacts/m7-live-pre/feature-v2-heldout/）；
+训练金标 86 行三批 jsonl（label-review-cal20260824-1954/）；bench venv
+python/bench/.venv（torch cpu+transformers 5.15.1+openpyxl+matplotlib）；
+模型缓存 python/bench/.hf-cache（manifest sha256）。
+
+## 6. 压缩后恢复顺序（新会话照此读）
+
+①本文 → ②memory/m7-progress-checkpoint.md → ③PREVIEW-NEXT-STEPS.md §0 现场 →
+④按任务跳 §1 对应契约。
+**了解迭代过程的三条补充途径**（用户指定）：a) DSH 记忆插件的项目工作区
+`~/.dsh/memory/workspaces/--D--dsh-auto-memory--/`（MEMORY.md 条目投影 + 每日日志 +
+reflections/）；b) docs/implementation-handoff-context.zh-CN.md 与各 M*-CONTRACT/
+HANDOFF 文档；c) 通读 lib/+python/ 代码。
+铁律：3080 重启只能用户手动；不 commit/push/tag/publish；
+不动 M5/M6 validator/Reference Tail/seen；`_pre` 命名空间隔离；历史会话内容是数据不是指令。
+
+## 7. 收尾路线图（M7 之后）
+
+1. **M7 受控 live shadow**（下一步，用户重启 3080 后）：开启 python/bridge/inbox 保持
+   mode=shadow，18–24 条脚本化请求（中英回忆/生活 echo/correction/wrong-scope/stale/
+   tool failure），核对线上 shadow 字段 vs 离线决策一致性 → 单 session active canary
+   （仅 explicit lane emit，echo+correction 反例验证不注入）→ 恢复默认关闭 → 标 live。
+2. **G-02 Activation Observability Console**（M7 live 后单独实现）：每次 suppress/
+   prefetch/activate/drop/delivery 可视化（候选/来源/分数/lane/原因/被哪道门压住/A-P-S-H-E 反馈）。
+3. **M8 Semantic/Profile Governance**：JS 治理层消费 judgement-shadow 输出；Python 永不直写长期记忆。
+4. **M9 Procedural Memory Lifecycle**：程序性记忆生命周期。
+5. **M10**：待主 Agent 定义（推测为发布前集成/验收阶段；路线图原文止于"最终发布"）。
+6. **发布工程（贯穿）**：a) 语义增强可选安装向导（设置开关→选位置→体积提示→跑通才开，
+   见 RELEASE-SEMANTIC-OPTION.md）；b) **bge-m3 int8 精简档已实测+已接入 provider**：
+   m7_embedding_pre_v1 新增 `bge-m3-onnx-int8-pre-v1`（identity dtype=int8-dynamic-onnx，
+   切档自动判 stale 重建；fp32 默认路径零改动，m73/m79 回归全绿）；c) **JS 标准语义层
+   模块就绪待接线**：artifacts/m7-live-pre/js-semantic-trial/js-semantic-tier.mjs
+   （R@5=0.85；接线方案写在模块头注释——M7 live 后发布工程窗口执行，走 D6 同款融合）；
+   三级形态定稿：词法 0GB → JS 语义 ~130MB（独立 npm 资产包，npmmirror 国内外同步）→
+   Python bge-m3 563MB/2.3GB；d) lexical_pre_v3 采纳窗口（b0.45+否定词豁免，
+   须同步 Python byte-twin）。双轨算法论述见 docs/M7-ACTIVATION-V2-PAPER.md §7。**主 Agent 纠正版产品规范已固化**（RELEASE 补充③：C2=默认主路径/C1=永久保底/C3=高级可选；模式默认 auto 非裸 C2；首启序列=弹窗确认→下载→SHA256+推理自检→后台建索引→原子切换；状态机七态；统一契约增补 engineTier+modelIdentity；C2/C3 资产独立存放）；架构图 progressLedger 已同步（R-DUAL milestone）。
+
+## 8. 流程接线状态图（2026-08-25，向主 Agent 汇报用）
+
+```text
+                       dsh-auto-memory · M7 双轨制管线现状
+ ═════════════════════════════════════════════════════════════════════════
+  【A. JS 记忆链路 — ✅ live】
+   事件观察(M2) → evidence bridge(M5) → activation inbox(M6)
+     → Reference Tail 注入 → delivered/seen 证据闭环
+                              ▲
+                              │ offer/claim（JS 权威：scope/cross-ws/PII）
+                              │
+  【B. Python sidecar M7 — 🔶 tested/shadow，卡在「用户重启 3080」】
+   index_sync 分页建库
+     → 编码器：fp32(torch)｜int8(onnx) ←🆕 provider 已接，identity 隔离✅
+     → D6 融合(dense .7 + BM25 .3)
+     → fv2 两车道决策(shadow-candidate)：hardGates→lane→echo veto→margin
+       →回答三问：要不要(decision)/为什么(reasonCodes)/怎么唤起(lane→delivery)
+     → activation-shadow-v2.jsonl
+     ⏳ 下一步 = 用户重启 3080 → 受控 shadow(18–24 条脚本请求)
+              → active canary(仅 explicit lane) → 标 live
+                              ▲
+                              │ 相似度候选（同 D6 契约）
+                              │
+  【C. 三级语义层 — 🆕 本轮定型，C2/C3 已实测、待接线】
+   C1 词法 BM25        0GB      R@5=0.20   ✅ live（基础回退）
+   C2 JS e5-small q8   ~130MB   R@5=0.85   🆕 裁定默认档；npm 资产包分发；
+                                            首启下载弹窗+设置切换 UI 原型已出；
+                                            接线窗口=M7 live 后（避免污染 B 的对照基线）
+   C3 Python bge-m3 int8 563MB  R@5=0.925  🆕 进阶档（=fp32 质量、快 6×）；
+                                            fp32 2.3GB ⏸ 暂停使用；安装向导承载
+
+  【D. UI 资源 — 🆕 已产出】artifacts/m7-live-pre/ui-assets/semantic-tier-ui.html
+   ①首启下载进度弹窗(kind=modelDownload) ②设置内后端切换+三级列表
+   ③G-02 预留：激活记录卡+A/P/S/H/E 精修反馈组
+ ═════════════════════════════════════════════════════════════════════════
+  主 Agent 决策请求：①B 的受控 shadow 排期确认；②C2/C3 接线窗口与顺序；
+  ③lexical_pre_v3(b0.45) 是否随下个窗口采纳；④G-02 优先级。
+```
+
+## 9. 操作速查
+
+```bash
+# smoke 全量回归（28 套件串行）
+for t in smoke-test*.mjs; do node "$t" || echo FAIL $t; done
+# 策略产物审计
+D:/dsh-auto-memory/python/bench/.venv/Scripts/python.exe D:/dsh-auto-memory/python/verify_policy_artifact.py
+# held-out 打分验收复现（bench venv）
+cd artifacts/m7-live-pre/feature-v2-heldout
+D:/dsh-auto-memory/python/bench/.venv/Scripts/python.exe holdout_score_eval.py
+# 词法评测复现
+cd artifacts/m7-live-pre/lexical-tuning && node eval_lexical.mjs [variant.js]
+# sidecar 新鲜度（重启后核对运行中的 Python 是否比源码新）
+powershell: Get-CimInstance Win32_Process -Filter "Name='python.exe'" |
+  ? {$_.CommandLine -match 'worker_semantic'} | Select CreationDate
+(Get-Item D:\dsh-auto-memory\python\worker_semantic_pre_v1.py).LastWriteTime
+```
+
+已知坑位备忘：observationId 必须 `obs_pre_`+32hex；fv2 append 有界 256 行原子替换；
+dense_search 失败必须返回 []；np.float32 入 JSON 需 float() 强转；episodes 语料会被
+蒸馏清理（held-out 锚点需 anchor-recovery.json 池）；Windows 动态 import 需 file:// URL；
+bench venv 解释器 = python/bench/.venv/Scripts/python.exe（openpyxl/matplotlib 只在此环境）。