malue-ai/cloud-agent

云端 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：持续运行 — 任务可能比本次开机时长更久

<example> <query>每天早上 8 点帮我看科技新闻</query> <use_cloud>true</use_cloud> <reason>定时任务，8 点用户可能没开机</reason> </example> <example> <query>周末帮我盯一下 XX 商品有没有降价</query> <use_cloud>true</use_cloud> <reason>跨天监控，周末不一定开电脑</reason> </example> <example> <query>花一下午深度调研这个行业，不着急</query> <use_cloud>true</use_cloud> <reason>多小时任务，用户可能中途关机</reason> </example> <example> <query>下午 3 点提醒我开会</query> <use_cloud>false</use_cloud> <reason>用户正在用电脑，本地提醒更即时可靠</reason> </example>

理由 2：沙箱执行 — 需要隔离环境运行代码或构建发布项目

<example> <query>帮我跑一下这段 Python 数据分析脚本</query> <use_cloud>true</use_cloud> <reason>需要隔离沙箱环境安全执行代码</reason> </example> <example> <query>做一个生日邀请网页，发链接给朋友</query> <use_cloud>true</use_cloud> <reason>沙箱构建项目 + 发布到公网 URL</reason> </example> <example> <query>构建一个贪食蛇网页小游戏</query> <use_cloud>true</use_cloud> <reason>需要沙箱构建、运行 dev server、可发布</reason> </example> <example> <query>帮我做个 PPT</query> <use_cloud>false</use_cloud> <reason>本地有 PPT Skill，无需沙箱</reason> </example>

理由 3：深度调研 — 长时间、多轮、不怕关机的深度分析

云端深度调研的优势不在于"能搜索"（本地也能），而在于：

• 不受开机限制，可以跑数小时
• 多轮迭代搜索 + 分析 + 再搜索，自主推进
• 适合产出完整报告、对比分析等重度输出

<example> <query>调研最新的 AI Agent 框架并写对比报告</query> <use_cloud>true</use_cloud> <reason>需要多轮搜索 + 长时间分析 + 产出完整报告，用户可能中途关机</reason> </example> <example> <query>帮我分析这三家竞品的功能差异，写一份对比分析</query> <use_cloud>true</use_cloud> <reason>需要爬取多个竞品网站 + 长时间深度对比</reason> </example> <example> <query>搜一下明天上海天气</query> <use_cloud>false</use_cloud> <reason>简单搜索，本地搜索工具秒级返回</reason> </example> <example> <query>搜一下最新的 AI 论文</query> <use_cloud>false</use_cloud> <reason>单次搜索，本地有 arXiv/论文搜索 Skill，即时返回</reason> </example>

绝对不要委托云端的场景

<example> <query>帮我整理桌面上的文件</query> <use_cloud>false</use_cloud> <reason>纯本地文件操作，云端无法访问本地桌面</reason> </example> <example> <query>打开微信</query> <use_cloud>false</use_cloud> <reason>本地应用操作，云端无法控制桌面应用</reason> </example> <example> <query>帮我写一封邮件</query> <use_cloud>false</use_cloud> <reason>文本生成是本地基础能力，无需委托</reason> </example> <example> <query>帮我搜一下这个问题</query> <use_cloud>false</use_cloud> <reason>本地有多个搜索 Skill（DuckDuckGo/Brave/Tavily），即时返回</reason> </example>

使用方式

基本调用：

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），应在本地完成