mcpField
C
catalyst-cache

catalyst-cache

github.com/catalystbyzoho数据与数据库701.0k 次安装今天更新
代码仓库

关于 catalyst-cache

帮助开发者通过 SDK 使用 Catalyst Cache Segment 的技能，说明缓存值仅支持字符串、TTL 行为，以及更新和删除操作的注意事项。

主要功能

  1. 01查询 Cache Segment ID
  2. 02SDK 获取、写入、更新和删除指引
  3. 03字符串值序列化说明
  4. 04TTL 限制与行为
  5. 05更新和删除操作注意事项

适用场景

  1. 01存储临时会话数据
  2. 02判断临时数据是否适合使用缓存
  3. 03排查 TTL 或删除行为异常

MCP 相关

在可用时，该技能会使用 MCP 的 `CatalystbyZoho_List_Cache_Segments` 查找 Segment ID。MCP 在此作为查询方式，而非 MCP 服务接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-cache

安装后在 Claude Code 中输入/catalyst-cache确认已加载。

附带文件references/cache-basics.md

详细介绍

工作原理

  1. 获取 Segment ID — 如果可用，请使用 MCP（CatalystbyZoho_List_Cache_Segments）；否则，从控制台或 .catalystrc 中获取。
  2. 加载 references/cache-basics.md — 查看 SDK 操作、TTL 限制（最长 48 小时），以及 segment.delete() / segment.update() 的注意事项。
  3. 仅支持字符串值 — 所有缓存值都是字符串。调用 put 前始终使用 JSON.stringify，调用 get 后始终使用 JSON.parse。
  4. TTL 行为 — TTL 的单位是小时（最长 48 小时），不是秒。如果调用 segment.update() 时未传入过期时间参数，键的 TTL 会被静默重置为 48 小时上限（1 小时的键会变为 48 小时）。segment.delete() 不会移除键，而是将 cache_value 设为 null，键仍会保留；之后调用 getValue() 会返回 null，HTTP 状态码为 200，且不会抛出异常。

触发条件

适用于以下情况："Cache"、"cache segment"、"cache key"、"cache value"、"TTL"、"in-memory store"、segment.get、segment.put、segment.delete、"session data"、"temporary data Catalyst"、"cache vs Data Store" 或 "48-hour cache"。

参考资料

参考资料在查询涉及以下内容时加载……
references/cache-basics.mdSDK 操作（get、put、delete、update）、Segment ID、最长 48 小时的 TTL、仅支持字符串值、segment.delete() 将值设为 null 的注意事项、segment.update() 的 TTL 注意事项

评论

支持 Markdown