aiconductor-cli 1.6.0 → 1.8.0

package/api_docs/wx_draft_add.md

@@ -1,56 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_draft_add`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-新增微信公众号图文草稿：先上传封面图获取 `thumb_media_id`，再调用微信 `draft/add` 接口创建草稿。仅做 API 密钥校验，**不扣费**。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| access_token | string | 是 | - | 微信公众号接口调用凭证（通过 wx_access_token 获取） |
-| title | string | 是 | - | 文章标题 |
-| content | string | 是 | - | 文章内容（HTML 格式） |
-| image_url | string | 是 | - | 封面图片 URL（需可公网访问，用于上传获取 thumb_media_id） |
-| author | string | 否 | 空 | 作者（微信限制不超过 16 字符，超出将截断） |
-| content_source_url | string | 否 | 空 | 原文链接 |
-| digest | string | 否 | 空 | 摘要 |
-| need_open_comment | int | 否 | `0` | 是否打开评论，`0` 否 / `1` 是 |
-| only_fans_can_comment | int | 否 | `0` | 是否仅粉丝可评论，`0` 否 / `1` 是 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| media_id | string | 创建成功的草稿 media_id（失败为空字符串，可传入 wx_draft_publish 发布） |
-| error_code | int | 错误码，成功为 `0`，失败为微信返回的 `errcode` |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_draft_add" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "access_token": "your_wechat_access_token",
-    "title": "我的第一篇文章",
-    "content": "<p>这里是正文内容，支持 <b>加粗</b> 等 HTML 标签。</p>",
-    "image_url": "https://example.com/cover.jpg",
-    "author": "张三",
-    "digest": "文章摘要"
-  }'
-```
-
-## 注意事项
-1. 本接口**不扣费**，仅验证 API 密钥。
-2. `image_url` 必须可公网访问，接口会先下载并上传至微信素材库获取 `thumb_media_id`；上传失败则返回 `media_id` 为空。
-3. `author` 字段超过 16 字符（或 8 个汉字）会被截断，以符合微信限制。
-4. 返回的 `media_id` 需配合 `wx_draft_publish` 接口完成发布。
-5. 微信端对 `content` 中图片有域名白名单等校验，建议正文图片先经 `wx_image_upload` 转为微信图片 URL。

package/api_docs/wx_draft_publish.md

@@ -1,47 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_draft_publish`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将已创建的图文草稿提交发布（微信 `freepublish/submit` 接口）。仅做 API 密钥校验，**不扣费**。注意：接口调用成功仅表示发布任务提交成功，实际发布结果由微信事件推送通知。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| access_token | string | 是 | - | 微信公众号接口调用凭证（通过 wx_access_token 获取） |
-| media_id | string | 是 | - | 要发布的草稿 media_id（通过 wx_draft_add 获取） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（任务是否提交成功） |
-| message | string | 响应消息 |
-| publish_id | string | 发布任务 ID（成功时返回） |
-| msg_data_id | string | 消息的数据 ID |
-| errcode | int | 微信返回的错误码，`0` 表示成功 |
-| errmsg | string | 错误信息 |
-| code | int | HTTP 状态码，成功为 `200`（密钥/参数错误为 400/401，超时 504，其他异常 500） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_draft_publish" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "access_token": "your_wechat_access_token",
-    "media_id": "your_draft_media_id"
-  }'
-```
-
-## 注意事项
-1. 本接口**不扣费**，仅验证 API 密钥。
-2. 需先通过 `wx_draft_add` 获取草稿 `media_id`，再调用本接口提交发布。
-3. 微信端为**异步发布**：本接口返回成功仅代表任务已提交，最终发布结果通过微信事件回调通知，需另行监听。
-4. `access_token`、`media_id` 缺失时分别返回 `code=400`；密钥无效返回 `code=401`；调用微信超时返回 `code=504`。

package/api_docs/wx_history_articles.md

