@a9i5k4/dsh-auto-memory 3.0.0 → 3.1.0

package/docs/HOMEPAGE-CONTENT-FOR-GM53.md

@@ -0,0 +1,299 @@
+# 项目主页内容规格 · 交给 GM5.3 执行
+
+> **用途**：这不是设计稿，是**内容脚本**。GM5.3 只需按本文逐节产出文本，不需要判断「写什么」。
+> **形态**：纯静态站点（`site/index.html` + `site/assets/site.css` + `site/assets/site.js`，零构建、零依赖）。
+> **平台**：GitHub Pages（先当 pages 用着，能用就行）。
+> **视觉**：**不做**。沿用现有 DeepSeek 暗色令牌体系即可，花哨的排后面再说。
+
+---
+
+## 一、页面总目标
+
+让一个**已经在用 DSH 的人**在 60 秒内相信三件事，然后去装：
+
+1. 这个插件**自己会记事**，不用你提醒它「记得记一下」；
+2. 它记的东西**你能查、能改、能删**，不是黑盒；
+3. 装它**没有代价**：零运行时依赖、无账号、无云端、BSD-3、三平台。
+
+### 读者分层（决定每页的写法）
+
+| 层 | 谁 | 看哪几页 | 需要什么 |
+|---|---|---|---|
+| L1 | 还没听说过的 DSH 用户 | 第 1–2 页 | 5 秒内明白「这插件干嘛的」 |
+| L2 | 在评估要不要装 | 第 3–8 页（功能详解） | 判断「机制靠不靠谱」 |
+| L3 | 已决定要装 | 第 10 页 | 直接抄命令 |
+| L4 | 怀疑派 | 第 11 页（边界） | 看到你**主动说自己的不足**才信你 |
+
+---
+
+## 二、逐页内容（11 页）
+
+> **每页统一四段式**：`标题/一句话` → `人话正文` → `示意（文字描述给 GM5.3，图可后补）` → `怎么核`
+> 最后一段是本插件「唤起可审计」调性的自证——**每页都要有，且必须是可当场验证的事实**。
+
+---
+
+### 第 1 页 · 首屏（HERO）
+
+**一句话**：无问自忆，且件件可查。
+
+**正文**（中文原文，英文另给）：
+> 你不用交代她「记得记一下」。她自己留意、自己归档，在该用上的时候自己想起来——
+> 每次想起都带一条你能读、能评、能改的证据。
+> 上下文写满时，她也不把自己压缩成一段摘要：合上一本写满批注的笔记，翻开新的一页。
+
+**安装命令**：`pnpm add @a9i5k4/dsh-auto-memory@latest` ＋复制按钮 ＋「三步装完 →」按钮
+
+**事实芯片**（五个，横向排列）：
+`v3.0.0` · `BSD-3-Clause` · `零运行时依赖` · `Win / macOS / Linux` · `中英双语`
+
+**示意**：四步闭环 —— 你说话 → 她留意 → 归档 → 想起来（附证据链）；中心写「零指令，不需要」
+
+**怎么核**：侧栏点开「记忆」→ 安装向导第一步就把每个开关讲一遍
+
+---
+
+### 第 2 页 · 她做六件事（全站骨架）
+
+**一句话**：看完这六条，你就了解这个插件了。下面都是细节。
+
+**内容**：6 张可点卡片，每张 = 编号 + 标题 + 一句话 + 「看细节 →」，链接到第 3–8 页。
+
+| # | 标题 | 一句话 |
+|---|---|---|
+| ① | 她自己记 | 不用你说「记得记一下」。她留意、归档，并在该用上时自己想起来。 |
+| ② | 每条都查得到 | 每次想起都带证据链：能读、能评、能改、能删。全在你自己盘上。 |
+| ③ | 三层分工 | 硬规矩、项目笔记、每日流水。常驻注入 + 按需检索，各管各的。 |
+| ④ | 她替你记日子 | 对话里的截止日期与承诺，她记进日历，到点提醒你。 |
+| ⑤ | 能搬，也不串味 | WorkBuddy / CodeBuddy / Claude Code / Codex 的记忆能搬进来；多个项目并行互不打扰。 |
+| ⑥ | 脏东西进不来 | 乱码、卡顿、JSON 注入在写入时就被拦；凭据不进提示词；每个功能单独可关。 |
+
+**示意**：无（纯导航页，避免抢注意力）
+
+**怎么核**：每张卡片点进去都能看到「怎么核」那一行
+
+---
+
+### 第 3 页 · ① 她自己记
+
+**正文**：
+> 你不用记得去告诉她「要记住」。每一轮结束，一个安静的子代理会读一遍刚发生的事，
+> 把值得留的按主题归档——不是往一堵墙上继续堆。等这些内容重新变得相关时，
+> 宿主会在上下文的固定边界把它们注入进去。模型不需要「想起来去查」，你的前缀缓存也不会被打散。
+
+**要点四条**：
+- 你没有任何「记得要做」的动作——根本没有一个会忘的保存键。
+- 按主题成组，一周后翻出来仍像笔记，不是一堆流水。
+- 固定边界注入，前缀缓存友好，不会每轮全量重算。
+- 窗口写满时她写一份交接账本，而不是把自己压缩掉。
+
+**示意**：上下文窗口右段高亮「她想起的」+ 上方标「固定边界」；下方是「读这一轮 → 按主题成组 → 落盘归档」三步
+
+**怎么核**：打开面板的**日志页签**，每条自动归档都带时间戳，并标明来自哪一轮。
+
+---
+
+### 第 4 页 · ② 每条都查得到
+
+**正文**：
+> 查不到源头的记忆就是传闻。每次唤起都带完整证据链：哪几条被激活、依据是什么、分数多少。
+> 你可以在「唤起回顾」里逐条评分——评分会回流到晋升判定，所以差了会越来越安静，好用的会越来越牢。
+> 没有黑盒，也没有任何东西离开你的磁盘。
+
+**要点四条**：
+- 你能在一条错记忆悄悄影响后面几个月之前就抓出它。
+- 评分就是反馈回路——技能就是这样挣到晋升的。
+- 凭据不进提示词：写入前卫生检查会剥掉。
+- 一切都在你本地磁盘；没有账号，没有云端。
+
+**示意**：一次唤起 → 展开证据链（来源条目 / 命中依据 / 评分）→ 四个动作胶囊：读、评、改、**删**（删高亮）
+
+**怎么核**：唤起回顾页签 → 任选一次唤起 → 能看到它的来源与评分；改或删立即生效。
+
+---
+
+### 第 5 页 · ③ 三层分工
+
+**正文**：
+> 她记的东西分三层放，放在哪一层，决定它怎么进入模型。
+> 硬规矩每一轮都进——没有例外。项目笔记住在常驻目录里，随手可用但不吃窗口。
+> 每日日志平时不占地方，真需要的时候才被拉进来。
+
+**三层结构**（左） × **三种到达方式**（右）：
+
+| 层 | 内容 | 到达方式 |
+|---|---|---|
+| 用户级硬约束 | 「绝不要 X」「永远用中文答」——你自己定的 | **每轮无条件注入**（不做相关性判断） |
+| 项目级笔记 | 决策、架构、约定——本来要反复解释的东西 | **常驻目录 + 命中即用**（≤800 tok） |
+| 每日日志 | 今天发生了什么，带时间戳 | **仅按需检索**（不进窗口，直到被需要） |
+
+**要点**：你把东西放进哪一层，本身就是调度决策。你不需要手工调注入策略。
+
+**怎么核**：设置页显示每一层当前占多少 token；规则层有可视化编辑器；笔记层显示常驻目录体积。
+
+---
+
+### 第 6 页 · ④ 她替你记日子
+
+**正文**：
+> 截止日期、约好的时间、顺口一说就忘的承诺，都是在聊别的事的时候被顺手记下的——
+> 「周五交报告」「下周给你发过去」。它们会带着解析好的日期进日历，
+> 并在**日期到之前**回来找你，不是之后。
+
+**要点四条**：
+- 明确日期：「10 月 4 日前」「30 号」。
+- 相对日期：「下周」「三天后」——按今天换算。
+- 时间与象限：截止时刻和重要度一并记下。
+- 你对别人许的承诺，不只是你自己的任务。
+
+**示意**：对话里一句话 → 解析成 `2026-11-01 23:59 · 重要不紧急 · …` → 标注「日期到之前回来找你」
+
+**怎么核**：问一句「我最近有什么安排」，她会从日历文件里读回来——那个文件你自己也能打开看。
+
+---
+
+### 第 7 页 · ⑤ 能搬，也不串味
+
+**正文**：
+> 如果你已经在别的 AI 工具里干过活，那段历史不用重来。她会扫描 WorkBuddy、CodeBuddy、
+> Claude Code、Codex 留下的记忆，按来源分别导入——进哪些你挑，事后也能把一个来源整个撤掉。
+> 另一半是反过来的：并行的工作区和会话各自保留自己的召回决策与索引缓存，
+> 你跟她讲过的工作上的事，不会串到另一个小项目里去。
+
+**要点四条**：
+- 扫描是**只读**的，在你点确认之前不会写任何东西。
+- 按来源分列，进哪些你挑。
+- 一个来源可以整个撤掉。
+- 全局层（硬规矩）是**故意共享**的——那是你的长期约束；其余全部按工作区隔离。
+
+**示意**：左侧四个外部工具 → 中间「扫描 + 逐源导入」→ 右侧项目 A / 项目 B 各自隔离，中间画 ╳
+
+**怎么核**：设置 → 外部记忆，会先列出检测到的每个来源及其路径与体积，**在你点确认之前不会写任何东西**。
+
+---
+
+### 第 8 页 · ⑥ 脏东西进不来
+
+**正文**：
+> 一个会写垃圾的记忆插件还不如没有。每次写入都先过闸门：乱码、卡顿输出、JSON 形状的注入
+> 都在那里被拦下；任何像凭据的东西在进入提示词之前就被剥掉。
+> 在那之上，每个功能是独立开关——你可以让它全自动跑，也可以只关掉某一项、其余照旧。
+
+**闸门拦三类**：乱码 / 卡顿与重复输出 / JSON 注入 → **丢弃 + 留痕**（不静默）
+
+**要点四条**：
+- 关掉提醒不影响召回；关掉召回不影响规矩。（**开关互不牵连**）
+- 无人值守模式整圈自动跑、不弹任何确认，挂着机也能用。
+- 任何模型开箱可用：词法档 0 GB 起步，内置语义档约 130 MB。
+- Python int8 进阶档（约 563 MB）是向导式可选安装，**永远不是前置条件**。
+
+**怎么核**：设置里每个功能各占一行、各有独立开关，点一下标签立刻翻面。
+
+---
+
+### 第 9 页 · 亮点页入口（占位）
+
+**一句话**：把它当成一间屋子，而不是一页纸。
+
+**正文**：
+> 三维档案终端把同样的内容变成一个能走进去的阵列：五列、四十份档案，方向键移动，拖拽环绕。
+> 选中的卡片会向镜头抬起，解密线随之合拢。它读的是和本页同一份数据——
+> 是同一个插件的另一种看法，不是另一个插件。
+
+**状态标注（诚实）**：需要 WebGL；**当前施工中**，不支持时自动退回本页这种可读版。
+
+**怎么核**：主页第 9 页的入口目前指向一个说明页，写清了还差哪三件事。
+
+---
+
+### 第 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. 交接白板与水位感知是实验特性。（注明当前默认值与开启位置）
+2. 语义档是可选的。JS 内置档（约 130 MB）是默认值、无需配置；Python int8 进阶档（约 563 MB）走向导安装。
+3. 面板 API 仅监听本机回环地址。外部访问返回 401 属预期行为，不是故障。
+4. 三维档案终端需要 WebGL。不支持时会退回可读版——信息不丢，只是没有三维呈现。
+5. 首屏角色的 24 fps 序列帧尚未交付；目前是内联 SVG 线稿，挂载位已按交付契约预埋。
+
+**怎么核**：白皮书 `docs/WHITEPAPER.md` 里每个数字都标注了代码出处。
+
+---
+
+### 页脚（法务层，**四段必须分列**）
+
+| 段 | 内容 |
+|---|---|
+| **许可** | 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 官方无关，与上述参考仓库作者亦无隶属关系 |
+
+> ⚠️ **角色许可（CC BY-NC-SA）与代码许可（BSD-3-Clause）冲突，不可合并成一句「本项目采用 XX 许可」。**
+
+---
+
+## 三、功能清单（供 GM5.3 引用，不要在主页全列）
+
+主页只展示上面 6 组。以下 39 条是**全量底表**，供需要时取用。
+
+### 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）
+写入闸门 · 凭据不进提示词 · 一切皆开关 · 工作区隔离
+
+**规模**：17 个模型工具 · 49 条 HTTP 路由 · 98 个配置键（其中 60 可写）· 12 页签 · 6 处插槽 · 0 运行时依赖
+
+---
+
+## 四、给 GM5.3 的执行约束
+
+1. **零构建**：产出必须是可直接打开的单页 HTML + CSS/JS，不引框架、不引 CDN（字体除外可酌情）。
+2. **双语**：所有面向用户文案必须中文 + 英文两套。现有实现是 `data-en` 属性 + 中文源文。
+   ⚠️ **`data-en` 元素内部不得有任何子标签**——语言切换用 `textContent` 整体替换，子元素会被永久抹平。
+3. **不要改视觉方向**：暗色 `#0a0a0a` + 品牌蓝 `#4d6bfe` / `#6799fe`，沿用即可。
+4. **每页必须有「怎么核」**：一句可当场验证的事实。这是本插件的调性，不能省。
+5. **边界页不许减少**：宁可写得不好看，也不要删掉诚实清单。
+6. **法务四段必须分列**，不得合并。
+7. **首屏不放角色定妆稿**：那是给画师看的交付契约，不是给访客看的。
+
+---
+
+## 五、现存页面的参考
+
+成品在 `site/index.html`（11 节、4 视口验证通过、断链 0）。
+GM5.3 可以直接在其上改文案与结构，也可以重写——**但上面 §二的 11 页内容不能少**。

