aiconductor-cli 1.6.0 → 1.8.0

package/api_docs/transaction_query.md

@@ -1,52 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/users/transaction_query`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-根据 API 密钥查询当前账户的消费/充值记录，支持类型、时间范围筛选、排序与分页（每页 20 条）。本插件仅校验密钥、不计费（无 billing）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| page | int | 否 | 1 | 页码（从 1 开始） |
-| type | string | 否 | "" | 交易类型筛选：`consume`（消费）/ `recharge`（充值），为空则不筛选 |
-| start_date | string | 否 | "" | 起始日期，格式 `YYYY-MM-DD` |
-| end_date | string | 否 | "" | 结束日期，格式 `YYYY-MM-DD` |
-| order | string | 否 | "desc" | 排序方向：`asc`（升序）/ `desc`（降序） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | array[object] | 交易记录列表（见下） |
-| pagination | object | 分页信息（见下） |
-| summary | object | 金额汇总（见下） |
-
-`data[]` 字段：`id`(int)、`service_code`(string)、`amount`(float)、`balance_after`(float)、`type`(string, consume/recharge)、`notes`(string)、`created_at`(string, `YYYY-MM-DD HH:MM:SS`)。
-
-`pagination` 字段：`page`(int)、`page_size`(int, 固定 20)、`total`(int)、`total_pages`(int)。
-
-`summary` 字段：`total_consume`(float, 消费总额)、`total_recharge`(float, 充值总额)。
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/users/transaction_query" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"page": 1, "type": "consume", "start_date": "2026-07-01", "end_date": "2026-07-29", "order": "desc"}'
-```
-
-## 注意事项
-1. 本插件仅校验 api_key 并查询其对应账户记录，不扣费（无 billing 字段）。
-2. 参数校验：`page < 1`、`type` 非 consume/recharge、`order` 非 asc/desc 均返回失败。
-3. 筛选 `start_date`/`end_date` 自动补全为当日 `00:00:00` ~ `23:59:59`。
-4. `summary` 汇总金额针对全部匹配记录（不限当前页）；`page` 超出 `total_pages` 时返回失败。
-5. 失败情况（密钥无效、账户禁用、参数错误、服务异常）均返回空 data 与零值分页/汇总。

package/api_docs/url_to_markdown.md

@@ -1,50 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/url_to_markdown`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将网页 URL 转换为干净的 Markdown 格式文本（使用 defuddle-proxy 服务）。按次计费，费用以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| url | string | 是 | - | 要转换的网页 URL（必须以 http:// 或 https:// 开头） |
-| timeout | int | 否 | 30 | 请求超时时间（秒） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| markdown | string | 转换后的 Markdown 内容（失败时为 ""） |
-| 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 | 交易流水号（未扣费时为 null） |
-| billing.error | string | 错误信息（仅失败响应的 billing 中可能出现） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/url_to_markdown" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "url": "https://example.com/article",
-    "timeout": 30
-  }'
-```
-
-## 注意事项
-1. 采用后扣费模式：仅当成功取得非空 Markdown 内容后才记录交易并扣费；下游返回 400/500、内容为空或请求超时时返回失败且不扣费。
-2. URL 格式无效（非 http/https 开头）、余额不足、API 密钥无效、账户禁用时不扣费。
-3. 请求下游服务的超时时间由 `timeout` 参数控制（连接阶段固定 10 秒）。

package/api_docs/video_download_url.md

@@ -1,57 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/video_download_url`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-解析视频链接并获取无水印下载地址，支持抖音、快手等多个平台，提供视频信息与下载链接，包含 API 密钥验证与按次计费，费用以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| video_url | string | 是 | - | 视频链接 URL（支持从分享文本中提取链接，保留 URL 参数） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息（成功/失败原因） |
-| source | string | 视频来源平台（如 douyin） |
-| author | string | 视频作者 |
-| title | string | 视频标题 |
-| thumbnail | string | 视频缩略图 URL |
-| duration | number | 视频时长（毫秒） |
-| medias | array | 媒体文件列表 |
-| medias[].url | string | 媒体文件下载地址 |
-| medias[].type | string | 媒体类型（video / audio） |
-| medias[].quality | string | 质量标识（如 No Watermark / Audio） |
-| medias[].extension | string | 文件扩展名（如 mp4 / mp3） |
-| medias[].data_size | number | 文件大小（备用方案无法获取时为 0） |
-| medias[].duration | number | 音频时长（秒，仅音频类型返回） |
-| billing | object | 计费信息 |
-| billing.service_fee | number | 本次服务费用 |
-| billing.discount_applied | boolean | 是否应用折扣/计费 |
-| billing.balance_before | number | 扣费前余额 |
-| billing.balance_after | number | 扣费后余额 |
-| billing.currency | string | 货币单位（CNY） |
-| billing.transaction_id | string | 交易流水号（失败为 null） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/video_download_url" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"video_url": "https://v.douyin.com/xxxx/"}'
-```
-
-## 注意事项
-1. 采用后扣费模式：解析失败（主方案失败且抖音备用方案也失败、非抖音域名）均不扣费（service_fee 为 0）。
-2. 抖音域名主方案失败时自动尝试抖音备用解析方案（parse_douyin_video），备用方案成功同样计费并返回无水印视频与音频。
-3. 按次计费：解析成功即扣费，与返回媒体数量无关。
-4. medias 中音频类型会额外返回 duration 字段；备用方案返回的媒体 data_size 为 0。

