aiconductor-cli 1.6.0 → 1.7.0

package/api_docs/douyin_user_videos_async.md

@@ -1,45 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_user_videos_async`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-调用抖音异步抓取服务，自动生成 task_id 并提交异步主页抓取任务（服务端以异步方式执行，不等待结果返回）。本接口仅负责提交任务，结果需配合 `douyin_user_videos_async_query` 查询。**本插件不参与计费系统**（无 verify_api_key / billing 调用）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| home_page | string | 是 | - | 抖音用户主页链接（自动提取并解析为长链接）。 |
-| max_seconds | integer | 否 | `300` | 异步任务最长等待秒数。 |
-| max_pages | integer | 否 | `30` | 异步任务最大翻页页数。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表（该参数将一并透传给异步后端服务）。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 任务是否提交成功。 |
-| task_id | string | 本次异步任务 ID（用于后续查询结果）。 |
-| message | string | 响应消息。 |
-| status_code | integer | 异步后端返回的 HTTP 状态码（成功为 200/202；网络异常为 0）。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_user_videos_async" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "home_page": "https://www.douyin.com/user/xxxxxx",
-    "max_pages": 10
-  }'
-```
-
-## 注意事项
-1. 本接口为异步提交，返回 200/202 仅表示任务已成功提交，不代表数据已抓取完成；请用返回的 `task_id` 调用 `douyin_user_videos_async_query` 查询结果。
-2. 链接解析失败（短链无法解析）会直接返回失败，不提交任务。
-3. 本插件无计费逻辑，不会进行余额校验与扣费。
-4. 异步后端密钥/服务地址仅配置在服务端，调用方无需也不应传入。

package/api_docs/douyin_user_videos_async_query.md

@@ -1,41 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_user_videos_async_query`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据 `douyin_user_videos_async` 提交任务后返回��� `task_id`，从结果存储（阿里云 OSS）拉取并解析对应的 JSON 结果文件。**本插件不参与计费系统**（无 verify_api_key / billing 调用，且请求本身不要求 api_key）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| task_id | string | 是 | - | 由 `douyin_user_videos_async` 返回的任务 ID。 |
-
-> **鉴权参数**：本接口逻辑不消费 api_key；若框架统一注入，可照常通过请求头 `Authorization: Bearer <api_key>` 传递，但不影响计费（无计费）。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（查询到结果文件为 true）。 |
-| result | object | 解析后的 JSON 内容（成功时返回；失败时为空对象 `{}`）。 |
-| error | string | 错误信息（成功时为空字符串 `""`；文件未生成/网络异常时返回提示）。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_user_videos_async_query" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "task_id": "3f9b1c2e-7d4a-4c8e-9b2a-1c2d3e4f5a6b"
-  }'
-```
-
-## 注意事项
-1. `result` 的具体字段结构取决于异步任务写入的内容，本接口原样返回 OSS 上的 JSON。
-2. 若结果尚未生成（任务仍在执行），通常会返回 404 相关提示：`查询结果尚未生成，请稍后再试`。此时应稍后重试查询。
-3. 若文件明确标记 `file_exists=false`，`success` 为 false 且 `error` 携带具体原因。
-4. 本插件无计费逻辑，不会进行余额校验与扣费。

package/api_docs/douyin_user_videos_max.md

