aiconductor-cli 1.2.1 → 1.2.2

package/src/commands/web_search.js

@@ -1,120 +1,84 @@
-const { resolveApiKey, webSearch } = require("../api");
-
-/**
- * 输出成功结果
- * @param {object} data
- * @param {"json"|"text"} format
- */
-function outputResult(data, format) {
-  if (format === "json") {
-    process.stdout.write(JSON.stringify({ success: true, data }, null, 2) + "\n");
-  } else {
-    // API 响应结构：{ success, message, data: { ResultCount, TimeCost, WebResults, ImageResults } }
-    const inner = data.data || {};
-    process.stdout.write(`✓ 搜索成功\n`);
-    process.stdout.write(`  结果数: ${inner.ResultCount}\n`);
-    process.stdout.write(`  耗时: ${inner.TimeCost}ms\n\n`);
-
-    if (inner.WebResults) {
-      inner.WebResults.forEach((item) => {
-        process.stdout.write(`[${item.SortId}] ${item.Title}\n`);
-        if (item.SiteName) process.stdout.write(`    站点: ${item.SiteName}\n`);
-        if (item.Url) process.stdout.write(`    URL: ${item.Url}\n`);
-        if (item.Snippet) process.stdout.write(`    摘要: ${item.Snippet}\n`);
-        if (item.Summary) process.stdout.write(`    内容摘要: ${item.Summary}\n`);
-        if (item.PublishTime) process.stdout.write(`    发布时间: ${item.PublishTime}\n`);
-        process.stdout.write(`\n`);
-      });
-    }
-
-    if (inner.ImageResults) {
-      inner.ImageResults.forEach((item) => {
-        process.stdout.write(`[${item.SortId}] ${item.Title}\n`);
-        if (item.SiteName) process.stdout.write(`    来源: ${item.SiteName}\n`);
-        if (item.Image?.Url) process.stdout.write(`    图片: ${item.Image.Url}\n`);
-        if (item.Image?.Width && item.Image?.Height) {
-          process.stdout.write(`    尺寸: ${item.Image.Width}x${item.Image.Height}\n`);
-        }
-        if (item.Url) process.stdout.write(`    来源页面: ${item.Url}\n`);
-        process.stdout.write(`\n`);
-      });
-    }
-  }
-}
-
-/**
- * 输出错误
- * @param {object} err
- * @param {"json"|"text"} format
- */
-function outputError(err, format) {
-  if (format === "json") {
-    process.stderr.write(JSON.stringify({ success: false, error: err.message || String(err) }, null, 2) + "\n");
-  } else {
-    process.stderr.write(`✗ 错误: ${err.message || err}\n`);
-  }
-}
-
-/**
- * search 命令
- * @param {string} query - 搜索关键词
- * @param {"web"|"image"} searchType - 搜索类型
- * @param {object} options - 命令行选项
- */
-async function searchCommand(query, searchType, options = {}) {
-  const format = options.format || "json";
-  const resolvedKey = resolveApiKey(options.apiKey);
-
-  if (!resolvedKey) {
-    outputError(
-      { message: "缺少 API Key。请通过 -k 参数、AICONDUCTOR_API_KEY 环境变量或 .env 文件提供。" },
-      format
-    );
-    process.exit(1);
-  }
-
-  const params = {
-    query,
-    searchType,
-  };
-
-  if (options.count !== undefined) {
-    params.count = parseInt(options.count, 10);
-  }
-  if (options.timeRange) {
-    params.timeRange = options.timeRange;
-  }
-  // need_summary 默认 true，--no-summary 时 options.summary 为 false
-  if (searchType === "web") {
-    params.needSummary = options.summary !== false;
-  }
-  if (options.contentFormat) {
-    params.contentFormats = options.contentFormat;
-  }
-  if (options.authLevel !== undefined) {
-    params.authLevel = parseInt(options.authLevel, 10);
-  }
-  if (options.queryRewrite) {
-    params.queryRewrite = true;
-  }
-
-  try {
-    const result = await webSearch(resolvedKey, params);
-    outputResult(result, format);
-    process.exit(0);
-  } catch (err) {
-    if (err.type === "http_error") {
-      outputError(
-        { message: `API 返回错误 (HTTP ${err.statusCode}): ${err.body?.message || JSON.stringify(err.body)}` },
-        format
-      );
-    } else if (err.type === "network_error") {
-      outputError({ message: `网络错误: ${err.message}` }, format);
-    } else {
-      outputError({ message: `未知错误: ${err.message || err}` }, format);
-    }
-    process.exit(1);
-  }
-}
-
-module.exports = { searchCommand };
+const { webSearch } = require("../api");
+const { outputResult, outputError, resolveKeyOrExit, handleApiError, safeParseInt } = require("../lib/cli-utils");
+
+/** text 模式的自定义格式化 */
+function formatSearchText(data) {
+  const inner = data.data || {};
+  let out = "✓ 搜索成功\n";
+  out += `  结果数: ${inner.ResultCount}\n`;
+  out += `  耗时: ${inner.TimeCost}ms\n\n`;
+
+  if (inner.WebResults) {
+    inner.WebResults.forEach((item) => {
+      out += `[${item.SortId}] ${item.Title}\n`;
+      if (item.SiteName) out += `    站点: ${item.SiteName}\n`;
+      if (item.Url) out += `    URL: ${item.Url}\n`;
+      if (item.Snippet) out += `    摘要: ${item.Snippet}\n`;
+      if (item.Summary) out += `    内容摘要: ${item.Summary}\n`;
+      if (item.PublishTime) out += `    发布时间: ${item.PublishTime}\n`;
+      out += `\n`;
+    });
+  }
+
+  if (inner.ImageResults) {
+    inner.ImageResults.forEach((item) => {
+      out += `[${item.SortId}] ${item.Title}\n`;
+      if (item.SiteName) out += `    来源: ${item.SiteName}\n`;
+      if (item.Image?.Url) out += `    图片: ${item.Image.Url}\n`;
+      if (item.Image?.Width && item.Image?.Height) {
+        out += `    尺寸: ${item.Image.Width}x${item.Image.Height}\n`;
+      }
+      if (item.Url) out += `    来源页面: ${item.Url}\n`;
+      out += `\n`;
+    });
+  }
+
+  return out.trimEnd();
+}
+
+/**
+ * search 命令
+ * @param {string} query - 搜索关键词
+ * @param {"web"|"image"} searchType - 搜索类型
+ * @param {object} options - 命令行选项
+ */
+async function searchCommand(query, searchType, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+
+  const params = { query, searchType };
+
+  if (options.count !== undefined) {
+    params.count = safeParseInt(options.count, undefined);
+  }
+  if (options.timeRange) {
+    params.timeRange = options.timeRange;
+  }
+  if (searchType === "web") {
+    params.needSummary = options.summary !== false;
+  }
+  if (options.contentFormat) {
+    params.contentFormats = options.contentFormat;
+  }
+  if (options.authLevel !== undefined) {
+    params.authLevel = safeParseInt(options.authLevel, undefined);
+  }
+  if (options.queryRewrite) {
+    params.queryRewrite = true;
+  }
+
+  try {
+    const result = await webSearch(apiKey, params);
+    outputResult(result, format, formatSearchText);
+    process.exit(0);
+  } catch (err) {
+    if (err.type === "validation_error") {
+      outputError(err, format);
+    } else {
+      handleApiError(err, format);
+    }
+    process.exit(1);
+  }
+}
+
+module.exports = { searchCommand };

