aiconductor-cli 1.3.5 → 1.5.0

package/api_docs/wx_history_articles.md

@@ -5,16 +5,16 @@
 - **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
 
 ## 功能说明
-获取微信公众号历史文章列表，支持自动翻页与按页计费。为**计费插件**：按成功翻页次数计费（每翻一页扣费一次），费用以 `api_services` 表（`service_code=get_wx_history_article`）配置为准（源码注释提示：链接短链 0.08/次、长链 0.06/次、按名称 0.08 元/次，实际以表配置为准）。
+获取微信公众号历史文章列表，支持自动翻页与按页计费。为**计费插件**：按成功翻页次数计费（每翻一页扣费一次），费用以 `api_services` 表（`service_code=get_wx_history_article`）配置为准。底层已由 `page` 迁移至 `offset + is_end` 翻页（兼容旧版 `total_page/now_page`），可通过 `max_pages` / `max_seconds` 控制自动翻页。
 
 ## 请求参数
 
 | 参数名 | 类型 | 必填 | 默认值 | 说明 |
 |--------|------|------|--------|------|
 | url | string | 否* | - | 微信文章链接（用于定位公众号）。与 `name` 至少提供一个 |
-| name | string | 否* | - | 公众号名称或微信 ID（调用参数名 `name`） |
+| name | string | 否* | - | 公众号名称或微信 ID（调用参数名 `name`，上游映射为 `nickname`） |
 | max_pages | int | 否 | `1` | 最大翻页数量 |
-| max_seconds | int | 否 | `50` | 最长运行时长（秒），超时即停止翻页 |
+| max_seconds | int | 否 | `50` | 最长运行时长（秒），超时即停止翻页，**最大值 170**（默认50，传值>170自动截断为170，预留10s给平台180s超时） |
 
 > **说明**：`url` 与 `name` 二者至少提供一个，否则返回失败。
 > **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
@@ -34,20 +34,39 @@
 | billing.pages_billed | int | 实际成功计费（翻页）页数 |
 | billing.total_service_fee | float | 累计扣费总额 |
 | billing.transaction_ids | array | 交易流水 ID 列表（每页一条） |
-| data | object | 历史文章结果数据，含以下字段 |
-| data.code | int | 最后一页的 API 返回码（`0` 为正常） |
+| data | object | 业务数据 |
+| data.code | int | 上游返回码，`0` 为成功 |
 | data.msg | string | `success` / `error` |
