用途：把单条抖音视频的元数据与文案沉淀进 Obsidian vault，视频本体留在本机磁盘，保持知识库轻量可检索。
主要能力：用 Playwright 打开视频页并拦截签名 API，取得作者、文案、时长、互动数（点赞/评论/收藏/转发/播放等）及可下载直链；MP4 下载到 ~/Downloads/soia-pkm-clip-douyin/<video_id>/video.mp4，不放进 vault；vault 内写一篇 Markdown 笔记（frontmatter 含 url、author、published_at、metrics、media_local_path 等，正文含来源折叠块、原文与留空的「我的看法」）。按已有笔记 frontmatter 的 url 去重，重复归档默认 SKIP；--force 可覆盖并保留已有 topics/people/摘要。
使用方式：python3 scripts/archive_douyin.py <URL>；不在 vault 内时加 --vault <path>。可选参数 --articles-dir、--metadata-only（只抓元数据不下载）、--timeout 90。vault 定位优先级为 CLI 参数、OBSIDIAN_VAULT 环境变量、私有 config.yml、从 cwd 向上自动发现（AGENTS.md/.obsidian）。依赖 Python 3、playwright；缺失时停止并给出 pip install playwright && python -m playwright install chromium。安装：npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-clip-douyin -y。
限制：需真实浏览器一次，不支持纯 HTTP 取数；签名直链短时效，--metadata-only 后要视频须重新运行；短链去重可能失效，建议用完整 /video/<id> 链接；视频已删除或改版会明确报错，不猜测降级。