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

package/skills/trtc-ai-realtime-interpreter/scripts/verify-credentials.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""三把钥匙免密校验脚本（AI 驱动配置流程的"原子工具"）。
+
+流程：
+1. AI 把用户贴过来的密钥用 write_to_file 写进 capabilities/conversation-core/.env
+2. AI 调用 `python3 scripts/verify-credentials.py [--type tencent|trtc|llm]`
+3. 本脚本只从 .env / 环境变量读取，绝不接受任何密钥作为命令行参数
+4. 输出结构化 JSON 到 stdout；AI 解析后按 SKILL.md 里的错误码表回应用户
+
+输出格式（始终是合法 JSON）：
+    单项: {"ok": true,  "type": "tencent", "error": "",     "message": "...", "latency_ms": 320}
+    单项: {"ok": false, "type": "trtc",    "error": "E002", "message": "...", "latency_ms": 0}
+    批量: {"ok": true,  "type": "all", "items": [ ... ]}
+
+退出码：0 表示全部通过；非 0 表示至少一项失败。
+
+安全红线：
+- 绝不接受命令行参数传入密钥
+- 绝不把密钥明文回显到 stdout/stderr
+- .env 权限（600）由写入方设置，本脚本不重复处理
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+import warnings
+from pathlib import Path
+
+warnings.filterwarnings("ignore")
+
+_HERE = Path(__file__).resolve().parent
+if str(_HERE) not in sys.path:
+    sys.path.insert(0, str(_HERE))
+
+from lib import credential_validators as cv  # noqa: E402
+
+
+def _print_json(data: dict) -> None:
+    sys.stdout.write(json.dumps(data, ensure_ascii=False))
+    sys.stdout.write("\n")
+    sys.stdout.flush()
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(prog="verify-credentials", description="三把钥匙免密校验（只从 .env 读取，输出结构化 JSON）")
+    parser.add_argument("--type", choices=["tencent", "trtc", "llm", "all"], default="all", help="只校验单个钥匙；默认全部")
+    parser.add_argument("--no-deep", action="store_true", help="TRTC 跳过深度 OpenAPI 校验，只做本地 UserSig 自洽检查")
+    parser.add_argument("--env-file", default="", help="可选：指定 .env 路径（默认 capabilities/conversation-core/.env）")
+    args = parser.parse_args(argv)
+
+    cv.load_dotenv(Path(args.env_file) if args.env_file else None)
+
+    if args.type == "tencent":
+        result = cv.validate_tencent()
+        _print_json(result.to_dict())
+        return 0 if result.ok else 1
+
+    if args.type == "trtc":
+        result = cv.validate_trtc(deep=not args.no_deep)
+        _print_json(result.to_dict())
+        return 0 if result.ok else 1
+
+    if args.type == "llm":
+        result = cv.validate_llm()
+        _print_json(result.to_dict())
+        return 0 if result.ok else 1
+
+    batch = cv.validate_all()
+    _print_json(batch.to_dict())
+    return 0 if batch.ok else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/skills/trtc-ai-realtime-interpreter/start.sh

