@tencent-rtc/trtc-agent-skills 0.1.6 → 0.1.7

package/skills/trtc-ai-oral-coach/capabilities/conversation-core/src/_capability_loader.py

@@ -0,0 +1,227 @@
+"""Dynamic loader for sibling capability packages (independent of cwd / repo directory name / hyphens).
+
+Why this module?
+================
+Capability directories use hyphenated names (e.g. ``knowledge-base``, ``human-handoff``),
+but Python ``import`` syntax cannot recognize hyphens. Additionally, the ``start.sh``
+process working directory is ``capabilities/conversation-core/``, so the project root
+is NOT in ``sys.path``. Therefore, the import style in manifest.yaml:
+
+    from capabilities.knowledge_base.src.retriever import attach_faq_to_instructions
+
+will **never work** — it implicitly assumes:
+1. Directory names use underscores (they actually use hyphens);
+2. The project root is in ``sys.path`` (it is not).
+
+This module uses ``importlib.util`` to proactively register each directory level as a
+valid Python package, bypassing package name restrictions; the project root is derived
+from ``__file__``, so **renaming the repo directory has no effect**. Relative imports
+such as ``from .x import y`` inside sub-modules also work correctly.
+
+Usage
+-----
+    from ._capability_loader import load_capability
+
+    retriever = load_capability("knowledge-base", "src/retriever.py")
+    new_text = retriever.attach_faq_to_instructions(text)
+
+    router_mod = load_capability("knowledge-base", "src/router.py")
+    app.include_router(router_mod.router, prefix="/api/v1/kb")
+"""
+from __future__ import annotations
+
+import importlib.util
+import logging
+import sys
+from pathlib import Path
+from threading import RLock
+from types import ModuleType
+from typing import Optional
+
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# Path resolution: derive repo_root from __file__, independent of cwd / repo directory name
+# This file is at <repo_root>/capabilities/conversation-core/src/_capability_loader.py
+# parents[3] = <repo_root>
+# ---------------------------------------------------------------------------
+_HERE = Path(__file__).resolve()
+_REPO_ROOT = _HERE.parents[3]
+_CAPABILITIES_ROOT = _REPO_ROOT / "capabilities"
+
+_CAPS_NAMESPACE = "_capabilities"
+
+_lock = RLock()
+_module_cache: dict[str, ModuleType] = {}
+
+
+def repo_root() -> Path:
+    """Return the repo root directory (the level containing ``capabilities/``)."""
+    return _REPO_ROOT
+
+
+def capabilities_root() -> Path:
+    return _CAPABILITIES_ROOT
+
+
+def _safe_name(part: str) -> str:
+    """Convert a directory segment to a valid Python identifier (hyphens → underscores)."""
+    return part.replace("-", "_")
+
+
+def _ensure_namespace_root() -> ModuleType:
+    """Register the ``_capabilities`` top-level namespace package in ``sys.modules``."""
+    mod = sys.modules.get(_CAPS_NAMESPACE)
+    if mod is not None:
+        return mod
+    spec = importlib.util.spec_from_loader(_CAPS_NAMESPACE, loader=None, is_package=True)
+    if spec is None:
+        raise RuntimeError("failed to build namespace spec")
+    mod = importlib.util.module_from_spec(spec)
+    mod.__path__ = [str(_CAPABILITIES_ROOT)]  # Let importlib find sub-packages under this directory
+    sys.modules[_CAPS_NAMESPACE] = mod
+    return mod
+
+
+def _ensure_package(qualified_name: str, dir_path: Path) -> ModuleType:
+    """Register ``dir_path`` as a Python package named ``qualified_name``.
+
+    If a ``__init__.py`` with the same name exists, exec it normally; otherwise treat as a namespace package.
+    Idempotent: if already in ``sys.modules``, returns immediately.
+    """
+    cached = sys.modules.get(qualified_name)
+    if cached is not None:
+        return cached
+
+    init_file = dir_path / "__init__.py"
+    if init_file.is_file():
+        spec = importlib.util.spec_from_file_location(
+            qualified_name,
+            init_file,
+            submodule_search_locations=[str(dir_path)],
+        )
+    else:
+        spec = importlib.util.spec_from_loader(qualified_name, loader=None, is_package=True)
+    if spec is None:
+        raise ModuleNotFoundError(f"failed to build spec for package: {qualified_name}")
+
+    pkg = importlib.util.module_from_spec(spec)
+    if not hasattr(pkg, "__path__"):
+        pkg.__path__ = [str(dir_path)]  # type: ignore[attr-defined]
+    sys.modules[qualified_name] = pkg
+
+    if init_file.is_file() and spec.loader is not None:
+        try:
+            spec.loader.exec_module(pkg)
+        except Exception:
+            sys.modules.pop(qualified_name, None)
+            raise
+    return pkg
+
+
+def load_capability(cap_name: str, module_rel: str) -> ModuleType:
+    """Load a Python file under a given capability package and return its module object.
+
+    Parameters
+    ----------
+    cap_name
+        Capability directory name, e.g. ``"knowledge-base"`` (with hyphens).
+    module_rel
+        Python file path relative to the capability root, e.g. ``"src/retriever.py"``.
+
+    Returns
+    -------
+    ModuleType
+        The executed module object. Raises :class:`ModuleNotFoundError` on failure.
+
+    Notes
+    -----
+    - In-process cache: the same ``(cap_name, module_rel)`` is loaded only once.
+    - Full module name is e.g. ``_capabilities.<cap_safe>.<dir>.<basename>``,
+      so relative imports like ``from .x import y`` inside capabilities work correctly.
+    """
+    cache_key = f"{cap_name}::{module_rel}"
+    with _lock:
+        cached = _module_cache.get(cache_key)
+        if cached is not None:
+            return cached
+
+    cap_dir = _CAPABILITIES_ROOT / cap_name
+    file_path = cap_dir / module_rel
+    if not file_path.is_file():
+        raise ModuleNotFoundError(
+            f"capability '{cap_name}' module '{module_rel}' not found at {file_path}"
+        )
+
+    # 1) Top-level namespace _capabilities.*
+    _ensure_namespace_root()
+
+    # 2) Capability package name _capabilities.<cap_safe>
+    cap_safe = _safe_name(cap_name)
+    cap_qual = f"{_CAPS_NAMESPACE}.{cap_safe}"
+    _ensure_package(cap_qual, cap_dir)
+
+    # 3) Register each intermediate directory level as a sub-package
+    rel_parts = Path(module_rel).parts
+    *dir_parts, leaf = rel_parts
+    parent_qual = cap_qual
+    parent_dir = cap_dir
+    for part in dir_parts:
+        parent_dir = parent_dir / part
+        parent_qual = f"{parent_qual}.{_safe_name(part)}"
+        _ensure_package(parent_qual, parent_dir)
+
+    # 4) Load leaf module
+    leaf_basename = Path(leaf).stem
+    leaf_qual = f"{parent_qual}.{_safe_name(leaf_basename)}"
+
+    cached_leaf = sys.modules.get(leaf_qual)
+    if cached_leaf is not None:
+        with _lock:
+            _module_cache[cache_key] = cached_leaf
+        return cached_leaf
+
+    spec = importlib.util.spec_from_file_location(leaf_qual, file_path)
+    if spec is None or spec.loader is None:
+        raise ModuleNotFoundError(
+            f"failed to build spec for capability '{cap_name}' / '{module_rel}'"
+        )
+    module = importlib.util.module_from_spec(spec)
+    sys.modules[leaf_qual] = module
+    try:
+        spec.loader.exec_module(module)
+    except Exception:
+        sys.modules.pop(leaf_qual, None)
+        raise
+
+    with _lock:
+        _module_cache[cache_key] = module
+    logger.debug("capability loaded: %s -> %s", leaf_qual, file_path)
+    return module
+
+
+def try_load_capability(
+    cap_name: str, module_rel: str
+) -> Optional[ModuleType]:
+    """Same as :func:`load_capability`, but returns ``None`` on failure instead of raising.
+
+    Suitable for "capability is optionally installed" scenarios: silently degrades
+    on missing, without affecting skeleton operation.
+    """
+    try:
+        return load_capability(cap_name, module_rel)
+    except Exception as exc:  # noqa: BLE001
+        logger.info(
+            "capability '%s' module '%s' not loaded (skipped): %s",
+            cap_name, module_rel, exc,
+        )
+        return None
+
+
+# ---------------------------------------------------------------------------
+# 全局模块别名：让任意能力都能 `import cap_loader` 拿到与 core 同一份 loader，
+# 从而实现"能力互相调用"（例如 scenario-roleplay 按需调用 custom-learning-kb），
+# 而不必知道 conversation-core 的包路径。用法同 core/report_llm.py 的
+# `coach_report_llm` 别名模式。
+# ---------------------------------------------------------------------------
+sys.modules.setdefault("cap_loader", sys.modules[__name__])

