aiconductor-cli 1.5.1 → 1.7.0

package/api_docs/aic_web_search.md

@@ -1,84 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/aic_web_search`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-
-## 功能说明
-基于火山引擎融合信息搜索，支持网页搜索和图片搜索，按次计费（0.03元/次）。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| api_key | string | 是 | - | 计费系统API密钥 |
-| query | string | 是 | - | 搜索关键词，1~100字符 |
-| search_type | string | 是 | - | 搜索类型：`web`（网页搜索）/ `image`（图片搜索） |
-| count | integer | 否 | 5 | 返回条数。web最多50，image最多5 |
-| time_range | string | 否 | - | 时间范围过滤，可选值见下方说明 |
-| need_summary | boolean | 否 | true | 是否返回摘要（仅web类型有效） |
-| content_formats | string | 否 | Text | 内容格式：`Text` / `Markdown` |
-
-### time_range 可选值
-
-| 值 | 说明 |
-|----|------|
-| OneDay | 最近一天 |
-| OneWeek | 最近一周 |
-| OneMonth | 最近一月 |
-| OneYear | 最近一年 |
-| YYYY-MM-DD..YYYY-MM-DD | 自定义日期区间，如 `2025-01-01..2025-04-18` |
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | object | 搜索结果数据 |
-| data.ResultCount | integer | 结果数量 |
-| data.TimeCost | integer | 搜索耗时（毫秒） |
-| data.WebResults | array | 网页搜索结果（search_type=web时） |
-| data.WebResults[].SortId | integer | 排序序号 |
-| data.WebResults[].Title | string | 页面标题 |
-| data.WebResults[].SiteName | string | 站点名称 |
-| data.WebResults[].Url | string | 页面链接 |
-| data.WebResults[].Snippet | string | 摘要片段 |
-| data.WebResults[].Summary | string | 内容摘要（需need_summary=true） |
-| data.WebResults[].Content | string | 页面正文内容 |
-| data.WebResults[].PublishTime | string | 发布时间 |
-| data.WebResults[].RankScore | float | 相关度评分 |
-| data.ImageResults | array | 图片搜索结果（search_type=image时） |
-| data.ImageResults[].SortId | integer | 排序序号 |
-| data.ImageResults[].Title | string | 图片标题 |
-| data.ImageResults[].SiteName | string | 来源站点 |
-| data.ImageResults[].Url | string | 来源页面链接 |
-| data.ImageResults[].Image.Url | string | 图片直链 |
-| data.ImageResults[].Image.Width | integer | 图片宽度（px） |
-| data.ImageResults[].Image.Height | integer | 图片高度（px） |
-| 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/aic_web_search" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "api_key": "your_api_key_here",
-    "query": "北京今日天气",
-    "search_type": "web",
-    "count": 5,
-    "need_summary": true
-  }'
-```
-
-## 注意事项
-1. query为必填参数，长度1~100字符
-2. search_type只支持web和image两种类型
-3. need_summary仅对web搜索有效
-4. 搜索失败不扣费，仅成功时计费

package/api_docs/audio_converter.md

@@ -1,51 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/audio_converter`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将视频 URL 转换为音频文件，支持多种输出格式（默认 mp3），包含 API 密钥验证与按秒计费（基础费率 × 音频时长秒数，向上取整），具体费率以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| video_url | string | 是 | - | 待转换的视频文件 URL |
-| output_format | string | 否 | mp3 | 输出音频格式，如 mp3、wav 等 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | object | 转换结果数据 |
-| data.duration | number | 音频时长（秒） |
-| data.* | any | 转换后音频文件信息（URL 等），结构取决于底层转换服务 |
-| 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/audio_converter" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"video_url": "https://example.com/video.mp4", "output_format": "mp3"}'
-```
-
-## 注意事项
-1. 采用后扣费模式：转换失败、API 密钥无效、余额不足以外的其他异常均不扣费（service_fee 为 0）。
-2. 费用 = 基础费率 × 音频时长（向上取整秒数）；余额不足时返回失败且预置计费信息（discount_applied 为 true 但 transaction_id 为 null）。
-3. API 密钥无效或无权限时返回对应错误且不计费。
-4. data 字段具体结构依赖底层音频转换服务，duration 为可靠返回字段。

package/api_docs/balance_query.md