@@ -0,0 +1,85 @@
+#!/usr/bin/env bash
+# =====================================================================
+# conversation-core 独立启动脚本（Path B 端到端验证用）
+#
+# 只拉起骨架服务（conversation-core + 已安装的能力包路由），不含任何场景 UI。
+# Path A 的完整体验 demo 请用 scenarios/meeting-interpreter/backend/start.sh。
+#
+# 用法：
+#   ./start.sh                  # HTTP 启动（默认端口 8020）
+#   ./start.sh --port 8080      # 自定义端口
+#   ./start.sh --rebuild        # 强制重建 venv
+# =====================================================================
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+CORE_DIR="$SCRIPT_DIR/capabilities/conversation-core"
+ENV_FILE="$CORE_DIR/.env"
+REQUIREMENTS="$CORE_DIR/requirements.txt"
+VENV_DIR="$SCRIPT_DIR/.venv"
+MIN_PY_MAJOR=3; MIN_PY_MINOR=9
+PORT=8020; REBUILD=0
+
+if [ -t 1 ]; then
+    GREEN='\033[0;32m'; YELLOW='\033[1;33m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
+else GREEN=''; YELLOW=''; RED=''; CYAN=''; NC=''; fi
+log()  { printf "${CYAN}[%s]${NC} %s\n" "$(date +%H:%M:%S)" "$*"; }
+ok()   { printf "${GREEN}✓${NC} %s\n" "$*"; }
+warn() { printf "${YELLOW}⚠${NC}  %s\n" "$*"; }
+die()  { printf "${RED}✗${NC} %s\n" "$*" >&2; exit 1; }
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --rebuild) REBUILD=1 ;;
+        --port)    shift; PORT="$1" ;;
+        --help|-h) sed -n '2,15p' "${BASH_SOURCE[0]}" | sed 's/^# \{0,1\}//'; exit 0 ;;
+        *) warn "忽略未知参数: $1" ;;
+    esac
+    shift
+done
+
+[ -f "$ENV_FILE" ] || die ".env not found: $ENV_FILE\n  请先按 SKILL.md 完成三把钥匙配置；\n  或手动: cp $CORE_DIR/.env.example $ENV_FILE 后填写"
+
+PY_CMD=""
+for cand in python3.12 python3.11 python3.10 python3.9 python3 python; do
+    if command -v "$cand" >/dev/null 2>&1; then
+        VER=$("$cand" -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")' 2>/dev/null || echo "0.0")
+        MAJOR=$(echo "$VER" | cut -d. -f1); MINOR=$(echo "$VER" | cut -d. -f2)
+        if [ "$MAJOR" -gt "$MIN_PY_MAJOR" ] || { [ "$MAJOR" -eq "$MIN_PY_MAJOR" ] && [ "$MINOR" -ge "$MIN_PY_MINOR" ]; }; then
+            PY_CMD="$cand"; ok "Python $VER -> $(command -v "$cand")"; break
+        fi
+    fi
+done
+[ -z "$PY_CMD" ] && die "未检测到 Python >= ${MIN_PY_MAJOR}.${MIN_PY_MINOR}"
+
+[ "$REBUILD" -eq 1 ] && [ -d "$VENV_DIR" ] && { warn "重建 venv..."; rm -rf "$VENV_DIR"; }
+NEED_INSTALL=0
+if [ ! -d "$VENV_DIR" ]; then
+    log "创建虚拟环境..."
+    "$PY_CMD" -m venv "$VENV_DIR" || die "venv 创建失败（Linux 可能需要: apt install python3-venv）"
+    NEED_INSTALL=1
+fi
+# shellcheck disable=SC1091
+source "$VENV_DIR/bin/activate"
+VENV_PY="$VENV_DIR/bin/python"; VENV_PIP="$VENV_DIR/bin/pip"
+
+[ "$NEED_INSTALL" -eq 0 ] && ! "$VENV_PY" -c "import fastapi, uvicorn, requests, dotenv, pydantic" 2>/dev/null && NEED_INSTALL=1
+if [ "$NEED_INSTALL" -eq 1 ]; then
+    log "安装依赖..."
+    "$VENV_PIP" install --upgrade pip >/dev/null 2>&1 || true
+    if "$VENV_PIP" install -r "$REQUIREMENTS" -i "https://pypi.tuna.tsinghua.edu.cn/simple" --timeout 15 >/dev/null 2>&1; then
+        ok "依赖安装完成（清华镜像）"
+    else
+        warn "镜像源失败，切换官方源..."
+        "$VENV_PIP" install -r "$REQUIREMENTS" >/dev/null || die "依赖安装失败"
+        ok "依赖安装完成（官方源）"
+    fi
+else ok "依赖已就位"; fi
+
+printf "%b🚀 启动 conversation-core: http://localhost:%s%b (Ctrl+C 停止)\n" "$GREEN" "$PORT" "$NC"
+
+cd "$CORE_DIR"
+export HOST="${HOST:-0.0.0.0}"; export PORT="$PORT"
+exec "$VENV_PY" -m uvicorn src.server:app --host "$HOST" --port "$PORT"

package/skills/trtc-ai-realtime-interpreter/triggers.yaml

@@ -0,0 +1,29 @@
+# trtc-ai-realtime-interpreter trigger word registry
+#
+# Documentation only — routing logic is inlined in SKILL.md frontmatter.
+# Do NOT reference this file as a runtime routing dependency.
+#
+# Purpose: single source of truth for what triggers the interpreter fast-path,
+# so edits happen here and get back-ported to SKILL.md manually.
+
+triggers:
+  include:
+    # Chinese
+    - "实时翻译"
+    - "AI 翻译"
+    - "AI翻译"
+    - "同声传译"
+    - "会议翻译"
+    - "TRTC 翻译"
+    - "TRTC翻译"
+    - "会议实时翻译"
+    - "跨语言会议"
+    - "多语言会议"
+    # English
+    - "real-time interpreter"
+    - "real-time translation"
+    - "AI interpreter"
+    - "TRTC Conversational AI"
+    - "meeting interpreter"
+    - "live translation"
+    - "simultaneous interpretation"

package/skills/trtc-ai-service/README.ja.md

@@ -6,11 +6,11 @@
 
 ## デモ
 
-https://github.com/user-attachments/assets/a2e076ce-38c9-4bd8-a40a-e4e09d4ce360
+https://github.com/user-attachments/assets/a2ad1d81-7282-42d1-b5ae-a0b9ec73933b
 
 ## Tencent RTC について
 
-[Tencent RTC](https://trtc.io)（リアルタイムコミュニケーション）は、世界中の数千の企業にリアルタイムの音声、ビデオ、会話型 AI 体験を提供しています。200以上の国と地域をカバーするグローバルエッジネットワークにより、TRTCは大規模で300ms未満の超低遅延を実現します。
+[Tencent RTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ)（リアルタイムコミュニケーション）は、世界中の数千の企業にリアルタイムの音声、ビデオ、会話型 AI 体験を提供しています。200以上の国と地域をカバーするグローバルエッジネットワークにより、TRTCは大規模で300ms未満の超低遅延を実現します。
 
 **Conversational AI** 機能により、開発者は聞き取り、理解し、自然に応答できる音声エージェントを構築できます——カスタマーサービス、販売支援、インテリジェントなセルフサービスシナリオに最適です。
 
@@ -52,44 +52,23 @@ AI（すべて自動実行）：
 
 ### インストール
 
-#### Codex CLI
+`npx` でインストール — 任意の IDE で動作し、プラグインマーケットプレイスは不要です。プロジェクトディレクトリ内で実行してください：
 
-**ユーザーレベル**（推奨 — すべてのプロジェクトで利用可能）：
 ```bash
-/skills install https://github.com/Tencent-RTC/agent-skills
-```
-
-**プロジェクトレベル**（現在のプロジェクトのみ利用可能）：
-```bash
-# Skill は ./.codex/skills/ にインストールされます（Finder で隠しフォルダを表示するには Cmd+Shift+.）
-/skills install --project https://github.com/Tencent-RTC/agent-skills
-```
-
-#### Claude Code CLI
-
-**ユーザーレベル**（推奨 — すべてのプロジェクトで利用可能）：
-```bash
-mkdir -p ~/.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ~/.claude/skills/agent-skills
-```
+# デフォルト — インストール済みの IDE（~/.{claude,cursor,codebuddy,codex}/）を自動検出し、
+# 検出された各 IDE にインストールします。検出されない場合は claude にフォールバックします
+npx -y @tencent-rtc/trtc-agent-skills@latest add
 
-**プロジェクトレベル**（現在のプロジェクトのみ利用可能）：
-```bash
-mkdir -p ./.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ./.claude/skills/agent-skills
-```
+# すべてのサポート対象 IDE に強制インストール（インストールしていない IDE も含む）
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide all
 
-#### その他のエージェント（CodeBuddy / Cursor など）
+# 特定の IDE のみにインストール
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide cursor
 
-任意の場所にクローンし、エージェントに `SKILL.md` を指定します：
-```bash
-git clone https://github.com/Tencent-RTC/agent-skills.git
-# そしてエージェントにこう伝えます：
-# "Load the Skill from /path/to/agent-skills/skills/trtc-ai-service/SKILL.md"
+# 再インストール前に以前のインストールをクリーンアップ
+npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 ```
 
-> **インストール後、CLI セッションを再起動**して、Skill が正しく登録・ロードされることを確認してください。
-
 ### トリガーキーワード
 
 - "AI customer service" / "build customer service" / "customer service bot"
@@ -104,8 +83,8 @@ git clone https://github.com/Tencent-RTC/agent-skills.git
 
 | キー | 目的 | 入手先 |
 |-----|---------|-----------------|
-| キー 1：TRTC アプリケーション認証情報 | エージェントが通話や音声チャットを実行可能にします | https://console.trtc.io/?quickclaim=engine_trial（登録して **RTC Engine** アプリを作成 — Conversational AI 対応） |
-| キー 2：Tencent Cloud API キー | Tencent Cloud 音声・通話サービスを使用する権限を証明します（TRTC アカウントとログインが同期されます） | https://console.tencentcloud.com/cam/capi |
+| キー 1：TRTC アプリケーション認証情報 | エージェントが通話や音声チャットを実行可能にします | https://console.trtc.io/?quickclaim=engine_trial&utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=3WFHfiqw（登録して **RTC Engine** アプリを作成 — Conversational AI 対応） |
+| キー 2：Tencent Cloud API キー | Tencent Cloud 音声・通話サービスを使用する権限を証明します（TRTC アカウントとログインが同期されます） | https://console.tencentcloud.com/cam/capi?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=v0K1Q0DSE |
 | キー 3：LLM API キー | エージェントが「考え」— 問い合わせを理解して応答できるようにします | 登録している AI サービス Web サイト（OpenAI、DeepSeek など） |
 
 > AI が各キーの取得方法をステップバイステップで詳しく説明します。キー情報はこの設定セッションでのみ使用され — システムが記録したり漏洩したりすることはありません。
@@ -154,6 +133,10 @@ STT（音声認識）と TTS（音声合成）はどちらも Tencent 自社エ
 | LLM（大規模言語モデル） | [LLM モデル概要](https://trtc.io/document/68338?product=conversationalai) |
 | TTS（音声合成） | [TTS モデル概要](https://trtc.io/document/68340?product=conversationalai) |
 
+### STT 対応言語
+
+`engine_model_type` に `bigmodel` を指定すると、音声認識の言語を指定できます。対応言語：`zh`（中国語）、`en`（英語）、`yue`（広東語）、`ar`（アラビア語）、`de`（ドイツ語）、`fr`（フランス語）、`es`（スペイン語）、`pt`（ポルトガル語）、`id`（インドネシア語）、`it`（イタリア語）、`ko`（韓国語）、`ru`（ロシア語）、`th`（タイ語）、`vi`（ベトナム語）、`ja`（日本語）、`tr`（トルコ語）、`hi`（ヒンディー語）、`ms`（マレー語）、`nl`（オランダ語）、`sv`（スウェーデン語）、`da`（デンマーク語）、`fi`（フィンランド語）、`pl`（ポーランド語）、`cs`（チェコ語）、`fil`（フィリピン語）、`fa`（ペルシア語）、`el`（ギリシャ語）、`ro`（ルーマニア語）、`hu`（ハンガリー語）、`mk`（マケドニア語）。
+
 ### 完全なドキュメント
 
 その他の設定が必要な場合は、Conversational AI 概要ページから該当する情報を探してください：

package/skills/trtc-ai-service/README.md

@@ -6,11 +6,11 @@
 
 ## Demo
 
-https://github.com/user-attachments/assets/a2e076ce-38c9-4bd8-a40a-e4e09d4ce360
+https://github.com/user-attachments/assets/a2ad1d81-7282-42d1-b5ae-a0b9ec73933b
 
 ## About Tencent RTC
 
-[Tencent RTC](https://trtc.io) (Real-Time Communication) powers real-time audio, video, and conversational AI experiences for thousands of businesses worldwide. With a global edge network spanning 200+ countries and regions, TRTC delivers sub-300ms ultra-low latency at scale.
+[Tencent RTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ) (Real-Time Communication) powers real-time audio, video, and conversational AI experiences for thousands of businesses worldwide. With a global edge network spanning 200+ countries and regions, TRTC delivers sub-300ms ultra-low latency at scale.
 
 The **Conversational AI** capability enables developers to build voice agents that can listen, understand, and respond naturally — perfect for customer service, sales assistance, and intelligent self-service scenarios.
 
@@ -52,44 +52,23 @@ You never open a terminal or run a script manually.
 
 ### Installation
 
-#### Codex CLI
+Install via `npx` — works with any IDE, no plugin marketplace required. Run it inside your project directory:
 
-**User-level** (recommended — available across all projects):
 ```bash
-/skills install https://github.com/Tencent-RTC/agent-skills
-```
-
-**Project-level** (only available in the current project):
-```bash
-# The skill will be installed to ./.codex/skills/ (Cmd+Shift+. to show hidden folders in Finder)
-/skills install --project https://github.com/Tencent-RTC/agent-skills
-```
-
-#### Claude Code CLI
-
-**User-level** (recommended — available across all projects):
-```bash
-mkdir -p ~/.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ~/.claude/skills/agent-skills
-```
+# Default — auto-detect installed IDEs (~/.{claude,cursor,codebuddy,codex}/)
+# and install for each one found. Falls back to claude if none detected.
+npx -y @tencent-rtc/trtc-agent-skills@latest add
 
-**Project-level** (only available in the current project):
-```bash
-mkdir -p ./.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ./.claude/skills/agent-skills
-```
+# Force install for every supported IDE (even ones you don't have)
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide all
 
-#### Other agents (CodeBuddy / Cursor / etc.)
+# Install only for one specific IDE
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide cursor
 
-Clone to any location and point your agent to `SKILL.md`:
-```bash
-git clone https://github.com/Tencent-RTC/agent-skills.git
-# Then tell your agent:
-# "Load the Skill from /path/to/agent-skills/skills/trtc-ai-service/SKILL.md"
+# Wipe a previous install before re-installing
+npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 ```
 
-> **After installation, restart your CLI session** to ensure the Skill is properly registered and loaded.
-
 ### Trigger keywords
 
 - "AI customer service" / "build customer service" / "customer service bot"
@@ -104,8 +83,8 @@ To get the customer service agent running, you need 3 cloud service credentials.
 
 | Key | Purpose | Where to find it |
 |-----|---------|-----------------|
-| Key 1: TRTC Application Credentials | Lets the agent make calls and do voice chat | https://console.trtc.io/?quickclaim=engine_trial (register & create an **RTC Engine** app — supports Conversational AI) |
-| Key 2: Tencent Cloud API Key | Proves you have permission to use Tencent Cloud voice & calling services (login syncs with your TRTC account) | https://console.tencentcloud.com/cam/capi |
+| Key 1: TRTC Application Credentials | Lets the agent make calls and do voice chat | https://console.trtc.io/?quickclaim=engine_trial&utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=3WFHfiqw (register & create an **RTC Engine** app — supports Conversational AI) |
+| Key 2: Tencent Cloud API Key | Proves you have permission to use Tencent Cloud voice & calling services (login syncs with your TRTC account) | https://console.tencentcloud.com/cam/capi?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=v0K1Q0DSE |
 | Key 3: LLM API Key | Lets the agent "think" — understand queries and respond | Your registered AI service website (e.g. OpenAI, DeepSeek, etc.) |
 
 > The AI will tell you exactly how to get each key step by step. Your key info is only used for this configuration session — the system does not log or leak it.
@@ -154,6 +133,10 @@ To change the underlying STT, LLM, or TTS models, check the model overview for e
 | LLM (Language Model) | [LLM Model Overview](https://trtc.io/document/68338?product=conversationalai) |
 | TTS (Text-to-Speech) | [TTS Model Overview](https://trtc.io/document/68340?product=conversationalai) |
 
+### STT supported languages
+
+When `engine_model_type` is set to `bigmodel`, you can specify the audio language for STT. Supported languages: `zh` (Chinese), `en` (English), `yue` (Cantonese), `ar` (Arabic), `de` (German), `fr` (French), `es` (Spanish), `pt` (Portuguese), `id` (Indonesian), `it` (Italian), `ko` (Korean), `ru` (Russian), `th` (Thai), `vi` (Vietnamese), `ja` (Japanese), `tr` (Turkish), `hi` (Hindi), `ms` (Malay), `nl` (Dutch), `sv` (Swedish), `da` (Danish), `fi` (Finnish), `pl` (Polish), `cs` (Czech), `fil` (Filipino), `fa` (Persian), `el` (Greek), `ro` (Romanian), `hu` (Hungarian), `mk` (Macedonian).
+
 ### Full documentation
 
 For any other configuration needs, start from the Conversational AI overview and navigate from there:

package/skills/trtc-ai-service/README.zh-CN.md

@@ -6,11 +6,11 @@
 
 ## 演示
 
-https://github.com/user-attachments/assets/a2e076ce-38c9-4bd8-a40a-e4e09d4ce360
+https://github.com/user-attachments/assets/a2ad1d81-7282-42d1-b5ae-a0b9ec73933b
 
 ## 关于 Tencent RTC
 
-[Tencent RTC](https://trtc.io)（实时音视频）为全球数千家企业提供实时音频、视频和对话式 AI 体验。依托覆盖 200+ 国家和地区的全球边缘网络，TRTC 提供低于 300ms 的超低延迟大规模实时通信能力。
+[Tencent RTC](https://trtc.io/?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=HIzH2eVJ)（实时音视频）为全球数千家企业提供实时音频、视频和对话式 AI 体验。依托覆盖 200+ 国家和地区的全球边缘网络，TRTC 提供低于 300ms 的超低延迟大规模实时通信能力。
 
 **Conversational AI** 能力让开发者可以构建能够聆听、理解并自然回应的语音智能体——非常适合客服、销售辅助和智能自助服务场景。
 
@@ -52,44 +52,23 @@ AI（自动完成所有操作）：
 
 ### 安装方式
 
-#### Codex CLI
+通过 `npx` 安装 — 支持任意 IDE，无需插件市场。在项目根目录执行：
 
-**用户级安装**（推荐 — 所有项目均可使用）：
 ```bash
-/skills install https://github.com/Tencent-RTC/agent-skills
-```
-
-**项目级安装**（仅当前项目可用）：
-```bash
-# Skill 将安装到 ./.codex/skills/（访达中按 Cmd+Shift+. 可显示隐藏文件夹）
-/skills install --project https://github.com/Tencent-RTC/agent-skills
-```
-
-#### Claude Code CLI
-
-**用户级安装**（推荐 — 所有项目均可使用）：
-```bash
-mkdir -p ~/.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ~/.claude/skills/agent-skills
-```
+# 默认 — 自动检测已安装的 IDE（~/.{claude,cursor,codebuddy,codex}/）
+# 为每一个检测到的 IDE 都安装好；都没检测到时回退到 claude
+npx -y @tencent-rtc/trtc-agent-skills@latest add
 
-**项目级安装**（仅当前项目可用）：
-```bash
-mkdir -p ./.claude/skills
-git clone https://github.com/Tencent-RTC/agent-skills.git ./.claude/skills/agent-skills
-```
+# 强制为所有支持的 IDE 都装一份（即使你本机没装那个 IDE）
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide all
 
-#### 其他 Agent（CodeBuddy / Cursor 等）
+# 只为某个指定的 IDE 安装
+npx -y @tencent-rtc/trtc-agent-skills@latest add --ide cursor
 
-克隆到任意位置，然后让 Agent 加载 `SKILL.md`：
-```bash
-git clone https://github.com/Tencent-RTC/agent-skills.git
-# 然后对你的 Agent 说：
-# "从 /path/to/agent-skills/skills/trtc-ai-service/SKILL.md 加载这个 Skill"
+# 重装前先清理旧的安装
+npx -y @tencent-rtc/trtc-agent-skills@latest add --clean
 ```
 
-> **安装完成后，请重启 CLI 会话** 以确保 Skill 被正确注册和加载。
-
 - "AI客服" / "搭建客服" / "客服机器人"
 - "TRTC + 客服" / "语音智能体 + 客服"
 - "帮我用 TRTC 搭建一个 AI 客服"
@@ -102,8 +81,8 @@ git clone https://github.com/Tencent-RTC/agent-skills.git
 
 | 密钥 | 用途 | 获取地址 |
 |------|------|---------|
-| 密钥 1：TRTC 应用凭证 | 让智能体能够拨打电话和进行语音聊天 | https://console.trtc.io/?quickclaim=engine_trial（注册并创建 **RTC Engine** 应用，支持 Conversational AI） |
-| 密钥 2：Tencent Cloud API Key | 证明你有权限使用 TRTC 语音和通话服务（登录态与 TRTC 账号自动同步） | https://console.tencentcloud.com/cam/capi |
+| 密钥 1：TRTC 应用凭证 | 让智能体能够拨打电话和进行语音聊天 | https://console.trtc.io/?quickclaim=engine_trial&utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=3WFHfiqw（注册并创建 **RTC Engine** 应用，支持 Conversational AI） |
+| 密钥 2：Tencent Cloud API Key | 证明你有权限使用 TRTC 语音和通话服务（登录态与 TRTC 账号自动同步） | https://console.tencentcloud.com/cam/capi?utm_source=github&utm_medium=skill&utm_campaign=Twitter%20AI%20%E4%B8%93%E9%A1%B9%20-%20AI%20Oral%20Coach&_channel_track_key=v0K1Q0DSE |
 | 密钥 3：LLM API Key | 让智能体能够"思考"——理解用户问题并回复 | 你注册的 AI 服务网站（如 OpenAI、DeepSeek 等） |
 
 > AI 会一步步详细告诉你如何获取每个密钥。你的密钥信息仅用于本次配置会话——系统不会记录或泄露。
@@ -152,6 +131,10 @@ STT（语音识别）和 TTS（语音合成）均使用腾讯自研引擎。你
 | LLM（大语言模型） | [LLM 模型总览](https://trtc.io/document/68338?product=conversationalai) |
 | TTS（语音合成） | [TTS 模型总览](https://trtc.io/document/68340?product=conversationalai) |
 
+### STT 支持语种
+
+当 `engine_model_type` 指定为 `bigmodel` 时，可指定音频语种。支持语种包括：`zh`（中文）、`en`（英语）、`yue`（粤语）、`ar`（阿拉伯语）、`de`（德语）、`fr`（法语）、`es`（西班牙语）、`pt`（葡萄牙语）、`id`（印尼语）、`it`（意大利语）、`ko`（韩语）、`ru`（俄语）、`th`（泰语）、`vi`（越南语）、`ja`（日语）、`tr`（土耳其语）、`hi`（印地语）、`ms`（马来语）、`nl`（荷兰语）、`sv`（瑞典语）、`da`（丹麦语）、`fi`（芬兰语）、`pl`（波兰语）、`cs`（捷克语）、`fil`（菲律宾语）、`fa`（波斯语）、`el`（希腊语）、`ro`（罗马尼亚语）、`hu`（匈牙利语）、`mk`（马其顿语）。
+
 ### 完整文档
 
 如有其他配置需求，请从 Conversational AI 总览页出发寻找相应答案：