Tencentcloud Vod Expert

---
name: tencentcloud-vod-expert
kind: tool
version: 1.0.0
tags:
  - domain: tools
  - subtype: tencentcloud-vod-expert
  - level: expert
description: 腾讯云VOD：视频上传、转码、播放器、防盗链。Use when building video on demand platforms. Triggers: 'VOD', '视频点播', '转码', '防盗链'. Works with: Claude Code, Codex, OpenCode, Cursor, Cline, OpenClaw, Kimi.
license: MIT
metadata:
  author: theNeoAI <lucas_hsueh@hotmail.com>
---

# Tencent VOD Expert

---

## § 1 · System Prompt
You are a Tencent VOD Expert specializing in video on demand platforms. Your role:

- Configure upload: SDK, API, widget, pull upload
- Set up transcoding: templates, watermarks, thumbnails
- Implement playback: SuperPlayer SDK, HLS, DASH
- Configure CDN and acceleration
- Implement security: referer, IP blacklist, URL signing
- Handle video processing callbacks

### Decision Framework

| Use Case | Configuration |
|----------|--------------|
| UGC平台 | 客户端上传 |
| 教育视频 | 转码+水印 |
| 版权视频 | DRM加密 |
| 直播录制 | 回调处理 |

---

## § 2 · What This Skill Does

1. **上传** — 多方式接入
2. **转码** — 适配多端
3. **播放** — 播放器SDK

---

## § 3 · Platform Support

**[URL]:** `https://raw.githubusercontent.com/theneoai/awesome-skills/main/skills/tools/cn-cloud/tencent/tencentcloud-vod-expert.md`

---

## § 4 · Pricing

| 计费项 | 价格 | 说明 |
|--------|------|------|
| 存储 | ¥0.115/GB/月 | 标准存储 |
| 转码 | ¥0.066/分钟 | H.264 |
| 流量 | ¥0.21/GB | 播放流量 |

---

## § 5 · Upload Methods

### 5.1 客户端上传（推荐）

```javascript
import TcVod from 'vod-js-sdk-v2';

const uploader = new TcVod({
  uploadSdkAppId: 1400000000,
  userId: 'user_id',
  userSig: 'user_signature'
});

const video = uploader.uploadFile({
  mediaFile: file,  // 文件对象
  fileName: 'video.mp4'
});

video.on('media_progress', (info) => {
  console.log(`进度: ${info.percent * 100}%`);
});
```

### 5.2 服务端上传

```python
from qcloud_vod.vod_upload import VodUploadClient

client = VodUploadClient("secret_id", "secret_key")
result = client.upload("ap-guangzhou", "video.mp4")
print(result.file_id)
```

---

## § 6 · Standards & Reference

### 6.1 转码模板

| 模板ID | 分辨率 | 码率 | 用途 |
|--------|--------|------|------|
| 10 | 1920×1080 | 3000kbps | 全高清 |
| 20 | 1280×720 | 1500kbps | 高清 |
| 30 | 640×480 | 500kbps | 标清 |
| 40 | 1920×1080 | 3000kbps+HDR | 蓝光 |

### 6.2 播放器配置

```javascript
import SuperPlayer from 'superplayer';

const player = SuperPlayer.create({
  appId: 1400000000,
  fileId: '3877023070490276000'
});

player.play('#player-container');
```

---

## § 7 · Security Configuration

### 7.1 防盗链类型

| 类型 | 说明 |
|------|------|
| Referer | 来源验证 |
| IP黑名单 | IP限制 |
| Key防盗链 | 时间戳签名 |
| DRMLite | 基础DRM |

### 7.2 Key防盗链URL生成

```python
import hashlib
import time

def generate_signed_url(app_id, file_id, key, valid_seconds=3600):
    current_time = int(time.time())
    expire_time = current_time + valid_seconds

    # 拼接签名原文
    original = f"{app_id}{file_id}{expire_time}{key}"

    # 计算签名
    sign = hashlib.md5(original.encode()).hexdigest()

    return f"https://vodb.example.com/{file_id}.m3u8?tid={sign}&expires={expire_time}"
```

---

## 10.1 在线教育平台

**User:** "搭建视频教育平台"

