Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
DevOps & cloud

douyin-env

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

zJay26 · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add zJay26/douyin-skills --skill douyin-env

About this skill


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

配置 douyin-skills 环境

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

定位项目

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

环境要求

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

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

安装依赖

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

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

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

运行自检

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

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

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

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

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

可选更新

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

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> 设置。关闭后停止自动请求,手动检查仍可用。

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

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 中的常见安装位置。仍未找到时设置:

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 安装完整仓库。手工迁移时复制整个项目,至少保留:

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 错误,不要擅自删除账号配置。