☁️ 云服务与消息推送 (Cloud Services)

专为流程编排与自动化设计的云端扩展套件，整合了通用 REST API 接口调用器、主流大语言模型（LLM）客户端以及多渠道群机器人协同通知组件。

---

📖 简介 (Overview)

xy_cloud 套件为流程自动化提供了连接云端基础设施的能力：

• 通用 HTTP/RESTful 通信：支持动态认证（Bearer、API Key、Basic Auth）、自动重试、网络代理及基于 JSONPath 的灵活字段提取。
• 现代化 LLM 接入：无缝对接 DeepSeek、OpenAI GPT-4o、通义千问 (Qwen)、Moonshot (Kimi)、Ollama 等主流大模型，提供提示词工程配置与结构化 JSON 模式输出。
• 团队协作与实时告警：内置钉钉 (DingTalk)、企业微信 (WeCom)、飞书 (Feishu) 及自定义 Webhook 推送，支持加签签名防伪造与富文本 Markdown 卡片消息。

---

✨ 核心特性 (Features)

• 云端 HTTP 客户端 (CloudHttpRequest)：
  • 支持 GET / POST / PUT / DELETE / PATCH / HEAD 全量请求方式。
  • 内置 Bearer Token、Basic Auth、Header/Query API Key 等多套鉴权方案。
  • 遇到 429 Too Many Requests 或 5xx 服务端异常时支持自动退避重试。
  • 支持 JSONPath 语法直接提取深层数据（如 data.items[0]、choices[0].message.content）。
• 统一云端大模型接口 (CloudLLM)：
  • 基于行业标准大模型协议，支持一键切换端点。
  • 支持环境变量读取密钥（如 env.DEEPSEEK_API_KEY、env.OPENAI_API_KEY）。
  • 支持系统提示词（System Prompt）、采样温度（Temperature）、最大 Token 长度控制。
  • 原生支持强制 JSON 模式（JSON Mode），保障自动化流程中下游解析稳定。
• 全渠道群机器人告警 (CloudNotify)：
  • 原生适配钉钉、企业微信、飞书机器人协议及通用 Custom Webhook。
  • 支持文本（Text）与富文本（Markdown）卡片格式。
  • 支持时间戳与加签鉴权，防止接口伪造攻击。

---

🛠️ 动作指令全景速查 (Action Catalog)

动作标识 (Tag)	功能名称	描述	输出类型
CloudHttpRequest	云端 HTTP 请求	通用 REST API 与 HTTP 接口调用器，支持鉴权、重试、代理与 JSONPath 提取	string
CloudLLM	云端大模型	标准大模型客户端（DeepSeek / GPT-4o / Qwen / Kimi 等），支持 JSON 模式	string
CloudNotify	群机器人通知	发送钉钉、企业微信、飞书群机器人消息与 Webhook 告警，支持加签与 Markdown	string

---

📚 详细参数说明与参考 (Detailed Reference)

1. CloudHttpRequest - 云端 HTTP 请求

执行标准网络请求并提取响应结果。

• 输入参数：
  • url (String)：目标接口完整地址（支持变量插值）。
  • method (String)：HTTP 谓词方法（GET, POST, PUT, DELETE, PATCH, HEAD）。
  • headers (String)：支持多行 Key: Value 或 JSON 格式请求头。
  • query_params (String)：URL Query 参数，支持多行 k=v 或 JSON 对象。
  • auth_type (String)：认证方式（None, Bearer Token, API Key (Header), API Key (Query), Basic Auth）。
  • auth_token (String)：认证凭据，支持通过 env.KEY 读取环境变量。
  • auth_header_key (String)：自定义 Header 键名（默认 Authorization 或 X-API-Key）。
  • body (String)：请求载荷，支持 JSON 字符串或表单数据。
  • content_type (String)：媒体类型声明（默认 application/json）。
  • timeout_secs (Number)：阻塞超时限制时间（单位：秒，默认 30）。
  • proxy (String)：网络代理地址（可选，如 http://127.0.0.1:7890）。
  • retry_count (Number)：遭遇 429 或 5xx 故障时的重试尝试次数（默认 3）。
  • json_path (String)：JSONPath 表达式，提取特定节点。
  • output_var (String)：存储响应结果的目标变量名。
• 输出类型： string（响应正文或提取出的字段内容）

---

2. CloudLLM - 云端大模型

发起大模型文本生成、总结与推理。

• 输入参数：
  • endpoint (String)：服务提供方基础地址（默认 https://api.deepseek.com/v1）。
  • api_key (String)：鉴权 Key，支持环境变量注入（env.DEEPSEEK_API_KEY）。
  • model (String)：模型型号标识（如 deepseek-chat, gpt-4o, qwen-plus）。
  • prompt (String)：用户输入提示词（支持动态上下文插值）。
  • system_prompt (String)：约束大模型角色行为的 System Prompt。
  • temperature (Real)：控制回答发散度（0.0 ~ 2.0，默认 0.7）。
  • max_tokens (Number)：单次输出 Token 长度阈值（默认 2048）。
  • json_mode (Number)：是否开启结构化 JSON 返回（0 关，1 开）。
  • output_var (String)：存储模型生成回答的变量名。
• 输出类型： string（大模型生成的文本或 JSON 内容）

---

3. CloudNotify - 群机器人通知

在自动化关键节点向即时通讯群组推送运行状态或异常告警。

• 输入参数：
  • channel (String)：目标推送通道类型（DingTalk, WeCom, Feishu, CustomWebhook）。
  • webhook_url (String)：群机器人的完整 Webhook 接口 URL。
  • secret (String)：安全加签 Secret（防篡改签名）。
  • msg_type (String)：消息展示类型（text, markdown）。
  • title (String)：卡片展示标题（Markdown 模式生效）。
  • content (String)：推送正文内容，支持变量与多行 Markdown 排版。
  • output_var (String)：接收机器人服务端响应结果的变量名。
• 输出类型： string（服务商接口返回的 JSON/状态描述）

---

📦 插件配置定义 (Manifest Reference)

{
  "plugin_id": "xy_cloud",
  "name": "云服务与消息推送 (Cloud Services)",
  "version": "0.50.5",
  "group": "Cloud",
  "group_icon": "☁",
  "description": "提供云端接口调用、AI 大模型问答以及企业微信、钉钉、飞书群机器人消息推送等功能",
  "actions": [...]
}

---

📄 许可证 (License)

本插件遵循免费专有许可协议 (Freeware)。供 小友+ 用户免费下载与使用，未经官方书面授权，严禁对二进制文件进行逆向工程、反编译或二次打包转售。