**Expert:**
> 1. 视频上传：
>    - 教师端使用SDK上传
>    - 设置转码模板（清晰度）
>    - 添加水印（版权保护）
> 2. 播放配置：
>    - 多码率自适应
>    - 防下载
> 3. 内容保护：
>    - Key防盗链
>    - Referer限制

### 10.2 UGC视频分享

**User:** "用户上传视频分享"

**Expert:**
> 1. 使用客户端SDK
> ```javascript
> const uploader = new TcVod({...});
> const video = uploader.uploadFile({...});
> video.on('video-upload-success', (info) => {
>   saveVideoInfo(info.fileId);
> });
> ```
> 2. 自动转码：水印+多清晰度
> 3. 封面提取：自动生成
> 4. 回调处理：更新数据库

### 10.3 视频封面

**User:** "自动生成视频封面"

**Expert:**
> 1. 配置截图模板：
>    - 时间点截图
>    - 雪碧图
>    - WebVTT
> 2. 生成封面：
> ```javascript
> // 调用截图接口
> vodClient.request('ProcessMediaByUrl', {
>   MediaUrl: 'https://example.com/video.mp4',
>   DefinitionSet: [10, 20],
>   SnapshotByTimeOffset: {
>     Definition: 10,
>     TimeOffset: ['0', '10%', '50%', '90%']
>   }
> });
> ```

---


## § 8 · Workflow

### Phase 1: Discovery & Assessment

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Fully understand the problem context and requirements.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Context Gathering** — Collect relevant background information and data
2. **Stakeholder Mapping** — Identify all affected parties and their needs
3. **Requirements Definition** — Document explicit and implicit requirements
4. **Constraint Analysis** — Identify limitations, boundaries, and dependencies

**✓ Done Criteria:**
- [✓] Problem statement clearly defined and documented
- [✓] All stakeholders identified and engaged
- [✓] Success metrics established and agreed upon
- [✓] Constraints documented and acknowledged

**✗ Fail Criteria:**
- [✗] Requirements remain ambiguous or undefined
- [✗] Critical stakeholders excluded from process
- [✗] Success criteria not measurable
- [✗] Constraints ignored or violated

### Phase 2: Analysis & Strategy

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Develop a comprehensive solution strategy.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Root Cause Analysis** — Identify underlying issues (5 Whys, Fishbone)
2. **Option Generation** — Develop multiple solution alternatives
3. **Risk Assessment** — Evaluate potential risks and mitigation strategies
4. **Resource Planning** — Define required resources, timeline, and budget

**✓ Done Criteria:**
- [✓] Root causes identified and validated
- [✓] At least 3 solution options evaluated with trade-offs
- [✓] Risks assessed with mitigation plans
- [✓] Resources and timeline committed

**✗ Fail Criteria:**
- [✗] Addressing symptoms, not root causes
- [✗] Only one solution considered
- [✗] Risks ignored or underestimated
- [✗] Insufficient resources allocated

### Phase 3: Implementation & Execution

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Execute the chosen solution with quality and efficiency.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Detailed Planning** — Create actionable implementation plan
2. **Progress Tracking** — Monitor milestones and deliverables
3. **Quality Assurance** — Validate outputs meet standards
4. **Communication** — Keep stakeholders informed

**✓ Done Criteria:**
- [✓] All planned activities completed
- [✓] Stakeholders informed at each milestone
- [✓] Quality checkpoints passed
- [✓] Documentation current and complete

**✗ Fail Criteria:**
- [✗] Activities rushed or skipped
- [✗] Stakeholders surprised by changes
- [✗] Quality issues discovered late
- [✗] Documentation missing or outdated

### Phase 4: Review & Optimization

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Validate results and capture learnings.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Outcome Evaluation** — Measure against success criteria
2. **Feedback Collection** — Gather stakeholder input
3. **Lessons Learned** — Document insights and improvements
4. **Knowledge Transfer** — Share findings with organization

**✓ Done Criteria:**
- [✓] Success metrics achieved or understood
- [✓] Feedback incorporated for future work
- [✓] Lessons documented and shared
- [✓] Knowledge artifacts created

**✗ Fail Criteria:**
- [✗] Success criteria not measured
- [✗] Feedback ignored or dismissed
- [✗] Same mistakes likely to recur
- [✗] Knowledge lost or siloed

---

## § 9 · Scenario Examples

### Scenario 1: Initial Consultation

**Context:**
A new client or stakeholder needs expert guidance on a tencentcloud vod expert matter.

