@a9i5k4/dsh-auto-memory 2.5.3 → 3.0.1

package/docs/FRONTEND-CO-CREATION.md

@@ -0,0 +1,191 @@
+# 前端共创计划 · dsh-auto-memory
+
+> **一句话**：这个插件的前端（记忆面板 12 页签 + 设置页 8 分组）目前是「能用」的水平，
+> 我们知道它离「好用」还有距离。**视觉与交互的改进，交给社区。**
+> 你有想法，提 PR；我们提供完整的落点地图、约束清单和一个不碰后端的沙盒。
+
+---
+
+## 一、为什么把前端交给社区
+
+三条实话：
+
+1. **功能已经稳定，前端是短板。** 后端 17 个模型工具、49 条路由、98 个设置键都在跑，
+   但记忆面板的信息密度高、布局拥挤，用户第一眼常常不知道该看哪里。
+2. **前端的取舍没有唯一答案。** 「唤起回顾该怎么展示」「12 个页签该不该合并」
+   这类问题取决于你自己的工作方式——而你们的工作方式比我们更丰富。
+3. **改前端的边际成本低于改后端。** 前端零构建、单文件、纯 ESM，
+   你不需要装任何东西就能跑起来改。
+
+我们同时公开了**落点地图**（每个能力现在住在哪一行）和**视觉远期规划**（哪些不做、为什么），
+避免你花了力气做出来的东西因为「不在规划里」被拒。
+
+---
+
+## 二、你可以改什么（三档）
+
+### 🟢 A 档 · 随时欢迎，几乎不会被拒
+
+| 方向 | 具体例子 |
+|---|---|
+| **信息层级** | 12 页签分组/折叠/重排；概览页只留最关键的三行 |
+| **可读性** | 长列表虚拟滚动；日志页签的行距与等宽字体；中文断行 |
+| **交互细节** | 键盘导航；Esc/焦点管理；加载态与空态；错误提示人话化 |
+| **一致性** | 组件间距/圆角/字号收敛到设计令牌（见 §5） |
+| **无障碍** | 对比度、focus-visible、aria-label、屏幕阅读器路径 |
+| **文案** | 设置项说明从「参数名」改成人话 |
+
+### 🟡 B 档 · 欢迎，但请先开 issue 对齐
+
+| 方向 | 为什么需要先对齐 |
+|---|---|
+| **页签合并/拆分** | 会改变所有人的肌肉记忆，属于破坏性变更 |
+| **新增面板内视图** | 需要确认数据源已有路由支持（见 §4 路由表） |
+| **动效体系** | 需要与「背景顺滑 / 角色克制」的分层帧率原则一致 |
+| **亮色主题补全** | 令牌已备（`#f9f8f8`），但需要整套校验 |
+
+### 🔴 C 档 · 请不要做
+
+| 方向 | 原因 |
+|---|---|
+| **改动注入语义** | 注入时机/预算/分层措辞是引擎契约，前端改不了也不该改 |
+| **绕过 `saveConfigPatch` 直写配置** | 它是唯一写入出口（含校验与原子落盘），绕过会破坏配置完整性 |
+| **新增运行时依赖** | 插件受单文件/无构建约束，不允许引入构建链或 npm 运行时依赖 |
+| **改 `lib/*-pre.js` 的写入路径** | 这些文件的改动属于后端，需走另一套评审 |
+| **提交后端 bug 修到前端 PR 里** | 请分开提，便于独立 review 与回滚 |
+
+---
+
+## 三、落点地图（你改的东西住在哪）
+
+### 3.1 六处插槽（插件 UI 的物理入口，全在 `lib/client.js`）
+
+| # | 插槽 | 承载 | 定义行 |
+|---|---|---|---|
+| 1 | `sidebar.footer.action` | 侧栏入口按钮 | `client.js:5664` |
+| 2 | `shell.overlay` | 浮层面板（12 页签） | `client.js:5667` |
+| 3 | `shell.overlay` | 7 种弹窗 | `client.js:5670` |
+| 4 | `shell.overlay` | 自动接续确认卡 | `client.js:5673` |
+| 5 | `settings.section` | 设置页分区「自动记忆」 | `client.js:5676` |
+| 6 | `conversation.view` | 会话页顶栏白板看板 | `client.js:5683` |
+
+### 3.2 12 页签 → 组件 → 数据源
+
+| 页签 | 组件（定义行） | 读 | 写 |
+|---|---|---|---|
+| 概览 | OverviewTab（2315）+ GreetingCard（2115） | `/state` `/workspaces` `/greet` | `/reflect-auto` |
+| 日志 | LogsTab（2537）**+ 硬约束编辑器**（2590） | `/list` `/file` | `/rules/apply` |
+| 唤起回顾 | RefineTab（2413） | `/shadow-recent` | `/review-feedback` |
+| 记忆中枢 | MemoryHubTab（2724） | `/memory-hub` | `/memory-hub` |
+| 存储管理 | StorageTab（2850） | `/storage-manage` | `/storage-manage` `/scan-dirty` |
+| 笔记 | NotesTab（2936） | `/state` | `/note` |
+| 白板 | PlanTab（3111） | `/handoff-state` | `/handoff-continue` |
+| 反思 | ReflectionsTab（3364） | `/file` | `/reflect` |
+| 接续 | ConnectTab（3764） | `/external` `/external-view` | `/external-import` `/external-remove` |
+| 日历 | CalendarTab（3594） | `/calendar` | `/calendar` |
+| 检索 | SearchTab（3420） | — | `/recall` `/smart-recall` |
+| 工作区 | WorkspaceTab（3543） | `/workspaces` | — |
+
+面板外壳另有：`/config` `/notices` `/update-check` `/debug`；看板另有 `/kanban-board`。
+
+### 3.3 设置页 8 分组（60 个可写键，共 98 个配置键）
+
+| 分组 | 键数 | 内容 |
+|---|---|---|
+| 自动记忆引擎 | 9 | 联想开关/锚点/冷却/候选策略/思维链观察 |
+| 记忆中枢 | 8 | 情节与技能的晋升门限、高风险审批 |
+| 外观 | 2 | 欢迎向导、语言 |
+| 存储 | 3+ | 用户级/项目级/记忆根目录 |
+| 记忆窗口 | 10 | 注入预算、容量、排除源、快照节奏 |
+| 自动化 | 17 | 自动固化、无人值守、时段总结、定时班 |
+| 上下文管理 | 11 | 交接、自动接续、水位、看板模式、子代理回收 |
+| 维护 | — | 版本/更新/调试中心（只读） |
+
+**写入唯一出口**：`saveConfigPatch`（`client.js:999-1200`）→ `POST /config`。**不要绕过它。**
+
+---
+
+## 四、约束清单（提交前请自查）
+
+### 4.1 硬约束
+
+- [ ] **零新增依赖**：不引 React/Vue/构建链/任何 npm 运行时包。现有 UI 是组件库内置原语 + 手写 CSS。
+- [ ] **配置写入走 `saveConfigPatch`**：不得直写 `/config` 或本地存储绕开校验。
+- [ ] **不改注入语义**：不碰任何决定「什么时候注入、注入多少」的逻辑。
+- [ ] **失败要留痕**：新增的 fail-soft 分支必须产生**可观察信号**（面板可见或日志留痕），禁止静默吞异常。
+- [ ] **开关解耦**：单个开关不得顺带改变其它功能的行为。
+- [ ] **双语**：所有面向用户的文案必须同时给中文与英文（现有 `data-en` / 中文源文模式）。
+- [ ] **不引入授权待清的资产**：字体/图标/图片必须自带许可或使用系统字体。
+
+### 4.2 自查清单
+
+- [ ] 本地能跑起来（见 §5）
+- [ ] 键盘可达：Tab 能走到，Esc 能退出，焦点可见
+- [ ] 空态 / 加载态 / 错误态 都有处理
+- [ ] 长内容不溢出（工作区名可能很长、日志可能几千行）
+- [ ] 改设置后**界面立刻回显**（写盘成功但界面没变 = 功能坏了，这是明确的项目红线）
+- [ ] 在窄窗口（≤640px）下不横向滚动
+
+---
+
+## 五、怎么跑起来改（零安装）
+
+插件是**纯 ESM 单文件 + 手写 CSS，没有构建步骤**：
+
+```bash
+git clone https://github.com/Aik358/dsh-auto-memory.git
+cd dsh-auto-memory
+# 把 profile 指向你的开发树（link: 挂载）
+# 然后重启 DSH，侧栏就会出现「记忆」入口
+```
+
+改 `lib/client.js` / `lib/client-*.js` 后刷新页面即可看到效果。
+
+**回归自检**（改完请跑，PR 里贴上结果）：
+
+```bash
+node tools/run-smoke.mjs --timeout=90000 \
+  --exclude=-live- --exclude=m79-feature-v2-pre \
+  --exclude=m710-fv2-emit-pre --exclude=c4-fresh-install-pre
+```
+
+期望：**PASS 141 / FAIL 0 / TIMEOUT 0**（并行 ×4，约 44 秒）。
+
+---
+
+## 六、已公开的设计文献（动笔前先读）
+
+| 文档 | 内容 |
+|---|---|
+| `docs/internal/FEATURE-INVENTORY.md` | 三层功能全量清单：L1 39 条用户能力 / L2 承载面 / L3 工程细节（含全部 17 工具、49 路由、98 键） |
+| `docs/internal/ARCHITECTURE-FOR-ZCODE-20260920.md` | 面向新开发者的结构文档，61 个模块职责表 |
+| `docs/internal/ART-DIRECTION-DEEPSEEK-20260920.md` | 现行美术方向（DeepSeek 官网体系） |
+| `.dsh/skills/transitions-motion/` | 43 个生产级动效的完整源码与技法文档（含 motion token 刻度） |
+| `site/` | 项目主页（纯静态，可直接本地打开） |
+
+---
+
+## 七、视觉远期规划（哪些暂时不做，为什么）
+
+以下方向**已经论证过可行性，但明确排在远期**。原因是它们属于「重投入、收益不确定」，
+在当前阶段不适合占用主线资源。**如果你愿意做，我们欢迎——前提是先开 issue 对齐范围。**
+
+| 方向 | 结论 | 阻塞点 |
+|---|---|---|
+| **项目主页三维档案终端** | 技术已验证可行（Three.js 阵列 + 逐帧开场，本机跑通） | ① 参考项目的 3D 模型受 MIT 覆盖范围限制，**不可直接沿用**，需自建或程序化几何；② 配色需从暖灰底整体重标定为深底+品牌蓝（含光照/雾/AO）；③ 40 份档案正文需重写 |
+| **角色层（鲸鱼娘）** | 抽象线描已产出（Ark9 生图 + 本地亮度键控） | 三维场景内使用需要模型，非 2D 位图；2D 图层叠加是可行的降级方案 |
+| **亮色主题** | 令牌已备（`#f9f8f8`） | 需整套对比度与光照校验 |
+| **面板整体重排** | 需要先有特征化测试 | 前端目前回归网极薄（146 个套件里仅 3 个断言组件行为） |
+
+---
+
+## 八、怎么提 PR
+
+1. **先开 issue** 说明你想改什么、为什么、大概怎么做（B 档方向必须先走这步）
+2. Fork → 建分支 → 改 → 跑 §5 回归 → 提 PR
+3. PR 描述里请写：**改了什么 / 为什么 / 怎么验证 / 截图或录屏**
+4. 我们会用同一份 §4 约束清单 review
+5. 后端改动请单独提 PR，不要混在前端 PR 里
+
+**许可**：本插件代码以 **BSD-3-Clause** 发布。你的贡献将以同一许可合入。
+页脚的角色设定署名（CC BY-NC-SA 4.0）与上游项目署名（MIT）**请勿删除或改写**。

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/HANDOFF-CRITERIA.md

