本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-layered-memory

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-layered-memory

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 每个子目录是独立的自包含单元，欢迎以 PR 提交新技能/插件，或提 Issue 反馈问题。
• 贡献要求：自包含（自带脚本/模板/文档）、许可证清晰（建议 MIT）、不写死密钥与本机绝对路径。
• 新增技能的入口文档统一为 SKILL.md，DSH 插件另附 cordis.patch.yml 与 package.json。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后记忆存放在哪里？

默认存放在用户主目录下的 ~/.dsh/memory/（macOS/Linux 为 ~/.dsh/memory，Windows 为 %USERPROFILE%.dsh\memory）。开启 autoNamespace 时会自动按 workspace 目录名 + git 分支创建子目录进行隔离；如需自定义可在 profile 配置中设置 memoryDir。

写入记忆必须提供 evidence 吗？

是。memory_write 与 memory_accept 都强制要求 evidence（行动验证公理），未提供会被工具直接拒绝。evidence 描述本次成功验证该信息的工具调用或实测结果，未验证的信息不允许写入正式记忆。

安装后工具列表里没有 memory_read 等工具怎么办？

默认采用渐进式暴露机制（progressive=true），所有 12 个工具仅在调用 memory_activate 或 memory skill 加载成功后挂到当前 Agent。skill 加载通常会自动激活；若工具仍未出现，调一次 memory_activate 即可。

如何回滚误改或归档过的记忆？

用 memory_rollback 工具，传入 topic 与 entry_type（fact/sop），会自动从 .history/ 取最近一次快照恢复；memory_archive 仅在 L1 索引和 memory_read 中隐藏条目，文件仍保留在 archive/，同样可通过 memory_rollback 还原。

卸载后会删除已写入的记忆吗？

不会。记忆文件全部以普通 Markdown/JSON 形式存储在 ~/.dsh/memory/（或其子命名空间目录），卸载插件仅移除插件自身，记忆文件可继续浏览或在其他 DSH 实例中复用；如需彻底清除可手动删除该目录。

L1 索引超过 30 行会怎样？

写入后会提示 over_limit=true。运行 memory_index 仅重建索引；运行 memory_maintain 会按访问热度压缩 L1 自动段，只保留活跃条目，被压掉的 fact/sop 仍存在文件中，但不再出现在 L1 索引里。

自动蒸馏候选（pending）是什么？

当 autoPending=true（默认）时，每轮 turn/end 会把本回合成功的工具调用写入 pending/ 候选区，不会自动入正式记忆。需要用 memory_pending 查看候选，memory_accept 并提供 topic/entry_type/evidence 后才会被写入 L2/L3。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22.19

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则