@a9i5k4/dsh-auto-memory 3.0.0 → 3.1.0

package/docs/GM53-HOMEPAGE-PROMPT.md

@@ -0,0 +1,323 @@
+# GM5.3 主页构建 Prompt（可直接粘贴）
+
+> **用法**：把本文件**全文**粘给 GM5.3。它自带全部上下文，不需要再读别的文件。
+> **产出**：一个可直接打开的静态站点（`index.html` + `assets/site.css` + `assets/site.js`）。
+> **不要问澄清问题**——所有决策已在本 prompt 内给定。
+
+---
+
+# 任务
+
+构建 **dsh-auto-memory** 的项目主页（GitHub Pages 用）。这是一个 **DeepSeek Harness（DSH）** 的记忆插件，当前版本 **3.0.0**。
+
+**交付形态**：纯静态站点，零构建、零依赖、零 CDN。产出三个文件：
+
+```
+index.html          单页，11 个 section
+assets/site.css     样式
+assets/site.js      双语切换 + 滚动揭示 + 复制按钮
+```
+
+**目标**：让一个已经在用 DSH 的人在 60 秒内相信三件事，然后去装：
+
+1. 这个插件**自己会记事**，不用你提醒它「记得记一下」
+2. 它记的东西**你能查、能改、能删**，不是黑盒
+3. 装它**没有代价**：零运行时依赖、无账号、无云端、BSD-3、跨平台
+
+---
+
+# 一、硬约束（违反即返工）
+
+## 1.1 技术约束
+
+- **零依赖**：不引 React / Vue / Tailwind / 任何 CDN / 任何 npm 包。**手写 HTML + CSS + 原生 JS**。
+- **单页**：11 个 `<section>`，锚点导航跳转，不做多页路由。
+- **双语**：所有面向用户的文案必须**中文原文 + `data-en` 属性**两套。
+  - ⚠️ **铁律**：`data-en` 元素内部**不得有任何子标签**。语言切换用 `textContent` 整体替换，子元素会被永久抹平。要在 `data-en` 元素里加粗，请把强调移到元素**之外**的兄弟节点。
+- **响应式**：1440 / 1024 / 610 / 390 四个视口都不能横向溢出。
+- **无障碍**：`<section>` 有 `aria-label`；SVG 有 `role="img"` + `aria-label`；键盘可达。
+
+## 1.2 视觉约束
+
+**色板**（DeepSeek 官方暗色体系，直接照用，不要自创）：
+
+```css
+:root {
+  --ds-bg:        #0a0a0a;   /* 页面底色 */
+  --ds-brand:     #4d6bfe;   /* 品牌蓝 */
+  --ds-brand-dark:#6799fe;   /* 亮蓝，用于 hover / 强调 */
+  --ds-brand-deep:#3a65c2;   /* 深蓝 */
+  --ds-text:      #ffffff;
+  --ds-text-2:    rgba(255,255,255,.72);
+  --ds-text-3:    rgba(255,255,255,.54);
+  --ds-surface-1: rgba(255,255,255,.04);
+  --ds-surface-3: rgba(255,255,255,.06);
+  --ds-border:    rgba(255,255,255,.10);
+  --ds-border-2:  rgba(255,255,255,.18);
+  --ds-radius-panel: 16px;
+  --ds-radius-card:  24px;
+  --ds-radius-pill:  100px;
+  --ds-blur: 12px;
+}
+```
+
+- 深色底 + 品牌蓝点缀，**玻璃质感**用 `backdrop-filter: blur(var(--ds-blur))`
+- 中文正文用系统字体栈，代码/标签用等宽
+- **每节必须有视觉元素**（SVG 示意图或图形化列表），不能只有纯文字段落
+
+## 1.3 内容约束
+
+- **每节必须有一个「怎么核」证据行** —— 一句**可当场验证**的事实（比如「打开面板的日志页签，每条自动归档都带时间戳」）。这是这个插件的调性（唤起可审计），不能省。
+- **不许出现**：厂商腔（赋能 / 极致体验 / 无缝 / 颠覆 / 引领）、空洞形容词、编造的数据。
+- **统一用「她」指代插件**（不要用「本插件」「系统」）。这是作者定的人格。
+- **诚实**：不知道的不写，没做的写「施工中」。
+
+## 1.4 法务约束（★ 四段必须分列，不得合并）
+
+页脚必须有四段，**不可合并成一句「本项目采用 XX 许可」**：
+
+| 段 | 内容 |
+|---|---|
+| **许可** | dsh-auto-memory 以 **BSD-3-Clause** 发布 |
+| **上游署名** | 三维场景结构参考 RhineLabUI / rhinelab-blog-theme（LBEILC / JesseLee-CN），**MIT**，Copyright (c) 2026 LBEILC。本项目**不包含**其三维模型、Blender 工程、原片素材或游戏品牌 |
+| **角色** | 角色设定「溟月」原作者 **上善无形**，**CC BY-NC-SA 4.0**——非商业衍生并署名、以同协议共享。该许可与上述代码许可**相互独立且更严格** |
+| **免责** | DeepSeek Harness 社区插件，与 **DeepSeek 官方无关**，与上述参考仓库作者亦无隶属关系 |
+
+---
+
+# 二、逐页内容（11 节）
+
+> 每节结构：**标题/一句话** → **人话正文** → **示意** → **「怎么核」证据行**
+
+---
+
+## §01 · 首屏 HERO
+
+**主张**：无问自忆，且件件可查。
+
+**正文（中文原文）**：
+> 你不用交代她「记得记一下」。她自己留意、自己归档，在该用上的时候自己想起来——每次想起都带一条你能读、能评、能改的证据。上下文写满时，她也不把自己压缩成一段摘要：合上一本写满批注的笔记，翻开新的一页。
+
+**必备元素**：
+- 安装命令 `pnpm add @a9i5k4/dsh-auto-memory@latest` + **复制按钮**
+- 五个事实芯片：`v3.0.0` · `BSD-3-Clause` · `零运行时依赖` · `Windows / macOS / Linux` · `中英双语`
+- 一张四步闭环 SVG：**你说话 → 她留意 → 归档 → 想起来（带证据链）**，中心标注「零指令，不需要」
+
+**怎么核**：打开面板的「概览」页签，安装向导第一步会把每个开关讲一遍。
+
+---
+
+## §02 · 她做六件事（全站导航骨架）
+
+**一句话**：看完这六条，你就了解这个插件了。下面都是细节。
+
+**六张卡片**（可点跳转到 §03–§08）：
+
+| # | 标题 | 一句话 |
+|---|---|---|
+| ① | 她自己记 | 不用你说「记得记一下」。她留意、归档，并在该用上时自己想起来。 |
+| ② | 每条都查得到 | 每次想起都带证据链：能读、能评、能改、能删。全在你自己盘上。 |
+| ③ | 三层分工 | 硬规矩、项目笔记、每日流水。常驻注入 + 按需检索，各管各的。 |
+| ④ | 她替你记日子 | 对话里的截止日期与承诺，她记进日历，到点提醒你。 |
+| ⑤ | 能搬，也不串味 | 别的 AI 工具的记忆能搬进来；多个项目并行互不打扰。 |
+| ⑥ | 脏东西进不来 | 乱码、卡顿、JSON 注入在写入时就被拦；凭据不进提示词；每个功能单独可关。 |
+
+**怎么核**：每张卡片点进去都能看到该节自己的「怎么核」那一行。
+
+---
+
+## §03 · ① 她自己记
+
+**正文**：
+> 你不用记得去告诉她「要记住」。每一轮结束，一个安静的子代理会读一遍刚发生的事，把值得留的按主题归档——不是往一堵墙上继续堆。等这些内容重新变得相关时，宿主会在上下文的固定边界把它们注入进去。模型不需要「想起来去查」，你的前缀缓存也不会被打散。
+
+**要点四条**：
+- 你没有任何「记得要做」的动作——根本没有一个会忘的保存键
+- 按主题成组，一周后翻出来仍像笔记，不是一堆流水
+- 固定边界注入，前缀缓存友好，不会每轮全量重算
+- 窗口写满时她写一份交接账本，而不是把自己压缩掉
+
+**示意**：上下文窗口右段高亮「她想起的」+ 上方标「固定边界」；下方三步链：读这一轮 → 按主题成组 → 落盘归档
+
+**怎么核**：打开面板的**日志页签**，每条自动归档都带时间戳，并标明来自哪一轮。
+
+---
+
+## §04 · ② 每条都查得到
+
+**正文**：
+> 查不到源头的记忆就是传闻。每次唤起都带完整证据链：哪几条被激活、依据是什么、分数多少。你可以在「唤起回顾」里逐条评分——评分会回流到晋升判定，所以差了会越来越安静，好用的会越来越牢。没有黑盒，也没有任何东西离开你的磁盘。
+
+**要点四条**：
+- 你能在一条错记忆悄悄影响后面几个月之前就抓出它
+- 评分就是反馈回路——技能就是这样挣到晋升的
+- 凭据不进提示词：写入前卫生检查会剥掉
+- 一切都在你本地磁盘；没有账号，没有云端
+
+**示意**：一次唤起 → 展开证据链（来源条目 / 命中依据 / 评分）→ 四个动作：读、评、改、**删**（删高亮）
+
+**怎么核**：唤起回顾页签 → 任选一次唤起 → 能看到它的来源与评分；改或删立即生效。
+
+---
+
+## §05 · ③ 三层分工
+
+**正文**：
+> 她记的东西分三层放，放在哪一层，决定它怎么进入模型。硬规矩每一轮都进——没有例外。项目笔记住在常驻目录里，随手可用但不吃窗口。每日日志平时不占地方，真需要的时候才被拉进来。
+
+**三层 × 三种到达方式**：
+
+| 层 | 内容 | 到达方式 |
+|---|---|---|
+| 用户级硬约束 | 「绝不要 X」「永远用中文答」——你自己定的 | **每轮无条件注入**（不做相关性判断） |
+| 项目级笔记 | 决策、架构、约定——本来要反复解释的东西 | **常驻目录 + 命中即用**（≤400 token） |
+| 每日日志 | 今天发生了什么，带时间戳 | **仅按需检索**（不进窗口，直到被需要） |
+
+**要点**：你把东西放进哪一层，本身就是调度决策。你不需要手工调注入策略。
+
+**示意**：三层堆叠 + 三条箭头指向模型，箭头粗细表示注入频率
+
+**怎么核**：设置页显示每一层当前占多少 token；规则层有可视化编辑器；笔记层显示常驻目录体积。
+
+---
+
+## §06 · ④ 她替你记日子
+
+**正文**：
+> 截止日期、约好的时间、顺口一说就忘的承诺，都是在聊别的事的时候被顺手记下的——「周五交报告」「下周给你发过去」。它们会带着解析好的日期进日历，并在**日期到之前**回来找你，不是之后。
+
+**要点四条**：
+- 明确日期：「10 月 4 日前」「30 号」
+- 相对日期：「下周」「三天后」——按今天换算
+- 时间与象限：截止时刻和重要度一并记下
+- 你对别人许的承诺，不只是你自己的任务
+
+**示意**：对话里一句话 → 解析成 `2026-11-01 23:59 · 重要不紧急` → 标注「日期到之前回来找你」
+
+**怎么核**：问一句「我最近有什么安排」，她会从日历文件里读回来——那个文件你自己也能打开看。
+
+---
+
+## §07 · ⑤ 能搬，也不串味
+
+**正文**：
+> 如果你已经在别的 AI 工具里干过活，那段历史不用重来。她会扫描 **WorkBuddy、CodeBuddy、Claude Code、Codex、ZCode、Kimi Code、TRAE** 留下的记忆，按来源分别导入——进哪些你挑，事后也能把一个来源整个撤掉。另一半是反过来的：并行的工作区和会话各自保留自己的召回决策与索引缓存，你跟她讲过的工作上的事，不会串到另一个小项目里去。
+
+**要点四条**：
+- 扫描是**只读**的，在你点确认之前不会写任何东西
+- 按来源分列，进哪些你挑
+- 一个来源可以整个撤掉
+- 全局层（硬规矩）是**故意共享**的——那是你的长期约束；其余全部按工作区隔离
+
+**示意**：左四个外部工具 → 中间「扫描 + 逐源导入」→ 右侧项目 A / 项目 B 各自隔离，中间画 ╳
+
+**怎么核**：设置 → 外部记忆，会先列出检测到的每个来源及其路径与体积，**在你点确认之前不会写任何东西**。
+
+---
+
+## §08 · ⑥ 脏东西进不来
+
+**正文**：
+> 一个会写垃圾的记忆插件还不如没有。每次写入都先过闸门：乱码、卡顿输出、JSON 形状的注入都在那里被拦下；任何像凭据的东西在进入提示词之前就被剥掉。在那之上，每个功能是独立开关——你可以让它全自动跑，也可以只关掉某一项、其余照旧。
+
+**闸门拦三类**：乱码 / 卡顿与重复输出 / JSON 注入 → **丢弃 + 留痕**（不静默）
+
+**要点四条**：
+- 关掉提醒不影响召回；关掉召回不影响规矩（**开关互不牵连**）
+- 无人值守模式整圈自动跑、不弹任何确认，挂着机也能用
+- 任何模型开箱可用：词法档 0 GB 起步，内置 JS 语义档约 130 MB
+- Python int8 进阶档（约 563 MB）是向导式可选安装，**永远不是前置条件**
+
+**怎么核**：设置里每个功能各占一行、各有独立开关，点一下标签立刻翻面。
+
+---
+
+## §09 · 亮点页入口
+
+**一句话**：把它当成一间屋子，而不是一页纸。
+
+**正文**：
+> 三维档案终端把同样的内容变成一个能走进去的阵列：五列、四十份档案，方向键移动，拖拽环绕。选中的卡片会向镜头抬起，解密线随之合拢。它读的是和本页同一份数据——是同一个插件的另一种看法，不是另一个插件。
+
+**必须诚实标注**：需要 WebGL；**当前施工中**，不支持时自动退回本页这种可读版。
+
+**怎么核**：入口指向一个说明页，写清了还差哪三件事。
+
+---
+
+## §10 · 安装
+
+**STEP 01 安装**（两条命令都给）：
+```
+pnpm add @a9i5k4/dsh-auto-memory@latest
+npm i @a9i5k4/dsh-auto-memory@latest
+```
+提示：pnpm v11 的 `minimumReleaseAge` 默认 24 小时，可能拦下刚发布的版本——设为 0 或写死版本号。
+
+**STEP 02 重启 DSH** —— 侧栏出现「记忆」入口。无账号、无云端、不上传任何东西。
+
+**STEP 03 30 秒验证** —— 说一件带日期的事（「周五交报告」），再问「我最近有什么安排」。日期答得出来，整条链路就是通的。
+
+**手册四链**：用户手册（中）/ User guide (EN) / Changelog / Issues
+
+---
+
+## §11 · 已知边界（五条）
+
+> **这一页不是自黑，是信任凭证。** 保留、不要删、不要减少。
+
+1. 交接白板与水位感知是实验特性。**白板与账本 3.0 起默认开启**；自动接续默认关闭。
+2. 语义档可选。内置 JS 语义档（约 130 MB）是默认值、无需配置；Python int8 进阶档（约 563 MB）走向导安装。
+3. 面板 API 仅监听本机回环地址。外部访问返回 401 属预期行为，**不是故障**。
+4. 三维档案终端需要 WebGL。不支持时会退回可读版——信息不丢，只是没有三维呈现。
+5. 首屏角色的 24 fps 序列帧尚未交付；目前是内联 SVG 线稿，挂载位已按交付契约预埋。
+
+**怎么核**：白皮书里每个数字都标注了代码出处。
+
+---
+
+# 三、功能底表（供取用，主页只展示上面 6 组）
+
+**规模数字（必须准确）**：`17 个模型工具` · `49 条 HTTP 路由` · `98 个配置键`（其中 60 可写）· `12 个面板页签` · `6 处插槽` · `0 运行时依赖`
+
+**12 个页签**：概览 / 日志 / 唤起回顾 / 记忆中枢 / 存储管理 / 笔记 / 白板 / 反思 / 接续 / 日历 / 检索 / 工作区
+
+**39 条能力分组**（主页只在 §02 展示 6 组）：
+
+- **A 记忆沉淀（5）**：全自动记忆沉淀 · 三层本地记忆 · 做梦式定时固化（每日 09:30）· 30 天蒸馏（每日 10:00）· 每日反思
+- **B 检索与召回（5）**：跨会话记忆检索 · 两段式省 token 检索（L0 摘要 → 按 id 展开）· 分层语义检索（词法 + 语义 RRF 融合）· 历史会话全文检索 · 外部 AI 工具记忆继承（7 种工具）
+- **C 注入与上下文（5）**：自动记忆注入（预算可调）· Tier-0 常驻目录（400 token 预算 / 占注入 25%）· 用户级硬性约束规则层 · 精简注入节奏（每 N 轮完整快照）· 结论生命周期（superseded / retracted / restore）
+- **D 白板与接续（6）**：项目白板 PLAN.md · 四段式交接账本 · 白板看板（5 泳道）· 白板溯源工具 · 自动接续 · 上下文水位提示
+- **E 技能库（4）**：模型直写技能 · 晋升门槛与审批（observed→candidate→validated→active）· 自动导出 SKILL.md · 审批界面人话化
+- **F 面板与界面（10）**：12 页签记忆面板 · 用户级硬性约束可视编辑 · 主动联想记忆 · 唤起回顾打分闭环 · 工作区地图 · 用户级日历 · 首启欢迎向导 · 安装向导与环境检测 · 双语界面 · 面板字号可调
+- **G 工程保障（4）**：写入闸门 · 凭据不进提示词 · 一切皆开关 · 工作区隔离
+
+---
+
+# 四、交付要求
+
+1. **三个文件直接可跑**：双击 `index.html` 就能看，不需要服务器、不需要构建。
+2. **`assets/site.js` 必须实现**：
+   - 语言切换（读 `data-en`，`textContent` 整体替换；当前语言存 `localStorage`）
+   - 滚动揭示（IntersectionObserver，`threshold: 0.15`，加 `.in` 类）
+   - 复制按钮（`navigator.clipboard`，成功后按钮文字变「已复制」）
+   - ⚠️ 尊重 `prefers-reduced-motion`
+3. **占位页**：§09 的入口指向 `lab/index.html`。也请生成这个页面，内容是**真实说明**「三维档案终端施工中，还差哪三件事」，**不要**留死链。
+4. **不要把角色定妆稿放首屏** —— 那是给画师看的交付契约，不是给访客看的。
+
+---
+
+# 五、自查清单（交付前逐条过）
+
+- [ ] 四个视口（1440/1024/610/390）都无横向滚动
+- [ ] 所有 `data-en` 元素内部**没有**子标签
+- [ ] 所有 `href="#xxx"` 的锚点在页面里都存在
+- [ ] §11 的五条边界**一条不少**
+- [ ] 法务四段**分列**，未合并
+- [ ] 每一节都有「怎么核」证据行
+- [ ] 无 CDN、无外链 JS/CSS、无 npm 依赖
+- [ ] 切到英文后页面文字完整可读，无丢字
+
+---
+
+**开始构建。产出后请报告：三个文件的行数、四个视口的自查结果、以及任何你做了但本 prompt 没要求的设计决策。**

