前言¶

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 官方無從屬關係。