一个 Claude Code skill：把视频链接（抖音 / 哔哩哔哩 / 小红书 / YouTube）一键转成飞书结构化笔记——含执行摘要、完整论证链路、Demo 详解、名词解释、金句和分章节逐字稿，自动归档到飞书云盘。
替代 Get 笔记的飞书原生方案，专为重度飞书 + Claude Code 用户设计。
A Claude Code skill that turns Douyin/Bilibili/Xiaohongshu/YouTube video links into rich, structured notes in Lark (Feishu) Docs. Lark-specific — heads-up for international readers.
把任意一条视频链接（含分享口令文本），自动转成飞书里逐字稿 + 妙记 + 结构化文档三件套，归档到云盘指定文件夹。
结构化文档包含：
- 📍 来源信息（蓝色高亮块）
- ✨ 执行摘要（黄色高亮块，3-5 行讲清作者想说啥）
- 🎯 核心论点（一句话立场）
- 🧭 完整论证链路（4-6 段叙述 + 必要 bullet）
- 🎬 Demo 实操（如果视频里有）
- 📚 名词解释（用大白话 + 类比，只解释真正生僻的）
- 💬 金句原文（≤ 3 句）
- 📜 逐字稿（按章节切分，带时间戳跳转）
Input（小红书短视频，3 分 47 秒）：
http://xhslink.com/o/4iU6H2cknfb 教程：用AI做出超级好用的求职个人主页🌟
Output（飞书文档）：
📋 配套飞书妙记（含逐字稿原文）：obcnphje7blvr3y2r241f84v
文档实际渲染效果（4 张截图）：
| 块 | 截图 |
|---|---|
| 标题 + 来源信息 + 执行摘要 |  |
| 完整教程步骤（叙述段落 + 适度 bullet） |  |
| 名词解释 + 金句原文 |  |
| 逐字稿（按章节切分，带 emoji + 时间戳） |  |
URL 输入
├─ download.sh 下载 mp4
│ ├─ 抖音：iesdouyin.com 解析 play_addr（绕开 cookies）
│ ├─ 哔哩哔哩 / YouTube / 小红书：yt-dlp
│ └─ 非视频内容 → exit 2 → 主动建议改用 defuddle skill
│
├─ get-captions.sh 尝试抓平台字幕
│ ├─ 拿到（B站 AI 字幕 / YouTube auto-captions）→ 直接进 Claude 写文档
│ └─ 没拿到 → 走飞书妙记 ASR 兜底
│
├─ 飞书妙记（兜底） lark-cli minutes +upload，等 ASR 完成拉逐字稿
│
├─ Claude 撰写 基于逐字稿按 11 块结构化模板写飞书 docx XML
│ （不直接复用妙记自带的 AI 总结，密度太低）
│
└─ lark-cli docs +create 落地到飞书云盘，返回 URL
字幕优先意味着 B站 / YouTube 大多数视频 3-5 分钟出结果；只有抖音、小红书或没字幕的视频才走妙记（多花 8-15 分钟）。
直接把这一句话复制给你的 Claude Code 或 Cursor：
帮我安装这个 Claude Code skill: https://github.com/teemoweng/lark-video2note
AI 会自己读这份 README，处理 clone、依赖检查、setup.sh 配置向导，跑完就能用。
AI 助手看到这一段请按下方「安装」章节的步骤执行：
git clone https://github.com/teemoweng/lark-video2note ~/.claude/skills/lark-video2note- 提醒用户在新会话生效前重启 Claude Code
- 执行
bash ~/.claude/skills/lark-video2note/scripts/setup.sh（这一步是交互式的，需要用户在终端里完成飞书 OAuth + 选目标文件夹）- 装完告知用户：以后在 Claude Code 里贴视频链接 + 「转成笔记」即可触发
| 工具 | 用途 | 安装 |
|---|---|---|
lark-cli |
飞书云盘 / 文档 / 妙记 API | npm install -g @larksuite/cli |
yt-dlp |
视频下载 + 字幕抓取 | brew install yt-dlp（或 pip install yt-dlp） |
curl |
抖音 share API | 系统自带 |
python3 |
JSON 解析 / 字幕处理 | macOS 自带 / brew install python |
| Chrome 浏览器 | B站字幕 / 小红书 cookies 来源（需登录） | — |
把本 repo 作为 Claude Code 的 skill 安装到 ~/.claude/skills/lark-video2note/：
git clone https://github.com/teemoweng/lark-video2note ~/.claude/skills/lark-video2note
cd ~/.claude/skills/lark-video2note安装到 ~/.claude/skills/ 下后需要重启 Claude Code 让 skill 被发现。
跑首次配置向导：
bash scripts/setup.sh向导会：
- 检查依赖
- 检查 lark-cli 登录态（缺 scope 会提示你跑
lark-cli auth login） - 让你选「让我建一个文件夹 / 我已经有 token」，把目标飞书云盘文件夹写进
config.json
需要的 lark-cli scope：
drive:drive
docs:document
minutes:minutes:readonly
minutes:minutes.artifacts:read
minutes:minutes.transcript:export
在 Claude Code 里直接说：
帮我把这条视频转成笔记：https://www.bilibili.com/video/BV...
或者：
/video2note https://v.douyin.com/xxx/
Claude 自动跑下载 → 字幕/妙记 → 撰写 → 归档四步，返回飞书文档 URL。
如果你贴 URL 时没加明确意图（"转成笔记"、"留档"等动词），Claude 默认会按全局规则先 triage 再问你。
把下面这段贴进你的 ~/.claude/CLAUDE.md，可以让 Claude 更聪明地判断是要 video2note、defuddle、还是别的处理路径：
## URL 链接处理
当用户粘贴一条 URL（裸链接、分享口令、markdown 链接皆可），**但没有明确表达想做什么时**，按 `triage → ask → act` 三步走，不要贸然触发任何 skill：
1. **分诊**：先识别这是什么。能从 URL 模式直接判的就直接判：
- 视频：`v.douyin.com` / `bilibili.com/video/` / `youtu.be` / `youtube.com/watch`
- GitHub 资源：`github.com/.../pull/` / `issues/` / `commit/`
- 网页文章：`mp.weixin.qq.com` / 一般博客域名
- 不确定的（如 `xhslink.com` 既可能是视频也可能是图文）：用 curl HEAD 看 og:type 探一下。
2. **报告 + 询问**：一句话告诉用户看到的是什么，再列 2-3 个可能的下一步动作让用户选。
3. **执行**：仅在用户回应明确意图后，调用对应 skill。
**例外**：用户的同一条消息里如果已经包含明确动词（总结 / 整理 / 归档 / 留档 / 转笔记 / 翻译 …），直接执行，不要为了问而问。- 小红书需要 Chrome 已登录小红书账号（脚本会自动读 cookies）
- 抖音的 share API 偶尔会被风控，目前稳定但不保证未来不变
- B站 AI 字幕对专业术语 / 多人对话识别率比飞书妙记略低；如果质量明显差，可以手动改走妙记路径
- 40 分钟以上视频 飞书 docs
--content一次性传可能超限，skill 会自动改用「骨架 + append」分段 - 本 skill 仅支持飞书生态，不支持归档到 Notion / Obsidian / 本地 markdown 等
- 支持归档到本地 markdown 文件（无飞书账号的用户）
- 支持小宇宙 / Apple Podcasts 等播客平台
- 支持本地 mp4 / mp3 直接处理（绕过下载步骤）
- 长视频自动智能切章（不依赖逐字稿的时间戳）
MIT License — 可商用、可修改、可二次分发。详见 LICENSE。
Teemo Weng — teemoweng.github.io