"""qqbot 插件 manifest.json 一致性测试。 验证 manifest.json 关键不变量： - ``capabilities.status`` / ``capabilities.probeable`` 为 ``true``，与 entry.py 注册的 StatusAdapter / ProbeableAdapter 一致。 - ``transport_mode`` 为 ``"stream"``，与 qqbot 仅注册 StreamConnector （无 Puller）的实际传输模式一致。 - ``capability_requirements`` 中引用的所有配置键均在 ``config_schema`` 中声明（F-03 单真相源：声明性字段交叉引用完整）。 - ``credential_strategy`` 声明为 static/manual，required_fields 为 app_id / app_secret。 - ``config_schema`` 含 app_id / app_secret / intents / api_base / sandbox 等核心配置项。 测试通过 ``load_manifest_from_dir`` 加载真实 ``manifest.json``，确保校验 基于实际文件内容而非硬编码预期值。 """ from __future__ import annotations import os import pytest from yuxi.channels.application.lifecycle.manifest_loader import load_manifest_from_dir from yuxi.channels.contract.plugin.manifest import ChannelManifest pytestmark = pytest.mark.unit @pytest.fixture def qqbot_manifest() -> ChannelManifest: """加载 qqbot 插件真实 manifest.json。""" plugin_dir = os.path.join( os.path.dirname(__file__), "..", "..", "..", "..", "..", "package", "yuxi", "channels", "plugins", "qqbot", ) return load_manifest_from_dir(os.path.abspath(plugin_dir)) # ------------------------------------------------------------------ # A1: status / probeable 能力声明与适配器注册一致 # ------------------------------------------------------------------ @pytest.mark.unit class TestStatusProbeableCapabilities: """A1：status / probeable 声明为 true，与 entry.py 注册的适配器一致。""" def test_status_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.status is True def test_probeable_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.probeable is True def test_identity_resolver_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.identity_resolver is True def test_lifecycle_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.lifecycle is True def test_rich_message_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.rich_message is True def test_message_recall_capability_is_true(self, qqbot_manifest): assert qqbot_manifest.capabilities.message_recall is True def test_streaming_capability_is_false(self, qqbot_manifest): """QQ Bot v1 不支持流式输出。""" assert qqbot_manifest.capabilities.streaming is False def test_message_edit_capability_is_false(self, qqbot_manifest): """QQ Bot v1 不支持消息编辑。""" assert qqbot_manifest.capabilities.message_edit is False def test_supports_qr_login_capability_is_false(self, qqbot_manifest): """QQ Bot v1 不支持扫码登录。""" assert qqbot_manifest.capabilities.supports_qr_login is False def test_agent_collaboration_capability_is_false(self, qqbot_manifest): """QQ Bot v1 不支持多 Agent 协作。""" assert qqbot_manifest.capabilities.agent_collaboration is False # ------------------------------------------------------------------ # A2: transport_mode 声明 # ------------------------------------------------------------------ @pytest.mark.unit class TestTransportMode: """A2：transport_mode 为 stream，与仅注册 StreamConnector 一致。""" def test_transport_mode_is_stream(self, qqbot_manifest): assert qqbot_manifest.transport_mode == "stream" # ------------------------------------------------------------------ # A3: 核心配置项存在性 # ------------------------------------------------------------------ @pytest.mark.unit class TestConfigSchemaCoreFields: """A3：config_schema 含核心配置项。""" def test_app_id_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "app_id" in keys def test_app_secret_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "app_secret" in keys def test_intents_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "intents" in keys def test_api_base_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "api_base" in keys def test_gateway_url_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "gateway_url" in keys def test_sandbox_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "sandbox" in keys def test_http_timeout_ms_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "http_timeout_ms" in keys def test_ws_heartbeat_interval_ms_in_config_schema(self, qqbot_manifest): keys = {f.key for f in qqbot_manifest.config_schema} assert "ws_heartbeat_interval_ms" in keys def test_app_id_is_required(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "app_id") assert field.required is True def test_app_secret_is_required(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "app_secret") assert field.required is True def test_app_secret_is_sensitive(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "app_secret") assert field.sensitive is True def test_app_id_not_hot_reloadable(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "app_id") assert field.hot_reloadable is False def test_sandbox_not_hot_reloadable(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "sandbox") assert field.hot_reloadable is False def test_http_timeout_ms_hot_reloadable(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "http_timeout_ms") assert field.hot_reloadable is True def test_ws_heartbeat_interval_ms_hot_reloadable(self, qqbot_manifest): field = next(f for f in qqbot_manifest.config_schema if f.key == "ws_heartbeat_interval_ms") assert field.hot_reloadable is True # ------------------------------------------------------------------ # A4: capability_requirements 引用的配置键均在 config_schema 中声明 # ------------------------------------------------------------------ @pytest.mark.unit class TestCapabilityRequirementsConsistency: """A4：capability_requirements 交叉引用完整性校验。 每项 capability_requirements 为 ``(能力字段名, (所需配置键清单))``， 所有引用的配置键必须在 config_schema 中声明（F-03 单真相源）。 """ def test_capability_requirements_not_empty(self, qqbot_manifest): assert len(qqbot_manifest.capability_requirements) > 0 def test_all_referenced_config_keys_exist_in_schema(self, qqbot_manifest): schema_keys = {f.key for f in qqbot_manifest.config_schema} for _capability, required_keys in qqbot_manifest.capability_requirements: for key in required_keys: assert key in schema_keys, f"capability_requirements 引用的配置键 '{key}' 未在 config_schema 中声明" def test_media_capabilities_require_app_credentials(self, qqbot_manifest): """媒体能力（图片/视频出入站）依赖 app_id 与 app_secret。""" req = dict(qqbot_manifest.capability_requirements) for cap in ( "supports_image_inbound", "supports_image_outbound", "supports_video_inbound", "supports_video_outbound", ): assert cap in req required = set(req[cap]) assert "app_id" in required assert "app_secret" in required def test_all_capabilities_have_app_credentials_requirement(self, qqbot_manifest): """QQ Bot 所有能力均依赖 app_id 与 app_secret。""" req = dict(qqbot_manifest.capability_requirements) for _cap, keys in req.items(): assert "app_id" in keys assert "app_secret" in keys # ------------------------------------------------------------------ # A5: credential_strategy 声明 # ------------------------------------------------------------------ @pytest.mark.unit class TestCredentialStrategy: """A5：credential_strategy 声明为 static/manual。""" def test_credential_strategy_not_none(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None def test_credential_strategy_type_is_static(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None assert qqbot_manifest.credential_strategy.type.value == "static" def test_credential_strategy_acquire_method_is_manual(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None assert qqbot_manifest.credential_strategy.acquire_method.value == "manual" def test_credential_strategy_required_fields(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None required = set(qqbot_manifest.credential_strategy.required_fields) assert "app_id" in required assert "app_secret" in required def test_credential_strategy_supports_rotation(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None assert qqbot_manifest.credential_strategy.supports_rotation is True def test_credential_strategy_not_supports_revocation(self, qqbot_manifest): assert qqbot_manifest.credential_strategy is not None assert qqbot_manifest.credential_strategy.supports_revocation is False # ------------------------------------------------------------------ # A6: resource_quota 声明 # ------------------------------------------------------------------ @pytest.mark.unit class TestResourceQuota: """A6：resource_quota 声明合理。""" def test_resource_quota_not_none(self, qqbot_manifest): assert qqbot_manifest.resource_quota is not None def test_max_connections_positive(self, qqbot_manifest): assert qqbot_manifest.resource_quota is not None assert qqbot_manifest.resource_quota.max_connections is not None assert qqbot_manifest.resource_quota.max_connections > 0 def test_max_calls_per_sec_positive(self, qqbot_manifest): assert qqbot_manifest.resource_quota is not None assert qqbot_manifest.resource_quota.max_calls_per_sec is not None assert qqbot_manifest.resource_quota.max_calls_per_sec > 0 # ------------------------------------------------------------------ # A7: 其他声明性字段 # ------------------------------------------------------------------ @pytest.mark.unit class TestDeclarativeFields: """A7：其他声明性字段验证。""" def test_channel_type_is_qqbot(self, qqbot_manifest): assert qqbot_manifest.channel_type == "qqbot" def test_requires_dm_pairing_is_true(self, qqbot_manifest): """QQ Bot 要求 DM 安全配对审批。""" assert qqbot_manifest.requires_dm_pairing is True def test_requires_outbound_delivery_is_true(self, qqbot_manifest): assert qqbot_manifest.requires_outbound_delivery is True def test_supports_credential_cloning_is_false(self, qqbot_manifest): """QQ Bot 不允许凭据克隆。""" assert qqbot_manifest.supports_credential_cloning is False def test_critical_is_false(self, qqbot_manifest): assert qqbot_manifest.critical is False def test_max_message_length_is_4000(self, qqbot_manifest): assert qqbot_manifest.max_message_length == 4000 def test_accessible_ports_contains_required(self, qqbot_manifest): """accessible_ports 应包含 ConfigPort / LoggerPort / CachePort。""" ports = set(qqbot_manifest.accessible_ports) assert "ConfigPort" in ports assert "LoggerPort" in ports assert "CachePort" in ports def test_injectable_pipelines_contains_inbound_outbound(self, qqbot_manifest): pipelines = set(qqbot_manifest.injectable_pipelines) assert "inbound" in pipelines assert "outbound" in pipelines