-| data.data | array | 文章列表，每项为文章对象（含标题、链接、发布时间等字段，结构取决于数据源） |
-| data.total_num | int | 该公众号历史文章总数（仅第一页返回） |
-| data.total_page | int | 总页数（仅第一页返回） |
-| data.publish_count | int | 发布次数（仅第一页返回） |
-| data.masssend_count | int | 群发次数（仅第一页返回） |
-| data.now_page | int | 实际已翻页数 |
-| data.now_page_articles_num | int | 已获取文章总数 |
-| data.mp_nickname | string | 公众号昵称（使用 `name` 参数时返回） |
-| data.mp_wxid | string | 公众号 wxid（使用 `name` 参数时返回） |
-| data.mp_ghid | string | 公众号 ghid（使用 `name` 参数时返回） |
-| data.head_img | string | 公众号头像（使用 `name` 参数时返回） |
+| data.data | array | 文章列表（已自动合并多页），每项结构见下表 |
+| data.data[].position | int | 当次群发中的位置（1 开始） |
+| data.data[].url | string | 文章链接（`mp.weixin.qq.com/s?...`） |
+| data.data[].sn | string | 文章唯一 sn |
+| data.data[].post_time | int | 发布时间戳（秒） |
+| data.data[].post_time_str | string | 发布时间字符串，如 `2026-08-27 16:32:59` |
+| data.data[].cover_url | string | 封面图 URL |
+| data.data[].original | int | 是否原创：`0` 否 `1` 是 |
+| data.data[].item_show_type | int | 展示类型 |
+| data.data[].digest | string | 摘要（可能为空） |
+| data.data[].title | string | 文章标题 |
+| data.data[].appmsgid | int | appmsg ID |
+| data.data[].update_time | int | 更新时间戳（秒） |
+| data.data[].types | int | 类型标识 |
+| data.data[].pic_cdn_url_235_1 | string | 封面 CDN 2.35:1 |
+| data.data[].pic_cdn_url_16_9 | string | 封面 CDN 16:9 |
+| data.data[].pic_cdn_url_1_1 | string | 封面 CDN 1:1 |
+| data.data[].source_url | string | 原文链接（转载时有值，否则为空） |
+| data.data[].read | int | 阅读数 |
+| data.data[].zan | int | 点赞数 |
+| data.total_num | int | 历史文章总数（旧版上游返回，新版通常为 `0`，以 `data.data.length` 为准） |
+| data.total_page | int | 总页数（旧版上游返回，新版通常为 `0`） |
+| data.publish_count | int | 发布次数（旧版上游返回，新版为 `0`） |
+| data.masssend_count | int | 群发次数（旧版上游返回，新版为 `0`） |
+| data.now_page | int | 实际已翻页数（等于 `billing.pages_billed`） |
+| data.now_page_articles_num | int | 已获取文章总数（等于 `data.data.length`） |
+| data.mp_nickname | string | 公众号昵称（使用 `name` 参数时返回，兼容 `nickname`） |
+| data.mp_wxid | string | 公众号 wxid（兼容 `wxid`） |
+| data.mp_ghid | string | 公众号 ghid（兼容 `ghid`） |
+| data.head_img | string | 公众号头像 |
 
 ## 请求示例
 
