跳到主内容

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

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则