platform-login

name	platform-login
description	平台二维码登录工具：打开登录页、截取QR码、等待扫码确认。公共工具，主/子系统均可调用。
tools	platform_login
metadata	{"category":"tools","emoji":"🔐","tree_id":"auth/platform_login","tree_group":"auth","min_tier":"task_light","approval_type":"plan_confirm","enabled_when":"always","security_level":"sandboxed","intent_keywords":{"zh":["登录","扫码登录","平台登录","登录小红书","小红书登录","配置小红书"],"en":["login","qr login","platform login","xhs login","xiaohongshu login","configure xhs"]},"related_tools":["browser_config","media_config","browser"],"scene_hint":"配置平台→browser_config.get检查→platform_login.start登录→platform_login.wait确认→media_config.update更新渠道","summary":"Login to platforms via browser QR code scan (currently supports Xiaohongshu)","title":"Platform Login","verb":"Login","file_access":"none","policy_groups":["group:auth"],"profiles":["full"],"sort_order":33,"tool_description":"平台扫码登录工具，通过浏览器自动打开登录页并截取QR码。Actions: start(打开登录页+截QR), wait(等待扫码完成), status(查询登录状态)。支持平台: xiaohongshu。","tool_input_schema":{"type":"object","properties":{"action":{"type":"string","enum":["start","wait","status"],"description":"start=open login page and capture QR screenshot, wait=poll for scan completion, status=check current auth state"},"platform":{"type":"string","enum":["xiaohongshu"],"default":"xiaohongshu","description":"Target platform (currently only xiaohongshu)"},"timeout_ms":{"type":"integer","default":120000,"description":"Timeout in milliseconds for wait action"}},"required":["action"]}}

平台登录工具 (platform_login)

公共工具，主系统和子系统均可调用。通过浏览器自动化打开登录页、截取 QR 二维码、等待用户扫码完成登录。

支持的平台

平台	platform 参数	登录方式
小红书	xiaohongshu	浏览器 QR 扫码

工具参数

参数	类型	必填	默认值	说明
action	string	是	-	start=打开登录页并返回 QR 截图, wait=等待扫码完成, status=查询当前登录状态
platform	string	否	xiaohongshu	目标平台
timeout_ms	integer	否	120000	wait 动作超时时间（毫秒）

标准调用流程

1. platform_login(action="start", platform="xiaohongshu")
   → 返回 QR 二维码截图（多模态图片）
2. 向用户展示："请扫描此二维码登录小红书"
3. platform_login(action="wait", platform="xiaohongshu")
   → 返回 {status: "authenticated", cookieCount: N}
4. 向用户确认："小红书登录成功"

委派指引

• 仅需登录 → 直接调用 platform_login
• 登录后继续发布/互动 → 委派给对应子智能体（如 spawn_media_agent），子智能体 SOP 中会自动处理登录
• Cookie 过期报错 → 提示用户需要重新登录，调用 platform_login(action="start")

用户交互提示

QR 码返回后向用户发送：

请使用小红书 App 扫描此二维码完成登录。扫码后我会自动确认登录状态。

错误处理

错误场景	处理方式
浏览器不可用	提示用户检查浏览器配置
截图失败	工具自动降级为纯文本提示，告知用户在浏览器窗口查看 QR 码
等待超时	提示用户重新扫码或检查网络
平台不支持	返回错误，列出当前支持的平台
未配置平台	提示用户在 gateway 配置中启用对应平台