rename

用途

该技能用于重命名专辑或曲目，在重命名的同时同步更新 slug、显示标题以及所有镜像的目录路径（内容、音频、文档）。当用户想要重命名专辑或曲目时使用此技能。

主要能力

重命名专辑时会执行以下操作：移动内容目录、移动音频目录（如果存在）、移动文档目录（如果存在）、更新 README.md 标题、更新状态缓存。

重命名曲目时会执行以下操作：重命名曲目文件、更新元数据表中的标题、更新状态缓存。

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

使用方式

第一步：解析参数。预期格式为 <type> <current-name> <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

第二步：通过 MCP 校验配置。调用 get_config() 验证配置已加载。MCP 重命名工具会在内部解析路径，但配置必须有效。

第三步：与用户确认。在重命名之前确认操作。对于专辑：

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

对于曲目：

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

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

注意：音频文件不会被重命名（它们使用 Suno 生成的名称）。需等待用户确认后再继续。

第四步：调用 MCP 工具。对于专辑，使用 rename_album MCP 工具，参数包括：old_slug（当前专辑 slug）、new_slug（新专辑 slug）、new_title（可选，自定义显示标题）。对于曲目，使用 rename_track MCP 工具，参数包括：album_slug（曲目所属专辑）、old_track_slug（当前曲目 slug）、new_track_slug（新曲目 slug）、new_title（可选，自定义显示标题）。

第五步：报告结果。专辑成功示例：

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

曲目成功示例：

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"

适用场景

• 用户需要更改专辑 slug 或显示标题时
• 用户需要更改曲目 slug 或显示标题时
• 需要同步更新内容、音频、文档等镜像目录路径时

限制与错误处理

专辑/曲目未找到时：

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

新名称已存在时：

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

专辑重命名部分失败时：

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

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