云表 Web CDP 自动登录流程

要解决的问题

云表 Web 的自动化任务经常先卡在登录环节：页面可能不是标准登录表单，而是登录中间页；也可能需要先点击“系统账号登录”才出现用户名和密码输入框。如果只按“打开页面、输入账号、点击登录”处理，很容易在错误页面停止。另一方面，登录地址、账号和密码也不适合直接写死在技能或脚本里，尤其是多环境、多租户或无人值守场景。

技能如何工作

这个技能把登录过程抽象成一组可验收的 Chrome CDP 步骤，核心是只执行流程，不保存凭据。baseUrl、username、password 必须由当前任务、运行时参数、环境变量或安全配置提供；缺少任一字段时只能报告缺失，不能猜测或回填默认值。

典型执行路径是：

• 打开 baseUrl，判断当前页面是否已经是登录页或登录中间页。
• 如果页面存在 “系统账号登录” 入口，先点击进入账号密码登录模式。
• 定位用户名输入框、密码输入框和登录按钮，使用外部提供的凭据填写并提交。
• 等待登录后的跳转、首页加载或页面状态稳定。
• 通过页面信号确认是否真正进入系统，而不是停留在登录页或错误页。

这里的成功标准比较具体：登录表单消失，当前页面进入系统首页或目标首页，页面处于已登录状态，并且没有出现明显登录错误提示。技能不把“点击了登录按钮”或“已生成 token”直接当成完成，因为中间状态仍可能失败。

适用边界与注意点

该技能适合作为云表系统登录、无人值守进入首页、以及后续页面验证的前置步骤。它依赖 Chrome CDP 运行时能力，但不负责选择浏览器介质，也不负责 Chrome 启动策略本身。因此，运行环境必须已经提供可用的 CDP 会话或浏览器控制能力。

需要注意三点：第一，所有输入都必须是外部提供的，避免硬编码地址、账号或密码；第二，如果页面结构变化导致无法识别登录入口，技能应停留在可诊断状态，而不是盲目提交；第三，后续业务验证只有在确认进入登录后上下文后继续，不能把登录按钮点击当作业务就绪。