@@ -63,8 +82,8 @@ curl -X POST "http://plugin.aiconductor.fun/api/wx_history_articles" \
 ```
 
 ## 注意事项
-1. 本接口**按页计费**，每成功翻一页扣费一次；已扣费的页不退还。
-2. **停止翻页条件**：余额不足、API 返回错误、无更多页、达到 `max_pages` 或超过 `max_seconds` 任一满足即停止；`billing.pages_billed` / `total_service_fee` 反映实际扣费。
+1. 本接口**按页计费**，每成功翻一页扣费一次；已扣费的页不退还。新版翻页依据上游 `offset` + `is_end`（`0` 表示还有下页），已兼容旧版 `total_page/now_page`。
+2. **停止翻页条件**：余额不足、API 返回错误（`code!=0`）、`is_end=1` 或 `offset` 为空、达到 `max_pages` 或超过 `max_seconds` 任一满足即停止；`billing.pages_billed` / `total_service_fee` 反映实际扣费。
 3. **不扣费场景**：缺少 `url` 与 `name`、API 密钥无效、账户被禁用——此时 `pages_billed=0`、`total_service_fee=0`、余额不变。
-4. `data.data[]` 为文章对象列表，字段结构由第三方数据源决定，需做容错解析。
-5. 每页请求最多重试 10 次；建议合理设置 `max_seconds` 以避免单次调用过长触发平台 180 秒超时。
+4. `data.data[]` 为跨页合并后的文章列表，单页条数由上游决定；`data.total_num/total_page/publish_count/masssend_count` 在新版上游中可能为 `0`，请以 `data.data.length` / `now_page_articles_num` 为准。
+5. 每页请求最多重试 10 次；`max_seconds` 默认 50s，最大 170s（平台兜底180s），建议按需设置以避免触发平台 504 超时。

package/bin/aiconductor-cli.js

@@ -2,13 +2,13 @@
 
 const { Command } = require("commander");
 const { publishCommand } = require("../src/commands/html_publish");
-const {
-  publishCommand: webpagePublishCommand,
-  listCommand: webpageListCommand,
-  deleteCommand: webpageDeleteCommand,
-} = require("../src/commands/md_publish");
-const { searchCommand } = require("../src/commands/web_search");
-const { briefingCommand } = require("../src/commands/content");
+const {
+  publishCommand: webpagePublishCommand,
+  listCommand: webpageListCommand,
+  deleteCommand: webpageDeleteCommand,
+} = require("../src/commands/md_publish");
+const { searchCommand } = require("../src/commands/web_search");
+const { briefingCommand } = require("../src/commands/content");
 const {
   videoInfoCommand,
   videoCommentsCommand,
@@ -18,13 +18,17 @@ const {
   videoSearchCommand,
   linkToTextCommand,
 } = require("../src/commands/douyin");
-const { notePublishCommand } = require("../src/commands/xhs");
-
-const program = new Command();
-
-function collect(value, previous) {
-  return previous ? previous.concat([value]) : [value];
-}
+const { hotListCommand: xhsHotListCommand, notePublishCommand } = require("../src/commands/xhs");
+const {
+  articleDataCommand: wxArticleDataCommand,
+  historyCommand: wxHistoryCommand,
+} = require("../src/commands/wx");
+
+const program = new Command();
+
+function collect(value, previous) {
+  return previous ? previous.concat([value]) : [value];
+}
 
 program
   .name("aiconductor-cli")
@@ -52,8 +56,8 @@ const webpageCmd = program
   .command("webpage")
   .description("网页发布（支持 Markdown 和 HTML）");
 
-webpageCmd
-  .command("publish")
+webpageCmd
+  .command("publish")
   .description("将 Markdown 或 HTML 发布为在线网页（自动识别类型）")
   .argument("<input>", "Markdown/HTML 文本字符串或文件路径")
   .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
@@ -61,30 +65,30 @@ webpageCmd
   .option("--type <type>", "强制指定类型：md 或 html（默认自动识别）")
   .option("--copy-button", "添加代码复制按钮（仅 Markdown 类型生效）")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((input, options) => {
-    webpagePublishCommand(input, options);
-  });
-
-webpageCmd
-  .command("list")
-  .description("查询当前用户已发布的网页")
-  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
-  .option("--page <page>", "页码，最小为 1", "1")
-  .option("--page-size <size>", "每页条数，范围为 1 到 100", "20")
-  .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((options) => {
-    webpageListCommand(options);
-  });
-
-webpageCmd
-  .command("delete")
-  .description("删除当前用户指定的已发布网页")
-  .argument("<webpage_id>", "网页记录 ID，可通过 webpage list 获取")
-  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
-  .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((webpageId, options) => {
-    webpageDeleteCommand(webpageId, options);
-  });
+  .action((input, options) => {
+    webpagePublishCommand(input, options);
+  });
+
+webpageCmd
+  .command("list")
+  .description("查询当前用户已发布的网页")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("--page <page>", "页码，最小为 1", "1")
+  .option("--page-size <size>", "每页条数，范围为 1 到 100", "20")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((options) => {
+    webpageListCommand(options);
+  });
+
+webpageCmd
+  .command("delete")
+  .description("删除当前用户指定的已发布网页")
+  .argument("<webpage_id>", "网页记录 ID，可通过 webpage list 获取")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((webpageId, options) => {
+    webpageDeleteCommand(webpageId, options);
+  });
 
 // search 子命令组
 const searchCmd = program
@@ -96,54 +100,54 @@ searchCmd
   .description("网页搜索")
   .argument("<query>", "搜索关键词（1~100字符）")
   .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
-  .option("-n, --count <n>", "返回条数（最多50）")
-  .option("--time-range <range>", "时间范围：OneDay/OneWeek/OneMonth/OneYear 或 YYYY-MM-DD..YYYY-MM-DD")
-  .option("--need-content", "仅返回包含正文的结果")
-  .option("--need-url", "仅返回带原文链接的结果")
-  .option("--sites <domains>", "限定搜索站点，完整域名以 | 分隔，最多20个")
-  .option("--block-hosts <domains>", "屏蔽站点，完整域名以 | 分隔，最多5个")
-  .option("--auth-info-level <level>", "权威度过滤：0=不限制，1=仅非常权威内容")
-  .option("--auth-level <level>", "兼容别名，等同 --auth-info-level")
-  .option("--content-format <format>", "正文格式：text 或 markdown", "text")
-  .option("--industry <type>", "行业搜索：finance、game 或 gov")
-  .option("--query-rewrite", "开启 Query 改写")
+  .option("-n, --count <n>", "返回条数（最多50）")
+  .option("--time-range <range>", "时间范围：OneDay/OneWeek/OneMonth/OneYear 或 YYYY-MM-DD..YYYY-MM-DD")
+  .option("--need-content", "仅返回包含正文的结果")
+  .option("--need-url", "仅返回带原文链接的结果")
+  .option("--sites <domains>", "限定搜索站点，完整域名以 | 分隔，最多20个")
+  .option("--block-hosts <domains>", "屏蔽站点，完整域名以 | 分隔，最多5个")
+  .option("--auth-info-level <level>", "权威度过滤：0=不限制，1=仅非常权威内容")
+  .option("--auth-level <level>", "兼容别名，等同 --auth-info-level")
+  .option("--content-format <format>", "正文格式：text 或 markdown", "text")
+  .option("--industry <type>", "行业搜索：finance、game 或 gov")
+  .option("--query-rewrite", "开启 Query 改写")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
   .action((query, options) => {
     searchCommand(query, "web", options);
   });
 
-searchCmd
-  .command("image")
+searchCmd
+  .command("image")
   .description("图片搜索")
   .argument("<query>", "搜索关键词（1~100字符）")
-  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
-  .option("-n, --count <n>", "返回条数（最多5）")
-  .option("--image-width-min <px>", "图片最小宽度")
-  .option("--image-width-max <px>", "图片最大宽度")
-  .option("--image-height-min <px>", "图片最小高度")
-  .option("--image-height-max <px>", "图片最大高度")
-  .option("--image-shapes <shapes>", "图片形状，以 | 分隔：横长方形、竖长方形、方形")
-  .option("--query-rewrite", "开启 Query 改写")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("-n, --count <n>", "返回条数（最多5）")
+  .option("--image-width-min <px>", "图片最小宽度")
+  .option("--image-width-max <px>", "图片最大宽度")
+  .option("--image-height-min <px>", "图片最小高度")
+  .option("--image-height-max <px>", "图片最大高度")
+  .option("--image-shapes <shapes>", "图片形状，以 | 分隔：横长方形、竖长方形、方形")
+  .option("--query-rewrite", "开启 Query 改写")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((query, options) => {
+    searchCommand(query, "image", options);
+  });
+
+// content 子命令组
+const contentCmd = program
+  .command("content")
+  .description("内容选题与素材工具");
+
+contentCmd
+  .command("briefing")
+  .description("聚合多平台热点与小红书热榜，生成选题原料")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("--sources <ids>", "来源 ID，逗号分隔；默认 zhihu,weibo,douyin,aihot")
+  .option("--limit <n>", "每个来源返回条数，范围 1 到 30", "30")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((query, options) => {
-    searchCommand(query, "image", options);
-  });
-
-// content 子命令组
-const contentCmd = program
-  .command("content")
-  .description("内容选题与素材工具");
-
-contentCmd
-  .command("briefing")
-  .description("聚合多平台热点，生成选题原料")
-  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
-  .option("--sources <ids>", "来源 ID，逗号分隔；默认 zhihu,weibo,douyin,aihot")
-  .option("--limit <n>", "每个来源返回条数，范围 1 到 30", "30")
-  .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((options) => {
-    briefingCommand(options);
-  });
+  .action((options) => {
+    briefingCommand(options);
+  });
 
 // 未知命令处理
 
@@ -226,26 +230,57 @@ const xhsCmd = program
   .command("xhs")
   .description("小红书数据工具箱");
 
+xhsCmd
+  .command("hot-list")
+  .description("获取小红书实时热榜")
+  .option("-k, --api-key <key>", "AIConductor API Key")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((options) => { xhsHotListCommand(options); });
+
 xhsCmd
   .command("note-publish")
-  .description("生成小红书扫码发布页与二维码（0.05元/次）")
+  .description("生成小红书扫码发布页与二维码（0.05元/次）")
   .argument("<type>", "笔记类型：normal（图文）或 video（视频）")
   .option("-k, --api-key <key>", "AIConductor API Key")
-  .option("-t, --title <title>", "笔记标题（最多20字符）")
-  .option("--content <text>", "笔记正文（最多1000字符）")
-  .option("--images <urls>", "图片公网URL列表，逗号分隔（normal类型，最多18张）")
-  .option("--image-file <path>", "本地图片路径，可重复使用（normal类型，最多18张）", collect)
-  .option("--image-base64 <data>", "图片Base64/data URL/@文本文件，可重复使用", collect)
-  .option("--video <url>", "视频公网URL（与--video-file、--video-base64三选一）")
-  .option("--video-file <path>", "本地视频路径（与--video、--video-base64三选一）")
-  .option("--video-base64 <data>", "视频Base64/data URL/@文本文件（与其他视频来源三选一）")
-  .option("--cover <url>", "视频封面图公网URL（与其他封面来源三选一）")
-  .option("--cover-file <path>", "本地视频封面路径（仅video类型有效）")
-  .option("--cover-base64 <data>", "视频封面Base64/data URL/@文本文件（仅video类型）")
-  .option("--upload-valid-days <days>", "本地/Base64素材临时链接有效期：1或7天", "7")
-  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .option("-t, --title <title>", "笔记标题（最多20字符）")
+  .option("--content <text>", "笔记正文（最多1000字符）")
+  .option("--images <urls>", "图片公网URL列表，逗号分隔（normal类型，最多18张）")
+  .option("--image-file <path>", "本地图片路径，可重复使用（normal类型，最多18张）", collect)
+  .option("--image-base64 <data>", "图片Base64/data URL/@文本文件，可重复使用", collect)
+  .option("--video <url>", "视频公网URL（与--video-file、--video-base64三选一）")
+  .option("--video-file <path>", "本地视频路径（与--video、--video-base64三选一）")
+  .option("--video-base64 <data>", "视频Base64/data URL/@文本文件（与其他视频来源三选一）")
+  .option("--cover <url>", "视频封面图公网URL（与其他封面来源三选一）")
+  .option("--cover-file <path>", "本地视频封面路径（仅video类型有效）")
+  .option("--cover-base64 <data>", "视频封面Base64/data URL/@文本文件（仅video类型）")
+  .option("--upload-valid-days <days>", "本地/Base64素材临时链接有效期：1或7天", "7")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
   .action((type, options) => { notePublishCommand(type, options); });
 
+// wx 子命令组（公众号数据）
+const wxCmd = program
+  .command("wx")
+  .description("微信公众号数据工具箱");
+
+wxCmd
+  .command("article-data")
+  .description("获取公众号文章互动数据（按次计费）")
+  .argument("<url>", "微信文章链接")
+  .option("-k, --api-key <key>", "AIConductor API Key")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((url, options) => { wxArticleDataCommand(url, options); });
+
+wxCmd
+  .command("history")
+  .description("获取公众号历史文章列表（按成功翻页次数计费）")
+  .argument("[url]", "微信文章链接（用于定位公众号）")
+  .option("-k, --api-key <key>", "AIConductor API Key")
+  .option("--name <name>", "公众号名称或微信 ID（与 url 至少提供一个）")
+  .option("--max-pages <n>", "最大翻页数量", "1")
+  .option("--max-seconds <n>", "最长运行时间（秒），最大 170", "50")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((url, options) => { wxHistoryCommand(url, options); });
+
 // 未知命令处理
 program.on("command:*", () => {
   console.error(`未知命令: ${program.args.join(" ")}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiconductor-cli",
-  "version": "1.3.5",
+  "version": "1.5.0",
   "description": "AIConductor CLI 工具箱",
   "keywords": [
     "aiconductor",