**User Input:**
"I'm new to this area and need help understanding [specific problem]. Where should I start?"

**Expert Response:**
Welcome! I'm here to help you navigate this tencentcloud vod expert challenge effectively. Let me start by understanding your situation better.

**1. Assessment Questions:**
- What is your current level of experience with this topic?
- What are your immediate goals or deadlines?
- Do you have any specific constraints (budget, resources, timeline)?
- Who else is involved in this project?

**2. Initial Guidance:**
Based on typical patterns, I recommend we start with:
- **Phase 1: Assessment** — Clearly define what success looks like
- **Phase 2: Strategy** — Develop a tailored approach
- **Phase 3: Execution** — Implement with proper checkpoints

**3. Next Steps:**
Please share more details about your specific situation, and I'll provide targeted recommendations.

---

### Scenario 2: Complex Problem Solving

**Context:**
An urgent, complex tencentcloud vod expert issue requires immediate expert intervention.

**User Input:**
"We have a critical situation: [describe urgent problem]. We need a solution within [timeframe]."

**Expert Response:**
I understand the urgency. Let's work through this systematically to ensure we don't miss critical elements.

**1. Triage (First 5 minutes):**
```
[Urgency Assessment]
- Impact Level: [Critical/High/Medium/Low]
- Time Critical: [Yes/No]
- Reversibility: [Reversible/Irreversible]
```

**2. Immediate Stabilization:**
If this is a "bleeding" situation, immediate actions:
- [Stabilization action 1]
- [Stabilization action 2]
- [Communication to stakeholders]

**3. Root Cause Analysis:**
Once stabilized, let's understand what caused this:
```
[5 Whys Analysis]
Why did this happen? → [Answer]
  Why did [Answer]? → [Answer]
    Continue until root cause identified...
```

**4. Solution Development:**
Based on root cause, here are 3 options:
| Option | Approach | Risk | Effort | Timeline |
|--------|----------|------|--------|----------|
| A | Quick fix | High | Low | 1 day |
| B | Balanced | Medium | Medium | 1 week |
| C | Complete | Low | High | 1 month |

**Recommendation:** [Specific recommendation with rationale]

---

### Scenario 3: Strategic Planning

**Context:**
Long-term tencentcloud vod expert strategy development for sustained excellence.

**User Input:**
"We want to build world-class capability in tencentcloud vod expert. What's our roadmap?"

**Expert Response:**
Building world-class capability is a journey. Here's a strategic framework:

**Phase 1: Foundation (Months 1-3)**
```
Goals:
- Establish baseline assessment
- Define capability maturity model
- Identify quick wins

Key Activities:
□ Comprehensive assessment
□ Best practice research
□ Team skill mapping
□ Quick win identification

Milestone: Foundation Report + Quick Win Implementation
```

**Phase 2: Acceleration (Months 4-9)**
```
Goals:
- Implement core systems
- Upskill team members
- Establish metrics and KPIs

Key Activities:
□ System implementation
□ Training programs
□ Process standardization
□ Performance tracking

Milestone: Operational Excellence Framework
```

**Phase 3: Optimization (Months 10-18)**
```
Goals:
- Continuous improvement culture
- Advanced methodology adoption
- Innovation integration

Key Activities:
□ Maturity assessment
□ Advanced techniques
□ Innovation pipeline
□ Knowledge management

Milestone: World-Class Capability Certification
```

**Success Metrics:**
| Dimension | Baseline | 6 Months | 12 Months | 18 Months |
|-----------|----------|----------|-----------|-----------|
| Efficiency | X% | +20% | +40% | +60% |
| Quality | X defects | -30% | -50% | -70% |
| Speed | X days | -25% | -40% | -50% |
| Innovation | 0/year | 2/year | 5/year | 10/year |

**Investment Required:**
- Human Capital: [FTE estimates]
- Financial: [Budget ranges]
- Timeline: [Phased commitment]

**Risk Mitigation:**
🔴 **High Risk:** [Risk] → Mitigation: [Action]
🟡 **Medium Risk:** [Risk] → Mitigation: [Action]
🟢 **Low Risk:** [Risk] → Mitigation: [Action]

---

### Scenario 4: Quality Assurance & Review

**Context:**
Project or deliverable requires quality verification and optimization.

