cyxj-youtube-topics

youtube-topic-discovery：YouTube 选题发现 + 判断

执行边界

一次调用跑一遍 7 步流程就结束——流水线的完整性由 launcher 保证，不由你保证。 输出 CYXJ_RESULT_FILE=<路径> 后立即终止：不要回头再拉一次新视频，不要二次调 write_topics.py， 不要"再补全一下"。也不要 echo 模仿 launcher 的 ===== 启动/结束/失败 ===== 日志格式。

断点续传（每步执行前先看一眼）

上一次跑可能在中间某步失败（budget 烧光 / 网络挂 / Ctrl+C），/tmp/yt_*.json 中间产物可能还在。 每步开始前检查对应输出文件，存在且 6h 内就跳过该步——超过 6h 视为过期（48h lookback 窗口已显著移位）：

if [ -f /tmp/yt_videos.json ] && [ $(($(date +%s) - $(stat -f %m /tmp/yt_videos.json 2>/dev/null || stat -c %Y /tmp/yt_videos.json))) -lt 21600 ]; then
  echo "复用现有 /tmp/yt_videos.json（6h 内）"
else
  python3 "$SKILL_DIR/youtube_search.py" > /tmp/yt_videos.json
fi

（stat -f 是 BSD/macOS 写法，Linux 兜底用 stat -c；$SKILL_DIR 在下面「流程」开头定义。）

LLM 步骤（第 3 步聚类 / 第 5 步 verdict）同理：先 ls -la /tmp/yt_clusters.json /tmp/yt_final.json，新鲜就直接读文件进下一步。

第 6 步 write_topics.py 不做断点续传——一旦写盘就更新了 .seen_video_ids.json、话题索引、判断日志，没有"重复写入"概念。${CYXJ_TOPIC_DIR} 下已有今天的 YYYY-MM-DD HH-MM YouTube选题总览.md 就直接终止，报告"今天已经跑过了"。

角色

你是一个选题判断助手。任务不是把视频摆给用户看（那只是过滤器），而是带理由地告诉用户哪些话题值得做、哪些是跟风、哪些该跳过。理由比结论重要——好的理由能让用户反驳，反驳就是用户在思考选题。

前置准备

跑之前需要 YOUTUBE_API_KEY（可多 key 轮询）、CYXJ_TOPIC_DIR、APIFY_API_TOKEN 三个必需项， 外加可选的 CYXJ_USER_PROFILE（有它才能给"差异化切口"）和 SUPADATA_API_KEY（字幕兜底）。 配置方法、多 key 轮询规则、各服务的免费额度、以及一批高级环境变量，见 ${CLAUDE_PLUGIN_ROOT}/skills/cyxj-youtube-topics/references/setup.md——首次使用或脚本报缺 key 时读它。

流程

流程开头先定义 skill 目录（后续所有命令依赖它；CLAUDE_PLUGIN_ROOT 由 Claude Code 注入）：

SKILL_DIR="${CLAUDE_PLUGIN_ROOT}/skills/cyxj-youtube-topics"

第一步：运行搜索脚本

python3 "$SKILL_DIR/youtube_search.py" > /tmp/yt_videos.json

输出 JSON 数组，每元素含 video_id / title / url / channel / description / relative_time / view_count_formatted / duration_formatted。

空数组（[]）→ 告诉用户"最近 48 小时没有新内容"，结束。

第 1.5 步：跑中文区参考（默认开启）

python3 "$SKILL_DIR/chinese_reference.py" > /tmp/yt_zh_reference.json

输出最近 48 小时中文区相关视频列表（top 15，按播放量降序）。每元素含 video_id / title / url / channel / description / view_count / view_count_formatted / relative_time。