rename

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Your Task

你的任务

Input: $ARGUMENTS

Rename an album or track using the MCP rename tools.

输入：$ARGUMENTS

使用MCP重命名工具重命名专辑或曲目。

Rename Skill

重命名Skill

You rename albums or tracks, updating slugs, display titles, and all mirrored directory paths (content, audio, documents).

你需要重命名专辑或曲目，更新slug、显示标题以及所有镜像目录路径（内容、音频、文档）。

Step 1: Parse Arguments

步骤1：解析参数

Expected format:

<type> <current-name> <new-name>

Examples:

```
album old-album-name new-album-name
```

track my-album 01-old-track 01-new-track

If arguments are missing or unclear, show usage:

Usage:
  /rename album <current-slug> <new-slug>
  /rename track <album-slug> <current-track-slug> <new-track-slug>

Examples:
  /rename album my-old-album my-new-album
  /rename track my-album 01-old-name 01-new-name

预期格式：

<类型> <当前名称> <新名称>

示例：

```
album old-album-name new-album-name
```

track my-album 01-old-track 01-new-track

如果参数缺失或不明确，显示使用说明：

Usage:
  /rename album <current-slug> <new-slug>
  /rename track <album-slug> <current-track-slug> <new-track-slug>

Examples:
  /rename album my-old-album my-new-album
  /rename track my-album 01-old-name 01-new-name

Step 2: Verify Config via MCP

步骤2：通过MCP验证配置

Call

get_config()

to verify configuration is loaded. The MCP rename tools resolve paths internally, but config must be valid.

调用

get_config()

验证配置是否已加载。MCP重命名工具会在内部解析路径，但配置必须有效。

Step 3: Confirm with User

步骤3：与用户确认

Before renaming, confirm the action:

For albums:

Rename album 'old-name' -> 'new-name'?

This will:
- Move content directory
- Move audio directory (if exists)
- Move documents directory (if exists)
- Update README.md title
- Update state cache

For tracks:

Rename track 'old-name' -> 'new-name' in album 'album-name'?

This will:
- Rename track file
- Update title in metadata table
- Update state cache

Note: Audio files are NOT renamed (they have Suno-generated names).

Wait for user confirmation before proceeding.

重命名前，需确认操作：

针对专辑：

是否将专辑'old-name'重命名为'new-name'？

此操作将：
- 移动内容目录
- 移动音频目录（如果存在）
- 移动文档目录（如果存在）
- 更新README.md标题
- 更新状态缓存

针对曲目：

是否将专辑'album-name'中的曲目'old-name'重命名为'new-name'？

此操作将：
- 重命名曲目文件
- 更新元数据表中的标题
- 更新状态缓存

注意：音频文件不会被重命名（它们使用Suno生成的名称）。

等待用户确认后再继续操作。

Step 4: Invoke MCP Tool

步骤4：调用MCP工具

For albums: Use the

rename_album

MCP tool with:

```
old_slug
```
: Current album slug
```
new_slug
```
: New album slug
```
new_title
```
: (optional) Custom display title

For tracks: Use the

rename_track

MCP tool with:

```
album_slug
```
: Album containing the track
```
old_track_slug
```
: Current track slug
```
new_track_slug
```
: New track slug
```
new_title
```
: (optional) Custom display title

针对专辑： 使用

rename_album

MCP工具，参数包括：

```
old_slug
```
: 当前专辑slug
```
new_slug
```
: 新专辑slug
```
new_title
```
: （可选）自定义显示标题

针对曲目： 使用

rename_track

MCP工具，参数包括：

```
album_slug
```
: 包含该曲目的专辑slug
```
old_track_slug
```
: 当前曲目slug
```
new_track_slug
```
: 新曲目slug
```
new_title
```
: （可选）自定义显示标题

Step 5: Report Results

步骤5：报告结果

Success:

Renamed album 'old-name' -> 'new-name'
  Content directory: moved
  Audio directory: moved (or: no audio directory found)
  Documents directory: moved (or: no documents directory found)
  Tracks updated: N

For tracks:

Renamed track 'old-name' -> 'new-name' in album 'album-name'
  Old path: /path/to/old-file.md
  New path: /path/to/new-file.md
  Title updated to: "New Name"

成功（专辑）：

已将专辑'old-name'重命名为'new-name'
  内容目录：已移动
  音频目录：已移动（或：未找到音频目录）
  文档目录：已移动（或：未找到文档目录）
  已更新曲目数量：N

成功（曲目）：

已将专辑'album-name'中的曲目'old-name'重命名为'new-name'
  原路径：/path/to/old-file.md
  新路径：/path/to/new-file.md
  标题已更新为："New Name"

Error Handling

错误处理

Album/track not found:

Error: Album 'name' not found.
Available albums: album-1, album-2, album-3

New name already exists:

Error: Album 'new-name' already exists.
Choose a different name.

Partial failure (album rename):

Warning: Content directory renamed successfully, but:
  - Audio directory rename failed: [error]
  - Documents directory rename failed: [error]

The content directory has been moved. Use rebuild_state to refresh the cache,
then manually move any remaining directories.

未找到专辑/曲目：

错误：未找到专辑'name'。
可用专辑：album-1, album-2, album-3

新名称已存在：

错误：专辑'new-name'已存在。
请选择其他名称。

部分失败（专辑重命名）：

警告：内容目录重命名成功，但：
  - 音频目录重命名失败：[错误信息]
  - 文档目录重命名失败：[错误信息]

内容目录已移动。请使用rebuild_state刷新缓存，然后手动移动剩余目录。