前言¶
DeepSeek Harness (dsh) 的核心設計理念是“一切皆插件”。在構建智能體應用時,會話上下文通常僅限於當前對話窗口,無法跨越多次會話或長時間週期保存關鍵信息。這導致智能體需要反覆重複已知信息,或者丟失用戶的歷史偏好。dsh-plugin-memory 插件通過持久化知識圖譜的方式,解決了智能體長期記憶與偏好追蹤的問題。
插件簡介¶
該插件由 menotbobbybrown 維護,遵循 MIT 許可證。它爲 dsh 智能體提供了長期事實存儲、偏好記錄以及基於語義和關鍵詞的檢索能力。通過集成 Cordis 框架,它還能自動向智能體暴露記憶工具。
核心功能¶
- 長期事實與偏好存儲:支持跨會話保存用戶習慣、代碼規範、架構決策等。
- 語義與關鍵詞檢索:提供相關度排名,能夠根據語義或關鍵詞精準召回所需的記憶片段。
- CLI 管理:提供
dsh-memory命令行工具,支持直接在終端進行記憶的增刪改查。 - Cordis 原生支持:自動向智能體暴露
memory_remember和memory_recall工具,使其在對話中能主動讀寫記憶。
安裝與啓用¶
在終端中執行以下命令即可安裝插件:
dsh plugin --profile web add "github:menotbobbybrown/dsh-plugin-memory"
典型用法¶
安裝完成後,可以通過 CLI 或程序化接口使用記憶功能。
CLI 使用¶
# 列出所有已存儲的條目
npx dsh-memory list
# 添加新的偏好或事實,並打上標籤
npx dsh-memory add "User prefers TypeScript and strict ESLint rules" --type preference --tags coding,style
# 搜索記憶,支持語義與關鍵詞匹配
npx dsh-memory search "coding style"
# 根據 ID 刪除特定記憶
npx dsh-memory forget <id>
程序化使用¶
在 Cordis 上下文中使用:
import { Context } from 'cordis';
import * as MemoryPlugin from 'dsh-plugin-memory';
const ctx = new Context();
ctx.plugin(MemoryPlugin);
// 存入記憶
ctx.memory.remember('Target database is PostgreSQL 16');
// 從記憶召回
const results = ctx.memory.recall('database version');
注意事項¶
- 運行權限:該插件以當前 DSH 進程的權限運行,請確保來源可信。
- 許可證:插件分發遵循 MIT License。
- 生態背景:DSH 社區目錄(如 SkillHub)與 DeepSeek / 幻方無官方從屬關係,請通過 GitHub 源碼覈實插件功能。
結語¶
dsh-plugin-memory 爲 DeepSeek Harness 提供了構建長期記憶能力的基礎設施。通過簡單的 CLI 或 API 調用,智能體可以輕鬆建立用戶畫像和歷史知識庫,從而在多輪對話中保持上下文的一致性。
插件目錄:https://www.skillhub.cn/plugins/menotbobbybrown/dsh-plugin-memory
GitHub 倉庫:https://github.com/menotbobbybrown/dsh-plugin-memory