package/api_docs/video_download_url_oss.md

@@ -1,55 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/video_download_url_oss`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-解析视频链接获取无水印下载地址，将无水印视频文件下载并上传至用户指定的阿里云 OSS，返回单个 OSS 链接。仅保留 quality=no_watermark 的视频，支持抖音、快手等多平台，包含 API 密钥验证与按次计费，费用以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| video_url | string | 是 | - | 视频链接 URL（支持从分享文本中提取链接，保留 URL 参数） |
-| OSS_ACCESS_KEY_ID | string | 是 | - | 用户阿里云 OSS 的 AccessKeyId |
-| OSS_ACCESS_KEY_SECRET | string | 是 | - | 用户阿里云 OSS 的 AccessKeySecret |
-| OSS_ENDPOINT | string | 是 | - | 用户阿里云 OSS 的 Endpoint（如 oss-cn-hangzhou.aliyuncs.com） |
-| OSS_BUCKET_NAME | string | 是 | - | 用户阿里云 OSS 的 Bucket 名称 |
-| oss_directory | string | 否 | temporary | OSS 中的存储目录 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| source | string | 视频来源平台（如 douyin） |
-| author | string | 视频作者 |
-| title | string | 视频标题 |
-| video_url_oss | string | 上传至 OSS 后的无水印视频链接 |
-| billing | object | 计费信息 |
-| billing.service_fee | number | 本次服务费用 |
-| billing.discount_applied | boolean | 是否应用折扣/计费 |
-| billing.balance_before | number | 扣费前余额 |
-| billing.balance_after | number | 扣费后余额 |
-| billing.currency | string | 货币单位（CNY） |
-| billing.transaction_id | string | 交易流水号（失败为 null） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/video_download_url_oss" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"video_url": "https://v.douyin.com/xxxx/", "OSS_ACCESS_KEY_ID": "your_ak", "OSS_ACCESS_KEY_SECRET": "your_sk", "OSS_ENDPOINT": "oss-cn-hangzhou.aliyuncs.com", "OSS_BUCKET_NAME": "my-bucket", "oss_directory": "temporary"}'
-```
-
-## 注意事项
-1. 仅保留 type=video 且 quality=no_watermark 的媒资，未找到则失败且不扣费。
-2. 采用后扣费模式：解析失败、OSS 配置错误、上传失败均不扣费（service_fee 为 0）。
-3. OSS 凭证由调用方自行提供，平台仅做上传不托管密钥；OSS 配置错误会返回明确错误。
-4. 下载并上传至 OSS 的超时时间为 300 秒；上传失败（如下载异常、OSS 写入失败）返回失败且不扣费。
-5. 按次计费：上传成功即扣费。

package/api_docs/video_to_text.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/video_to_text`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将视频文件 URL 转换为文字，使用 DashScope API 进行语音识别转写，包含 API 密钥验证与按秒计费（基础费率 × 视频时长秒数，向上取整），具体费率以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| file_url | string | 是 | - | 待转写的视频文件 URL |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息（成功/失败原因） |
-| text | string | 转写文本结果 |
-| billing | object | 计费信息 |
-| billing.service_fee | number | 本次服务费用 |
-| billing.discount_applied | boolean | 是否应用折扣/计费 |
-| billing.balance_before | number | 扣费前余额 |
-| billing.balance_after | number | 扣费后余额 |
-| billing.currency | string | 货币单位（CNY） |
-| billing.transaction_id | string | 交易流水号（失败为 null） |
-| billing.base_fee | number | 基础费率（成功及余额不足分支返回） |
-| billing.duration_seconds | number | 计费时长（秒，向上取整，成功及余额不足分支返回） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/video_to_text" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"file_url": "https://example.com/video.mp4"}'
-```
-
-## 注意事项
-1. 视频时长超过 20 分钟将被拒绝转写并返回失败，不计费。
-2. 采用后扣费模式：转写失败、无法获取时长、密钥无效等异常均不扣费（service_fee 为 0）。
-3. 单次转写超时约 55 秒，超时视为失败且不扣费。
-4. 费用 = 基础费率 × 视频时长（向上取整秒数）；余额不足时返回失败且预置计费信息（transaction_id 为 null）。

