media-post

Files (43)

• CHANGELOG.md
• README.md
• SKILL.md
• VALIDATION.md
• __init__.py
• icon.svg
• mediapost_chapter_renderer.py
• mediapost_cover_picker.py
• __init__.py · mediapost_inline/
• storage_stats.py · mediapost_inline/
• system_deps.py · mediapost_inline/
• upload_preview.py · mediapost_inline/
• mediapost_models.py
• mediapost_pipeline.py
• mediapost_recompose.py
• mediapost_seo_generator.py
• mediapost_task_manager.py
• mediapost_vlm_client.py
• plugin.json
• plugin.py
• __init__.py · tests/
• conftest.py · tests/
• __init__.py · tests/integration/
• test_qwen_vl_smoke.py · tests/integration/
• test_recompose_smoke.py · tests/integration/
• test_chapter_renderer.py · tests/
• test_cover_picker.py · tests/
• test_models.py · tests/
• test_pipeline.py · tests/
• test_recompose.py · tests/
• test_relay_integration.py · tests/
• test_routes.py · tests/
• test_seo_generator.py · tests/
• test_skeleton.py · tests/
• test_task_manager.py · tests/
• test_vlm_client.py · tests/
• bootstrap.js · ui/dist/_assets/
• i18n.js · ui/dist/_assets/
• icons.js · ui/dist/_assets/
• markdown-mini.js · ui/dist/_assets/
• styles.css · ui/dist/_assets/
• icon.svg · ui/dist/
• index.html · ui/dist/

SKILL.md (first lines)

# Media Post Skill Definition

Single source of truth: [`docs/media-post-plan.md`](../../docs/media-post-plan.md) v1.0.

## 1. Trigger Scenarios

Use this skill when the user wants to:

- Pick the best cover image from an edited video
- Repurpose a 16:9 video to 9:16 (Reels / Shorts / TikTok) or 1:1 (feed)
- Generate platform-specific titles, descriptions, hashtags, and chapter
  timestamps for TikTok / Bilibili / WeChat / Xiaohongshu / YouTube
- Render chapter / section cards as PNGs from a chapter list

Keywords (zh + en): 封面, 选封面, 竖版, 9:16, 重构图, 多端, SEO, 标题,
hashtag, 章节卡, cover, vertical, recompose, repurpose, hashtags,
description, chapter cards, vlog publishing, social media kit.

## 2. Command Reference

| Tool | Purpose |
|------|---------|
| `media_post_create` | Submit a new task (any of 4 modes) |
| `media_post_status` | Get the current state and outputs of one task |
| `media_post_list` | List recent tasks (filterable by mode and status) |
| `media_post_cancel` | Cancel a running task |

## 3. Input Schema

### `media_post_create`

```json
{
  "mode": "cover_pick | multi_aspect | seo_pack | chapter_cards",
  "video_path": "/uploads/edited.mp4",
  "params": {
    // cover_pick
    "quantity": 8,
    "min_score_threshold": 3.0,
    "platform_hint": "universal | tiktok | bilibili | wechat | xiaohongshu | youtube",

    // multi_aspect
    "target_aspects": ["9:16", "1:1"],
    "recompose_fps": 2.0,
    "letterbox_fallback": true,

    // seo_pack
    "platforms": ["tiktok", "bilibili", "wechat", "xiaohongshu", "youtube"],
    "instruction": "Pet daily vlog",
    "subtitle_path": "/uploads/sub.srt",
    "include_chapters": true,

    // chapter_cards
    "template_id": "modern | minimal | retro | youtube_style | custom",
    "chapters": [
      { "title": "Intro", "subtitle": "Why we made this", "start_time": 0 }
    ]
  },
  "cost_approved": false
}
```

`cost_approved=true` is required only when the cost preview crosses the
configured warn threshold (default ¥10) — the API replies with HTTP 402
`ApprovalRequired` otherwise.

### `media_post_status`

```json
{ "task_id": "abc123def456" }
```

### `media_post_list`

```json
{ "mode": "cover_pick", "status": "succeeded", "limit": 20, "offset": 0 }
```

### `media_post_cancel`

```json
{ "task_id": "abc123def456" }
```

## 4. Output Schema

### Task envelope (shared by all modes)

```json
{
  "id": "abc123def456",
  "mode": "cover_pick",
  "status": "pending | running | succeeded | failed | cancelled",
  "pipeline_step": "setup | check_deps | estimate_cost | prepare_assets | <mode_run> | finalize",
  "progress": 0.0,
  "cost_estimate_cny": 0.32,
  "cost_actual_cny": 0.31,
  "error_kind": "network | timeout | auth | quota | moderation | dependency | format | duration | unknown",
  "error_message": "...",
  "error_hints": ["...", "..."],
  "outputs": { /* mode-specific, see below */ }
}
```

### Mode-specific outputs

| Mode | Output shape |
|------|--------------|
| `cover_pick` | `{ "covers": [{ "path": "...", "score": 4.2, "axis_scores": {...}, "best_for": "...", "bbox": {...} }] }` |
| `multi_aspect` | `{ "outputs": [{ "aspect": "9:16", "path": "...", "trajectory": [[t, x], ...] }] }` |
| `seo_pack` | `{ "platforms": { "tiktok": { "title": "...", "description": "...", "hashtags": [...] }, ... } }` |
| `chapter_cards` | `{ "cards": [{ "index": 0, "path": "...", "title": "..." }] }` |

## 5. Error Codes (canonical 9-key taxonomy)

| Kind | Meaning | User Action |
|------|---------|-------------|
| `network` | Connection failed / DNS / proxy | Check network, retry |
| `timeout` | Vendor request exceeded the timeout window | Retry, or split into smaller jobs |

From LZM163126lzm/openakita, AGPL-3.0.

More from LZM163126lzm/openakita