aiconductor-cli 1.3.3 → 1.3.5

package/api_docs/image_resize.md

@@ -0,0 +1,58 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/image_resize`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+根据尺寸/体积限制对图片等比例缩放并压缩，处理完成后上传至阿里云 OSS。按次计费，费用以 api_services 表配置为准（服务码 `image_resize`）。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| image_url | string | 是 | - | 原始图片链接 |
+| max_width | integer | 否 | `None` | 最大宽度（像素），超出则等比缩放 |
+| max_height | integer | 否 | `None` | 最大高度（像素），超出则等比缩放 |
+| max_MB | float | 否 | `None` | 最大体积（MB），超出则渐进式压缩画质/尺寸 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| processed_url | string | 处理后图片 URL（已上传 OSS），失败/未处理时为原图或空串 |
+| width | integer | 最终宽度（像素），未处理时为 0 |
+| height | integer | 最终高度（像素），未处理时为 0 |
+| size_mb | float | 最终体积（MB），未处理时为 0 |
+| billing | object | 计费信息 |
+| billing.service_fee | float | 本次费用（= base_fee） |
+| billing.base_fee | float | 基础单价（来自 api_services） |
+| billing.discount_applied | boolean | 是否应用折扣（恒为 false） |
+| 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/image_resize" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "image_url": "https://example.com/photo.jpg",
+    "max_width": 1200,
+    "max_MB": 1.5
+  }'
+```
+
+## 注意事项
+1. `max_width`、`max_height`、`max_MB` 三个限制条件均未提供时，直接返回原图信息且不计费、不扣费（`service_fee=0`）。
+2. 余额不足时不扣费，返回 `success=false`。
+3. 透明通道图片（PNG/RGBA）会转换为 RGB 后以 JPEG 保存。
+4. 处理失败（下载/压缩/上传异常）时返回 `success=false`，不计费。
+5. 下载图片超时 15 秒，超限视为失败。

package/api_docs/image_to_permalink.md

@@ -0,0 +1,61 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/image_to_permalink`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+批量将图片上传至阿里云 OSS 并生成永久链接。按成功上传的图片张数计费，单价以 api_services 表配置为准（服务码 `image_to_permalink`）。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| image_urls | array | 是 | - | 图片 URL 列表，单次最多 50 张 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功（全部成功或部分成功均为 true，全部失败为 false） |
+| message | string | 响应消息 |
+| permalink | array | 上传后的永久链接列表，失败项为空字符串 |
+| upload_results | array | 每张图片的上传结果详情 |
+| upload_results[].index | integer | 图片序号（从 1 开始） |
+| upload_results[].original_url | string | 原始图片 URL |
+| upload_results[].permalink | string | 上传后的永久链接，失败为空 |
+| upload_results[].success | boolean | 该张是否上传成功 |
+| upload_results[].file_size | integer | 文件字节数，失败为 0 |
+| upload_results[].message | string | 该张结果说明 |
+| billing | object | 计费信息 |
+| billing.service_fee | float | 实际费用（单价 × 成功张数） |
+| billing.image_count | integer | 成功上传张数 |
+| billing.base_fee_per_image | float | 每张基础单价（来自 api_services） |
+| billing.discount_applied | boolean | 是否应用折扣（成功分支为 true，全失败为 false） |
+| 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/image_to_permalink" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "image_urls": [
+      "https://example.com/a.jpg",
+      "https://example.com/b.png"
+    ]
+  }'
+```
+
+## 注意事项
+1. `image_urls` 不能为空；单次最多 50 张，超出返回 `success=false`。
+2. 单张图片超过 10MB 会被拒绝并计入该张失败；仅支持常见图片格式（jpg/png/gif/webp/heif/heic，HEIF/HEIC 自动转 PNG）。
+3. 仅对成功上传的图片计费；部分成功时 `success=true`，计费按成功张数计算。
+4. 余额不足时不扣费，返回 `success=false`。
+5. 全部上传失败时返回 `success=false` 且不扣费。

package/api_docs/link_expander.md

