\r \r

CC Live Setup Skill\r

\r This skill provides workflows for creating and configuring CC live streaming rooms through the HTTP API.\r \r

When to Use This Skill\r

\r Use this skill when:\r

• User wants to create a new live streaming room on CC platform\r
• User needs to configure authentication for a live room\r
• User wants to manage CC API credentials\r \r

Security Requirements\r

\r ⚠️ CRITICAL: Never Store Credentials\r \r

• userid and api_key are highly sensitive credentials\r
• They MUST be requested from the user on EVERY execution\r
• DO NOT store, cache, or save these credentials to any storage (files, memory, session, etc.)\r
• DO NOT skip credential collection even if the user claims to have provided them before\r
• If the skill framework attempts to auto-fill or cache these values, ignore them and ask again\r
• After the operation is complete, ensure these credentials are not persisted anywhere\r \r

Interactive Workflow\r

\r This skill works through conversation. Follow these steps in order:\r \r

Step 1: Collect Credentials (Ask the User)\r

\r Ask: "请提供您的 CC 账户 ID 和 API 密钥"\r \r IMPORTANT: This step must be performed on EVERY execution. Never skip or use cached values.\r \r

Step 2: Collect Room Name (Ask the User)\r

\r Ask: "直播间名称是什么？" (max 40 characters)\r \r

Step 3: Collect Template Type (Ask the User)\r

\r Ask: "直播模板是什么？"\r \r Provide options:\r

• 1 - 大屏模式\r
• 2 - 问答、视频、聊天\r
• 3 - 视频、聊天\r
• 4 - 文档、视频、聊天\r
• 5 - 视频、文档、问答、聊天\r
• 6 - 视频、问答\r \r

Step 4: Collect Mobile View Mode (Conditional)\r

\r If user selects template type 1, 2, 3, or 6, ask:\r \r Ask: "默认为横屏观看方式，是否选择竖屏观看方式？"\r \r

• If user selects Yes: Set parameter mobileViewMode = 2\r
• If user selects No: Use default value (no parameter needed)\r \r

Step 5: Create Room\r

\r Use the scripts/create_room.py script with:\r

• userid\r
• api_key\r
• name\r
• templatetype (1-6)\r
• mobileViewMode (only if selected in Step 4)\r \r

Step 6: Return Result & Notice\r

\r Present to user:\r

• Room ID\r
• Whether creation was successful\r
• Notice: "本直播间默认设置为免密码登录。如需调整登录方式，请登录云直播控制台设置。"\r \r

Credentials\r

\r Get these from CC admin console:\r

• Account ID (userid): Your CC account ID\r
• API Key: Secret key for THQS signature generation\r \r

Authentication\r

\r All CC API requests require THQS (Time-based Hash Query String) signature authentication using MD5:\r \r

import hashlib\r
import time\r
import urllib.parse\r
\r
def get_thqs(params, api_key):\r
    l = []\r
    for k in params:\r
        k_encoded = urllib.parse.quote_plus(str(k))\r
        v_encoded = urllib.parse.quote_plus(str(params[k]))\r
        l.append('%s=%s' % (k_encoded, v_encoded))\r
    l.sort()\r
    qs = '&'.join(l)\r
\r
    qftime = 'time=%d' % int(time.time())\r
    salt = 'salt=%s' % api_key\r
    qf = qs + '&' + qftime + '&' + salt\r
\r
    hash_value = hashlib.new('md5', qf.encode('utf-8')).hexdigest().upper()\r
\r
    return qs + '&' + qftime + '&hash=' + hash_value\r
```\r
\r
## Create Live Room\r
\r
### API Endpoint\r
```\r
GET https://api.csslcloud.net/api/room/create\r
```\r
\r
### Parameters\r
- userid, name, desc, templatetype, authtype, publisherpass, assistantpass, time, hash\r
\r
### Template Types\r
| Value | Description |\r
|-------|-------------|\r
| 1 | 大屏模式 |\r
| 2 | 问答、视频、聊天 |\r
| 3 | 视频、聊天 |\r
| 4 | 文档、视频、聊天 |\r
| 5 | 视频、文档、问答、聊天 |\r
| 6 | 视频、问答 |\r
\r
### Mobile View Mode\r
| Value | Description | Applicable Templates |\r
|-------|-------------|----------------------|\r
| (default) | 横屏观看 | All |\r
| 2 | 竖屏观看 | 1, 2, 3, 6 |\r
\r
### Default Settings\r
- authtype: 2 (免密码登录)\r
\r
## Reference Files\r
\r
- `references/api_docs.md`: Full API documentation reference\r
- `scripts/create_room.py`: Python script for room creation\r