malue-ai 云端 Agent 委托
云端 Agent 是本地的能力扩展。本地优先处理，但当本地不适合或无法完成时，委托云端。
云端与本地的能力边界
云端独有（本地做不到）
- 隔离代码沙箱：Docker 容器内安全执行任意代码（Python/Node/Shell），不影响用户系统
- 项目构建与发布：沙箱内 build 项目 + 打包 Docker 镜像 + 部署到公网 URL，用户可直接访问
- 24/7 持续运行：云端定时任务不受电脑开关机影响，支持 cron/interval/once 三种调度模式
- 云端文件存储：S3/OSS 持久化，生成预签名下载链接
本地独有（云端做不到）
- 桌面 UI 自动化（peekaboo / pywinauto / Claude Computer Use）
- 本地应用控制（打开微信、操作飞书、Apple Mail/Calendar 等）
- 截图 + OCR、剪贴板读写
- 本地文件直接访问（整理桌面、移动文件）
两端都有（不是委托云端的理由）
- 联网搜索：本地有 DuckDuckGo/Brave/Tavily/arXiv/论文搜索，日常搜索本地即可
- 网页内容提取：本地有 Jina Reader、Crawl4AI
- 知识库检索：本地有 FTS5 + 语义搜索 + RAG
- 文件处理：本地可直接读写 PDF/Excel/Word
什么时候委托云端
满足以下任一理由即可委托：
理由 1：持续运行 — 任务可能比本次开机时长更久
理由 2：沙箱执行 — 需要隔离环境运行代码或构建发布项目
理由 3：深度调研 — 长时间、多轮、不怕关机的深度分析
云端深度调研的优势不在于"能搜索"（本地也能），而在于：
- 不受开机限制，可以跑数小时
- 多轮迭代搜索 + 分析 + 再搜索，自主推进
- 适合产出完整报告、对比分析等重度输出
绝对不要委托云端的场景
使用方式
基本调用：
cloud_agent(task="调研 AI Agent 赛道最新动态并写一份分析报告")
带上下文：
cloud_agent(
task="基于以下竞品列表做深度调研",
context="竞品: Manus, Devin, Bolt..."
)
带文件（PDF / Excel / 图片等）：
cloud_agent(
task="分析这份行业报告并提取关键数据",
files=[{"file_url": "/path/to/report.pdf", "file_name": "行业报告.pdf", "file_type": "application/pdf"}]
)
本地文件会自动上传到云端后再传给云端 Agent 处理。
执行特性
- 流式输出：云端默认流式返回，执行过程中会实时推送进度（思考中 -> 工具调用 -> 生成文本）
- 执行时间：简单任务 10-30 秒，深度调研 1-3 分钟，沙箱构建项目 2-5 分钟
- 文件支持：可传入 PDF、Excel、CSV、图片等文件，本地文件会自动上传到云端 S3
- 网络依赖：需要网络连接，不可达时工具会返回明确错误提示
- 结果格式：返回纯文本结果，如需生成本地文件（PPT / Excel），应在本地完成