@@ -0,0 +1,39 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/link_expander`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 本接口无需鉴权（代码中未读取 api_key，无计费）
+
+## 功能说明
+从分享文本中提取链接并解析为原始长链接的插件，无计费。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| share_url | string | 是 | - | 输入的分享内容文本，可包含链接 |
+| timeout | int | 否 | 10 | 请求超时时间（秒） |
+| clean_params | bool | 否 | true | 是否清理 URL 中的参数（true 清理，false 保留） |
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| long_url | string | 解析后的长链接 |
+| raw_url | string | 从分享内容中提取出的原始链接 |
+| message | string | 操作结果信息 |
+| status_code | int | 解析请求的 HTTP 状态码 |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/link_expander" \
+  -H "Content-Type: application/json" \
+  -d '{"share_url": "点击查看 https://t.cn/abc 更多内容", "timeout": 10, "clean_params": true}'
+```
+
+## 注意事项
+1. 本插件无任何鉴权与计费逻辑，调用 free。
+2. 默认清理 URL 参数（clean_params=true）；设为 false 可保留原始参数。
+3. 从分享文本中自动提取首个有效链接后再进行跳转解析；解析失败返回 success=false 并携带 message 与 status_code。

package/api_docs/llm_proxy.md

@@ -0,0 +1,61 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/llm_proxy`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（仅做 API 密钥验证，不扣费）
+
+## 功能说明
+OpenAI 兼容格式的大模型透明代理，支持 SSE 流式输出与 45 秒心跳，模型 ID 自动路由（当前路由 aiconductor/deepseek-v4-pro → DeepSeek API）。仅校验 API 密钥，**不扣费**。
+
+## 请求参数
+遵循 OpenAI `chat/completions` 请求格式：
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| model | string | 是 | - | 模型 ID（如 aiconductor/deepseek-v4-pro） |
+| messages | array | 是 | - | 对话消息列表 |
+| stream | bool | 否 | false | 是否流式输出（true 启用 SSE） |
+| temperature | float | 否 | 0.7 | 采样温度 |
+| max_tokens | int | 否 | 4096 | 最大生成 token 数 |
+| top_p | float | 否 | 1.0 | 核采样概率 |
+| frequency_penalty | float | 否 | 0 | 频率惩罚 |
+| presence_penalty | float | 否 | 0 | 存在惩罚 |
+| stop | array | 否 | null | 停止词序列 |
+| thinking | object | 否 | null | 思考参数 |
+| reasoning_effort | string | 否 | null | 推理强度 |
+| response_format | object | 否 | null | 响应格式（如 JSON 模式） |
+| tools | array | 否 | null | 工具定义 |
+| tool_choice | string | 否 | null | 工具选择策略 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+上游原始响应透传，遵循 OpenAI `chat/completions` 格式：
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| id | string | 响应唯一 ID |
+| object | string | 对象类型（如 chat.completion） |
+| created | int | 创建时间戳 |
+| model | string | 实际使用的模型名 |
+| choices | array | 生成结果列表 |
+| usage | object | token 用量统计 |
+| error | string | 异常时返回（如 "Invalid API key"、"Upstream request failed"） |
+
+> 流式模式（stream=true）下以 SSE 逐块返回 `data: {...}` 事件，结束以 `data: [DONE]` 标记。
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/llm_proxy" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{"model": "aiconductor/deepseek-v4-pro", "messages": [{"role": "user", "content": "你好"}], "stream": false}'
+```
+
+## 注意事项
+1. 仅校验 API 密钥有效性，本接口**不扣费**。
+2. 模型路由：aiconductor/deepseek-v4-pro 映射为 DeepSeek 实际模型 deepseek-v4-pro；未配置上游 API Key 时返回 "Upstream API key not configured"。
+3. model 与 messages 为必填，缺失返回 `{"error": "model and messages are required"}`。
+4. 非流式超时 180 秒，流式（SSE）超时 600 秒；流式每 45 秒发送一次 `: ping` 心跳以保持微信小程序连接。
+5. 响应为上游原始内容透传，完整保留上游的 choices / usage 等字段结构。

