用途：封装 Shopee Open Platform Livestream 模块的 25 个 API，用于创建和管理 Shopee（虾皮）店铺直播场次及直播中的商品、展示与互动。调用前依赖 linkfox-shopee-store-auth 选店，请求经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发，path 须为 api/v2/livestream/...。
主要能力：上传图片（upload_image）；场次管理（create_session、update_session、start_session、end_session、get_session_detail）；商品列表管理（add_item_list、delete_item_list、update_item_list、get_item_count、get_item_list、get_like_item_list、get_recent_item_list）；商品集合（get_item_set_list、get_item_set_item_list、apply_item_set）；展示位管理（update_show_item、delete_show_item、get_show_item）；数据指标（get_session_metric、get_session_item_metric）；评论互动（get_latest_comment_list、post_comment、ban_user_comment、unban_user_comment）。
使用方式：可用通用入口 python scripts/livestream_api.py '<JSON 参数>' [--inline]，或按操作调用对应脚本（如 upload_image.py、create_session.py、start_session.py 等）。响应默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json；≤8 KB 时落盘后完整 JSON 打印到 stdout，>8 KB 时只输出摘要，加 --inline 可强制全量打印。读数据建议先看摘要，再用 jq 或 ConvertFrom-Json 从保存文件按需抽取。
适用场景：创建并开播（上传素材、创建场次、添加商品、开始直播）；直播中管理（切换展示商品、评论互动、查看数据）。
限制：本工具不消耗算力；会消耗算力的失败或空结果不得自动换关键词、翻页或连续试探，需继续检索时应先向用户说明。未配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY、响应 401 或 402、或提示算力/余额不足时，按 references/onboarding.md 处理。运行前执行 python scripts/check_auth_dependency.py，exit code 42 需先安装 linkfox-shopee-store-auth。不可写入 /tmp，当前目录不可写则报错。店铺授权、短视频、通用媒体上传、商品 listing 由其他对应技能处理。