@@ -1,89 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_history_articles`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-获取微信公众号历史文章列表，支持自动翻页与按页计费。为**计费插件**：按成功翻页次数计费（每翻一页扣费一次），费用以 `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`，上游映射为 `nickname`） |
-| max_pages | int | 否 | `1` | 最大翻页数量 |
-| max_seconds | int | 否 | `50` | 最长运行时长（秒），超时即停止翻页，**最大值 170**（默认50，传值>170自动截断为170，预留10s给平台180s超时） |
-
-> **说明**：`url` 与 `name` 二者至少提供一个，否则返回失败。
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| billing | object | 计费信息，含以下子字段 |
-| billing.service_fee | float | 单页计费单价 |
-| billing.discount_applied | boolean | 是否应用了折扣（本插件恒为 `true`） |
-| billing.balance_before | float | 扣费前账户余额 |
-| billing.balance_after | float | 扣费后账户余额 |
-| billing.currency | string | 货币单位，固定 `CNY` |
-| billing.pages_billed | int | 实际成功计费（翻页）页数 |
-| billing.total_service_fee | float | 累计扣费总额 |
-| billing.transaction_ids | array | 交易流水 ID 列表（每页一条） |
-| data | object | 业务数据 |
-| data.code | int | 上游返回码，`0` 为成功 |
-| data.msg | string | `success` / `error` |
-| 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 | 公众号头像 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_history_articles" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "name": "人民日报",
-    "max_pages": 3,
-    "max_seconds": 50
-  }'
-```
-
-## 注意事项
-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[]` 为跨页合并后的文章列表，单页条数由上游决定；`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/api_docs/wx_image_upload.md

@@ -1,46 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_image_upload`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-从指定 URL 下载图片并上传到微信公众号素材库，返回微信图片 URL。仅做 API 密钥校验，**不扣费**。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| access_token | string | 是 | - | 微信公众号接口调用凭证（通过 wx_access_token 获取） |
-| image_url | string | 是 | - | 待上传的图片公网 URL 地址 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| url | string | 上传成功后微信返回的图片 URL（失败为空字符串） |
-| errcode | int | 错误码，`0` 表示成功，非 0 或 `-1` 表示失败 |
-| errmsg | string | 错误描述信息 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_image_upload" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "access_token": "your_wechat_access_token",
-    "image_url": "https://example.com/cover.jpg"
-  }'
-```
-
-## 注意事项
-1. 本接口**不扣费**，仅验证 API 密钥。
-2. 仅支持 `jpg` / `jpeg` / `png` 格式，且文件大小需在 **1MB 以内**，超出限制将返回失败。
-3. `image_url` 须为可公网访问的图片地址；接口会校验响应 `Content-Type` 是否为图片类型。
-4. `access_token` 为必填，缺失时返回 `errcode=-1` 的失败响应。
-5. 上传使用的微信接口为 `cgi-bin/media/uploadimg`，返回的是微信图片外链 URL。