@@ -1,59 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_user_videos_max`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据抖音用户主页 URL 获取该用户发布的视频列表，逐页获取后对每条视频调用详情接口获取完整信息（视频下载/封面链接、音乐、作者粉丝数等），支持分页与时间限制。双路独立计费，费用以 api_services 表配置为准：主页翻页按 `douyin_homepage_max` 扣费，每条成功富化的视频按 `douyin_video_info_max` 扣费。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| home_page | string | 是 | - | 抖音用户主页 URL（支持短链接，自动解析长链接并提取 sec_user_id）。 |
-| max_seconds | integer | 否 | `180` | 最长运行时间（秒），内部上限 180 秒。 |
-| max_pages | integer | 否 | `1` | 最大翻页页数，`0` 表示不限制页数（受 max_seconds 约束）。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| data | object | 结果数据。 |
-| data.aweme_list | array | 富化后的视频列表，每项含：author{nickname,signature,sec_uid,avatar,follower_count,total_favorited}、create_time、create_time_formatted、home_page、desc、share_url、duration（MM:SS）、statistics{digg_count,collect_count,comment_count,share_count}、enriched（是否成功富化）、video_id、interaction_detail{like,collect,share,comment}、video{cover,no_watermark_video,watermark_video}、images、music{title,author,play_url}。 |
-| data.total_pages_charged | integer | 实际扣费的主页翻页数。 |
-| data.total_videos_enriched | integer | 成功富化的视频数。 |
-| data.total_videos_failed | integer | 富化失败的视频数（保留基础数据并标记 enriched=false）。 |
-| billing | object | 计费信息。 |
-| billing.service_fee_homepage | float | 主页翻页单页费率。 |
-| billing.service_fee_video | float | 单个视频详情费率。 |
-| billing.total_fee | float | 实际总扣费（主页费 + 视频费）。 |
-| billing.discount_applied | boolean | 是否应用折扣。 |
-| billing.pages_charged | integer | 实际扣费页数。 |
-| billing.videos_charged | integer | 实际扣费视频数。 |
-| billing.balance_before | float | 扣费前余额。 |
-| billing.balance_after | float | 扣费后余额。 |
-| billing.currency | string | 货币类型，固定为 `CNY`。 |
-| billing.transaction_ids | array | 全部扣费交易ID列表（主页 + 视频）。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_user_videos_max" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "home_page": "https://www.douyin.com/user/xxxxxx",
-    "max_pages": 3
-  }'
-```
-
-## 注意事项
-1. 先校验 API 密钥与余额（至少够一页主页费），余额不足或密钥无效不扣费。
-2. 双路计费：每翻一页扣一次主页费；每成功富化一条视频（余额足够时）扣一次视频费；余额不足时剩余视频不再扣费。
-3. 视频详情接口 QPS 限制为 2，内置重试机制；富化失败的视频保留基础数据并标记 `enriched=false`，不扣视频费。
-4. 上游（TikHub / RapidAPI）密钥仅配置在服务端，调用方无需也不应传入。

package/api_docs/douyin_video_comments.md

@@ -1,68 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_video_comments`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据抖音视频 URL 获取该视频的评论列表（含评论内容、点赞数、IP 归属地、作者信息等）。按次计费，费用以 api_services 表配置为准（服务码 `douyin_single_video_comment_get`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| video_url | string | 是 | - | 抖音视频 URL（自动解析长链接并提取 video_id）。 |
-| max_count | integer | 否 | `50` | 获取的评论条数。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| data | object | 评论结果。 |
-| data.total | integer | 评论总数。 |
-| data.cursor | integer | 下一页游标。 |
-| data.has_more | integer | 是否还有更多（0/1）。 |
-| data.comments | array | 评论列表，每项含以下字段： |
-| data.comments[].text | string | 评论内容。 |
-| data.comments[].digg_count | integer | 评论点赞数。 |
-| data.comments[].ip_label | string | IP 归属地。 |
-| data.comments[].create_time | integer | 评论时间（Unix 时间戳）。 |
-| data.comments[].nickname | string | 评论者昵称。 |
-| data.comments[].reply_comment_total | integer | 回复总数。 |
-| data.comments[].cid | string | 评论 ID。 |
-| data.comments[].is_hot | boolean | 是否热评。 |
-| data.comments[].stick_position | integer | 置顶位置。 |
-| data.comments[].label_text | string | 标签文本。 |
-| data.comments[].reply_id | string | 回复的评论 ID。 |
-| data.comments[].level | integer | 评论层级。 |
-| data.comments[].is_author_digged | boolean | 作者是否点赞。 |
-| data.comments[].is_folded | boolean | 是否被折叠。 |
-| data.comments[].user | object | 评论者信息：uid、nickname、unique_id、sec_uid、region、avatar、custom_verify。 |
-| 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 | integer | 成功扣费后的交易ID；未扣费时为 `null`。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_video_comments" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "video_url": "https://www.douyin.com/video/7113430448613267720",
-    "max_count": 50
-  }'
-```
-
-## 注意事项
-1. 先校验 API 密钥与余额，余额不足或密钥无效不扣费；链接解析/视频 ID 提取失败不扣费。成功获取到评论数据后才扣费。
-2. 上游接口遇 HTTP 429（并发受限）或返回错误状态时自动重试（最多 5 次，每次间隔 2 秒）。
-3. 上游（RapidAPI）密钥仅配置在服务端，调用方无需也不应传入。