package/api_docs/markitdown.md

@@ -0,0 +1,47 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/markitdown`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 本插件无需鉴权（未使用 api_key）
+
+## 功能说明
+使用 Microsoft MarkItDown 库将指定 URL 的文件转换为 Markdown 格式内容。免费接口，无计费。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| file_url | string | 是 | - | 待转换文件的 URL 地址（需为有效 http/https 链接） |
+| timeout | int | 否 | 30 | 文件下载超时时间（秒） |
+| use_llm | boolean | 否 | false | 是否使用 LLM 进行图像描述（当前版本未接入具体 LLM 客户端） |
+
+> **鉴权参数**：本插件不接收 api_key，框架自动注入的 api_key 不会被使用。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| content | string | 转换后的 Markdown 文本内容（失败时为空） |
+| file_name | string | 原始文件名 |
+| file_size | int | 文件大小（字节） |
+| message | string | 成功时的响应消息（仅成功响应包含） |
+| error | string | 错误信息（仅失败响应包含，替代 message） |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/markitdown" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "file_url": "https://example.com/sample.docx",
+    "timeout": 30,
+    "use_llm": false
+  }'
+```
+
+## 注意事项
+1. 本插件不扣费、不校验 API 密钥，任何人均可直接调用。
+2. `file_url` 必须是合法 URL（含 scheme 与 netloc），否则返回参数错误。
+3. 下载失败（网络异常、HTTP 状态码错误）、依赖库缺失（未安装 markitdown）或转换异常时返回 `success=false` 并附带 `error` 信息。
+4. 转换成功时返回 `message`，失败时返回 `error` 而非 `message`；调用方需同时兼容两个字段。

package/api_docs/md_to_docx.md

@@ -0,0 +1,51 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_docx`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 内容转换为 DOCX 文档并上传到阿里云 OSS，内置针对 htmldocx 库 `no attribute run` 错误的修复补丁。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容 |
+| filename | string | 否 | "document" | 输出文件名（不含后缀），系统会自动追加时间戳与 UUID 后缀 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| filename | string | 生成的 DOCX 文件名（失败时为 ""） |
+| file_url | string | 生成的文件下载 URL（失败时为 ""） |
+| 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/md_to_docx" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 标题\n\n这是一段 **加粗** 的正文，下面是一个列表：\n\n- 项目一\n- 项目二",
+    "filename": "我的文档"
+  }'
+```
+
+## 注意事项
+1. Markdown 文本为空时返回失败且不扣费；API 密钥无效、账户禁用或余额不足时均不扣费。
+2. 转换过程中若文档格式过于复杂导致解析异常，返回 `success=false` 且提示转换失败，此情况不扣费。
+3. 生成的 DOCX 已统一设置字体（西文 Times New Roman，中文 宋体）。

package/api_docs/md_to_html.md

@@ -0,0 +1,53 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_html`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 内容转换为美观的 HTML 网页并上传到阿里云 OSS 存储，支持复制按钮和 MathJax 数学公式渲染。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容 |
+| filename | string | 否 | 随机 8 位十六进制串 | 文件名（不含后缀），用作网页标题及文件名基础 |
+| add_copy_button | boolean | 否 | true | 是否在页面右下角添加「复制全文」按钮 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| online_url | string | 在线访问的 HTML 网页 URL（失败时为 ""） |
+| file_url | string | 文件 URL（仅在错误响应中返回空字符串，正常成功响应不返回该字段） |
+| 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/md_to_html" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 我的网页\n\n支持 $E=mc^2$ 公式与代码块。",
+    "filename": "demo_page",
+    "add_copy_button": true
+  }'
+```
+
+## 注意事项
+1. 采用后扣费模式：网页发布事务（finalize_webpage_publish）成功后才扣费；若发布事务失败，系统会尝试清理已上传的 OSS 文件且不扣费。
+2. API 密钥无效、账户禁用或余额不足时不扣费；Markdown 解析失败、OSS 上传失败、内容过大时返回失败且不扣费。
+3. 仅 `online_url` 为成功响应的有效返回字段；`file_url` 仅为错误响应占位，正常情况请勿依赖。

