Overview

Use this skill to publish local videos to Douyin with a deterministic CLI flow:

• Validate local dependencies and env.
• OAuth authorize and store encrypted token locally.
• Prepare video metadata and transcript from local audio.
• Generate 3 caption candidates in chat from transcript.
• Confirm or edit caption, then publish.
• If official publish permission is unavailable, export an outbox package for manual publish.

Use the script at /scripts/douyin.js.

Required Environment

Set these environment variables before auth or publish:

• DOUYIN_CLIENT_KEY
• DOUYIN_CLIENT_SECRET
• DOUYIN_REDIRECT_URI

Optional overrides:

• DOUYIN_SCOPE
• DOUYIN_TOKEN_ENC_KEY
• DOUYIN_ASR_MODE (api / whisper-gpu / whisper-cpu)
• DOUYIN_ASR_API_URL
• DOUYIN_ASR_API_MODEL
• DOUYIN_ASR_API_KEY
• DOUYIN_WHISPER_BIN
• DOUYIN_WHISPER_MODEL_PATH
• DOUYIN_FFMPEG_BIN
• DOUYIN_FFPROBE_BIN

Workflow

• Run dependency checks:

node /scripts/douyin.js doctor

• Authorize account (manual code paste flow):

node /scripts/douyin.js auth

• Prepare transcript and metadata from a local video path. Accept both Linux and Windows path formats.

node /scripts/douyin.js prepare --video "E:\\videos\\demo.mp4"

• Create 3 caption candidates from transcript.text with this structure:
• Line 1: title hook
• Line 2-3: concise description
• Final line: 2-5 hashtags

• Ask user to select or edit one final caption.

• Publish with explicit visibility and confirmation policy:

node /scripts/douyin.js publish \
  --video "E:\\videos\\demo.mp4" \
  --text "" \
  --private-status 0 \
  --auto-confirm false

Command Behavior

• doctor: reports dependency and env readiness plus install hints.
• auth: opens OAuth URL, accepts pasted callback URL or code, stores encrypted token.
• prepare: returns metadata, transcript, and ASR failure detail (without stopping publish flow).
• publish: uploads and creates video via official API. If permission-like API errors occur, writes fallback files under outbox and returns mode: fallback.
• config: stores persistent settings (defaultPrivateStatus, autoConfirm, whisperBin, whisperModelPath, outboxDir, etc.).

Caption Rules

Before publish:

• Keep final text length <= 1000.
• Always show the final draft to the user.
• If auto-confirm is false, require explicit user confirmation in terminal.

Output Contracts

Treat script stdout as JSON. Always parse and branch by:

• ok
• command
• mode (official or fallback for publish)
• asrError (optional in prepare)