前言¶

DeepSeek Harness (DSH) 遵循“一切皆插件”的理念。在实际使用中，Agent 每次开启新会话往往会丢失之前的上下文，导致需要重复确认偏好或事实。

dsh-pi-memory 是 Pi 生态中流行记忆插件 pi-memory 的 DeepSeek Harness 移植版。它为 DSH 提供跨会话的持久记忆能力，支持长期事实记录、每日日志追加、待办清单管理，以及可选的语义搜索。

功能¶

插件提供以下核心工具：

• memory_write：写入长期记忆或今日日志。
• memory_forget：删除记忆条目并生成恢复记录。
• memory_restore：使用恢复 ID 恢复被删除的条目。
• memory_read：读取记忆文件或列出每日日志。
• scratchpad：管理待办清单（添加、完成、撤销、清理）。
• memory_search：跨所有记忆文件搜索（需要 qmd 支持）。
• memory_status：检查健康状态，包括文件位置、qmd/collection/embeddings 状态。

所有记忆内容以 Markdown 文件形式存储在 $DSH_HOME/agent/memory/ 目录下。

安装¶

插件尚未发布到 npm，需通过本地路径安装。

# 1. 克隆仓库并安装依赖
git clone https://github.com/GongYuanCaiJi/dsh-pi-memory.git
cd dsh-pi-memory && npm install

# 2. 添加到 DSH Profile（headless 模式需先添加 @deepseek-ai/dsh-headless@next）
dsh plugin --profile "$P" add @deepseek-ai/dsh-headless@next
dsh plugin --profile "$P" add .

使用¶

安装后，Agent 会自动加载记忆上下文。

• 基础记录：直接让 Agent 记住事实。

    你：记住：我偏好深色模式。
    Agent：...

• 查询记忆：在全新会话中查询。

    你：我上次说过偏好什么？
    Agent：...

• 待办清单：使用 scratchpad 工具管理任务。
• 提高可搜性：在记忆内容中使用 #tags 和 [[wiki-links]]。

    #preference [[editor]] 用户偏好 Neovim + LazyVim 配置。

• 检查状态：运行 memory_status 确认记忆文件与 qmd 状态。

注意事项¶

• 安装方式：当前仅支持本地路径安装，未发布到 npm。
• 语言：插件注入给 Agent 的提示词与记忆上下文模板为上游英文原文。
• 搜索依赖：memory_search 需要 qmd 支持。首次启用语义搜索时，qmd embeddings 需要下载模型（约 1 分钟）。
• Windows 兼容性：在 Windows 上，若 qmd 在 Shell 中可用但 DSH 中不可用，需确保 node_modules 在 PATH 中，或插件会通过 Node 直接调用 qmd 入口。
• 获取最新状态：在 stable 模式下，应使用 memory_read 或 memory_search 获取最新状态，而不是依赖注入的上下文。

生态背景¶

DeepSeek Harness (DSH) 遵循“一切皆插件”的理念。此插件由 GongYuanCaiJi 维护，代码与逻辑 100% 来自 pi-memory（MIT 许可证）。社区目录（SkillHub）为独立站点，与 DeepSeek 官方无从属关系。