package/src/lib/cli-utils.js

@@ -0,0 +1,80 @@
+const { resolveApiKey } = require("../api");
+
+/**
+ * 统一成功输出
+ * @param {object} data - API 返回数据
+ * @param {"json"|"text"} format
+ * @param {function} [textFormatter] - text 模式的自定义格式化函数，接收 data 返回字符串
+ */
+function outputResult(data, format, textFormatter) {
+  if (format === "json") {
+    process.stdout.write(JSON.stringify({ success: true, data }, null, 2) + "\n");
+  } else {
+    const text = textFormatter ? textFormatter(data) : JSON.stringify(data, null, 2);
+    process.stdout.write(text + "\n");
+  }
+}
+
+/**
+ * 统一错误输出
+ * @param {object} err - 错误对象（需有 message 属性）
+ * @param {"json"|"text"} format
+ */
+function outputError(err, format) {
+  const msg = err.message || String(err);
+  if (format === "json") {
+    process.stderr.write(JSON.stringify({ success: false, error: msg }, null, 2) + "\n");
+  } else {
+    process.stderr.write(`✗ 错误: ${msg}\n`);
+  }
+}
+
+/**
+ * 解析 API Key，失败时输出错误并退出进程
+ * @param {string} [optionKey] - 命令行传入的 key
+ * @param {"json"|"text"} format
+ * @returns {string} 解析到的 API Key
+ */
+function resolveKeyOrExit(optionKey, format) {
+  const key = resolveApiKey(optionKey);
+  if (!key) {
+    outputError(
+      { message: "缺少 API Key。请通过 -k 参数、AICONDUCTOR_API_KEY 环境变量或 .env 文件提供。" },
+      format
+    );
+    process.exit(1);
+  }
+  return key;
+}
+
+/**
+ * 统一 API 错误处理（不退出，由调用方决定退出码）
+ * @param {object} err - 错误对象
+ * @param {"json"|"text"} format
+ */
+function handleApiError(err, format) {
+  if (err.type === "http_error") {
+    outputError(
+      { message: `API 返回错误 (HTTP ${err.statusCode}): ${err.body?.message || JSON.stringify(err.body)}` },
+      format
+    );
+  } else if (err.type === "network_error") {
+    outputError({ message: `网络错误: ${err.message}` }, format);
+  } else {
+    outputError({ message: `未知错误: ${err.message || err}` }, format);
+  }
+}
+
+/**
+ * 安全解析整数，无效时返回 defaultValue
+ * @param {*} value
+ * @param {number} defaultValue
+ * @returns {number}
+ */
+function safeParseInt(value, defaultValue) {
+  if (value === undefined || value === null) return defaultValue;
+  const n = parseInt(value, 10);
+  return Number.isNaN(n) ? defaultValue : n;
+}
+
+module.exports = { outputResult, outputError, resolveKeyOrExit, handleApiError, safeParseInt };

