dsh-butler-memory

dsh plugin --profile web add dsh-butler-memory

dsh-butler-memory



DeepSeek Harness 的长期记忆：agent 能用，你也能看见。 一个组合包同时打通

两条通道：模型获得 mcp__butler__memory_* 工具；Web 会话头部出现"记忆"按钮，

面板可查看记忆、敏感度徽章、修订历史与待决候选——写入依然绑定 owner/revision/

audit，绝不静默入库。

DSH 组合包：把 butler-memory-mcp 的记忆能力接进 DeepSeek

Harness 的两条通道——

1. 给 agent：声明一个 dsh-mcp-client 实例，spawn ai-butler-memory-mcp，

模型获得 mcp__butler__memory_* 工具；

2. 给用户：一个 Web 端"记忆"面板（会话头部按钮 + 对话框），可查看长期

记忆、敏感度/类别徽章、修订时间线、推断候选并接受/拒绝，含**服务健康

状态与离线时的分步安装指引**——语义移植自

ai-butler-framework 的 web/index.html 记忆面板。

DSH agent ──mcp__butler__memory_*──► butler-memory-mcp (stdio, DSH 托管)
DSH web 面板 ──host.call──► host 半部 ──JSON-RPC──► butler-memory-mcp (stdio, 插件托管)

零手动运行：两条通道都由 DSH/插件自动 spawn 子进程（崩溃后自动重启），

不需要你手动启动任何服务。

优雅降级：记忆桥缺失或未配置时（未装 pip 包、env 未配、数据库不可达），

dsh web 照常启动、普通对话不受影响——记忆工具暂时缺席，面板显示离线

状态与安装指引，修复后即恢复。

前置条件

1. 已安装 butler-memory-mcp

（pip install butler-memory-mcp，确保 ai-butler-memory-mcp 在 PATH 上）；

2. 已按 butler-memory-mcp README 配置 ~/.config/butler-memory-mcp/.env

（数据库与桥设备凭据）。新机器/无数据库时一条命令完成全部初始化：

ai-butler-memory-mcp setup-docker（需 Docker Desktop）；

3. Node 22+；dsh CLI 已安装。

可选环境变量

变量 · 默认 · 作用

AI_BUTLER_MEMORY_MCP_COMMAND · ai-butler-memory-mcp · 面板桥的启动命令（PATH 上找不到时给绝对路径）

BUTLER_MEMORY_PANEL_URL · 未设置（stdio 模式） · 设置后回退到旧式 HTTP 面板模式，指向自管的 --transport http 实例

安装

从 npm（发布后推荐）

dsh plugin add dsh-butler-memory

插件激活时自动把 butler-memory skill 复制到

$DSH_HOME/skills/butler-memory/（幂等，崩溃不影响），DSH 的文件系统

skill 提供方会在所有 profile 中发现它；也可手动执行

npm run install-skill 重装。

本地开发（源码 checkout）

npm install
npm run build                # 构建 client/dist/client.js
dsh plugin add ..            # 本地路径安装到当前 profile

发布形态：package.json 同时声明 dsh.bundle（贡献 cordis.patch.yml 层）与

dsh.client（platform: web，浏览器 bundle 经 /plugins/<id>/client.js 注入）。

层顺序与覆盖

cordis.patch.yml 插入两行；用户可在自己的 $DSH_HOME/cordis.patch.yml 或

profile 的 cordis.patch.yml 整行覆盖（如换端口、换命令）。patch 是整行替换，

覆盖时需重述全部配置键。

验证（照搬官方 examples/mcp-memory 流程）

1. 会话 A：记住我的验证饮品是 lapsang-<唯一后缀>。 → 确认调用写入工具成功；

2. 新会话 B：我的验证饮品是什么？查一下记忆。 → 确认召回；

3. 会话 B：用这个偏好为会议建议一款饮品。 → 确认回答使用了记忆；

4. 点击会话头部"记忆"按钮：面板显示该条记忆（含类别/敏感度徽章）；

面板中接受/拒绝候选后，记忆服务状态即时变化。

与官方示例的差异（本插件卖点）

官方 examples/mcp-memory 只提供模型工具，没有用户可视界面。本组合包把

butler 的"用户可看、可审、可撤销"面板带到 DSH，且写入依然绑定框架的

owner/revision/audit 语义。

兼容性验证记录（dsh 0.1.0-rc.6 实测）

• ctx.inject(['connection']) + ctx.connection.rpc.handle 静态插件 RPC

契约（对齐官方 dsh-api-gateway 用法）；

• Slot 注册：`ctx.slots.inject(key, () => ctx.slots.register({name, id,

order}, Component))`，与官方 dsh-client-ui-jobs 同槽位实测；

• 客户端 bundle 采用模块表契约（__ModuleLoader__ + CJS 工厂，React 由

页面提供）；

• MCP 协议 2025-11-25 握手、headless agent 工具调用、面板 RPC 通道、

桥崩溃自动重启均已在真实实例验证。

详见 [PLAN.md](PLAN.md)。

License

[Apache License 2.0](LICENSE)，与上游项目一致。本包仅包含接入配置与面板代码，

不包含任何第三方运行时、模型权重或专有素材。

相关项目

• butler-memory-mcp —

记忆 MCP 服务器（本包的数据源）；

• ai-butler-framework — 记忆领域服务的实现方（上游）；
• DSH 官方第三方记忆 MCP 示例 —

本包接入方式的对齐基准。