浏览器任务模式

浏览器任务模式（Browser Task）用于让 ToCodex 在真实浏览器环境中完成需要“看页面、点按钮、填表单、读取网页内容”的任务。它适合处理传统代码工具无法直接完成的网页交互，例如登录管理后台、筛选数据、导出报表、检查页面状态或调试前端问题。

适用场景

当任务需要与网页界面交互时，优先考虑浏览器任务模式：

打开并操作网站、控制台、管理后台、CMS 或 SaaS 系统。
在网页中点击按钮、切换标签页、选择菜单、展开下拉框。
填写表单、提交配置、创建记录或修改后台字段。
查询页面数据、筛选列表、复制结果、整理信息。
下载或生成后台报表，并根据页面结果输出总结。
复现前端问题，例如页面报错、按钮无响应、样式异常、登录跳转异常。
检查线上页面的实际展示效果，而不仅仅是阅读源码。

如果只是读取公开网页文档或 API 说明，通常使用普通网页获取能力即可；只有当任务需要真实浏览器交互时，才切换到浏览器任务模式。

启动方式

你可以直接描述要完成的网页任务，ToCodex 会在需要时切换或创建浏览器任务。例如：

使用浏览器任务模式打开管理后台，查询今天新增用户数量，并整理成一段报告。

也可以明确要求进入浏览器任务模式：

请用浏览器任务模式登录后台，检查订单列表中最近 10 条失败订单。

启动任务时，建议提供以下信息：

目标网址：例如后台地址、控制台地址或具体页面链接。
操作目标：例如查询数据、修改配置、生成报表、验证页面状态。
必要账号信息的处理方式：不要在聊天中发送密码、密钥或敏感令牌；优先使用浏览器中已登录的会话、临时测试账号或由你手动完成登录。
输出格式：例如表格、摘要、步骤记录、异常截图说明或报告内容。

网页操作能力

浏览器任务模式可以模拟常见人工浏览器操作：

打开指定 URL，并等待页面加载完成。
点击导航、按钮、链接、图标和菜单项。
在输入框中输入关键词、编号、日期范围等内容。
选择下拉框、单选框、复选框和日期控件。
滚动页面，查找隐藏在下方的内容。
读取页面上的文本、表格、提示信息和错误信息。
在多个页面或标签之间切换，跟踪业务流程。
根据页面反馈调整下一步操作。

为了提高成功率，任务描述应尽量包含页面路径、按钮名称、筛选条件和判断标准。例如：“进入用户管理 > 用户列表，筛选注册时间为今天，统计状态为正常的用户数”。

表单填写

浏览器任务模式适合完成重复性或结构化表单操作，例如创建活动、填写配置、提交工单或录入数据。

建议将表单需求写清楚：

打开活动后台，新建一个活动：
- 活动名称：夏季会员专享
- 开始时间：2026-06-01 10:00
- 结束时间：2026-06-30 23:59
- 状态：草稿
填写后不要提交，停在预览页面让我确认。

填写表单时应注意：

对生产环境中的提交、删除、发布、支付、发送通知等高风险操作，需要明确授权。
对不可逆操作，应要求 ToCodex 先停在确认页面，不自动点击最终确认。
对复杂表单，最好逐项列出字段名称和值，避免歧义。
对批量录入任务，建议提供结构化数据，例如表格、CSV 内容或清晰的列表。

后台系统操作

在管理后台、运营系统、CRM、数据平台等场景中，浏览器任务模式可以帮助完成常见运营和排查工作：

查询用户、订单、工单、账单、日志或活动记录。
按日期、状态、关键词、地区、渠道等条件筛选数据。
查看详情页，提取关键字段并汇总。
生成日报、周报、运营报告或异常清单。
检查配置是否生效，例如开关状态、权限配置、版本号、发布时间。
对比不同页面的数据是否一致。

对于后台系统，建议优先使用只读查询任务。涉及修改配置、删除数据、发送消息、审批流程等操作时，应清楚说明边界，并要求在最终提交前暂停确认。

调试用途

浏览器任务模式也可以辅助前端调试和线上问题排查：

复现指定页面的报错流程。
检查按钮点击后是否触发预期跳转或接口请求。
观察页面加载、空状态、错误提示和权限提示。
验证修复后的页面在浏览器中的真实效果。
帮助描述问题复现步骤，便于后续交给代码模式修复。

示例：

用浏览器任务模式打开订单详情页，复现“点击导出无响应”的问题，记录复现步骤、页面提示和可能的异常位置。

浏览器任务模式关注“页面实际行为”；如果需要修改源码、运行测试或修复逻辑，通常应再切换到代码模式处理。

注意事项

使用浏览器任务模式时，请遵循以下原则：

保护敏感信息：不要在对话中粘贴密码、验证码、私钥、访问令牌或客户隐私数据。
谨慎执行高风险操作：删除、发布、付款、群发、审批、封禁等操作需要明确授权。
优先使用测试环境：涉及配置变更或数据写入时，尽量在测试环境验证。
明确停止点：如果只需要填写到确认页，请说明“不要最终提交”。
提供判断标准：例如“看到成功提示即停止”“导出文件出现后汇总文件名”“筛选结果为空则报告为空”。
避免过度自动化：验证码、人机验证、金融交易等流程应由用户手动完成关键步骤。
记录结果：重要操作完成后，应输出操作路径、筛选条件、结果摘要和异常信息。

示例任务

示例一：打开管理后台

请用浏览器任务模式打开 https://admin.example.com。
如果已经登录，进入「系统设置 > 版本信息」，读取当前前端版本、后端版本和发布时间，并用中文列出结果。
如果未登录，请停在登录页并提示我手动登录。

适合用于快速检查后台状态、版本信息、配置开关和系统健康情况。

示例二：查询数据

请用浏览器任务模式进入管理后台的「订单管理」。
筛选条件：
- 日期：今天
- 订单状态：失败
- 支付渠道：全部

读取失败订单总数，并抽取前 10 条订单的订单号、用户 ID、失败原因和创建时间，整理成 Markdown 表格。

适合用于运营排查、异常统计、客服辅助和数据核对。

示例三：生成报告

请用浏览器任务模式打开数据看板，查询本周新增用户、活跃用户、付费订单数和收入。
将结果整理成一份中文周报，包括：
1. 核心指标表格
2. 环比变化说明
3. 需要关注的异常点
4. 建议后续动作

适合用于从后台页面读取指标，并将分散数据整理成可直接发送的报告。