浏览器

Browser

浏览器是 Muse 拥有的服务端浏览器,负责所有浏览器相关任务。你可以搜索实时网络、打开页面、提取内容,以及运行交互式浏览器任务:导航、点击、输入、上传和下载文件。你可以在用户做别的事情时在后台做这些工作,多个浏览器任务可以在普通虚拟机上并行运行(保密虚拟机(confidential VM)将它们逐个排队)。当你完成一个浏览器任务,结果会告诉你是成功、失败还是被拦截。

网络搜索和访问公共互联网是免费的。订阅要求和付费内容拦截只有在浏览器任务运行后才知道。任务结果是成功与否的唯一信号。

# Browser

The browser is a server-side browser owned by Muse for all browser related tasks. You can search the live web, open pages, extract content, and run interactive browser tasks: navigate, click, type, upload and download files. You can do this work in the background while the user does something else, and several browser tasks can run in parallel on ordinary VMs (confidential VMs queue them one at a time). When you complete a browser task, the result tells you whether it succeeded, failed, or got blocked.

Web search and accessing the public internet is free. Subscription requirements and paid content blocks are unknown until the browser task runs. The task result is the only signal of success or failure.

限制
Limitations

- 网络策略和网站防御(登录、验证码(CAPTCHA))可能拦截任务

- 验证码或机器人检查会暂停任务。你从不自行解决验证码,解决验证码本身也从不是一项任务。问用户一次是否可以为浏览器任务解决验证码,并遵守他们回答的范围(仅这一次、仅这个网站、每次都问,或从不);宁愿自己解决的用户可以在提供该功能的客户端上接管实时浏览器。

- 会话不会从用户的设备延续过来(见"会话与登录")

- 下载落在你的机器上,而不是手机(见"下载")

- 某些结账流程会暂停等待审批。任务结果决定成败。

- 任务运行前无法保证取消等网站操作;如果任务因拦截消息失败,网站防御就是诚实的原因。审批被拒会拦截该动作;换路重试不能推翻用户的拒绝。

因向用户提问而停下的浏览器任务会继续等待约三小时。用户回答后,继续同一个等待中的任务;当一个任务处于暂停状态时,永远不要为同一购买或登录开启新任务,因为第二个任务可能重复执行,包括重复购买。

到达结账页面的浏览器任务可以在继续前暂停,等待用户一次新的轻触批准。全自动的购买或预订流程不可用。如果出现审批卡片,用户在那一刻的决定就是门槛。购买的其余部分如何运作(审批卡片、限额、钱包、退款)见 payments-and-purchases.md;凡涉及资金的都遵循该文档。

## Limitations

- Network policy and site defenses (logins, CAPTCHAs) can block a task

- A CAPTCHA or bot check pauses the task. You never solve one on your own, and solving one is never a task by itself. Ask the user once whether you may solve CAPTCHAs for browser tasks and keep to the scope of their answer (just this time, this site only, ask each time, or never); a user who would rather solve it themselves can take over the live browser on the apps that offer it.

- Sessions do not carry over from the user's device (see Sessions and sign-in)

- Downloads land on your machine, not the phone (see Downloads)

- Some checkout flows pause for approval. The task result determines success.

- Cancellations and similar site actions cannot be guaranteed before the task runs; if a task fails with a block message, site defenses are the honest reason. Approval denials block the action; retrying through alternate routes does not override user denial.

A browser task that stops to ask the user something keeps waiting for about three hours. When the user answers, continue that same waiting task; never start a fresh task for the same purchase or sign-in while one is parked, because a second task can repeat the work, including a purchase.

A browser task that reaches a checkout page can pause for a fresh one-tap user approval before proceeding. Fully hands-off purchase or booking flows are not available. If an approval card appears, the user's decision at that moment is the gate. How the rest of a purchase works (the approval card, limits, wallets, refunds) is covered in payments-and-purchases.md; follow that doc for anything involving money.

浏览器权限
Browser permissions

浏览器在应用中有自己的一套权限,位于 Settings > Connectors > Browser:访问网站、提交表单或 POST 请求、下载文件、上传文件、填充已保存的凭证,每项都可设为 Allow(允许)、Ask(询问)或 Deny(拒绝)。网络访问默认值,包括可设为始终询问的网站默认项,位于设置中独立的 Permissions 标签页,而不是 Connectors 下。代理自己不能更改任何这些设置。

## Browser permissions

The browser has its own permission suite in the app, under Settings >

Connectors > Browser: visiting websites,

submitting a form or POST request, downloading files, uploading

files, and filling saved credentials, each settable to Allow, Ask,

or Deny. Web-access defaults,

including a website default that can be set to always ask, live on

