tiktok-ensure-login

Files (1)

• SKILL.md

SKILL.md (first lines)

## 为什么有这个 skill

TikTok web 的"发评论"必须登录态（未登录用户评论框 disabled 或被反爬拦截）。所有 `tiktok-*` 业务 skill 在执行前**必须**先调本 skill 确认登录态。

**本 skill 不自动登录**——登录由用户手动完成（v1 设计决策）。只检测 + 提示。

## 登录态判定（双层）

### Cookie 辅助（不可靠，HttpOnly）

```js
() => ({
  sessionid: document.cookie.includes('sessionid='),
  sid_tt: document.cookie.includes('sid_tt='),
  uid_tt: document.cookie.includes('uid_tt='),
})
```

命中任一即视为"有信号"，但**不作为唯一判定**——TikTok 部分 cookie 是 HttpOnly，JS 读不到。

### DOM 主判

```js
() => {
  const CURRENT_USER_AVATAR_SELECTOR = 'a[data-e2e="nav-profile"]';  // header 区可见的当前用户入口
  const LOGIN_BUTTON_SELECTOR = '';  // 留空，用 JS 文本匹配兜底（TikTok 登录按钮 data-e2e 不稳定）

  const hasAvatar = !!document.querySelector(CURRENT_USER_AVATAR_SELECTOR);
  const hasLoginBtn = !!document.querySelector(LOGIN_BUTTON_SELECTOR) ||
                      Array.from(document.querySelectorAll('button, a'))
                        .some(el => /log\s*in|sign\s*up/i.test(el.textContent || ''));
  const onLoginPage = /\/login|\/signup/.test(location.pathname);
  const hasCaptcha = !!document.querySelector('[class*="captcha" i]:not([class*="Badge" i]), iframe[src*="captcha" i], iframe[src*="verify" i], [class*="SliderCaptcha" i], [class*="challenge" i]');

  return { hasAvatar, hasLoginBtn, onLoginPage, hasCaptcha };
}
```

判定规则：
- `hasAvatar && !hasLoginBtn && !onLoginPage && !hasCaptcha` → **已登录**
- `onLoginPage || (hasLoginBtn && !hasAvatar)` → **未登录**
- `hasCaptcha` → **`verify_required`**，暂停让用户手动通过
- 头像存在但登录按钮也存在 → **异常态**，返回 `inconsistent_state` 让上层决定

## 验证码检测（独立）

`[class*="captcha"], [class*="verify"], iframe[src*="captcha"]` 命中 → 返回 `verify_required`，提示用户在 Chrome 手动通过。**不自动重试**。

## 操作步骤

1. 调用 `browser-navigate` 到 `https://www.tiktok.com/`，等 `domcontentloaded`
2. 用 `evaluate_script` 跑上面的 DOM 判定函数
3. 若 `logged_in = true` → 提取当前用户标识：
   - `document.querySelector('[data-e2e="user-avatar"]')?.getAttribute('alt')` 或
   - 链接到 `/@<username>` 的 `a[href*="/@"]` 元素文本
   返回成功
4. 若 `logged_in = false`：
   a. 终端向用户提示：
      ```
      请在已打开的 Chrome 窗口中手动登录 TikTok。
      不要关闭该窗口；登录完成后告诉我"继续"。
      ```
   b. 启动轮询：每 2 秒重跑 DOM 判定，最多 `max_rounds` 轮，每轮 `max_wait_seconds` 秒超时
   c. 命中 → 跳到步骤 3 二次确认（防页面自动刷新导致误判）
5. 若 `verify_required`：返回，**不轮询**，让用户手动通过后重试
6. 超时仍未登录 → 返回 `{ logged_in: false, reason: 'timeout' }`

## 返回格式

成功：
```
已确认登录，当前用户：{nickname}
```

失败：
```
登录失败：{reason}
reason ∈ { timeout, verify_required, inconsistent_state, cli_unavailable }
```

## 经验与陷阱

- **HttpOnly cookie**：仅靠 `document.cookie.includes('sessionid=')` 不可靠，**必须**配合 DOM 判定
- **`sessionid` 跨域**：TikTok 的 sessionid 不是简单 `sessionid=`，可能是 `sessionid=xxx%3D%3D`，判断时用 `includes('sessionid=')` 即可
- **页面自动刷新**：登录完成后 TikTok 可能 reload 页面，DOM 判定瞬时返回不一致 → 二次确认防误判
- **不要用 tiktok.com 的 cookie 当唯一信号**：TikTok 跟 douyin 不同，未登录也能种下部分 cookie
- **不重试 verify_required**：验证码需要人眼判断，agent 重试无意义
- **`max_rounds` 上限由调用方决定**：skill 内部只做"单次判定 + 单轮轮询"，调用方决定重试策略

## Selector 更新

DOM 判定里的 `CURRENT_USER_AVATAR_SELECTOR` 和 captcha selector 是探测后填入的。selector 失效 → 跑 `skills/tiktok-post-comment/scripts/probe-deep.mjs`（参见 [skills/tiktok-post-comment/SKILL.md](../tiktok-post-comment/SKILL.md)）重新探测，不盲猜。

From 271642183/tiktok-web-skills, MIT.

More from 271642183/tiktok-web-skills