有数报告分析技能（Report Analysis）

功能

该技能支持：

• 通过 reportId 查询报告元信息、页面列表、组件信息概览。
• 输出结构化的报告概览（页面数量、组件数量、组件类型等），便于快速理解报告内容。

使用场景

• 需要快速浏览某个报告的页面/组件结构，了解包含哪些图表和筛选器。

依赖环境

• Node.js 20+
• 需要网络访问有数平台 API
• 需要安装 skill youdata-env-config 并完成配置（用于获取 token 和 domainUrl）

使用方法

1. 提供报告ID（reportId），或在parameter.js中配置默认reportId。
2. 运行脚本获取报告分析结果。

运行前准备

1. 确保已安装并配置好 youdata-env-config 技能，用于生成 token 和 domainUrl。
2. 在本技能目录的 scripts/parameter.js 中可配置默认的 reportId。
3. 也可通过命令行参数直接传入 reportId 或带有 reportId 的描述文本（如 报告ID: 12345 ...）。

配置要求

需要在技能目录下 /scripts/env.js 中配置：

• tokenKey: 用户的有数 tokenKey
• domainUrl: API 域名

调用示例

• step1：使用 skill youdata-env-config 获取 env（json字符串格式），同一次会话youdata系列的skill可以复用，不用二次生成
• step2：获取当前 SKILL.md 的绝对目录地址 skillFolder
• step3：调用脚本
• 1. 直接指定 reportId：

node skills/reportAnalysis/scripts/index.js 12345 '{"token":"...","domainUrl":"..."}'

• 3. 通过描述文本提取 reportId（例如："报告ID: 12345 需要分析页面组件"）：

node skills/reportAnalysis/scripts/index.js "报告ID: 12345 需要分析页面组件" '{"token":"...","domainUrl":"..."}'

参数说明

• reportId：报告唯一标识（必选）。
  • 若第一个位置参数为纯数字，则直接作为 reportId。
  • 若第一个位置参数为描述文本，则会尝试从中提取 reportId（例如：报告ID: 12345）。
  • 如果未提供第一个位置参数或无法从中解析，则会从 parameter.js 读取 reportId。
• env：JSON 格式字符串，包含 token 和 domainUrl。

输出示例

程序会输出“分析摘要”部分，包含报告名称、页面数量、组件数量等信息；并同时输出“原始返回结果”供进一步分析。

错误处理

• 缺少必需参数时会输出正确用法提示并退出。
• 环境变量解析失败会返回解析错误信息。
• 网络或 API 错误会显示具体错误并终止执行。
• 若上层自然语言到组件的解析失败，会提示无法定位对应图表并要求用户提供 reportId。