下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/letmetry--skill-kv-store.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @letmetry/skill-kv-store。为 AI 技能与智能体提供零配置的键值持久化存储。无需搭建数据库或 Redis，生成一把 UUID 密钥即可跨会话保存状态、缓存与配置，自带命名空间隔离与 TTL 生命周期。免费 7 天 / 100 条，付费解锁更长保留与更高配额。
阅读全文 （展开查看完整说明）
概述
让你的技能持久化小数据，不用自己搭数据库。一把 UUID 密钥，跨会话、跨机器都能存能取。
它能帮你解决什么
- 跨会话记忆：对话状态、任务进度、去重集合在多次调用 / 多个会话间不丢。
- 结果缓存：把昂贵的外部 API 结果、计算产物缓存起来，省 token、省时间。
- 结构化小数据：配置项、计数器、排行榜、简单队列等
键 → 值数据。 - 单值 ≤ 300KB，适合"小数据"场景；不是用来存大文件或训练数据的。
为什么选它（和其他方案的区别）
| 对比项 | 技能数据存储 | 本地 / 内存 KV（如 gh-kvstore、本地 cache） | 自建 Redis / 向量库 |
|---|---|---|---|
| 需要自己运维服务 | ❌ 不需要 | ❌ 不需要 | ✅ 要装要管 |
| 重启 / 跨会话后数据还在 | ✅ 云端持久化 | ❌ 内存型重启即丢 | ✅ 持久 |
| 跨机器 / 多智能体共享 | ✅ 云端同一后端 | ❌ 仅本机 | ✅（要自己暴露） |
| 上手成本 | 一行：生成 UUID | 一行 | 装服务 + 配连接 |
| 隔离 / 多租户 | ✅ 每把密钥一个命名空间，互不可见 | 看实现 | 自己搞定 |
一句话：比其他内存 KV 更"扛丢"，比自建 Redis 更"省事"。
快速开始
- 生成一把你的密钥（任意 UUID v4）：
scripts/kv.js uuid- 把它设为环境变量
KV_API_KEY（建议每个技能用各自的 UUID，天然隔离）。 - 开写：
scripts/kv.js set mytask:progress '{"step":2}' --ttl 7
scripts/kv.js get mytask:progress不设 KV_API_KEY 时，kv.js 会自动生成并持久化到 ~/.kvstore_key，首次 set 即可用。
CLI 用法
scripts/kv.js set <key> <value> [--ttl <天，默认7>] # 写入；value 可为 JSON 或文本
echo '{"items":[1,2,3]}' | scripts/kv.js set <key> --ttl 30 # 从 stdin 读（适合 JSON/多行）
scripts/kv.js get <key> # 读取（缺失返回 404）
scripts/kv.js del <key> # 删除（立即生效）
scripts/kv.js usage # 查看本密钥的套餐 / 已用条数 / 上限HTTP API（在代码里直接调用）
所有请求带头 X-API-Key: <你的UUID>，不同调用方数据自动隔离、互不可见。
| 方法 | 路径 | Body | 说明 |
|---|---|---|---|
| PUT/POST | /api/kv/{key} | { "value": <any>, "ttlDays": <int, 默认 7> } | 写入；返回 plan / ttlCapDays / ttlDays / expiresAt |
| GET | /api/kv/{key} | — | 读值（缺失 404） |
| DELETE | /api/kv/{key} | — | 删除 |
| GET | /api/kv/usage | — | 本调用方用量 |
服务端地址默认 https://museumcheck.cn（可用 KV_API_BASE 覆盖）。
套餐与配额
| 档位 | 价格 | 最长保留 | 最多条数 |
|---|---|---|---|
| 免费 free | ¥0 | 7 天 | 100 |
| 周卡 weekly | ¥3 | 7 天 | 1,000 |
| 月卡 monthly | ¥9 | 30 天 | 5,000 |
| 年卡 annual | ¥84 | 365 天 | 50,000 |
- 写入请求的
ttlDays会被封顶到当前档位上限（免费最多 7 天），无法靠声明更长 TTL 绕过。 - 卡过期自动回落免费档；已写入数据按各自到期时间保留，不受影响。
- 读 / 删免费，不计入套餐。
使用限制
- 单值 ≤ 300KB。
key为单路径段，不含/。- 条数按档位封顶（超出无法写入）；更高配额买对应套餐即可。
- 不同密钥的数据天然隔离，互不可见。
- 请勿用于刷量等滥用行为，违规密钥会被封禁。
