AndyYang12345/dsh-butler-memory

dsh-butler-memory

[!WARNING] Deprecated — this DSH integration plugin is no longer maintained. DSH changes rapidly, and this plugin is not being updated to follow newer releases. The compatibility notes below describe the versions that were tested at the time; they are not a promise of compatibility with current DSH. This repository remains available as a historical reference.

已停止维护：仅限这个 DSH 接入插件。 由于 DSH 上游更新较快，本插件不再跟进新版； 下文的安装与兼容性记录仅代表当时的测试结果。此声明不适用于独立的 ai-butler-framework 或 butler-memory-mcp 项目。

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 已安装。

可选环境变量

安装

从 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 示例 — 本包接入方式的对齐基准。