tiktok-web-skills

Files (11)

• .gitignore
• AGENTS.md
• CLAUDE.md
• LICENSE
• README.md
• SKILL.md
• manual-reset.md · docs/
• lib.mjs
• context.mjs · scripts/probes/
• search-full.mjs · scripts/probes/
• search.mjs · scripts/probes/

SKILL.md (first lines)

## ⚠️ 前置条件

每个 `tiktok-*` task 跑前必须满足前置条件。流程图：

```mermaid
flowchart TD
    V["V: 验证环境<br/>chrome-devtools CLI + daemon"] --> L["L: tiktok-ensure-login<br/>用户手动登录"]
    V -->|daemon 不通| VR["重置链 stop+start (≤3 次)"]
    VR -->|仍失败| VRC["提示用户手动清理 profile<br/>不自动 rm -rf"]
    VR -->|恢复| V

    L -->|未登录| M["提示用户在 Chrome 手动登录<br/>每 2s 轮询, ≤3 轮"]
    M -->|登录完成| L
    M -->|超时| HALT["abort"]

    L -->|已登录| N["N: tiktok-browser-navigate-to-video"]
    N -->|最终 URL 非视频页| HALT
    N --> H["H: selector 健康检查<br/>输入框/提交按钮可见"]

    H -->|selector 失效| P["probe-deep<br/>人工确认后落库"]
    P --> H

    H -->|OK| C["C: tiktok-post-comment<br/>清空 + 粘贴 + 点击"]
    C -->|检测到验证码/verify| A["用户手动通过验证<br/>不自动重试"]
    A --> C
    C --> R["R: 验证评论流出现新评论<br/>(≤15s)"]

    R -->|verified| Z["完成"]
    R -->|未出现| F["submission_unverified<br/>返回 reason + nextAction"]
    R -->|歧义| F2["ambiguous_verification<br/>不自动重发"]

    style VR fill:#ffe4b5
    style VRC fill:#ffe4b5
    style M fill:#e0f0e0
    style A fill:#e0f0e0
    style HALT fill:#ffcccc
    style F fill:#ffcccc
    style F2 fill:#ffcccc
```

## 启动 daemon

```javascript
import { ensureCli, startDaemon, listPages } from 'file:///Users/jianze/Developer/tiktok-web-skills/lib.mjs';

// 前置校验：chrome-devtools CLI 必须在 PATH
ensureCli();

// userDataDir 必传（不传抛错）—— 不传时 CLI 的 --isolated 默认 true 创建临时 profile
startDaemon({
  userDataDir: '$HOME/Library/Application Support/tiktok-web-skills/chrome-profile'
});
listPages();  // 不通 → 走流程图 VR 路径
```

> chrome-devtools CLI 错误通常不返回非零 exit code；`listPages` / `stopDaemon` / `status` 卡死 10s 超时抛 `CliTimeoutError`（typed error，`code='ETIMEDOUT'`）。`startDaemon` 30s。

## 调用约定

- Agent 调 skill 时读取 `skills/<skill-name>/SKILL.md`，按 `input` / `depends` / `操作步骤` 执行
- **优先调 `lib.mjs` 里的 wrapper** —— wrapper 固定命令结构 + 透传参数 + 结构性排除坏 flag
- TikTok 评论 selector 已填（probe + 端到端验证），参见 [skills/tiktok-post-comment/SKILL.md](skills/tiktok-post-comment/SKILL.md) 顶部 selector 段
- 登录由用户手动完成，skill 不做自动化登录
- **不**捕获网络请求作为 tiktok-post-comment 成功信号（TikTok 走 WebSocket）—— 唯一成功信号 = 评论流出现新评论

## 重置 daemon

破坏性操作：参见 [docs/manual-reset.md](docs/manual-reset.md)。Agent skill 默认不自动 `rm -rf profile` —— 3 次 `stop+start` 仍失败时停下来让用户处理。

## 不做（v1 + v2 范围外）

- scrape comments（抓评论列表）
- open-dm / send-dm
- 评论 API 直连
- 自动登录
- 自动绕过验证码
- `.gitnexus/` 索引
- `token-report.md`

From 271642183/tiktok-web-skills, MIT.

More from 271642183/tiktok-web-skills