Kris
742299cb07
本次提交包含多维度代码优化与功能增强： 1. 移除报告模块冗余导入与枚举，清理报表相关代码 2. 新增扫码登录支持方法与飞书适配器适配 3. 完善异常日志与健康检查信息 4. 扩展目录、配对管理、能力查询等接口 5. 优化出站管道与事务提交后钩子逻辑 6. 修复飞书消息解析与响应空值问题 7. 重构配置更新与服务账号创建逻辑 8. 统一传输错误分类契约与错误基类扩展
150 lines
7.1 KiB
Python
150 lines
7.1 KiB
Python
"""微信 iLink（ClawBot）渠道插件入口。
|
||
|
||
实现 ``CHANNEL_ENTRY`` 契约，注册 11 个适配器与生命周期钩子，返回
|
||
``PluginManifest``。由宿主在 loaded 阶段通过 ``importlib`` 导入并调用。
|
||
|
||
调用顺序（严格）：
|
||
1. ``getXxxPort`` 获取被驱动端口实例（宿主已从 manifest.accessible_ports
|
||
加载权限，无需运行时 declareXxx）。
|
||
2. 实例化 ``WeChatILinkLifecycleHandler`` 与 ``ILinkClient``。
|
||
3. 实例化并注册 11 个适配器（puller / inbound / outbound / session /
|
||
status / login / lifecycle / probeable / doctor / wizard / whitelist）。
|
||
4. ``registerLifecycleHandler`` 注册生命周期钩子（鸭子类型调用）。
|
||
5. 返回 ``PluginManifest``。
|
||
|
||
F-03 单真相源：本入口仅承接 discover 阶段解析的 ``ChannelManifest``，
|
||
不再重复构造声明性字段（capabilities / config_schema / accessible_ports /
|
||
injectable_pipelines / resource_quota / env_vars / credential_strategy 等），
|
||
所有声明性字段以 ``manifest.json`` 为唯一真相源。本函数仅负责适配器实例化、
|
||
client 实例化、LifecycleHandler 构造与 ``registerAdapter`` 调用。
|
||
|
||
适配器 DI 说明：
|
||
- 7 个适配器（puller / inbound / outbound / login / lifecycle / doctor /
|
||
wizard）接收 ``(client, logger_port)``。
|
||
- ``probeable`` 适配器接收 ``(client, persistence_port, logger_port)``：
|
||
需动态发现 account_id 调用 getconfig 探活。
|
||
- ``whitelist`` 适配器接收 ``(cache_port, logger_port)``：白名单数据本地
|
||
存储于 CachePort，不调用渠道侧 API，无需 ILinkClient。
|
||
- ``session`` / ``status`` 适配器无状态（INV-5），无 ``__init__`` 参数，
|
||
仅做协议转换，所有数据从 raw_event.payload 提取。
|
||
|
||
长轮询传输管理：iLink 通过 ``PullerAdapter`` 长轮询 ``getupdates`` 拉取
|
||
消息，``PullerWorker`` 由传输引擎通过 ``ChannelAccountOnline`` /
|
||
``ChannelAccountOffline`` 领域事件触发启停，``LifecycleAdapter`` 与
|
||
``LifecycleHandler`` 不自管理轮询任务。
|
||
|
||
依赖方向：仅 import ``yuxi.channels.contract.*`` + 标准库 + 同插件内部模块，
|
||
不污染框架层。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from yuxi.channels.contract.plugin.entry import PluginHost
|
||
from yuxi.channels.contract.plugin.manifest import (
|
||
ChannelManifest,
|
||
PluginManifest,
|
||
)
|
||
|
||
from .adapters.doctor_adapter import WeChatILinkDoctorAdapter
|
||
from .adapters.inbound_adapter import WeChatILinkInboundAdapter
|
||
from .adapters.lifecycle_adapter import WeChatILinkLifecycleAdapter
|
||
from .adapters.login_adapter import WeChatILinkLoginAdapter
|
||
from .adapters.outbound_adapter import WeChatILinkOutboundAdapter
|
||
from .adapters.probeable_adapter import WeChatILinkProbeableAdapter
|
||
from .adapters.puller_adapter import WeChatILinkPullerAdapter
|
||
from .adapters.session_adapter import WeChatILinkSessionAdapter
|
||
from .adapters.status_adapter import WeChatILinkStatusAdapter
|
||
from .adapters.whitelist_adapter import WeChatILinkWhitelistAdapter
|
||
from .adapters.wizard_adapter import WeChatILinkWizardAdapter
|
||
from .ilink_client import ILinkClient
|
||
from .lifecycle import WeChatILinkLifecycleHandler
|
||
|
||
# 已注册适配器类型列表（与 registerAdapter 调用顺序一致）。
|
||
# 此处为运行时适配器清单，非声明性字段，需与下方 registerAdapter 调用保持一致。
|
||
_ADAPTER_TYPES: tuple[str, ...] = (
|
||
"puller",
|
||
"inbound",
|
||
"outbound",
|
||
"session",
|
||
"status",
|
||
"login",
|
||
"lifecycle",
|
||
"probeable",
|
||
"doctor",
|
||
"wizard",
|
||
"whitelist",
|
||
)
|
||
|
||
|
||
def channel_entry(host: PluginHost, manifest: ChannelManifest) -> PluginManifest:
|
||
"""微信 iLink 渠道插件入口。
|
||
|
||
由宿主在 loaded 阶段调用，完成适配器注册、生命周期钩子注册，
|
||
返回 ``PluginManifest``。
|
||
|
||
能力边界（accessible_ports / injectable_pipelines / resource_quota /
|
||
config_schema / env_vars / credential_strategy 等）由 discover 阶段
|
||
解析的 ``manifest`` 静态字段承载，宿主在加载期通过
|
||
``PluginCapabilityChecker.check`` 校验，运行时通过
|
||
``PluginHostImpl._checkPortAccess`` 从 manifest 读取并强制约束。本函数
|
||
不重复构造声明性字段（F-03 单真相源）。
|
||
|
||
参数：
|
||
host: 插件宿主，提供端口获取与扩展点注册 API。
|
||
manifest: 渠道清单，由 discover 阶段从 ``manifest.json`` 解析得到，
|
||
承载所有声明性字段。本函数复用其 ``config_schema`` 注入
|
||
``LifecycleHandler``，并直接作为返回 ``PluginManifest.manifest``。
|
||
"""
|
||
|
||
# 1. 获取端口实例（宿主已从 manifest.accessible_ports 加载权限）
|
||
# ILinkClient 仅依赖 ConfigPort/CachePort/LoggerPort（凭证由
|
||
# CredentialService 通过 ConfigPort→CachePort 管理）；
|
||
# PersistencePort 供 ProbeableAdapter 动态发现 account_id。
|
||
config_port = host.getConfigPort()
|
||
logger_port = host.getLoggerPort()
|
||
cache_port = host.getCachePort()
|
||
persistence_port = host.getPersistencePort()
|
||
|
||
# 2. 实例化 ILinkClient 与 LifecycleHandler
|
||
# 依赖关系为单向：handler 在 onInit 调 client.attach_http_client 注入连接池，
|
||
# client 不引用 handler。先创建 client，再创建 handler 并通过构造器注入。
|
||
# config_schema 取自 manifest（F-03 单真相源）。
|
||
client = ILinkClient(config_port, cache_port, logger_port)
|
||
handler = WeChatILinkLifecycleHandler(
|
||
config_port,
|
||
logger_port,
|
||
cache_port,
|
||
manifest.config_schema,
|
||
client,
|
||
)
|
||
|
||
# 3. 实例化并注册 11 个适配器
|
||
# 8 个适配器接收 (client, logger_port)；probeable 接收
|
||
# (client, persistence_port, logger_port)；whitelist 接收
|
||
# (cache_port, logger_port)；session / status 无状态。
|
||
host.registerAdapter("puller", WeChatILinkPullerAdapter(client, logger_port))
|
||
host.registerAdapter("inbound", WeChatILinkInboundAdapter(client, logger_port))
|
||
host.registerAdapter("outbound", WeChatILinkOutboundAdapter(client, logger_port))
|
||
host.registerAdapter("session", WeChatILinkSessionAdapter())
|
||
host.registerAdapter("status", WeChatILinkStatusAdapter())
|
||
host.registerAdapter("login", WeChatILinkLoginAdapter(client, logger_port))
|
||
host.registerAdapter("lifecycle", WeChatILinkLifecycleAdapter(client, logger_port))
|
||
host.registerAdapter("probeable", WeChatILinkProbeableAdapter(client, persistence_port, logger_port))
|
||
host.registerAdapter("doctor", WeChatILinkDoctorAdapter(client, logger_port))
|
||
host.registerAdapter("wizard", WeChatILinkWizardAdapter(client, logger_port))
|
||
host.registerAdapter("whitelist", WeChatILinkWhitelistAdapter(cache_port, logger_port))
|
||
|
||
# 4. 注册生命周期钩子
|
||
# PluginHost Protocol 未声明 registerLifecycleHandler，但 PluginHostImpl
|
||
# 已实现，运行时通过鸭子类型调用。
|
||
host.registerLifecycleHandler(handler)
|
||
|
||
# 5. 返回 PluginManifest（manifest 直接复用入参，adapters 为运行时清单）
|
||
return PluginManifest(
|
||
manifest=manifest,
|
||
adapters=_ADAPTER_TYPES,
|
||
)
|
||
|
||
|
||
CHANNEL_ENTRY = channel_entry
|