feat(*): 插件中心与模型协议 - 完善声明式协议运行时并增加功能开放控制

backend/internal/protocol/docs/volcengine-ark-image.md

@@ -0,0 +1,61 @@
+# 火山方舟图片生成
+
+本插件面向火山方舟 Ark 图片生成 JSON 接口。提示词直接发送，参考图数组映射到 `image`，连续生成和水印参数可从模型扩展字段透传。
+
+## 接口、鉴权与区域
+
+{{OPERATIONS}}
+
+```http
+POST {channel_base_url}/api/v3/images/generations
+Authorization: Bearer <ARK_API_KEY>
+Content-Type: application/json
+```
+
+Base URL、鉴权方式和可用模型受火山方舟控制台、区域与接入方式影响。若使用 AK/SK 签名网关，应由渠道层完成签名，不能把 Secret Key 写入插件文档或浏览器。
+
+## 模型与支持边界
+
+模型 ID、尺寸范围与能力以火山方舟控制台为准。
+
+## 参数与字段映射
+
+{{PARAMETERS}}
+
+当前实现：`aspectRatio -> size`，所有 `images -> image[]`；`extra` 可透传 `size`、`sequential_image_generation`、`sequential_image_generation_options`、`watermark`。`imageCount`、`quality` 与 `resolution` 没有通用映射，必须按模型接口另行适配。
+
+## 文生图示例
+
+```bash
+curl "{channel_base_url}/api/v3/images/generations" \
+  -H "Authorization: Bearer <ARK_API_KEY>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model":"YOUR_ARK_ENDPOINT_OR_MODEL",
+    "prompt":"古城屋顶追逐，低机位，动态构图",
+    "size":"2048x1152",
+    "watermark":false
+  }'
+```
+
+## 参考图示例
+
+```json
+{
+  "model":"YOUR_ARK_ENDPOINT_OR_MODEL",
+  "prompt":"保持人物服装和发型，生成侧面中景",
+  "image":["https://example.com/character.png"],
+  "size":"2048x1152"
+}
+```
+
+## 响应解析与限制
+
+响应按 `data[]` 图片数组解析，元素需包含 `url`、`b64_json` 或 `data`。当前插件没有为 Ark 特有错误码、任务模式或内容过滤结果做专属解包；渠道返回非兼容结构时会明确失败。模型尺寸、参考图数量、序列图上限、水印和计费以控制台当前模型说明为准，不能从插件默认值推断。
+
+## 官方资料
+
+- [火山方舟视觉模型 API 文档](https://www.volcengine.com/docs/82379)
+- [火山方舟 API 接入与鉴权文档](https://www.volcengine.com/docs/82379/1263279)
+
+{{CONTRACT}}