素材首次入库、同商品资料复用或剪辑前查找背景音乐时，按需读取相邻 reusable-material-library/SKILL.md 及其类型说明。先复用已有理解，再补实际缺口；采用结果交原消费者并回读实际产物。

Douyin Music Library

正式独立运行时遵循任务方案、工作台登记与主动定位：主 Agent 登记真实任务并打开当前聊天对应详情；子阶段沿原任务，后台仅更新数据。此约定不扩大本 Skill 的业务权限。

Use this skill to acquire and maintain reusable music assets before editing. Do not mix audio into video and do not publish.

Workflow

1. Read references/input-output-contract.md.
2. Resolve platform_account_uid (the internal Creator Center UID, not the public Douyin ID) from the target account config. Connect only to that account's loopback CDP endpoint, then verify the same-origin read-only identity response before opening the music picker.
3. Use douyin_cdp_music.py list for a read-only picker check, or sync to download missing tracks from the selected tab.
4. Use manage_music_library.py import-manifest to migrate already verified run assets without downloading them again.
5. Use manage_music_library.py select before editing. Continue only when the returned asset has matching account_scope, usage_status=active, rights_review_status=passed, and a valid local sha256.
6. Refresh availability with a complete picker scan. If a stored track disappears, set usage_status=paused but retain its local file and history. A partial or limited scan must never pause unseen assets.

Commands

python3 scripts/manage_music_library.py import-manifest \
  --source-manifest /abs/path/music_asset_manifest.json \
  --account-id <account_id> \
  --library-root /abs/path/data/account-music-library

python3 scripts/manage_music_library.py select \
  --account-id <account_id> \
  --asset-id <asset_id> \
  --library-root /abs/path/data/account-music-library

python3 scripts/douyin_cdp_music.py list \
  --config-root /abs/path/configs \
  --account-id <account_id> \
  --tab favorites --limit 5

Safety Rules

• Never reuse another account's availability evidence, even when audio hashes match.
• Never persist cookies, headers, tokens, browser-profile contents, or a full signed media URL.
• Download through the authenticated browser context with CDP Network.loadNetworkResource and IO.read; fail closed if unavailable.
• Accept only a complete response, write to .part, validate bytes, sha256 and audio metadata, then atomically promote it.
• For batches, process the first item immediately, wait a random 15–30 seconds after each successful item, and stop on the first failure.
• Never click the music picker's “使用” button, submit a publishing form, or modify a video.

Failure Boundaries

Fail closed on missing or remote CDP endpoints, unauthenticated or mismatched accounts, closed picker, ambiguous media responses, incomplete downloads, invalid audio, account mismatch, paused assets, missing files, or hash drift. Do not fall back to another account, exported cookies, a third-party downloader, or raw unauthenticated HTTP.

Resources

• Contract: references/input-output-contract.md
• Persistent library and migration CLI: scripts/manage_music_library.py
• Creator Center CDP adapter: scripts/douyin_cdp_music.py