AndyYang12345/dsh-butler-memory

安装

**零手动运行**：两条通道都由 DSH/插件自动 spawn 子进程（崩溃后自动重启），
不需要你手动启动任何服务。

**优雅降级**：记忆桥缺失或未配置时（未装 pip 包、env 未配、数据库不可达），
`dsh web` 照常启动、普通对话不受影响——记忆工具暂时缺席，面板显示离线
状态与安装指引，修复后即恢复。

## 前置条件

1. 已安装 [butler-memory-mcp](https://github.com/AndyYang12345/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（发布后推荐）

把 AndyYang12345/dsh-butler-memory 加入你的 DSH 配置（web profile）即可启用。