抖音投稿助手 7gzgn/dsh-douyin-publish

dsh-douyin-publish（抖音发布器）

把一段本地视频，一路送到抖音投稿页的「待发布」状态。

打开投稿页 → 真实点上「上传视频」→ 把文件交给系统对话框（含回读校验）→ 填标题 → 设可见性 → 默认停手。

这是四个作品里唯一的「功能」（前三个都是工具）：它不止给 AI 加一个动作，而是替使用者跑完一条链 —— 开页面、点按钮、交文件、填表、判断该不该发。
也正因为如此，它的默认值必须保守。

两条默认值是刻意的

| 参数 | 默认 | 要改成别的必须显式说 |
| visibility | private（仅自己可见） | visibility: 'public' / 'friends' |
| mode | draft（不点发布） | mode: 'publish' |

发布是不可逆且对外可见的动作。所以这个插件默认只做到「表填好、停发布前」，你要发，就再说一次。想先看看会发生什么，用 dryRun: true。

它做什么（每一步都留证据）

| 步 | 动作 | 细节 |
| ① | 检查视频 | 大小 / 分辨率 / 时长 / 编码（ffprobe，拿不到也不拦） |
| ② | 借浏览器会话 | 用自己的会话键，和别的任务不串台 |
| ③ | 打开投稿页 | creator.douyin.com/creator-micro/content/upload |
| ④ | 等上传控件 | 轮询到 input[type=file] 出现为止 |
| ⑤ | 真实点击「上传视频」 | 程序化 click() 不会弹系统对话框，必须真点 |
| ⑥ | 递文件 | 等对话框 → 填路径（走剪贴板）→ 回读逐字比对 → 点确认 |
| ⑦ | 等编辑页 | 轮询到 URL 含 /content/post/video |
| ⑧ | 填标题 | 按页面上真实的 placeholder 定位 |
| ⑨ | 设可见性 | 按页面上真实的中文标签点（公开 / 好友可见 / 仅自己可见） |
| ⑩ | 发布，或故意不发布 | mode=draft 时这一步记 skipped |

失败会分类说清：no-browser / no-dialog / handover / edit-page-timeout / visibility / publish。

它依赖什么

- 浏览器插件（借宿主的 ctx.browser 服务）—— 没有时明确报错，不会假装能用。
这是刻意的：官方浏览器插件的工具层也是同一条路（inject 里带 browser）。
- 系统「打开文件」对话框能力：自带 lib/handover.ps1（与作者的 dsh-file-handover 同源，但四个插件各自独立成仓，不互相依赖）。
- 可选：ffprobe（没有也能发，只是少了元信息）。

安装

市场收录后在 DSH 里搜 dsh-douyin-publish 安装。手动安装：

New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-douyin-publish" -Target "D:\dsh\projects\dsh-douyin-publish"
profile 的 package.json：dependencies 加 "dsh-douyin-publish": "link:D:/dsh/projects/dsh-douyin-publish" 并把 "dsh-douyin-publish" 加进 dsh.profile.bundles（漏了不加载）→ 重启 DSH

发布前先做这两件事：① 装好浏览器插件；② 在浏览器窗口里登录抖音创作者中心 （登录态存在浏览器 profile 里，一次登录可跨重启复用）。

用法

工具（在 DSH 里）

douyin_upload videoPath=D:\videos\a.mp4 title="标题" [topics="猫,狗"] [visibility=private] [mode=draft|publish] [dryRun]

典型流程：dryRun: true 看一眼 → 正式跑一次（停发布前）→ 到浏览器里核对 → mode: 'publish' 真发。

命令（不依赖浏览器的那一半）

dsh-douyin-publish check --video "D:\videos\a.mp4"

已知限制

- 版式绑定：选择器基于 2026-10-16 实测的创作者中心版式；抖音改版后需要同步更新。
- 话题（topics）v0.1 只记进回执，不代填 —— 话题框的行为要先摸清再说。
- 验证码 / 风控不硬试：检测到就停下请人到浏览器窗口处理，再继续。
- 仅 Windows：递文件那一段依赖 EnumWindows / UI Automation / PowerShell。
- 不做内容创作：剪片、封面、文案是内容管线的事（用 ffmpeg 等），这个插件只负责「送上去」。

自测

node test/smoke.mjs # 假浏览器 + 假 spawn：断言编排序列、默认值、失败分类；不碰抖音

License

MIT