feat: add session-level publish and comment flow

docs/control-plane-guide.md

@@ -232,17 +232,31 @@ http://127.0.0.1:8787/
 排查原则：
 
 - `transcribe` 失败：先看 `Groq API Key`、`ffmpeg`
-- `song_detect` 失败：先看 `codex_cmd`
+- `song_detect` 失败：先看 `song_detect.provider`，再看 `codex_cmd` 或 `qwen_cmd`
 - `publish` 失败：先看 `cookies.json`、`biliup`
 - `collection_*` 失败：再看任务历史和日志
 
 评论规则补充：
 
 - `comment`
-  - 纯享版视频下默认发“编号歌单”，不带时间轴
-  - 完整版主视频下默认才发“带时间轴评论”
+  - 纯享版视频下默认发 session 级聚合“编号歌单”
+  - 内容按 `P1/P2/P3` 分组
+  - 同一 session 只由 anchor task 发一次
+  - 完整版主视频下默认才发 session 级“带时间轴评论”
+  - 内容按 `P1/P2/P3` 分组
+  - 同一 session 只由 anchor task 发一次
   - 如果当前任务找不到 `full_video_bvid.txt`，也没能从最近发布列表解析出完整版 BV，主视频评论会跳过
 
+session 规则补充：
+
+- 同主播、文件名时间 `3` 小时内的任务会自动归到同一 session
+- session 的 `session_key` 使用最早片段标题
+- 同一 session 内：
+  - 只有 anchor task 真正执行纯享版上传
+  - 纯享版上传会聚合整组 `split_video`
+  - 整组 task 共用同一个 `bvid.txt`
+  - split/full 评论都只发一次
+
 ## Artifacts
 
 这里显示任务当前已经产出的文件，例如：
@@ -324,7 +338,7 @@ http://127.0.0.1:8787/
 - `upload_config_file`
 - `ffprobe`
 - `ffmpeg`
-- `codex_cmd`
+- `codex_cmd` 或 `qwen_cmd`
 - `biliup_path`
 
 如果某个依赖显示 `(external)`，表示它还在用系统或父项目路径，不是 `biliup-next` 自己目录内的副本。
@@ -361,6 +375,7 @@ Settings 分成两层：
 - `min_duration_seconds`
 - `groq_api_key`
 - `codex_cmd`
+- `qwen_cmd`
 - `retry_count`
 - `season_id_a`
 - `season_id_b`
@@ -449,7 +464,7 @@ __BILIUP_NEXT_SECRET__
 
 建议：
 
-- 如果你希望纯享版评论更适合分P浏览，保持 `post_split_comment = true`
+- 如果你希望纯享版评论以 session 级聚合歌单展示，保持 `post_split_comment = true`
 - 如果你不希望尝试给完整版主视频发时间轴评论，可以关闭 `post_full_video_timeline_comment`
 - 如果磁盘紧张，再开启 cleanup；默认建议先关闭，等确认流程稳定后再开