aiconductor-cli 1.3.1 → 1.3.3

package/AGENTS.md

@@ -1,76 +1,67 @@
-# CLAUDE.md
+# Repository Guidelines
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+## Project Structure & Module Organization
 
-## Commands
-
-### 本地运行
-
-```bash
-node bin/aiconductor-cli.js --help                              # 查看所有命令
-node bin/aiconductor-cli.js <command> --help                    # 查看子命令选项
-node bin/aiconductor-cli.js search web "关键词" -n 3 -f text    # 真实调用示例
 ```
-
-### 发布到 npm
-
-```bash
-npm version patch|minor|major    # 升版本号
-npm pkg fix                      # 修复 package.json 格式
-npm publish                      # 发布
+bin/aiconductor-cli.js     CLI entry point (Commander.js)
+src/
+  api.js                   HTTP API client — all platform calls live here
+  lib/cli-utils.js         Shared helpers: output, error handling, key resolution
+  commands/
+    html_publish.js        `html publish` command
+    md_publish.js          `webpage publish` command (Markdown/HTML)
+    web_search.js          `search web` / `search image` commands
+    douyin.js              All `douyin` subcommands
+    xhs.js                 `xhs note-publish` command
 ```
 
-发布前须对本轮新增/修改的每个命令逐条执行真实调用，确认 exit 0 且输出格式正确。
+- Commands are thin wrappers: parse options, call `src/api.js`, format output, and exit.
+- Shared logic (key resolution, error formatting, output) goes into `src/lib/cli-utils.js`.
+- Each command file exports an async function; no side effects on load.
 
-## Architecture
+## Build, Test, and Development Commands
 
-### 分层结构
+- `node bin/aiconductor-cli.js --help` — run locally without a build step
+- `npm install` — install the single runtime dependency (`commander`)
+- No test suite currently exists
 
-```
-bin/aiconductor-cli.js          ← 入口层：commander 注册子命令树，不含业务逻辑
-src/api.js                      ← API 层：HTTPS 请求封装 + API Key 解析
-src/lib/cli-utils.js            ← 共享工具：output/outputError/key/error 统一处理
-src/commands/<topic>.js         ← 命令层：参数组装、调用 API、格式化输出
-```
+## Coding Style & Naming Conventions
 
-**`bin/aiconductor-cli.js`** — 纯聚合入口，action 回调只做参数传递。
+- 2-space indentation, no tabs
+- CommonJS (`require` / `module.exports`), no ESM
+- camelCase for JS identifiers; snake_case for API request fields
+- Every exported function gets a JSDoc block describing parameters and return type
+- Use `const` by default; `let` only when reassignment is needed
+- No formatter or linter configured — follow surrounding code style
 
-**`src/api.js`** — 所有外部 API 调用的底层封装：
-- `resolveApiKey(optionKey)` — 三级优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件
-- `httpPost()` — 通用 HTTPS POST（端口 443），统一处理 HTTP 错误和网络错误
-- 每个 API 端点对应一个独立函数，通过 `stripBilling()` 过滤计费信息
-- 新增 API 端点只改此文件
+## Error Handling
 
-**`src/lib/cli-utils.js`** — 所有 command 文件共享的工具模块：
-- `outputResult(data, format, textFormatter?)` — 统一成功输出（JSON: `{success: true, data}`）
-- `outputError(err, format)` — 统一错误输出（JSON: `{success: false, error}` 到 stderr）
-- `resolveKeyOrExit(optionKey, format)` — 解析 API Key，失败自动输出错误并 exit(1)
-- `handleApiError(err, format)` — 统一处理 http_error / network_error / 未知错误
-- `safeParseInt(value, defaultValue)` — 安全整数解析，防 NaN
+- Never swallow errors with empty `catch`. At minimum, log and re-throw.
+- API errors carry a `.type` property (`http_error`, `network_error`, `validation_error`, `api_error`)
+- Commands exit with code 0 on success, 1 on failure
 
-**`src/commands/<topic>.js`** — 命令编排层，每个文件对应一个子命令组：
-- 导入 `cli-utils` 的 4 个共享函数，消除重复代码
-- 业务逻辑函数接收 argument + options，组装参数 → 调 API → `outputResult`
-- 成功 `exit(0)`，失败 `exit(1)`
+## Testing Guidelines
 