package/api_docs/wx_md_to_html.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_md_to_html`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将 Markdown 文本转换为微信公众号兼容的 HTML（遵循 V2.0 样式规范：基于 Section、Flex 列表、内联样式）。仅做 API 密钥校验，**不扣费**。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| md_text | string | 是 | - | 待转换的 Markdown 文本内容 |
-| primary_color | string | 否 | `#07c160` | 主题色（标题、列表标记、链接、加粗等用色，微信绿） |
-| text_color | string | 否 | `#333333` | 正文文字颜色 |
-| secondary_color | string | 否 | `#888888` | 次要文本颜色 |
-| font_size | int | 否 | `16` | 正文字号（px） |
-| line_height | float | 否 | `1.75` | 行高 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息（成功示例：「转换成功」；空内容示例：「转换成功（空内容）」） |
-| html | string | 转换后的微信公众号 HTML 字符串（失败为空字符串） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_md_to_html" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "md_text": "# 标题\n\n这是一段正文，支持 **加粗**、[链接](https://example.com) 与列表：\n\n- 项目一\n- 项目二",
-    "primary_color": "#07c160",
-    "text_color": "#333333"
-  }'
-```
-
-## 注意事项
-1. 本接口**不扣费**，仅验证 API 密钥。
-2. 当 `md_text` 为空时仍返回 `success=true` 且 `html` 为空字符串（视为空内容转换成功）。
-3. 转换支持标题、段落、有序/无序列表（转为 Flex Section）、引用、代码块、内联代码、图片、表格、加粗、链接等常见 Markdown 元素。
-4. 输出为带内联样式的 HTML 片段，可直接粘贴至公众号编辑器。

package/api_docs/wx_rss_reader.md

@@ -1,59 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_rss_reader`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-批量读取微信公众号的 RSS 订阅文章（支持多公众号并发）。为**计费插件**：按公众号数量计费（单价 × 公众号个数），费用以 `api_services` 表（`service_code=wechat_rss_reader`）配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| wx_names | string | 是 | - | 公众号名称，多个用英文逗号隔开，如 `公众号A,公众号B` |
-| recent_days | int | 否 | `3` | 获取最近几天内的文章 |
-| max_items | int | 否 | `5` | 每个公众号最多返回几篇 |
-| use_json_mode | bool | 否 | `false` | 是否启用 JSON 文件模式：为 `true` 时结果打包上传 OSS 并返回 `data_url`，`data` 为 null |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（整体任务是否提交完成） |
-| message | string | 响应消息，如「批量处理完成: 成功 X 个，失败 Y 个」 |
-| billing | object | 计费信息，含以下子字段 |
-| billing.service_code | string | 服务代码 `wechat_rss_reader` |
-| billing.unit_fee | float | 单个公众号的单价 |
-| billing.total_fee | float | 总费用 = 单价 × 公众号数量 |
-| billing.count | int | 本次请求的公众号数量 |
-| billing.transaction_id | int | 交易流水 ID |
-| data_url | string | JSON 模式下的 OSS 结果文件链接（`use_json_mode=false` 时为 null） |
-| data | array | 非 JSON 模式下的解析结果列表（`use_json_mode=true` 时为 null），每个元素含以下字段 |
-| data[].wx_name | string | 公众号名称 |
-| data[].success | boolean | 该公众号是否解析成功 |
-| data[].message | string | 该公众号的解析说明 |
-| data[].data | object | 该公众号的 RSS 解析结果（结构取决于 RSS 解析服务返回） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_rss_reader" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "wx_names": "人民日报,央视新闻",
-    "recent_days": 3,
-    "max_items": 5,
-    "use_json_mode": false
-  }'
-```
-
-## 注意事项
-1. 本接口**计费**，按公众号数量（×单价）一次性扣费；余额不足时不扣费并返回失败。
-2. API 密钥无效或账户被禁用时不扣费。
-3. 公众号需已在后台 `wechat_rss_feeds` 表中配置对应 RSS 链接，未配置或查询不到则返回该公众号 `success=false`。
-4. 多公众号并发上限为 5；单公众号 RSS 解析调用最多重试 3 次，单次请求整体超时 60 秒。
-5. `use_json_mode=true` 时结果以 JSON 文件形式上传至 OSS（`temporary_90` 目录）并返回 `data_url`，便于批量数据落地。

package/api_docs/xhs_hot_list.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_hot_list`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-获取小红书实时热榜（热门话题/关键词榜单），返回名次、标题、链接、热度值及趋势。按次计费，费用以 api_services 表配置为准（service_code: `xhs_hot_list`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| 无业务参数 | — | — | — | 仅需有效的 api_key 鉴权，无需其他业务参数 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / transaction_id） |
-| data.date | string | 热榜日期 |
-| data.items | array[object] | 热榜条目列表（见下） |
-
-`data.items[]` 字段：`rank`(int)、`title`(string)、`url`(string)、`item_id`(string)、`hot`(string)、`hot_value`(int)、`trend`(string)。
-
-## 请求示例
-
-```bash
-curl -X GET "http://plugin.aiconductor.fun/api/xhs_hot_list" \
-  -H "Authorization: Bearer your_api_key"
-```
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_hot_list" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{}'
-```
-
-## 注意事项
-1. 接口无业务参数，仅需有效的 api_key；余额不足、密钥无效或账户禁用均不扣费。
-2. 上游返回业务错误或热榜为空时返回失败且不扣费。
-3. 采用后扣费模式：仅成功取到热榜数据后才扣费，网络/上游异常不扣费。
-4. 上游单页请求超时 55s。

package/api_docs/xhs_note_comments_fast.md

@@ -1,54 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_comments_fast`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据笔记 ID 或分享链接获取小红书笔记的一级评论数据，支持自动翻页与时间控制，按页计费。费用以 api_services 表配置为准（service_code: `xhs_get_note_comment_fast`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| note_id | string | 否 | None | 笔记 ID（`share_text` 为空时必填） |
-| xsec_token | string | 否 | None | URL 或列表中的 xsec_token 值（`share_text` 为空时必填） |
-| share_text | string | 否 | None | web 端 URL 链接（`note_id` 为空时必填） |
-| max_pages | int | 否 | 1 | 最大翻页数 |
-| max_seconds | int | 否 | 50 | 最长运行时长（秒） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-> `note_id`+`xsec_token` 与 `share_text` 两组参数至少提供一组。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / pages_billed / total_service_fee / transaction_ids） |
-| data.code | int | 上游返回码 |
-| data.user_id | string | 笔记所属用户 ID |
-| data.comments | array[object] | 评论列表（已过滤 liked/show_tags/status/at_users 字段，含 sub_comments 子评论） |
-| data.cursor | string | 下一页翻页游标 |
-| data.has_more | boolean | 是否还有更多数据 |
-| data.time | int | 处理完成时间戳（毫秒） |
-| data.xsec_token | string | 笔记 xsec_token |
-| data.total_pages | int | 实际抓取页数 |
-| data.total_comments | int | 评论总数 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_comments_fast" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"note_id": "65dxxxx", "xsec_token": "xxx_token", "max_pages": 2}'
-```
-
-## 注意事项
-1. 按页计费：每成功抓取一页计费一次，余额不足、超时或上游无更多数据自动停止翻页。
-2. 采用后扣费模式：仅成功获取并解析后才扣费，失败不扣费。
-3. `note_id`+`xsec_token` 或 `share_text` 至少一组；上游 `code != 0` 时停止翻页。
-4. 评论数据已剔除内部字段（liked/show_tags/status/at_users），便于前端使用。
-5. 上游单页请求超时 55s。

package/api_docs/xhs_note_info_v2.md

@@ -1,45 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_info_v2`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-小红书笔记信息提取插件 V2，支持从分享文本或直接链接中提取笔记标题、内容、图片和视频信息，集成 API 密钥验证与计费。按次计费，费用以 api_services 表配置为准（service_code: `get_xhs_note_info_v2`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| url | string | 是 | — | 网页地址或包含链接的分享文本 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| title | string | 笔记标题（已去除「 - 小红书」后缀） |
-| content | string | 笔记内容（meta description） |
-| image_urls | array[string] | 图片链接列表（og:image） |
-| video_url | string | 视频链接（og:video） |
-| video_duration | string | 视频时长（og:videotime） |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / transaction_id） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_info_v2" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"url": "https://www.xiaohongshu.com/explore/65dxxxx?xsec_token=xxx&xsec_source=pc_pgy"}'
-```
-
-## 注意事项
-1. 采用后扣费模式：仅在页面成功访问并提取到信息后才扣费；密钥无效、账户禁用、页面不可访问、解析异常等均不扣费。
-2. 输入支持直接链接，也支持粘贴分享文本，插件会自动从文本中提取链接（`remove_params=False` 保留参数）。
-3. 若链接为 `xhslink.com` 短链，会自动解析为原始长链接（超时 10s），解析失败则继续用原链接尝试。
-4. 标题自动去除末尾「 - 小红书」后缀；内容取自页面 `meta[name=description]`。
-5. 上游页面请求超时 55s，超時或网络异常时返回失败且不扣费。

package/api_docs/xhs_note_info_v3.md

@@ -1,69 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_info_v3`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据笔记ID获取小红书笔记详情，包括标题、描述、用户信息、图片列表、互动数据、标签等。按次计费。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| note_id | string | 是 | | 笔记ID，从小红书链接 `/explore/` 后提取，如 `6915bf1300000000070380e4` |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| note_data | object | 笔记详情数据 |
-| note_data.note_id | string | 笔记ID |
-| note_data.type | string | 笔记类型（normal/video等） |
-| note_data.title | string | 笔记标题 |
-| note_data.desc | string | 笔记描述 |
-| note_data.time | integer | 发布时间（毫秒时间戳） |
-| note_data.video | string | 视频信息（图文笔记为空） |
-| note_data.user | object | 用户信息 |
-| note_data.user.user_id | string | 用户ID |
-| note_data.user.nickname | string | 用户昵称 |
-| note_data.user.avatar | string | 用户头像URL |
-| note_data.image_list | array | 图片列表 |
-| note_data.image_list[].url | string | 图片URL |
-| note_data.image_list[].width | integer | 图片宽度 |
-| note_data.image_list[].height | integer | 图片高度 |
-| note_data.image_list[].live_photo | boolean | 是否为Live Photo |
-| note_data.interact_info | object | 互动数据 |
-| note_data.interact_info.liked_count | string | 点赞数 |
-| note_data.interact_info.collected_count | string | 收藏数 |
-| note_data.interact_info.comment_count | string | 评论数 |
-| note_data.interact_info.share_count | string | 分享数 |
-| note_data.tag_list | array | 标签列表 |
-| note_data.tag_list[].id | string | 标签ID |
-| note_data.tag_list[].name | string | 标签名称 |
-| note_data.tag_list[].type | string | 标签类型 |
-| billing | object | 计费信息 |
-| billing.service_fee | float | 服务费 |
-| billing.discount_applied | boolean | 是否应用折扣 |
-| billing.balance_before | float | 扣费前余额 |
-| billing.balance_after | float | 扣费后余额 |
-| billing.currency | string | 货币类型（CNY） |
-| billing.transaction_id | string | 交易ID |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_info_v3" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"note_id": "6915bf1300000000070380e4"}'
-```
-
-## 注意事项
-1. note_id 从小红书链接中提取，链接格式为 `https://www.xiaohongshu.com/explore/{note_id}`
-2. 笔记可能因被隐藏、删除或设置访问权限而无法获取，此时返回失败信息且不扣费
-3. 采用后扣费模式，仅笔记详情获取成功时才扣费

