Douyin Skills

# 抖音自动化技能包

使用本项目的本地 CLI 驱动本机 Chrome，处理登录、内容发现、图文/视频发布和基础互动。

## 执行入口

- 将 `{baseDir}` 视为当前 Skill 的绝对目录。
- 只通过 `python "{baseDir}/scripts/cli.py" <子命令>` 操作抖音。
- 如果系统只有 `python3`，将示例中的 `python` 替换为 `python3`。
- 首次使用或环境变化后先运行：

```bash
python "{baseDir}/scripts/cli.py" doctor
```

CLI 始终输出 JSON。根据字段判断结果，不要只看进程退出码或按钮是否被点击。

在依赖特定字段前运行以下命令读取运行时与结果契约版本：

```bash
python "{baseDir}/scripts/cli.py" version
python "{baseDir}/scripts/cli.py" capabilities
```

解析规则、确认/未确认状态和退出码见 `{baseDir}/docs/RESULT_CONTRACT.md`。

`capabilities` 提供当前命令、参数和影响类型，不代表用户授权。只读排查浏览器时使用 `browser-status`；只有本地排查需要时加 `--include-tabs` 显示标题和 URL。全局 `--target-id` 可显式接管已有页面；会话丢失后的发布后续步骤会停止，不能随意选取其他标签页。迁移细节见 `{baseDir}/docs/RUNTIME.md`。

## 路由任务

| 用户意图 | 使用子技能 |
| --- | --- |
| 检查登录、扫码、短信验证、多账号 | `douyin-auth` |
| 安装、迁移、依赖检查、检查更新、设置下载目录 | `douyin-env` |
| 搜索、读取公开作品详情、查看热门话题 | `douyin-explore` |
| 图文/视频表单、封面、音乐、发布 | `douyin-publish` |
| 点赞、收藏、评论、获取分享链接 | `douyin-interact` |

多步骤请求按 `认证 → 内容准备/搜索 → 发布或互动 → 结果确认` 的顺序组合子技能。

## 共同约束

1. 将实际抖音页面操作限制在本项目 CLI；可以使用普通文件或图片工具准备、检查素材，但不要换用另一套抖音自动化实现。
2. 只连接 loopback Chrome 调试地址，不向局域网或公网暴露 CDP。
3. 优先复用同一端口上已有的可用 loopback Chrome 调试实例，不因 headless/headed 偏好差异重启用户的登录会话；没有可用实例时才按默认模式启动 Chrome。导航后若短暂出现验证码/风控中间页，CLI 会先做有限稳定重检，并在切到 headed 后重新判定当前页面；`risk_recovered: true` 且 `logged_in: true` 时直接继续。只有 JSON 明确返回 `needs_user_verification: true` 才停下请用户人工处理；不要仅凭标题、页面片段或旧的 `risk_page` 结果暂停，也不要尝试绕过验证。
4. 在任何会改变账号状态的操作前确认目标账号与目标作品。用户明确提出“点赞/收藏/评论/发布该内容”可视为本次操作授权。