| name | onezion-wechat-channels-live |
| description | 多平台直播录制 + 视频号专属下载 + 智能总结一体化工具。 整合 StreamCap/streamget(50+ 平台直播录制)与 wechatVideoDownload(视频号视频/直播下载), 录制完成后可自动调用 onezion-video-summarize 进行转录与总结。 触发词:直播录制、视频号直播、live stream recording、看直播、总结直播、 录制直播间、直播回放、download live、record live、wechat channels live。
|
| agent_created | true |
onezion-wechat-channels-live
多平台直播录制 + 视频号专属下载 + 智能总结一体化 skill。
架构
┌─────────────────────────────────────────────────┐
│ onezion-wechat-channels-live │
├────────────────────┬────────────────────────────┤
│ streamget │ wechatVideoDownload │
│ (50+ 平台) │ (视频号专属) │
│ Python CLI │ Windows GUI │
│ 解析流URL+录制 │ 自动监听 + 一键下载 │
├────────────────────┴────────────────────────────┤
│ FFmpeg 录制引擎 │
├─────────────────────────────────────────────────┤
│ onezion-video-summarize (转录 + 总结) │
└─────────────────────────────────────────────────┘
工具选择指南
| 场景 | 工具 | 说明 |
|---|
| B站/抖音/快手/Twitch/YouTube 等 50+ 平台 | streamget + FFmpeg | Agent 可直接调用,全自动 |
| StreamCap GUI 批量监控 | StreamCap 桌面/Web | 纯 GUI,适合长期监控多个主播 |
| 微信视频号(Windows) | wechatVideoDownload | 仅 Windows,需微信 PC 运行 |
| 微信视频号(macOS) | 抓包 + FFmpeg 或 屏幕录制 | 需手动获取流 URL |
重要:StreamCap 是纯 GUI 应用(Flet 框架),没有 REST API,无法被 Agent 直接调用。
Agent 自动化录制使用底层 streamget 库 + FFmpeg,无需启动 StreamCap GUI。
依赖
- Python 3.10+
- FFmpeg(录制 + 转码核心)
- streamget(pip 包,StreamCap 底层流获取库)
检查依赖:
python3 --version && ffmpeg -version && pip3 show streamget
快速安装
bash ~/.workbuddy/skills/onezion-wechat-channels-live/scripts/setup.sh
安装内容:
- 通过 pip 安装
streamget
- 克隆 StreamCap 仓库到
~/Tools/StreamCap/(可选,用于 GUI 模式)
- 检查 FFmpeg 是否已安装
使用方式
一、Agent 自动录制(streamget + FFmpeg)
这是 Agent 可直接调用的自动化路径,适用于 50+ 平台。
基本用法
python3 ~/.workbuddy/skills/onezion-wechat-channels-live/scripts/record_and_summarize.py \
--url "https://live.bilibili.com/xxxxx" \
--duration 3600 \
--output ~/records/stream.flv
python3 ~/.workbuddy/skills/onezion-wechat-channels-live/scripts/record_and_summarize.py \
--url "https://live.bilibili.com/xxxxx" \
--duration 3600 \
--summarize
python3 ~/.workbuddy/skills/onezion-wechat-channels-live/scripts/record_and_summarize.py \
--stream-url "https://pull-flv-xxx.flv" \
--output ~/records/wechat_live.flv
参数说明
| 参数 | 说明 | 示例 |
|---|
--url | 直播间 URL(自动解析流地址) | https://live.bilibili.com/12345 |
--stream-url | 直接提供流 URL(跳过解析) | https://pull-flv-xxx.flv |
--duration | 录制时长(秒),不指定则持续录制 | 3600(1小时) |
--output | 输出文件路径 | ~/records/stream.flv |
--summarize | 录制完成后自动总结 | |
--check | 仅检查依赖 | |
支持的平台(streamget 50+)
国内(30+):抖音、快手、虎牙、斗鱼、B站、小红书、YY、映客、AcFun、京东、淘宝等
海外(10+):TikTok、Twitch、PandTV、Soop、Twitcasting、CHZZK、Shopee、YouTube、LiveMe、Flextv、Popkontv、Bigo 等
注意事项
- YouTube、淘宝等平台需要 cookies
- 小红书、花椒等使用一次性 URL,不支持循环监控
- 抖音短链接需要 Node.js 环境
二、StreamCap GUI(批量监控,可选)
StreamCap 是基于 Flet 的桌面/Web GUI,适合长期监控多个主播。
注意:StreamCap 没有 REST API,无法被 Agent 直接调用。仅作为人工操作的 GUI 工具。
启动
cd ~/Tools/StreamCap && python3 main.py
cd ~/Tools/StreamCap && python3 main.py --web
功能
| 功能 | 说明 |
|---|
| 循环监控 | 实时监控,开播自动录制 |
| 定时任务 | 在设定时间段内检查并录制 |
| 批量录制 | 同时监控多个直播间 |
| 分段录制 | 按时长切分文件(默认30分钟/段) |
| 自动转码 | 录制完成后自动转为 MP4 |
| 消息推送 | 开播状态通知 |
配置
通过 .env 文件配置环境变量:
nano ~/Tools/StreamCap/.env
录制任务通过 GUI 界面添加(点击 "+" 按钮),配置直播间 URL、录制格式、质量等。
DMG 安装(macOS)
也可直接下载预编译包:
三、wechatVideoDownload — 视频号专属
功能
- 视频号视频下载(含加密视频自动解密)
- 视频号直播录制(实时)
- 视频号直播回放下载
- 视频号图片下载
- 自动监听微信客户端流量
平台限制
- 仅支持 Windows
- 需要微信 PC 客户端运行
- 最新版本:v2.6(2025-01-03)
Windows 上安装使用
- 下载:https://pan.quark.cn/s/02054d6f9664 (v2.6)
- 解压后运行 exe
- 点击"开始监听"
- 在微信中打开视频号,软件自动捕获
- 选择下载或复制链接
macOS 替代方案
方案 A:抓取直播流 URL + FFmpeg
- 在微信中打开视频号直播间
- 使用 Charles/Proxyman 等抓包工具捕获直播流
- 找到
https://pull-m*.wxlivecdn.com/*.flv 格式的流地址
- 使用 FFmpeg 录制:
ffmpeg -reconnect 1 -reconnect_streamed 1 -reconnect_delay_max 5 \
-i "直播流URL" -c copy output.flv
方案 B:屏幕录制(onezion-screenpipe)
使用 onezion-screenpipe 进行持续屏幕+音频录制,适合无法获取流 URL 的场景。
方案 C:虚拟机
在 Parallels/VMware 中运行 Windows + wechatVideoDownload。
四、录制 + 总结一体化
录制完成后自动调用 onezion-video-summarize:
python3 ~/.workbuddy/skills/onezion-wechat-channels-live/scripts/record_and_summarize.py \
--url "https://live.bilibili.com/xxxxx" \
--duration 3600 \
--summarize
总结流程:
- 录制完成 → 生成
.flv/.mp4 文件
- 调用
onezion-video-summarize → 云端转录 API(优先)+ 摘要生成
- 输出结构化总结文档
Agent 交互流程
当用户说"帮我录制/总结某个直播"时:
- 确认平台:视频号?还是其他平台?
- 确认目标:直播间 URL
- 确认需求:只录制 / 录制+总结 / 直接总结已有录像
- 执行:
- streamget 支持的平台 →
record_and_summarize.py --url
- 视频号 → 抓包获取流 URL →
record_and_summarize.py --stream-url
- 已有录像 → 直接调用
onezion-video-summarize
- 输出:录制文件 + 总结文档
常见问题
Q: StreamCap 支持视频号吗?
A: 不支持。streamget/StreamCap 平台列表中没有微信视频号(GitHub 上有 3 个 open issue 请求此功能,暂无实现计划)。
Q: wechatVideoDownload 能在 Mac 上用吗?
A: 不能,Windows 专用。Mac 上用抓包+FFmpeg 或屏幕录制替代。
Q: 录制的视频太大怎么办?
A: 用 onezion-video-compress 压缩后再总结。
Q: 部分平台需要 cookies?
A: YouTube、淘宝等需要。StreamCap GUI 模式下可在界面中配置;CLI 模式需自行处理 cookies。
Q: 循环监控某主播开播?
A: 使用 StreamCap GUI 的"循环监控"功能,Agent 无法直接操作此功能(无 API)。