@sovovs/bycli 2.1.31 → 2.1.32

package/cli-manifest.json

@@ -28485,6 +28485,42 @@
     "sourceFile": "weixin/drafts.js",
     "navigateBefore": false
   },
+  {
+    "site": "weixin",
+    "name": "home-overview",
+    "aliases": [
+      "overview",
+      "dashboard",
+      "fans"
+    ],
+    "description": "读取公众号首页概览：原创内容、总用户数（粉丝数）、昨日阅读/分享/新增关注人数及阅读增长百分比；账号级昨日汇总，单篇文章数据请用 published",
+    "access": "read",
+    "domain": "mp.weixin.qq.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "settle",
+        "type": "int",
+        "default": 3,
+        "required": false,
+        "help": "打开首页后等待渲染的秒数"
+      }
+    ],
+    "columns": [
+      "original_count",
+      "total_users",
+      "yesterday_reads",
+      "yesterday_reads_change_pct",
+      "yesterday_shares",
+      "yesterday_new_followers",
+      "stat_range"
+    ],
+    "type": "js",
+    "modulePath": "weixin/home-overview.js",
+    "sourceFile": "weixin/home-overview.js",
+    "navigateBefore": false
+  },
   {
     "site": "weixin",
     "name": "published",

package/clis/weixin/_wechat/home-overview.js

@@ -0,0 +1,114 @@
+import { CommandExecutionError } from '@sovovs/bycli/errors';
+
+const DOMAIN = 'mp.weixin.qq.com';
+
+/**
+ * @typedef {{
+ *   originalCount: number | null,
+ *   totalUsers: number | null,
+ *   yesterdayReads: number | null,
+ *   yesterdayReadsChangePct: number | null,
+ *   yesterdayShares: number | null,
+ *   yesterdayNewFollowers: number | null,
+ *   statRange: string | null,
+ * }} HomeOverview
+ */
+
+/** @param {string} token */
+export function buildHomeUrl(token) {
+  const parameters = new URLSearchParams({
+    t: 'home/index',
+    lang: 'zh_CN',
+    token: String(token),
+  });
+  return `https://${DOMAIN}/cgi-bin/home?${parameters.toString()}`;
+}
+
+/**
+ * Reads the home dashboard counters from `window.wx.cgiData` with a DOM fallback.
+ * Kept as a string so it can run through `page.evaluate` unchanged.
+ */
+export const HOME_OVERVIEW_SCRIPT = `(() => {
+  const digits = value => {
+    if (value === null || value === undefined) return null;
+    const text = String(value).replace(/[\\s,]/g, '');
+    const match = /^-?\\d+(?:\\.\\d+)?$/.exec(text);
+    return match ? Number(text) : null;
+  };
+  const textOf = selector => {
+    const node = document.querySelector(selector);
+    return node ? node.textContent : null;
+  };
+  const overviewByTitle = keyword => {
+    const items = Array.from(document.querySelectorAll('.weui-desktop-data-overview'));
+    const matched = items.find(item => {
+      const title = item.querySelector('.weui-desktop-data-overview__title');
+      return title ? title.textContent.indexOf(keyword) !== -1 : false;
+    });
+    if (!matched) return { value: null, changePct: null };
+    const desc = matched.querySelector('.weui-desktop-data-overview__desc');
+    const tips = matched.querySelector('.tips_num');
+    return {
+      value: digits(desc ? desc.textContent : null),
+      changePct: digits(tips ? tips.textContent.replace('%', '') : null),
+    };
+  };
+
+  const cgiData = (window.wx && window.wx.cgiData) || {};
+  const summary = cgiData.yesterdaySummary || {};
+  const reads = overviewByTitle('昨日阅读');
+  const shares = overviewByTitle('昨日分享');
+  const followers = overviewByTitle('昨日新增关注');
+  const statRange = textOf('.weui-desktop-data_description');
+
+  return {
+    originalCount: digits(textOf('.weui-desktop-user_sum.original_cnt')),
+    totalUsers: digits(cgiData.total_friend_cnt) ?? digits(textOf('.weui-desktop-user_num .weui-desktop-user_sum')),
+    yesterdayReads: digits(summary.pv) ?? reads.value,
+    yesterdayReadsChangePct: digits(summary.pvAnalysis && summary.pvAnalysis.changeRate) ?? reads.changePct,
+    yesterdayShares: digits(summary.share) ?? shares.value,
+    yesterdayNewFollowers: digits(summary.subscribe) ?? followers.value,
+    statRange: statRange ? statRange.trim().replace(/\\s+/g, ' ') : null,
+  };
+})()`;
+
+/**
+ * @param {unknown} payload
+ * @returns {HomeOverview}
+ */
+export function normalizeHomeOverview(payload) {
+  if (!payload || typeof payload !== 'object') {
+    throw new CommandExecutionError(
+      'WeChat home overview returned an unreadable payload',
+      'Reload the Official Account home page and run the command again.',
+    );
+  }
+  const raw = /** @type {Record<string, unknown>} */ (payload);
+  const number = key => (Number.isFinite(raw[key]) ? Number(raw[key]) : null);
+  const overview = {
+    originalCount: number('originalCount'),
+    totalUsers: number('totalUsers'),
+    yesterdayReads: number('yesterdayReads'),
+    yesterdayReadsChangePct: number('yesterdayReadsChangePct'),
+    yesterdayShares: number('yesterdayShares'),
+    yesterdayNewFollowers: number('yesterdayNewFollowers'),
+    statRange: typeof raw.statRange === 'string' && raw.statRange.trim()
+      ? raw.statRange.trim().replace(/\s+/g, ' ')
+      : null,
+  };
+
+  const metrics = [
+    overview.originalCount,
+    overview.totalUsers,
+    overview.yesterdayReads,
+    overview.yesterdayShares,
+    overview.yesterdayNewFollowers,
+  ];
+  if (metrics.every(value => value === null)) {
+    throw new CommandExecutionError(
+      'WeChat home overview exposed no counters',
+      'The home dashboard layout may have changed; check that the Official Account home page renders its data panel.',
+    );
+  }
+  return overview;
+}

package/clis/weixin/home-overview.js

@@ -0,0 +1,51 @@
+import { cli, Strategy } from '@sovovs/bycli/registry';
+import { resolveBrowserCredentials } from './_wechat/auth-session.js';
+import {
+  HOME_OVERVIEW_SCRIPT,
+  buildHomeUrl,
+  normalizeHomeOverview,
+} from './_wechat/home-overview.js';
+
+const DOMAIN = 'mp.weixin.qq.com';
+
+const COLUMNS = [
+  'original_count',
+  'total_users',
+  'yesterday_reads',
+  'yesterday_reads_change_pct',
+  'yesterday_shares',
+  'yesterday_new_followers',
+  'stat_range',
+];
+
+export const homeOverviewCommand = cli({
+  site: 'weixin',
+  name: 'home-overview',
+  access: 'read',
+  domain: DOMAIN,
+  aliases: ['overview', 'dashboard', 'fans'],
+  description: '读取公众号首页概览：原创内容、总用户数（粉丝数）、昨日阅读/分享/新增关注人数及阅读增长百分比；账号级昨日汇总，单篇文章数据请用 published',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  navigateBefore: false,
+  args: [
+    { name: 'settle', type: 'int', default: 3, help: '打开首页后等待渲染的秒数' },
+  ],
+  columns: COLUMNS,
+  func: async (page, args) => {
+    const { token } = await resolveBrowserCredentials(page);
+    await page.goto(buildHomeUrl(token));
+    const settle = Number(args.settle ?? 3);
+    await page.wait(Number.isFinite(settle) && settle > 0 ? settle : 3);
+    const overview = normalizeHomeOverview(await page.evaluate(HOME_OVERVIEW_SCRIPT));
+    return [{
+      original_count: overview.originalCount,
+      total_users: overview.totalUsers,
+      yesterday_reads: overview.yesterdayReads,
+      yesterday_reads_change_pct: overview.yesterdayReadsChangePct,
+      yesterday_shares: overview.yesterdayShares,
+      yesterday_new_followers: overview.yesterdayNewFollowers,
+      stat_range: overview.statRange,
+    }];
+  },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovovs/bycli",
-  "version": "2.1.31",
+  "version": "2.1.32",
   "publishConfig": {
     "access": "public"
   },