baidu-transcript-export
v1.1.0
Published
Portable Agent Skill for verified batch export of Baidu Netdisk video transcripts
Downloads
24
Maintainers
Readme
百度网盘视频文稿导出
我是一个遵循 Agent Skills 开放格式的百度网盘自动化技能,可以安装到多种 Agent 中。
当你在百度网盘 Mac 客户端里存着一整套课程视频,逐条打开、进入“文稿”、点击“导出”已经变成重复劳动时,你可以雇用我把当前文件夹从第一条处理到最后一条,并为每一次成功导出留下可核对的结果。
当我面对一个包含大量视频的百度网盘文件夹时,我想把逐条检查和导出文稿变成一次可验证的批处理,以便把时间留给阅读、整理和使用内容,同时不用担心误点、漏项或虚假成功。
我帮你推进什么
- 从当前文件夹的第一条视频开始,沿播放器“选集”处理到末尾。
- 视频进入播放页后直接点击“文稿”,无需暂停,也不等待视频缓冲。
- 文稿通常在 3–5 秒内出现;出现后识别并点击左侧导出图标。
- 只有百度网盘显示“正在导出至视频所在文件夹”或“已导出至视频所在文件夹”,才记录为成功。
- 输出 JSON 报告,区分成功、生成中、文稿未出现、导出图标未找到和导出未确认。
为什么可以放心交给我
这个流程来自真实文件夹的反复测试和修正,关键动作都有边界:
- 不碰推荐视频:只处理“选集 查看全部”和“精选”之间的条目。
- 不把 VIP 卡片当文稿:视觉上匹配完整标签栏,同时确认文字顺序为“视频、笔记、AI看、课件、文稿”。
- 不把复制当导出:同时识别“导出 + 复制”两个相邻图标,只点击左侧导出图标。
- 不把点击当成功:必须捕获百度网盘的导出确认提示。
- 不催尚未生成的文稿:遇到“文稿生成中,预计需要 5–20 分钟”时标记为待处理,继续下一条。
使用条件
- macOS
- 已安装并登录百度网盘 Mac 客户端
- 使用的 Agent 具备 macOS 桌面控制、截图识别和点击能力
- 百度网盘当前界面已打开目标文件夹,或已经打开该文件夹中的视频
技能的安装和发现可以跨 Agent;实际操作百度网盘桌面客户端仍需要 Agent 提供 Computer Use 能力。目前完整自动化脚本已在 Codex Desktop 上验证。缺少桌面控制能力时,Agent 应明确提示运行条件,不会把“已安装技能”误报为“已经完成导出”。
安装
npx baidu-transcript-export默认会安装到所有已适配的全局技能目录;已有同名技能会被安全跳过。更新时使用:
npx baidu-transcript-export --force指定 Agent
npx baidu-transcript-export --agent codex
npx baidu-transcript-export --agent claude,cursor
npx baidu-transcript-export --agent opencode| Agent | 全局目录 | 项目目录 |
|---|---|---|
| 通用 Agent Skills | ~/.agents/skills/ | .agents/skills/ |
| OpenAI Codex | ~/.codex/skills/ | .codex/skills/ |
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Cursor | ~/.cursor/skills/ | .cursor/skills/ |
| OpenCode | ~/.config/opencode/skills/ | .opencode/skills/ |
| Google Antigravity | ~/.gemini/antigravity/skills/ | .agent/skills/ |
项目级安装:
npx baidu-transcript-export --scope project预览目标而不写入文件:
npx baidu-transcript-export --dry-run重新打开 Agent 会话后,技能会显示为 baidu-transcript-export。
一句话调用
先在百度网盘中打开目标文件夹,然后告诉 Agent:
使用 $baidu-transcript-export 导出当前百度网盘文件夹中所有视频文稿。具备桌面控制能力的 Agent 会从第一条视频开始执行,持续报告进度,并在最后给出成功与待处理项目的统计。
结果状态
| 状态 | 含义 |
|---|---|
| exported | 已看到百度网盘的导出确认提示 |
| transcript_generating | 百度网盘仍在生成文稿,可稍后重试 |
| transcript_not_verified | 没有可靠确认文稿入口或文稿页面 |
| export_icon_not_found | 没有可靠识别到导出工具栏 |
| export_click_not_confirmed | 已点击,但没有看到导出确认,因此不算成功 |
仓库结构
skill/
├── SKILL.md
├── agents/openai.yaml
├── scripts/baidu-transcript-batch.mjs
└── assets/
├── video-tabs-toolbar.png
└── export-copy-toolbar.png
tests/
├── internals.test.mjs
└── installer.test.mjs
bin/
└── baidu-transcript-export.mjs验证
npm test
npm run check当前识别模板针对百度网盘 Mac 客户端深色播放器界面制作。百度网盘大幅修改界面后,可能需要更新 skill/assets/ 中的模板。
标准与兼容性
技能目录遵循 Agent Skills 规范:以 SKILL.md 为入口,并按需携带 scripts/ 与 assets/。OpenCode 官方文档明确支持 .opencode/skills/、.claude/skills/ 和 .agents/skills/;Cursor 也将 Agent Skills 作为开放格式支持。安装器同时写入各 Agent 的原生目录,以降低不同版本之间的发现差异。