package/docs/PROMO-PROMPT-3.0.md

@@ -0,0 +1,100 @@
+# dsh-auto-memory 3.0 宣传图 · 单发完整 Prompt
+
+> **用法**：整段粘进生图工具，一次出图。
+> **推荐参数**：`gpt-image-2.5` / quality `high` / size `1536x1024`（16:9 横版）
+> 若要竖版封面用 `1024x1536`，把构图描述里的「left / right」换成「top / bottom」。
+
+---
+
+## Prompt（直接复制）
+
+```
+A polished product banner illustration for a developer tool, 16:9 widescreen, dark cinematic anime aesthetic.
+
+LAYOUT: Split composition. Left 55% is a clean information panel with crisp typography. Right 45% is a full-body anime character with floating holographic elements. A soft vertical light seam separates the two halves.
+
+BACKGROUND: Deep navy-to-near-black gradient, from #12203f at the upper left to #050810 at the lower right. Subtle floating grid of thin cyan lines, faint bokeh particles, and a soft cyan glow behind the character. A few translucent glass panels drift in the background with very low opacity. Clean, premium, technical — not cluttered.
+
+CHARACTER (right side, occupying right 45%, full body from head to knees): A gentle anime girl with long flowing light-blue hair and a small gold star hair clip. Large expressive blue eyes with soft highlights, warm closed-mouth smile, looking slightly toward the viewer. She wears a white blouse with puffy sleeves, a dark navy vest with gold trim and small gold buttons, a large navy bow at the collar with a round blue gemstone brooch, and a navy pleated skirt with a gold chain and gem pendant at the waist. She holds a large open dark-navy hardcover book in both hands; the book's cover is embossed with gold filigree and displays the English text "MEMORY LOG" in clean gold serif capitals. In her raised right hand she holds a dark fountain pen with a gold nib. Around her float 6 to 8 glowing translucent blue glass memory cards, each with a delicate gold corner frame and a small sparkle icon. Soft rim light from the left catches her hair and shoulders; cool cyan bounce light from the cards. Clean crisp line art, cel shading, soft painterly highlights, high detail on hair strands and fabric folds.
+
+LEFT PANEL TOP — main title block:
+Large bold Chinese title text, two lines, white with a subtle cyan glow:
+"无问自忆"
+"记忆不断线"
+Below it, smaller light-blue English subtitle in a clean sans-serif:
+"She remembers, unbidden."
+Below that, one line of small gray-blue Chinese text:
+"跨窗口 · 跨会话 · 跨工具"
+
+LEFT PANEL MIDDLE — a 2x2 grid of four rounded glass capability cards, each with a thin cyan border, a small line-art icon in the upper left, and Chinese text:
+Card 1 icon: a small closed book. Title "自动记忆" in white bold, body text "每轮自动沉淀，寒暄轮跳过" in small gray-blue.
+Card 2 icon: a shield with a checkmark. Title "写入闸门" in white bold, body text "乱码与凭据进不了提示词" in small gray-blue.
+Card 3 icon: a clipboard with a pen. Title "交接账本" in white bold, body text "换窗口不丢上下文" in small gray-blue.
+Card 4 icon: three stacked horizontal layers. Title "三层记忆" in white bold, body text "硬规矩 / 笔记 / 日志" in small gray-blue.
+
+LEFT PANEL LOWER — a dark rounded terminal bar with a thin cyan border, containing monospace text in cyan-green:
+"pnpm add @a9i5k4/dsh-auto-memory@latest"
+To its right, a small rounded pill button with the Chinese text "复制".
+
+LEFT PANEL BOTTOM — a horizontal row of small rounded info chips with thin borders, each containing short Chinese text:
+"17 模型工具"  "49 路由"  "98 配置键"  "12 面板页签"  "零运行时依赖"
+
+TOP RIGHT CORNER — a small glowing version badge, rounded pill shape with a cyan border and cyan text: "v3.0.0"
+
+BOTTOM LEFT CORNER — small gray text: "BSD-3-Clause  ·  Windows / macOS / Linux"
+
+STYLE: Premium dark UI illustration, deep blue and cyan palette with small warm gold accents, glassmorphism, soft glow, high contrast between text and background. Typography must be sharp, correctly spelled, well-kerned, and perfectly legible. All Chinese characters must be accurate and correct. Cinematic lighting, clean composition, professional key visual quality, no watermark, no signature, no border frame.
+```
+
+---
+
+## 出图后必做：文字准确性自检
+
+AI 生图的**中文长文本**仍可能出错（缺笔画、错字、糊字）。逐项核对：
+
+- [ ] 主标题「无问自忆」「记忆不断线」——**这两行最重要**，错一个字就重出
+- [ ] 英文副标题 `She remembers, unbidden.`
+- [ ] 四张卡片标题：自动记忆 / 写入闸门 / 交接账本 / 三层记忆
+- [ ] 卡片小字（错字可接受，糊字不行 —— 小字允许后期覆盖）
+- [ ] 命令 `pnpm add @a9i5k4/dsh-auto-memory@latest`（**必须逐字符对**）
+- [ ] 五个 chip：17 模型工具 / 49 路由 / 98 配置键 / 12 面板页签 / 零运行时依赖
+- [ ] 版本号 `v3.0.0`（不是 0.1.35、不是 3.0.1）
+- [ ] 书封 `MEMORY LOG`
+- [ ] 左下 `BSD-3-Clause`
+
+**修图策略**（按性价比排序）：
+1. **重出**：主标题或命令出错 → 直接重跑，改 prompt 里对应那行
+2. **局部重绘（inpainting）**：只有某一小块错 → 用图生图 + 蒙版只遮那一块
+3. **HTML 后期覆盖**：只有卡片小字或 chip 糊 → 用 HTML 渲染同位置的文字层叠上去（此时 AI 已经画好了光影氛围，只为修字）
+
+---
+
+## 内容依据（写 prompt 时的事实来源）
+
+全部经代码自核，**不要改动这些数字**：
+
+| 项 | 值 |
+|---|---|
+| 版本 | **3.0.0**（2026-09-17 发布） |
+| 模型工具 | **17** |
+| HTTP 路由 | **49** |
+| 配置键 | **98**（60 可写） |
+| 面板页签 | **12** |
+| 运行时依赖 | **0** |
+| 许可 | BSD-3-Clause |
+
+**3.0.0 真正的新东西**（宣传图该讲的）：
+1. **底层重建收官** —— 检索、注入、容量、并发四条底层全部重建
+2. **白板/看板从实验升为出厂形态**（`handoffEnabled` 默认 `true`、`boardMode` 默认 `graph`）
+3. **语义索引永久不就绪的真因修复** —— 累计 22,945 行 `index-not-ready` 降级日志；根因是 Python worker 的同步槽被一次未完成的同步永久占住；修复给出两条「可证已死」接管出口
+4. **多工作区/多会话适配** —— 修掉引擎里 4 处「单槽」变量，同时跑两个会话时不再互相覆盖
+
+---
+
+## 负面提示（若工具支持 negative prompt）
+
+```
+low quality, blurry, blurry text, garbled characters, wrong Chinese characters, misspelled text,
+extra fingers, deformed hands, watermark, signature, logo, border frame, cluttered background,
+neon overload, oversaturated, flat lighting, 3d render, photorealism, western cartoon style
+```