package/docs/HANDBOOK.md

@@ -1,8 +1,8 @@
 # dsh-auto-memory 接手与全量验证手册（自包含）
 
 > **适用对象**：完全不了解本项目与插件背景的新 Agent。只凭本文件即可接手操作并完成全量验证。
-> **版本基准**：插件 v2.2.6（BSD-3-Clause）／DSH v0.1.2-rc.1／Windows。
-> **最后核对**：2026-09-10（以代码与 DSH CLI help 原文为准）。
+> **版本基准**：插件 v3.0.1（BSD-3-Clause，版本号以 `package.json` 为准）／DSH v0.1.2-rc.1／Windows。
+> **最后核对**：2026-09-22（以代码与 DSH CLI help 原文为准；本手册的路径类事实统一按「发布名」口径重取，见 §0 命名口径）。
 
 ---
 
@@ -10,13 +10,14 @@
 
 | 术语 | 全称 / 含义 |
 |---|---|
-| **DSH** | **DeepSeek Harness**，宿主应用。以 CLI `dsh` 启动，提供浏览器 UI（`dsh web`）与插件装载能力。本机安装在 `C:\Users\JH Z\AppData\Roaming\npm\node_modules\@deepseek-ai\dsh` |
+| **DSH** | **DeepSeek Harness**，宿主应用。以 CLI `dsh` 启动，提供浏览器 UI（`dsh web`）与插件装载能力。Windows 默认装在 `%APPDATA%\npm\node_modules\@deepseek-ai\dsh`（**不要写死某个用户名**） |
 | **Cordis** | DSH 使用的插件框架（`@deepseek-ai/cordis ^4.0.1`）。本插件是 Cordis 插件，通过 `cordis.patch.yml` 注入宿主 |
 | **本插件** | `dsh-auto-memory`，包名同名，工程根目录 `D:\dsh-auto-memory` |