package/api_docs/video_to_text_v2.md

@@ -1,49 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/video_to_text_v2`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将视频文件 URL 转换为文字。长视频（>5 分钟的非 MP3 文件）直接使用阿里云 STT 转写，短视频和 MP3 使用 Coze STT 转写，包含 API 密钥验证与按秒计费（基础费率 × 实际转写时长，四舍五入至少 1 秒），具体费率以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| file_url | string | 是 | - | 待转写的视频文件 URL |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息（成功/失败原因） |
-| text | string | 转写文本结果 |
-| billing | object | 计费信息 |
-| billing.service_fee | number | 本次服务费用 |
-| billing.discount_applied | boolean | 是否应用折扣/计费 |
-| billing.balance_before | number | 扣费前余额 |
-| billing.balance_after | number | 扣费后余额 |
-| billing.currency | string | 货币单位（CNY） |
-| billing.transaction_id | string | 交易流水号（失败为 null） |
-| billing.base_fee | number | 基础费率（成功及余额不足分支返回） |
-| billing.duration_seconds | number | 计费时长（秒，四舍五入，成功及余额不足分支返回） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/video_to_text_v2" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"file_url": "https://example.com/video.mp4"}'
-```
-
-## 注意事项
-1. 视频时长超过 20 分钟将被拒绝转写并返回失败，不计费。
-2. 余额 ≤ 0 将直接返回失败且不计费（额外校验）。
-3. 路由策略：>5 分钟且非 mp3 用阿里云 STT；其余（≤5 分钟视频或 mp3）用 Coze STT。
-4. 采用后扣费模式：转写失败、未获取到文本、密钥无效等异常均不扣费（service_fee 为 0）。
-5. 费用 = 基础费率 × 实际转写时长（四舍五入，至少 1 秒）；余额不足时返回失败且预置计费信息（transaction_id 为 null）。

package/api_docs/volcengine_face_pretty.md

@@ -1,55 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/volcengine_face_pretty`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-调用火山引擎智能变美（FacePretty）接口进行人脸美颜。本插件在平台侧不执行计费（handler 未调用计费模块），仅消耗调用方提供的火山引擎 AccessKey 配额。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| access_key_id | string | 是 | - | 火山引擎 AccessKeyId |
-| secret_access_key | string | 是 | - | 火山引擎 SecretAccessKey |
-| image_url | string | 是 | - | 待处理图片 URL |
-| region | string | 否 | `"cn-north-1"` | 火山引擎服务区域 |
-| do_risk | boolean | 否 | `false` | 是否需要内容安全审核 |
-| multi_face | string | 否 | `"0"` | 多人脸策略：`"1"` 处理所有人脸，其他值仅处理最大人脸 |
-| beauty_level | float | 否 | `1.0` | 美颜程度，范围 0.0-1.0，值越大越明显 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| image_url | string | 处理后图片 URL（已转存至 OSS 临时目录），失败时为空字符串 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/volcengine_face_pretty" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "access_key_id": "你的火山引擎AK",
-    "secret_access_key": "你的火山引擎SK",
-    "image_url": "https://example.com/portrait.jpg",
-    "beauty_level": 0.8,
-    "multi_face": "0",
-    "do_risk": false,
-    "region": "cn-north-1"
-  }'
-```
-
-## 注意事项
-1. 需调用方自备有效的火山引擎 AccessKey，平台侧不校验、不托管该密钥。
-2. `image_url` 为必填，缺失直接返回 `success=false`。
-3. `beauty_level` 取值 0.0-1.0；`multi_face="1"` 时处理图中所有人脸。
-4. 火山引擎接口失败时会自动重试最多 10 次；全部失败返回 `success=false`。
-5. 处理后的图片由插件转存至阿里云 OSS 临时目录并返回 URL，原响应为 base64 时也会上传。
-6. 平台侧不扣费，仅消耗火山引擎侧配额。

