视频号作品数据统计

一键拉取微信视频号助手的经营数据并生成 CSV 统计表，比平台后台手动导出多两个独有能力：①批量下载全部作品封面 ②发布日期精确到时分秒。输出月度/周度数据统计（各来源播放量、朋友量、点赞量、评论量、分享量、关注者量、关注者总数）与单篇作品明细（标题、封面、发布日期、完播率、平均播放时长等）。当用户要视频号数据统计、月度/周度数据、单篇数据、来源分布、作品封面下载、发布日期查询时使用。触发词：视频号数据、视频号统计、月度数据、周度数据、单篇数据、来源分布、视频号封面。

视频号数据统计（channels-video-data）

通过 Playwright 登录视频号助手，拉取指定周期的经营数据，产出两份 CSV 与单篇封面到工作区根 dist/。

行为约束（必须遵守）

只收集数据：按下方流程跑脚本、产出 CSV 与封面即完成。不做数据解读/分析/总结、不给运营建议、不画图表、不写报告、不对比历史数据、不产生"下一步建议"。
周期询问：需确认周期时只提供「上一个月」「上一周」两个选项，禁止出现其他选项；用户自述其他周期（如"6月"）时按自定义范围直跑。

前置条件

Node.js ≥ 18 + npm
Playwright：无 node_modules 时 npm init -y && npm install playwright（中文/非英文目录 npm init -y 报 Invalid name 时改手写 package.json 再装，国内必须加 --registry=https://registry.npmmirror.com）；浏览器未装时 npx playwright install chromium（注意：不带镜像时国内会长时间卡住甚至静默失败——退出码 0、无输出、但浏览器目录为空，属假成功，须重装）。国内必须走镜像，否则官方境外 CDN 极慢：PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright npx playwright install chromium
登录态：首次运行自动开浏览器，本机微信客户端在线则自动免扫码（最长等待 90s）；登录态持久化在运行目录 .chrome_profile/，后续秒登
浏览器一律用 playwright 自带 chromium，禁用 channel: 'chrome'/'msedge'

执行流程

复制 scripts/ 整个目录到工作区，保持子目录结构（fetch.js 依赖 lib/ 子模块，勿平铺）
按「前置条件」装依赖
运行 node scripts/fetch.js：
- --range=last-week（上一周）/ --range=last-month（上一个月）/ --range="6月"（自定义范围）
- 可选 --clean：先清空 dist/ 旧产物再拉（仅限工作区根 dist/，不影响登录态）
产物生成在工作区根 dist/，命名 视频号_{周期标签}_{月度|周度}{产物}.csv（周期标签如 2026年08月/2026年34周，自定义范围无 _周期类型 段）

产物

视频号_2026年08月_月度汇总数据统计.csv — 周期聚合（各来源播放/互动/关注者量及总数）
视频号_2026年08月_月度作品数据统计.csv — 单篇明细（发布日期精确到时分秒）
视频号_2026年08月_月度作品封面/ — 每作品 1 张封面 jpg（按发布日期命名，与 CSV「封面」列一致）