dsh-memory

DeepSeek Harness 的长期记忆插件：把跨会话需要记住的事情（用户偏好、项目事实、会话摘要、可复用知识）持久化到磁盘，并在每个新会话开始时自动注入给 Agent。

特性

• 四类记忆：preference（偏好，应默认遵守）、fact（项目/环境事实）、summary（会话/任务摘要）、knowledge（可复用知识/经验）
• 两种作用域：global（所有项目适用）、project（按项目隔离，slug 自动从会话 cwd 推导）
• 四个 Agent 工具：memory_write / memory_read / memory_search / memory_delete
• 会话开始自动注入：监听 agent/pre-step，在第一步把全局+项目记忆渲染成带字节预算的 `` 注入；内容寻址去重，resume 会话不会重复注入
• 原子持久化：临时文件 + rename，崩溃不产生撕裂文件；损坏的 unit 优雅降级为空而不是崩溃
• 半自动：写入由 Agent 判断（建议先 memory_search 查重再写），符合你的「半自动」选型

安装

dsh plugin --profile  add dsh-memory
# 或从本地 checkout 安装
cd  && dsh plugin --profile  add .

配置

在 profile 的 cordis.patch.yml（或 --patch 覆盖）中配置：

- id: memory
  config:
    enabled: true
    root: C:/Users//.dsh/memory   # 可选；默认 $DSH_HOME/memory（支持 ~ 前缀）
    maxBytes: 4000         # 注入预算（UTF-8 字节），默认 4000
    maxEntryBytes: 512     # 注入时单条内容上限，默认 512
    injectOnStart: true    # 会话开始自动注入，默认 true
    searchLimit: 20        # memory_search 默认返回上限，默认 20

工具

memory_write

{
  "type": "preference",
  "scope": "global",
  "content": "用户偏好中文回复",
  "tags": ["language"],
  "importance": 4
}

• type: preference | fact | summary | knowledge（必填）
• scope: global | project（必填；project 自动绑定当前会话 cwd）
• content: 记忆内容（必填）
• id: 已存在记忆的 id，传了则更新该条
• tags: 检索标签（可选）
• importance: 1..5 重要度（可选，注入与搜索排序参考）

memory_read

按作用域（+ 可选类型过滤）列出记忆，最新在前。

memory_search

在全局+当前项目记忆中检索：query（内容/标签不区分大小写包含匹配，多词须全命中）、tags（交集）、type 过滤；按重要度、再按更新时间排序。

memory_delete