会话记忆库 xiuyuan18/dsh-engram-session

dsh-engram-session

⚠️ 非官方项目。 这是社区独立开发的插件，不是 DeepSeek Harness 官方产品，与 DeepSeek 无隶属关系，也未获其认可，更不由 DeepSeek Harness 团队维护。使用风险自负。

为 DeepSeek Harness 提供按会话隔离的 Engram 记忆功能 —— 一个独立打包的项目，可在多个配置档和预设之间复用。

这个包是一个打包单元（bundle）：它的 dsh.bundle.patch（cordis.patch.yml）是组合层，负责插入插件行；插件加载时再把 Engram Memory Protocol 注册成自己的系统提示词段落（engram:memory-protocol，order 10），部署人设完全不受影响。装进任何配置档只需一条命令：

from anywhere; <path> may be absolute or relative to your invoking directory
dsh plugin --profile web add /home/xiuyuaned/dsh-plugins/dsh-engram-session

dsh plugin 会执行 pnpm add，并同步 dsh.profile.bundles —— 声明了 dsh.bundle 的包会自动加入层栈。打包单元掌管一切（插件行 + 协议段落），所以移除或禁用它不会留下任何副作用（没有工具残留，也没有孤立的记忆指令）。

为新配置档或预设做配置

1. 先装一次依赖（项目自带 node_modules，无需外部依赖）：

cd /home/xiuyuaned/dsh-plugins/dsh-engram-session && pnpm install

2. 把打包单元加进配置档（每个配置档都要重复一次）：

dsh plugin --profile <name> add /home/xiuyuaned/dsh-plugins/dsh-engram-session

3. 重启该配置档的应用。预设也可以直接在 dsh.profile.bundles 里列出这个打包单元，再在 package.json 里加一条 link: 依赖。

移除是对称的：dsh plugin --profile <name> remove dsh-engram-session。随时都能用 add 命令重新安装 —— 源码放在配置档外面，所以移除打包单元永远不会删掉它。

它做什么

每个智能体会话起一个 engram mcp stdio 子进程，cwd = session.header.cwd（会话的工作区），并通过 agent.ctx.tools.register() 把 mem_ 工具注册进该智能体自己的作用域。作用域注册会遮蔽全局工具层，所以并发会话各自看到自己的记忆面，共用同一套 mcp__engram__mem_ 名字也不会冲突。

把子进程的根目录定在会话工作区，Engram 的项目自动探测（git 根目录 / .engram/config.json）就能按会话确定下来 —— 这是官方给出的修复方案，专门解决 MCP 子进程拿不到可靠 cwd 的宿主环境（DSH web GUI、VS Code、WSL、CI）。不需要 --project 固定。

面向模型的工具规格在本地做了修正：engram 自带的 scope 参数描述漏了 global，插件在注册定义里重写了它们（只改描述文本 —— 名称、类型、必填标记都不动），让智能体的工具契约保持准确，不必等上游发版。

配置

| 字段 | 默认值 | 说明 |
| serverName | engram | 面向模型的工具名命名空间 |
| binary | (自动检测) | Engram 可执行文件；见 二进制文件解析 |
| args | ['mcp'] | 传给 MCP stdio 服务器的参数 |
| toolCallTimeoutMs | 60000 | 每次 tools/call 的超时时间 |

二进制文件解析

没有写死任何机器相关的路径。binary 未设置时，插件挑第一个找到的可执行文件：先查 PATH，再依次查 ~/.local/bin/engram、/usr/local/bin/engram、/opt/homebrew/bin/engram。什么都没找到就记一条警告，然后不挂载记忆工具——协议部分也一并跳过，这样智能体永远不会听说那些根本不存在的工具。

在配置档配置里设置 binary（绝对路径，或裸命令名）可以覆盖检测结果。设置了但文件不存在，会记一条警告并退回检测，所以 0.4 之前版本创建的配置档即使写死了 /home/xiuyuaned/.local/bin/engram，换到别的机器上也能自愈。

生命周期

- agent/created（挂载时还会扫描已在运行的智能体）→ 启动子进程并注册
- agent/disposed → 注销工具，关闭客户端（顺带杀掉子进程）
- 插件 dispose → 对每个存活条目执行同样的清理

项目结构

- index.js —— 插件本体：每个智能体一个 Engram MCP 子进程 + 注册作用域内的 mem_* 工具
- cordis.patch.yml —— 打包组合层（插件行）
- AGENTS.md —— 给参与本项目的 AI 智能体的指引
- package.json / pnpm-lock.yaml —— ESM 清单与锁文件

开发

架构细节、约定、验证步骤和坑，见 AGENTS.md。快速检查：

node --check index.js

已知限制

- 没有重连监管：子进程在会话中途挂掉，它的工具就一直失败到会话结束；重启 GUI 才能恢复。
- 结果只投影文本：图片/音频/内嵌 MCP 块都变成诊断信息（Engram 返回的是文本结果）。