SuperAPI AI 工具集

develop-timeline-studio-plugin

编程与开发

查看项目

更新于 10-16 00:06

技能介绍

用途:为 Timeline Studio 开发、评估或评审图像与视频生成连接器(供应商插件)。开始前须完整阅读 ../../docs/generation-plugin-development.md,并查看仓库 AGENTS.md 及 src/components/GenerationPlugins.jsx、src/hooks/useGenerationPlugins.js 的现有实现。当前插件属于审查型源码集成,不要假设已存在可外部安装的插件运行时;若契约所述共享注册表与宿主缺失,仅做请求范围内的有界抽取,并保留现有供应商行为。

主要能力与判断:依据供应商官方文档确认稳定任务/结果 API 或自有浏览器 SDK、自动获取全部生成图像或视频、鉴权与凭据归属、浏览器与 CORS 要求、真实任务/进度/错误/取消语义,以及临时输出有效期、成本、区域和账号限制。拒绝通用嵌入或手动结果 URL 流程;当供应商要求在浏览器代码中使用开发者密钥或缺少安全自动输出路径时停止,并说明缺失能力而非模拟。

边界与安全:传输与响应解析放在隔离适配器中,通过单一声明式清单注册身份与能力;宿主负责并发、取消仲裁、媒体校验、对象 URL、通知与 My assets 提交,供应商不得改动时间线或获取广泛编辑器状态。完成前下载并解码输出字节,导入全部声明输出,不伪造百分比进度。完成媒体进入 My assets 但不自动插入时间线;开发者自有密钥须走安全后端连接层;回环插件仅接受 localhost、127.0.0.1 或 ::1,显示已连接前须校验端点和 CORS,不推荐局域网暴露或通配 CORS。

本地化与收尾:供应商专属文案覆盖 zh、en、ja、ko、es、fr、de、pt、th、vi、ru;把原始传输失败转为本地化可操作错误,不泄露密钥。在真实供应商状态下验证后运行 npm run lint、npm run typecheck、npm run build;不在产品仓库添加持久测试装置或测试媒体。交付时报告供应商类别、鉴权边界、支持模式、取消真实性、输出下载行为、变更文件与验证结果,并说明仍未具备的能力。定价、具体供应商名单与外部安装流程暂未提供。