WORKFLOW · 工作流
一条链接的旅程
01链接
weixin.qq.com
/sph/ 分享链接
03下载
H.264 高清版
+ H.265 省空间版
06确认门
抓评论/回放时
询问 → 确认 → 执行
07入库
Obsidian 灵犀库
LingxiSync v5 标准
QUICKSTART · 快速开始
三种用法
最常用的是第一种——动口不动手，对任意接入的 Agent 说人话即可。
# ① 对话式（推荐）：对 Kimi / Claude Code / Codex 说
"用 Mark-wx-video-insight 处理这个视频号链接"
"下载并拆解这条视频号，顺便看看评论"
# ② 终端式：无头下载 + 转录（免密码）
python3 ~/.agents/skills/Mark-wx-video-insight/scripts/wx_pipeline.py \
"https://weixin.qq.com/sph/xxxx"
# ③ 终端式：含评论抓取（需密码 + 微信在线）
python3 ~/.agents/skills/Mark-wx-video-insight/scripts/wx_pipeline.py \
"https://weixin.qq.com/sph/xxxx" --comments --deep-scan
BOUNDARY · 能力边界
能做什么，不能做什么
| 场景 | 路径 |
|---|
| 普通分享视频 | 无头模式：免密码、不改代理、不开微信 |
| 互动数据（赞/藏/转/评数） | 无头模式直接可得 |
| 评论内容 | 捕获模式：需微信桌面版在线 + 一次密码 |
| 直播回放 | 捕获模式，无头不保证成功 |
| 疑似预览截断 | 下载时长明显偏短时，切捕获模式拿完整版 |
| 多条链接 | 可一次发多条，串行处理；捕获模式一次一条 |
RULES · 评论抓取规则
防风控，也为洞察
| 规则 | 说明 |
|---|
| 100 条封顶 | 一级 + 二级合计，分页间隔 1 秒，硬性不调高 |
| 点赞 > 20 预筛 | 主流声音快速入池 |
| --deep-scan | 低赞评论全量保存，语义扫描只留「强痛点」 |
| 定位契合度 | 只深挖与「普通人 × AI 时代 × 成长跃迁」契合的痛点 |
| 数据不出本机 | 评论属登录态数据，仅存本地与 Obsidian |
AGENTS · 三端同源
一个 Skill，三个入口
Skill 本体在 ~/.agents/skills/Mark-wx-video-insight，Claude Code 与 Codex 通过软链接共享同一份源文件——改一处，三端同时生效。
Claude Code
~/.claude/skills
边界：脚本依赖本机 macOS 环境（下载器后端、Whisper、网络工具），仅限这台 Mac；捕获模式的密码任何 Agent 都不能代输，需在你自己的终端执行。
MAINTENANCE · 维护
唯一的保养点
无头解析依赖一枚腾讯元宝 Cookie（存于本机配置，权限 600）。
若日后解析突然失败，大概率是 Cookie 过期：
① 浏览器打开 yuanbao.tencent.com 并登录
② 对 Kimi 说「帮我更新元宝 Cookie」即可自动完成
其余部件——下载器后端、Whisper 模型、Skill 脚本——均为一次性配置，长期免维护。