前言¶

在 DeepSeek Harness (DSH) 的开发或使用场景中，会话结束通常意味着上下文丢失。为了解决这个问题，dsh-maestro-memory 插件提供了持久化跨会话记忆和待办事项的能力。它将数据保留在 ~/.dsh/memories 中，使 AI 能够在会话之间保持连续性。

是什么¶

这是一个 DSH 插件，提供持久化跨会话记忆和待办事项。它维护 ~/.dsh/memories 文件。该插件由 ddtcorex 维护。

安装与启用¶

在安装前，请确保环境满足以下要求：
- Node.js 22+
- pnpm 11+
- DSH deepseek-harness master 版本

安装插件时，使用以下命令：

dsh plugin --profile web add github:ddtcorex/dsh-maestro-memory#<tag-or-sha>

插件包含 cordis.patch.yml 配置文件，安装时无需重复添加。该配置文件用于定义插件的核心行为，包括记忆目录、快照顺序以及写入控制等参数。

核心功能¶

该插件提供以下核心功能：

• 多轨道记忆管理：支持五条记忆轨道，包括全局、用户、项目、分支和日常记忆。
• 待办事项管理：提供 maestro_todo 工具，用于管理跨会话的待办事项。
• 敏感信息过滤：memory 工具会自动过滤敏感信息，避免泄露 API key、密码等。
• 健康检查：提供健康检查端点，用于监控插件运行状态。

典型用法¶

在 DSH 环境中，可以通过以下工具进行操作：

• 管理记忆轨道：使用 memory 命令在五条轨道中添加、查看或管理条目。
• 管理待办事项：使用 maestro_todo 命令管理跨会话的待办事项列表。
• 修复记忆数据：如果发现记忆文件损坏，可以使用 memory.repair 命令修复条目，例如拆分粘连的条目或移除重复项。
• 检查健康状态：访问 /dsh-maestro-memory-health 端点查看插件的运行状况和统计信息。

注意事项¶

使用该插件时需要注意以下几点：

• 版本要求：确保 DSH 版本为 deepseek-harness master，且 Node.js 和 pnpm 版本符合要求。
• 配置修改：writeGuard 配置在 apply() 时读取，修改该配置需要重启 DSH 进程。
• 同步逻辑：归档同步逻辑较为复杂，需要在所有机器上执行一致的操作，否则可能导致数据不一致。
• 合规性：插件以当前 DSH 进程的权限运行，安装前请检查源码与许可证。

短结尾¶

dsh-maestro-memory 通过文件持久化解决了 DSH 上下文丢失的问题，适合需要长期记忆和任务跟踪的场景。更多细节可参考 GitHub 仓库。