Origin

简体中文

English

简体中文

English

外观

常见问题 ​

常见的问题、你会看到什么，以及该怎么做。Origin 的提示会说明出了什么问题，通常也会说明怎么解决；下面引用的就是这些提示的原文。

安装与接入 ​

Node.js 版本太旧 ​

每个命令都失败，提示 Origin needs Node.js 22.16 or later; this is v20.11.1.。Origin 用到了 Node.js 22.16 才加入的 zstd 压缩和 SQLite 在线备份。

安装 Node.js 22.16 或更高版本，然后用它重新安装 Origin（npm install -g @openlinkos/origin）。如果你用版本管理工具，请确认 Agent 启动的 Node.js 与你的终端里的是同一个：从桌面启动器打开的 Agent，可能在它的 PATH 上找到另一个版本。在 Agent 的终端里运行 node --version 就能看出是哪个。

Agent 看不到 Origin 的工具 ​

Agent 的列表里没有 origin server，或者 server 启动失败。

  • 检查注册情况：claude mcp list、codex mcp list 或 grok inspect（见接入 Agent）。请在用户范围注册 Origin，而不是按项目注册，这样每个项目都能看到它。
  • 在 Windows 上，npm 把 origin 装成 .cmd 脚本，Agent 无法直接启动它。请注册 cmd /c origin mcp，而不是 origin mcp。
  • 在 Git Bash 里注册时，请在前面加上 MSYS_NO_PATHCONV=1，否则 Git Bash 会把 /c 改写成 C:/，注册的命令启动时就会失败：MSYS_NO_PATHCONV=1 claude mcp add --scope user origin -- cmd /c origin mcp。
  • 注册或更新 Origin 之后，请重启 Agent：Agent 在会话开始时才启动它的 MCP server。
  • 在终端里运行 origin status。如果它失败了，server 也会以同样的方式失败，提示会说明原因。

结果里缺少刚说过的话 ​

Agent 找不到一个会话最后几条消息。

origin mcp 在 search 和 timeline 之前读入新的日志行，最多每 10 秒一次；在 remember 和 correct 之前总会读入；后台每分钟一次；Agent 退出时再读一次（见时效）。所以检索通常能看到几秒前说的话。看不到的是：

  • 不使用 Origin 的 Agent 的会话，要等使用 Origin 的 Agent 运行，或运行 origin sync。在只有这类 Agent 运行的机器上，请定时运行 origin sync。
  • 其他设备的会话，要等那台设备与中枢同步。
  • 如果后台查看被关闭（ORIGIN_WATCH_INTERVAL_MS=0），以上这些都看不到。

升级 ​

较新的 Origin 用过的库被拒绝 ​

每个命令都失败，提示 The store at … has format version 4, but this Origin knows versions up to 3 only: a newer Origin has used it. Upgrade Origin to open it; nothing was changed.

较新的 Origin 已经升级了这个库，而一个较旧的 Origin 想打开它，常见的是从另一处安装启动、或在你更新之前就已启动的 Agent 的 MCP server。请更新所有使用这个库的安装（npm install -g @openlinkos/origin@latest；中枢则更新镜像），然后重启 Agent。不支持在已升级的库上退回较旧的 Origin。

打开库时会升级它 ​

更新之后，某个命令输出 Upgrading the store to version 4: …，并且比平时慢。

新版本可能会改变库的格式；第一个打开库的命令会就地把它升级到最新，只做一次。有些升级要重新读取已归档的日志，在大的库或中枢上需要一段时间。期间打开这个库的其他命令和 Agent 会等待升级完成，最多 5 分钟。为保险起见，更新前请先备份库（见备份）。

如果某一步失败，提示会说明：The store could not be upgraded to version 4 (…): … Nothing of this step was kept; it runs again the next time the store is opened.。解决提示中指出的原因，再运行任意一个命令即可。需要重新读取已归档日志的步骤，要用 origin 命令来打开库；在把原始镜像放在存储桶里的中枢上，还要先配置好存储桶。

个人中枢 ​

连不上中枢 ​

