@wecode-ai/weibo-openclaw-plugin 2.2.5 → 2.2.7

package/node_modules/ws/lib/sender.js

@@ -4,6 +4,9 @@
 
 const { Duplex } = require('stream');
 const { randomFillSync } = require('crypto');
+const {
+  types: { isUint8Array }
+} = require('util');
 
 const PerMessageDeflate = require('./permessage-deflate');
 const { EMPTY_BUFFER, kWebSocket, NOOP } = require('./constants');
@@ -200,8 +203,10 @@ class Sender {
 
       if (typeof data === 'string') {
         buf.write(data, 2);
-      } else {
+      } else if (isUint8Array(data)) {
         buf.set(data, 2);
+      } else {
+        throw new TypeError('Second argument must be a string or a Uint8Array');
       }
     }
 

package/node_modules/ws/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ws",
-  "version": "8.20.0",
+  "version": "8.20.1",
   "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
   "keywords": [
     "HyBi",

package/openclaw.plugin.json

@@ -9,6 +9,14 @@
         "additionalProperties": false,
         "properties": {}
     },
+    "contracts": {
+        "tools": [
+            "weibo_token",
+            "weibo_status",
+            "weibo_search",
+            "weibo_hot_search"
+        ]
+    },
     "channelConfigs": {
         "weibo": {
             "label": "Weibo",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wecode-ai/weibo-openclaw-plugin",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "type": "module",
   "description": "OpenClaw Weibo DM channel plugin",
   "license": "MIT",

package/skills/weibo-creator/SKILL.md

@@ -2,11 +2,13 @@
 name: weibo-creator
 description: |
   微博创作者数据工具。获取创作者中心的综合数据摘要，包含近30天阅读/发博/互动趋势、
-  近7天粉丝与铁粉数据、铁粉画像（分布/性别/年龄/地区/兴趣/来源）以及近期热门博文详情。
+  近7天粉丝与铁粉数据、铁粉画像（分布/性别/年龄/地区/兴趣/来源）、近期热门博文详情
+  以及最近4周 V影响力榜周榜得分与排名数据。
   当用户需要了解自己的创作数据、粉丝增长情况、内容表现或铁粉画像时激活；
-  或当用户询问如何升级橙V/金V、距离升级还差多少、需要多长时间能达标时激活。
+  或当用户询问如何升级橙V/金V、距离升级还差多少、需要多长时间能达标时激活；
+  或当用户询问自己的 V榜排名、得分、与同领域博主对比、哪些方面需要提升时激活。
 metadata:
-  version: "1.0.1"
+  version: "1.0.2"
 ---
 
 # 微博创作者数据工具
@@ -134,6 +136,52 @@ node scripts/weibo-creator.js summary --token=<token>
 
 ---
 
+### 7. V榜周榜数据
+
+#### `data.rankDetails` — KOL 周度排名评分列表（数组，最近4次周榜，最多4条）
+
+每条记录对应一个自然周的榜单数据：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `dt` | string | 数据日期（格式：yyyyMMdd，如 "20260427"） |
+| `fieldId` | number | 领域 ID |
+| `fieldName` | string | 领域名称（如 "科技"） |
+| `period` | string | 周期描述（如 "2026年第18周"） |
+| `scorePeriod` | string | 评分周期（如 "04/27-05/03"） |
+| `rank` | string | 本周排名 |
+| `totalScore` | string | 综合总分 |
+| `details` | array | 各维度评分明细（共9项，见下表） |
+
+#### `data.rankDetails[].details` — 各维度评分明细（9项）
+
+每项结构如下：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `name` | string | 指标名称 |
+| `score` | string | 用户自己的得分 |
+| `fullScore` | string | 该项满分（无满分时为空字符串） |
+| `avgScore` | string | 同领域同层级博主均值（无均值时为空字符串） |
+
+9项指标的层级结构如下：
+
+```
+传播影响力得分
+  ├── 私域流量得分
+  ├── 公域流量得分
+  └── 内容效率得分
+内容吸引力得分
+  ├── 被互动得分
+  └── 粉丝吸引力得分
+主动活跃度得分
+  └── 主动活跃得分
+```
+
+> `details` 数组中共9项，按上述层级顺序排列，包含3个父级维度和6个子维度。
+
+---
+
 ## 使用示例
 
 ```bash
@@ -199,6 +247,28 @@ node scripts/weibo-creator.js help
         "likeTotal": 2100,
         "interactTotal": 3000
       }
+    ],
+    "rankDetails": [
+      {
+        "dt": "20260427",
+        "fieldId": 10,
+        "fieldName": "科技",
+        "period": "2026年第18周",
+        "scorePeriod": "04/27-05/03",
+        "rank": "128",
+        "totalScore": "76.5",
+        "details": [
+          { "name": "传播影响力得分", "score": "32.1", "fullScore": "40", "avgScore": "28.6" },
+          { "name": "私域流量得分",   "score": "12.4", "fullScore": "",   "avgScore": "11.2" },
+          { "name": "公域流量得分",   "score": "10.8", "fullScore": "",   "avgScore": "9.5"  },
+          { "name": "内容效率得分",   "score": "8.9",  "fullScore": "",   "avgScore": "7.9"  },
+          { "name": "内容吸引力得分", "score": "28.4", "fullScore": "35", "avgScore": "24.1" },
+          { "name": "被互动得分",     "score": "16.2", "fullScore": "",   "avgScore": "13.8" },
+          { "name": "粉丝吸引力得分", "score": "12.2", "fullScore": "",   "avgScore": "10.3" },
+          { "name": "主动活跃度得分", "score": "16.0", "fullScore": "25", "avgScore": "14.5" },
+          { "name": "主动活跃得分",   "score": "16.0", "fullScore": "",   "avgScore": "14.5" }
+        ]
+      }
     ]
   }
 }
@@ -213,66 +283,98 @@ node scripts/weibo-creator.js help
 3. `fansTotal` 字段仅昨日（T-1）有值，其余日期可能为 `null`
 4. 铁粉画像数据为截止昨日的当前值，非趋势数据
 5. `topBlogs` 最多返回5条近期热门博文
+6. `rankDetails` 返回最近4次周榜数据；若用户尚未上榜或数据不足，可能少于4条
+7. `details` 中 `fullScore` 和 `avgScore` 为空字符串时表示该项无满分/均值数据
 
 ---
 
-## 金橙V 升级分析
+## 数据分析能力
+
+本技能在基础数据之上，提供以下加工数据和分析能力。当用户询问创作数据分析、金橙V升级、V榜排名等问题时，综合运用以下能力输出分析报告。
+
+---
+
+### 一、加工数据
+
+以下数据由基础数据计算得出，可在分析报告中直接使用：
+
+#### 互动效率数据
+
+| 加工数据 | 计算方式 | 数据来源 |
+|----------|----------|----------|
+| 日互动总数 | 当日转发数 + 评论数 + 点赞数 | `interactTrend30Days` 各日 |
+| 日千阅互动数 | 日互动总数 ÷ 日总排水阅读数 × 1000 | `interactTrend30Days` + `readTrend30Days` |
+| 单条博文互动总数 | 转发总数 + 评论总数 + 赞总数 | `topBlogs[].repostTotal` + `commentTotal` + `likeTotal` |
+| 单条博文千阅互动数 | 单条博文互动总数 ÷ 单条博文阅读总数 × 1000 | `topBlogs[]` |
+
+> **千阅互动数**（每千次阅读带来的互动数）是衡量内容质量的核心指标，数值越高说明内容越能引发读者互动。
+
+#### 博文排行数据
+
+从 `topBlogs` 中按不同维度排序，找出 TOP5 博文：
+
+| 排行类型 | 排序依据 | 说明 |
+|----------|----------|------|
+| 高阅读量博文 | `readTotal` 降序 | 近期阅读量最高的博文 |
+| 高互动量博文 | 单条博文互动总数降序 | 近期互动量最高的博文 |
+| 高千阅互动博文 | 单条博文千阅互动数降序 | 近期内容质量最高的博文 |
+
+#### 增长速率数据
+
+| 加工数据 | 计算方式 | 数据来源 |
+|----------|----------|----------|
+| 近30天条均阅读量 | 近30天总阅读量 ÷ 近30天发博总数 | `readTrend30Days` + `postTrend30Days` |
+| 日均新增铁粉数 | 近7天 `newBigFanCount` 求和 ÷ 7 | `fanTrend7Days` |
+| 日均新增粉丝数 | 近7天 `newFansCount` 求和 ÷ 7 | `fanTrend7Days` |
+| 近30天阅读量趋势 | 对比前15天与后15天均值，判断上升/下降/平稳 | `readTrend30Days` |
+
+---
+
+### 二、金橙V 升级分析
 
 > 升级标准详见：[金橙V 升级标准](references/creator-v-upgrade.md)
 
-获取到创作者数据摘要后，若用户询问金V/橙V升级相关问题，请按以下步骤进行分析：
+若用户询问金V/橙V升级相关问题，请按以下步骤进行分析：
+
+#### 升级标准速查
 
-### 第一步：判断当前状态
+| 等级 | 条件 |
+|------|------|
+| **橙V** | 已认证黄V ＋ 铁粉数 ≥ 100 ＋ 近30天排水阅读量 ≥ 30 万 |
+| **金V** | 已认证黄V ＋ 粉丝量 ≥ 1 万 ＋ 铁粉数 ≥ 1000 ＋ 近30天排水阅读量 ≥ 1000 万 |
 
-根据升级标准，结合数据判断用户所处阶段：
+#### 分析步骤
+
+**第一步：判断当前状态**
 
 - **已是黄V，尚未达到橙V**：铁粉数 < 100 或近30天排水阅读量 < 30 万
 - **已是橙V，尚未达到金V**：粉丝量 < 1 万 或 铁粉数 < 1000 或 近30天排水阅读量 < 1000 万
 
-### 第二步：计算各项达标差距
-
-对未达标的指标，计算还差多少：
+**第二步：计算各项达标差距**
 
 | 指标 | 数据来源 | 计算方式 |
 |------|----------|----------|
-| 近30天排水阅读量 | `readTrend30Days` 中所有 `totalReadCount` 求和 | 目标值 − 当前值 |
-| 铁粉数 | `fanTrend7Days` 中最新一条的 `bigFanTotal` | 目标值 − 当前值 |
-| 粉丝量 | `fanTrend7Days` 中最新一条的 `fansTotal` | 目标值 − 当前值 |
+| 近30天排水阅读量 | `readTrend30Days` 所有 `totalReadCount` 求和 | 目标值 − 当前值 |
+| 铁粉数 | `fanTrend7Days` 最新一条的 `bigFanTotal` | 目标值 − 当前值 |
+| 粉丝量 | `fanTrend7Days` 最新一条的 `fansTotal` | 目标值 − 当前值 |
 
-### 第三步：计算增长速率
-
-| 指标 | 计算方式 |
-|------|----------|
-| 日均新增铁粉数 | `fanTrend7Days` 中所有 `newBigFanCount` 求和 ÷ 7 |
-| 日均新增粉丝数 | `fanTrend7Days` 中所有 `newFansCount` 求和 ÷ 7 |
-| 近30天条均阅读量 | `readTrend30Days` 总阅读量 ÷ `postTrend30Days` 中发博总数 |
-| 近30天排水阅读量变化趋势 | 对比 `readTrend30Days` 前15天与后15天的均值，判断上升/下降/平稳 |
-| 近7天铁粉数变化趋势 | 对比 `fanTrend7Days` 首尾两端的 `bigFanTotal`，判断增长速度 |
-
-### 第四步：预估达标时间
-
-对每个未达标指标，按当前增长速率估算所需天数：
+**第三步：预估达标时间**
 
 ```
 距离达标天数 = 差距值 ÷ 日均增长量
 ```
 
-> 若日均增长量为 0 或负数，则说明当前趋势下无法自然达标，需要提升内容质量或发博频率。
+- 阅读量：差距 ÷ (条均阅读量 × 日均发博数)
+- 铁粉数：差距 ÷ 日均新增铁粉数
+- 粉丝量：差距 ÷ 日均新增粉丝数
 
-### 第五步：输出分析报告
+> 若日均增长量为 0 或负数，则说明当前趋势下无法自然达标，需要提升内容质量或发博频率。
 
-分析报告应包含以下内容：
+**第四步：输出分析报告**
 
-1. **当前状态**：已达到哪个等级，距离下一级还差哪些指标
-2. **各项达标情况**：逐项列出已达标 ✅ / 未达标 ❌ 及差距数值
-3. **增长速率**：日均新增粉丝、日均新增铁粉、条均阅读量
-4. **预估达标时间**：按当前速率，各项指标预计还需多少天
-5. **提升建议**：
-   - 若阅读量不足：建议提高发博频率或优化内容质量（参考条均阅读量）
-   - 若铁粉数不足：建议增加与粉丝的互动，提升粉丝活跃度
-   - 若粉丝量不足：建议扩大内容传播，提升公域流量占比
+报告包含：当前状态、各项达标情况（✅/❌ + 差距数值）、增长速率、预估达标时间、提升建议。
 
-### 示例分析输出
+#### 示例输出
 
 ```
 📊 金橙V 升级分析报告
@@ -294,3 +396,79 @@ node scripts/weibo-creator.js help
   - 保持每天 2 条以上的发博频率，重点提升单条阅读量
   - 多发互动性强的内容，加速铁粉积累
 ```
+
+---
+
+### 三、V榜数据分析
+
+若用户询问 V榜排名、得分、与同领域博主对比等问题，请按以下步骤进行分析：
+
+#### 分析步骤
+
+**第一步：整理最近4周榜单数据**
+
+从 `rankDetails` 中按 `dt` 升序排列（最旧 → 最新），对每周提取综合总分、排名、9项明细得分及均值。
+
+**第二步：分析总分与排名趋势**
+
+| 判断维度 | 方法 |
+|----------|------|
+| 总分趋势 | 对比首周与末周总分，判断上升/下降/平稳 |
+| 排名趋势 | 对比首周与末周排名（数字越小越靠前），判断进步/退步/稳定 |
+| 波动情况 | 观察中间两周是否有明显波动 |
+
+**第三步：分析9项明细数据**
+
+将用户得分（`score`）与同领域同层级均值（`avgScore`）对比：
+
+> 若 `avgScore` 为空字符串、缺失或无法解析为有效数值，则**跳过横向对比**，仅分析该项近4周的变化趋势，并在报告中注明"同领域均值缺失，无法进行横向对比"。
+
+差距计算公式（`avgScore` 为有效正数时）：
+
+```
+差距 = |用户得分 - avgScore| ÷ avgScore
+```
+
+- **领先**：用户得分 > `avgScore`，且差距 ≥ 10%
+- **持平**：差距 < 10%
+- **落后**：用户得分 < `avgScore`，且差距 ≥ 10%
+
+同时对比最近4周该项得分变化趋势：
+- **进步**：末周得分 > 首周得分
+- **退步**：末周得分 < 首周得分
+- **稳定**：末周得分 ≈ 首周得分（差距 < 5%）
+
+**第四步：输出分析报告**
+
+报告包含：总分与排名趋势、领先项（优势）、落后项（需加强）、进步项、退步项、提升建议。
+
+#### 示例输出
+
+```
+📊 V榜数据分析报告（科技领域）
+
+最近4周总分与排名：
+  第15周（04/06-04/12）：总分 71.2，排名 #156
+  第16周（04/13-04/19）：总分 73.8，排名 #142
+  第17周（04/20-04/26）：总分 75.1，排名 #135
+  第18周（04/27-05/03）：总分 76.5，排名 #128
+  → 总分持续上升（+5.3分），排名稳步提升（进步28位）✅
+
+各维度对比（第18周 vs 同领域均值）：
+  传播影响力：32.1 vs 均值 28.6 → 领先 12.2% ✅（近4周持续进步）
+  内容吸引力：28.4 vs 均值 24.1 → 领先 17.8% ✅（近4周稳定）
+  主动活跃度：16.0 vs 均值 14.5 → 领先 10.3% ✅
+
+  子维度详情：
+  ├ 私域流量：12.4 vs 均值 11.2 → 领先 10.7% ✅
+  ├ 公域流量：10.8 vs 均值 9.5  → 领先 13.7% ✅（近4周进步最大）
+  ├ 内容效率：8.9  vs 均值 7.9  → 领先 12.7% ✅
+  ├ 被互动：  16.2 vs 均值 13.8 → 领先 17.4% ✅
+  ├ 粉丝吸引：12.2 vs 均值 10.3 → 领先 18.4% ✅
+  └ 主动活跃：16.0 vs 均值 14.5 → 领先 10.3% ✅
+
+总结：
+  - 各维度全面领先同领域均值，整体表现优秀
+  - 公域流量得分近4周进步最为显著，建议继续保持
+  - 主动活跃度满分25分，当前得分16.0，仍有较大提升空间，建议增加发博频率
+```