package/api_docs/md_to_mindmap.md

@@ -0,0 +1,52 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_mindmap`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 内容转换为思维导图图片并返回图片 URL。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容（思维导图结构，通常为多级列表） |
+| filename | string | 否 | "mindmap" | 输出文件名 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| image_url | string | 生成的思维导图图片 URL（失败时为 ""） |
+| width | int | 图片宽度（失败时为 0） |
+| height | int | 图片高度（失败时为 0） |
+| 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/md_to_mindmap" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "- 中心主题\n  - 分支一\n    - 子节点A\n  - 分支二",
+    "filename": "我的思维导图"
+  }'
+```
+
+## 注意事项
+1. 采用后扣费模式：先校验下游思维导图服务返回成功并包含 `url`，再检查余额并扣费；下游失败时不扣费。
+2. 余额不足、API 密钥无效、账户禁用时不扣费；网络异常或下游无返回时不扣费。
+3. 请求下游服务的超时时间为 60 秒（连接 10 秒）。

package/api_docs/md_to_pdf.md

@@ -0,0 +1,52 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_pdf`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 内容转换为 PDF 并上传到阿里云 OSS 存储，返回生成的 PDF 文件 URL。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容 |
+| filename | string | 否 | "document" | 输出文件名 |
+| font | string | 否 | "simsun" | 字体选择，可选值：simsun（宋体）、source（黑体）、kai（楷体） |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息（成功时含页数信息，如「PDF生成成功（共N页）」） |
+| pdf_url | string | 生成的 PDF 文件 URL（失败时为 ""） |
+| 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/md_to_pdf" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 报告标题\n\n这是 PDF 正文内容。",
+    "filename": "我的报告",
+    "font": "simsun"
+  }'
+```
+
+## 注意事项
+1. 采用后扣费模式：先调用下游 PDF 服务并校验成功，再检查余额并扣费；下游失败时不扣费。
+2. 余额不足、API 密钥无效、账户禁用时不扣费；网络异常或下游无返回时不扣费。
+3. 请求下游服务的超时时间为 60 秒（连接 10 秒）。

package/api_docs/md_to_png.md

@@ -0,0 +1,53 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_png`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 内容转换为 PNG 图片并上传到阿里云 OSS 存储，返回生成的 PNG 文件 URL 及图片尺寸信息。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容 |
+| filename | string | 否 | "document" | 输出文件名（作为图片标题），系统会自动追加后缀 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| png_url | string | 生成的 PNG 图片 URL（失败时为 ""） |
+| file_name | string | 生成的文件名（失败时为 ""） |
+| width | int | 图片宽度（失败时为 0） |
+| height | int | 图片高度（失败时为 0） |
+| 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/md_to_png" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 标题\n\n这是转换为 PNG 图片的 Markdown 内容。",
+    "filename": "我的图片"
+  }'
+```
+
+## 注意事项
+1. 采用后扣费模式：只有 PDF/PNG 等下游服务成功返回后才会扣费；网络请求失败、下游生成失败时返回 `success=false` 且不扣费。
+2. 依赖服务端环境变量中的 OSS 配置，若配置不完整返回失败且不扣费。
+3. 请求下游服务的超时时间为 60 秒（连接 10 秒），超大内容可能触发超时。

package/api_docs/md_to_txt.md

@@ -0,0 +1,51 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_txt`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 文本转换为纯文本 TXT 文件。按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | Markdown 文本内容 |
+| filename | string | 否 | "document" | 输出文件名（不含后缀），系统会自动追加时间戳与 UUID 后缀 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| filename | string | 生成的 TXT 文件名（失败时为 null） |
+| file_url | string | 生成的文件下载 URL（失败或 OSS 上传失败时为空） |
+| 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 | string | 交易流水号（未扣费时为 null） |
+| billing.error | string | 错误信息（仅失败响应的 billing 中可能出现） |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/md_to_txt" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 标题\n\n这是 **加粗** 的正文，转换后会变成纯文本。",
+    "filename": "纯文本输出"
+  }'
+```
+
+## 注意事项
+1. 转换结果为去除 Markdown 标记后的纯文本；若结果为空（如纯图片链接 Markdown）返回失败且不扣费。
+2. Markdown 文本为空时返回失败且不扣费；API 密钥无效、账户禁用或余额不足时不扣费。
+3. OSS 上传失败时仍返回 `success=true`，但 `file_url` 为空，且不会扣费（计费信息保持初始值）。

