前言¶
在 DeepSeek Harness (DSH) 的 Web 环境下构建智能体时，上下文记忆往往是一个难点。默认情况下，对话是独立的，无法自动积累长期知识。dsh-simple-memory 插件旨在解决这一问题，它提供了一套基于零代码存储的检索式记忆方案。不需要配置数据库或向量数据库，插件通过文件系统与模型交互，帮助开发者在项目旁维护一份结构化的记忆仓库。
插件定位¶
这是一个由社区成员 a903067276-rgb 独立开发的非官方插件。它采用 Markdown 文件作为存储介质，利用 DSH 的插件系统作为入口，将记忆管理融入日常对话流中，避免中断正常工作流。
核心能力¶
会话索引注入¶
每次开启新会话时，插件会在 agent/pre-step 阶段注入三部分内容：
1. 当前项目进度：显示最近的项目状态，防止模型使用过期信息。
2. 最近 6 条笔记：自动抓取最近编辑过的笔记标题和首行结论，帮助模型快速关联上下文。
3. 分类计数与搜索入口：提供全局或项目维度的记忆概览。
四动作记忆菜单¶
点击输入框左侧的灯泡图标，会弹出一个四动作菜单，用于直接操作记忆：
* Recall (回顾)：审查当前对话轮次，列出值得记忆的候选内容（包括决策、坑点、偏好），确认后写入。
* Promote (提升)：整理暂存池 (staging.md) 和梦境池 (dreams.md)，确认后将其提升至全局或项目目录。
* Browse (浏览)：在侧边面板中查看、搜索和阅读已存储的记忆，无需占用对话回合。
* Dream (梦境)：随机抽取 3-5 条记忆，寻找跨项目的共性、矛盾或可复用方案，生成洞察并写入梦境池。
记忆格式与限制¶
插件强制记忆文件遵循特定格式：分类-主题.md，且单个文件大小限制为 2KB。这种限制迫使记忆条目保持精简，便于检索。
跨会话搜索¶
启用全文本索引后，可以使用 session_search 功能在过往会话记录中搜索关键词（时间、工作区、标题、最佳匹配片段）。
梦境池机制¶
dreams.md 用于存放生成的跨项目洞察。这些内容包含来源记忆、连接关系和目标建议，同样需要手动确认提升后才会生效。
安装与启用¶
在终端中执行以下命令添加插件：
dsh plugin --profile web add "github:a903067276-rgb/dsh-simple-memory#main"
添加完成后，重启 dsh web。进入设置页的 “Memory” 板块，点击 “Initialize memory repo” 即可一键初始化记忆仓库的目录结构。
使用流程¶
日常记忆记录¶
在对话过程中，当需要记录关键信息时，点击输入框左侧的灯泡图标。选择 Recall 模式，模型会列出候选条目，确认无误后点击写入。或者，选择 Dream 模式，让模型基于已有记忆生成新的洞察。
记忆整理与提升¶
在 Promote 模式下，插件会列出暂存池和梦境池中的内容。你需要判断这些内容的归属（是放入全局 common/ 目录，还是放入特定项目），确认后执行提升操作。
浏览与搜索¶
点击 Browse 模式，可以在弹出的面板中查看记忆列表。面板支持按项目或全局分组，并提供搜索框用于快速定位内容。
工作原理与文件结构¶
插件的核心是文件系统。默认记忆根目录位于 ~/Documents/DSH/memory/（可在设置中修改）。
memory/
├── common/ # 全局经验，跨项目复用
├── projects/ # 按项目分区的记忆
├── references/ # 冷知识库，仅搜索
├── archive/ # 归档区，遗忘的记忆
├── staging.md # 待提升池
└── dreams.md # 梦境洞察池
所有记忆文件均以 Markdown 格式存储，插件负责解析这些文件并将其内容注入到 DSH 的上下文中。
适用场景与注意¶
适用场景¶
- 需要长期维护项目上下文的智能体开发。
- 需要在多个项目间复用经验（如代码规范、踩坑记录）。
- 希望保持零配置、零数据库依赖的开发者。
注意事项¶
- 平台支持：macOS 为开发验证环境，Linux 和 Windows 预期可用但未经过充分测试。
- 依赖要求：DSH Web 版本需 >= 0.1.0-rc.6。插件与旧版 DSH 的兼容性为尽力而为。
- Git 依赖：可选。安装 Git 后，整个记忆根目录会初始化为一个 Git 仓库，提供回滚安全机制。
- 非官方项目：该项目由社区成员维护，请根据需要自行检查源码与许可证。
