aiconductor-cli 1.3.1 → 1.3.3

package/src/commands/md_publish.js

@@ -1,6 +1,11 @@
 const fs = require("fs");
 const path = require("path");
-const { publishHtml, publishMdToHtml } = require("../api");
+const {
+  publishHtml,
+  publishMdToHtml,
+  getPublishedWebpages,
+  deletePublishedWebpage,
+} = require("../api");
 const { outputResult, outputError, resolveKeyOrExit, handleApiError } = require("../lib/cli-utils");
 
 /**
@@ -51,6 +56,47 @@ function formatPublishText(data) {
   return out.trimEnd();
 }
 
+/**
+ * text 模式的网页列表格式化
+ * @param {{webpages?: Array, page?: number, page_size?: number, total?: number}} data
+ * @returns {string}
+ */
+function formatWebpageListText(data) {
+  const webpages = data.webpages || [];
+  if (!webpages.length) return "没有已发布网页。";
+
+  const header = `已发布网页（第 ${data.page} 页，每页 ${data.page_size} 条，共 ${data.total} 条）`;
+  const entries = webpages.map((webpage) => {
+    const lines = [`[${webpage.id}] ${webpage.title || "未命名网页"}`];
+    if (webpage.online_url) lines.push(`  URL: ${webpage.online_url}`);
+    if (webpage.source) lines.push(`  来源: ${webpage.source}`);
+    if (webpage.created_at) lines.push(`  发布时间: ${webpage.created_at}`);
+    return lines.join("\n");
+  });
+  return [header, ...entries].join("\n");
+}
+
+/**
+ * text 模式的网页删除格式化
+ * @param {{webpage_id?: number|null, message?: string}} data
+ * @returns {string}
+ */
+function formatWebpageDeleteText(data) {
+  let output = `已删除网页 ID: ${data.webpage_id}`;
+  if (data.message) output += `\n信息: ${data.message}`;
+  return output;
+}
+
+/**
+ * API 业务失败时抛出统一错误
+ * @param {{success?: boolean, message?: string}} result
+ */
+function throwOnApiFailure(result) {
+  if (result && result.success === false) {
+    throw Object.assign(new Error(result.message || "API 请求失败"), { type: "api_error" });
+  }
+}
+
 /**
  * webpage publish 命令 — 统一发布 Markdown 或 HTML 为在线网页
  * @param {string} input - Markdown/HTML 代码或文件路径
@@ -84,4 +130,46 @@ async function publishCommand(input, options = {}) {
   }
 }
 
-module.exports = { publishCommand };
+/**
+ * webpage list 命令 — 查询当前用户已发布的网页
+ * @param {{ apiKey?: string, format?: string, page?: string, pageSize?: string }} options
+ */
+async function listCommand(options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+
+  try {
+    const result = await getPublishedWebpages(apiKey, {
+      page: options.page,
+      pageSize: options.pageSize,
+    });
+    throwOnApiFailure(result);
+    outputResult(result, format, formatWebpageListText);
+    process.exit(0);
+  } catch (err) {
+    handleApiError(err, format);
+    process.exit(1);
+  }
+}
+
+/**
+ * webpage delete 命令 — 删除指定的已发布网页
+ * @param {string} webpageId
+ * @param {{ apiKey?: string, format?: string }} options
+ */
+async function deleteCommand(webpageId, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+
+  try {
+    const result = await deletePublishedWebpage(apiKey, webpageId);
+    throwOnApiFailure(result);
+    outputResult(result, format, formatWebpageDeleteText);
+    process.exit(0);
+  } catch (err) {
+    handleApiError(err, format);
+    process.exit(1);
+  }
+}
+
+module.exports = { publishCommand, listCommand, deleteCommand };

package/src/commands/web_search.js

@@ -1,5 +1,5 @@
 const { webSearch } = require("../api");
