用途：本技能用于通过 Amplitude 产品分析 API 获取与分析产品数据，涵盖原始事件导出、事件分段、漏斗分析、留存分析、用户查询、行为队列和事件上报。
认证与地址：Dashboard REST 与 Export API 使用 HTTP Basic Auth，用户名为 API key，密码为 secret key，顺序必须是 api_key:secret_key，反序会返回 401。curl 中通过 -u "$AMPLITUDE_API_KEY:$AMPLITUDE_SECRET_KEY" 传入。Dashboard 与 Export 主机为 https://amplitude.com（EU 为 https://analytics.eu.amplitude.com）；上报主机为 https://api2.amplitude.com（EU 为 https://api.eu.amplitude.com）。上报接口不使用 Basic Auth，API key 放在 JSON 请求体的 api_key 字段中。
主要能力与用法：事件导出 GET /api/2/export，start 与 end 使用 YYYYMMDDTHH 格式（UTC 小时），返回 ZIP 压缩的 gzip JSON lines，单次窗口最多 365 天，数据在入库约 2 小时后可用。事件分段 GET /api/2/events/segmentation，e、start、end 必填，i 设置间隔（1 为按天，-300000 为实时 5 分钟）。漏斗分析 GET /api/2/funnels，每个 e 参数为一步事件定义，重复 e 表示多步。留存分析 GET /api/2/retention，使用 se 与 re 定义起始与回访事件。用户查询 GET /api/2/usersearch 支持按 Amplitude ID、用户 ID、设备 ID 或邮箱查找；用户活动流 GET /api/2/useractivity 需传入数值型 Amplitude ID。行为队列 GET /api/3/cohorts 列出项目所有队列，GET /api/5/cohorts/request/<cohort-id> 下载队列成员。事件上报 POST /2/httpapi，HTTP V2 单次最多接受 1000 个事件，time 使用 Unix 毫秒。
使用建议：事件名含特殊字符时，用 --data-urlencode 从文件读取 JSON（如 e@/tmp/amplitude_event.json）可避免 URL 解析问题。时间格式注意区分：Dashboard 端点用 YYYYMMDD，Export 用 YYYYMMDDTHH，上报用 Unix 毫秒。
限制与注意：Dashboard REST 约每小时每项目 1000 次查询；Export 单次上限 4 GB；上报单次最多 1000 事件。secret key 不可暴露在客户端，它授予项目原始事件的完整读取权限。EU 数据驻留项目需替换为对应 EU 主机。排障可运行 zero doctor check-connector --env-name AMPLITUDE_API_KEY 或 zero doctor check-connector --url https://amplitude.com/api/2/events/segmentation --method GET。