package/skills/trtc-ai-oral-coach/capabilities/conversation-core/src/agent.py

@@ -0,0 +1,197 @@
+# -*- coding: utf-8 -*-
+"""会话编排 —— 忠实移植定稿 Demo 的 join / start / stop / farewell / invoke 逻辑。
+
+设计：
+  * core 只做协议编排 + TRTC 调用；**实时对话零 LLM**。
+  * system_prompt / welcome / 语速由 scenario-roleplay 能力组装（通过 _capability_loader
+    动态加载 src/compose.py；未安装则用极简默认，保证光核心也能进房对话）。
+  * push-to-talk（InvokeLLM）：用户点"结束说话"后手动触发 AI 回复。
+"""
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, Optional
+
+from ._capability_loader import try_load_capability
+from .config import CoreConfig
+from .trtc_client import TRTCClient
+from .usersig import sign_trio, gen_user_sig
+
+logger = logging.getLogger("agent")
+
+# ---- TRTC 协议级常量（与定稿 Demo 一致）----
+TTS_VOICE_MAP = {
+    ("en", "female"): "v-female-p9Xy7Q1L",
+    ("en", "male"):   "v-male-A4b9KqP2",
+    ("zh", "female"): "female-kefu-xiaoyue",
+    ("zh", "male"):   "male-kefu-xiaoxu",
+}
+_EN_HOTWORDS = ",".join([
+    "zero|11","one|11","two|11","three|11","four|11","five|11","six|11","seven|11",
+    "eight|11","nine|11","ten|11","eleven|11","twelve|11",
+    "first|10","second|10","third|10","fourth|10","fifth|10","once|10","twice|10",
+    "um|11","uh|11","oh|11","hmm|11","ah|11","er|11","yeah|11","yep|11","nope|11",
+    "okay|11","ok|11","like|10","well|10","so|10","right|10",
+])
+SCENARIOS = {"travel", "work", "study", "free"}
+LEVELS    = {"beginner", "intermediate", "advanced"}
+STYLES    = {"friend", "listener", "local"}
+GENDERS   = {"female", "male"}
+
+DEFAULT_WELCOME  = "Hi! I'm your AI English speaking partner. Ready to start? Let's warm up..."
+DEFAULT_FAREWELL = {
+    "en": "Great chat today! Let me put together your report...",
+    "zh": "今天聊得不错！我来为你生成报告...",
+}
+DEFAULT_END_KEYWORDS = {
+    "en": ["end practice", "stop practice", "i'm done", "that's enough", "finish session"],
+    "zh": ["结束练习", "我练完了", "停止练习", "不练了"],
+}
+
+
+def _voice_id(lang: str, gender: str) -> str:
+    key = (lang if lang in ("en", "zh") else "en",
+           gender if gender in GENDERS else "female")
+    return TTS_VOICE_MAP[key]
+
+
+class Agent:
+    def __init__(self, cfg: CoreConfig) -> None:
+        self._cfg = cfg
+        self._trtc = TRTCClient(cfg)
+
+    # ------------------------------------------------------------------
+    # join / config —— 签发三套 UserSig + 下发前端配置
+    # ------------------------------------------------------------------
+    def issue_config(self, user_id: str) -> Dict[str, Any]:
+        if not user_id:
+            raise ValueError("userid is required")
+        sigs = sign_trio(self._cfg.trtc.sdk_app_id, self._cfg.trtc.sdk_secret_key, user_id)
+        avatar_on = self._cfg.avatar_enabled()
+
+        # 风格元数据由 scenario-roleplay 提供（未装 → 空列表）
+        styles = []
+        _sr = try_load_capability("scenario-roleplay", "src/compose.py")
+        if _sr is not None and hasattr(_sr, "styles_metadata"):
+            try:
+                styles = _sr.styles_metadata()
+            except Exception as exc:  # noqa: BLE001
+                logger.warning("styles_metadata failed: %s", exc)
+
+        return {
+            "sdkappid":         sigs["sdkappid"],
+            "userid":           sigs["user_id"],
+            "usersig":          sigs["user_sig"],
+            "robot_userid":     sigs["robot_user_id"],
+            "robot_usersig":    sigs["robot_user_sig"],
+            "avatar_userid":    sigs["avatar_user_id"] if avatar_on else "",
+            "avatar_usersig":   sigs["avatar_user_sig"] if avatar_on else "",
+            "avatar_available": avatar_on,
+            "styles":           styles,
+            "personas":         styles,   # 兼容别名
+            "end_keywords":     DEFAULT_END_KEYWORDS,
+            "farewell_message": DEFAULT_FAREWELL,
+        }
+
+    # ------------------------------------------------------------------
+    # start —— 组装 prompt（scenario-roleplay）+ 调 TRTC StartAIConversation
+    # ------------------------------------------------------------------
+    def start(self, body: Dict[str, Any]) -> Dict[str, Any]:
+        use_avatar = bool(body.get("UseAvatar", False)) and self._cfg.avatar_enabled()
+
+        # === agent.compose_conversation 插座：scenario-roleplay 组装 ===
+        prep = self._compose(body)
+        system_prompt = prep["system_prompt"]
+        welcome       = prep["welcome"]
+        speed         = float(prep.get("speed", 1.0))
+        gender        = prep.get("voice_gender", "female")
+
+        user_cfg = body.get("UserConfig", {}) or {}
+        interrupt_mode = int(user_cfg.get("InterruptMode", 1))
+        interrupt_dur  = int(user_cfg.get("InterruptSpeechDuration", 600))
+        vad_level      = int(user_cfg.get("VadLevel", 2))
+        vad_silence    = int(user_cfg.get("VadSilenceTime", 1200))
+        turn_mode      = int(user_cfg.get("TurnDetectionMode", 3))
+
+        agent_cfg = {
+            "UserId":                  body["AgentConfig"]["UserId"],
+            "UserSig":                 body["AgentConfig"]["UserSig"],
+            "TargetUserId":            body["AgentConfig"]["TargetUserId"],
+            "MaxIdleTime":             60,
+            "WelcomeMessage":          welcome,
+            "WelcomeMessagePriority":  0,
+            "TurnDetectionMode":       turn_mode,
+            "TurnDetection":           {"SemanticEagerness": "auto"},
+            "FilterOneWord":           False,
+            "FilterBracketsContent":   4,   # 过滤 [FEEDBACK]/[FOLLOWUP] 标签不进 TTS/字幕
+            "SubtitleMode":            0,   # 全量累积字幕（与前端 isAccumulative 匹配）
+            "InterruptMode":           interrupt_mode,
+            "InterruptSpeechDuration": interrupt_dur,
+        }
+        stt_cfg = {"Language": "en", "VadLevel": vad_level, "VadSilenceTime": vad_silence,
+                   "HotWordList": _EN_HOTWORDS}
+
+        import json as _json
+        params = {
+            "SdkAppId":   self._cfg.trtc.sdk_app_id,
+            "RoomId":     str(body["RoomId"]),
+            "RoomIdType": 0,
+            "AgentConfig": agent_cfg,
+            "STTConfig":   stt_cfg,
+            "LLMConfig":   _json.dumps(self._cfg.llm_config_with_prompt(system_prompt), ensure_ascii=False),
+        }
+        if use_avatar:
+            params["TTSConfig"] = _json.dumps({"TTSType": "dummy"}, ensure_ascii=False)
+            avatar = self._cfg.avatar_config()
+            params["AvatarConfig"] = _json.dumps({
+                **avatar,
+                "AvatarUserID":  body["AvatarConfig"]["AvatarUserID"],
+                "DriverType":    1,
+                "AvatarUserSig": body["AvatarConfig"]["AvatarUserSig"],
+            }, ensure_ascii=False)
+        else:
+            params["TTSConfig"] = _json.dumps({
+                "TTSType": "flow", "Model": "flow_01_turbo",
+                "VoiceId": _voice_id("en", gender), "Language": "en",
+                "Speed": max(0.5, min(2.0, speed)), "Volume": 1.0, "Pitch": 0,
+            }, ensure_ascii=False)
+
+        result = self._trtc.start(params)
+        logger.info("StartAIConversation ok: TaskId=%s welcome_source=%s",
+                    result.get("TaskId"), prep.get("welcome_source"))
+        return result
+
+    def _compose(self, body: Dict[str, Any]) -> Dict[str, Any]:
+        """调 scenario-roleplay 组装；未安装则极简默认（保证光核心可对话）。"""
+        _sr = try_load_capability("scenario-roleplay", "src/compose.py")
+        if _sr is not None and hasattr(_sr, "compose_prepare"):
+            try:
+                return _sr.compose_prepare(body)
+            except Exception as exc:  # noqa: BLE001
+                logger.warning("scenario-roleplay compose failed, using default: %s", exc)
+        opening = (body.get("OpeningQuestion") or "").strip() or DEFAULT_WELCOME
+        return {
+            "system_prompt": "You are a friendly AI English speaking partner. "
+                             "Chat naturally in English and keep the conversation going.",
+            "welcome": opening, "speed": 1.0, "voice_gender": "female",
+            "welcome_source": "core-default",
+        }
+
+    # ------------------------------------------------------------------
+    # stop / farewell / invoke
+    # ------------------------------------------------------------------
+    def stop(self, body: Dict[str, Any]) -> Dict[str, Any]:
+        return self._trtc.stop(body["TaskId"])
+
+    def farewell(self, body: Dict[str, Any]) -> Dict[str, Any]:
+        lang = body.get("Lang", "en")
+        text = body.get("FarewellText") or DEFAULT_FAREWELL.get(lang, DEFAULT_FAREWELL["en"])
+        result = self._trtc.control(body["TaskId"], "ServerPushText", text,
+                                    interrupt=True, stop_after_play=True)
+        result["FarewellText"] = text
+        return result
+
+    def invoke(self, body: Dict[str, Any]) -> Dict[str, Any]:
+        """push-to-talk：把缓存用户文本发给 AI 触发回复（空文本亦可，基于已有上下文）。"""
+        text = (body.get("Text") or "").strip()
+        return self._trtc.control(body["TaskId"], "InvokeLLM", text, interrupt=True)