package/api_docs/douyin_video_info.md

@@ -1,70 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_video_info`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据抖音视频分享链接获取视频详情（标题、时间、互动数据、作者、无水印/有水印视频地址、音乐等）。按次计费，费用以 api_services 表配置为准（服务码 `douyin_video_info_max`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| share_url | string | 是 | - | 抖音视频分享链接或包含链接的文本（自动提取纯净链接并解析长链接）。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| data | object | 视频详情。 |
-| data.video_id | string | 视频 aweme_id。 |
-| data.title | string | 视频描述/标题。 |
-| data.create_time | integer | 发布时间（Unix 时间戳）。 |
-| data.create_time_formatted | string | 发布日期（YYYY-MM-DD）。 |
-| data.duration | integer | 时长（毫秒）。 |
-| data.duration_seconds | integer | 时长（秒，毫秒整除 1000）。 |
-| data.interaction.like | integer | 点赞数。 |
-| data.interaction.collect | integer | 收藏数。 |
-| data.interaction.share | integer | 分享数。 |
-| data.interaction.comment | integer | 评论数。 |
-| data.author.nickname | string | 作者昵称。 |
-| data.author.sec_uid | string | 作者 sec_uid。 |
-| data.author.signature | string | 作者签名。 |
-| data.author.avatar | string | 作者头像地址。 |
-| data.author.follower_count | integer | 作者粉丝数。 |
-| data.author.total_favorited | integer | 作者获赞总数。 |
-| data.video.cover | string | 封面地址。 |
-| data.video.no_watermark_video | string | 无水印视频地址。 |
-| data.video.watermark_video | string | 有水印视频地址。 |
-| data.images | array | 图文/笔记图片地址列表（非图文视频为 `null`）。 |
-| data.music.title | string | 背景音乐标题。 |
-| data.music.author | string | 背景音乐作者。 |
-| data.music.play_url | 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 | integer | 成功扣费后的交易ID；未扣费时为 `null`。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_video_info" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "share_url": "https://v.douyin.com/xxxxxxxx/"
-  }'
-```
-
-## 注意事项
-1. 先校验 API 密钥与余额，余额不足或密钥无效不扣费；链接提取/解析失败、视频数据不存在/获取失败均不扣费。
-2. 上游接口在两个 URL 间轮流重试（最多 5 次，每次间隔 2 秒）；均失败才返回错误并扣费（因已通过余额校验，按约定本次视为已计费请求）。
-3. 上游（RapidAPI）密钥仅配置在服务端，调用方无需也不应传入。

package/api_docs/douyin_video_search.md