package/api_docs/volcengine_faceswap.md

@@ -1,55 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/volcengine_faceswap`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-调用火山引擎 CVProcess（face_swap3_6）接口进行人脸融合（换脸）。本插件在平台侧不执行计费（handler 未调用计费模块），仅消耗调用方自行提供的火山引擎 AccessKey 配额。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| access_key_id | string | 是 | - | 火山引擎 AccessKeyId |
-| secret_access_key | string | 是 | - | 火山引擎 SecretAccessKey |
-| source_image | string | 是 | - | 源图 URL（被替换的人脸图） |
-| template_image | string | 是 | - | 模板图 URL（目标人脸图） |
-| face_type | string | 否 | `"area"` | 换脸类型：`l2r`/`t2b`/`area`，非法值自动回退为 `area` |
-| source_similarity | float | 否 | `1.0` | 源脸相似度，范围 0-1；无法转为 float 时回退 1.0 |
-| ref_img_url | string | 否 | `None` | 参考图 URL（可选，用于增强） |
-| region | string | 否 | `"cn-north-1"` | 火山引擎服务区域 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| image_url | string | 融合后的图片 URL，失败时为空字符串 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/volcengine_faceswap" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "access_key_id": "你的火山引擎AK",
-    "secret_access_key": "你的火山引擎SK",
-    "source_image": "https://example.com/face.jpg",
-    "template_image": "https://example.com/template.jpg",
-    "face_type": "area",
-    "source_similarity": 1.0,
-    "region": "cn-north-1"
-  }'
-```
-
-## 注意事项
-1. 需调用方自备有效的火山引擎 AccessKey，平台侧不校验、不托管该密钥。
-2. `face_type` 仅接受 `l2r`/`t2b`/`area`，其余值自动回退为 `area`。
-3. `source_similarity` 传入非法值时回退为 `1.0`，不会报错。
-4. 火山引擎接口失败时会自动重试，最多重试 10 次；全部失败返回 `success=false`。
-5. 平台侧不扣费，仅消耗火山引擎侧的调用配额。

package/api_docs/website_screenshot.md

@@ -1,49 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/website_screenshot`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-对指定网站进行截图并返回截图 URL，支持自定义截图宽度与加载延迟，包含 API 密钥验证与按次计费，费用以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| url | string | 是 | - | 要截图的网站 URL（须以 http:// 或 https:// 开头） |
-| delay_seconds | int | 否 | 1 | 页面加载后的延迟秒数 |
-| width | int | 否 | 1920 | 截图宽度（像素） |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| screenshot_url | string | 生成的截图文件 URL |
-| file_name | string | 截图文件名 |
-| billing | object | 计费信息 |
-| billing.service_fee | number | 本次服务费用 |
-| billing.discount_applied | boolean | 是否应用折扣/计费 |
-| billing.balance_before | number | 扣费前余额 |
-| billing.balance_after | number | 扣费后余额 |
-| billing.currency | string | 货币单位（CNY） |
-| billing.transaction_id | string | 交易流水号（失败为 null） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/website_screenshot" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"url": "https://example.com", "delay_seconds": 2, "width": 1920}'
-```
-
-## 注意事项
-1. 采用后扣费模式：截图生成失败、URL 格式无效、请求异常均不扣费（service_fee 为 0）。
-2. url 必须以 http:// 或 https:// 开头，否则返回格式错误且不扣费。
-3. 截图服务请求超时 180 秒，超时视为服务异常且不扣费。
-4. 按次计费：截图成功即扣费。

package/api_docs/wx_access_token.md

@@ -1,44 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_access_token`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-获取微信公众号接口调用凭据（Access Token）。仅做 API 密钥有效性校验，**不扣费**，Token 有效期为 7200 秒（由微信返回，需调用方自行缓存）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| appid | string | 是 | - | 微信公众号的 AppID |
-| secret | string | 是 | - | 微信公众号的 AppSecret |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| access_token | string | 获取到的接口调用凭据（失败为空字符串） |
-| expires_in | int | 凭证有效时间，单位：秒（成功时微信返回，一般为 7200；失败为 0） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_access_token" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "appid": "wx1234567890abcdef",
-    "secret": "your_app_secret"
-  }'
-```
-
-## 注意事项
-1. 本接口**不扣费**，仅验证 API 密钥；密钥无效或账户被禁用时返回 `success=false`。
-2. `appid` / `secret` 为公众号后台凭证，请妥善保管，避免泄露。
-3. 微信返回的 `access_token` 全局唯一且有效期 7200 秒，建议调用方缓存复用，避免频繁调用触发频率限制。
-4. 调用微信接口的网络超时时间为 30 秒，超时返回失败提示。

