Music Tagger

音乐文件批量标签工具，支持读取/编辑音乐元数据（歌名、艺术家、专辑、流派等），批量编辑标签，按标签整理音乐文件，预览模式和撤销功能！

Security Scan

The skill appears to do what it says: a local music-tagging/organizing tool with no unrelated credential requests, network calls, or elevated privileges; it's a simplified/demo implementation that operates on local files.

Purpose & Capability

Name/description match the code and documentation. The code implements reading/previewing/organizing/undo for music files. The README/SKILL.md mention mutagen for full tag write support; current code uses simulated read/write, which is coherent for a demo.

Instruction Scope

SKILL.md only instructs running local CLI commands and describes file operations (read/edit/organize/undo). It does not instruct reading unrelated system files, contacting external endpoints, or accessing environment variables.

Install Mechanism

No install spec provided (instruction-only skill) and included code is self-contained. The only third-party dependency mentioned is pip-installable 'mutagen', which is appropriate for the stated purpose and not suspicious. No downloads from arbitrary URLs or archive extraction are used.

Credentials

The skill declares no environment variables, credentials, or config paths. The code operates on user-specified directories only, so requested access is proportionate to the purpose.

Persistence & Privilege

always is false and the skill does not request persistent/system-wide privileges. It writes a local backup file (.music-tagger-backup.json) inside the output directory, which is expected for undo functionality.

Assessment

This skill appears internally consistent and implements local file operations only. Before installing/running: 1) prefer running the provided Python script in a sandbox or test folder; 2) back up your music files (the tool itself also writes a local .music-tagger-backup.json); 3) note that current read/write are simulated — installing 'mutagen' is required for actual tag edits, so review that dependency if you plan to enable real editing; 4) verify the install source/repo (SKILL.md references 'clawhub install' and a repo clone but no concrete URL was provided); and 5) inspect the code yourself if you have concerns about running code from an unknown author.

Music Tagger - 音乐文件批量标签工具

功能特性

• ✅ 自动识别音乐文件格式（mp3, flac, wav, aac, m4a, ogg, wma, ape 等）
• ✅ 读取/编辑音乐元数据（歌名、艺术家、专辑、流派、年份、曲目号等）
• ✅ 批量编辑标签
• ✅ 按标签整理音乐文件（艺术家/专辑、流派、年份等）
• ✅ 预览模式（先看效果再执行）
• ✅ 撤销操作（安全可靠）

安装

# 方法一：通过 clawhub 安装
clawhub install music-tagger

# 方法二：作为 Python 脚本运行
git clone <repo-url>
cd music-tagger
pip install mutagen

依赖说明

当前版本是简化版，主要演示框架。要启用实际标签编辑功能，请安装：

• mutagen：处理音乐元数据

快速开始

1. 读取音乐文件标签

music-tagger read song.mp3

2. 编辑音乐文件标签

music-tagger edit song.mp3 --title "My Song" --artist "My Artist" --album "My Album"

3. 批量设置标签

music-tagger batch ./music --artist "My Artist"

4. 按艺术家/专辑整理音乐

music-tagger organize ./music --by artist-album --output ./organized

5. 预览模式

music-tagger organize ./music --by artist-album --preview

6. 撤销操作

music-tagger undo ./organized

详细使用说明

read 命令参数

• file：（必需）要读取标签的音乐文件

edit 命令参数

• file：（必需）要编辑标签的音乐文件
• --title：歌名
• --artist：艺术家
• --album：专辑
• --genre：流派
• --year：年份
• --track：曲目号

batch 命令参数

• directory：（必需）要批量编辑的音乐目录
• --title：批量设置歌名
• --artist：批量设置艺术家
• --album：批量设置专辑
• --genre：批量设置流派
• --year：批量设置年份

organize 命令参数

• directory：（必需）要整理的音乐目录
• --by：整理方式，可选 artist-album（按艺术家/专辑，默认）、genre（按流派）、year（按年份）
• --output：输出目录，默认在输入目录下创建 organized 文件夹
• --preview：预览模式，只显示方案不实际执行

支持的音乐格式

格式	说明
mp3	MP3 音频
flac	FLAC 无损音频
wav	WAV 音频
aac, m4a	AAC 音频
ogg	OGG 音频
wma	Windows Media 音频
ape	APE 无损音频

示例场景

场景 1：批量设置艺术家

# 将整个文件夹的音乐艺术家设置为 "My Artist"
music-tagger batch ./music --artist "My Artist"

场景 2：按艺术家/专辑整理音乐

# 按艺术家/专辑整理音乐文件夹
music-tagger organize ./music --by artist-album --output ./Music/Organized

场景 3：先预览，再执行

# 第一步：预览
music-tagger organize ./music --by artist-album --preview

# 第二步：确认没问题后执行
music-tagger organize ./music --by artist-album --output ./organized

注意事项

• 确保已安装所需的依赖库
• 编辑标签前建议先备份原文件
• 建议先用 --preview 预览效果
• 整理前建议先备份原文件

更新日志

v1.0.0 (2026-03-06)

• 初始版本发布
• 支持读取/编辑基本音乐标签
• 支持批量编辑标签
• 支持按标签整理音乐
• 支持预览模式
• 支持撤销操作