-| **pre 线 / `-pre.js`** | 源码约定：新增模块一律命名为 `lib/xxx-pre.js`（纯函数、零 IO、IO 注入）。发布时由流水线剥去 `-pre` 生成同名 `lib/xxx.js`。**改源码改 `-pre.js`；`lib/xxx.js` 是产物，禁止手改** |
+| **pre 线 / `-pre.js`** | 源码约定：新增模块一律命名为 `lib/xxx-pre.js`（纯函数、零 IO、IO 注入）。发布时由 `tools/release.mjs` 的**转换表**剥去 `-pre` 生成同名 `lib/xxx.js`。**改源码改 `-pre.js`；`lib/xxx.js` 是产物，禁止手改** |
+| **命名口径（发布名 vs pre 名）** | 同一份身份在两条线上拼写不同，**本手册正文一律给「发布名」——即用户实际装到的那个**；pre 开发树各加 `-pre`。成对关系：端点前缀 `/api/dsh-auto-memory/` ↔ `/api/dsh-auto-memory-pre/`；诊断日志 `dsh-auto-memory-diagnose.log` ↔ `dsh-auto-memory-pre-diagnose.log`；配置 `dsh-auto-memory.json` ↔ `dsh-auto-memory-pre.json`；目录 `memory/hub/` ↔ `memory/hub-pre/`、`memory/evidence/` ↔ `memory/evidence-pre/`、`memory/index/` ↔ `memory/index-pre/`、`memory/semantic/` ↔ `memory/semantic-pre/`。**★例外：`memory/degrade-pre/` 转换表里没有对应规则 ⇒ 发布物里仍叫 `degrade-pre`，不要改成 `degrade`**。依据：`tools/release.mjs` 转换表 + 已发布产物 `D:\dsh_debug\_publish_dsh-auto-memory\lib\index.js` |
 | **宿主侧 / 后端** | `lib/index.js`，运行在 Node 进程里，负责存储、检索、端点、工具、调度 |
 | **浏览器侧 / 前端** | `lib/client.js`，注入到 DSH 浏览器 UI，负责面板与设置页 |