package/api_docs/wx_article_analysis_data_push.md

@@ -1,43 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_article_analysis_data_push`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-微信文章分析数据推送服务（纯扣费/触发接口）。为**计费插件**：每次调用直接扣费一次，费用以 `api_services` 表（`service_code=wx_article_analysis_data_push`）配置为准。
-
-## 请求参数
-
-> 本接口无额外业务参数，仅需 API 密钥鉴权。
-
-> **鉴权参数**：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.transaction_id | int/None | 交易流水 ID（成功时为整数；失败或未扣费时为 `null`） |
-| billing.error | string | 失败分支额外携带的错误说明（仅失败时存在） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_article_analysis_data_push" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{}'
-```
-
-## 注意事项
-1. 本接口为**纯扣费/触发接口**，每次成功调用即扣费一次，用于触发后续的微信文章分析数据推送流程。
-2. **不扣费场景**：API 密钥无效、账户被禁用、余额不足、服务异常——此时 `transaction_id=null`，余额不变（异常分支 `service_fee=0`）。
-3. 调用方应据 `success` 判断扣费结果；失败分支的 `billing` 中会包含 `error` 字段说明原因。

package/api_docs/wx_article_data.md

@@ -1,48 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/wx_article_data`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-获取指定微信文章的互动数据（阅读、点赞、在看、分享、收藏、评论等）。为**计费插件**：按次计费，费用以 `api_services` 表（`service_code=wx_article_data`）配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| url | string | 是 | - | 微信文章链接 |
-
-> **鉴权参数**：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.transaction_ids | array | 交易流水 ID 列表（成功时为 `[transaction_id]`，未扣费时为空列表 `[]`） |
-| data | object | 文章互动数据（结构取决于第三方数据源，通常含阅读数、点赞数、在看数、分享数、收藏数、评论数等字段；失败时为 `{}`） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/wx_article_data" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "url": "https://mp.weixin.qq.com/s?__biz=xxxx&mid=xxxx&idx=1&sn=xxxx"
-  }'
-```
-
-## 注意事项
-1. 本接口**计费**，仅在成功获取文章数据后扣费一次；`billing.transaction_ids` 为列表。
-2. **不扣费场景**：缺少 `url`、API 密钥无效、账户被禁用、余额不足、第三方 API 返回错误（`code!=0`）、服务异常——上述情况 `transaction_ids` 为空列表且余额不变。
-3. 上游数据服务最多重试 10 次，单次调用整体超时 60 秒。
-4. `data` 字段结构由第三方数据源决定，调用方应做容错处理；异常分支下 `data` 含 `error_details`。

package/api_docs/wx_article_style_rewrite.md

@@ -1,45 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/users/wx_article_style_rewrite`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-异步调用扣子工作流，将微信公众号文章按指定风格改写，返回 task_url 供轮询结果。本插件仅校验密钥、不计费（无 billing）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| coze_token | string | 是 | — | 用户的 Coze API Token |
-| article_url | string | 是 | — | 微信公众号文章链接 |
-| article_style | string | 是 | — | 文章风格，如：招商小话匣 |
-| model | string | 否 | "minimax/minimax-m2.7" | 使用的模型 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功（任务已提交） |
-| message | string | 响应消息（成功时为「任务已提交，请打开result_url查看结果」） |
-| task_id | string | 工作流任务 ID |
-| result_url | string | 结果查看 URL |
-| debug_url | string | 调试 URL |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/users/wx_article_style_rewrite" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"coze_token": "pat_xxxxxxxx", "article_url": "https://mp.weixin.qq.com/s/abcdef", "article_style": "招商小话匣"}'
-```
-
-## 注意事项
-1. 本插件仅校验 api_key 有效性，不扣费（无 billing 字段）。
-2. `coze_token`、`article_url`、`article_style` 均为必填，缺失任一将返回失败。
-3. 为异步任务：提交后通过响应中的 `result_url` 查看改写结果，需自行轮询。
-4. 工作流内部使用固定的飞书多维表格参数与 workflow_id，调用方无需关心。
-5. 校验失败、密钥无效或账户禁用时返回空 task_id/result_url/debug_url。