aiconductor-cli 1.4.0 → 1.5.1

package/src/api.test.js

@@ -4,8 +4,7 @@ const http = require("node:http");
 const https = require("node:https");
 const test = require("node:test");
 
-const { hotList, webSearch, xhsHotList } = require("./api");
-const {
+const { hotList, webSearch, xhsHotList } = require("./api");const {
   buildBriefingResult,
   formatHotListText,
   parseLimit,
@@ -14,6 +13,14 @@ const {
 } = require("./commands/content");
 const { formatSearchText } = require("./commands/web_search");
 const { hotListTextFormatter, notePublishTextFormatter } = require("./commands/xhs");
+const {
+  wxArticleData,
+  wxHistoryArticles,
+} = require("./api");
+const {
+  formatArticleDataText,
+  formatHistoryText,
+} = require("./commands/wx");
 
 function captureRequest(callback, responseBody = { success: true, billing: {} }, transport = https) {
   const originalRequest = transport.request;
@@ -366,3 +373,143 @@ test("parseLimit accepts the documented range", () => {
   assert.throws(() => parseLimit("31"), { type: "validation_error" });
   assert.throws(() => parseLimit("invalid"), { type: "validation_error" });
 });
+
+test("wxArticleData posts the article url with a Bearer header and strips billing", async () => {
+  const request = await captureRequest(() => wxArticleData("test-key", " https://mp.weixin.qq.com/s?__biz=M1 "), {
+    success: true,
+    message: "微信公众号文章互动数据获取成功。",
+    billing: { service_fee: 0.02, transaction_ids: [7] },
+    data: { read_num: 1200, zan_num: 8 },
+  });
+
+  assert.equal(request.options.path, "/api/wx_article_data");
+  assert.equal(request.options.port, 443);
+  assert.equal(request.options.headers.Authorization, "Bearer test-key");
+  assert.deepEqual(request.body, { url: "https://mp.weixin.qq.com/s?__biz=M1" });
+  assert.equal(request.result.billing, undefined);
+  assert.equal(request.result.data.read_num, 1200);
+});
+
+test("wxArticleData rejects a blank url without calling the endpoint", async () => {
+  await assert.rejects(() => wxArticleData("test-key", "  "), { type: "validation_error" });
+});
+
+test("wxHistoryArticles maps pagination fields from the api docs", async () => {
+  const request = await captureRequest(() => wxHistoryArticles("test-key", {
+    name: " 人民日报 ",
+    maxPages: "3",
+    maxSeconds: "50",
+  }), { success: true, data: { data: [] } });
+
+  assert.equal(request.options.path, "/api/wx_history_articles");
+  assert.equal(request.options.headers.Authorization, "Bearer test-key");
+  assert.deepEqual(request.body, { name: "人民日报", max_pages: 3, max_seconds: 50 });
+});
+
+test("wxHistoryArticles accepts a url instead of a name and rejects missing locators", async () => {
+  const request = await captureRequest(
+    () => wxHistoryArticles("test-key", { url: "https://mp.weixin.qq.com/s/abc" }),
+    { success: true, data: { data: [] } }
+  );
+  assert.deepEqual(request.body, { url: "https://mp.weixin.qq.com/s/abc" });
+
+  await assert.rejects(() => wxHistoryArticles("test-key", {}), { type: "validation_error" });
+  await assert.rejects(
+    () => wxHistoryArticles("test-key", { name: "人民日报", maxSeconds: 171 }),
+    { type: "validation_error" }
+  );
+});
+
+test("wx endpoints turn HTTP 200 business failures into api_error", async () => {
+  const failure = { success: false, message: "账户余额不足，当前余额：0.01，需要：0.02", billing: {} };
+
+  await assert.rejects(
+    () => captureRequest(() => wxArticleData("test-key", "https://mp.weixin.qq.com/s/abc"), failure),
+    (err) => err.type === "api_error" && err.message === failure.message
+  );
+  await assert.rejects(
+    () => captureRequest(() => wxHistoryArticles("test-key", { name: "人民日报" }), failure),
+    { type: "api_error" }
+  );
+});
+
+test("wx history treats an upstream code inside a successful response as a failure", async () => {
+  // 2026-11-05 线上实测：平台仍回 success:true，把上游失败塞进 data.code（api_docs：code 0 为成功），
+  // 文章数组为空。若照 success 判断，会把「上游挂了」报成「这个号最近没发文」。
+  const upstreamFailure = {
+    success: true,
+    message: "未能获取到任何数据。请检查参数或账户余额。",
+    billing: { pages_billed: 0, transaction_ids: [] },
+    data: { code: 20001, msg: "error", data: [], now_page: 0, now_page_articles_num: 0 },
+  };
+
+  await assert.rejects(
+    () => captureRequest(() => wxHistoryArticles("test-key", { name: "人民日报" }), upstreamFailure),
+    (err) =>
+      err.type === "api_error" &&
+      err.message.includes("未能获取到任何数据") &&
+      err.message.includes("20001")
+  );
+});
+
+test("wx history still resolves an empty page when the upstream code is 0", async () => {
+  const emptyButOk = {
+    success: true,
+    message: "微信公众号历史文章获取完成。成功获取 1 页数据，共 0 篇文章。",
+    data: { code: 0, msg: "success", data: [], now_page: 1 },
+  };
+
+  const request = await captureRequest(
+    () => wxHistoryArticles("test-key", { name: "不存在的号" }),
+    emptyButOk
+  );
+  assert.deepEqual(request.result.data.data, []);
+  assert.equal(request.result.success, true);
+});
+
+test("wx history formatter lists documented article fields", () => {
+  const text = formatHistoryText({
+    data: {
+      mp_nickname: "人民日报",
+      mp_ghid: "gh_363b924965e9",
+      now_page: 1,
+      data: [{
+        title: "今日要闻",
+        post_time_str: "2026-08-27 16:32:59",
+        read: 12345,
+        zan: 67,
+        original: 1,
+        digest: "摘要内容",
+        url: "https://mp.weixin.qq.com/s/abc",
+      }],
+    },
+  });
+  assert.match(text, /公众号: 人民日报（gh_363b924965e9）/);
+  assert.match(text, /篇数: +1/);
+  assert.match(text, /\[1\] 今日要闻/);
+  assert.match(text, /时间: 2026-08-27 16:32:59/);
+  assert.match(text, /阅读 12345 \| 点赞 67 \| 原创/);
+  assert.match(text, /URL: +https:\/\/mp\.weixin\.qq\.com\/s\/abc/);
+});
+
+test("wx article-data formatter labels the fields the live endpoint returns", () => {
+  // 字段取自 2026-11-04 线上真实响应
+  const articleText = formatArticleDataText({
+    message: "微信公众号文章互动数据获取成功。",
+    data: { read: 100001, zan: 5685, looking: 3202, share_num: 21013, collect_num: 3129, comment_count: 12 },
+  });
+  assert.match(articleText, /阅读: 100001/);
+  assert.match(articleText, /点赞: 5685/);
+  assert.match(articleText, /在看: 3202/);
+  assert.match(articleText, /分享: 21013/);
+  assert.match(articleText, /收藏: 3129/);
+  assert.match(articleText, /评论: 12/);
+
+  // 上游新增字段时不能被吞掉
+  const withUnknown = formatArticleDataText({ data: { read: 1, new_metric: 7 } });
+  assert.match(withUnknown, /阅读: 1/);
+  assert.match(withUnknown, /new_metric: 7/);
+
+  const emptyText = formatArticleDataText({ data: {} });
+  assert.match(emptyText, /上游未返回字段/);
+});

package/src/commands/wx.js

@@ -0,0 +1,116 @@
+const { wxArticleData, wxHistoryArticles } = require("../api");
+const { outputResult, resolveKeyOrExit, handleApiError } = require("../lib/cli-utils");
+
+// wx_article_data 的真实返回字段（2026-11-04 线上实测）；上游改名时未知键仍原样输出
+const ARTICLE_DATA_LABELS = [
+  ["read", "阅读"],
+  ["zan", "点赞"],
+  ["looking", "在看"],
+  ["share_num", "分享"],
+  ["collect_num", "收藏"],
+  ["comment_count", "评论"],
+];
+
+/**
+ * 获取公众号文章互动数据
+ * @param {string} url 微信文章链接
+ * @param {object} options
+ */
+async function articleDataCommand(url, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+  try {
+    const result = await wxArticleData(apiKey, url);
+    outputResult(result, format, formatArticleDataText);
+    process.exit(0);
+  } catch (err) { handleApiError(err, format); process.exit(1); }
+}
+
+/**
+ * 获取公众号历史文章列表
+ * @param {string|undefined} url 微信文章链接（用于定位公众号）
+ * @param {object} options
+ */
+async function historyCommand(url, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+  try {
+    const result = await wxHistoryArticles(apiKey, {
+      url,
+      name: options.name,
+      maxPages: options.maxPages,
+      maxSeconds: options.maxSeconds,
+    });
+    outputResult(result, format, formatHistoryText);
+    process.exit(0);
+  } catch (err) { handleApiError(err, format); process.exit(1); }
+}
+
+/**
+ * text 输出：公众号文章互动数据（已知字段给中文标签，未知字段原样输出）
+ * @param {object} resp
+ * @returns {string}
+ */
+function formatArticleDataText(resp = {}) {
+  const data = resp.data || {};
+  const lines = ["✓ 公众号文章互动数据"];
+  if (resp.message) lines.push(`  消息: ${resp.message}`);
+
+  const printed = new Set();
+  const known = [];
+  ARTICLE_DATA_LABELS.forEach(([key, label]) => {
+    if (data[key] === undefined) return;
+    printed.add(key);
+    known.push(`  ${label}: ${data[key]}`);
+  });
+  const extras = Object.keys(data)
+    .filter((key) => !printed.has(key))
+    .map((key) => {
+      const value = data[key];
+      return `  ${key}: ${value !== null && typeof value === "object" ? JSON.stringify(value) : String(value)}`;
+    });
+
+  if (known.length === 0 && extras.length === 0) {
+    lines.push("  上游未返回字段（用 -f json 查看原始响应）");
+    return lines.join("\n");
+  }
+  return lines.concat(known, extras).join("\n");
+}
+
+/**
+ * text 输出：公众号历史文章列表
+ * @param {object} resp
+ * @returns {string}
+ */
+function formatHistoryText(resp = {}) {
+  const data = resp.data || {};
+  const articles = Array.isArray(data.data) ? data.data : [];
+  const lines = ["✓ 公众号历史文章"];
+  const nickname = data.mp_nickname || data.nickname;
+  // 实测用 name 定位时只有 mp_ghid，api_docs 里的 mp_wxid / head_img 并不返回
+  const accountId = data.mp_wxid || data.wxid || data.mp_ghid;
+  if (nickname) lines.push(`  公众号: ${nickname}${accountId ? `（${accountId}）` : ""}`);
+  lines.push(`  篇数:   ${articles.length}`);
+  if (data.now_page !== undefined) lines.push(`  翻页:   ${data.now_page}`);
+
+  articles.forEach((item, index) => {
+    lines.push(`\n[${index + 1}] ${item.title || "未命名文章"}`);
+    if (item.post_time_str) lines.push(`    时间: ${item.post_time_str}`);
+    const stats = [];
+    if (item.read !== undefined) stats.push(`阅读 ${item.read}`);
+    if (item.zan !== undefined) stats.push(`点赞 ${item.zan}`);
+    if (item.original) stats.push("原创");
+    if (stats.length > 0) lines.push(`    数据: ${stats.join(" | ")}`);
+    if (item.digest) lines.push(`    摘要: ${item.digest}`);
+    if (item.url) lines.push(`    URL:  ${item.url}`);
+  });
+
+  return lines.join("\n");
+}
+
+module.exports = {
+  articleDataCommand,
+  historyCommand,
+  formatArticleDataText,
+  formatHistoryText,
+};