PostgreSQL 持久个人记忆:MCP 记忆工具 + 可查看记忆与候选的 Web 面板。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-butler-memory
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:AndyYang12345/dsh-butler-memory
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
[!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 的两条通道——
- 给 agent:声明一个
dsh-mcp-client实例,spawnai-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+;
dshCLI 已安装。
可选环境变量
| 变量 | 默认 | 作用 |
|---|---|---|
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,与上游项目一致。本包仅包含接入配置与面板代码, 不包含任何第三方运行时、模型权重或专有素材。
相关项目
- butler-memory-mcp — 记忆 MCP 服务器(本包的数据源);
ai-butler-framework— 记忆领域服务的实现方(上游);- DSH 官方第三方记忆 MCP 示例 — 本包接入方式的对齐基准。
链接
同类插件
vectorize-io/hindsight#coding-agents★ 60916
Hindsight:会学习的 Agent 长期记忆系统,自动召回/保存、知识页、深度反思与按仓库隔离的记忆银行。
volcengine/OpenViking#examples/dsh-memory-plugin★ 42209
面向 DeepSeek Harness 的 OpenViking 记忆与上下文插件:pre-step 自动召回与画像注入、会话捕获、`viking://` URI 防护,以及对接 OpenViking 服务端的 recall/write 记忆工具。
MemTensor/MemOS#memos-local-plugin★ 12392
DeepSeek Harness 本地记忆插件:分层 L1/L2/L3 记忆,自动沉淀与手动 memos_* 检索工具并存,内置记忆浏览器。
agentscope-ai/ReMe#dsh★ 3799
将 DeepSeek Harness 接入 ReMe 本地优先、自进化的个人知识库:自动把已完成的主 Agent 对话沉淀为用户掌控的 Markdown 记忆,通过 reme_search 结合 BM25、可选向量检索和 wikilink 展开搜索对话与资料,并按日整理长期记忆。
zilliztech/memsearch#MemSearch★ 2873
供 DSH 与其他编程 Agent 共享的 Markdown 记忆,支持自动捕获、步骤前上下文注入、搜索召回,以及通过审阅面板实现 memory-to-skill 自进化。
vshulcz/deja-vu#extensions/dsh★ 1544
跨会话长期记忆与上下文恢复:读取本机上其他四十五个(45+)编程智能体已经写下的会话文件,支持安装前历史找回与中断恢复(Claude Code、Codex、Cursor、Windsurf、Trae、Antigravity、VS Code Copilot Chat、opencode、OpenClaw、Hermes、Kimi、Qoder、Cline、Zed、Magpie 等):提供 deja_recall、deja_session、deja_blame、deja_fix、deja_how、deja_remember 六个工具与 /deja 命令,并可选地把召回结果加入运行时上下文。共享本地 BM25 CLI/MCP 索引,不用大模型,不用向量嵌入,不联网(dsh plugin --profile web add dsh-deja)。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。