技能介绍

要解决什么问题

工程师和创作者常把信息散在视频号、公众号、抖音、小红书和 B 站里：想留底音视频、拿逐字稿做检索，还要落成能进知识库的 Markdown。各平台 CDN 链接会过期，公众号排版又不好直接归档。本技能把「识别链接 → 拉取媒体与文稿 → 按模板写笔记 → 落到 IMA 或 Obsidian」串成一条可在 Agent 里执行的流程。

它怎么工作

授权模型：音视频下载走后端 API，请求必须携带有效 Token（POST /api/auth/status 校验）。Token 是使用权凭证，不是按次扣费；无效或过期会返回 401，需向服务商续期。
统一下载入口：download_media.py 按链接自动识别平台（如 weixin.qq.com/sph/、mp.weixin.qq.com、douyin.com、xiaohongshu.com、bilibili.com），可选 --video、--audio、--transcript，并生成含封面、概要、逐字稿等区块的结构化笔记。
输出模式：output.mode 为 ima、obsidian 或 both。Obsidian 将 .md 与媒体写入本地仓库（公众号走 save_wechat_article.py 本地抓 HTML 转 MD）。IMA 通过 WorkBuddy ima-mcp 连接器上传；公众号在 IMA 下用 import_urls 链入库，其它平台走「生成 MD → COS → add_knowledge」。
可选分析：在已有逐字稿基础上，可按模板做「爆款拆解」或自产视频的「复盘诊断」（不依赖额外付费接口）。

边界与注意点

首次使用须完成 Token 与保存方式配置；IMA 模式还需在连接器里选取知识库 ID，不要手填外链。
IMA 默认只上传 MD；mp4 不被 IMA 接受。仅当用户明确要求时才额外传 mp3。
小红书依赖本地 xhs_cookie.txt 登录态；视频号等异步逐字稿需等 download_media.py 轮询完成后再上传，避免残缺笔记。
传给下载脚本的 URL 必须与用户原文一致，短链末尾字符被模型改错会导致 404。