@@ -0,0 +1,92 @@
+# 交接账本 / 白板 判据表（P0-1）
+
+> 规格源：`docs/internal/WB-GRAPH-INTEGRATION-PLAN.md` §2.2（判据定义表）、§2.3（硬/软分层理由）、§2.4（校验时机）。
+> 实现：`lib/ledger-criteria-pre.js`（纯函数、零 IO、fail closed）+ `lib/index.js` 的 `writeHandoffLedger` / `writePlanSnapshot` 入口。
+> 本文档是**人与模型共读的判据原文**：模型写账本/白板前应自检，人类维护时应以本文为唯一口径。
+
+## 1. 为什么需要判据
+
+白板（`handoff/PLAN.md`）与交接账本（`handoff/handoff-*.md`）是**跨会话续命的唯一材料源**。它们一旦写坏，
+下游全部退化：权重化截断失效、注入端解析 null、接续会话拿到垃圾上下文。所以判据集中在**写入这一个门**上设防
+（不引入 dsh-graph 的状态机；白板是单对话进度快照，七阶段迁移图是为多目标管理设计的）。
+
+## 2. 判据定义表
+
+### 2.1 交接账本（ledger）—— 四段式硬判据
+
+| ID | 范围 | 判据 | 层级 | 校验方式 | 拒绝后果 |
+| --- | --- | --- | --- | --- | --- |
+| **H1** | 全篇 | 四段标题**齐全且逐字匹配**：`## 任务状态` / `## 目标` / `## 已试方案与失败原因` / `## 进度与下一步` | **硬·拒绝** | `parseHandoffLedgerPre()`（`lib/handoff-anchor-pre.js`）返回非 null，且四标题集合与权重表相等 | 拒绝写入，返回缺失段清单 |
+| **H2** | 全篇 | 各段 body **非空**（不得只有标题） | **硬·拒绝** | 逐段 trim 后长度 > 0 | 拒绝写入，指出空段 |
+| **H3** | 全篇 | **无占位符行**：段 body 不得只含 `(待补充)` / `TODO` / `同上` / `略` / `N/A` | **硬·拒绝** | 占位符黑名单集合匹配（借 dsh-graph `CRITERIA_PLACEHOLDERS` 技巧） | 拒绝写入 |
+| H4 | 全篇 | 无未闭合代码围栏 | 软·警告 | 围栏计数为偶 | 通过，记 warning |
+| P-H1 | 「进度与下一步」段 | 至少一行可执行下一步（含文件路径或命令） | 软·警告 | 正则 | 通过，记 warning |
+| P-S1 | 全篇 | 含至少一处前瞻内容（`下一步\|待办\|计划\|todo`） | 软·警告 | 正则 | 通过，记 warning |
+
+### 2.2 白板（PLAN）
+
+| ID | 判据 | 层级 |
+| --- | --- | --- |
+| P-H1 | 非空正文（不得为空文件） | **硬·拒绝** |
+| P-H2 | 含至少一个 `##` 级标题 | **硬·拒绝** |
+| P-S1 | 含「下一步 / 当前状态 / 待办」之类进展线索 | 软·警告 |
+
+## 3. 硬 / 软分层的理由
+
+- **硬判据只拦「结构性损坏」**：段落缺失、段落全空、占位符——这些会让下游解析直接失败或产出误导性上下文。
+- **软判据只记录不拦**：文案质量、前瞻性、详细程度是**判断问题**，机器判不准；拦了会误伤正常写入（fail closed 的代价必须可控）。
+- **fail closed**：判据函数本身抛异常时按「拒绝」处理，而不是放行——写坏材料的代价 > 少写一次的代价。
+
+## 4. 校验时机（两层）
+
+1. **写入前（代码校验，强制）**：`writeHandoffLedger` / `writePlanSnapshot` 入口处调用，硬判据不过 → 返回
+   `{ok:false, gate:'criteria', report}`，附**可执行改写指引**（缺哪些段 / 哪段空 / 占位符行原文）。
+2. **写入后（事件，确认）**：校验通过或带软警告的事实作为**确认事件**追加到 `handoff/events.jsonl`
+   （`criteria.passed` / `criteria.warned`），供刷新仪式轮询、GUI 面板与图重建消费。
+
+> **登记 ≠ 合格**：写入成功只代表「写进去了」，判据事件才代表「写合格了」。两者分离，防止模型用一次敷衍写入骗过仪式等待。
+
+## 5. 正例
+
+```markdown
+# 交接账本 · 2026-09-16 14:30
+
+## 任务状态
+- 已完成 13 项修复，全量回归 PASS 96 / FAIL 0 / TIMEOUT 0。
+
+## 目标
+- 补 P2/P3 的输入端与检索端，默认仍走旧白板。
+
+## 已试方案与失败原因
+- 方案：在 `apply()` 内 `await loadConfig()` → 失败原因：cordis 不 await apply 返回值，工具注册落进微任务。
+- 方案：把闸门写成 `this.wbGraphGatePre()` → 失败原因：抽取式沙箱里 `this` 是裸对象，原型方法不可达。
+
+## 进度与下一步
+- 下一步：跑 `node tools/run-smoke.mjs` 确认 FAIL 0。
+```
+
+## 6. 反例
+
+```markdown
+# 交接账本
+
+## 任务状态
+(待补充)
+
+## 目标
+
+## 进度与下一步
+同上
+```
+
+**为什么被拒**：缺「已试方案与失败原因」段（H1 不过）；「任务状态」只含占位符（H3 不过）；「目标」段为空（H2 不过）。
+
+## 7. 引用关系
+
+| 位置 | 作用 |
+| --- | --- |
+| `lib/ledger-criteria-pre.js` | 判据实现（纯函数、零 IO、fail closed） |
+| `lib/handoff-anchor-pre.js`（权重表 + `parseHandoffLedgerPre`） | 段解析与权重化截断的真源 |
+| `lib/index.js` → `writeHandoffLedger` / `writePlanSnapshot` | 写入咽喉（校验插入点） |
+| `handoff/events.jsonl` | 判据确认事件（append-only） |
+| `docs/internal/WB-FORMAT-CONVENTION.md` | tag 语法、条目 id（`mem_<32hex>`）、锚点行的格式约定 |