chore: 初始化仓库（排除 adb 二进制文件以解决推送超时）

tasks/douyin/actions/__init__.py

@@ -0,0 +1,21 @@
+"""抖音操作注册包。import 触发各操作注册。
+
+加新抖音操作：新建 xxx.py，在下面加一行 from . import xxx。
+注意：必须先从 base 导入 ACTIONS，再导入各操作模块，否则循环导入。
+"""
+# 先初始化注册表（base.py 里定义了 ACTIONS = create_action_registry()）
+from .base import (
+    BaseAction, register_action, create_action_registry,
+    list_actions, get_action, should_trigger,
+    ACTIONS,
+    list_action_types, get_action_class,
+)
+
+# 再导入各操作模块，触发 @register_action(ACTIONS) 注册
+from . import like  # noqa: F401
+
+__all__ = [
+    "BaseAction", "register_action", "create_action_registry",
+    "list_actions", "get_action", "should_trigger",
+    "ACTIONS", "list_action_types", "get_action_class",
+]

tasks/douyin/actions/base.py

@@ -0,0 +1,51 @@
+"""抖音操作基类与注册机制。
+
+操作 = 抖音养号主循环里某个时机执行的一次具体行为（点赞/评论/关注等）。
+这里的注册表只对抖音任务生效，其他任务有自己的 actions 包。
+
+设计：抖音的 ACTIONS 注册表是独立的 dict，用 core.actions 的
+register_action(ACTIONS) 装饰器注册，和全局/其他 app 互不污染。
+
+新增抖音操作步骤（照着 like.py 抄）：
+
+  1. 在 tasks/douyin/actions/ 下新建 my_action.py
+  2. 写一个 BaseAction 子类，用 @register_action 装饰，实现 execute：
+
+       from core.actions import BaseAction, register_action, should_trigger
+       from . import ACTIONS  # 本任务注册表
+
+       @register_action(ACTIONS)
+       class MyAction(BaseAction):
+           action_type = "my_action"
+           name = "我的操作"
+           description = "做什么"
+           default_params = {"rate": 0.5}
+
+           def execute(self, d, params, worker):
+               if not should_trigger(params["rate"]):
+                   return False
+               # ... 用 d(xpath=...) / d(text=...) 操作
+               return True
+
+  3. 在 tasks/douyin/actions/__init__.py 加一行：from . import my_action
+
+  做完前端自动出现该操作的可勾选项。
+"""
+from core.actions import (
+    BaseAction, register_action, create_action_registry,
+    list_actions, get_action, should_trigger,
+)
+
+# 抖音专属操作注册表（独立 dict，不污染其他 app）
+ACTIONS = create_action_registry()
+
+
+# 兼容旧导入：tasks/douyin/actions/__init__.py 原来从这里导出
+def list_action_types():
+    """返回所有已注册抖音操作的元信息（供前端展示）。"""
+    return list_actions(ACTIONS)
+
+
+def get_action_class(action_type):
+    """按 action_type 取抖音操作类。"""
+    return get_action(ACTIONS, action_type)

tasks/douyin/actions/like.py

@@ -0,0 +1,105 @@
+"""抖音点赞操作。
+
+两种方式：
+  by_element   — 用 xpath 找右侧红心按钮点击（相对定位，不依赖视频卡片序号）
+  double_click — 双击屏幕中央（兜底，不依赖元素，抖音"双击点赞"手势）
+
+定位器随抖音版本变，by_element 找不到会自动回退双击，不会卡住。
+要适配新版本抖音：用 weditor 重新抓当前界面，调整下面定位逻辑。
+"""
+from core.actions import BaseAction, register_action, should_trigger
+from core.logger import get_logger
+from . import ACTIONS
+
+_log = get_logger("action.like")
+
+
+@register_action(ACTIONS)
+class LikeAction(BaseAction):
+    action_type = "like"
+    name = "点赞"
+    description = "看完视频后随机点赞（找红心按钮，找不到回退双击）"
+    default_params = {
+        "rate": 0.3,                 # 触发概率 0~1
+        "method": "by_element",      # by_element=找红心 | double_click=双击屏幕
+    }
+
+    def execute(self, d, params, worker):
+        rate = float(params.get("rate", 0.3))
+        if not should_trigger(rate):
+            return False
+        method = params.get("method", "by_element")
+        if method == "by_element":
+            if self._like_by_element(d):
+                worker.set_action("点赞(红心)")
+                return True
+            # 找不到红心，回退双击
+        ok = self._double_click_center(d)
+        if ok:
+            worker.set_action("点赞(双击)")
+        return ok
+
+    @staticmethod
+    def _like_by_element(d):
+        """找右侧操作栏红心按钮点击，成功返回 True。
+
+        定位优先级：description 精确 → descriptionContains 模糊 → resourceId → xpath
+        每种方式找到即点即返回，找不到继续下一种。全程记日志。
+        """
+        # 方式1：description 精确匹配（最稳，不依赖结构）
+        for desc in ("点赞", "未点赞", "like"):
+            el = d(description=desc)
+            if el.exists:
+                el.click()
+                _log.info(f"like 命中 description={desc}")
+                return True
+        # 方式2：descriptionContains 模糊匹配（适配不同版本文案）
+        for kw in ("赞", "like"):
+            el = d(descriptionContains=kw)
+            if el.exists:
+                el.click()
+                _log.info(f"like 命中 descriptionContains={kw}")
+                return True
+        # 方式3：resourceId 列表（扩充候选，覆盖更多抖音版本）
+        for rid in ("com.ss.android.ugc.aweme:id/aky",
+                    "com.ss.android.ugc.aweme:id/d-like-view-icon",
+                    "com.ss.android.ugc.aweme:id/h3r",
+                    "com.ss.android.ugc.aweme:id/dfz",
+                    "com.ss.android.ugc.aweme:id/c5w"):
+            el = d(resourceId=rid)
+            if el.exists:
+                el.click()
+                _log.info(f"like 命中 resourceId={rid}")
+                return True
+        # 方式4：xpath 相对定位——右侧操作栏 LinearLayout 的第一个 ImageView
+        # 定位思路：ViewPager 下当前 FrameLayout 里的 LinearLayout，
+        # 取其直接子 FrameLayout 里的第一个 ImageView（点赞在操作栏最上方）
+        try:
+            el = d.xpath(
+                '//androidx.viewpager.widget.ViewPager'
+                '/android.widget.FrameLayout'
+                '/com.bytedance.highperformanceview.layout.MeasureOnceRelativeLayout2'
+                '/com.bytedance.highperformanceview.layout.MeasureOnceRelativeLayout2'
+                '/android.widget.LinearLayout/android.widget.FrameLayout[2]'
+                '/android.widget.LinearLayout/android.widget.FrameLayout[1]'
+                '/android.widget.FrameLayout[1]/android.widget.ImageView'
+            )
+            if el.exists:
+                el.click()
+                _log.info("like 命中 xpath")
+                return True
+        except Exception as e:
+            _log.warning(f"like xpath 异常: {e}")
+        _log.info("like_by_element 全部失败，准备回退双击")
+        return False
+
+    @staticmethod
+    def _double_click_center(d):
+        """双击屏幕中央点赞。按屏幕尺寸算坐标，适配不同分辨率。"""
+        try:
+            info = d.info
+            w, h = info["displayWidth"], info["displayHeight"]
+            d.double_click(int(w * 0.5), int(h * 0.5))
+            return True
+        except Exception:
+            return False