文档
03 平台04 媒体供应04_开发

MG-04-014 渠道插件

历史设计:2026-09-22 起停止新插件接入,安装/绑定等入口返回 410。当前流程见 ADMIN_API.md。旧数据和在途任务保留兼容。

所有端点在 /admin/v1 下,仅管理员 Bearer 权限。服务 Key 无权访问;不返回上游密钥。

方法路径含义
GET/channel-plugins不可变插件版本、已安装协议对
GET/channel-statistics最近 24 小时渠道任务数、成功/失败数、成功平均完成耗时及最近检查状态;无样本不评成功率
POST/channel-plugins/validate校验清单结构与真实执行器,不做网络验证
POST/channel-plugins安装新版本;重复 key/revision 为冲突
GET/channels/{id}/plugin绑定、检查计划、最近状态
PUT/channels/{id}/plugin绑定/升级/回滚及检查计划;If-Match 为渠道版本
POST/channels/{id}/models/sync手动检查,与定期检查共享互斥租约
PUT/public-models/{id}/bindings/apply原子保存优先级/绑定并校验发布;If-Match 为模型版本

清单见仓库 Skill 的 references/channel-plugins.md。绑定 body 为 {plugin_id,auto_check,interval_minutes},间隔 15–10080 分钟。改变插件要求渠道停用;归档渠道不可修改。原有渠道迁移不建立绑定、不启动定期访问。

渠道成功率分母为 succeeded + failed;取消、提交未知和执行中不计入成功/失败样本。平均耗时仅统计已成功的 Attempt,不表示排队时间或画面质量。

后台 reconciler 每分钟领取最多一个到期检查。数据库 3 分钟租约,网络工作 90 秒上限;不在事务内调用上游。检查只更新目录和价格,不收费生成。模型失败保留全部旧数据;价格失败保留旧价格并标记 partial。静态错误消息不包含上游响应或密钥。

自动维护:明确映射、实际返回的视频型号自动建停用草稿。机器报价保存原始规则;仅固定、已知计费规则生成自动采购资料。人工编辑后解除该报价的自动管理。已验证参数、执行成本、路由、启停不被同步覆盖;新参数存观察资料。

首版不声称已完成:任意协议动态代码热加载、自动抓取任意文档、破坏性参数变化的完整停用/确认工作流、Token 执行成本、单供给自动保护策略开关、素材文件上传。已有执行器和健康保护继续生效。

迁移 000025 新增两张表;不可变版本及操作审计保留。应用回退可保留附加表,无需删数据。新增清单不自动绑定真实渠道。

On this page