Media Naming Guide — AI skill for Claude Code

media-naming-guide

**Chinese media library naming conventions for Plex, Emby, Jellyfin, and other media servers.**

中文影视库命名规范 + [Cursor AI Skill](https://docs.cursor.com/features/skills)，适用于任何存储设备和媒体服务器。

[中文](#功能) | [English](#features)

---

Features

This guide standardizes Chinese media filenames with a format that works across all major media servers:

电影: 中文名 English Name (年份) [分辨率 来源]/
剧集: 中文名 English Name SXX/

**What's inside:**

• Naming conventions for movies, TV series, extras, and multi-part films
• Positive validation regex — scan your library and find all non-conforming names
• Chinese censorship evasion decoding guide — decode names like S探, 让丨Z弹飞, 人MG仆
• English name verification best practices — avoid common pitfalls
• A ready-to-use scanner script (scripts/scan.py)

Quick Examples

Before	After
The.Imitation.Game.2014.DVDSCR.x264-GoPanda	模仿游戏 The Imitation Game (2014)
煎饼侠.Jian.Bing.Man.2015.HD1080P.Mp4Ba	煎饼侠 Jian Bing Man (2015) [1080p]
S探 S01	神探 Detective S01
让丨Z弹飞	让子弹飞 Let the Bullets Fly (2010)

Use as Cursor Skill

Add this repo as a Cursor Skill to let AI agents organize your media library:

# Clone to your Cursor skills directory
git clone https://github.com/skyzhao1223/media-naming-guide.git \
  ~/.cursor/skills/media-naming-guide

Then mention any of the following in Cursor chat to activate the skill: `影视整理` `电影命名` `剧集命名` `media library` `Plex naming` `资源整理`

Scan Your Library

python scripts/scan.py /path/to/media

The scanner recursively validates every file and directory against the naming conventions. It groups issues by type and reports all non-conforming items.

# Output as JSON for scripting
python scripts/scan.py /path/to/media --json > issues.json

Your media directory should contain `电影/` and/or `剧集/` subdirectories.

Related: ZSpace NAS users

If you use a [ZSpace (极空间)](https://www.zspace.cn/)