README.md main

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，与上游项目一致。本包仅包含接入配置与面板代码，
不包含任何第三方运行时、模型权重或专有素材。

dsh-butler-memory

dsh-butler-memory

前置条件

可选环境变量

安装

从 npm（发布后推荐）

本地开发（源码 checkout）

层顺序与覆盖

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

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

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

License

相关项目