mcpField
C
catalyst-signals

catalyst-signals

github.com/catalystbyzoho云与 DevOps70968 次安装今天更新
代码仓库

关于 catalyst-signals

catalyst-signals 是用于配置 Catalyst Signals 事件流的技能，适合通过控制台构建事件驱动流程的项目团队。它涵盖发布者、规则、过滤与转换，以及 Webhook、函数和电路等目标；配置仅能在控制台完成。

主要功能

  1. 01配置发布者与事件
  2. 02设置规则、过滤器和载荷转换
  3. 03将事件发送到 Webhook、函数或电路
  4. 04选择即时或批量分发策略
  5. 05查看事件状态与日志

适用场景

  1. 01为事件配置函数或 Webhook 目标
  2. 02按条件过滤并转换事件载荷
  3. 03在开发环境修改规则并部署
  4. 04检查事件分发状态与日志

安装

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

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

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

附带文件references/signals-basics.md

详细介绍

前提条件

使用 Signals 前，请先在控制台中为每个项目激活一次：

控制台 → 您的项目 → 左侧边栏中的 Signals → 点击 "Start Exploring"

跳过此步骤将无法访问 Publishers、Webhooks、Rules 和 Logs。每个项目只需激活一次。

工作原理

  1. 仅限控制台的服务——如果用户期望使用 SDK/API，必须明确说明不可行。 Catalyst Signals 完全通过 Catalyst 控制台进行配置——没有用于创建 publishers、rules 或 webhooks 的 SDK、REST API 或编程接口。所有设置均通过控制台 UI 完成。

    • Publishers、事件、webhooks 和 rules 在 Console → Signals 中创建
    • Functions 和 Circuits 在 Console → Serverless 中单独创建，然后在 Signals rules 中选为目标
    • 代码层面唯一的交互是在目标 functions/circuits 中接收事件

  2. 了解流程——Publisher → Event → Rule（含筛选器/转换）→ Target（Webhook/Function/Circuit）

  3. 加载 references/signals-basics.md——了解 publishers（Zoho/Catalyst/Custom）、事件、rules、目标、分发策略、事件状态和部署注意事项

  4. 关键概念：

    • Publishers 在操作发生时发出事件（共 3 种：Zoho、Catalyst CloudScale、Custom）
    • Events 是 JSON 负载，带有自动生成的架构（Zoho 每个事件最大 100KB，Custom 每个事件最大 64KB）
    • Rules 将 publishers 连接到目标，可选配置筛选器和负载转换
    • Targets 通过 Webhooks、Functions 或 Circuits 接收事件
    • Dispatch Policy 控制事件投递方式：Instant（默认，立即投递）或 Batch（按数量 / 大小 / 计划 / 属性；TTL 固定为 24 小时）。“One-Time Dispatch”不是一种策略——当 Batch 的条件在 TTL 到期前始终未满足时，它是触发的无重试后备投递

  5. 部署警告——生产环境中的 Rules 已锁定（只能启用/禁用）。所有 Rule 更改都必须在 Development 中进行并部署。每次部署最多 25 个 publishers。

安全检查清单

  • Custom publisher REST API 速率限制：每分钟 500 个请求。超过此限制会导致 API URL 被锁定 60 秒。
  • 特定环境的 REST API URL：Custom 事件 REST API URL 在 Development 和 Production 中有所不同——部署时请更新 URL。
  • Function/Circuit 目标沿用其自身权限：如果目标是一个 function，它将按照配置的权限范围（用户或管理员）运行。Signals 不会覆盖 function 级别的权限。
  • 事件负载大小限制：Zoho publishers 每个事件最大 100KB（多事件批次最大 5MB）。Custom publishers 每个事件最大 64KB（最多 25 个事件时最大 256KB）。

触发词

在以下场景中使用此技能："Signals"、"Catalyst 事件总线"、"事件驱动架构"、"publisher"、"Zoho publisher"、"Catalyst publisher"、"custom publisher"、"事件架构"、"rule"、"事件筛选器"、"事件转换"、"webhook 目标"、"分发策略"、"即时分发"、"一次性分发"、"计划分发"、"批量分发"、"事件排序"、"重试策略"、"TTL"、"事件状态"、"Signals 日志"、"Signals 仪表板"、"部署 Signals"或"Signals 控制台"。

参考资料

参考资料在查询涉及以下内容时加载……
references/signals-basics.mdPublishers（Zoho/Catalyst/Custom）、事件和架构、custom event REST API、rules 和筛选器、目标（webhooks/functions/circuits）、分发策略（One-Time/Scheduled/Batching）、事件转换、重试策略、事件排序、事件状态、日志、仪表板、部署限制、生产环境限制

评论

支持 Markdown