Reasonix 会话同步与跨设备续接

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

Reasonix 的存储最朴素：一个目录，一批 *.jsonl 会话文件，文件名（stem）就是会话 id。

会话存在哪里

项 值
目录 %APPDATA%\reasonix\sessions\（Windows）
文件 每个会话一个 *.jsonl，以文件名（不含扩展名）作为会话标识

接入同步

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

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

同步行为与注意点

  • 只追加：会话文件按 JSONL 追加，同步只增加条目，不改写你已有的历史。
  • 运行中的会话跳过：正在被 Reasonix 占用（存在锁文件）的会话本轮不碰，等它结束后下一轮自动同步 —— 这是避免写冲突的刻意设计，不是漏同步。
  • 文件名即 id：改名或移动文件会被当成另一个会话，所以请让 Reasonix 自己管理这些文件，不要在目录里手工整理。

跨设备与跨 Agent

接入同一工作区的每台机器都会看到同一份会话列表。装完客户端之后最直观的体验是：换台电脑打开 Reasonix，之前那批会话直接就在，不需要导出导入。也可以把它们交给别的 Agent 继续（例如用 Hermes 做长文整理、用 OpenCode 改代码）—— 上下文不会断。

相关