feat(platform): 插件协议系统 - 支持声明式渠道、工作流与参考媒体映射

backend/internal/protocol/docs/autodl-comfyui.md

@@ -0,0 +1,28 @@
+# {{NAME}}
+
+## 接口
+
+AutoDL.Art 将 ComfyUI 工作流包装为异步任务接口。创建任务使用 `POST /api/v1/comfyui/comfyui_workflow/{workflow_id}`，影策运行时模板为 `/api/v1/comfyui/comfyui_workflow/{model}`；查询结果使用 `GET /api/v1/comfyui/comfyui_workflow/result/{task_id}`，影策运行时模板为 `/api/v1/comfyui/comfyui_workflow/result/{task_id}`。`workflow_id` 由模型字段传入，不能把它写死在渠道地址中。创建接口只返回任务标识，宿主负责按照统一任务生命周期轮询。
+
+## 模型
+
+AutoDL 的模型选择对应 ComfyUI 工作流 ID。不同工作流可以声明不同参数，插件清单中的工作流贡献负责描述参数、默认值和画布能力。当前内置示例使用 `minimax_h3_lightx2v_no_pic`，表示 MiniMax H3 文生视频工作流。后续新增工作流只需增加工作流贡献，不需要修改生成服务代码。
+
+## 参数
+
+请求体为 JSON。常用字段包括 `prompt`、`duration` 和 `resolution`；实际工作流可以扩展自己的参数 schema。状态返回值位于 `data.status`，任务 ID 位于 `data.task_id`，成功结果位于 `data.results`。结果数组中的地址是短期 URL，成功后必须立即由宿主下载到影策资源存储，不能把临时地址直接写入画布长期数据。
+
+## 鉴权
+
+使用 AutoDL 令牌作为 `Authorization` 请求头。令牌应配置在渠道密钥存储中，只由后端出站请求读取，不进入插件 Manifest、浏览器 URL、日志或持久任务正文。Token 分组应选择 AutoDL 的 ComfyUI 分组。
+
+## 状态与结果
+
+`QUEUED` 映射为排队，`RUNNING` 映射为处理中，`SUCCESS` 映射为成功，`FAILED` 映射为失败。成功但没有 `data.results` 时，宿主应返回真实错误而不是生成空节点。视频结果由宿主读取 MIME、下载并保存，用户界面只消费已保存资源。
+
+## 官方
+
+- [AutoDL ComfyUI API](https://autodl.art/docs/comfyui_api/)
+- [AutoDL Token 管理](https://autodl.art/large-model/tokens)
+
+{{CONTRACT}}