Eagle音频文件翻译插件

简介

这个Eagle插件用于批量将音效文件名从英文翻译成中文（或其他语言），并按照自定义规范进行重命名，提升音效资源库的可用性和检索效率。支持多种翻译服务，包括智谱AI、Deepseek、OpenRouter、阿里云百炼和Google Translate等。

核心功能

• 批量读取Eagle中的音效文件
• 调用多种翻译API进行文件名翻译
• 使用CSV术语库进行专业术语匹配
• 支持UCS命名规则和自定义命名规则
• 预览和手动修正翻译结果
• 批量重命名并更新Eagle资源库
• 自动识别文件分类和子分类
• 智能提取和保留文件序号
• 支持英文标准化处理和多种命名风格

支持的翻译服务

• 智谱AI (GLM-4)
• Deepseek
• OpenRouter (支持多种AI模型)
• 阿里云百炼
• Google Translate

使用方法

1. 选择文件

• 从当前选中：使用Eagle中当前选中的文件
• 从标签：选择带有特定标签的文件
• 文件夹树选择器：直接在界面中操作的可视化文件夹选择器

文件夹树选择器

文件夹树选择器直接集成在主界面中，提供了最直观的文件夹选择方式：

• 直接操作：无需弹窗，直接在主界面中选择文件夹
• 可视化文件夹结构：以树形结构显示所有文件夹和子文件夹
• 搜索功能：支持按文件夹名称搜索
• 包含子文件夹选项：可选择是否同时获取所有子文件夹中的文件
• 文件数量显示：实时显示选中文件夹的文件数量
• 智能获取：根据选项自动获取相应范围的文件
• 自动加载：页面打开时自动加载文件夹树，无需额外操作

2. 配置翻译设置

• 选择翻译服务提供者
• 设置API密钥（如需要）
• 选择源语言和目标语言
• 选择是否使用翻译缓存和CSV术语库
• 启用英文标准化处理（生成简短的英文描述）
• 选择命名风格（驼峰命名、帕斯卡命名、蛇形命名等）

3. 配置命名规则

• 使用UCS命名规则或自定义命名规则
• 选择命名元素（分类ID、分类名称、子分类等）
• 设置分隔符
• 配置自定义命名模板

4. 执行翻译和重命名

• 点击"开始翻译"进行翻译
• 在预览界面查看和编辑翻译结果
• 确认后点击"应用文件名"执行更改

UCS命名规则

UCS（Universal Category System）命名规则是一种专为音效文件设计的命名规范，包含以下元素：

• 分类ID (CatID)：音效分类的简写代码
• 分类 (Category)：音效的主分类
• 分类中文名 (Category_zh)：分类的中文翻译
• 子分类 (SubCategory)：更详细的分类
• 子分类中文名 (SubCategory_zh)：子分类的中文翻译
• 英文描述 (FXName)：音效的英文描述（可使用AI生成简短标准化描述）
• 中文描述 (FXName_zh)：音效的中文描述（通过AI翻译生成）
• 制作者ID (CreatorID)：音效制作者的标识
• 项目ID (SourceID)：音效所属项目的标识
• 序号 (SerialNumber)：音效的序号

英文标准化和命名风格

插件支持对英文描述(FXname)进行标准化处理，生成简短、标准的英文描述，并支持多种命名风格：

英文标准化

启用英文标准化处理后，插件会使用AI将原始文件名转换为简短的英文描述（通常2-5个单词），例如：

• 原始文件名："Heavy Metal Door Closing With Latch"
• 标准化后："Metal Door Close"

这个功能在使用UCS命名规则时特别有用，可以生成更加简洁、标准的FXname。

命名风格

插件支持以下命名风格：

• 驼峰命名 (camelCase)：第一个单词首字母小写，后续单词首字母大写，例如："metalDoorClose"
• 帕斯卡命名 (PascalCase)：所有单词首字母大写，例如："MetalDoorClose"
• 蛇形命名 (snake_case)：单词全部小写，使用下划线分隔，例如："metal_door_close"
• 烧烤命名 (kebab-case)：单词全部小写，使用连字符分隔，例如："metal-door-close"
• 自定义分隔符：使用自定义的分隔符连接单词，例如："metal.door.close"

命名工具类