@@ -1,60 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_video_search`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据关键词搜索抖音视频，支持排序、发布时间、时长、内容类型等筛选，并自动翻页。按页计费，费用以 api_services 表配置为准（服务码 `douyin_video_search`，每翻一页扣一次费，不足一页不扣）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| keyword | string | 是 | - | 搜索关键词。 |
-| sort_type | string | 否 | `0` | 排序类型（透传 TikHub 接口，如 `0` 综合、`1` 最多点赞等）。 |
-| publish_time | string | 否 | `0` | 发布时间筛选（透传 TikHub 接口）。 |
-| filter_duration | string | 否 | `0` | 时长筛选（透传 TikHub 接口）。 |
-| content_type | string | 否 | `0` | 内容类型筛选（透传 TikHub 接口）。 |
-| max_pages | integer | 否 | `1` | 最大翻页页数，`0` 表示不限制页数（受 max_seconds 约束）。 |
-| max_seconds | integer | 否 | `50` | 最大运行秒数，内部上限 50 秒。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| data | object | 搜索结果。 |
-| data.video_list | array | 视频列表，每项含：aweme_id、desc、create_time、author{uid,short_id,nickname,sec_uid,unique_id,signature,follower_count,total_favorited,is_verified,verification_type,enterprise_verify_reason,custom_verify,region,avatar_url}、music{id,title,author,duration,play_url}、video{duration,ratio,width,height,play_url,download_suffix,cover_url,dynamic_cover_url,origin_cover_url}、statistics{aweme_id,comment_count,digg_count,download_count,play_count,share_count,forward_count,collect_count...}、share_url、video_tag。 |
-| data.cursor | integer | 下一页游标。 |
-| data.has_more | integer | 是否还有更多（0/1）。 |
-| billing | object | 计费信息。 |
-| billing.service_fee | float | 单页服务费率。 |
-| billing.total_fee | float | 实际总扣费（页数 × 单页费率）。 |
-| billing.discount_applied | boolean | 是否应用折扣。 |
-| billing.pages_charged | integer | 实际扣费页数。 |
-| billing.balance_before | float | 扣费前余额。 |
-| billing.balance_after | float | 扣费后余额。 |
-| billing.currency | string | 货币类型，固定为 `CNY`。 |
-| billing.transaction_ids | array | 各页扣费交易ID列表。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_video_search" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "keyword": "露营攻略",
-    "sort_type": "1",
-    "max_pages": 2
-  }'
-```
-
-## 注意事项
-1. 仅当某一页成功返回视频数据时才对该页扣费；第一页即失败则不扣费，直接返回失败。
-2. 受 `max_pages` 与 `max_seconds`（上限 50 秒）双重限制；超时或后续翻页失败会返回已成功获取的部分数据（success 仍为 true）。
-3. 上游（TikHub）密钥仅配置在服务端，调用方无需也不应传入。

package/api_docs/douyin_video_search_fast.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_video_search_fast`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-通过 Coze 工作流对抖音关键词进行快速搜索，返回视频列表（每条视频附带格式化后的创建时间）。按次计费，费用以 api_services 表配置为准（服务码 `douyin_keywords_search_fast`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| keyword | string | 是 | - | 搜索关键词。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| keyword | string | 回显的搜索关键词。 |
-| video_list | array | 视频列表，每项含上游返回的原始字段；其中 `create_time` 经转换为 `create_time_converted`（YYYY-MM-DD HH:MM）。 |
-| message | 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 | integer | 成功扣费后的交易ID；未扣费时为 `null`。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/douyin_video_search_fast" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "keyword": "美食教程"
-  }'
-```
-
-## 注意事项
-1. 采用后扣费模式：仅在搜索成功（上游 code=0 且 HTTP 200）后才扣费；密钥无效/余额不足/网络异常/响应解析失败均不扣费。
-2. 上游 Coze 工作流密钥仅配置在服务端，调用方无需也不应传入。
-3. 返回结构依赖上游工作流输出，具体视频字段以 `video_list` 中实际内容为准。

package/api_docs/fast_ocr.md

