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。

License

Apache License 2.0，与上游项目一致。本包仅包含接入配置与面板代码，
不包含任何第三方运行时、模型权重或专有素材。

相关项目

• butler-memory-mcp —
  记忆 MCP 服务器（本包的数据源）；
• ai-butler-framework — 记忆领域服务的实现方（上游）；
• DSH 官方第三方记忆 MCP 示例 —
  本包接入方式的对齐基准。