# 记忆日历 · 用户说明书 适用于当前安装版本（Beta 2.0 开发中）。 这份说明写给使用者，不要求懂代码。 --- ## 1. 它是什么 记忆日历是 DSH 的本地记忆插件。 它做三件事： 1. **存**：把过去的对话整理成“文本包”，存到本地； 2. **找**：你问“上次那个…”，它去本地包和标签里找； 3. **回原文**：找到后能回到原始对话事件，不只看摘要。 它**不会**： - 自动上传任何内容； - 自动同步到云端； - 把整段记忆塞进每一轮对话； - 代替你判断“这段该不该记”。 数据只在本机： ```text <工作区>\.memory-calendar ``` --- ## 2. 怎么打开 在 DSH 里打开： > **设置 → 记忆** 会看到「记忆日历」。 主要区域： - **通知与确认**：通知偏好； - **大脑**：当前工作区使用哪些记忆库； - **最近的包**：已经存下来的对话包； - **子标签**：用于检索的标签； - **图谱**：大脑之间的连接关系。 --- ## 3. 日常怎么“让它想起来” 不需要记命令。 直接在对话里问，例如： - “上次那个记忆插件怎么验证的？” - “我之前问过 ComfyUI 部署吗？” - “三个月前我说过冰锥什么来着？” - “仔细回忆一下，别漏。” 模型会自己决定要不要查记忆，以及查多深。 ### 回忆强度 - 默认是**正常强度**； - 你说“仔细 / 完整 / 别漏 / 好好想”，会自动加大； - 默认找不到时，会自动再搜一次更深的； - 如果仍然没找到，会明确说“没找到”，而不是硬编一个。 --- ## 4. 怎么让它“记住这个” 直接说： > “记住这个：……” 它会把这句话**逐字**保存到当前工作区的 pin 里，不做摘要、不改写。 查看或删除： - “我让你记住过什么？” - “把那条 pin 删掉” > 注意：目前 pin 是对话里的工具能力，**没有单独的 pin 管理页面**。 --- ## 5. 怎么减少记录 ### 临时不想新增、不想检索 打开： > **设置 → 记忆 → 关闭本工作区记忆** 开启后： - 当前工作区不再新增包； - 当前工作区不再参与检索； - **已有包不会被删除**； - 其他工作区不受影响。 它只是“静音”，不是“删除”。 ### 想彻底分开 用不同的工作区，或断开大脑连接。 不同工作区默认各自有独立的大脑。 --- ## 6. 大脑与工作区 - 一个工作区默认使用一个大脑； - 连一个大脑 = 独立； - 连多个大脑 = 共享/只读合并； - 一个都不连 = 插件不激活。 图谱里可以： - 建立连接； - 断开连接； - 放大查看； - 切换浅色/深色。 写盘相关操作会先确认，不会静默改图。 ### 左侧工作区抽屉 图谱左侧有一条竖排按钮： > **工作区** 点开后是工作区抽屉。 - 抽屉里的 **工作区** 和侧边栏的 **会话** 不是一回事： - 一个工作区可以包含多个会话； - 抽屉显示的是工作区，以及它当前可见的会话数。 - 每行显示： - 工作区名字； - `勾选数/可见会话数`； - 「当前」「隐藏/显示」。 - `▸` 展开后，可以在抽屉里看到该工作区的会话列表。 隐藏工作区： - 只影响图谱显示； - 不关闭记忆； - 不删除连接； - 已有连接和包都保留。 隐藏项可以**拖回画布**重新显示。 ### 会话的勾选和拖拽 展开工作区后，每个会话前面有复选框： - 勾选：图谱里显示这个会话节点； - 取消：图谱里不显示； - 「全选 / 清空」可以批量调整。 拖拽会话： - 只调整显示顺序； - **不会**改动 DSH 的会话归属； - **不会**写数据； - 仅保存在本机界面设置里。 图谱里： ```text 大脑 → 工作区 → 勾选的会话 ``` - 工作区不能连接工作区； - 会话是终点，只读，不再继续展开； - 会话节点不参与记忆连接，只用于查看结构。 ### 右键菜单 在节点上右键会出现菜单（例如「复制路径」）。 - 鼠标离开节点或菜单后 **0.5 秒**自动关闭； - 鼠标移入菜单会取消关闭计时。 --- ## 7. 自动检查点与提示 聊天变长时，插件会在上下文压力较高时自动打包一次，避免压缩后丢失细节。 你会看到： - 屏幕**顶部居中**一条提示： > 记忆检查点已保存 - 如果检测到上下文被压缩： > 上下文已压缩，记忆已补包 说明： - 提示约 10 秒后消失； - 不挡点击； - 它不是 Windows 系统通知，只在 DSH 应用内显示； - 不是每次聊天都会提示，只有实际完成检查点时才会。 当前已验证： - 50% 档检查点； - 手动检查点。 70% / 85% 档还在观察中。 --- ## 8. 包里到底有什么 “文本包”目前只保留： - 用户文本； - 助手文本； - 时间、标签、来源 session 等元数据。 不包含： - 推理过程； - 工具完整输出； - 附件原文件； - 被脱敏的密钥。 所以现在的准确说法是： > **文本包**，不是“无损归档”。 “原始归档（完整保存）”是 **Beta 3.0** 的目标，不是当前状态。 --- ## 9. 数据安全 - 全部本地； - 不上传、不联网同步； - 包写入使用临时文件替换，避免半截文件； - 自动检查点有并发锁，不会同时写坏索引； - 关闭本工作区记忆不会删旧包。 建议： - 升级 DSH 或插件前，先备份 `.memory-calendar`； - 不要在主 profile 安装 `0.2.1-alpha.*` 的实验 bundle；之前出过会话崩溃。 --- ## 10. 常见问题 ### 问：为什么它不主动提旧事？ 这是故意的。默认不注入整段记忆，避免每轮烧 token。需要时你问，它才查，如果需要主动提及往事，可以寻找其他插件搭配使用。 ### 问：为什么有的时候记忆搜不到？ 可能是： - 那段还没打包； - 关键词太泛； - 发生在很久以前； - 当前工作区关闭了记忆。 可以换一种说法，或说“仔细找找”。 ### 问：为什么没有弹窗？ 先确认： 1. 当前页面加载的是最新客户端； 2. 最近确实触发过记忆检查点； 3. 提示在屏幕**顶部居中**位置。 ### 问：关闭记忆后，旧包会删吗？ 不会。只是不新增、不检索。 ### 问：能看到包里的原文吗？ 可以。让模型用 `memory_read` 读包内文本，或用 `memory_expand` 回原始对话事件。 --- ## 11. 当前限制 - 70% / 85% 自动检查点尚未真实触发验证； - 没有 Windows 系统通知栏通知； - 没有独立的 pin 管理页； - 没有云同步、多人共享； - 没有语义向量检索（按计划，暂不做）； - 插件本地 HTTP 路由还没有真正的 token 鉴权。 --- ## 12. 总结 > 它是一个**本地、可关、可查、能回原文**的记忆日历。 > 你不问，它不检索读取；你问，它去翻记忆库。