package/docs/USER-GUIDE.en.md

@@ -41,7 +41,7 @@
 
 ## 1. Install & entry points
 
-- Install into the DSH web profile directory (`~/.dsh/profiles/web`): `pnpm add @a9i5k4/dsh-auto-memory`, then append `"@a9i5k4/dsh-auto-memory"` to the `dsh.profile.bundles` array in that directory's `package.json` (or one-click from the DSH plugin marketplace).
+- Install into the DSH web profile directory (`~/.dsh/profiles/web`): `pnpm add @a9i5k4/dsh-auto-memory@latest`, then append `"@a9i5k4/dsh-auto-memory"` to the `dsh.profile.bundles` array in that directory's `package.json` (or one-click from the DSH plugin marketplace).
 - **You must restart dsh web after installing**: the injection surface (manifest) loads at startup. Same after changing host code.
 - After a browser-side update, **hard-refresh** (Ctrl+Shift+R) to load the new client.js.
 - pnpm v11 blocks packages published <24h ago (`minimumReleaseAge`): set `minimumReleaseAge: 0` in `pnpm-workspace.yaml` or pin an explicit version for same-day updates.
@@ -50,7 +50,7 @@
 - The version number in the panel title and in Settings → "Check for updates" both show the **installed** version.
 - A **floating pin** (line-drawn quick-access icon) also lives in the sidebar for one-click access to memory actions from anywhere.
 - Since DSH 0.1.2-rc.1 the Web UI sits behind a token gate (new token every restart; the `?token=…` URL in the startup log is your address). This plugin's HTTP endpoints are loopback-only and unaffected by the gate.