package/skills/trtc-ai-oral-coach/capabilities/conversation-core/src/config.py

@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+"""conversation-core 配置加载（从 .env 读三把钥匙 + Region + 两组 LLM）。
+
+对齐 AI 客服 Skill：三把钥匙走扁平 .env（配合 verify-credentials.py 复用）。
+陪练特有的场景/风格/难度默认值内置在 scenario-roleplay 能力里，core 不管。
+"""
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+from dotenv import load_dotenv
+
+_BASE_DIR = Path(__file__).resolve().parent.parent   # capabilities/conversation-core/
+load_dotenv(_BASE_DIR / ".env.local")
+load_dotenv(_BASE_DIR / ".env")
+
+
+# Region → TRTC OpenAPI Endpoint
+REGION_PROFILES = {
+    "cn":   {"endpoint": "trtc.tencentcloudapi.com",      "region": "ap-guangzhou"},
+    "intl": {"endpoint": "trtc.intl.tencentcloudapi.com", "region": "ap-singapore"},
+}
+
+
+def _env(key: str, default: str = "") -> str:
+    return (os.getenv(key) or default).strip()
+
+
+@dataclass
+class TRTCCred:
+    sdk_app_id: int
+    sdk_secret_key: str
+    region: str
+
+    @property
+    def configured(self) -> bool:
+        return bool(self.sdk_app_id) and bool(self.sdk_secret_key)
+
+    @property
+    def endpoint(self) -> str:
+        return REGION_PROFILES.get(self.region, REGION_PROFILES["intl"])["endpoint"]
+
+    @property
+    def api_region(self) -> str:
+        return REGION_PROFILES.get(self.region, REGION_PROFILES["intl"])["region"]
+
+
+@dataclass
+class TencentCloudCred:
+    secret_id: str
+    secret_key: str
+
+    @property
+    def configured(self) -> bool:
+        return bool(self.secret_id) and bool(self.secret_key)
+
+
+@dataclass
+class LLMCred:
+    api_key: str
+    api_url: str
+    model: str
+
+    @property
+    def configured(self) -> bool:
+        return bool(self.api_key)
+
+
+class CoreConfig:
+    """core 运行期配置：三把钥匙 + 实时对话 LLM + 报告 LLM（共享评估基座用）。"""
+
+    def __init__(self) -> None:
+        region = _env("TRTC_REGION", "intl")
+        if region not in REGION_PROFILES:
+            region = "intl"
+        self.trtc = TRTCCred(
+            sdk_app_id=int(_env("TRTC_SDK_APP_ID", "0") or 0),
+            sdk_secret_key=_env("TRTC_SDK_SECRET_KEY"),
+            region=region,
+        )
+        self.tencent = TencentCloudCred(
+            secret_id=_env("TENCENT_CLOUD_SECRET_ID"),
+            secret_key=_env("TENCENT_CLOUD_SECRET_KEY"),
+        )
+        # 实时对话 LLM（TRTC 云端 AI Bot 调用）
+        self.llm = LLMCred(
+            api_key=_env("LLM_API_KEY"),
+            api_url=_env("LLM_API_URL", "https://api.openai.com/v1/chat/completions"),
+            model=_env("LLM_MODEL", "gpt-4o-mini"),
+        )
+        # 报告/纠正/建议 LLM（后端直连；空则回退到实时对话 LLM 配置）
+        self.report_llm = LLMCred(
+            api_key=_env("REPORT_LLM_API_KEY") or self.llm.api_key,
+            api_url=_env("REPORT_LLM_API_URL") or self.llm.api_url,
+            model=_env("REPORT_LLM_MODEL") or self.llm.model,
+        )
+        self.report_llm_temperature = float(_env("REPORT_LLM_TEMPERATURE", "0.2") or 0.2)
+        self.report_llm_timeout = float(_env("REPORT_LLM_TIMEOUT", "120") or 120)
+
+    # ---- 实时对话 LLMConfig（注入动态 SystemPrompt 后传给 TRTC）----
+    def llm_config_with_prompt(self, system_prompt: str) -> dict:
+        # History: TRTC 服务端自动维护的上下文轮数，官方上限 50，做个保护
+        history = max(0, min(50, int(_env("LLM_HISTORY", "20") or 20)))
+        return {
+            "LLMType":     "openai",
+            "Model":       self.llm.model,
+            "APIKey":      self.llm.api_key,
+            "APIUrl":      self.llm.api_url,
+            "SystemPrompt": system_prompt,
+            "Streaming":   True,
+            "Temperature": float(_env("LLM_TEMPERATURE", "0.4") or 0.4),
+            "History":     history,
+            # 上下文与音频播放进度同步：未播完的音频对应文本不计入下一轮上下文，
+            # 避免"AI 自相矛盾/重复问候/像是在跟自己说话"这类问题。默认开启。
+            "HistoryMode": int(_env("LLM_HISTORY_MODE", "1") or 1),
+            # 原来没有 Timeout：实时对话模型响应稍慢时，TRTC 云端 AI Bot 可能拿不到
+            # LLM 回复而静默无输出。给个较宽松的默认值。
+            "Timeout":     float(_env("LLM_TIMEOUT", "20") or 20),
+        }
+
+    # ---- 数字人（三项全填启用）----
+    def avatar_enabled(self) -> bool:
+        return bool(_env("AVATAR_APPKEY")) and bool(_env("AVATAR_ACCESS_TOKEN")) \
+            and bool(_env("AVATAR_PROJECT_ID"))
+
+    def avatar_config(self) -> dict:
+        return {
+            "AvatarType":          _env("AVATAR_TYPE", "tencent"),
+            "Appkey":              _env("AVATAR_APPKEY"),
+            "AccessToken":         _env("AVATAR_ACCESS_TOKEN"),
+            "VirtualmanProjectId": _env("AVATAR_PROJECT_ID"),
+        }
+
+    @property
+    def fully_configured(self) -> bool:
+        return self.trtc.configured and self.tencent.configured and self.llm.configured
+
+    def missing(self) -> list:
+        m = []
+        if not self.trtc.configured:    m.append("TRTC")
+        if not self.tencent.configured: m.append("TENCENT_CLOUD")
+        if not self.llm.configured:     m.append("LLM")
+        return m
+
+
+def load_config() -> CoreConfig:
+    return CoreConfig()

package/skills/trtc-ai-oral-coach/capabilities/conversation-core/src/core/__init__.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+"""conversation-core/src/core 子包。"""