Catalyst Cache

catalystbyzoho/agent-skills/skills/catalyst-cache

作者 catalystbyzoho69e5df0514d6091eb7fb399106d1a43298f83b33无许可证66 个星标收录于 2026年10月9日更新于 2026年10月9日仓库今天更新

Catalyst Cache — in-memory key-value store with TTL for ephemeral session and temporary data. Trigger on 'Cache', 'cache segment', 'cache key', 'TTL', 'segment.put', 'segment.get', or 'temporary data Catalyst'.

AI 生成的概览

指导使用 Catalyst Cache 内存键值存储,涵盖 SDK 操作、TTL 限制与已知陷阱。

功能
该技能说明如何使用 Catalyst Cache——一种带 TTL、用于临时会话和临时数据的内存键值存储。内容包括获取 segment ID、加载 cache-basics 参考文档以了解 SDK 操作、以 JSON 序列化方式存储仅限字符串的值,以及 48 小时 TTL 上限。它还记录了两个陷阱:不带过期参数的 segment.update() 会把 TTL 重置为 48 小时,而 segment.delete() 只是把值设为 null,并不会删除键。
适用场景
当任务涉及 Catalyst Cache 段、缓存键或值、TTL 设置、会话或临时数据,或在缓存与 Data Store 之间做选择时使用。排查缓存行为异常(如 TTL 意外变化或删除后返回 null)时也适用。
运行要求
需要 Catalyst 环境及其缓存 SDK;若可用则使用列出缓存段的 MCP 工具,否则 segment ID 来自控制台或 .catalystrc。不附带脚本,仅为说明文档加一份参考文档。

How It Works

  1. Get Segment ID — Use MCP (CatalystbyZoho_List_Cache_Segments) if available; otherwise retrieve it from the console or .catalystrc.
  2. Load references/cache-basics.md — for SDK operations, TTL limits (48 hr max), and the segment.delete() / segment.update() gotchas.
  3. String values only — All cache values are strings. Always JSON.stringify before put and JSON.parse after get.
  4. TTL behavior — TTL is in HOURS (max 48), not seconds. segment.update() called WITHOUT an expiry argument silently resets the key's TTL to the 48-hour maximum (a 1-hour key becomes a 48-hour key). segment.delete() does not remove the key — it sets cache_value to null and the key persists; a later getValue() returns null with HTTP 200 and never throws.

Triggers

Use this skill for: "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", or "48-hour cache".

References

ReferenceLoad when the query is about…
references/cache-basics.mdSDK operations (get, put, delete, update), Segment ID, 48hr TTL max, string-only values, segment.delete() null gotcha, segment.update() TTL gotcha

来源与署名

来源:catalystbyzoho/agent-skills位于skills/catalyst-cache提交69e5df0

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架