{"title":"Variables API","slug":"variables","category":"api","summary":"用于 LLM 状态的快速键值存储 — 计数器、标志位、最后访问时间戳、部分进度。","audience":["human","llm"],"tags":["api","variables","kv-store","state"],"difficulty":"beginner","updated":"2026-06-27","word_count":91,"read_minutes":1,"llm_context":"Auth: Mind Key\nSet: POST /var { key, value }\nGet: GET /var/:key\nList: GET /var\nDelete: DELETE /var/:key\nUse case: store last-seen timestamps, counters, flags, partial workflow state\nFaster than memory (PostgreSQL direct, no FTS5 indexing)\nNot for: structured facts (use /memory), long content (use /script)\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Variables API\n\nVariables API 是用于临时状态的快速键值存储。与记忆（被索引、可搜索、结构化）不同，变量针对快速读写做了优化 — 非常适合计数器、标志位和会话状态。\n\n## 端点\n\n### POST /var\n\n设置或更新变量。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/var \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\"}'\n```\n\n### GET /var/:key\n\n获取单个变量。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\n响应：\n\n```json\n{ \"key\": \"last_session_at\", \"value\": \"2026-06-27T14:00:00Z\", \"updated_at\": \"...\" }\n```\n\n### GET /var\n\n列出所有变量。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var\n```\n\n### DELETE /var/:key\n\n删除变量。\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/var/last_session_at\n```\n\n## 何时使用变量、何时使用记忆\n\n| 用例 | 使用 |\n|----------|-----|\n| 用户名、偏好 | Memory（可搜索、结构化） |\n| 上次会话时间戳 | Variable（临时状态） |\n| 计数器（例如已发送消息数） | Variable（频繁更新） |\n| 工作流状态（“5 步中已完成 3 步”） | Variable（短暂状态） |\n| 长篇项目笔记 | Memory（全文索引） |\n| 可复用脚本 | Script 存储（命名、版本化） |\n\n## 常见模式\n\n### 跟踪上次会话\n\n```bash\n# 会话结束时\ncurl -X POST .../var -d '{\"key\": \"last_session_at\", \"value\": \"'$(date -Iseconds)'\"}'\n\n# 会话开始时\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d \"$LAST\" +%s)\n```\n\n### 计数器模式\n\n```bash\n# 自增\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d \"{\\\"key\\\": \\\"api_calls\\\", \\\"value\\\": $((N+1))}\"\n```\n\n### 功能开关\n\n```bash\ncurl -X POST .../var -d '{\"key\": \"feature_x_enabled\", \"value\": \"true\"}'\n\n# 检查\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ \"$ENABLED\" = \"true\" ]; then ... fi\n```\n\n## 下一步\n\n- [Memory API](/docs/api/memory) — 用于结构化、可搜索的数据\n- [Cron 与调度器](/docs/api/cron)\n","content_html":"

Variables API

\n

Variables API 是用于临时状态的快速键值存储。与记忆（被索引、可搜索、结构化）不同，变量针对快速读写做了优化 — 非常适合计数器、标志位和会话状态。

\n

端点

\n

POST /var

\n

设置或更新变量。

\n
curl -X POST https://synapse.schaefer.zone/var \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{"key": "last_session_at", "value": "2026-06-27T14:00:00Z"}'

GET /var/:key

\n

获取单个变量。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/var/last_session_at

响应：

\n
{ "key": "last_session_at", "value": "2026-06-27T14:00:00Z", "updated_at": "..." }

GET /var

\n

列出所有变量。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/var

DELETE /var/:key

\n

删除变量。

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/var/last_session_at

何时使用变量、何时使用记忆

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
用例使用
用户名、偏好Memory（可搜索、结构化）
上次会话时间戳Variable（临时状态）
计数器（例如已发送消息数）Variable（频繁更新）
工作流状态（“5 步中已完成 3 步”）Variable（短暂状态）
长篇项目笔记Memory（全文索引）
可复用脚本Script 存储（命名、版本化）
\n

常见模式

\n

跟踪上次会话

\n
# 会话结束时\ncurl -X POST .../var -d '{"key": "last_session_at", "value": "'$(date -Iseconds)'"}'\n\n# 会话开始时\nLAST=$(curl .../var/last_session_at | jq -r .value)\ncurl .../memory/diff?since=$(date -d "$LAST" +%s)

计数器模式

\n
# 自增\nN=$(curl .../var/api_calls | jq -r .value)\ncurl -X POST .../var -d "{\\"key\\": \\"api_calls\\", \\"value\\": $((N+1))}"

功能开关

\n
curl -X POST .../var -d '{"key": "feature_x_enabled", "value": "true"}'\n\n# 检查\nENABLED=$(curl .../var/feature_x_enabled | jq -r .value)\nif [ "$ENABLED" = "true" ]; then ... fi

下一步

\n\n","urls":{"html":"/docs/api/variables","text":"/docs/api/variables?format=text","json":"/docs/api/variables?format=json","llm":"/docs/api/variables?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}