ForcePilot/backend/package/yuxi/channels/protocols/actions.py
Kris 7a972055b7 feat: 新增渠道服务基础框架与核心工具类
新增大量渠道适配器相关的协议、策略、工具类与基础设施代码,包括:
1.  多协议定义:认证、消息、配置、网关等核心接口
2.  策略模块:上下文、群聊、去重、防抖等业务策略
3.  工具集:重试、去重、文本分块、消息格式化等SDK工具
4.  基础设施:外部进程管理、事件广播、熔断机制等
5.  账户与管道系统:账户管理、消息处理管道实现
6.  运行时服务:状态收集、维护任务、日志等后台服务
2026-05-12 00:53:57 +08:00

43 lines
1.2 KiB
Python

from __future__ import annotations
from dataclasses import dataclass
from typing import TYPE_CHECKING, Protocol, runtime_checkable
if TYPE_CHECKING:
from yuxi.channels.models import DeliveryResult
@dataclass
class ActionContext:
action: str
channel_id: str
chat_id: str
msg_id: str
args: dict
session_key: str | None = None
run_id: str | None = None
def get(self, key: str, default=None):
return self.args.get(key, default)
@runtime_checkable
class ChannelMessageActionProtocol(Protocol):
"""消息动作协议 — 编辑、删除、表情回应等增强交互能力"""
async def edit_message(self, chat_id: str, msg_id: str, content: str) -> DeliveryResult: ...
async def delete_message(self, chat_id: str, msg_id: str) -> DeliveryResult: ...
async def send_reaction(self, chat_id: str, msg_id: str, emoji: str) -> DeliveryResult: ...
def supports_action(self, action: str) -> bool: ...
def resolve_execution_mode(self, action: str) -> str: ...
async def handle_action(self, ctx: ActionContext) -> DeliveryResult: ...
def extract_target_from_args(self, args: dict) -> dict | None: ...
def describe_message_tool(self) -> dict: ...