package/api_docs/xhs_note_publish.md

@@ -1,54 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/xhs_note_publish`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-生成小红书扫码发布 H5 页面与二维码，支持图文/视频两种笔记类型，可选转存素材到 OSS。按次计费，费用以 api_services 表配置为准（service_code: `xhs_note_publish`（普通）/ `xhs_note_publish_pro`（含 OSS 转存））。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| type | string | 是 | — | 笔记类型：`normal`（图文）或 `video`（视频） |
-| title | string | 否 | "" | 标题，最多 20 字符（中文=1，英文/数字=0.5） |
-| content | string | 否 | "" | 正文，最多 1000 字符 |
-| images | array[string] | 否 | [] | 图片 URL 列表（`normal` 类型必填，最多 18 张，需公网 http(s)） |
-| video | string | 否 | "" | 视频 URL（`video` 类型必填，需公网 http(s)） |
-| cover | string | 否 | "" | 封面图 URL（`video` 类型可选，需公网 http(s)） |
-| transfer_to_oss | bool | 否 | false | 是否将素材转存到 OSS（视频上限 200MB，图片上限 32MB） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data.id | string | 笔记 ID |
-| data.url | string | 发布页 URL（上传至 OSS） |
-| data.qrcode | string | 发布页二维码（base64 data URL） |
-| data.transfer_to_oss | boolean | 是否转存了素材到 OSS |
-| data.media | object | 最终使用的素材（见下） |
-| data.media.images | array[string] | 图片地址（转存后为 OSS 地址） |
-| data.media.video | string | 视频地址（转存后为 OSS 地址） |
-| data.media.cover | string | 封面地址（转存后为 OSS 地址） |
-| billing | object | 计费信息（service_fee / discount_applied / balance_before / balance_after / currency / transaction_id） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/xhs_note_publish" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"type": "normal", "title": "周末探店", "content": "分享一家很棒的咖啡馆", "images": ["https://example.com/cover.jpg"]}'
-```
-
-## 注意事项
-1. 参数校验失败（`type` 非法、标题/正文超长、图文缺 images、视频缺 video、URL 非公网等）不扣费，返回 `billing` 余额均为 0。
-2. 图片/视频/封面 URL 必须是公网可访问的 http(s) 地址，并有 SSRF 防护（禁止内网、localhost 及非公网 IP）。
-3. 视频上限 200MB、图片上限 32MB，下载时最多 4 次重定向。
-4. 实际发布需在移动端小红书 APP 内完成；PC 端仅用于预览与扫码，调用方拿到 `url`/`qrcode` 后引导用户在手机打开。
-5. 采用后扣费模式：H5 页面生成并上传成功后才扣费，异常不扣费。