album-dashboard

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Your Task

你的任务

Input: $ARGUMENTS (album name)

Generate a structured progress dashboard for the specified album.

输入：$ARGUMENTS（专辑名称）

为指定专辑生成结构化的进度仪表盘。

Album Dashboard

专辑仪表盘

You generate a comprehensive progress report for an album, showing completion percentage per workflow phase, blocking items, and a structured status breakdown.

你需要生成一份全面的专辑进度报告，展示各工作流阶段的完成百分比、阻塞项以及结构化的状态细分。

Workflow Phases

工作流阶段

Track completion across these phases:

Phase	Complete When
1. Concept	Album README has title, genre, tracklist defined
2. Research	RESEARCH.md and SOURCES.md exist (if source-based)
3. Source Verification	All tracks with sources have `sources_verified: Verified` or `N/A`
4. Lyrics	All tracks have lyrics in their Lyrics Box
5. Pronunciation	All pronunciation table entries applied in lyrics
6. Review	Lyrics reviewed (no critical issues remain)
7. Generation	All tracks have `has_suno_link: true`
8. Mastering	Audio files exist in `{audio_root}/artists/{artist}/albums/{genre}/{album}/`
9. Release	Album status is "Released"

跟踪以下阶段的完成情况：

阶段	完成条件
1. 概念阶段	专辑README文件已定义标题、流派和曲目列表
2. 调研阶段	RESEARCH.md和SOURCES.md文件存在（若基于素材创作）
3. 素材验证阶段	所有带素材的曲目均标记为 `sources_verified: Verified` 或 `N/A`
4. 歌词阶段	所有曲目在其歌词框中包含歌词内容
5. 发音标注阶段	歌词中已应用所有发音表条目
6. 审核阶段	歌词已审核（无关键问题遗留）
7. 生成阶段	所有曲目均标记为 `has_suno_link: true`
8. 母带处理阶段	音频文件存在于 `{audio_root}/artists/{artist}/albums/{genre}/{album}/` 路径下
9. 发布阶段	专辑状态为“Released”

Data Collection

数据收集

From MCP Server

从MCP Server获取

Call
```
get_album_progress(album_slug)
```
— returns completion stats, phase detection, track counts by status
Call
```
find_album(name)
```
— returns album metadata (genre, status, track list with per-track fields)
Call
```
list_track_files(album_slug)
```
— returns tracks with file paths for any additional checks

These three calls replace all manual state.json reads and file globbing.

调用
```
get_album_progress(album_slug)
```
— 返回完成统计数据、阶段检测结果、按状态划分的曲目数量
调用
```
find_album(name)
```
— 返回专辑元数据（流派、状态、带单轨字段的曲目列表）
调用
```
list_track_files(album_slug)
```
— 返回带文件路径的曲目，用于额外检查

这三个调用替代了所有手动读取state.json文件和文件匹配操作。

Dashboard Format

仪表盘格式

ALBUM DASHBOARD
===============

[Album Title] ([genre])
Status: [status]

PROGRESS BY PHASE
─────────────────
[============================  ] 90%  Concept
[============================  ] 90%  Research
[========================      ] 75%  Source Verification
[====================          ] 63%  Lyrics Written
[================              ] 50%  Pronunciation
[============                  ] 38%  Reviewed
[========                      ] 25%  Generated
[                              ]  0%  Mastered
[                              ]  0%  Released

OVERALL: ████████░░░░░░░░ 47% complete

TRACK STATUS BREAKDOWN
──────────────────────
| # | Track | Status | Suno | Sources |
|---|-------|--------|------|---------|
| 01 | Track One | Final | link | Verified |
| 02 | Track Two | In Progress | — | Pending |
| 03 | Track Three | Not Started | — | N/A |
...

BLOCKING ITEMS
──────────────
! Track 02: Sources pending verification — blocks generation
! Track 05: No style prompt — blocks generation
! Track 07: Pronunciation table not applied — blocks generation

