cloud-agent 用于把本地方案不适合或无法完成的任务委托给云端 Agent。定位是本地能力的扩展：本地优先处理，满足特定理由时才转云端。
云端独有能力：隔离代码沙箱（Docker 容器内安全执行 Python/Node/Shell 代码，不影响本机系统）；项目构建与发布（沙箱内构建、打包镜像、部署到公网 URL）；24/7 持续运行（云端定时任务不受开关机影响，支持 cron/interval/once 三种调度）；云端文件存储（S3/OSS 持久化，可生成预签名下载链接）。
本地独有能力：桌面 UI 自动化、本地应用控制、截图与 OCR、剪贴板读写、本地文件直接访问。联网搜索、网页内容提取、知识库检索、PDF/Excel/Word 文件处理两端都有，不构成委托云端的理由。
委托条件（满足任一）：一是持续运行，任务可能比本次开机时长更久；二是沙箱执行，需隔离环境运行代码或构建发布项目；三是深度调研，长时间、多轮、不怕关机的分析，可跑数小时并自主推进，适合完整报告与对比分析。
用法：调用 cloud_agent(task="...")；可带 context 提供上下文；可带 files 传入 PDF、Excel、CSV、图片等，本地文件会自动上传到云端 S3 后再交给云端 Agent。
执行特性：默认流式返回，实时推送进度（思考中、工具调用、生成文本）；简单任务约 10-30 秒，深度调研约 1-3 分钟，沙箱构建项目约 2-5 分钟；需要网络连接，不可达时返回明确错误；返回纯文本结果，如需生成本地 PPT/Excel 文件应在本地完成。
限制：源资料未明确列出具体不可委托场景的清单，仅提示部分场景不应委托云端；具体平台支持、配额、收费与更多配置暂未提供。