核心功能
Toutiao Publisher 是一款面向内容创作者的头条号发布工具，通过浏览器自动化技术解决自媒体运营中的两大痛点：繁琐的重复登录流程和平台的内容规范限制。
使用方式
该工具采用半自动化设计，兼顾灵活性与易用性。首次使用时运行 auth_manager.py setup 完成一次性扫码登录，系统会将浏览器状态持久化保存至 data/browser_state/state.json，后续发布直接调用 publisher.py 即可跳过登录环节直达编辑页面。对于高频发布场景，支持通过命令行参数 --title、--content、--cover 实现全自动化发布，并可通过 --headless 模式在后台静默执行。
显著优势
1. 持久化认证：基于 patchright 的浏览器上下文状态保存技术，实现"一次登录，长期可用"，避免传统爬虫方案频繁的 Cookie 失效问题
2. 反检测机制：集成 stealth 模块对抗平台的风控策略，降低账号异常风险
3. 智能标题优化：内置字节跳动平台规则校验，自动将标题调整至 2-30 字符的合规区间
4. 环境自管理：通过 run.py 封装器自动处理虚拟环境依赖，降低部署门槛
局限性与风险
半自动依赖：核心发布流程仍需人工介入（或依赖外部传入的 Markdown 文件），并非完整的内容生产闭环。完全自动化模式需用户自行准备内容素材，对非技术用户存在使用门槛。
平台政策风险：头条号对自动化工具有明确限制，频繁 API 调用或异常行为可能触发账号风控。工具虽采用浏览器模拟降低特征，但批量发布、高频操作仍可能导致限流或封禁。
技术债务：依赖 patchright（Playwright 的分支）而非官方方案，长期维护稳定性存疑。浏览器状态文件若泄露，相当于凭证失窃。
适合人群
- 个人自媒体运营者：需要管理 1-3 个头条账号，追求"扫码一次、发布多次"的轻量体验
- 内容工作室：有批量分发需求，具备技术能力整合 CMS 与自动化流程
- 营销自动化开发者：可将此作为头条号发布的原子能力，嵌入更大的内容分发系统
安全建议
建议配合账号分级策略使用——日常运营使用低权限账号，主账号保留人工发布。定期执行 auth_manager.py status 检查会话有效性，发现异常及时 clear 清理状态重登。