SuperAPI AI 工具集

session-timeout-handler

智能体与模型

查看项目

更新于 10-15 22:39

技能介绍

用途:Claude Code 默认工具超时为 120 秒,该技能提供可复用模式,让长时间、大批量任务在超时约束下分步完成并可从断点继续。适用于循环处理 50 个以上条目、运行超过 60 秒的命令、下载多个大文件、批量 API 调用、处理大数据集、数据库迁移、构建大型项目、克隆多个仓库等场景。

主要能力与策略:分批处理,每次只取一小批条目处理,并打印下一批的启动偏移量;检查点续跑,用文件记录已完成项,重跑时从断点继续;状态机,把工作流拆成 INIT、DOWNLOAD、PROCESS、FINALIZE 等阶段,每次运行推进一个阶段;进度跟踪,以 JSON 记录总数、成功、失败与时间戳,并用 jq 更新展示。另有超时安全模式:并行加限流(最多 3 到 5 个并发)、timeout 与缓存回退、增量构建。

使用方式:以 Bash 脚本实现,常见片段包括 tail -n +$OFFSET file.txt | head -$BATCH_SIZE、LAST=$(cat .checkpoint || echo 0)、timeout 90s operation || use_cached_result。可与 Claude Code 多轮对话配合:每轮处理一批并保存检查点,下一轮从检查点继续,最后汇总报告;也可启动后台任务后用 pid 文件检查状态。

限制与注意:资料建议批次控制在 5 到 10 项,单次操作超时设 60 到 90 秒留出余量,注意处理退出码 124;不要一次处理超过 50 项,不要忽略检查点,不要无限并行或无限重试(建议 3 到 4 次上限),完成后清理临时文件与检查点。具体安装方式、平台与授权信息暂未提供。