---
name: xiaohongshu-publish-video
description: "Execute XiaoHongShu (小红书) video-note publishing workflow in the creator platform: open publish center, switch to 视频 mode, prepare video assets, upload videos, fill title/body/topics, configure settings, and validate pre-publish state. Use when the user asks to 发布视频笔记, 发视频, or automate web publishing steps before final submit. Prefer user-provided video paths; if no video paths are provided, generate videos via gemini-video-web and consume manifest target paths for upload. Support configurable publish modes (`safe_mode` and `live_mode`)."
---

# Xiaohongshu Publish Video

## Workflow

1. Confirm account is logged in and creator center is reachable.
2. Open creator publish page and switch to 视频 publishing mode.
3. Prepare video inputs: use user-provided paths first, otherwise generate via gemini-video-web.
4. Upload video and wait for editor panel readiness.
5. Fill title/body/topics and required settings.
6. Validate preview and publish controls.
7. Execute publish behavior according to publish mode.
8. Save publish evidence and return summary.

## Shared Session Policy

- Use per-thread Playwright CLI sessions across all web-automation skills:
  - Auto session policy: `tools/pw` derives one Playwright session per `CODEX_THREAD_ID` (fallback: `PLAYWRIGHT_SESSION_OWNER` or explicit `--session`).
- Use `/Users/xd/java/xhs/tools/pw` as the only Playwright CLI entrypoint.
- Prefer the default auto session; pass `--session <name>` only when explicit isolation is required.

## 1) Enter Creator Publish Page

- From web homepage, click left sidebar `发布`.
- Expect new tab: `https://creator.xiaohongshu.com/publish/publish?...`.
- Switch to the new tab before continuing.

## 2) Switch To 视频 Mode

- Click `上传视频` tab (or equivalent video publish tab text).
- If tab click fails due viewport/position issues:
  - Resize viewport to desktop (for example 1440x1000).
  - Re-snapshot and retry with latest refs.
- Use `上传视频` area visibility as the final switch-success signal.
- Do not treat tab text click success as completion by itself.

## 3) Prepare Videos

- Prefer user-provided absolute file paths when available.
- If user did not provide video paths:
  - Generate videos from topic/content using `gemini-video-web`.
  - Read the generated manifest JSON and extract `files[*].target_path`.
  - Use manifest-derived paths as upload input.
- Ensure at least 1 valid video path exists before entering upload.

Manifest linkage rules:

- Trust manifest `status=ok` and `collected_count>=1` before upload.
- If manifest status is not ok, stop and return video-preparation failure.
- Avoid guessing latest files by timestamp when manifest is available.

## 4) Upload Video

- Click `上传视频` to open file chooser.
- Upload absolute file paths from Step 3.
- After upload, verify editor state:
  - video preview area is visible
  - title and body input areas are visible
  - upload progress indicator is complete

Video readiness rule:

- Wait until transcoding/upload state is done before publish checks.
- If status stays processing beyond timeout, retry snapshot and wait once.
- If still processing, block final publish.

## 5) Fill Core Content

- Fill title textbox (`填写标题会有更多赞哦` or equivalent).
- Fill body contenteditable area.
- Insert topics (mandatory):
  - Click recommended topic chips, and/or
  - Use `话题` button for manual insertion.
  - Validate final topic count from actual editor content, not click count.
  - Ensure total topic count is >= 5 before proceeding.
- Verify body counter and preview panel update.

Topic counting rule:

- Count inserted topic tokens in正文内容（例如 `#话题`）。
- If token count < 5, continue inserting until count >= 5.
- If repeated insertion still fails to reach 5, block final publish.

Title/body rule:

- Title must be non-empty and specific to the video content.
- Body must be non-empty and descriptive (recommended >= 20 Chinese characters).
- If either title or body is empty, block final publish.

## 6) Configure Settings

