Oh My Pi 会话同步与跨设备续接

最后更新 2026-09-17 · MIT 许可 · 个人自托管免费

Oh My Pi（客户端标识 omp）的会话存储很干净：一个目录、一批追加写的文件，因此同步逻辑也最直白。

会话存在哪里

项 值
目录 ~/.omp/agent/sessions/
覆盖方式 环境变量 OMP_CODING_AGENT_DIR 指向别处时，适配器跟随该变量

如果你把 Oh My Pi 的数据目录挪到过别的位置（比如放在同步盘或另一块盘上），把 OMP_CODING_AGENT_DIR 设上即可，适配器会读那里。

接入同步

  1. 在接入帮助页选择 Oh My Pi → 下载客户端包（服务端地址已自动预填）。
  2. 解压后首次运行 install-deps.bat（Windows）或 ./install-deps.sh（macOS / Linux）。
  3. 用页面给出的注册命令接入（工作区 API Key 已自动填入），客户端以 HERMES_SYNC_AGENT=omp 启动。
  4. 重启 Oh My Pi。

首次启动增量拉取；远端为空时自动推送本地数据完成配对；之后每 5 分钟同步一次。

同步行为与注意点

  • 只追加，不重写：会话文件是追加写的，同步只往里加新条目，不会覆盖或重排你已有的历史。
  • 标题会跟着走：title / title_change 这类条目同属会话数据，所以同步到另一台机器后，会话列表里的标题与本地一致 —— 不会出现一堆「未命名会话」。
  • 会话 id 用 uuidv7：天然按时间有序，合并两端数据时不会因为排序错乱而重复。

跨设备与跨 Agent

这是最常见的使用方式：家里一台、公司一台，两边都装 Oh My Pi 客户端接入同一工作区。你在公司问了一半的问题，回家打开同一台 agent 的会话列表就能看到并接着问；换成 Hermes 或 OpenCode 继续也行 —— 池子是共享的。

相关