-### 输出格式约定
+No test framework is wired up yet. If adding tests:
+- Use a standard Node.js test runner or Jest
+- Place test files next to the module they cover (`src/commands/web_search.test.js`)
 
-所有命令支持 `-f json|text`：
-- **JSON（默认）**：成功 stdout `{ success: true, data: {...} }`，失败 stderr `{ success: false, error: "..." }`
-- **text**：人类可读格式，成功以 `✓` 开头
+## Commit & Pull Request Guidelines
 
-### API Key 鉴权
+From the existing history:
 
-两种模式共存（由 API 端决定，不要自行统一）：
-- Body 模式：`api_key` 放入请求 body（多数端点）
-- Bearer 模式：`Authorization: Bearer <api_key>` HTTP 头（web_search、douyin_video_search）
+- Messages are in English, often prefixed with conventional commit tags: `feat:`, `fix:`, `refactor:`, `chore:`, `style:`, `ci:`
+- Agent-authored commits include `[Agent]` before the description
+- PRs should describe the change, note API surface impacts, and keep diffs focused
 
-### 扩展新 API 的标准流程
+## Adding a New Command
 
-1. `src/api.js`：添加 API 端点常量和调用函数（~10 行）
-2. `src/commands/<新主题>.js`：新建文件，导入 `cli-utils`，写命令函数（~10 行/命令）
-3. `bin/aiconductor-cli.js`：引入模块并注册子命令组
+1. Create `src/commands/<name>.js` with an async handler that calls `src/api.js`
+2. Add the API function to `src/api.js` if it calls a new endpoint
+3. Register the subcommand in `bin/aiconductor-cli.js`
+4. Update `README.md` — command synopsis, option table, and example
 
-### Skills 依赖
+## Security & Configuration
 
-`.codebuddy/skills/` 下 3 个 skills（`aic-web-search`、`webpage-publish`、`douyin-toolbox`）依赖此 CLI。修改命令签名或输出格式会破坏它们。`.codebuddy/` 已被 `.npmignore` 排除。
+- API Key is read from three sources in order: `-k` CLI argument → `AICONDUCTOR_API_KEY` env var → `.env` file
+- Never commit `.env` files or hardcoded credentials

package/README.md

