byted-marketing-agent-trending-list

趋势榜单（TrendingList）

When to Use

• /trending — 手动触发完整趋势榜单查询
• 用户问"热点话题/话题挑战/热榜事件/行业趋势/公域洞察"
• 用户想了解"最近有什么热点/行业热搜/热门话题挑战"
• 用户说"帮我看看热榜/最近什么事件在热/趋势是什么"
• 被其他编排 skill 调用（如日报生成、内容策划）
• 定时任务自动执行获取最新趋势数据

⛔ OUTPUT RULE — 最高优先级

• 执行过程中禁止向用户输出任何中间过程，包括但不限于：自检、创建虚拟环境、安装依赖、连通性验证等技术步骤。
• 禁止输出以下任何内容（违反即为失败）：
  • ❌ “让我先进行自检” / “正在创建虚拟环境” / “依赖安装中” / “安装还在进行”
  • ❌ “让我先查看技能文件” / “首先进行环境准备”
  • ❌ 接口地址、凭证、token、脚本路径、内部字段名、SDK 版本信息
  • ❌ 数据库表名（如 cdp_voc.hot_topic_insights）、英文字段名（如 main_challenge、heat_value）、query_type 值（如 hot_topic_insights、hot_event）——无论是过程还是结果，一律禁止向用户透露
• 若环境未就绪需要安装，只允许输出一句用户友好的提示（如"正在为您初始化查询服务，请稍候…"），完成后直接返回业务结果，不播报技术细节。
• 只在完成后输出一次：业务结果（行业列表 / 榜单列表 / 单条详情）或”暂无数据/参数缺失需要选择”。

自检与环境准备（每次执行前必须完成）

⚠️ 强制规则

• 所有脚本调用必须使用虚拟环境的 Python：$VENV_PY
• 首次使用或自检失败时，必须先完成下方"安装虚拟环境"步骤，再重新自检通过后才能执行业务调用。
• 禁止直接使用系统 python3，避免依赖污染或版本不匹配。

0. 凭证检测（环境准备前先检查）

if [ -z "$VOLCENGINE_ACCESS_KEY" ] || [ -z "$VOLCENGINE_SECRET_KEY" ]; then
  echo "CREDENTIALS_MISSING"
else
  echo "VOLCENGINE_ACCESS_KEY: 已设置"
fi

• 若输出 CREDENTIALS_MISSING：必须向用户索取凭证，输出：

  🔑 需要配置火山引擎访问凭证，请提供：

  • AccessKey（AK）：
  • SecretKey（SK）：

• 用户提供后，将其存入 shell 变量 VOLC_AK_INPUT / VOLC_SK_INPUT，后续所有命令附加 --ak "$VOLC_AK_INPUT" --sk "$VOLC_SK_INPUT"。
• 若凭证已存在（VOLCENGINE_ACCESS_KEY / VOLCENGINE_SECRET_KEY 已设置），无需询问，直接进入自检。

A. 离线自检（不触网，每次执行前先跑）

SCRIPTS_DIR=$(dirname "$(find ~ -maxdepth 8 -name "openapi_client.py" -path "*byted-marketing-agent-trending-list*" 2>/dev/null | head -1)")
SKILL_DIR=$(dirname "$SCRIPTS_DIR")
VENV_PY=$SKILL_DIR/venv/bin/python3

# 1) 检查虚拟环境是否存在
test -f $VENV_PY && echo "venv OK" || echo "venv 不存在，请先执行安装步骤"

# 2) 检查依赖是否可用
$VENV_PY -c "import volcenginesdkcore; from volcenginesdkcore import ApiClient; print('deps OK')"

# 3) 检查 volcengine-python-sdk 版本（必须 >= 4.0.43）
$VENV_PY -c "from importlib.metadata import version; print(version('volcengine-python-sdk'))"

# 4) 语法检查
$VENV_PY -m py_compile $SCRIPTS_DIR/openapi_client.py && echo "syntax OK"