dsh-auto-memory 使用指南
为 DSH Web GUI 提供三层自动记忆引擎:每轮对话自动沉淀、关键词检索与跨工具记忆继承,含可视化面板与日历视图。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-auto-memory
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add @a9i5k4/dsh-auto-memory
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 主动提醒 — AI 在对话里发现 deadline、约定或承诺时,自动写进日历,并在之后的会话中赶在时间到达前提醒你(
calendar_add/calendar_done/calendar_remove)。 - 暖心问候 — 每个时段(早上 / 下午 / 晚上)都有 AI 写的问候,还会提起你今天最重要的工作;离开超过一小时回来,它会说「欢迎回来」并帮你补上这段时间发生了什么。
- 它自己写日志 — 每轮对话结束,一个小型子代理悄悄判断什么值得记,按主题把条目追加进今日日志;长期决策升格到项目笔记、跨项目规则升格到用户级记忆。你永远不用记得去记录。
- 每日反思 — 结构化记录成果 / 教训 / 下一步,想回顾时可以看看一天到底过得怎么样。
- 有人情味的日历 — 紧急程度用语义色区分,07:00-22:00 当天时间轴,支持地点与提醒字段;AI 从上下文帮你维护,而不是让你去填表单。
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
安装后没有看到「记忆」侧边栏入口怎么办?
必须在 DSH 的 web profile 目录(~/.dsh/profiles/web)下安装,并在该目录 package.json 的 dsh.profile.bundles 数组里追加 @a9i5k4/dsh-auto-memory,然后重启 dsh web 才会生效;只装包不重启或没追加 bundle 行都不显示。
记忆文件存在哪里?重装 DSH 会丢吗?
记忆以纯文本 Markdown 保存在用户主目录下:用户级在 ~/.dsh/memory/MEMORY.md、项目记忆统一在 ~/.dsh/memory/workspaces/{workspace}/,不写入 DSH 安装目录,重装或迁移主目录都不影响;旧版分散在工作区里的 .dsh-memory 会在首次运行时自动迁移到集中根目录(旧文件保留不删)。
自动沉淀会不会消耗很多 token?
默认开启且每天最多调用 8 次、间隔可配,非工作时间冷却自动翻倍;静态规则挂在系统提示词里保持字节级稳定,动态记忆走运行时快照,DeepSeek 前缀缓存可全程命中以减少重复编码消耗。
能继承 CodeBuddy / Claude Code / Codex 的记忆吗?
能。插件会自动检测 /.workbuddy、/.codebuddy、/.claude、/.codex 等目录下的记忆文件与历史会话;接入(import)只记录源文件路径指针,不复制内容,需要时按需读取,避免外部脏内容污染本地记忆。
记忆里会泄露密钥吗?
注入到 prompt 的内容会过滤掉疑似密钥/令牌的段落,文件本身完整保留;但密钥本身仍属敏感信息,README 明确建议不要主动写入或粘贴密钥到对话里。
怎么升级这个插件?
在 ~/.dsh/profiles/web 目录执行 pnpm up @a9i5k4/dsh-auto-memory(或 npm install @a9i5k4/dsh-auto-memory@latest),然后重启 dsh web;设置 → 自动记忆 页面提供一键升级按钮和「检查更新」能力。注意 pnpm v11 默认不允许安装发布不足 1 天的版本,当天发版需要在 pnpm-workspace.yaml 加 minimumReleaseAge: 0 或指定显式版本。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 未声明
- Node: >=22.19.0 (建议,含 zstdDecompressSync 完整支持;<22 仍可运行但会话索引回退明文读)
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则