用途
tiktok-upload 用于登录 TikTok 并发布视频。当前 TikTok 没有 sau tiktok 命令行入口，实际使用的是仓库中的 uploader/tk_uploader/main_chrome.py，因此不能虚构 CLI 参数。
主要能力
- 使用仓库现有的 Patchright/Playwright Chrome 上传器操作 TikTok 发布流程。
- 账号会话保存在 cookies/tk_uploader/account.json。
- 首次登录可参考 examples/get_tk_cookie.py，由用户本人在 TikTok 页面完成登录。
- 支持单条视频发布，通过 publish_date=0 表示立即发布。
- 定时发布需传入明确的 datetime，不应自行推算发布时间。
- TiktokVideo 没有独立简介参数。
使用方式
运行前需确认仓库依赖已安装、conf.py 中的 Chrome 配置正确，并取得用户提供的视频路径。单条视频可按仓库 API 流程执行：
import asyncio from pathlib import Path from conf import BASE_DIR from uploader.tk_uploader.main_chrome import TiktokVideo, tiktok_setup
account_file = Path(BASE_DIR) / "cookies" / "tk_uploader" / "account.json" video_file = Path(BASE_DIR) / "videos" / "demo.mp4" asyncio.run(tiktok_setup(str(account_file), handle=True)) app = TiktokVideo("标题", str(video_file), ["标签"], 0, str(account_file)) asyncio.run(app.main())
仓库中的 examples/upload_video_to_tiktok.py 会批量处理目录下 MP4、自动从文件提取标题与标签，并安排次日 16:00 发布；除非用户明确要求这些行为，不要直接运行该脚本。
适用场景
适用于用户需要发布 TikTok 视频，且当前环境可访问本仓库、具备本地 Chrome 配置与有效账号会话的情况；可用于单条视频的立即或指定时间发布。
限制与注意事项
- 不得读取、复制或提交 cookie 文件。
- 每次发布前让用户确认账号、单条视频、标题、标签及立即或定时方式。
- 页面布局或登录状态不符合预期时应停止并报告。
- 只有平台页面确认提交后才报告成功；结果未知时先核查 TikTok Studio，不能直接重发。
- 资料未提供收费、价格、支持平台范围或发布效果等信息，暂未提供。