-| **工具（tool）** | 供模型调用的函数（类似 MCP 工具）。本插件注册 10 个，统一以 `_pre` 结尾 |
+| **工具（tool）** | 供模型调用的函数（类似 MCP 工具）。本插件注册 **17 个**；pre 树名字以 `_pre` 结尾，发布名去掉 `_pre`（如 `memory_recall`） |
 | **水位（water level）** | 当前会话上下文占用比例（0–1）。用于决定何时触发接续 |
 | **接续 / handoff** | 上下文将满时，把进度交接给一个新会话继续工作的机制 |
 | **主动联想** | 不等用户询问，由系统主动判断"该想起什么"并注入上下文——本插件的核心差异化能力 |
@@ -26,7 +27,7 @@
 | **BM25** | 经典词法相关性算法 |
 | **M8 / 记忆中枢** | 三层记忆存储（fact 事实／episodic 经历／procedure 技能）与编排器 memory-hub 的合称 |
 | **evidence（证据）** | 记忆被使用情况的记录，六类：`seen`（曝光）／`read`（读到原文）／`cite`（回复引用）／`reuse`（跨会话复用）／`success`（任务成功）／`correction`（用户纠正） |
-| **endpoint / 端点** | 后端 HTTP 接口，路径前缀统一为 `/api/dsh-auto-memory-pre/` |
+| **endpoint / 端点** | 后端 HTTP 接口，路径前缀统一为 `/api/dsh-auto-memory/`（pre 树为 `/api/dsh-auto-memory-pre/`），共 49 条 |
 
 ---
 
