Skip to content

Releases: JianHeShui/dsh-douyin

v1.1.0 — Linux 适配 / 私信驱动 / HTTP API

Choose a tag to compare

@JianHeShui JianHeShui released this 23 Oct 15:57

基于上游 SakuraMat0u/dsh-douyin-toolkit 1.0.0(MIT)的改版,面向 Linux / headless 服务器环境。

1.1.0 — 2026-10-23

Fork 后的第一个版本,基于上游 dsh-douyin-toolkit 1.0.0。

新增

  • 私信 / 群聊驱动 python/douyin_im.py:Playwright 驱动抖音网页版,默认 dry-run,三道闸(--send + DOUYIN_IM_ALLOW_SEND=1 + 可选 DOUYIN_IM_ALLOW_TO 白名单),文件锁串行,发送后气泡确认,超时进程组回收。
  • HTTP API python/douyin_http.py:FastAPI,默认 127.0.0.1:7709,暴露 /health /trending /search /detail /profile /status /download /frames /im/*。
  • 视频下载与抽帧:带 cookie 请求移动端分享页,从 _ROUTER_DATA 解析无水印直链,绕过需要 a_bogus 签名的官方详情接口;yt-dlp generic 提取失败时退回 urllib 流式下载;ffmpeg 均匀抽 4–12 帧供视觉模型使用。
  • 登录态导出工具 tools/export_login_state.py:在本地有显示器的电脑上扫码登录并导出 storage_state,解决服务器 headless 无法扫码的问题。
  • DOM 探测工具 tools/probe_im.py:前端改版后采集选择器。
  • 离线测试 tests/test_fixture.py + tests/fixture_chat.html:在仿真 DOM 上验证 dry-run、发送路径、群名后缀匹配、NOT_FOUND,不联网、不发真实消息。
  • 文档:docs/COOKIE-GUIDE.md、docs/HTTP-API.md、docs/SECURITY.md、docs/LINUX-ADAPTER.md。
  • scripts/run-http.{sh,ps1}、scripts/selfcheck.{sh,ps1}、deploy/douyin-api.service。

修改

  • Linux / headless 适配:浏览器发现扩展到 Chromium / Chrome / Playwright 自带内核(版本号目录用 glob 扫描),无 DISPLAY 时自动降级 headless,进程清理增加 POSIX 分支(pkill -f <profile> / pgrep + 启动参数精确匹配)。
  • 路径参数化:所有服务器绝对路径改为环境变量或相对路径(DOUYIN_DATA_DIR、DOUYIN_PYTHON、DOUYIN_BROWSER、DOUYIN_MEDIA_DIR、DOUYIN_COOKIE_FILE 等)。
  • 包名:dsh-douyin-toolkit → dsh-douyin(插件 id 仍为 douyin)。
  • 私信驱动与插件共用同一个 data/ 目录,不再分开维护测试档。

保持不变

  • dy-cli 只读通道、11 个 DSH 工具、错误码、限频与配额、凭证脱敏、登录状态机、账号指纹、douyin_publish 占位接口。

安装

git clone https://github.com/JianHeShui/dsh-douyin.git
cd dsh-douyin

详见 README.md 与 docs/。

⚠️ 抖音对非官方接口有风控,写操作默认全部关闭;请自行评估账号风险。