把智能体状态放在云端,而不是本地的 JSON 文件
检查点、已处理清单和运行日志,换一个会话、换一台电脑、智能体崩了都还在,而且重试永远不会重复生效。
更新于
要跨会话工作的智能体都要保存状态:哪些条目做完了、长任务停在哪里、每次运行发生了什么。通常是一个放在智能体旁边的 state.json。它会随机器一起丢,别的智能体看不见,两次运行还会互相覆盖。Tunc Orb 把同样的状态放在云端,并用规则让并发写入和重试写入都是安全的。
记录保存当前状态
一条记录装一个值:JSON、文本或二进制,最大 16 MiB。创建一次,之后按你上次读到的版本号去改。过期的版本号会被以 revision_conflict 拒绝,所以两个智能体不会悄悄互相覆盖:慢一步的那个重新读一次再决定。
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"create","name":"jobs/import/checkpoint",
"about":"Where the nightly import stopped",
"value":{"cursor":"2026-10-23T00:00:00Z","done":[]},
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'要改 JSON 记录的一部分,就发一个 JSON Patch(add、remove、replace、test)。任何一步失败,整个改动都不生效:
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"patch","name":"jobs/import/checkpoint","if_revision":"rev_…",
"patch":[{"op":"replace","path":"/cursor","value":"2026-10-24T00:00:00Z"},
{"op":"add","path":"/done/-","value":"batch-17"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'日志记录发生过什么
日志只能追加:每次追加 1 到 100 条(最多 64 KiB),由服务分配 ID 和顺序。给条目一个 event_key,例如来源消息的 ID:用同一个 key 和完全相同的内容再发一次,会返回原来那条而不是重复一条;但如果内容不同,这次调用会以 event_key_conflict 被拒绝,并且这一批的其余条目也一起不生效。
curl -s https://api.tuncorb.com/v1/write \
-H "Authorization: Bearer $TUNC_API_KEY" -H "Content-Type: application/json" \
-d '{"operation":"append","name":"jobs/import/runs","about":"One entry per nightly import run",
"entries":[{"value":{"rows":1204,"status":"ok"},"event_key":"run-2026-10-24"}],
"mutation_id":"mut_<26 lowercase base32 characters, new for each change>"}'重试永远不会重复生效
每次改动都带一个 mutation_id。如果请求超时、你不知道它有没有落地,就用同一个 mutation_id 再发一次,或者用 data_read 的 status 操作查它的结果。改动只会生效一次。
在你自己的代码里
在 https://tunchub.com/account/keys/new 创建一个 API 密钥,把它作为 Bearer token 发给 https://api.tuncorb.com(POST /v1/read、/v1/write、/v1/delete)。claude.ai、ChatGPT、Claude Code、Cursor 和 VS Code 里的智能体通过 https://mcp.tuncorb.com/mcp 使用同一个存储,所以脚本和智能体可以共用一个检查点。
- 通过远程 MCP 时单个值最大 64 KiB;更大的文件放进 Tunc Art,把它的 artifact_id 存进记录里。
- 每个智能体每秒:50 次读取、20 次保存、5 次搜索。短时间突发没问题。
- 免费版:Tunc Hub、Tunc Art 和 Tunc Orb 共用 1 GB 存储,每天 50,000 次操作。
