# 我叫罗米奇-MP3文件操作程序 **Repository Path**: romich/MP3_renamer_crossplatform ## Basic Information - **Project Name**: 我叫罗米奇-MP3文件操作程序 - **Description**: 多功能文件处理工具，主要用于批量处理 MP3 文件，支持自定义命名规则、自动识别存储设备并完成文件转存。适用于ZHAO-Watch-Music与stm32便携手表v3.1 - **Primary Language**: C++ - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2025-06-08 - **Last Updated**: 2026-01-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # C++ MP3 文件操作程序：多功能音频文件管理工具 ### 项目简介 **MP3 文件操作程序**是一个基于 C++ 开发的多功能音频文件管理工具，主要用于批量处理 MP3 文件。它提供了灵活的文件重命名规则和自动化的文件转存功能，适用于需要对音频文件进行规范化管理的各种场景，如音乐库整理、嵌入式设备音频文件排序（如 ZHAO-Watch-MH 与 STM32 便携手表 v3.1）等。 程序通过 Windows API 实现了文件夹选择、文件操作和设备枚举等功能，结合多线程技术提升了用户体验，并通过进度条实时反馈操作状态，让整个文件处理过程直观可控。 核心功能特点 ### 1. 双模式操作选择 * **仅重命名模式**：仅在本地完成文件重命名，支持自定义文件夹结构和命名规则，适合需要先预览处理效果的场景。 * **自动操作模式**：在完成文件重命名后，自动检测可移动存储设备（如 U 盘），并将处理后的文件转存到目标设备，实现一键式文件管理。 ### 2. 灵活的命名规则系统 * **三种预设模式**： * **MP3-stm32\_v3.1 模式**：文件夹名为 "MP3"，文件按 4 位数字编号（0000-9999） * **MP3-ZHAO\_Watch\_MH 模式**：文件夹名为 "01"，文件按 3 位数字编号（00-999） * **Video 音频 - ZHAO\_Watch\_MH 模式**：文件夹名为 "02"，文件按 3 位数字编号（001-999） * **完全自定义模式**： * 支持自定义文件夹名称 * 可设置 1-10 位的文件编号长度（如设置为 3 则编号范围为 000-999） * 自动根据文件数量验证编号范围有效性 ### 3. 完善的文件处理流程 1. **智能文件夹选择**： * 集成 PowerShell 实现图形化文件夹选择对话框 * 支持手动输入路径并自动修复可能的格式问题 * 实时检测路径有效性和 MP3 文件存在性 1. **高效文件处理**： * 批量扫描和计数 MP3 文件 * 按修改时间排序确保处理顺序 * 分块复制文件并显示实时进度 * 原子性重命名操作保证文件完整性 1. **可移动设备管理**： * 自动检测系统中的可移动磁盘 * 支持多设备选择（当存在多个可移动磁盘时） * 智能等待设备插入（自动模式下） * 完整的文件夹移动操作（复制 + 删除） ### 4. 增强的用户体验 * **动态进度反馈**： * 整体操作进度条 * 文件复制进度详情 * 重命名操作实时状态 * **智能错误处理**： * 路径非法字符检测与修复 * 设备未插入自动重试机制 * 文件操作错误详细日志 * 超时处理与用户提示 * **交互优化**： * 清晰的模式选择引导 * 操作步骤实时提示 * 中文友好的界面文本 * 可配置的控制台窗口大小 技术实现细节 ### 关键技术与 API * **Windows API 核心组件**： * `GetConsoleWindow`/`SetWindowLong`：控制台窗口定制（禁止调整大小、设置滚动条） * `GetLogicalDriveStringsA`/`GetDriveTypeA`：可移动磁盘检测 * `FindFirstFileA`/`FindNextFileA`：文件系统枚举 * `CopyFileA`/`RenameFileA`：文件操作 * `CreateEvent`/`_beginthreadex`：多线程同步处理 * **C++ 标准库特性**： * C++11 正则表达式 (``)：路径格式验证 * 智能指针与资源管理：动态内存分配与释放 * 字符串处理 (``)：路径格式化与文件名操作 * 算法库 (``)：文件排序与集合操作 * **特殊技术实现**： * PowerShell 集成：通过`system`调用实现图形化文件夹选择对话框 * 控制台优化：缓冲区大小设置实现 "无限" 滚动 * 进度条绘制：基于控制台光标定位的动态 UI ### 核心模块架构 ``` MP3文件操作程序 ├── 界面交互模块 │ ├── 模式选择器 │ ├── 文件夹选择对话框 │ ├── 进度条显示 │ └── 控制台定制 ├── 文件处理模块 │ ├── MP3文件检测 │ ├── 文件复制引擎 │ ├── 重命名处理器 │ └── 路径管理器 ├── 设备管理模块 │ ├── 可移动磁盘检测 │ ├── 设备选择器 │ └── 文件夹移动器 └── 工具支持模块 ├── 字符编码处理 ├── 错误处理 ├── 时间戳管理 └── 多线程辅助 ``` 快速使用指南 ### 操作流程概览 1. **模式选择**： * 启动程序后选择 "仅重命名" 或 "自动操作" 模式 * "自动操作" 模式会在处理完成后将文件转存到 U 盘 1. **规则配置**： * 选择预设模式（MP3、视频音频等） * 或进入自定义模式设置文件夹名和编号规则 1. **文件夹选择**： * 通过图形对话框选择包含 MP3 文件的文件夹 * 程序会自动检测路径有效性和文件数量 1. **文件处理**： * 程序会显示复制和重命名的实时进度 * 自动模式下会检测可移动设备并完成转存 1. **完成确认**： * 处理完成后显示统计信息 * 可在本地或 U 盘中查看整理后的文件 ### 典型使用场景 #### 场景 1：整理 U 盘音乐文件 1. 插入 U 盘并确保系统识别 2. 运行程序选择 "自动操作" 模式 3. 选择 "MP3-stm32\_v3.1" 预设模式 4. 选择电脑中存放音乐的文件夹 5. 程序会自动将文件重命名为 0000.mp3 格式并转存到 U 盘 #### 场景 2：为智能手表准备音频文件 1. 选择 "MP3 与 Video 音频" 模式（文件夹 01） 2. 选择包含音频文件的文件夹 3. 程序会按 000.mp3 格式重命名文件 4. 在自动模式下选择手表存储设备 5. 处理完成后可直接将手表连接电脑使用 编译与运行 ### 系统要求 * **操作系统**：Windows 7 及以上（完全兼容 Windows 10/11） * **编译器**： * Visual Studio 2015 及以上（推荐） * MinGW-w64（GCC 5.1+） * **依赖项**：无额外依赖，使用标准 C++ 和 Windows API ### 编译步骤 #### Visual Studio 编译 1. 打开 Visual Studio 2. 创建新的 "空项目" 3. 添加`main.cpp`到项目中 4. 设置项目为 "Release" 配置（可选） 5. 编译运行（F5 或 Ctrl+F5） #### MinGW 编译（命令行） 1. 打开命令提示符或 PowerShell 2. 导航到源代码目录 3. 执行编译命令： ``` g++ -std=c++11 main.cpp -o MP3FileManager.exe -mwindows ``` 1. 运行程序： ``` MP3FileManager.exe ``` ### 运行时注意事项 * **路径要求**： * 源文件夹路径应避免包含中文和特殊字符 * 自动模式下 U 盘路径会自动处理，但建议使用英文命名的设备 * **权限要求**： * 程序需要读取源文件夹和写入目标位置的权限 * 自动模式下可能需要操作可移动设备的权限 * **PowerShell 要求**： * 文件夹选择对话框依赖 PowerShell，确保系统已安装 PowerShell 3.0+ * 如遇 PowerShell 限制，可能需要调整执行策略 项目结构 ``` MP3文件操作程序/ ├── src/ # 源代码目录 │ ├── main.cpp # 主程序文件 │ ├── file\_operations.cpp # 文件操作模块 │ ├── ui\_operations.cpp # 界面交互模块 │ ├── device\_management.cpp # 设备管理模块 │ └── utils.cpp # 工具函数 ├── include/ # 头文件目录 │ ├── file\_operations.h │ ├── ui\_operations.h │ ├── device\_management.h │ └── utils.h ├── docs/ # 文档目录 │ ├── README.md # 项目说明 │ └── usage\_guide.md # 使用指南 ├── build/ # 编译输出目录 │ ├── Debug/ # 调试版本 │ └── Release/ # 发布版本 └── resources/ # 资源文件 └── icon.ico # 程序图标(可选) ``` 贡献与支持 ### 贡献方式 1. **提交 Issue**： * 发现 bug 时，请详细描述重现步骤和系统环境 * 提出新功能建议时，请说明使用场景和预期效果 1. **提交 Pull Request**： * 请先创建 Issue 讨论修改方向 * 确保代码符合项目编码规范 * 提供必要的注释和测试案例 ### 常见问题解答 #### Q: 程序运行时提示 "无法打开文件夹选择对话框" A: 这可能是由于 PowerShell 权限限制导致的。可以尝试： 1. 以管理员身份运行程序 2. 在 PowerShell 中执行`Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned`并选择 Y #### Q: 自动模式下无法检测到 U 盘 A: 请确认： 1. U 盘已正确插入并被系统识别 2. 程序有访问可移动设备的权限 3. 尝试重新插拔 U 盘或重启程序 #### Q: 重命名后的文件编号不连续 A: 这通常是由于源文件夹中存在非 MP3 文件或程序处理过程中被中断导致的。建议： 1. 确保源文件夹只包含需要处理的 MP3 文件 2. 处理过程中不要中断程序 3. 如遇中断，可重新运行程序并选择相同的设置 许可证信息 本项目采用[MIT 许可证](LICENSE)，允许自由使用、修改和分发，但需保留原作者声明和许可证文件。 ``` MIT License Copyright (c) 2023 Romich Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ``` 版本历史 * **v0.65** (2023-XX-XX) * 新增自定义模式下的编号范围自动验证 * 优化可移动设备检测逻辑，增加重试机制 * 改进错误处理和用户提示信息 * 完善 README 文档和使用指南 * **v0.60** (2023-XX-XX) * 新增三种预设模式（MP3、视频音频等） * 实现自定义模式的文件夹和编号设置 * 优化进度条显示和用户交互体验 * 增强路径处理和非法字符检测 * **v0.50** (2023-XX-XX) * 初始版本发布 * 实现基本的文件重命名功能 * 支持可移动设备自动转存 * 集成文件夹选择对话框 如果您在使用过程中遇到任何问题或有改进建议，欢迎通过项目仓库的 Issue 功能反馈，我们会尽快处理！ > 文档部分内容可能由 AI 生成 >