应延长超时并启用分片上传：一、调高http客户端connect至60秒、read/write至1800秒，开启keepalive；二、为github/oss/sftp等connector单独配置timeout_ms=3600000及分片参数；三、离线环境通过pythonhttpsreq_timeout或代码层传入timeout=(60,3600)；四、强制启用分片上传与断点续传，指定part_size和state_file。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用QoderWake执行大文件上传或下载任务时频繁遭遇连接超时中断，则可能是由于默认网络超时阈值过短、未适配长耗时IO场景所致。以下是解决此问题的多种参数调整路径：
一、调整HTTP客户端全局超时配置
QoderWake底层HTTP通信依赖统一客户端实例，其默认connect与read超时均为30秒，无法满足百MB级以上文件的稳定传输需求。需显式延长各阶段等待上限，避免因网络抖动或服务端处理延迟触发提前断连。
1、定位QoderWake配置目录下的config/http-client.yaml文件。
2、修改timeout区块，将connect设为60秒，read设为1800秒（30分钟），write同步设为1800秒。
3、确保enable_keepalive为true，并设置keepalive_idle为45秒以维持TCP连接活性。
4、保存后执行qoderctl http reload命令热加载新配置，验证日志中出现HTTP client timeout updated: connect=60s, read=1800s提示。
二、为特定Connector单独设置超时参数
当大文件传输通过GitHub、OSS或自建SFTP Connector完成时，全局HTTP超时不生效。必须针对该Connector的底层协议栈单独注入超时控制，防止其内部SDK使用硬编码默认值。
1、进入QoderWake管理控制台，导航至「Connector管理中心」→ 选择目标Connector（如oss-v2.1）。
2、点击「高级参数」展开面板，在JSON编辑区添加以下字段：
{"timeout_ms": 3600000, "max_retries": 3, "retry_delay_ms": 2000}
3、确认该Connector已启用「分片上传」开关，并将part_size_mb设为100（适用于1GB以上文件）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
4、提交配置后，在CLI中运行qoder connector test oss-v2.1 --upload-test-file /tmp/test_512mb.bin验证稳定性。
三、修改底层Python Requests会话行为（离线环境适用）
在无GUI管理界面或受限容器环境中，可通过直接注入环境变量覆盖Requests默认行为，绕过QoderWake配置层实现强制超时延长，适用于临时应急或CI/CD流水线部署。
1、在启动QoderWake前，导出环境变量：export REQUESTS_CA_BUNDLE=/etc/qoderwake/certs/fullchain.pem（若启用自定义CA）。
2、设置超时环境变量：export PYTHONHTTPSREQ_TIMEOUT="3600"（单位：秒）。
3、若使用自定义Requests会话封装，需在lib/transport/session.py中定位Session().request()调用处，强制传入timeout=(60, 3600)元组。
4、重启QoderWake进程，检查qoder logs --tail 100 | grep "timeout"输出是否包含新值。
四、启用分片上传+断点续传双机制
单纯延长超时仅缓解表象，无法解决单次失败全量重传问题。必须激活分片上传引擎并持久化上传状态，使中断后可从最近成功分片继续，大幅降低重试开销与失败概率。
1、确认QoderWake版本≥v1.0.2，执行qoder feature list | grep multipart验证multipart_upload特性已启用。
2、在任务脚本中显式声明分片策略：upload_opts = {"use_multipart": true, "part_size": 10485760, "state_file": "/var/run/qoderwake/upload_state.json"}。
3、确保/var/run/qoderwake/目录具备当前用户读写权限，且upload_state.json文件由QoderWake进程自动创建与更新。
4、模拟中断测试：上传过程中执行kill -TERM $(pgrep -f "qoderwake.*upload")，重启后观察日志是否输出Resuming from part 7 of 23。