SUMMARY
───────
Tracks: [X complete / Y total]
Blocking: [N items]
Next action: [recommendation]

ALBUM DASHBOARD
===============

[Album Title] ([genre])
Status: [status]

PROGRESS BY PHASE
─────────────────
[============================  ] 90%  Concept
[============================  ] 90%  Research
[========================      ] 75%  Source Verification
[====================          ] 63%  Lyrics Written
[================              ] 50%  Pronunciation
[============                  ] 38%  Reviewed
[========                      ] 25%  Generated
[                              ]  0%  Mastered
[                              ]  0%  Released

OVERALL: ████████░░░░░░░░ 47% complete

TRACK STATUS BREAKDOWN
──────────────────────
| # | Track | Status | Suno | Sources |
|---|-------|--------|------|---------|
| 01 | Track One | Final | link | Verified |
| 02 | Track Two | In Progress | — | Pending |
| 03 | Track Three | Not Started | — | N/A |
...

BLOCKING ITEMS
──────────────
! Track 02: Sources pending verification — blocks generation
! Track 05: No style prompt — blocks generation
! Track 07: Pronunciation table not applied — blocks generation

SUMMARY
───────
Tracks: [X complete / Y total]
Blocking: [N items]
Next action: [recommendation]

Phase Completion Calculation

阶段完成度计算

Concept Phase

概念阶段

100% if: Album README has title AND tracklist with actual track names (not template)
50% if: README exists but tracklist is template placeholder
0% if: No README

100%完成：专辑README文件包含标题且曲目列表为实际曲目名称（非模板占位符）
50%完成：README文件存在但曲目列表为模板占位符
0%完成：无README文件

Research Phase (source-based albums only)

调研阶段（仅基于素材的专辑）

100% if: RESEARCH.md AND SOURCES.md both exist with content
50% if: Only one exists
N/A if: Album is not source-based (no tracks have sources_verified field or all are N/A)

100%完成：RESEARCH.md和SOURCES.md均存在且包含内容
50%完成：仅其中一个文件存在
N/A：专辑非基于素材创作（无曲目包含sources_verified字段或所有字段均为N/A）

Source Verification Phase

素材验证阶段

% = (tracks with Verified or N/A) / total tracks * 100
Skip tracks where sources_verified is N/A for the denominator

完成率 = (标记为Verified或N/A的曲目数) / 总曲目数 * 100
分母中跳过sources_verified为N/A的曲目

Lyrics Phase

歌词阶段

% = (tracks with lyrics content) / total tracks * 100

完成率 = (包含歌词内容的曲目数) / 总曲目数 * 100

Generation Phase

生成阶段

% = (tracks with has_suno_link=true) / total tracks * 100

完成率 = (标记为has_suno_link=true的曲目数) / 总曲目数 * 100

Mastering Phase

母带处理阶段

Check

{audio_root}/artists/{artist}/albums/{genre}/{album}/

for WAV/FLAC files

% = (audio files found) / total tracks * 100

检查

{audio_root}/artists/{artist}/albums/{genre}/{album}/

路径下是否存在WAV/FLAC文件

完成率 = (找到的音频文件数) / 总曲目数 * 100

Release Phase

发布阶段

100% if album status is "Released", 0% otherwise

专辑状态为“Released”则完成率100%，否则0%

Remember

注意事项

Visual progress bars — Use ASCII progress bars for quick scanning
Highlight blockers — Blocking items are the most important info
Include next action — End with a clear recommendation
Be accurate — Count carefully, don't estimate
Handle missing data gracefully — If audio_root doesn't exist, mastering is 0%

可视化进度条 — 使用ASCII进度条以便快速浏览
突出显示阻塞项 — 阻塞项是最重要的信息
包含下一步操作 — 结尾给出明确建议
确保准确性 — 仔细统计，不要估算
优雅处理缺失数据 — 若audio_root不存在，母带处理阶段完成率为0%