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

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 定位