@@ -1,38 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/balance_query`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-通过 API 密钥查询当前账户余额。查询功能，不计费。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| （无业务参数） | - | - | - | 仅需通过请求头鉴权，无需业务参数 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| balance | float | 账户余额 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/balance_query" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{}'
-```
-
-## 注意事项
-1. 仅依赖请求头中的 `api_key` 鉴权，无需任何业务参数。
-2. API 密钥无效返回 `success=false` 且 `balance=0`；账户被禁用（status≠1）同样返回 `success=false`。
-3. 该接口为只读查询，不触发任何扣费或交易记录。

package/api_docs/bing_search.md

@@ -1,55 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/bing_search`
-- **方法**: `POST`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-通过 Coze 工作流调用 Bing 搜索 API，支持关键词搜索、结果数量、时间范围和偏移量参数，包含 API 密钥验证与按次计费，费用以 api_services 表配置为准。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| query | string | 是 | - | 搜索关键词 |
-| count | int | 否 | 10 | 返回结果数量，范围 1~50 |
-| freshness | string | 否 | 空字符串 | 时间范围，格式 YYYY-MM-DD..YYYY-MM-DD |
-| offset | int | 否 | 0 | 结果偏移量 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| data | object | 搜索结果数据 |
-| data.results | array | 搜索结果列表 |
-| data.results[].name | string | 结果标题 |
-| data.results[].url | string | 结果链接 |
-| data.results[].snippet | 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.error | string | 错误描述（失败时返回，成功时无此字段） |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/bing_search" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"query": "人工智能 最新进展", "count": 10, "freshness": "2024-01-01..2024-12-31", "offset": 0}'
-```
-
-## 注意事项
-1. 采用后扣费模式：搜索失败、参数错误、余额不足、上游异常均不扣费（service_fee 为 0）。
-2. query 为必填；count 须在 1~50 之间，否则返回参数错误且不扣费。
-3. 上游 Coze 工作流请求超时 60 秒，超时视为服务异常且不扣费。
-4. 按次计费：搜索成功即扣费。
-5. billing.error 仅在失败分支返回，用于说明失败原因。

package/api_docs/china_stock_data.md

