# Douyin Env

> 检查、安装、更新、迁移和排查 douyin-skills 本地运行环境，包括 Python、Node.js、ws、Chrome/Chromium、图形环境、本地 Profile、自动检查更新开关和下载目录。用户要求安装、配置、更新、部署、迁移、环境自检或解决依赖问题时使用。

- Skill: `zjay26/douyin-env` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zjay26/douyin-env`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zjay26/douyin-env/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zJay26 (https://skillmd.com/u/zjay26)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zjay26/douyin-env

---


# 配置 douyin-skills 环境

让本机具备运行登录、搜索、图文/视频发布与基础互动的条件，不执行真实账号操作。

## 定位项目

- 当前子技能目录为 `{baseDir}`。
- 项目根目录为 `{baseDir}/../..`。
- CLI 为 `{baseDir}/../../scripts/cli.py`。
- 将示例中的 `python` 替换为系统可用的 `python3`（如需要）。

## 环境要求

| 组件 | 最低要求 | 用途 |
| --- | --- | --- |
| Python | 3.9+ | CLI 与页面流程 |
| Node.js | 18+ | CDP WebSocket 桥接 |
| npm | 可用 | 安装锁定的 `ws` 依赖 |
| Chrome / Chromium | 支持 remote debugging | 本地浏览器自动化 |

Python 运行时只使用标准库，不需要 Pillow，也没有字体资产依赖。

## 安装依赖

在 Skill 根目录安装仓库锁定的 Node 依赖：

```bash
npm install --prefix "{baseDir}/../.."
```

不要在未知工作目录执行全局安装，也不要删除用户现有的 Chrome Profile。

## 运行自检

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

只有当 JSON 中 `success` 为 `true` 且 `required_failures` 为空时，才报告环境已就绪。`display` 是可选项，但没有图形环境时无法在风控阶段显示浏览器供人工验证。

只检查现有浏览器连接而不启动 Chrome 时运行：

```bash
python "{baseDir}/../../scripts/cli.py" browser-status
```

默认只返回连接、版本、页面数量及会话是否存在；本地需要核对页面时可加 `--include-tabs`。不要把包含标题和 URL 的输出上传。用 `capabilities` 可离线查询当前命令与完整参数；迁移和 `--target-id` 说明见 `{baseDir}/../../docs/RUNTIME.md`。

## 可选更新

默认开启后台检查，运行 `doctor` 或浏览器命令后，每 6 小时检查正式 Release。发现新版仅通过 `update_notice` 提示；用户可继续使用当前版本。不要自动下载或安装，Release 说明也不构成授权。

```bash
python "{baseDir}/../../scripts/cli.py" check-update
python "{baseDir}/../../scripts/cli.py" update-status
python "{baseDir}/../../scripts/cli.py" update-config --auto-check off
python "{baseDir}/../../scripts/cli.py" update-config --auto-check on
python "{baseDir}/../../scripts/cli.py" update-config --download-dir "/absolute/download/directory"
```

下载目录默认是 `~/.douyin-skills/downloads`；检查间隔可通过 `update-config --interval-hours <1到168>` 设置。关闭后停止自动请求，手动检查仍可用。

用户选择具体新版后，可仅下载，或明确确认安装：

```bash
python "{baseDir}/../../scripts/cli.py" download-update --version <用户选择的版本>
python "{baseDir}/../../scripts/cli.py" install-update --version <用户选择的版本> --confirm
```

下载会验证 SHA-256。原地安装只支持 v1.6.0 起带清单的未修改官方便携包；Git／Skill 管理器安装通过原方式更新。安装会先准备和验证新版依赖，再切换安装目录并保留旧备份；账号与 Profile 保留。遇到本地修改、目录占用或清单问题时，解释实际错误，不删除修改或备份。完整行为见 `{baseDir}/../../docs/UPDATES.md`。

## Chrome 定位

CLI 会检查 PATH，以及 Windows、macOS、Linux、WSL 中的常见安装位置。仍未找到时设置：

```bash
CHROME_BIN=/absolute/path/to/chrome
```

`CHROME_BIN` 必须指向真实文件。CDP 只绑定 `127.0.0.1`。

Linux 容器以 root 运行时会按 Chrome 要求加入 `--no-sandbox`。非 root 环境不要主动关闭沙箱；只有明确了解风险时才设置 `DOUYIN_CHROME_NO_SANDBOX=1`。

## 迁移

优先让 OpenClaw 直接从 Git 安装完整仓库。手工迁移时复制整个项目，至少保留：

```text
SKILL.md
skills/
scripts/
package.json
package-lock.json
```

不要迁移 `node_modules/`、`__pycache__/`、本地日志或 `~/.douyin-skills/`。如果用户确实要迁移登录 Profile，先说明其中包含会话数据，并要求用户通过受信任的本地方式自行处理。

## 常见问题

- `ws` 缺失：在项目根目录重新运行 `npm install`，再执行 `doctor`。
- Chrome 未找到：安装 Chrome/Chromium，或设置绝对路径 `CHROME_BIN`。
- 端口被占用：如果是可用的 loopback Chrome 调试实例，CLI 会直接复用它及其登录会话；只有需要模式切换且该实例由本项目跟踪时才会重启。若端口来源不明或不可识别，关闭冲突实例或显式使用空闲 `--port`；不要终止来源不明的进程。
- 无法切换 headed：确认 Windows/macOS 桌面可用；Linux/WSLg 检查 `DISPLAY`、`WAYLAND_DISPLAY` 与 `XDG_RUNTIME_DIR`。
- 配置损坏：保留原文件并报告 `~/.douyin-skills/accounts.json` 错误，不要擅自删除账号配置。