@@ -1,51 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/fast_ocr`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-通过 Coze 工作流对图片进行 OCR 文字识别，返回拼接后的识别文本与原始结果。按次计费，费用以 api_services 表配置为准（服务码 `Fast_OCR`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| image_url | string | 是 | - | 待识别的图片 URL |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| ocr_text | string | 拼接后的完整识别文字 |
-| ocr_results | array | 原始 OCR 识别结果（按区块组织） |
-| ocr_results[].words | array | 区块内文字项列表 |
-| ocr_results[].words[].text | 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.transaction_id | int/null | 交易 ID |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/fast_ocr" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "image_url": "https://example.com/receipt.jpg"
-  }'
-```
-
-## 注意事项
-1. `image_url` 为必填，缺失返回 `success=false`。
-2. 单价由 `api_services` 表（服务码 `Fast_OCR`）读取，按次计费。
-3. 余额不足、Coze 调用失败、OCR 未识别到结果等情形均不扣费，返回 `success=false`。
-4. `ocr_results` 为 Coze 工作流返回的原始结构（含按区块/文字项组织），`ocr_text` 为所有文字项的拼接结果。

package/api_docs/flow_article2podcast_creat.md

@@ -1,41 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/flow_article2podcast_creat`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-创建文章转播客工作流任务，支持文章 URL 或内容输入，返回执行 ID 用于后续查询。本插件不计费（无 billing）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| article_content | string | 否 | "" | 文章内容（与 article_url 至少填一个） |
-| article_url | string | 否 | "" | 文章 URL（与 article_content 至少填一个） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| execute_id | string | 执行 ID（用于查询接口） |
-| debug_url | string | 调试 URL |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/flow_article2podcast_creat" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"article_url": "https://example.com/some-article", "article_content": ""}'
-```
-
-## 注意事项
-1. `article_content` 与 `article_url` 至少提供一个，否则返回失败（execute_id/debug_url 为空）。
-2. 该接口为异步任务创建入口，需配合 `flow_article2podcast_query` 接口，使用返回的 `execute_id` 轮询执行结果。
-3. 内部调用扣子（Coze）工作流 API，请求超时 30s（连接 10s）。
-4. 工作流创建失败、HTTP 非 200、未返回 execute_id 等情况均返回失败且不产生执行 ID。

package/api_docs/flow_article2podcast_query.md

@@ -1,41 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/flow_article2podcast_query`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-查询文章转播客工作流任务执行结果，输入执行 ID，返回执行状态与输出内容。本插件不计费（无 billing）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| execute_id | string | 是 | — | 执行 ID（由 flow_article2podcast_creat 创建时返回） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（execute_status 为 Success 时为 true） |
-| message | string | 响应消息（根据状态返回：成功/失败/执行中） |
-| execute_status | string | 执行状态：`Running` / `Success` / `Failed` |
-| output | string | 输出结果（已提取的 Output 内容，原始为 JSON 字符串） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/flow_article2podcast_query" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"execute_id": "7484132558797553704_xxxx"}'
-```
-
-## 注意事项
-1. `execute_id` 不能为空，否则直接返回失败。
-2. 该接口为异步轮询接口：任务可能处于 `Running` 状态，需调用方按间隔重试直至 `Success` 或 `Failed`。
-3. `output` 为上游 Output 字段内容；若 JSON 解析失败则原样返回字符串。
-4. 内部调用扣子（Coze）工作流历史接口，请求超时 30s（连接 10s）。
-5. 本插件不产生费用（不计费）。

package/api_docs/flow_wx_history_articles.md

@@ -1,45 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/flow_wx_history_articles`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-通过扣子（Coze）工作流获取微信公众号历史文章数据，返回文章 Excel 与 ZIP 文件的下载链接。本接口**不接入本平台计费系统（不扣费）**，仅作为工作流调用桥接。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| account_name | string | 是 | - | 目标微信公众号名称 |
-| max_pages | int | 否 | `5` | 最大翻页数量 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，框架自动注入；本插件同时会将该 `api_key` 作为工作流参数转发给扣子工作流。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（工作流执行结果） |
-| message | string | 处理结果消息 |
-| article_xlsx | string | 文章数据 Excel 文件 URL（失败为空字符串） |
-| article_zip | string | 文章数据 ZIP 文件 URL（失败为空字符串） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/flow_wx_history_articles" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "account_name": "人民日报",
-    "max_pages": 5
-  }'
-```
-
-## 注意事项
-1. 本接口**不接入本平台计费系统，不扣费**。
-2. `api_key` 除用于本平台鉴权外，会被作为工作流参数 `api_key` 转发给扣子工作流（框架自动从请求头注入到 body），请确保提供的密钥同时被工作流侧接受。
-3. 调用依赖外部扣子工作流（Coze），整体请求超时时间为 120 秒；超时或网络错误返回 `success=false`。
-4. 响应中 `data` 字段由扣子工作流返回（JSON 字符串），解析后提取 `article_xlsx`、`article_zip`、`message`、`success`；工作流执行失败（`code!=0`）或数据解析失败时返回失败。
-5. 返回的为文件下载链接，调用方自行下载；链接有效期取决于扣子/存储侧配置。