@@ -1,221 +0,0 @@
-# 中国股票数据 API 文档（统一 params 结构）
-
-- **Base URL**：`https://plugin.aiconductor.fun`
-- **统一入口**：`POST /api/china_stock_data`
-- **请求结构**：
-
-```json
-{
-  "api_key": "",
-  "tool_name": "",
-  "params": {}
-}
-```
-
-- **示例股票**：贵州茅台 `600519`
-
-## output_format（点到即可）
-
-多数工具支持 `params.output_format` 指定输出格式：`json | markdown | csv | html | xml | excel`，不传通常默认 `markdown`。
-
----
-
-## 通用 curl 模板
-
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' \
-  -H 'Content-Type: application/json' \
-  -d '{
-    "api_key": "sk_ece2677ec2137c37bab9df9f56a2b2",
-    "tool_name": "<TOOL_NAME>",
-    "params": {
-      
-    }
-  }'
-```
-
----
-
-## 接口列表（30 个 tool_name）
-
-下面每个“接口”都给一个可直接用的 curl 示例（统一用 `600519`）。
-
-### 1) get_time_info（时间信息）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_time_info","params":{}}'
-```
-
-### 2) get_realtime_data（实时行情）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_realtime_data","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 3) get_hist_data（历史行情）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_hist_data","params":{"symbol":"600519","interval":"day","interval_multiplier":1,"start_date":"2026-01-01","end_date":"2026-03-18","adjust":"none","indicators_list":null,"output_format":"json"}}'
-```
-
-### 4) get_news_data（相关新闻）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_news_data","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 5) get_stock_basic_info（股票概要）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_basic_info","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 6) get_financial_metrics（关键财务指标）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_financial_metrics","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 7) get_balance_sheet（资产负债表）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_balance_sheet","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 8) get_income_statement（利润表）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_income_statement","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 9) get_cash_flow（现金流量表）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cash_flow","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 10) get_fund_flow（资金流向）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_fund_flow","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 11) get_inner_trade_data（内部股东交易）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_inner_trade_data","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 12) get_investor_sentiment（投资情绪）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_investor_sentiment","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 13) get_shareholder_info（股东情况）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_shareholder_info","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 14) get_product_info（主营构成/产品情况）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_product_info","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 15) get_profit_forecast（业绩预测）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_profit_forecast","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 16) get_stock_fhps_detail（分红送股详情）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_fhps_detail","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 17) get_stock_cyq（筹码分布）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_cyq","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 18) get_stock_research_report（研究报告）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_research_report","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 19) get_stock_circulate_stock_holder（流通股东）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_circulate_stock_holder","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 20) get_stock_management_change（高管变动）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_management_change","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 21) get_stock_restricted_release_queue（限售解禁）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_restricted_release_queue","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 22) get_stock_value（估值/价值指标）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_value","params":{"symbol":"600519","output_format":"json"}}'
-```
-
-### 23) get_macro_data（宏观指标）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_macro_data","params":{"indicator":"gdp","output_format":"json"}}'
-```
-
-### 24) get_stock_a_code_name（A股代码-名称表）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_a_code_name","params":{"output_format":"json"}}'
-```
-
-### 25) get_stock_technical_rank（技术形态榜单）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_technical_rank","params":{"indicator_name":"连续上涨","output_format":"json"}}'
-```
-
-### 26) get_stock_board_industry_summary（板块行业概览）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_board_industry_summary","params":{"output_format":"json"}}'
-```
-
-### 27) get_all_cni_indices（全部中证指数列表）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_all_cni_indices","params":{"output_format":"json"}}'
-```
-
-### 28) get_cni_index_hist（中证指数历史）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cni_index_hist","params":{"symbol":"399300","start_date":"20260101","end_date":"20260318","output_format":"json"}}'
-```
-
-### 29) get_cni_index_detail（中证指数成分）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cni_index_detail","params":{"symbol":"399300","date":"202603","output_format":"json"}}'
-```
-
-### 30) get_stock_volatility（分钟级波动率）
-```bash
-curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
-  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_volatility","params":{"symbol":"600519","start_date":"2026-03-18 09:30:00","end_date":"2026-03-18 15:00:00","period":"1","adjust":"none","output_format":"json"}}'
-```

package/api_docs/delete_published_webpage.md

@@ -1,38 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/delete_published_webpage`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-删除当前用户指定的已发布网页，同时删除 OSS 上的 HTML 对象使公开链接失效，免费。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| webpage_id | integer | 是 | - | 已发布网页的记录 ID，从网页列表接口的 `webpages[].id` 获取 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功 |
-| message | string | 响应消息 |
-| webpage_id | integer / null | 删除成功时返回已删除的记录 ID；失败时为 null |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/delete_published_webpage" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{"webpage_id": 123}'
-```
-
-## 注意事项
-1. 只能删除当前 API 密钥所属用户的记录；不存在或无权的记录会返回同一提示。
-2. 删除会同时移除 OSS 对象，原公开链接将无法再访问。
-3. OSS 删除或数据库删除失败时，接口会返回失败，可重试。

package/api_docs/doubao_search.md

@@ -1,80 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/doubao_search`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-豆包搜索 Custom 版，支持网页与图片搜索，套餐密钥优先；套餐不可用时自动切换按量密钥。按次计费，当前基础价格为0.02元/次，业务成功后扣费。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| query | string | 是 | - | 搜索关键词，1~100字符。 |
-| search_type | string | 是 | - | 搜索类型：`web`（网页）或 `image`（图片）。 |
-| count | integer | 否 | web为`10`，image为`5` | 返回条数；web范围为1~50，image范围为1~5。 |
-| query_rewrite | boolean | 否 | `false` | 是否开启 Query 改写。 |
-| need_content | boolean | 否 | `false` | 仅web：是否仅返回包含正文的结果。 |
-| need_url | boolean | 否 | `false` | 仅web：是否仅返回带原文链接的结果。 |
-| sites | string | 否 | - | 仅web：限定搜索站点，完整域名以`\|`分隔，最多20个。 |
-| block_hosts | string | 否 | - | 仅web：屏蔽站点，完整域名以`\|`分隔，最多5个。 |
-| auth_info_level | integer | 否 | `0` | 仅web：权威度过滤，`0`不限制，`1`仅非常权威内容。 |
-| time_range | string | 否 | - | 仅web：`OneDay`、`OneWeek`、`OneMonth`、`OneYear`，或`YYYY-MM-DD..YYYY-MM-DD`。 |
-| content_formats | string | 否 | `text` | 仅web：正文格式，`text`或`markdown`。 |
-| industry | string | 否 | - | 仅web：行业搜索类型，`finance`、`game`或`gov`。 |
-| image_width_min | integer | 否 | - | 仅image：图片最小宽度，不能大于`image_width_max`。 |
-| image_width_max | integer | 否 | - | 仅image：图片最大宽度。 |
-| image_height_min | integer | 否 | - | 仅image：图片最小高度，不能大于`image_height_max`。 |
-| image_height_max | integer | 否 | - | 仅image：图片最大高度。 |
-| image_shapes | array&lt;string&gt; / string | 否 | - | 仅image：允许的形状：`横长方形`、`竖长方形`、`方形`。POST传数组；GET以`\|`分隔。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| data | object | 原样保留的豆包上游完整响应。 |
-| data.ResponseMetadata | object | 上游元信息，包含`RequestId`；上游业务失败时包含`Error`。 |
-| data.ResponseMetadata.Error.Code | string | 上游错误码。 |
-| data.ResponseMetadata.Error.Message | string | 上游错误说明。 |
-| data.Result | object | 搜索结果；上游业务失败时为`null`。 |
-| data.Result.ResultCount | integer | 搜索结果数量。 |
-| data.Result.WebResults | array | 网页结果列表，仅`search_type=web`返回。 |
-| data.Result.ImageResults | array | 图片结果列表，仅`search_type=image`返回。 |
-| data.Result.SearchContext | object | 搜索上下文，包含原始关键词与搜索类型。 |
-| data.Result.TimeCost | integer | 上游搜索耗时，单位毫秒。 |
-| data.Result.LogId | string | 上游日志ID。 |
-| 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`。 |
-| billing.error | string | 失败原因；成功时为`null`。 |
-
-## 请求示例
-
-```bash
-curl -X POST "http://plugin.aiconductor.fun/api/doubao_search" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "query": "最新的北京游玩攻略",
-    "search_type": "web",
-    "count": 10,
-    "need_url": true,
-    "time_range": "OneYear",
-    "content_formats": "markdown"
-  }'
-```
-
-## 注意事项
-1. 搜索成功后才扣费；参数校验失败、上游业务错误、网络错误和余额不足均不会扣费。
-2. 服务优先使用`BYTED_WEB_SEARCH_SUBSCRIPTION_API_KEY`；仅上游返回套餐不支持、套餐不可用或套餐额度耗尽（10409、10410、10412）时，才自动切换`BYTED_WEB_SEARCH_POSTPAID_API_KEY`。
-3. 套餐与按量密钥均未配置时接口会返回服务异常；密钥只应配置在服务端`.env`中，不得由调用方传入。
-4. `data`为上游完整响应，请按`data.Result.WebResults`或`data.Result.ImageResults`读取结果。

package/api_docs/douyin_link_to_text_v1.md

@@ -1,50 +0,0 @@
-## 接口信息
-- **URL**: `http://plugin.aiconductor.fun/api/douyin_link_to_text_v1`
-- **方法**: `POST` / `GET`
-- **Content-Type**: `application/json`
-- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
-
-## 功能说明
-将抖音视频链接转换为文字（语音转写）。按次计费，费用以 api_services 表配置为准：含下载解析费（服务码 `Get_Download_Url`）+ 转写费（服务码 `douyin_link_to_text_v1`，转写费 = 基础费率 × 视频时长秒数向上取整）。仅转写成功才计转写费；时长超过 20 分钟会失败。
-
-## 请求参数
-
-| 参数名 | 类型 | 必填 | 默认值 | 说明 |
-|--------|------|------|--------|------|
-| video_url | string | 是 | - | 抖音视频分享链接或包含链接的文本。 |
-
-> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
-
-## 响应参数
-
-| 参数名 | 类型 | 说明 |
-|--------|------|------|
-| success | boolean | 是否成功。 |
-| message | string | 响应消息。 |
-| text | string | 转写得到的文本；失败时为固定值 `文字提取失败`。 |
-| billing | object | 计费信息。 |
-| billing.service_fee | float | 本次总扣费（下载费 + 转写费）。 |
-| billing.base_fee | float | 转写基础费率（仅在转写成功时出现）。 |
-| billing.duration_seconds | integer | 计费时长秒数（向上取整，仅转写成功时出现）。 |
-| 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_link_to_text_v1" \
-  -H "Authorization: Bearer your_api_key" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "video_url": "https://v.douyin.com/xxxxxxxx/"
-  }'
-```
-
-## 注意事项
-1. 先校验 API 密钥与余额（最低需 0.02 元），解析链接与下载失败不扣费；仅下载成功扣下载费，仅转写成功再扣转写费。
-2. 视频时长 ≤5 分钟走 Coze STT；5~20 分钟走阿里云 STT；超过 20 分钟直接返回失败，不扣费。
-3. 转写失败（如准确度不达标、上游异常）仅扣除已产生的下载费，不再扣转写费。
-4. 返回的 `text` 在失败分支固定为字符串 `文字提取失败`。