SuperAPI AI 工具集

job-state-machine

通用与其它

查看项目

更新于 10-15 20:30

技能介绍

用途:为异步任务(如图片生成、导出等)提供受校验的状态流转、进度跟踪与产物(asset)关联,确保任务最终进入终态并保留错误信息。

主要能力:定义 QUEUED、PROCESSING、COMPLETED、FAILED、PARTIAL 五种状态;通过 VALID_TRANSITIONS 限制合法流转,仅允许 QUEUED→PROCESSING,PROCESSING→COMPLETED/PARTIAL/FAILED;终态无后续流转。提供 isTerminalState 判断终态。JobService 支持创建任务、按用户校验读取、流转状态、更新进度、标记完成/失败/部分完成,以及创建与查询任务产物。非法流转抛出 InvalidStateTransitionError。

使用方式:资料给出 TypeScript 与 Python 两套实现,均依赖注入的 db 对象进行读写;worker 中先流转到 PROCESSING,分步调用 updateProgress,上传结果后 createAsset,最后 markCompleted;异常时 markFailed。数据库参考表 jobs 与 assets,含状态与进度 CHECK 约束及索引。

适用场景:需要可靠状态管理、长任务进度反馈、产物与任务关联以便清理的异步处理流程。

限制:资料未提供安装命令、依赖版本、具体数据库适配实现、部署方式与收费信息;示例中的 db 接口与 doStep1 等函数需自行实现。