-- All data stays on your machine: `~/.dsh/memory/` (memory files), `~/.dsh/dsh-auto-memory-pre.json` (config; `dsh-auto-memory.json` in release builds).
+- All data stays on your machine: `~/.dsh/memory/` (memory files), `~/.dsh/dsh-auto-memory.json` (config). **Note**: inside this repo's pre dev tree the same file carries a `-pre` suffix; the build you install from npm uses the suffix-less name. Same applies to every path below.
 
 ## 2. First launch
 
@@ -193,8 +193,8 @@ The static injection face: the `<memory_system>` block composed into every turn.
 
 | Item | Notes |
 |---|---|
-| Version / check for updates | Compares with the npm registry; registry installs get one-click updates. Local dev links show the update command `cd ~/.dsh/profiles/web && pnpm up @a9i5k4/dsh-auto-memory` |
-| Diagnostics log | `~/.dsh/dsh-auto-memory-pre-diagnose.log` (subagent circuit-breaking, consolidation skips, GC, recall degradation — all in here) |
+| Version / check for updates | Compares with the npm registry; registry installs get one-click updates. Local dev links show the update command `cd ~/.dsh/profiles/web && pnpm up @a9i5k4/dsh-auto-memory@latest` |
+| Diagnostics log | `~/.dsh/dsh-auto-memory-diagnose.log` (subagent circuit-breaking, consolidation skips, GC, recall degradation — all in here; **it sits next to `memory/`, not inside it**) |
 | Community | QQ group feedback — faster than GitHub issues (link in README) |
 
 ---