@@ -35,7 +36,7 @@
 本插件给 DSH 加一套**长期记忆系统**：记忆以 Markdown 文件存放在用户目录下，插件负责写入、检索、在合适时机主动提醒模型，并在上下文将满时把进度交给新会话。
 
 - 工程根：`D:\dsh-auto-memory`
-- 源码：`lib/index.js`（宿主侧，约 8000 行）、`lib/client.js`（浏览器侧）、`lib/*-pre.js`（各纯核心模块，58 个文件）
+- 源码：`lib/index.js`（宿主侧，约 11,600 行）、`lib/client.js`（浏览器侧）、`lib/*-pre.js`（各纯核心模块，62 个文件）
 - 发布产物：`lib/`（含剥名后的 `.js`）、`python/`、`docs/`、`cordis.patch.yml`
 - 运行时依赖：**零**。`dependencies` 为空；peer 为 cordis；optional 为 transformers
 
@@ -74,28 +75,34 @@ dsh web --no-open --port 0
 │  · 语义引擎环境检测面板                                      │
 │  仅负责「展示 + 收集用户操作」，通过 DSH 远程 API 调用后端    │
 └───────────────┬───────────────────────────────────────────┘
-                │ HTTP /api/dsh-auto-memory-pre/*
+                │ HTTP /api/dsh-auto-memory/*（pre 树为 /api/dsh-auto-memory-pre/*）
 ┌───────────────▼───────────────────────────────────────────┐
 │ 宿主侧（后端）lib/index.js + lib/*-pre.js                   │
-│  · 端点路由（39 个）                                         │
-│  · 工具（10 个，供模型调用）                                  │
+│  · 端点路由（49 个）                                         │
+│  · 工具（17 个，供模型调用）                                  │
 │  · 存储：记忆文件、M8 三层 JSON、evidence 事件 JSONL          │
 │  · 检索：C1 词法 / C2 语义 / C3 Python 语义                  │
 │  · 决策：主动联想门控、接续调度、水位监测                      │
 └───────────────┬───────────────────────────────────────────┘
                 │ 读写
 ┌───────────────▼───────────────────────────────────────────┐
-│ 磁盘 C:\Users\JH Z\.dsh\memory\                             │
-│  · workspaces\<工作区>\*.md       记忆日志/笔记/白板/账本     │
-│  · hub-pre\episodes|facts|procedures.json   M8 三层          │
-│  · evidence-pre\events\YYYY-MM-DD.jsonl     证据事件（按日）  │
-│  · dsh-auto-memory-pre-diagnose.log         诊断日志         │
+│ 磁盘 ~/.dsh/（Windows：%USERPROFILE%\.dsh\）                 │
+│  · memory\workspaces\<工作区>\*.md   日志/笔记/白板/账本     │
+│  · memory\hub\episodes|facts|procedures.json   M8 三层       │
+│  · memory\evidence\events\YYYY-MM-DD.jsonl   证据事件（按日） │
+│  · （诊断日志**不在本目录**，见 §5.2）                        │
 └────────────────────────────────────────────────────────────┘
 ```
 
+> ⚠️ **诊断日志的位置**：`~/.dsh/dsh-auto-memory-diagnose.log` —— 它与 `memory/` **同级**，不在 `memory/` 里面
+> （代码依据：`lib/index.js` 里是 `path.join(dshHome(), 'dsh-auto-memory-pre-diagnose.log')`，没有 `'memory'` 这一段）。
+> 打包日志时先确认文件存在再交：`ls -l ~/.dsh/*diagnose*.log`
+
+```
+
 **数据流向（一次典型记忆检索）**：
 
-1. 模型调用工具 `memory_recall_pre`（或前端点选）→ 宿主侧 `recall()`
+1. 模型调用工具 `memory_recall`（pre 树 `memory_recall_pre`；或前端点选）→ 宿主侧 `recall()`
 2. `recall()` 构建 L0 语料（从日志/反思/笔记抽取摘要）
 3. 词法臂（C1）打 L0、语义臂（C2）打 L0；若查询含时间表达，追加时间臂
 4. 三臂经 `rankFusionRRFPre`（rank-space，k=60）融合排序
@@ -125,7 +132,7 @@ dsh web --no-open --port 0
 
 - **位置**：记忆窗格内的「记忆中枢」页签
 - **内容**：技能（procedure）／事实（fact）／经历（episodic）三栏
-- **预期**：有内容时显示条目；无内容显示正确空态；数据来自 `hub-pre\*.json`
+- **预期**：有内容时显示条目；无内容显示正确空态；数据来自 `memory\hub\*.json`（pre 树为 `memory\hub-pre\*.json`）
 
 ### 4.3 设置分组（`data-dam-settings-group`）
 
@@ -147,7 +154,7 @@ dsh web --no-open --port 0
 | `procedurePromotionEnabled` | false | 开启 → 技能晋升可用 |
 | `unattendedMode` / `awayMinutes` | false / 60 | 无人值守相关（**设置页 UI 尚未核实，属待办**） |
 
-> ⚠️ 修改设置后需要**重载/重启 dsh web**才生效的场景，以实际观察为准；若改完无变化，先查 `/api/dsh-auto-memory-pre/config` 是否已回写。
+> ⚠️ 修改设置后需要**重载/重启 dsh web**才生效的场景，以实际观察为准；若改完无变化，先查 `/api/dsh-auto-memory/config`（pre 树 `/api/dsh-auto-memory-pre/config`）是否已回写。
 
 ### 4.4 语义引擎环境检测面板（`data-dam-detect-panel`）
 
@@ -162,7 +169,7 @@ dsh web --no-open --port 0
 
 ## 5. 后端状态来源（如何确认前端操作已生效）
 
-### 5.1 主要端点（`lib/index.js` 注册，共 39 个，前缀 `/api/dsh-auto-memory-pre/`）
+### 5.1 主要端点（`lib/index.js` 注册，共 **49** 条，前缀 `/api/dsh-auto-memory/`）
 
 | 端点 | 用途 | 关键返回字段 |
 |---|---|---|
@@ -171,7 +178,7 @@ dsh web --no-open --port 0
 | `state` | 运行状态总览 | 水位、启用状态等 |
 | `debug` | 调试视图 | 含 `shadowRetrieval` 等 |
 | `semantic-status` / `semantic-emit` / `semantic-download` | 语义引擎状态/发射/下载 | 档位、模型状态 |
-| `activation-inbox-pre` | 激活收件箱 | 候选与投递记录 |
+| `activation-inbox` | 激活收件箱 | 候选与投递记录 |
 | `auto-continue-state` / `auto-continue-decide` / `handoff-continue` | 接续状态与决策 | 水位、是否触发、材料层 |
 | `smart-recall` | 智能检索 | 命中列表 |
 | `storage-manage` | 存储管理 | 文件/统计 |
@@ -179,19 +186,36 @@ dsh web --no-open --port 0
 | `update` / `update-check` | 更新 | 版本信息 |
 | `calendar`、`file`、`browse-dir`、`external*`、`summarize`、`shadow-recent`、`subagent-gc`、`greet` | 其余辅助端点 | — |
 
-> 端点名以代码为准：`grep -oE "'/api/dsh-auto-memory-pre/[a-z0-9-]+'" lib/index.js | sort -u`
+> 端点名与条数以代码为准（**一条命令自核**，`49` 与 `/api/dsh-auto-memory/` 都由它推出，不是写死的）：
+>
+> ```bash
+> node -e "const f=require('fs');const s=f.readFileSync('lib/index.js','utf8'),r=f.readFileSync('tools/release.mjs','utf8');const P=[...r.matchAll(/\['([^']+)',\s*'([^']+)'\]/g)].map(m=>[m[1],m[2]]);const c=x=>P.reduce((a,[b,d])=>a.split(b).join(d),x);const e=[...new Set([...s.matchAll(/'(\/api\/dsh-auto-memory[^']*)'/g)].map(m=>m[1]))];console.log('端点条数:',e.length);console.log('发布名前缀:',c(e[0]).split('/').slice(0,3).join('/')+'/')"
+> ```
+>
+> 在工程根执行，输出应为 `端点条数: 49` / `发布名前缀: /api/dsh-auto-memory/`。命令读的是**源码 + 发布转换表**，所以两条线的拼写都能对上。
 
 ### 5.2 日志
 
-- **诊断日志**：`C:\Users\JH Z\.dsh\memory\dsh-auto-memory-pre-diagnose.log`
+- **诊断日志**：`~/.dsh/dsh-auto-memory-diagnose.log`（Windows：`%USERPROFILE%\.dsh\dsh-auto-memory-diagnose.log`）
+  - **★它不在 `memory/` 下面**：代码是 `path.join(dshHome(), 'dsh-auto-memory-pre-diagnose.log')`（pre 树），无 `'memory'` 段
   - 关键线索：插件加载异常、`diag(...)` 输出的降级与状态（如 `hub success evidence: +N`、`p9a correction attribution: ...`）
-- **证据事件**：`C:\Users\JH Z\.dsh\memory\evidence-pre\events\YYYY-MM-DD.jsonl`
+- **证据事件**：`~/.dsh/memory/evidence/events/YYYY-MM-DD.jsonl`（pre 树为 `~/.dsh/memory/evidence-pre/events/`）
   - 单行结构（实测）：顶层 `kind` / `memoryId` / `recordedAt` / `anchorId` …，**时间戳在 `event.ts`**（顶层无 `ts`/`createdAt`）
-- **M8 数据**：`C:\Users\JH Z\.dsh\memory\hub-pre\{episodes,facts,procedures}.json`（原子写）
+- **M8 数据**：`~/.dsh/memory/hub/{episodes,facts,procedures}.json`（原子写；pre 树为 `memory/hub-pre/`）
+- **降级台账**：`~/.dsh/memory/degrade-pre/latest.json` —— ★**这条没有发布名，两条线都叫 `degrade-pre`**，见下方自核
+
+> **一条命令自核上面 4 条路径的「发布名」**（读源码 + 发布转换表，所以两条线都对得上）：
+>
+> ```bash
+> node -e "const f=require('fs');const s=f.readFileSync('lib/index.js','utf8'),r=f.readFileSync('tools/release.mjs','utf8');const P=[...r.matchAll(/\['([^']+)',\s*'([^']+)'\]/g)].map(m=>[m[1],m[2]]);const c=x=>P.reduce((a,[b,d])=>a.split(b).join(d),x);const d=s.match(/'dsh-auto-memory[^']*diagnose\.log'/)[0].slice(1,-1);console.log('诊断日志(发布名):',c(d));for(const k of ['hub-pre','evidence-pre','index-pre','semantic-pre','degrade-pre'])console.log('  ',k,'->',c(k))"
+> ```
+>
+> 输出应为：`诊断日志(发布名): dsh-auto-memory-diagnose.log`，以及 `hub-pre -> hub`、`evidence-pre -> evidence`、
+> `index-pre -> index`、`semantic-pre -> semantic-pre`、**`degrade-pre -> degrade-pre`**（最后一行就是「不能整体替换」的证据）。
 
 ### 5.3 「前端操作 → 后端确认」判定方法（通用三步）
 
-1. **操作前**取基线快照：`GET /api/dsh-auto-memory-pre/config`（或 `state`）+ 记录相关文件条目数/修改时间
+1. **操作前**取基线快照：`GET /api/dsh-auto-memory/config`（或 `state`）+ 记录相关文件条目数/修改时间
 2. **在前端执行操作**（改开关、点按钮）
 3. **操作后再取**：对比配置值是否变化、端点返回是否变化、磁盘文件 mtime/条数是否变化
 
@@ -200,27 +224,37 @@ dsh web --no-open --port 0
 **示例（改 `memoryHubEnabled`）**：
 
 ```
-改前：GET /config → memoryHubEnabled=false；hub-pre\*.json 无新写入
+改前：GET /config → memoryHubEnabled=false；memory/hub\*.json 无新写入
 前端：开启「记忆中枢」开关
-改后：GET /config → memoryHubEnabled=true；对话若干轮后 hub-pre\*.json mtime 更新、条目增加
+改后：GET /config → memoryHubEnabled=true；对话若干轮后 memory/hub\*.json mtime 更新、条目增加
 ```
 
 ---
 
-## 6. 工具（模型可调用，10 个）
+## 6. 工具（模型可调用，17 个）
 
-| 工具 | 作用 |
-|---|---|
-| `memory_recall_pre` | 记忆检索（默认返回 L0，`expand` 展开原文） |
-| `memory_read_pre` | 按锚点读取记忆原文 |
-| `memory_note_pre` | 写入记忆（含 `kind` 区分日志/笔记/白板 `plan`/账本 `handoff` 等） |
-| `memory_log_pre` | 记录日志条目 |
-| `memory_reflect_pre` | 生成反思 |
-| `memory_consolidate_pre` | 记忆巩固 |
-| `memory_maintain_pre` | 存储维护 |
-| `memory_status_pre` | 状态查询 |
-| `memory_user_pre` | 用户级记忆读写 |
-| `memory_external_pre` | 外部记忆源管理 |
+> 下表给的是**发布名**；pre 树各加 `_pre` 后缀（`memory_recall` ↔ `memory_recall_pre`）。
+> 自核（数一遍源码里的注册调用）：`node -e "const s=require('fs').readFileSync('lib/index.js','utf8');const n=[...s.matchAll(/defineTool\('([a-z_]+)'/g)].map(m=>m[1]);console.log(n.length,'个:',n.sort().join(' '))"`
+
+| 工具（发布名） | pre 树名 | 作用 |
+|---|---|---|
+| `memory_recall` | `memory_recall_pre` | 记忆检索（默认返回 L0，`expand` 展开原文） |
+| `memory_read` | `memory_read_pre` | 按锚点读取记忆原文 |
+| `memory_note` | `memory_note_pre` | 写入记忆（含 `kind` 区分日志/笔记/白板 `plan`/账本 `handoff` 等） |
+| `memory_log` | `memory_log_pre` | 记录日志条目 |
+| `memory_reflect` | `memory_reflect_pre` | 生成反思 |
+| `memory_consolidate` | `memory_consolidate_pre` | 记忆巩固 |
+| `memory_maintain` | `memory_maintain_pre` | 存储维护（30 天蒸馏） |
+| `memory_status` | `memory_status_pre` | 状态查询 |
+| `memory_user` | `memory_user_pre` | 用户级记忆读写 |
+| `memory_external` | `memory_external_pre` | 外部记忆源管理（list / import） |
+| `memory_procedure` | `memory_procedure_pre` | 流程（技能）直写：write 进审批列表 / activate 写入+晋升+激活 |
+| `memory_expand` | `memory_expand_pre` | 白板结构化展开（需 `boardMode=graph`） |
+| `memory_trace` | `memory_trace_pre` | 白板结构化回溯（需 `boardMode=graph`） |
+| `calendar_add` | `calendar_add_pre` | 添加日历事项 |
+| `calendar_list` | `calendar_list_pre` | 列出日历条目 |
+| `calendar_done` | `calendar_done_pre` | 标记日历条目完成 |
+| `calendar_remove` | `calendar_remove_pre` | 删除日历条目 |
 
 ---
 
@@ -228,6 +262,7 @@ dsh web --no-open --port 0
 
 > **通用前置**：`dsh web --no-open` 已启动；插件已装载；已确认端口并手动打开 UI。
 > **通用通过标准**：每一步都要有**证据**（截图 / 日志原文 / 数据快照）。禁止"看起来正常"这类无证据结论。
+> ★**端点写法**：本节一律写发布名 `GET /api/dsh-auto-memory/xxx`；**在 pre 开发树里跑要换成 `/api/dsh-auto-memory-pre/xxx`**（别把手册里的写法当成 pre 树的写法）。工具名同理（`memory_recall` ↔ `memory_recall_pre`）。
 
 ### A. 启动与装载
 
@@ -235,14 +270,14 @@ dsh web --no-open --port 0
 |---|---|---|---|
 | A1 | — | `dsh web --no-open` | 终端打印监听地址；**没有自动弹出浏览器** |
 | A2 | A1 | 查看诊断日志与终端输出 | 无 `SyntaxError` / `ReferenceError` / 模块加载失败 |
-| A3 | A2 | `GET /api/dsh-auto-memory-pre/state` | 返回 200 且含状态字段 |
+| A3 | A2 | `GET /api/dsh-auto-memory/state` | 返回 200 且含状态字段 |
 
 ### B. 记忆检索主流程
 
 | # | 步骤 | 通过标准 |
 |---|---|---|
-| B1 | 调用 `memory_recall_pre` 查一个常见主题 | 返回 L0 列表，含 `id`/`score`/`match_reason` |
-| B2 | 用返回的 `id` 调 `expand="mem_xxx"`（或 `memory_read_pre`） | 能取到对应原文，且**不串条** |
+| B1 | 调用 `memory_recall` 查一个常见主题 | 返回 L0 列表，含 `id`/`score`/`match_reason` |
+| B2 | 用返回的 `id` 调 `expand="mem_xxx"`（或 `memory_read`） | 能取到对应原文，且**不串条** |
 | B3 | **语义验证**：查一个词法不重合但语义相关的查询（如记忆里写"npm 发布报 ENEEDAUTH"，查"发布凭证问题"） | 能召回。若失败，切 `legacy` 融合再测对比；legacy 正常而 rrf 失败 = **P8 回归，停止** |
 | B4 | **时间臂验证**：查含时间表达的查询（如"上周"），再查一条不含时间词的同类查询做对照 | 含时间词 → 对应时间段条目排序上升；不含时间词 → 排序与对照一致（**零行为变更**） |
 | B5 | 异常：查一个明显不存在的主题 | 不报错，返回空或弱命中，不阻塞 |
@@ -258,16 +293,16 @@ dsh web --no-open --port 0
 
 | # | 步骤 | 通过标准 |
 |---|---|---|
-| D1 | `GET /api/dsh-auto-memory-pre/memory-hub` | 200，含 `policyVersion`/`stats`/三栏数据 |
+| D1 | `GET /api/dsh-auto-memory/memory-hub` | 200，含 `policyVersion`/`stats`/三栏数据 |
 | D2 | 打开记忆窗格 → 记忆中枢页签 | 三栏有内容或正确空态 |
 | D3 | 关闭 `memoryHubEnabled` → 重载 → 对话若干轮 | 无新落盘；端点反映未启用 |
-| D4 | 重新开启 → 对话若干轮 | `hub-pre\*.json` 有新条目 |
+| D4 | 重新开启 → 对话若干轮 | `memory/hub\*.json` 有新条目 |
 
 ### E. 证据链
 
 | # | 步骤 | 通过标准 |
 |---|---|---|
-| E1 | 对话若干轮后查看当日 `evidence-pre\events\*.jsonl` | 新增 `seen` 事件 |
+| E1 | 对话若干轮后查看当日 `memory/evidence\events\*.jsonl` | 新增 `seen` 事件 |
 | E2 | 触发一次用户纠正（对话里说"不对，你记错了"之类） | 新增 `kind:"correction"` 事件（且归因到最近被 cite/read 的记忆） |
 | E3 | 异常：events 目录缺失/损坏 | 检索不报错（fail-soft），重要性取中性 |
 
@@ -284,7 +319,7 @@ dsh web --no-open --port 0
 
 | # | 步骤 | 通过标准 |
 |---|---|---|
-| G1 | 对话若干轮 | 工作区日志 `*.md` 有新条目；`hub-pre\*.json` 更新 |
+| G1 | 对话若干轮 | 工作区日志 `*.md` 有新条目；`memory/hub\*.json` 更新 |
 | G2 | **重启 dsh web**（带 `--no-open`） | 数据 restore 不丢 |
 | G3 | 异常：磁盘不可写 | 不崩溃，日志有记录 |
 
@@ -321,7 +356,7 @@ node tests/smoke/smoke-test-continue-chain-pre.mjs              # 58
 | 启动后 UI 空白/无插件入口 | 检查插件是否装载到 web profile；看诊断日志加载错误 |
 | 改了设置没效果 | 查 `/config` 是否回写；确认是否需要重载 |
 | recall 返回空 | 确认记忆目录有内容；确认 `semanticEngineMode` 与引擎可用；看日志降级记录 |
-| 证据不落盘 | 检查 `evidence-pre\events` 目录权限；确认相关开关 |
+| 证据不落盘 | 检查 `memory/evidence\events` 目录权限；确认相关开关 |
 | 接续不触发 | 确认水位确实到 0.75；`autoContinueEnabled` 为 true |
 | 检索很慢 | 当前词法检索为全量扫描（无倒排索引，属已知待办） |
 
@@ -345,10 +380,11 @@ node tests/smoke/smoke-test-continue-chain-pre.mjs              # 58
 | 工程根 | `D:\dsh-auto-memory` |
 | 宿主侧入口 | `lib/index.js` |
 | 浏览器侧入口 | `lib/client.js` |
-| 端点前缀 | `/api/dsh-auto-memory-pre/`（39 个） |
+| 端点前缀 | `/api/dsh-auto-memory/`（49 条；pre 树 `/api/dsh-auto-memory-pre/`） |
 | 工具 | 10 个，`memory_*_pre` |
 | 记忆根 | `C:\Users\JH Z\.dsh\memory` |
-| 证据事件 | `...\evidence-pre\events\YYYY-MM-DD.jsonl`（时间戳在 `event.ts`） |
-| 诊断日志 | `...\dsh-auto-memory-pre-diagnose.log` |
-| M8 数据 | `...\hub-pre\{episodes,facts,procedures}.json` |
+| 证据事件 | `...\memory\evidence\events\YYYY-MM-DD.jsonl`（时间戳在 `event.ts`） |
+| 诊断日志 | `...\dsh-auto-memory-diagnose.log`（**与 `memory\` 同级**，不在其下） |
+| M8 数据 | `...\memory\hub\{episodes,facts,procedures}.json` |
+| 降级台账 | `...\memory\degrade-pre\latest.json`（★两条线同名，无发布名） |
 | 水位/接续阈值 | 0.75 / 0.75（**须低于官方压缩 0.80**） |