dsh-butler-memory
DeepSeek Harness 的长期记忆：agent 能用，你也能看见。 一个组合包同时打通
两条通道：模型获得 mcp__butler__memory_* 工具；Web 会话头部出现"记忆"按钮，
面板可查看记忆、敏感度徽章、修订历史与待决候选——写入依然绑定 owner/revision/
audit，绝不静默入库。
DSH 组合包：把 butler-memory-mcp 的记忆能力接进 DeepSeek
Harness 的两条通道——
- 给 agent：声明一个
dsh-mcp-client 实例，spawn ai-butler-memory-mcp，
模型获得 mcp__butler__memory_* 工具；
- 给用户：一个 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 照常启动、普通对话不受影响——记忆工具暂时缺席，面板显示离线
状态与安装指引，修复后即恢复。
前置条件
- 已安装 butler-memory-mcp
（
pip install butler-memory-mcp，确保 ai-butler-memory-mcp 在 PATH 上）；
- 已按 butler-memory-mcp README 配置
~/.config/butler-memory-mcp/.env
（数据库与桥设备凭据）。新机器/无数据库时一条命令完成全部初始化：
ai-butler-memory-mcp setup-docker（需 Docker Desktop）；
- 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 流程）
- 会话 A：
记住我的验证饮品是 lapsang-<唯一后缀>。 → 确认调用写入工具成功；
- 新会话 B：
我的验证饮品是什么？查一下记忆。 → 确认召回；
- 会话 B：
用这个偏好为会议建议一款饮品。 → 确认回答使用了记忆；
- 点击会话头部"记忆"按钮：面板显示该条记忆（含类别/敏感度徽章）；
面板中接受/拒绝候选后，记忆服务状态即时变化。
与官方示例的差异（本插件卖点）
官方 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，与上游项目一致。本包仅包含接入配置与面板代码，
不包含任何第三方运行时、模型权重或专有素材。
相关项目
