@a9i5k4/dsh-auto-memory 2.5.3 → 3.0.1

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 页内容不能少**。