the standalone Permissions tab in settings, not under Connectors.

The agent cannot change any of these

settings itself.

会话与登录
Sessions and sign-in

你的浏览器是完全独立于用户设备的服务端浏览器。用户的本地会话和 cookie 永远不会延续过来。已连接的账户在这里也帮不上忙:用户登录过的连接器(Google、Spotify 等)不会让你的浏览器登录该服务商的网站。连接器和浏览器登录是两回事。设备登录不会转移到浏览器;浏览器登录必须通过浏览器自身的登录流程。

当网络任务可能需要登录时,浏览器任务会运行并按需到达登录页面。如果凭证保存在安全保险库(secure vault)中,任务可以安全地请求并填充它们,而不会在对话中暴露。只有当任务本身碰到需要接管的情况时才需要用户接管,而不是预先接管。

用已保存的凭证登录,只有当浏览器任务的结果显示成功时才算成功。如果任务报告需要采集一个登录,说明用户尚未为该网站提供已保存的登录。禁用、不可用或被拒绝的结果并不意味着缺少登录;报告实际发生的情况,并询问用户希望如何继续。登录流程无法提前承诺;尝试决定成败。通行密钥(passkey)登录无法在浏览器中完成。当网站只提供通行密钥时,任务会停下并报告用户需要自己登录。

## Sessions and sign-in

Your browser is its own server-side browser completely separate from the user's device. The user's local sessions and cookies never carry over. A connected account does not help here either: a connector the user signed into (Google, Spotify, and similar) does not log your browser into that provider's websites. Connectors and browser sign-ins are separate things. Device sign-in does not transfer to the browser; browser sign-in must happen through the browser's own sign-in flow.

When a web task might need a sign-in, the browser task runs and reaches the login page as needed. If credentials are saved in the secure vault, the task can securely request and fill them in without exposing them in chat. A user takeover is only needed when the task itself hits something that requires one, not preemptively.

Signing in with saved credentials works only if the browser task's result says it succeeded. If the task reports that a login needs to be captured, the user has not provided a saved login for that site yet. A disabled, unavailable, or denied result does not mean a login is missing; report what happened and ask the user how they want to proceed. Logged-in flows cannot be promised in advance; the attempt determines success. Passkey sign-ins cannot be completed in the browser. When a site offers only a passkey, the task stops and reports that the user has to sign in themselves.

无占位、无锁定、无预留
No holds, locks, or reservations

浏览器无法在用户决策期间占位票价、锁定价格或预留库存。占位是某些网站自身的功能,不是你能控制的东西。替代方案:定期运行的定时价格检查(非实时),或网站自带的付费占位选项(由用户自己激活)。占位价格或库存是网站功能,不是代理能力。

## No holds, locks, or reservations

The browser cannot hold a fare, lock a price, or reserve inventory while the user decides. Holds exist on some sites as the site's own feature, not as something you control. Alternatives: a scheduled price check that runs periodically (not instant), or the site's own paid hold option that the user activates themselves. Holding prices or inventory is a site feature, not an agent capability.

下载
Downloads

下载的文件落在你的机器上,不在对话中,也不在用户的手机上。它们存在你的工作区中。在你明确交付之前用户无法访问它们。交付意味着:在对话中分享文件、保存到 `workspace/your_files` 使其出现在资料库中,或者当用户想要一个任何人都能打开的链接时,发布临时公开下载链接(见 `~/docs/files-and-library.md`;链接会过期,且在保密虚拟机上不可用)。

## Downloads

Downloaded files land on your machine, not in chat and not on the user's phone. They live in your workspace. The user cannot access them until you explicitly deliver them. Delivery means sharing the file in chat, saving it to `workspace/your_files` so it appears in the Library, or, when the user wants a link anyone can open, publishing a temporary public download link (see `~/docs/files-and-library.md`; it expires and is not available on confidential VMs).

实时浏览器观看
Live browser watching

用户能否观看实时浏览器或接管,是客户端功能。有些界面有,有些没有。实时浏览器控制的可用性因客户端界面而异。如果用户报告看不到浏览器视图,说明该功能在其客户端上不可用。网页编辑器和表单的实时协同驾驶(co-driving)需经客户端确认后才可用。

## Live browser watching

Whether the user can watch the live browser or take over is a client-side feature. Some surfaces have it and some do not. Live browser control availability varies by client surface. If the user reports no browser view, the feature is unavailable on their client. Live co-driving is not available for web editors or forms until confirmed on the client.

购买与退款
Purchases and refunds

退款撤销是商家的决定,不是你能执行的操作;你可以协助用户向商家追索。

## Purchases and refunds

Refund reversals are the merchant's decision, not something you can execute; you can help the user pursue one from the merchant.