package/api_docs/md_to_wxhtml.md

@@ -0,0 +1,64 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/md_to_wxhtml`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将 Markdown 转换为微信公众号兼容的 HTML，支持 8 种内置主题或自定义 4 色配置，并可选择生成一键复制页面 URL。为**计费插件**：按次计费，费用以 `api_services` 表（`service_code=md_to_wxhtml`）配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| md_text | string | 是 | - | 待转换的 Markdown 文本内容 |
+| theme | string | 否 | 空（自定义） | 内置主题名称，启用后覆盖所有排版参数。可选值：GitHub / Notion / 极简风 / 书籍印刷 / 微信绿 / 暗夜模式 / 商务蓝 / 活力橙粉 |
+| primary_color | string | 否 | `#fa8c16` | 【自定义】主色调，用于列表标记、链接、引用边框 |
+| accent_color | string | 否 | `#f05209` | 【自定义】强调色，用于内联代码文字色 |
+| title_color | string | 否 | `#1a1a1a` | 【自定义】标题色 |
+| text_color | string | 否 | `#333333` | 【自定义】正文色 |
+| font_size | int | 否 | `16` | 【自定义】正文字号（px） |
+| line_height | float | 否 | `1.75` | 【自定义】行高 |
+| font_family | string | 否 | 系统无衬线字体 | 【自定义】字体，如：思源黑体 / 宋体 / 衬线字体 / 等宽字体 |
+| title_align | string | 否 | `居左` | 所有层级标题对齐方式：`居左` 或 `居中`（主题不覆盖此项） |
+| generate_copy_url | bool | 否 | `false` | 是否生成一键复制页面 URL（上传至 OSS 并返回链接） |
+| title | string | 否 | 空 | 文章标题，仅在 `generate_copy_url=true` 时显示在复制页面顶部 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| html_code | string | 转换后的微信公众号 HTML（当 `generate_copy_url=false` 时返回，否则为空字符串） |
+| copy_url | string | 一键复制页面 URL（当 `generate_copy_url=true` 时返回，否则为空字符串） |
+| billing | object | 计费信息，含以下子字段 |
+| billing.service_fee | float | 本次实际扣费金额 |
+| billing.base_fee | float | 基础服务单价 |
+| billing.discount_applied | boolean | 是否应用了折扣 |
+| billing.balance_before | float | 扣费前账户余额 |
+| billing.balance_after | float | 扣费后账户余额 |
+| billing.currency | string | 货币单位，固定 `CNY` |
+| billing.transaction_id | int/None | 交易流水 ID（失败或未扣费时为 `null`） |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/md_to_wxhtml" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "md_text": "# 标题\n\n正文内容，支持 **加粗** 与列表。",
+    "theme": "微信绿",
+    "generate_copy_url": false
+  }'
+```
+
+## 注意事项
+1. 本接口**计费**，单次调用扣费一次；即使 `md_text` 为空内容也会扣费（返回空 `html_code`）。
+2. **不扣费场景**：API 密钥无效、账户被禁用、余额不足、服务异常（此时 `transaction_id=null`，`service_fee=0`）。
+3. 当 `generate_copy_url=true` 时返回 `copy_url` 且 `html_code` 为空；为 `false` 时返回 `html_code`。
+4. 指定 `theme` 后，自定义排版参数（primary_color 等）将被主题配置覆盖；`title_align` 始终生效。
+5. 文件上传至 OSS 目录 `temporary`，复制页面含「复制正文 / 复制标题」按钮。