装一个抖音归档 Skill 到 Obsidian 库:先验仓库状态,再按载体分两路试跑

方法桶双卡的作业卡(仓颉 RIA 六段,业主 2026-10-19 拍板加配);同条主卡见末尾出处区。

R — Reading

“先提取视频 ID,判断是视频帖还是图文帖。视频帖走无水印下载加语音转写,图文帖走正文提取加图片批量下载。” “AI 提炼核心观点,搭目录索引,打标签,整理成带 frontmatter 的 Markdown 笔记。” “你只需要复制这个链接告诉你的 ai 助手让他安装这个 skill 就可以。刷到有用的内容,发个链接,剩下的它来处理。”

出处:原视频 简介文案(本条无口播层,库内 00_原文/douyin/2026-10-21-抖音→Obsidian自动归档);步骤性细节据 仓库 README 补全,README 与文案不同处已在 B 段标出。

I — Interpretation

这类归档 skill 的可迁移设计有两条规则、一条安装套路。两条规则:载体分诊——同一入口进来先判断是视频帖还是图文帖,视频帖取”下载→语音转写→文案”,图文帖取”正文提取→图片批量下载”,取料路径按载体分开;厚度分档——落盘文档的深度按原料文字总量决定,README 明写轻量、标准、深度三档,不靠人临场决定写多长。一条安装套路是把仓库链接交给 AI 助手让它自己 clone、装依赖、配 key,人不手动碰配置文件;转写侧的隐性依赖是 FFmpeg 加一个语音识别服务的 API Key(该仓用硅基流动),也就是”发个链接就归档”的前提是先给它一条会烧额度的转写通道。

A1 — Application Example(仓库实测元数据 + README 记载的安装路径,非效果实测)

2026-10-21 回源核到的事实:仓库 zzybrim/douyin-obsidian 存在且未归档,2026-08-06 创建、最后 push 2026-08-22、star 74、fork 5、根目录无 LICENSE 文件;自称基于 yzfly/douyin-mcp-server 二开,而上游仓库已被原作者标记 archived(star 1279、最后 push 2026-07-02)。README 记载的安装路径:git clone 到 Claude Code 的 ~/.claude/skills/douyin-obsidian(或 Codex CLI 的项目级 .codex/skills/douyin-obsidian)→ python scripts/setup.py 装依赖(自动配 FFmpeg)→ 首次发视频链接时若未配置 API Key,会引导注册硅基流动并把 sk- 开头的密钥写进 ~/.douyin-video/config.json。触发方式是自然语言意图(“把这个视频转成文字""提取图片文字""存到笔记”等)。产出效果未实测:视频与文案均无失败样本、无转写错误率。

A2 — Future Trigger

情境:

  1. 想把刷到的抖音内容随手丢进 Obsidian,不愿意手工建笔记时;
  2. 自建采集管线要决定”视频和图文要不要走同一条路”时;
  3. 评估别人的自动化归档工具、或判断某个第三方 skill 值不值得装时;
  4. 发现自己的自动归档管线”写多长全看当天心情”、产出厚度不稳定时。 语言信号:“这个能不能直接存进我的库""帮我把这条转成文字""装个 skill 就行""这类工具靠不靠谱”。 相邻区分:与”收藏夹定时批量入库”(恐龙哥 10-21 卡)不同——那条是每天批量消化存量收藏,本卡是单条链接随手归档;与”重复工作流教一次沉淀成 Skill”(玄离 10-20 卡)不同——那条管封装自己的流程,本卡管引入别人的成品。

E — Execution

  1. 先验货再装:查三件事——仓库是否 archived、最后一次 push 距今多久、有无 LICENSE。完成标准:拿到 star、创建日、最后 push 日、license 状态四项事实。判停点:上游或本体已 archived 且无 LICENSE → 默认不装进生产环境,只读代码借设计(本条即卡在此点:上游 archived、无 LICENSE、60 天未更)。
  2. 装前六类扫描:按既有第三方 skill 规矩过一遍脚本(网络外发、凭证读写、执行命令、下载内容、写盘位置、依赖来源)。完成标准:六类各有结论一行。判停点:发现密钥明文外发或自动 curl 执行 → 停止,不进第二步之后的任何环节。
  3. 装:clone 到宿主 agent 的 skills 目录(Claude Code 走 ~/.claude/skills/,Codex 走项目级 .codex/skills/),跑仓库自带 setup 脚本装依赖。完成标准:skill 被宿主识别、可列出触发词。
  4. 配转写通道:视频帖路线需要 FFmpeg 与语音识别 API Key。完成标准:密钥落在本地配置文件里、不写进仓库;额度消耗口径清楚(每天几条)。判停点:不想为转写付额度 → 只保留图文帖路线,视频帖路线关闭。
  5. 两路各试一条:一条视频帖、一条图文帖。完成标准:视频帖出口播文案、图文帖出正文与图片,两者都落成带 frontmatter 的 Markdown 并落进指定目录。判停点:任一路线连续失败且原因是平台拦截 → 按红线不重试不绕过,记录失败形态后停。
  6. 对比自己的库:拿它的输出结构对照自家规范(frontmatter 字段、附件位置、索引方式)。完成标准:明确”抄设计”还是”接工具”二选一,并写下理由。

B — Boundary

  • 不要用的场合:库规范已经成型且需要人做裁决环节的(该库的沉淀质量靠”薄厚卡 + 速览判断”,全自动归档会把裁决权交出去);对抖音账号安全敏感的场景——此类工具要下载与登录态,被拦后自动重试违反既定红线;只需一次性取文案时(为一个链接装全套 FFmpeg 与转写通道不成比例);要对外分发或商用时(无 LICENSE 等于没授权)。
  • 作者盲点:文案里”文件归位之后索引页自动更新,新条目顺延编号”在仓库 README 216 行中查无记载(全篇无”索引”二字),属未经证实的自述;全程未提登录、风控、转写错误率与去重——这四个恰是此类管线真正的失效点;也无失败样本与耗时数据。
  • 时效:仓库 2026-08-22 后未更新,抖音接口与硅基流动定价随时会变,本卡步骤以 README 记载时点为准,用前重查。

📺 Florence《抖音→Obsidian自动归档》,抖音,2026-08-10 · 原视频 · 仓库 zzybrim/douyin-obsidian · 上游 yzfly/douyin-mcp-server · 库内 2026-10-21-抖音→Obsidian自动归档 · 手写版对照 卡片/方法/10-21-归档先判载体再定厚度 登记元数据(简):capability_id: cap.kbv2.douyin-archive-skill-intake · importance: 中(借设计为主,工具本体暂不引入)· intents: [第三方skill装前验收, 单条链接归档, 载体分诊与厚度分档] · keywords: [douyin-obsidian, skill 安装, FFmpeg, 转写 API Key, archived]