- Do not add location.
- Review content settings:
  - `原创声明`
  - `公开可见`
  - `定时发布`
  - other toggles as needed by request.
- Ignore geolocation prompts/errors and keep location empty.

Video-specific checks:

- If cover selection is available, confirm a cover is selected.
- If music/subtitle/licensing controls appear, keep defaults unless user explicitly requests changes.

## 7) Validate Pre-Publish State

- Confirm right-side preview reflects title/body/topics.
- Confirm title is non-empty.
- Confirm body is non-empty (recommended >= 20 Chinese characters).
- Confirm topic count is >= 5.
- Confirm no location tag is present in preview.
- Confirm uploaded video count is >= 1.
- Confirm video is ready (no active processing indicator).
- Confirm bottom actions are visible:
  - `暂存离开`
  - `发布`
- Publish hard gate (must all pass):
  - title is non-empty
  - body is non-empty (recommended >= 20 Chinese characters)
  - video count >= 1
  - topic count >= 5
  - location is empty
  - video ready state is true
- Default safety behavior:
  - Do not click final `发布` unless user explicitly asks for real submission now.

## 8) Publish Mode

- `safe_mode` (default):
  - Run full workflow and hard-gate checks.
  - Never click final `发布`.
- `live_mode`:
  - Require explicit user intent for real posting in current turn.
  - Click final `发布` only after hard-gate checks pass.

## 9) Failure Handling (Layered Retries)

- Video preparation failure:
  - If user paths are invalid, ask for corrected absolute paths.
  - If gemini generation fails, stop publish flow and return failure reason.
- Manifest linkage failure:
  - If manifest missing/invalid/empty, retry reading once.
  - If still invalid, stop and return manifest failure.
- Upload failure:
  - If upload area blocks or file chooser fails, re-snapshot and retry once.
  - If still failing, stop and report upload failure.
- Video processing timeout:
  - Retry waiting once with refreshed snapshot.
  - If still not ready, block final publish.
- Content validation failure:
  - If title/body is empty, refill once and re-check.
  - If still empty, block final publish.
- Topic insertion failure:
  - Retry insertion via alternate path (chip -> manual topic button).
  - If topic count stays < 5, block final publish.
- UI interaction failure:
  - On stale refs/click interception/modal cover, wait briefly, re-snapshot, retry once.
- Publish action failure:
  - If publish click fails, re-snapshot and retry click once.
  - If success page still not reached, return publish-step failure.
- Publish gate failure:
  - If any hard gate fails, do not click `发布`; return blocking conditions.

## 10) Reliability Rules

- Re-snapshot after:
  - tab switches
  - upload completion
  - dropdown/modal open/close
- On click interception or stale refs:
  - wait briefly
  - refresh snapshot
  - retry with updated refs.

## 11) Save Publish Evidence

- On successful live publish:
  - Wait for success indicator (for example `发布成功`).
  - Capture success screenshot to:
    - `/Users/xd/java/xhs/output/playwright/xhs-video-publish-success-<YYYYMMDD-HHMMSS>.png`
  - Record:
    - publish time
    - title
    - uploaded video path list
    - screenshot path

## 12) Return Report

Return a compact execution summary:

- uploaded videos count
- title/body/topic/location/video-ready status
- settings changed
- publish mode used (`safe_mode` or `live_mode`)
- whether final publish was intentionally skipped or executed
- evidence info when published (success marker, screenshot path, publish time)

## Boundaries

- Do not post misleading or spam content.
- Do not publish real content without clear user confirmation in current turn.
- Do not modify unrelated account settings.
- Never add location information.
- Never proceed to final publish when topic count is < 5.
- Never proceed to final publish when title is empty.
- Never proceed to final publish when body is empty.
- Never proceed to final publish when uploaded video count is < 1.
- Never proceed to final publish when location is non-empty.
- Never proceed to final publish when video processing is unfinished.
- Default to `safe_mode` unless user clearly requests real posting now.