package/AGENTS.md

@@ -1,79 +0,0 @@
-# AGENTS.md This file provides guidance to Agent when working with code in this repository.
-
-## Commands
-
-### 本地运行（开发调试）
-
-```bash
-node bin/aiconductor-cli.js --help                              # 查看所有命令
-node bin/aiconductor-cli.js html publish --help                 # 查看某命令选项
-node bin/aiconductor-cli.js search web "关键词" -n 3 -f text    # 运行网页搜索（text 输出）
-node bin/aiconductor-cli.js search image "关键词" -n 2          # 运行图片搜索（JSON 输出）
-```
-
-### 发布到 npm
-
-```bash
-npm version patch|minor|major    # 升版本号（新增功能升 minor，修复升 patch）
-npm pkg fix                      # 修复 package.json 格式问题
-npm publish                      # 发布（如开启 2FA 需加 --otp=<验证码>）
-```
-
-### 验证流程
-
-发布前必须对本轮新增/修改的每个命令执行真实调用，确认 exit code 0 且输出格式正确。用 `node bin/aiconductor-cli.js <command> --help` 检查选项完整性。
-
-## Architecture
-
-### 分层设计
-
-项目采用三层分离架构，每层职责明确：
-
-```
-bin/aiconductor-cli.js          ← 入口层：commander 注册子命令树，不含业务逻辑
-src/api.js                      ← API 层：HTTP 请求封装 + API Key 解析
-src/commands/<topic>.js         ← 命令层：参数组装、调用 API、格式化输出
-```
-
-**`bin/aiconductor-cli.js`** 是纯聚合入口，用 commander 的 `.command().addCommand()` 结构将各 topic 模块注册为子命令树。action 回调只做参数传递，不含业务逻辑。新增命令分类只需在此文件引入并注册。
-
-**`src/api.js`** 是所有外部 API 调用的底层封装：
-- `resolveApiKey(optionKey)` — 三级优先级查找 API Key：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > 当前目录 `.env` 文件
-- `httpPost(host, path, body, headers)` — 通用 HTTP POST 封装，支持自定义 headers，统一处理 HTTP 错误（`type: "http_error"`）和网络错误（`type: "network_error"`）
-- 每个外部 API 对应一个独立函数（如 `publishHtml`、`webSearch`），函数内过滤 `billing` 字段后返回
-- 新增外部 API 渠道只改此文件
-
-**`src/commands/<topic>.js`** 是命令编排层，每个文件对应一个命令分组：
-- 接收业务参数 + options 对象
-- 调用 `resolveApiKey` 解析 Key（失败则 exit 1）
-- 组装参数调用 `api.js` 中的函数
-- 通过 `outputResult` / `outputError` 统一处理输出
-- 成功 `process.exit(0)`，失败 `process.exit(1)`
-
-### 命令文件命名规则
-
-`src/commands/` 下的文件名与 API 端点名一一对应：
-- `/api/html_publish` → `html_publish.js`
-- `/api/aic_web_search` → `web_search.js`
-
-新增命令时遵循同样规则：文件名 = API 端点名（snake_case）。
-
-### 输出格式约定
-
-所有命令支持 `-f json|text` 两种输出格式：
-- **JSON（默认）**：成功输出 `{ success: true, data: {...} }`，失败输出 `{ success: false, error: "..." }`，便于 AI Agent 解析
-- **text**：人类可读格式，成功以 `✓` 开头，失败以 `✗` 开头
-
-### API Key 鉴权
-
-不同 API 使用不同鉴权方式：
-- `html_publish`：api_key 放入请求 body
-- `aic_web_search`：使用 `Authorization: Bearer <api_key>` 请求头
-
-### 计费信息过滤
-
-所有 API 函数在返回前通过解构 `const { billing, ...safe } = resp` 过滤掉计费字段，不暴露给终端用户。
-
-### Skills
-
-`.codebuddy/skills/` 下存放 CodeBuddy Skill 文档（SKILL.md），描述 CLI 命令的使用方法供 AI Agent 调用。每个 Skill 对应一个 CLI 命令分组，目录名使用 kebab-case。此目录已被 `.npmignore` 排除，不会发布到 npm。