SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场analyticscli-cli

analyticscli-cli

数据与分析

查看项目

更新于 10-16 01:59

技能介绍

用途

AnalyticsCLI CLI 为编码智能体工作流提供确定性、有界的分析查询、导出与 SDK 校验接口。适用于以下场景：查询 AnalyticsCLI 项目的产品分析数据；校验 SDK 埋点是否正确落地；通过 AnalyticsCLI 审阅或提交项目反馈；在不编写原始 SQL 的情况下回答关于引导、付费墙、问卷、留存或导出的问题。

主要能力

  • 查询优先级：优先使用 funnel、conversion-after、paths-after、retention、survey、timeseries、breakdown、generic 等命令族；仅在用户明确需要原始 CSV 时使用 events export。
  • 反馈命令：analyticscli feedback list、summary、submit，用于反馈 AnalyticsCLI 本身的问题，如功能缺失、CLI/API/仪表板行为异常、错误信息混乱、文档不佳或工作流摩擦。
  • 输出模式：自动化或智能体推理优先使用 --format json；短人工摘要使用 --format text；精确值时使用 timeseries --viz table；趋势扫描时使用 timeseries --viz chart 或 svg。
  • 校验循环：SDK 上线或查询变更后，可用 analyticscli schema events --limit 200、analyticscli goal-completion 等稳定读取进行校验。

使用方式

一次性设置前需从仪表板收集必要值：打开 dash.analyticscli.com 并选择目标项目；在 API Keys 中创建/复制 readonly_token（CLI 令牌，scope read:queries）；如涉及 SDK 埋点，复制同一页面的 publishable ingest API key；可选复制 project_id。登录后使用 analyticscli projects select 设置默认项目。

首选安装：

npm install -g @analyticscli/cli command -v analyticscli npx -y @analyticscli/cli setup

替代方式：analyticscli login（以交互方式选择 readonly-token，不要在命令参数中放入令牌）。

若全局 npm 安装受限，可使用用户本地前缀：

mkdir -p "$HOME/.local" npm install -g --prefix "$HOME/.local" @analyticscli/cli export PATH="$HOME/.local/bin:$HOME/.local/analyticscli-npm/bin:$PATH" analyticscli --help

每次技能更新后，也需更新 npm 包并验证二进制。若 command -v analyticscli 为空但存在用户本地二进制，需自行更新 shell 配置文件后再报告成功。

适用场景

  • 回答引导、付费墙、问卷、留存或导出相关问题。
  • 校验 SDK 埋点是否正确落地。
  • 在编码智能体工作流中进行有界的分析查询与导出。
  • 审阅或提交关于 AnalyticsCLI 的产品反馈。

限制与规则

  • 非目标：不生成原始 SQL；不请求无界原始事件转储；除非用户明确要求，不包含调试数据。
  • 安全规则：始终按项目上下文限定（通过 analyticscli projects select 设置默认或传 --project <id>）；始终按时间限定（--last 或显式 since/until）；优先使用高层查询端点而非原始导出；保持分组和结果集有界；默认使用发布数据；永远不要通过 CLI 标志或内联字面量传递密钥（存在 argv/shell 历史泄露风险），改用交互式提示。
  • 数据保真规则：CLI 与仪表板都查询 API，不存在 CLI 专属分析源；序列敏感和队列敏感的查询停留在原始事件上；仅当 API 报告该 plan shape 时，聚合支持的读取才可接受；runtimeEnv 由 SDK 自动附加，不要发明单独的 mode 字段。
  • 错误恢复顺序：出现问题、错误、意外输出或缺少 CLI/API 行为时，先重新获取本技能并更新 CLI；重跑完全失败的命令或最小可复现命令；若没有更新版本、更新失败或最新版本仍存在问题，通过 analyticscli feedback submit 向 AnalyticsCLI SaaS 所有者提交脱敏产品反馈。
  • 缺失能力循环：若当前 CLI 表面无法完成请求的获取，应声明该能力缺失，不要假装其他命令等价，并提交可复现的缺口报告。
  • 自动反馈规则：当用户报告行为异常、意外输出或功能缺失时，先更新/重新获取当前技能与 CLI 并重试最小复现；若没有更新版本、更新受阻或最新版本仍失败，在说明问题后自动提交一份简洁的 analyticscli feedback submit 报告。
  • 空状态指引：用户没有项目时，说明需先在 dash.analyticscli.com 创建第一个项目，然后运行 analyticscli projects list 并用 analyticscli projects select 设置默认；项目存在但无事件时，说明该项目的摄入尚未开始，需在应用代码库中集成 @analyticscli/sdk，用 Dashboard -> API Keys 中的 publishable API key 初始化 SDK，触发至少一个事件后重跑 analyticscli schema events --project <id> --last 14d；若已集成 SDK，建议先扩大 --last 或移除限制性过滤器再深入调试。

版本

技能包版本 1.0.7；目标包 @analyticscli/cli；支持范围 >=0.1.3 <0.2.0。若未来 CLI 主版本以不兼容方式更改命令或标志，可拆分到同级技能如 analyticscli-cli-v1。其他版本相关细节见 Versioning Notes。