@@ -77,6 +77,36 @@ aiconductor-cli webpage publish index.html -t my-page
 aiconductor-cli webpage publish "# Hello\n\nThis is **markdown**" -t hello
 ```
 
+### 管理已发布网页
+
+查询当前 API Key 所属用户的网页发布记录：
+
+```bash
+aiconductor-cli webpage list [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--page` | 页码，最小为 1 | 1 |
+| `--page-size` | 每页条数，范围为 1 到 100 | 20 |
+| `-k, --api-key` | API Key（可选） | 环境变量 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+删除指定的已发布网页及其公开 HTML 对象：
+
+```bash
+aiconductor-cli webpage delete <webpage_id> [选项]
+```
+
+示例：
+```bash
+# 查看第 2 页，每页 50 条
+aiconductor-cli webpage list --page 2 --page-size 50 -f text
+
+# 删除 ID 为 123 的网页
+aiconductor-cli webpage delete 123
+```
+
 ### 网页搜索
 
 ```bash
@@ -85,18 +115,23 @@ aiconductor-cli search web <关键词> [选项]
 
 | 选项 | 说明 | 默认值 |
 |------|------|--------|
-| `-n, --count` | 返回条数（最多50） | 5 |
+| `-n, --count` | 返回条数（最多50） | 10 |
 | `--time-range` | 时间范围：预设 `OneDay`/`OneWeek`/`OneMonth`/`OneYear`，或自定义 `YYYY-MM-DD..YYYY-MM-DD` | 无 |
-| `--no-summary` | 不返回内容摘要 | 默认返回 |
-| `--content-format` | 内容格式：`Text` 或 `Markdown` | Text |
-| `--auth-level` | 权威过滤：0=不过滤，1=优先权威来源 | 0 |
+| `--need-content` | 仅返回包含正文的结果 | 关闭 |
+| `--need-url` | 仅返回带原文链接的结果 | 关闭 |
+| `--sites` | 限定搜索站点，完整域名以 `\|` 分隔，最多20个 | 无 |
+| `--block-hosts` | 屏蔽站点，完整域名以 `\|` 分隔，最多5个 | 无 |
+| `--auth-info-level` | 权威度过滤：0=不限制，1=仅非常权威内容 | 0 |
+| `--auth-level` | `--auth-info-level` 的兼容别名 | 无 |
+| `--content-format` | 正文格式：`text` 或 `markdown` | text |
+| `--industry` | 行业搜索：`finance`、`game` 或 `gov` | 无 |
 | `--query-rewrite` | 开启 Query 改写 | 关闭 |
 | `-f, --format` | 输出格式：`json` 或 `text` | json |
 
 示例：
 ```bash
-aiconductor-cli search web "北京今日天气" -n 3 --auth-level 1
-aiconductor-cli search web "AI 最新进展" --time-range OneWeek --content-format Markdown
+aiconductor-cli search web "北京今日天气" -n 3 --auth-info-level 1 --need-url
+aiconductor-cli search web "AI 最新进展" --time-range OneWeek --content-format markdown --need-content
 aiconductor-cli search web "技术文章" --time-range 2025-01-01..2025-06-30 -n 10
 ```
 
@@ -109,12 +144,17 @@ aiconductor-cli search image <关键词> [选项]
 | 选项 | 说明 | 默认值 |
 |------|------|--------|
 | `-n, --count` | 返回条数（最多5） | 5 |
-| `--time-range` | 时间范围：预设或自定义日期范围 | 无 |
+| `--image-width-min` | 图片最小宽度 | 无 |
+| `--image-width-max` | 图片最大宽度 | 无 |
+| `--image-height-min` | 图片最小高度 | 无 |
+| `--image-height-max` | 图片最大高度 | 无 |
+| `--image-shapes` | 图片形状，以 `\|` 分隔：`横长方形`、`竖长方形`、`方形` | 无 |
+| `--query-rewrite` | 开启 Query 改写 | 关闭 |
 | `-f, --format` | 输出格式：`json` 或 `text` | json |
 
 示例：
 ```bash
-aiconductor-cli search image "长城风景" -n 3 -f text
+aiconductor-cli search image "长城风景" -n 3 --image-width-min 1200 --image-shapes "横长方形|方形" -f text
 ```
 
 ### 抖音数据工具箱
@@ -279,7 +319,7 @@ aiconductor-cli xhs note-publish video \
 |------|------|
 | HTML 发布 | 0.01 元/次 |
 | Markdown/HTML 网页发布 | 0.01 元/次 |
-| 网页/图片搜索 | 0.03 元/次 |
+| 豆包网页/图片搜索 | 0.02 元/次 |
 | 抖音作品详情 | 0.01 元/次 |
 | 抖音作品评论 | 0.01 元/次 |
 | 抖音用户视频列表 | 0.03 元/页 |
@@ -299,6 +339,8 @@ cd aiconductor-cli
 npm install
 node bin/aiconductor-cli.js --help    # 本地运行
 ```
+
+贡献前请阅读 [AGENTS.md](./AGENTS.md) 了解项目结构、编码风格与提交流程。
 
 ## License
 

package/bin/aiconductor-cli.js

@@ -2,7 +2,11 @@
 
 const { Command } = require("commander");
 const { publishCommand } = require("../src/commands/html_publish");
-const { publishCommand: webpagePublishCommand } = require("../src/commands/md_publish");
+const {
+  publishCommand: webpagePublishCommand,
+  listCommand: webpageListCommand,
+  deleteCommand: webpageDeleteCommand,
+} = require("../src/commands/md_publish");
 const { searchCommand } = require("../src/commands/web_search");
 const {
   videoInfoCommand,
@@ -47,8 +51,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 文件提供）")
@@ -56,9 +60,30 @@ webpageCmd
   .option("--type <type>", "强制指定类型：md 或 html（默认自动识别）")
   .option("--copy-button", "添加代码复制按钮（仅 Markdown 类型生效）")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((input, options) => {
-    webpagePublishCommand(input, 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
@@ -70,12 +95,17 @@ 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("--no-summary", "不返回摘要")
-  .option("--content-format <format>", "内容格式：Text 或 Markdown", "Text")
-  .option("--auth-level <level>", "权威来源过滤：0=不过滤，1=优先权威来源", "0")
-  .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);
@@ -85,9 +115,14 @@ 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("--time-range <range>", "时间范围：OneDay/OneWeek/OneMonth/OneYear 或 YYYY-MM-DD..YYYY-MM-DD")
+  .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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiconductor-cli",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "AIConductor CLI 工具箱",
   "keywords": [
     "aiconductor",
@@ -21,7 +21,9 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "scripts": {},
+  "scripts": {
+    "test": "node --test"
+  },
   "dependencies": {
     "commander": "^12.1.0"
   }

package/src/api.js

@@ -3,9 +3,11 @@ const fs = require("fs");
 const path = require("path");
 
 const API_HOST = "plugin.aiconductor.fun";
-const API_PATH = "/api/html_publish";
-const MD_TO_HTML_API_PATH = "/api/md_to_html";
-const SEARCH_API_PATH = "/api/aic_web_search";
+const API_PATH = "/api/html_publish";
+const MD_TO_HTML_API_PATH = "/api/md_to_html";
+const PUBLISHED_WEBPAGES_API_PATH = "/api/published_webpages";
+const DELETE_PUBLISHED_WEBPAGE_API_PATH = "/api/delete_published_webpage";
+const SEARCH_API_PATH = "/api/doubao_search";
 const DOUYIN_VIDEO_INFO_PATH = "/api/douyin_video_info";
 const DOUYIN_VIDEO_COMMENTS_PATH = "/api/douyin_video_comments";
 const DOUYIN_USER_VIDEOS_PATH = "/api/douyin_user_videos";
@@ -60,7 +62,7 @@ function stripBilling(resp) {
  * @param {*} value
  * @param {string} name
  */
-function validateInt(value, name) {
+function validateInt(value, name) {
   if (value === undefined || value === null) return;
   const n = Number(value);
   if (!Number.isInteger(n) || n < 0) {
@@ -124,6 +126,22 @@ function httpPost(host, requestPath, body, headers = {}) {
   });
 }
 
+/**
+ * 校验正整数参数
+ * @param {*} value
+ * @param {string} name
+ * @param {number} [max]
+ * @returns {number}
+ */
+function validatePositiveInt(value, name, max) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || (max !== undefined && n > max)) {
+    const range = max === undefined ? "大于等于 1" : `1 到 ${max}`;
+    throw Object.assign(new Error(`${name} 须为 ${range} 的整数，收到: ${value}`), { type: "validation_error" });
+  }
+  return n;
+}
+
 function contentTypeForFilename(filename) {
   const types = {
     ".avif": "image/avif",
@@ -255,26 +273,62 @@ async function publishHtml(apiKey, htmlCode, title) {
 }
 
 /**
- * 网页/图片搜索
- * @param {string} apiKey
- * @param {{ query: string, searchType: string, count?: number, timeRange?: string, needSummary?: boolean, contentFormats?: string, authLevel?: number, queryRewrite?: boolean }} params
- * @returns {Promise<object>}
- */
-async function webSearch(apiKey, params) {
-  // 输入校验
-  validateInt(params.count, "count");
-  validateInt(params.authLevel, "authLevel");
-
-  const reqBody = {
-    query: params.query,
-    search_type: params.searchType,
-  };
-  if (params.count !== undefined) reqBody.count = params.count;
-  if (params.timeRange) reqBody.time_range = params.timeRange;
-  if (params.needSummary !== undefined) reqBody.need_summary = params.needSummary;
-  if (params.contentFormats) reqBody.content_formats = params.contentFormats;
-  if (params.authLevel !== undefined) reqBody.auth_level = params.authLevel;
-  if (params.queryRewrite !== undefined) reqBody.query_rewrite = params.queryRewrite;
+ * 豆包网页/图片搜索
+ * @param {string} apiKey
+ * @param {{ query: string, searchType: "web"|"image", count?: number, queryRewrite?: boolean, needContent?: boolean, needUrl?: boolean, sites?: string, blockHosts?: string, authInfoLevel?: number, timeRange?: string, contentFormats?: string, industry?: string, imageWidthMin?: number, imageWidthMax?: number, imageHeightMin?: number, imageHeightMax?: number, imageShapes?: string[]|string }} params
+ * @returns {Promise<object>}
+ */
+async function webSearch(apiKey, params) {
+  const maxCount = params.searchType === "web" ? 50 : 5;
+  if (params.searchType !== "web" && params.searchType !== "image") {
+    throw Object.assign(new Error("searchType 只能是 web 或 image"), { type: "validation_error" });
+  }
+  const count = params.count === undefined ? undefined : validatePositiveInt(params.count, "count", maxCount);
+  validateInt(params.authInfoLevel, "authInfoLevel");
+  validateInt(params.imageWidthMin, "imageWidthMin");
+  validateInt(params.imageWidthMax, "imageWidthMax");
+  validateInt(params.imageHeightMin, "imageHeightMin");
+  validateInt(params.imageHeightMax, "imageHeightMax");
+
+  const authInfoLevel = params.authInfoLevel === undefined ? undefined : Number(params.authInfoLevel);
+  const imageWidthMin = params.imageWidthMin === undefined ? undefined : Number(params.imageWidthMin);
+  const imageWidthMax = params.imageWidthMax === undefined ? undefined : Number(params.imageWidthMax);
+  const imageHeightMin = params.imageHeightMin === undefined ? undefined : Number(params.imageHeightMin);
+  const imageHeightMax = params.imageHeightMax === undefined ? undefined : Number(params.imageHeightMax);
+
+  if (authInfoLevel !== undefined && ![0, 1].includes(authInfoLevel)) {
+    throw Object.assign(new Error("authInfoLevel 只能是 0 或 1"), { type: "validation_error" });
+  }
+  if (imageWidthMin !== undefined && imageWidthMax !== undefined && imageWidthMin > imageWidthMax) {
+    throw Object.assign(new Error("imageWidthMin 不能大于 imageWidthMax"), { type: "validation_error" });
+  }
+  if (imageHeightMin !== undefined && imageHeightMax !== undefined && imageHeightMin > imageHeightMax) {
+    throw Object.assign(new Error("imageHeightMin 不能大于 imageHeightMax"), { type: "validation_error" });
+  }
+
+  const reqBody = {
+    query: params.query,
+    search_type: params.searchType,
+  };
+  if (count !== undefined) reqBody.count = count;
+  if (params.queryRewrite !== undefined) reqBody.query_rewrite = params.queryRewrite;
+
+  if (params.searchType === "web") {
+    if (params.needContent !== undefined) reqBody.need_content = params.needContent;
+    if (params.needUrl !== undefined) reqBody.need_url = params.needUrl;
+    if (params.sites) reqBody.sites = params.sites;
+    if (params.blockHosts) reqBody.block_hosts = params.blockHosts;
+    if (authInfoLevel !== undefined) reqBody.auth_info_level = authInfoLevel;
+    if (params.timeRange) reqBody.time_range = params.timeRange;
+    if (params.contentFormats) reqBody.content_formats = params.contentFormats;
+    if (params.industry) reqBody.industry = params.industry;
+  } else {
+    if (imageWidthMin !== undefined) reqBody.image_width_min = imageWidthMin;
+    if (imageWidthMax !== undefined) reqBody.image_width_max = imageWidthMax;
+    if (imageHeightMin !== undefined) reqBody.image_height_min = imageHeightMin;
+    if (imageHeightMax !== undefined) reqBody.image_height_max = imageHeightMax;
+    if (params.imageShapes !== undefined) reqBody.image_shapes = params.imageShapes;
+  }
 
   const resp = await httpPost(API_HOST, SEARCH_API_PATH, reqBody, {
     Authorization: `Bearer ${apiKey}`,
@@ -291,7 +345,7 @@ async function webSearch(apiKey, params) {
  * @param {boolean} [addCopyButton=true]
  * @returns {Promise<{success: boolean, message: string, file_url: string, online_url: string}>}
  */
-async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false) {
+async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false) {
   const reqBody = {
     api_key: apiKey,
     md_text: mdText,
@@ -301,8 +355,44 @@ async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false)
 
   const resp = await httpPost(API_HOST, MD_TO_HTML_API_PATH, reqBody);
 
-  return stripBilling(resp);
-}
+  return stripBilling(resp);
+}
+
+/**
+ * 查询当前用户已发布的网页列表
+ * @param {string} apiKey
+ * @param {{page?: number|string, pageSize?: number|string}} [params]
+ * @returns {Promise<{success: boolean, webpages: Array, total: number, page: number, page_size: number}>}
+ */
+async function getPublishedWebpages(apiKey, params = {}) {
+  const page = validatePositiveInt(params.page === undefined ? 1 : params.page, "page");
+  const pageSize = validatePositiveInt(params.pageSize === undefined ? 20 : params.pageSize, "page_size", 100);
+  const resp = await httpPost(API_HOST, PUBLISHED_WEBPAGES_API_PATH, {
+    page,
+    page_size: pageSize,
+  }, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+
+  return stripBilling(resp);
+}
+
+/**
+ * 删除当前用户指定的已发布网页
+ * @param {string} apiKey
+ * @param {number|string} webpageId
+ * @returns {Promise<{success: boolean, message: string, webpage_id: number|null}>}
+ */
+async function deletePublishedWebpage(apiKey, webpageId) {
+  const id = validatePositiveInt(webpageId, "webpage_id");
+  const resp = await httpPost(API_HOST, DELETE_PUBLISHED_WEBPAGE_API_PATH, {
+    webpage_id: id,
+  }, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+
+  return stripBilling(resp);
+}
 
 /**
  * 获取抖音作品详情
@@ -436,8 +526,10 @@ async function xhsNotePublish(apiKey, params) {
 
 module.exports = {
   resolveApiKey,
-  publishHtml,
-  publishMdToHtml,
+  publishHtml,
+  publishMdToHtml,
+  getPublishedWebpages,
+  deletePublishedWebpage,
   webSearch,
   douyinVideoInfo,
   douyinVideoComments,

package/src/api.test.js

@@ -0,0 +1,98 @@
+const assert = require("node:assert/strict");
+const { EventEmitter } = require("node:events");
+const https = require("node:https");
+const test = require("node:test");
+
+const { webSearch } = require("./api");
+
+function captureRequest(callback) {
+  const originalRequest = https.request;
+  let captured;
+  https.request = (options, responseCallback) => {
+    const request = new EventEmitter();
+    const chunks = [];
+    request.write = (chunk) => chunks.push(Buffer.from(chunk));
+    request.end = () => {
+      captured = { options, body: JSON.parse(Buffer.concat(chunks).toString("utf-8")) };
+      const response = new EventEmitter();
+      response.statusCode = 200;
+      responseCallback(response);
+      response.emit("data", Buffer.from(JSON.stringify({ success: true, billing: {} })));
+      response.emit("end");
+    };
+    return request;
+  };
+
+  return callback().then(() => captured).finally(() => {
+    https.request = originalRequest;
+  });
+}
+
+test("webSearch maps current web search options to the Doubao endpoint", async () => {
+  const request = await captureRequest(() => webSearch("test-key", {
+    query: "最新的北京游玩攻略",
+    searchType: "web",
+    count: 10,
+    queryRewrite: true,
+    needContent: true,
+    needUrl: true,
+    sites: "example.com|volcengine.com",
+    blockHosts: "spam.example",
+    authInfoLevel: 1,
+    timeRange: "OneYear",
+    contentFormats: "markdown",
+    industry: "finance",
+  }));
+
+  assert.equal(request.options.path, "/api/doubao_search");
+  assert.equal(request.options.headers.Authorization, "Bearer test-key");
+  assert.deepEqual(request.body, {
+    query: "最新的北京游玩攻略",
+    search_type: "web",
+    count: 10,
+    query_rewrite: true,
+    need_content: true,
+    need_url: true,
+    sites: "example.com|volcengine.com",
+    block_hosts: "spam.example",
+    auth_info_level: 1,
+    time_range: "OneYear",
+    content_formats: "markdown",
+    industry: "finance",
+  });
+});
+
+test("webSearch maps current image filters and rejects invalid count", async () => {
+  const request = await captureRequest(() => webSearch("test-key", {
+    query: "长城风景",
+    searchType: "image",
+    count: 5,
+    queryRewrite: true,
+    imageWidthMin: 1200,
+    imageWidthMax: 1920,
+    imageHeightMin: 800,
+    imageHeightMax: 1080,
+    imageShapes: "横长方形|方形",
+  }));
+
+  assert.deepEqual(request.body, {
+    query: "长城风景",
+    search_type: "image",
+    count: 5,
+    query_rewrite: true,
+    image_width_min: 1200,
+    image_width_max: 1920,
+    image_height_min: 800,
+    image_height_max: 1080,
+    image_shapes: "横长方形|方形",
+  });
+
+  await assert.rejects(
+    webSearch("test-key", { query: "长城", searchType: "image", count: 6 }),
+    { type: "validation_error" }
+  );
+  await assert.rejects(
+    webSearch("test-key", { query: "长城", searchType: "image", imageWidthMin: "invalid" }),
+    { type: "validation_error" }
+  );
+});