@sovovs/bycli 2.1.65 → 2.1.66

package/cli-manifest.json

@@ -30292,7 +30292,7 @@
   {
     "site": "weixin-channels",
     "name": "post-detail",
-    "description": "读取单条视频号作品的概览、趋势、来源和留存，默认最近 7 天；建议使用 --format json",
+    "description": "读取单条视频号作品的概览、趋势、来源占比、逐日来源明细和留存，默认最近 7 天；建议使用 --format json",
     "access": "read",
     "domain": "channels.weixin.qq.com",
     "strategy": "cookie",
@@ -30334,6 +30334,7 @@
       "overview",
       "trend",
       "sources",
+      "data_details",
       "retention"
     ],
     "type": "js",
@@ -30401,7 +30402,7 @@
   {
     "site": "weixin-channels",
     "name": "sources",
-    "description": "按视频号后台返回的来源统计账号指标，默认最近 7 天，截至昨日",
+    "description": "按视频号后台来源汇总账号指标及播放占比，默认最近 7 天，截至昨日",
     "access": "read",
     "domain": "channels.weixin.qq.com",
     "strategy": "cookie",
@@ -30432,6 +30433,7 @@
     "columns": [
       "source",
       "views",
+      "views_pct",
       "recommendations",
       "likes",
       "comments",

package/clis/weixin-channels/_shared/model.js

@@ -174,6 +174,7 @@ export function normalizeSources(data, range) {
     if (!isRecord(data) || !Array.isArray(data.dataByTabtype)) {
         throw new CommandExecutionError('Weixin Channels returned malformed source metrics');
     }
+    const totalViews = normalizeOverview(data, range).views;
     return data.dataByTabtype.map((item) => {
         if (!isRecord(item) || item.tabType == null || typeof item.tabTypeName !== 'string' || !isRecord(item.data)) {
             throw new CommandExecutionError('Weixin Channels returned a source without its identity or metrics');
@@ -181,10 +182,13 @@ export function normalizeSources(data, range) {
         if (typeof item.tabType !== 'string' && !(Number.isSafeInteger(item.tabType) && item.tabType >= 0)) {
             throw new CommandExecutionError('Weixin Channels returned an invalid source identity');
         }
+        const overview = normalizeOverview({ totalData: item.data }, range);
         return {
-            ...normalizeOverview({ totalData: item.data }, range),
+            ...overview,
             source_id: item.tabType,
             source: item.tabTypeName,
+            views_pct: totalViews === null || totalViews === 0 || overview.views === null
+                ? null : roundTwo(overview.views / totalViews * 100),
         };
     });
 }
@@ -242,13 +246,20 @@ export function normalizeDetail(data, retention, id, range) {
         throw new CommandExecutionError('Weixin Channels returned an unexpected single-post detail payload');
     }
     const feed = data.feedData[0];
+    const sources = normalizeSources(feed, range);
+    const trend = normalizeTrend(feed, range);
+    const sourceTrends = feed.dataByTabtype.map((item) => normalizeTrend({ totalData: item.data }, range));
     return {
         id: postId(id),
         start_date: range.startDate,
         end_date: range.endDate,
         overview: normalizeOverview(feed, range),
-        trend: normalizeTrend(feed, range),
-        sources: normalizeSources(feed, range),
+        trend,
+        sources,
+        data_details: trend.flatMap((_, dayIndex) => sources.map((source, sourceIndex) => {
+            const { date, ...metrics } = sourceTrends[sourceIndex][dayIndex];
+            return { date, source_id: source.source_id, source: source.source, ...metrics };
+        })),
         retention: normalizeRetention(retention),
         fans_breakdown_available: !data.notExistFansData,
     };

package/clis/weixin-channels/post-detail.js

@@ -8,7 +8,7 @@ export const postDetailCommand = cli({
   name: 'post-detail',
   access: 'read',
   domain: 'channels.weixin.qq.com',
-  description: '读取单条视频号作品的概览、趋势、来源和留存，默认最近 7 天；建议使用 --format json',
+  description: '读取单条视频号作品的概览、趋势、来源占比、逐日来源明细和留存，默认最近 7 天；建议使用 --format json',
   strategy: Strategy.COOKIE,
   browser: true,
   navigateBefore: false,
@@ -18,7 +18,7 @@ export const postDetailCommand = cli({
     { name: 'start-date', type: 'str', valueRequired: true, help: '统计开始日期 YYYY-MM-DD（包含），须同时提供 --end-date' },
     { name: 'end-date', type: 'str', valueRequired: true, help: '统计结束日期 YYYY-MM-DD（包含），最晚为上海昨日' },
   ],
-  columns: ['id', 'start_date', 'end_date', 'overview', 'trend', 'sources', 'retention'],
+  columns: ['id', 'start_date', 'end_date', 'overview', 'trend', 'sources', 'data_details', 'retention'],
   func: async (page, args = {}) => {
     const id = args.id;
     if (typeof id !== 'string' || !/^\d+$/.test(id)) {

package/clis/weixin-channels/sources.js

@@ -7,7 +7,7 @@ export const sourcesCommand = cli({
   name: 'sources',
   access: 'read',
   domain: 'channels.weixin.qq.com',
-  description: '按视频号后台返回的来源统计账号指标，默认最近 7 天，截至昨日',
+  description: '按视频号后台来源汇总账号指标及播放占比，默认最近 7 天，截至昨日',
   strategy: Strategy.COOKIE,
   browser: true,
   navigateBefore: false,
@@ -16,7 +16,7 @@ export const sourcesCommand = cli({
     { name: 'start-date', type: 'str', valueRequired: true, help: '开始日期 YYYY-MM-DD（包含），须同时提供 --end-date' },
     { name: 'end-date', type: 'str', valueRequired: true, help: '结束日期 YYYY-MM-DD（包含），最晚为上海昨日' },
   ],
-  columns: ['source', 'views', 'recommendations', 'likes', 'comments', 'shares', 'follows'],
+  columns: ['source', 'views', 'views_pct', 'recommendations', 'likes', 'comments', 'shares', 'follows'],
   func: async (page, args = {}) => {
     const range = resolveDateRange(args, new Date(), 7);
     const data = await fetchTotalData(page, range);

package/package.json

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