Agent 得到的结果末尾带有 Note: the Origin hub was not consulted (the hub at https://hub.example.com is unreachable: …); these results come from this device only.，或者 origin sync 失败。

没有中枢，设备也照常工作：它等待中枢 2 秒（ORIGIN_HUB_TIMEOUT_MS）后用自己的库作答，把 Agent 写下的内容先存在本地，下一次同步时再发送。只有纠正或遗忘只在中枢上才有的内容，才需要中枢。

运行 origin hub status：它显示设备上次同步的时间、上一次失败的同步的错误，以及中枢现在是否接受这个令牌。提示中枢 rejected the token (HTTP 401)，说明令牌已被吊销或输错了：在中枢上创建新令牌，再重新连接（见创建令牌）。还要检查中枢前面的 TLS 代理或 CDN（见放在 TLS 之后），以及不需要令牌的 GET /healthz。

令牌属于另一台设备 ​

origin hub connect 失败，提示 This token belongs to device "laptop", but this store is named "desktop"; …，或者中枢以 403 拒绝请求。

中枢令牌只对以它命名的那台设备有效，而设备以它的库的名称为人所知。要么在中枢上创建一个以这个库命名的令牌（origin token create desktop），用它来连接；要么，如果这台机器就是 laptop，用 --device laptop 以那个名称连接。库一旦以某个名称写过条目或遗忘记录，就会保留这个名称（This store is named "desktop" and keeps that name, …）；从 Agent 记忆文件导入的条目不算在内。

中继警告有会话还没有发送 ​

origin status 或 Agent 显示 Warning: Claude Code sessions not sent to the hub yet were last written 24 days ago, and Claude Code deletes them after 30 days (…); …

中继不为还没发送的会话保留副本，所以如果 Agent 先删除了日志，这些会话就丢失了。请让中枢可以访问，并运行 origin sync；origin status 按来源显示还有多少待发送。对 Claude Code，你也可以在它的 settings.json 里用 cleanupPeriodDays 让日志保留更久。

归档与数据 ​

解析错误 ​

origin sync 报告某个来源有解析错误，或者管理界面的概览显示某个 Agent 有解析错误。

某个 Agent 改变了日志格式，有些行暂时读不懂。不会丢失任何东西：每一行都保存在原始镜像中，文件其余部分照常读取。origin sync --verbose 会输出每个错误及其文件和行号。请更新 Origin；新版本学会读取这些行后，会在需要时重新读取它们。如果在最新版本上仍有解析错误，请报告问题，写明 Agent 及其版本，但不要附上这些行本身，因为其中可能有隐私数据。

数据在哪里，占多少空间 ​

origin status 的最后一行是 Data directory: …：~/.origin，或 ORIGIN_HOME。其中有数据库 origin.db，以及日志的压缩副本 raw/（见Origin 保存了什么）。管理界面概览中的「存储」面板（在设备上用 origin ui）会显示各占多少空间。

粗略估算，数据库每个事件约占 2.5 KB；日志停止增长之后，原始镜像约为所复制日志的五分之一。数据库旁边的 origin.db-wal 存放最近的写入；每次检查点之后，它会被截回到 64 MB。

迁移或重置库 ​

数据库和原始镜像是一个整体：不要只删除、替换或复制其中之一，也不要在 Origin 运行时只复制 origin.db。

  • 要迁移一个库，用 origin backup <dir> 把它备份到新的空目录，停止 Agent，再备份一次到同一个目录，以复制这期间的变化，然后让 ORIGIN_HOME 指向它，包括在你的终端里，以及 Agent 启动 origin mcp 时的环境里。备份不包含 hub.json，其中是与中枢的连接及其令牌：把它也复制过去，或者用 origin hub connect 重新连接。
  • 要从头开始，让 ORIGIN_HOME 指向一个新的空目录，把旧目录留作备份。在连接了中枢的设备上，恢复一份备份比用空库更好：库保留它的名称和它在中枢记录中的位置，所以能从中断的地方接着同步。
  • 要清除全部数据，见清除全部数据。