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

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

@@ -0,0 +1,57 @@
+# 火山方舟视频任务
+
+本插件使用 Ark Contents Generations Tasks 异步接口。提示词和参考图组成 `content[]`；比例、分辨率、时长、音频和水印位于顶层任务参数。
+
+## 接口与鉴权
+
+{{OPERATIONS}}
+
+```http
+POST {channel_base_url}/api/v3/contents/generations/tasks
+GET  {channel_base_url}/api/v3/contents/generations/tasks/{task_id}
+Authorization: Bearer <ARK_API_KEY>
+Content-Type: application/json
+```
+
+## 模型与约束
+
+模型通常对应控制台可用模型或 endpoint ID。允许时长、分辨率、画幅、参考图数量、是否可生成音频及计费由具体模型决定。插件默认 5 秒、`16:9`、`720p`，默认值不是上游能力承诺。
+
+## 参数与字段映射
+
+{{PARAMETERS}}
+
+每张图片构造为 `{"type":"image_url","image_url":{"url":"..."},"role":"reference_image"}`。当前不发送参考视频与参考音频；`generate_audio` 和 `watermark` 只在 true 时发送。
+
+## 创建任务示例
+
+```bash
+curl "{channel_base_url}/api/v3/contents/generations/tasks" \
+  -H "Authorization: Bearer <ARK_API_KEY>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model":"YOUR_ARK_VIDEO_MODEL",
+    "content":[
+      {"type":"text","text":"保持人物一致，镜头缓慢环绕"},
+      {"type":"image_url","image_url":{"url":"https://example.com/subject.png"},"role":"reference_image"}
+    ],
+    "ratio":"16:9",
+    "resolution":"720p",
+    "duration":5,
+    "generate_audio":true,
+    "watermark":false
+  }'
+```
+
+## 查询、状态与结果
+
+创建响应任务 ID 由统一解析器从顶层、`task` 或 `data` 提取。查询成功后读取视频数组或常见 URL 字段。若 Ark 把结果放在其他嵌套路径，必须用真实 fixture 增加专属解析，不允许只根据 `completed` 返回空成功。
+
+任务失败可能来自 endpoint 不可用、素材下载失败、参数组合不受支持、内容审核、并发或额度限制。上游 request ID 应保留用于排查，API Key 和素材正文不得进入日志。
+
+## 官方资料
+
+- [火山方舟视频生成 API](https://www.volcengine.com/docs/82379)
+- [火山方舟内容生成任务文档](https://www.volcengine.com/docs/82379/1520757)
+
+{{CONTRACT}}