@sovovs/bycli 2.1.30 → 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/juejin/search.js

@@ -26,20 +26,26 @@ const PAGE_SIZE = 20;
 const MAX_LIMIT = 200;
 const MAX_PAGES = 30;
 
-// 掘金对**非 0 的时间窗**（search_type=1/2/3）会间歇性返回空首页：同一 query
-// 连打 6 次，2-5 次拿到 `data: []` 而 err_no 仍是 0/success，只有 cursor 里的
-// 实例标识不同——像是部分后端分片对时间窗查询答不出来。实测 period=week 命中
-// 率只有 1/6 ~ 2/6，但 4 次以内总能拿到数据。
+// 掘金对**非 0 的时间窗**（search_type=1/2/3）会间歇性返回空首页：`data: []`
+// 但 err_no 仍是 0 / err_msg "success"，整个响应体除了 cursor 里的实例标识
+// 之外和有数据时完全一致，只有 has_more 跟着变 false——像是部分后端分片对时间
+// 窗查询答不出来。
 //
-// 真实无结果（如 query="鿃鿄鿅鿆"）连打 8 次稳定是 0，所以重试只会救回抖动，
-// 不会把空态变成假数据。只重试**首页且一行都没拿到**的情形：翻页途中的空页
-// 本来就是正常的终止信号。
-const EMPTY_RETRY_ATTEMPTS = 4;
-const EMPTY_RETRY_DELAY_MS = 400;
-
-function delay(ms) {
-    return new Promise((resolve) => { setTimeout(resolve, ms); });
-}
+// 单次请求的空概率实测 **76%**（query=rust/period=day，25 次里 19 次空），
+// 且与请求间隔无关（0ms 9/12、400ms 10/12、1500ms 11/12——加延迟只会更差），
+// 所以各次尝试相互独立、退避没有意义。改过 8 种参数组合（去 cursor / 去 limit /
+// 去 spider / 补 version / 换 sort_type / 换 id_type / 最小参数集）空率都在
+// 6-9/10，没有能让它确定化的参数。
+//
+// 首次成功所需次数实测分布（12 轮）：中位数 3、p90 5、最大 7。取 12 次把
+// 独立失败概率压到 0.76^12 ≈ 3%（4 次时是 33%，实测正好对应 4/6 的命中率）。
+//
+// 真实无结果（query="鿃鿄鿅鿆" / "zzzqqqxxx..."）连打 12-14 次稳定是 0，所以
+// 重试只会救回抖动，不会把空态变成假数据。注意掘金对**无匹配**的查询会退化成
+// 返回无关的推荐文章，但那属于「有数据」分支，和这里的空首页是两回事。
+//
+// 只重试**首页且一行都没拿到**的情形：翻页途中的空页本来就是正常的终止信号。
+const EMPTY_RETRY_ATTEMPTS = 12;
 
 const TYPES = {
     all: 0,
@@ -327,9 +333,9 @@ cli({
             pages += 1;
 
             // 首页空 → 可能是上面说的分片抖动，有界重试；真实空态重试后仍是空。
+            // 不加退避：实测各次尝试独立，延迟只会拖慢且略微更差。
             if (rows.length === 0 && payload.data.length === 0) {
                 for (let attempt = 1; attempt < EMPTY_RETRY_ATTEMPTS; attempt += 1) {
-                    await delay(EMPTY_RETRY_DELAY_MS);
                     payload = await fetchPage(url);
                     if (payload.data.length > 0) break;
                 }

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.30",
+  "version": "2.1.32",
   "publishConfig": {
     "access": "public"
   },