# Variables API
SUMMARY: 用于 LLM 状态的快速键值存储 — 计数器、标志位、最后访问时间戳、部分进度。

KEY CONTEXT:
Auth: Mind Key
Set: POST /var { key, value }
Get: GET /var/:key
List: GET /var
Delete: DELETE /var/:key
Use case: store last-seen timestamps, counters, flags, partial workflow state
Faster than memory (PostgreSQL direct, no FTS5 indexing)
Not for: structured facts (use /memory), long content (use /script)

Variables API
Variables API 是用于临时状态的快速键值存储。与记忆（被索引、可搜索、结构化）不同，变量针对快速读写做了优化 — 非常适合计数器、标志位和会话状态。
端点
POST /var
设置或更新变量。
[CODE BLOCK]
GET /var/:key
获取单个变量。
[CODE BLOCK]
响应：
[CODE BLOCK]
GET /var
列出所有变量。
[CODE BLOCK]
DELETE /var/:key
删除变量。
[CODE BLOCK]
何时使用变量、何时使用记忆
| 用例 | 使用 |
|----------|-----|
| 用户名、偏好 | Memory（可搜索、结构化） |
| 上次会话时间戳 | Variable（临时状态） |
| 计数器（例如已发送消息数） | Variable（频繁更新） |
| 工作流状态（“5 步中已完成 3 步”） | Variable（短暂状态） |
| 长篇项目笔记 | Memory（全文索引） |
| 可复用脚本 | Script 存储（命名、版本化） |
常见模式
跟踪上次会话
[CODE BLOCK]
计数器模式
[CODE BLOCK]
功能开关
[CODE BLOCK]
下一步
- Memory API — 用于结构化、可搜索的数据
- Cron 与调度器