with one click
yida-login
// 宜搭登录态管理。扫码登录,Cookie 持久化到 .cache/cookies.json。不适用于:已有有效登录态时(先用 openyida env 确认),或切换组织时(应先 logout 再重新登录)。
// 宜搭登录态管理。扫码登录,Cookie 持久化到 .cache/cookies.json。不适用于:已有有效登录态时(先用 openyida env 确认),或切换组织时(应先 logout 再重新登录)。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | yida-login |
| description | 宜搭登录态管理。扫码登录,Cookie 持久化到 .cache/cookies.json。不适用于:已有有效登录态时(先用 openyida env 确认),或切换组织时(应先 logout 再重新登录)。 |
openyida login 命令获取并缓存到 .cache/cookies.json.cache/cookies.json,必须重新执行登录流程openyida env 确认环境和登录态.cache/cookies.json 持久化,不依赖跨会话的 memory 状态| 用户意图 | 触发条件 |
|---|---|
| 首次使用或 Cookie 失效 | 其他命令报 401/未登录错误时自动触发 |
| 切换账号/组织 | 先 openyida logout 再重新登录 |
正向触发:
.cache/cookies.json不适用场景(不要触发):
openyida env 确认)openyida logout 再重新登录)通常无需手动调用,其他命令在 Cookie 失效时会自动触发登录。
openyida login
默认登录路径不需要 Playwright:优先复用缓存;Codex、Qoder、悟空、Claude Code、OpenCode、Cursor 等可检测到的 AI 工具先尝试本地 Chrome/Edge/Chromium CDP 登录,CDP 不可用时再使用二维码 handoff;其他终端环境使用二维码登录。openyida login --browser 优先使用本地 Chrome/Edge/Chromium CDP,CDP 不可用时才用 Playwright 兜底。
在 AI 对话框环境中没有有效缓存,且本地 CDP 浏览器登录不可用时,openyida login 返回 need_qr_scan JSON,包含 qr_image_markdown、agent_response_markdown、qr_image_file、qr_url、poll_command 和 session_file。
收到 need_qr_scan 后:
qr_image_markdown,或原样粘贴 agent_response_markdown;不要只展示 qr_image_file 文件路径或 qr_urlpoll_commandneed_corp_selection,优先调用 OpenYida MCP 工具 select_yida_login_organization,传入 session_file,由 MCP 原生选择控件完成组织选择和 Cookie 写入不要手动编造或写入 Cookie。多组织选择优先使用 --corp-id <corpId> 或 MCP 原生组织选择控件,不要把组织列表塞进普通聊天选择控件。
需要强制本地浏览器登录时使用:
openyida login --browser
--browser 优先使用本地 Chrome / Edge / Chromium CDP,CDP 不可用时才用 Playwright 兜底。
下面这些是兼容旧版 AI 内置浏览器 handoff 的显式命令,只有用户明确要求内置浏览器 handoff 时才使用:
openyida login --codex
openyida login --qoder
openyida login --wukong
若宿主 in-app browser 缺少 Cookie 导出到 CLI 缓存的桥接能力,不要手动编造或写入 Cookie,改用默认登录或显式 openyida login --agent-qr。
需要强制使用 AI 工具二维码 handoff 时:
openyida login --agent-qr
该命令返回 need_qr_scan JSON,包含可直接渲染的 qr_image_markdown 和 agent_response_markdown。扫码后执行 poll_command。兼容旧命令 openyida login --codex-qr。
{"csrf_token":"b2a5d192-xxx","corp_id":"dingxxx","user_id":"1955225xxx","base_url":"https://abcd.aliwork.com"}
base_url取自登录后浏览器实际跳转到的域名,可能与config.json中的loginUrl不同。后续所有 API 请求使用此值。
各命令通过响应体 errorCode 自动处理登录态异常:
| errorCode | 含义 | 处理方式 |
|---|---|---|
TIANSHU_000030 | CSRF Token 过期 | 自动无头刷新 |
307 | Cookie 失效 | 自动重新登录 |
| 异常场景 | 处理方式 |
|---|---|
| 扫码超时 | 重新执行 openyida login,二维码有时效限制 |
| 登录后 Cookie 仍无效 | 检查 .cache/cookies.json 是否正确写入,执行 openyida env 验证 |
| 反复登录失败 | 停止重试,提示用户联系开发同学 @天晟,不要自主尝试其他登录方案 |
| CSRF Token 过期(TIANSHU_000030) | 自动无头刷新,无需手动干预 |
| Cookie 失效(307) | 自动重新登录,无需手动干预 |