name	api-usage
description	Windy10v10AI 的 VScripts API 调用规范与工作流（ApiClient、重试机制、Analytics 事件采集与发送模式）。
disable-model-invocation	true

API Usage

本技能用于在本项目中新增/修改 VScripts 侧 API 调用时，遵循既有架构与最佳实践，避免随意拼接口与重复造轮子。

明确要调用的端点、请求方法、body 结构、触发时机
查找现有同类调用（优先复用/对齐）
若需要新 DTO：
- 放到 src/vscripts/api/**/dto/
- 保持字段清晰，发送前补齐 matchId、version 等元数据（如适用）
选择调用模式并实现：
- 模式 1：提供 static 方法，构造 ApiParameter，调用 sendWithRetry
- 模式 2：注册事件监听器，使用静态变量累积数据，在合适状态发送并记录日志
确保日志包含关键可排查信息（成功、失败、数量、玩家等）

name	api-usage
description	Windy10v10AI 的 VScripts API 调用规范与工作流（ApiClient、重试机制、Analytics 事件采集与发送模式）。
disable-model-invocation	true

本技能用于在本项目中新增/修改 VScripts 侧 API 调用时，遵循既有架构与最佳实践，避免随意拼接口与重复造轮子。

明确要调用的端点、请求方法、body 结构、触发时机
查找现有同类调用（优先复用/对齐）
若需要新 DTO：
- 放到 src/vscripts/api/**/dto/
- 保持字段清晰，发送前补齐 matchId、version 等元数据（如适用）
选择调用模式并实现：
- 模式 1：提供 static 方法，构造 ApiParameter，调用 sendWithRetry
- 模式 2：注册事件监听器，使用静态变量累积数据，在合适状态发送并记录日志
确保日志包含关键可排查信息（成功、失败、数量、玩家等）

api-usage