-const { outputResult, outputError, resolveKeyOrExit, handleApiError, safeParseInt } = require("../lib/cli-utils");
+const { outputResult, outputError, resolveKeyOrExit, handleApiError } = require("../lib/cli-utils");
 
 /** text 模式的自定义格式化 */
 function formatSearchText(data) {
@@ -49,19 +49,34 @@ async function searchCommand(query, searchType, options = {}) {
   const params = { query, searchType };
 
   if (options.count !== undefined) {
-    params.count = safeParseInt(options.count, undefined);
+    params.count = options.count;
   }
   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.needContent) params.needContent = true;
+    if (options.needUrl) params.needUrl = true;
+    if (options.sites) params.sites = options.sites;
+    if (options.blockHosts) params.blockHosts = options.blockHosts;
+    const authInfoLevel = options.authInfoLevel ?? options.authLevel;
+    if (authInfoLevel !== undefined) {
+      params.authInfoLevel = authInfoLevel;
+    }
+    if (options.contentFormat) params.contentFormats = options.contentFormat;
+    if (options.industry) params.industry = options.industry;
+  } else {
+    for (const [optionName, paramName] of [
+      ["imageWidthMin", "imageWidthMin"],
+      ["imageWidthMax", "imageWidthMax"],
+      ["imageHeightMin", "imageHeightMin"],
+      ["imageHeightMax", "imageHeightMax"],
+    ]) {
+      if (options[optionName] !== undefined) {
+        params[paramName] = options[optionName];
+      }
+    }
+    if (options.imageShapes) params.imageShapes = options.imageShapes;
   }
   if (options.queryRewrite) {
     params.queryRewrite = true;

package/.codebuddy/skills/aic-web-search/SKILL.md

@@ -1,141 +0,0 @@
----
-name: aic-web-search
-description: 通过 AIConductor CLI 进行网页搜索和图片搜索。当用户需要搜索网络信息、查找网页内容、搜索图片时应使用此 Skill。触发词包括：搜索/搜一下/查一下/网页搜索/图片搜索/联网搜索/web search/image search。
----
-
-## 概述
-
-此 Skill 通过全局安装的 `aiconductor-cli` 命令行工具，调用融合信息搜索 API，支持网页搜索和图片搜索。
-
-## 准备工作
-
-### API Key 配置
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-获取后配置环境变量：
-
-**macOS / Linux：**
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-**Windows PowerShell：**
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-> 也可使用 `.env` 文件（项目目录下写入 `AICONDUCTOR_API_KEY=your-api-key`）。
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 搜索流程
-
-### 网页搜索
-
-使用 JSON 格式（默认，AI 友好）。
-
-```bash
-aiconductor-cli search web <搜索关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count <n>` | 返回条数（最多50） | 5 |
-| `--time-range <range>` | 时间范围过滤 | 无 |
-| `--no-summary` | 不返回内容摘要 | 默认返回摘要 |
-| `--content-format <format>` | 内容格式：`Text` 或 `Markdown` | `Text` |
-| `--auth-level <level>` | 权威来源过滤：`0`=不过滤，`1`=优先权威来源 | `0` |
-| `--query-rewrite` | 开启 Query 改写（口语化/长问题推荐） | 关闭 |
-| `-k, --api-key <key>` | API Key | 环境变量或 .env |
-| `-f, --format <format>` | 输出格式：`json` 或 `text` | `json` |
-
-**time_range 可选值：**
-- `OneDay` - 最近一天
-- `OneWeek` - 最近一周
-- `OneMonth` - 最近一月
-- `OneYear` - 最近一年
-- `YYYY-MM-DD..YYYY-MM-DD` - 自定义日期区间，如 `2025-01-01..2025-04-18`
-
-**示例：**
-
-```bash
-aiconductor-cli search web "北京今日天气" -n 5 --auth-level 1
-```
-
-若用户需要人类可读输出：
-
-```bash
-aiconductor-cli search web "北京今日天气" -f text
-```
-
-### 图片搜索
-
-```bash
-aiconductor-cli search image <搜索关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count <n>` | 返回条数（最多5） | 5 |
-| `--time-range <range>` | 时间范围过滤 | 无 |
-| `-k, --api-key <key>` | API Key | 环境变量或 .env |
-| `-f, --format <format>` | 输出格式：`json` 或 `text` | `json` |
-
-**示例：**
-
-```bash
-aiconductor-cli search image "长城风景" -n 3
-```
-
-### 解析输出
-
-JSON 格式输出示例（网页搜索）：
-```json
-{
-  "success": true,
-  "data": {
-    "success": true,
-    "message": "搜索成功",
-    "data": {
-      "ResultCount": 5,
-      "TimeCost": 234,
-      "WebResults": [
-        {
-          "SortId": 1,
-          "Title": "北京今日天气",
-          "SiteName": "中国天气网",
-          "Url": "https://...",
-          "Snippet": "摘要片段...",
-          "Summary": "内容摘要...",
-          "Content": "页面正文...",
-          "PublishTime": "2025-06-23",
-          "RankScore": 0.95
-        }
-      ]
-    }
-  }
-}
-```
-
-从中提取 `data.data.WebResults`（网页搜索）或 `data.data.ImageResults`（图片搜索）作为搜索结果返回给用户。
-
-### 错误处理
-
-- 缺少 API Key → 提示用户前往 https://dev.aiconductor.fun/register 注册获取
-- CLI 未安装 / command not found → 执行 `npm install -g aiconductor-cli`，安装后重试原命令
-- API 返回错误 → 展示错误信息给用户
-- 搜索失败不扣费，仅成功时计费
-
-## 注意事项
-
-1. 搜索关键词长度限制 1~100 字符
-2. `need_summary`（摘要）仅对网页搜索有效，图片搜索忽略此参数
-3. `auth_level=1` 适用于医疗、政策、金融等高可信度场景，仅在网页搜索时生效
-4. `query_rewrite=true` 适用于口语化提问或长问题，开启后上游会先改写 query 再搜索
-5. API 按次计费（0.03 元/次），计费信息不会暴露给终端用户
-6. 默认使用 JSON 输出格式，便于 AI Agent 解析

package/.codebuddy/skills/aic-web-search/references/aiconductor-skills-setup.md

@@ -1,50 +0,0 @@
-# 技能安装与配置
-
-仅当用户明确要求首次安装、初始化或配置此技能时读取本文档。正常搜索流程默认环境已经可用，不要每次使用前执行初始化。
-
-## 安装或升级 CLI
-
-使用 npm 全局安装最新版：
-
-```bash
-npm install -g aiconductor-cli@latest
-```
-
-安装后确认命令可用：
-
-```bash
-aiconductor-cli --help
-```
-
-## 配置 API Key
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-macOS / Linux：
-
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Windows PowerShell：
-
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-也可在当前项目目录创建 `.env` 文件：
-
-```env
-AICONDUCTOR_API_KEY=your-api-key
-```
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 故障恢复
-
-- `command not found` / `aiconductor-cli` 无法识别：执行安装或升级命令后重试原命令
-- 缺少 API Key：按上方方式配置密钥后开启新的终端会话，或在当前命令中临时使用 `-k <api-key>`
-- API Key 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。

package/.codebuddy/skills/douyin-toolbox/SKILL.md

@@ -1,219 +0,0 @@
----
-name: douyin-toolbox
-description: 抖音数据获取与处理工具箱，支持视频详情、评论抓取、用户主页、视频搜索、语音转文字等功能。当用户需要操作抖音数据时使用，例如：(1) 查看某个视频的详细信息或评论，(2) 获取用户主页视频列表或用户资料，(3) 按关键词搜索抖音用户或视频，(4) 将抖音视频语音转为文字，(5) 任何涉及抖音数据提取或分析的任务。
----
-
-## 概述
-
-此 Skill 通过全局安装的 `aiconductor-cli` 命令行工具，调用 AIC 抖音系列 API，支持视频详情、评论抓取、用户视频、用户详情、用户搜索、视频搜索、链接转文字共 7 个功能。
-
-适用环境默认已配置好 CLI 和 API Key。当遇到安装或配置问题时，读取 [references/aiconductor-skills-setup.md](references/aiconductor-skills-setup.md)。仅当用户明确要求初始化或配置 Skill 时才主动读取该文件。
-
-## 使用流程
-
-### 获取视频详情
-
-根据抖音视频分享链接获取视频详细信息，包括作者信息、统计数据、音乐信息等。
-
-```bash
-aiconductor-cli douyin video-info <分享链接> [选项]
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-info "https://v.douyin.com/xxx/"
-```
-
-### 获取视频评论
-
-根据抖音视频URL获取该视频的评论列表。
-
-```bash
-aiconductor-cli douyin video-comments <视频URL> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-count <n>` | 获取评论数量 | 50 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-comments "https://v.douyin.com/xxx/" --max-count 20
-```
-
-### 获取用户视频列表
-
-根据抖音用户主页URL获取该用户发布的视频列表，支持分页和时间限制。
-
-```bash
-aiconductor-cli douyin user-videos <主页URL> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大180 | 50 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-videos "https://www.douyin.com/user/xxx" --max-pages 3
-```
-
-### 获取用户详情
-
-根据抖音用户主页URL获取用户详细信息，包括基本信息、统计数据、直播状态等。
-
-```bash
-aiconductor-cli douyin user-detail <主页URL>
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-detail "https://www.douyin.com/user/xxx"
-```
-
-### 搜索用户
-
-根据关键词搜索抖音用户，支持按粉丝数量和用户类型筛选。
-
-```bash
-aiconductor-cli douyin user-search <关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数，0=不限制 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大180 | 50 |
-| `--fans-range <范围>` | 粉丝数筛选 | 不限 |
-| `--user-type <类型>` | 用户类型筛选 | 不限 |
-
-**粉丝数范围 `--fans-range`：**
-
-| 值 | 说明 |
-|----|------|
-| `0_1k` | 1000以下 |
-| `1k_1w` | 1000到1万 |
-| `1w_10w` | 1万到10万 |
-| `10w_100w` | 10万到100万 |
-| `100w_` | 100万以上 |
-
-**用户类型 `--user-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `common_user` | 普通用户 |
-| `enterprise_user` | 企业认证用户 |
-| `personal_user` | 个人认证用户 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-search "美食博主" --fans-range 1w_10w --user-type personal_user --max-pages 2
-```
-
-### 搜索视频
-
-根据关键词搜索抖音视频，支持排序方式、发布时间、视频时长、内容类型等筛选。
-
-```bash
-aiconductor-cli douyin video-search <关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数，0=不限制 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大50 | 50 |
-| `--sort-type <类型>` | 排序方式 | 0 |
-| `--publish-time <时间>` | 发布时间筛选 | 0 |
-| `--filter-duration <时长>` | 视频时长筛选 | 0 |
-| `--content-type <类型>` | 内容类型筛选 | 0 |
-
-**排序方式 `--sort-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 综合排序 |
-| `1` | 最多点赞 |
-| `2` | 最新发布 |
-
-**发布时间 `--publish-time`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `1` | 最近一天 |
-| `7` | 最近一周 |
-| `180` | 最近半年 |
-
-**视频时长 `--filter-duration`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `0-1` | 1分钟以内 |
-| `1-5` | 1-5分钟 |
-| `5-10000` | 5分钟以上 |
-
-**内容类型 `--content-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `1` | 视频 |
-| `2` | 图片 |
-| `3` | 文章 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-search "北京旅游" --sort-type 2 --publish-time 7 --max-pages 2
-```
-
-### 链接转文字
-
-将抖音视频链接中的语音转换为文字。支持两套语音识别策略，自动检测转写准确度。
-
-```bash
-aiconductor-cli douyin link-to-text <视频URL>
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin link-to-text "https://v.douyin.com/xxx/"
-```
-
-### 通用选项
-
-所有子命令均支持：
-
-| 选项 | 说明 |
-|------|------|
-| `-k, --api-key <key>` | AIConductor API Key（优先于环境变量和 .env） |
-| `-f, --format <format>` | 输出格式：`json` 或 `text`，默认 `json` |
-
-### 错误处理
-
-- 缺少 API Key / CLI 未安装 / command not found → 读取 [references/aiconductor-skills-setup.md](references/aiconductor-skills-setup.md) 并按其步骤处理
-- API 返回错误 → 展示错误信息给用户
-
-## 注意事项
-
-1. 接口支持 POST 和 GET 两种请求方式
-2. 所有接口均自动解析抖音短链接
-3. 翻页接口（用户搜索/视频搜索/用户视频）按页计费，达到时间或页数限制时自动停止
-4. API 按次或按页计费，计费信息不会暴露给终端用户
-5. 默认使用 JSON 输出格式，便于 AI Agent 解析
-6. 获取用户详情按次计费（0.03元/次）而非按秒

package/.codebuddy/skills/douyin-toolbox/references/aiconductor-skills-setup.md

@@ -1,50 +0,0 @@
-# 技能安装与配置
-
-仅当用户明确要求首次安装、初始化或配置此技能时读取本文档。正常操作流程默认环境已经可用，不要每次使用前执行初始化。
-
-## 安装或升级 CLI
-
-使用 npm 全局安装最新版：
-
-```bash
-npm install -g aiconductor-cli@latest
-```
-
-安装后确认命令可用：
-
-```bash
-aiconductor-cli --help
-```
-
-## 配置 API Key
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-macOS / Linux：
-
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Windows PowerShell：
-
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-也可在当前项目目录创建 `.env` 文件：
-
-```env
-AICONDUCTOR_API_KEY=your-api-key
-```
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 故障恢复
-
-- `command not found` / `aiconductor-cli` 无法识别：执行安装或升级命令后重试原命令
-- 缺少 API Key：按上方方式配置密钥后开启新的终端会话，或在当前命令中临时使用 `-k <api-key>`
-- API Key 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。