
【导语AI 工具重度用户道荣和露因 AI 记忆“绑设备”问题困扰开发了开源项目 agentctxsync实现 AI 会话跨设备、跨 Agent 同步本文介绍其架构、设计、踩坑及上手方法。】AI 记忆痛点催生同步方案道荣和露作为 AI 工具重度用户在使用 Hermes、Codex、opencode 等工具时深受 AI 记忆“绑设备”问题困扰。白天在公司电脑与 AI 交流的完整上下文晚上回家在笔记本上同一工具却毫无记忆换 Agent 更是如此。因无现成好用方案他们开发了 agentctxsync。架构简单却功能强大agentctxsync 架构分为本地和服务端两头。本地每个 Agent 挂一个 MCP 客户端可读写 SQLite、JSONL、JSON 等存储格式服务端用 FastAPI 加 PostgreSQL 管理同步还有中英双语 Web 管理界面。目前支持 Hermes、OpenAI Codex 等 6 种 Agent新增 Agent 只需写新适配器。设计心思保障稳定安全在设计上同步要稳是核心。启动自动增量拉取首次配对自动引导推送之后每 5 分钟双向同步一次跨设备续写只推新增消息消息按三元组去重大批量同步自动分批。多租户隔离干净每个空间独立 API Key管理员看不到用户会话和消息。Web 界面功能丰富客户端自动更新且可回滚。开发踩坑终得解决方案开发中踩过不少坑。如 Windows 会话 id 带冒号前缀问题通过改成裸 id 解决SQLite 锁竞争问题通过写连接 busy_timeout 压到 5 秒、启动拉取延迟 8 秒等处理去重失效问题通过加内容级兜底去重和确定性微调解决。上手容易带来意外惊喜上手 agentctxsync 只需三步服务器跑部署脚本Web 界面注册拿 API Key按 Agent 下载客户端包配置。初版完成后道荣家里电脑 Hermes 崩了会话数据全靠同步到服务器的 agentctxsync 拉回。项目已开源技术栈包括 FastAPI、PostgreSQL 等受 AI 跨设备失忆困扰的用户可尝试。编辑观点agentctxsync 解决了 AI 跨设备记忆难题架构简单、设计周全虽开发有挑战但已克服对 AI 用户是实用工具开源也利于技术发展。