配置 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 依赖：

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