抖音续火花

一个会「断」的社交仪式

抖音的火花机制很简单：和好友或群聊连续互动，火花就会延续；断一天，可能就凉了。问题在于它完全依赖人记得每天发一条消息。一旦忙起来或者忘了打开 App，前几天积累的火花就断了。这个技能要解决的就是这件事——把「记得发」变成可配置、可自动执行的脚本。

它如何工作

这个技能不调用 API，也不走深链（/im/ 会被抖音拦截），而是驱动你本机的真实浏览器，用模拟鼠标点击进入消息列表，逐个给配置好的好友或群发送一条短消息。登录态复用你真实的浏览器 profile：首次扫码一次，session 就持久化在数据目录里，脚本不会读取或存储原始 cookie。

所有个人数据（配置、登录 session、火花历史、日志）都存放在技能目录之外的独立数据目录里。解析优先级为 --data-dir → DOUYIN_XUHUOHUA_HOME（旧版回退 DOUYIN_SPARK_HOME）→ WORKBUDDY_CONFIG_DIR/CODEBUDDY_CONFIG_DIR → ~/.workbuddy/skills-data/douyin-xuhuohua，每个 WorkBuddy 实例的数据彼此隔离。

任何操作前先跑 python scripts/dsk.py config show 查看当前状态，绝不假设配置存在。主要命令包括 init、config、target add|list|update|remove、login、run [--dry-run]、streak、history、automation-plan、doctor、diag、cleanup、purge。CLI 在 stdout 输出单条 JSON envelope，进度与诊断走 stderr。退出码区分了未登录（2）、配置无效/无目标（3）、依赖缺失（4）、部分成功（5）、全部失败（6）、已有实例在运行（7）、未接受免责声明（8）等情况。

发送时每个目标独立处理，一个失败不阻塞其他目标。每条消息发出后会验证聊天中气泡是否出现且输入框清空，验证失败即记为该目标的失败。

想定时运行的话，automation-plan --hour H --minute M [--jitter] 会输出一个 RRULE 和一段自包含 prompt，再通过 automation_update 创建周期性自动化任务。

适用边界与注意点

• 首次使用必须接受一行免责声明（onboarding.disclaimer_accepted=true），否则脚本拒绝发送。
• 依赖 playwright>=1.40，由 doctor 检查；缺失时按提示安装即可。
• 登录依赖真实浏览器窗口扫码，无人值守的机器上需要注意这一步需要有人在场。
• 先用 run --dry-run 确认能正确定位联系人，再开启真实发送。
• 自动化发送本质是一种自动操作行为，使用前建议阅读 references/compliance.md 中的服务条款说明。