package/api_docs/generate_image.md

@@ -1,68 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/generate_image`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-调用火山引擎 Ark Seedream 文生图模型生成 AI 图片，支持 doubao-seedream-4.5/5.0、2K/4K 分辨率与多种宽高比。按实际生成张数计费，单价以 api_services 表配置为准（服务码 `Generate_Image`）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| prompt | string | 是 | - | 图片生成提示词 |
-| model | string | 否 | `"doubao-seedream-5-0-260128"` | 模型名，仅支持 `doubao-seedream-5-0-260128` / `doubao-seedream-4-5-251128` |
-| resolution | string | 否 | `"2K"` | 分辨率，仅支持 `2K`/`4K` |
-| aspect_ratio | string | 否 | `"1:1"` | 宽高比，可选 `1:1`/`4:3`/`3:4`/`16:9`/`9:16`/`3:2`/`2:3`/`21:9` |
-| image | array | 否 | `None` | 参考图 URL 列表（1-14 张，用于图生图） |
-| watermark | boolean | 否 | `false` | 是否添加水印 |
-| response_format | string | 否 | `"url"` | 返回格式：`url` 或 `b64_json` |
-| sequential_image_generation | string | 否 | `"disabled"` | `disabled`=单图，`auto`=组图 |
-| max_images | integer | 否 | `15` | 组图模式最大图片数（1-15，仅 `auto` 时生效） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| images | array | 生成的图片列表 |
-| images[].url | string | 图片 URL（已转存至 OSS temporary 目录） |
-| images[].b64_json | string | base64 图片数据（仅 `response_format=b64_json` 时返回） |
-| images[].size | string | 图片尺寸（若有） |
-| model | string | 实际使用的模型名 |
-| created | integer | 生成时间戳 |
-| usage | object | 用量信息（来自 Ark 响应） |
-| billing | object | 计费信息 |
-| billing.service_fee | float | 本次总费用（单价 × 生成张数） |
-| billing.discount_applied | boolean | 是否应用折扣（恒为 true） |
-| billing.balance_before | float | 扣费前余额 |
-| billing.balance_after | float | 扣费后余额 |
-| billing.currency | string | 货币单位，固定 `CNY` |
-| billing.transaction_id | int/null | 交易 ID |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/generate_image" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "prompt": "一只在樱花树下打盹的橘猫，宫崎骏风格",
-    "model": "doubao-seedream-5-0-260128",
-    "resolution": "2K",
-    "aspect_ratio": "16:9",
-    "watermark": false,
-    "response_format": "url"
-  }'
-```
-
-## 注意事项
-1. 模型、分辨率、宽高比需匹配，非法值直接返回 `success=false`（错误信息会列出支持的选项）。
-2. `image` 参考图数量不能超过 14 张；组图模式下 `max_images` 取值 1-15。
-3. 单价由 `api_services` 表（服务码 `Generate_Image`）读取，按生成张数计费；`discount_applied` 恒为 `true`。
-4. 若 `余额 < 单张费用` 则直接返回 `success=false` 且不扣费；若余额足以支付单张但不足以支付全部，则正常生成并按 `min(应扣费用, 余额)` 实际扣减（仍返回 `success=true`）。
-5. 生成的图片 URL 为 Ark 原链（24h 有效），插件已自动转存至 OSS `temporary/` 目录以长期可用。