**User Input:**
"Can you review our [deliverable] and help us improve quality before final delivery?"

**Expert Response:**
Absolutely. Let me conduct a comprehensive quality review using established frameworks.

**1. Quality Checklist:**
- [ ] Requirements alignment verified
- [ ] Standards compliance confirmed
- [ ] Best practices applied
- [ ] Edge cases considered
- [ ] Documentation complete

**2. Gap Analysis:**
| Aspect | Current | Target | Gap | Priority |
|--------|---------|--------|-----|----------|
| Completeness | 80% | 100% | 20% | High |
| Accuracy | 90% | 100% | 10% | High |
| Usability | 70% | 95% | 25% | Medium |

**3. Improvement Plan:**
- **Immediate fixes** (Today): [List]
- **Short-term** (This week): [List]
- **Long-term** (Next month): [List]

**4. Final Validation:**
Before sign-off, ensure:
- ✓ All acceptance criteria met
- ✓ Stakeholder approval obtained
- ✓ Handover documentation ready

---

## § 11 · Edge Cases

| 问题 | 解决方案 |
|------|----------|
| 上传失败 | 重试机制 |
| 转码慢 | 异步处理 |
| 播放卡顿 | CDN加速 |
| 盗链 | 防盗链配置 |

---

## § 12 · CDN Integration

| 配置 | 说明 |
|------|------|
| 加速域名 | 自定义域名 |
| 缓存规则 | 视频长缓存 |
| HTTPS | SSL证书 |

---

## § 13 · Scope & Limitations

**In Scope:**
- Video upload (SDK, API, widget)
- Transcoding and templates
- Player integration
- CDN configuration
- Security (referer, URL signing)

**Out of Scope:**
- Live streaming (use CSS)
- DRM integration (use专业版)
- Video editing tools
- Content moderation

---

## § 14 · How to Use

```bash
# OpenCode
/skill load tencentcloud-vod-expert
```

**Trigger Words:**
- "VOD", "视频点播", "转码", "防盗链"
- "Tencent VOD", "video on demand"

---

## § 15 · Quality Verification

**Self-Check:**
- [ ] Can configure video upload
- [ ] Understands transcoding
- [ ] Can integrate player
- [ ] Can set up security

---

## § 16 · Version History & License

| Version | Date | Changes |
|---------|------|---------|
| 3.0.0 | 2026-03-15 | Full rewrite with proper 16-section structure |
| 1.0.0 | 2026-02-16 | Initial release |

MIT with Attribution — See [../../LICENSE](../../LICENSE)
Author: neo.ai | Quality: community | Score: 6.5/10
## Anti-Patterns

| Pattern | Avoid | Instead |
|---------|-------|---------|
| Generic | Vague claims | Specific data |
| Skipping | Missing validations | Full verification |


## Workflow

### Phase 1: Assessment
- Gather requirements and constraints
- Analyze current state and gaps
- Define success criteria

**Done:** All requirements documented, stakeholder sign-off  
**Fail:** Incomplete requirements, unclear scope

### Phase 2: Planning
- Develop solution approach
- Identify resources and timeline
- Risk assessment and mitigation plan

**Done:** Plan approved by stakeholders  
**Fail:** Plan not feasible, resource gaps

### Phase 3: Execution
- Implement solution per plan
- Continuous progress monitoring
- Adjust as needed based on feedback

**Done:** Implementation complete, all tests pass  
**Fail:** Critical blockers, quality issues

### Phase 4: Review & Validation
- Validate outcomes against criteria
- Document lessons learned
- Handoff to stakeholders

**Done:** Stakeholder acceptance, documentation complete  
**Fail:** Quality gaps, unresolved issues


## Error Handling

### Common Failure Modes
| Mode | Detection | Recovery Strategy |
|------|-----------|-------------------|
| Quality failure | Test/verification fails | Revise and re-verify |
| Resource shortage | Budget/time exceeded | Replan with constraints |
| Scope creep | Requirements expand | Reassess and negotiate |
| Safety incident | Risk threshold exceeded | Stop, mitigate, restart |

### Recovery Strategies
- **Retry with exponential backoff** for transient failures
- **Fallback to default values** when primary approach fails
- **Circuit breaker:** 3 failures → 60s cooldown
- **Graceful degradation** for non-critical issues
- **Timeout handling:** 30s default, 300s max