插件使用 NamingUtils 工具类集中处理所有与命名相关的逻辑，提供了以下核心功能：

文本规范化

• normalizeEnglishText：规范化英文文本，移除特殊符号，保留字母、数字
• normalizeChineseText：规范化中文文本，移除特殊符号，保留中文、字母、数字

命名风格处理

• applyNamingStyle：应用各种命名风格（驼峰命名、帕斯卡命名、蛇形命名等）

序号处理

• extractNumber：从文本中提取数字序号，支持多种序号模式
• combineTextAndNumber：重新组合文本和数字，保持原始格式

文件名处理

• processFileName：统一处理文件名的提取、规范化和格式化
• isChineseText：检测文本是否为中文
• getNameWithoutExtension：获取不带扩展名的文件名
• getExtension：获取文件扩展名

术语库

插件使用 UCSv8.2.1.csv 文件作为音效术语库，包含常见音效术语的翻译。您可以自行编辑这个文件，增加您常用的专业术语。

安装方法

1. 下载插件压缩包
2. 在Eagle中，点击"插件" > "安装插件"
3. 选择下载的插件压缩包
4. 重启Eagle

开发者信息

• 版本：1.1.2
• 作者：茶荼
• 许可证：MIT

AI辅助分类功能

插件支持使用AI辅助分类功能，可以自动分析音效文件名，并推断其分类和子分类。这个功能在处理大量音效文件时特别有用，可以显著提高分类的准确性和效率。

如何启用AI辅助分类

1. 在插件设置中启用“AI辅助分类”选项
2. 确保已配置有效的翻译服务（如OpenRouter、Deepseek或智谱AI）
3. 开始翻译时，系统会自动使用AI分析文件名并推断分类

AI辅助分类的优势

• 更高的分类准确性，特别是对于复杂或专业的音效名称
• 减少手动分类的工作量
• 更一致的分类结果
• 可以处理CSV术语库中没有包含的新术语

更新日志

v1.1.3 (2025-06-24)

• 新增文件夹树选择器功能，提供可视化的文件夹选择界面
• 添加"包含子文件夹中的文件"选项，支持递归获取子文件夹文件
• 实现智能文件数量显示，根据选项实时更新文件统计
• 解决Eagle API多文件夹查询限制问题，采用逐个查询策略
• 优化文件夹树的搜索和展开/折叠功能
• 改进用户体验，提供更直观的文件选择方式
• 移除重复的"从文件夹"按钮，简化界面
• 将文件夹树选择器直接集成到主界面，无需弹窗操作
• 页面加载时自动初始化文件夹树，提升使用便利性

v1.1.2 (2025-06-23)

• 创建NamingUtils工具类，集中处理所有与命名相关的逻辑
• 优化命名规则相关代码，减少重复逻辑和冗余代码
• 统一文本规范化和命名风格处理方法
• 改进文件名序号提取和处理逻辑
• 修复文件处理过程中的错误，提高稳定性
• 优化代码结构，减少代码量，提高可维护性

v1.1.1 (2025-04-22)

• 在预览表格中添加CatID列，显示音效文件的分类ID
• 添加提示词预览功能，可查看当前使用的翻译提示词和标准化提示词内容
• 创建提示词管理模块(PromptTemplates)，集中管理所有翻译提示词
• 改进设置保存功能，确保用户设置（包括选择的提供者、提示词风格、API密钥等）在会话之间保持

v1.1.0 (2025-04-21)

• 添加AI辅助分类功能，提高分类准确性
• 优化代码结构，移除特殊处理代码，提高通用性
• 修复分类ID和分类名称的映射问题
• 添加对Deepseek和智谱AI翻译接口的支持
• 改进文件名序号的处理逻辑
• 优化CSV术语库的匹配算法

v1.0.0 (2025-04-21)

• 首次发布

未来计划

• 添加更多翻译服务提供者
• 进一步优化AI辅助分类功能
• 添加批量处理进度显示
• 支持更多自定义命名规则
• 添加更多音效分类和术语
• 添加用户反馈机制改进翻译质量
• 优化代理服务器自动启动功能
• 添加批量文件重命名功能，支持移除特定词汇或符号
• 添加API密钥验证功能
• 改进UI界面，使用Magic MCP组件库