dsh-task-memory

  

English | 中文

面向 DeepSeek Harness 的任务隔离长期记忆插件。

记忆按任务分库，保存在 ~/.dsh/storages/task-memory/。写入某一任务的事实，对其他任务默认不可见，除非主动切换任务。

目录页： dsh.pub/zh/plugins/dsh-task-memory

为什么做这个

多数 DSH memory 插件是全局或按 workspace 共享的。本插件把 task（任务） 当作隔离边界：

1. 默认任务：由 session 的 cwd 推导 2. memory_bind_task：把当前 session 绑到指定任务 vault 3. 搜索 / 读取 / 提示注入：不会跨任务边界，提示注入按 agent 级作用域注册——每个会话的系统提示只注入它自己任务的记忆

快速开始

# 安装到 web profile（生产环境建议钉完整 commit SHA）
dsh plugin --profile web add "github:wangyihao0001-oss/dsh-task-memory"

# 或通过目录 CLI
npx dshpub add wangyihao0001-oss/dsh-task-memory --profile web

重启 Web UI（或重启 profile），然后在会话里：

1. memory_bind_task — 例如 taskId: "my-app"（可选 title） 2. memory_remember — key: "stack"，content: "Node 22 + Postgres"，可选 pinned: true 3. memory_recall / memory_search — 在同一任务内读回 4. memory_current_task — 确认当前 session 落在哪个 vault

工具

不要把密钥、token 等敏感信息写进记忆。

安装 / 验证 / 卸载

# 安装
dsh plugin --profile web add "github:wangyihao0001-oss/dsh-task-memory#<40位SHA>"

# 确认 bundle 层已出现
dsh --profile web --dump-config

# 从 profile 移除
dsh plugin --profile web remove dsh-task-memory

安装或卸载后，请重启 dsh web（或重启 profile），让 Cordis 层重新加载。

卸载不会删除 ~/.dsh/storages/task-memory/ 下的 vault 文件——需要备份或清理请自行处理。

本地开发（不安装）

npm install
npm run build
npm test        # node:test 单测
npm run smoke   # 构建 + 冒烟

开发时 link 本地 checkout：

dsh plugin --profile web add "$(pwd)"

若从 DSH 源码仓库启动：

pnpm dsh web --patch /absolute/path/to/dsh-task-memory/cordis.dev.yml

请把 cordis.dev.yml 里的绝对路径改成指向本仓库编译后的 lib/index.js。

配置

cordis.patch.yml 默认值：

injectLimit: 8           # 注入到提示中的记忆条数上限
injectMaxChars: 2400     # 注入块软字符预算
injectMaxEntryChars: 400 # 单条记忆在注入块中的字符上限（超出截断）
injectPrompt: true       # 是否为当前任务注入置顶/近期事实
maxEntries: 500          # 每个 vault 的条目上限（>= 1）；超出时淘汰最旧的非置顶条目
                         # （置顶永不被淘汰；新增超出上限会被拒绝；对已有 key 的更新不受容量限制）

可选 storageRoot 覆盖默认目录 ~/.dsh/storages/task-memory。

存储与可靠性

~/.dsh/storages/task-memory/
  <task-id>.json

每个文件形如：

{
  "taskId": "<task-id>",
  "title": "<title>",
  "updatedAt": 0,
  "entries": [
    {
      "id": "m_…",
      "key": "<key>",
      "content": "…",
      "tags": [],
      "pinned": true,
      "createdAt": 0,
      "updatedAt": 0
    }
  ]
}

• 文件是纯 JSON，可直接手工编辑或备份
• 写入通过临时文件 + 原子 rename，读取永远看到一致快照
• 同一任务的写入（含 memory_bind_task 的标题更新、save、update）在进程内串行化（per-task 锁），并行 agent 并发写不会丢更新。读改写请优先用 update，避免 load → 修改 → save 覆盖并发写入
• 置顶条目永不被淘汰；vault 满且可淘汰的只有置顶条目时，新增 key 会被拒绝并返回明确错误（避免「刚写入就被淘汰」的静默丢失）；对已有 key 的原地更新（upsert）不受容量限制，仍会尽力收缩
• 启动时自动清理崩溃残留的 *.tmp（只清理超过 1 小时的，避免误删其他进程的进行中写入）

模型体验

当 injectPrompt 为 true 时，插件会把一段简短记忆块注入当前 agent 会话的系统提示：

• 只包含该会话绑定的 vault（或 cwd 推导的默认任务）
• 优先置顶条目，其次近期条目，受 injectLimit / 字符预算约束
• 其他会话、其他任务的记忆不会出现在这段注入里

超出提示预算的内容，仍可通过工具显式 recall / search。

已知限制

• 目前是 Host-only 组合包：尚无浏览 vault 的 Web UI（见路线图）
• 搜索是词法匹配（英文 token + 中文 bigram），不是向量检索
• 隔离边界是本插件内的 task id，并不沙箱化整个 DSH
• dsh.pub 上架是自动契约检查，不等于安全审计
• 请勿在记忆中存放凭据、token 或个人隐私

兼容性

• Node.js >= 20
• peer 依赖见 package.json（@deepseek-ai/dsh-* / cordis / schemastery）
• 通过 dsh.bundle.patch → cordis.patch.yml 以 Git bundle 安装
• 目标 profile：web（或任何会加载 Host tools 的 profile）

路线图

• ✅ 按 session 精确的提示注入（agent 级 scoped context，取代进程级 bind 猜测）
• 在同一套工具背后可选向量检索
• 小型 Web UI：浏览 / 置顶 / 删除 vault

许可证

MIT — 见 [LICENSE](./LICENSE)。