@@ -250,7 +250,7 @@ Every decision lands in the **Recall review** tab for A/P/S/H/E grading. Every i
 
 ## 7. Evidence chain & memory importance
 
-Every memory keeps an auditable usage dossier — six event types, filed daily under `~/.dsh/memory/evidence-pre/events/YYYY-MM-DD.jsonl`:
+Every memory keeps an auditable usage dossier — six event types, filed daily under `~/.dsh/memory/evidence/events/YYYY-MM-DD.jsonl` (this repo's pre dev tree uses `evidence-pre/`):
 
 | Event | Meaning |
 |---|---|
@@ -366,7 +366,7 @@ All three write tools (log/note/user) pass the **write gate**: GBK mojibake, stu
 | pnpm blocks a same-day update | pnpm v11 `minimumReleaseAge` blocks <24h packages: set `minimumReleaseAge: 0` or pin the version |
 | Web UI asks for a token | DSH 0.1.2-rc.1 security gate; the token is in the `dsh web` startup-log URL and rotates each restart |
 | Sidebar Memory button vanished | Likely a conflict with another sidebar-injecting plugin; disable the suspect in plugin management |
-| Feedback / grab logs | `~/.dsh/dsh-auto-memory-pre-diagnose.log`; QQ group in README |
+| Feedback / grab logs | `~/.dsh/dsh-auto-memory-diagnose.log` (run `ls -l ~/.dsh/*diagnose*.log` first to confirm it is non-empty); QQ group in README |
 
 ---
 
@@ -374,16 +374,16 @@ All three write tools (log/note/user) pass the **write gate**: GBK mojibake, stu
 
 | Content | Path |
 |---|---|
-| Plugin config | `~/.dsh/dsh-auto-memory-pre.json` (`dsh-auto-memory.json` in release builds) |
+| Plugin config | `~/.dsh/dsh-auto-memory.json` (this repo's pre dev tree uses `dsh-auto-memory-pre.json`) |
 | User-level memory | `~/.dsh/memory/MEMORY.md` |
 | Workspace memory | `~/.dsh/memory/workspaces/<workspace>/` (MEMORY.md, daily logs, handoff/, reflections/, summaries/) |
 | Whiteboard & ledgers | `~/.dsh/memory/workspaces/<workspace>/handoff/` (PLAN.md + handoff-*.md) |
-| Memory Hub layers | `~/.dsh/memory/hub-pre/` (episodes / facts / procedures .json, atomic writes) |
-| Evidence events | `~/.dsh/memory/evidence-pre/events/YYYY-MM-DD.jsonl` (six types, per day) |
-| Semantic-engine data | `~/.dsh/memory/semantic-pre/` (embedding-config.json, decision shadow logs, vector cache) |
+| Memory Hub layers | `~/.dsh/memory/hub/` (episodes / facts / procedures .json, atomic writes; this repo's pre dev tree uses `hub-pre/`) |
+| Evidence events | `~/.dsh/memory/evidence/events/YYYY-MM-DD.jsonl` (six types, per day; pre dev tree uses `evidence-pre/`) |
+| Semantic-engine data | `~/.dsh/memory/semantic/` (embedding-config.json, decision shadow logs, vector cache; pre dev tree uses `semantic-pre/`) |
 | Models / venv | `~/.dsh/models/js-semantic/` (C2 model) · `~/.dsh/python-engine/` (C3 venv + model; plugin upgrades never touch these) |
 | Subagent trace backups | `~/.dsh/subagent-gc-backup/` (move back into `~/.dsh/sessions/` to roll back) |
-| Diagnostics log | `~/.dsh/dsh-auto-memory-pre-diagnose.log` |
+| Diagnostics log | `~/.dsh/dsh-auto-memory-diagnose.log` (next to `memory/`, **not** inside it) |
 
 ---
 

package/docs/USER-GUIDE.zh-CN.md

@@ -41,7 +41,7 @@
 
 ## 1. 安装与入口
 
-- 安装：在 DSH 的 web profile 目录（`~/.dsh/profiles/web`）执行 `pnpm add @a9i5k4/dsh-auto-memory`，并在同目录 `package.json` 的 `dsh.profile.bundles` 数组里追加 `"@a9i5k4/dsh-auto-memory"`（或在 DSH 插件市场一键安装）。
+- 安装：在 DSH 的 web profile 目录（`~/.dsh/profiles/web`）执行 `pnpm add @a9i5k4/dsh-auto-memory@latest`，并在同目录 `package.json` 的 `dsh.profile.bundles` 数组里追加 `"@a9i5k4/dsh-auto-memory"`（或在 DSH 插件市场一键安装）。
 - **装完必须重启 dsh web**：插件的注入面（manifest）在启动时加载；改完 host 代码同理。
 - 浏览器端更新后需**硬刷新**（Ctrl+Shift+R）才会加载新 client.js。
 - pnpm v11 会拦截发布不足 24 小时的新版本（`minimumReleaseAge`）：当天更新请在 `pnpm-workspace.yaml` 设 `minimumReleaseAge: 0`，或直接 pin 版本号。
@@ -50,7 +50,7 @@
 - 面板标题里的版本号与 设置 →「检查更新」显示的都是**当前安装的版本**。
 - 侧栏还有一颗**悬浮钉**（线描快捷入口），可从任何页面快速唤出记忆操作。
 - DSH 0.1.2-rc.1 起 Web UI 有 token 认证闸门（每次重启换新 token，启动日志里 `?token=…` 即访问地址）；本插件的 HTTP 端点仅本机回环可访问，不受闸门影响。
-- 数据全在本机：`~/.dsh/memory/`（记忆文件）、`~/.dsh/dsh-auto-memory-pre.json`（配置，发布版为 `dsh-auto-memory.json`）。
+- 数据全在本机：`~/.dsh/memory/`（记忆文件）、`~/.dsh/dsh-auto-memory.json`（配置）。**注意**：本仓库的 pre 开发树里同一个文件名带 `-pre` 后缀；你从 npm 装到的版本是**不带**后缀的那个，下面所有路径同理。
 
 ## 2. 第一次启动
 
@@ -193,8 +193,8 @@
 
 | 项 | 说明 |
 |---|---|
-| 插件版本 / 检查更新 | 与 npm registry 比对；registry 安装可一键更新。本地开发链接会显示更新命令 `cd ~/.dsh/profiles/web && pnpm up @a9i5k4/dsh-auto-memory` |
-| 诊断日志 | `~/.dsh/dsh-auto-memory-pre-diagnose.log`（子代理熔断、巩固跳过、回收、唤起降级等事件全在内） |
+| 插件版本 / 检查更新 | 与 npm registry 比对；registry 安装可一键更新。本地开发链接会显示更新命令 `cd ~/.dsh/profiles/web && pnpm up @a9i5k4/dsh-auto-memory@latest` |
+| 诊断日志 | `~/.dsh/dsh-auto-memory-diagnose.log`（子代理熔断、巩固跳过、回收、唤起降级等事件全在内；**与 `memory/` 同级，不在 `memory/` 里面**） |
 | 交流群 | QQ 群反馈，响应比 issue 快（链接见 README） |
 
 ---
@@ -250,7 +250,7 @@
 
 ## 7. 证据链与记忆重要性
 
-每条记忆都有可审计的使用档案，六类事件按日落盘 `~/.dsh/memory/evidence-pre/events/YYYY-MM-DD.jsonl`：
+每条记忆都有可审计的使用档案，六类事件按日落盘 `~/.dsh/memory/evidence/events/YYYY-MM-DD.jsonl`（本仓库 pre 开发树为 `evidence-pre/`）：
 
 | 事件 | 含义 |
 |---|---|
@@ -366,7 +366,7 @@ AI 在对话中可直接调用（共 14 个，你不需要记）：
 | pnpm 安装当天新版被拦 | pnpm v11 `minimumReleaseAge` 拦 24h 内新版：`minimumReleaseAge: 0` 或 pin 版本 |
 | Web UI 打开要 token | DSH 0.1.2-rc.1 起的安全闸门，token 在 `dsh web` 启动日志的 URL 里，重启即换 |
 | 侧栏插件按钮消失 | 可能与其他注入侧栏的插件冲突，到插件管理停用嫌疑插件 |
-| 想反馈 / 拿日志 | `~/.dsh/dsh-auto-memory-pre-diagnose.log`；QQ 群见 README |
+| 想反馈 / 拿日志 | `~/.dsh/dsh-auto-memory-diagnose.log`（打包前先 `ls -l ~/.dsh/*diagnose*.log` 确认非空）；QQ 群见 README |
 
 ---
 
@@ -374,16 +374,16 @@ AI 在对话中可直接调用（共 14 个，你不需要记）：
 
 | 内容 | 路径 |
 |---|---|
-| 插件配置 | `~/.dsh/dsh-auto-memory-pre.json`（发布版 `dsh-auto-memory.json`） |
+| 插件配置 | `~/.dsh/dsh-auto-memory.json`（本仓库 pre 开发树为 `dsh-auto-memory-pre.json`） |
 | 用户级记忆 | `~/.dsh/memory/MEMORY.md` |
 | 工作区记忆 | `~/.dsh/memory/workspaces/<工作区>/`（MEMORY.md、每日日志、handoff/、reflections/、summaries/） |
 | 白板与账本 | `~/.dsh/memory/workspaces/<工作区>/handoff/`（PLAN.md + handoff-*.md） |
-| 记忆中枢三层 | `~/.dsh/memory/hub-pre/`（episodes / facts / procedures .json，原子写） |
-| 证据事件 | `~/.dsh/memory/evidence-pre/events/YYYY-MM-DD.jsonl`（六类，按日） |
-| 语义引擎数据 | `~/.dsh/memory/semantic-pre/`（发射配置 embedding-config.json、决策影子日志、向量缓存） |
+| 记忆中枢三层 | `~/.dsh/memory/hub/`（episodes / facts / procedures .json，原子写；本仓库 pre 开发树为 `hub-pre/`） |
+| 证据事件 | `~/.dsh/memory/evidence/events/YYYY-MM-DD.jsonl`（六类，按日；本仓库 pre 开发树为 `evidence-pre/`） |
+| 语义引擎数据 | `~/.dsh/memory/semantic/`（发射配置 embedding-config.json、决策影子日志、向量缓存；本仓库 pre 开发树为 `semantic-pre/`） |
 | 语义模型/venv | `~/.dsh/models/js-semantic/`（C2 模型）· `~/.dsh/python-engine/`（C3 venv+模型，升级插件不受影响） |
 | 子代理痕迹备份 | `~/.dsh/subagent-gc-backup/`（移回 `~/.dsh/sessions/` 即回滚） |
-| 诊断日志 | `~/.dsh/dsh-auto-memory-pre-diagnose.log` |
+| 诊断日志 | `~/.dsh/dsh-auto-memory-diagnose.log`（与 `memory/` 同级，不在 `memory/` 里面） |
 
 ---