yida-login

name	yida-login
description	宜搭平台登录态管理技能，通过 Playwright 管理登录态（Cookie 持久化 + 扫码登录），获取 CSRF Token。
license	MIT
compatibility	["opencode","claude-code"]
metadata	{"audience":"developers","workflow":"yida-auth","version":"1.0.0","tags":["yida","auth","login","cookie"]}

宜搭登录态管理技能

概述

本技能提供宜搭平台的登录态管理能力，支持 Cookie 持久化和自动验证，首次使用需扫码登录，后续自动复用 Cookie。

何时使用

当以下场景发生时使用此技能：

• 首次使用宜搭技能，需要扫码登录
• Cookie 过期或失效，需要重新登录
• 其他技能调用时提示登录态异常
• 用户要求手动执行登录

使用示例

示例 1：触发登录

场景：手动触发扫码登录 命令：

python3 .claude/skills/yida-login/scripts/login.py

输出：

{"csrf_token":"b2a5d192-xxx","corp_id":"dingxxx","user_id":"1955225xxx","base_url":"https://abcd.aliwork.com"}

示例 2：刷新 CSRF Token

场景：CSRF Token 失效但 Cookie 有效 命令：

python3 .claude/skills/yida-login/scripts/login.py --refresh-csrf

使用方式

python3 .claude/skills/yida-login/scripts/login.py

无需任何参数，登录地址从项目根目录的 config.json 中读取（loginUrl 字段），登录后可能跳转到 abcd.aliwork.com 等域名。

输出：登录成功后，将 csrf_token、base_url（跳转后的实际域名）和 Cookie 信息以 JSON 格式输出到 stdout，同时 Cookie 持久化到项目根目录的 .cache/cookies.json。

⚠️ 重要：base_url 取自登录成功后浏览器实际跳转到的域名，而非 config.json 中配置的 loginUrl 或 defaultBaseUrl。例如，即使 loginUrl 配置为 https://www.aliwork.com，如果你的账号所属组织对应的是 abcd.aliwork.com，平台会自动跳转，最终 base_url 将是 https://abcd.aliwork.com。后续所有 API 请求（包括 yida-publish 发布）都会使用这个 base_url。如需发布到特定域名，请确保 config.json 中的 loginUrl 指向该域名对应的组织，并且你的账号属于该组织。

项目根目录通过向上查找 config.json 或 .git 目录来定位。

工作流程

1. 检查本地是否存在 .cache/cookies.json 缓存（包含 Cookie 和 base_url）
2. 若存在，直接从 Cookie 中提取 csrf_token（tianshu_csrf_token）、corp_id 和 user_id（tianshu_corp_user），无需访问任何页面
3. 若 Cookie 中无 tianshu_csrf_token，视为失效，打开有头浏览器让用户扫码登录
4. 登录成功后直接从 Cookie 中提取所需信息，保存 Cookie 和 base_url（从登录后实际跳转的 URL 获取）

前置依赖

• Python 3.12+
• playwright（pip install playwright && playwright install chromium）

文件结构

yida-login/
├── SKILL.md           # 本文档
└── scripts/
    └── login.py       # 登录脚本

项目根目录/
├── config.json        # 全局配置（loginUrl、defaultBaseUrl）
└── .cache/
    └── cookies.json   # 登录态缓存（运行时自动生成，含 Cookie + base_url）

输出格式

脚本成功执行后，最后一行输出 JSON：

{
  "csrf_token": "b2a5d192-db90-484c-880f-9b48edd396d5",
  "corp_id": "ding9a0954b4f9d9d40ef5bf40eda33b7ba0",
  "user_id": "19552253733782",
  "base_url": "https://abcd.aliwork.com",
  "cookies": [...]
}

csrf_token 从 Cookie tianshu_csrf_token 的 value 中提取；corp_id 和 user_id 从 Cookie tianshu_corp_user 的 value 中提取，格式为 {corpId}_{userId}，按最后一个 _ 分隔。

base_url 是登录后浏览器实际跳转到的域名（如 https://abcd.aliwork.com），可能与 config.json 中的 loginUrl 不同。其他脚本应使用此值作为 API 请求的基础地址，而非硬编码域名。

其他脚本可通过管道接收并解析 stdout 最后一行获取登录态信息。

缓存格式

.cache/cookies.json 文件格式（兼容旧版纯 Cookie 数组）：

{
  "cookies": [...],
  "base_url": "https://abcd.aliwork.com"
}

csrf_token、corp_id、user_id 不存储在缓存中，每次启动时直接从 Cookie 列表中提取（tianshu_csrf_token 和 tianshu_corp_user 字段）。

全局配置

所有脚本（login.py 及各 JS 脚本）从项目根目录的 config.json 读取配置，不再硬编码 URL：

{
  "loginUrl": "https://www.aliwork.com/workPlatform",
  "defaultBaseUrl": "https://www.aliwork.com"
}

字段	说明
loginUrl	扫码登录页面地址（登录成功后平台可能自动跳转到其他域名）
defaultBaseUrl	API 请求的默认基础地址（仅当 base_url 未从登录态中获取时作为兜底使用，正常流程不会用到）

错误处理机制

各 skill 脚本通过解析接口响应体的 errorCode 字段来判断登录态异常，并自动调用本技能处理：

errorCode	含义	处理方式
"TIANSHU_000030"	csrf 校验失败（csrf_token 过期）	调用 login.py --refresh-csrf 无头刷新 csrf_token，无需重新扫码
"307"	登录状态已过期（Cookie 失效）	调用 login.py 触发完整重新登录（可能需要扫码）

注意：错误判断基于响应体 JSON 的 errorCode 字段，而非 HTTP 状态码。

退出登录

清空本地 Cookie 缓存文件内容即可完成退出，下次调用任意技能时将自动触发重新扫码登录：

echo -n "" > .cache/cookies.json

适用场景：

• 需要切换账号或切换组织
• Cookie 失效且无法自动刷新
• 用户主动要求退出登录

注意：Cookie 缓存文件位于项目根目录（含 README.md 或 .git 的目录）的 .cache/ 目录下。退出登录不影响已部署的页面和已保存的数据。

与其他技能配合

• 退出登录：需要切换账号或 Cookie 失效时，执行上方「退出登录」命令后重新运行任意技能即可触发扫码登录
• yida-publish：发布时自动调用本技能获取登录态
• yida-create-app、yida-create-page、yida-create-form-page：通过管道将本技能输出传入