LunaTranslator 多配置文件实战使用 --userconfig 参数实现多实例并行与配置隔离【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator本指南讲解 LunaTranslator 的多配置文件Multiple User Config机制通过命令行参数--userconfig指定独立的配置目录让同一份软件同时以多套完全不同的设置运行无需再为每个配置复制整个软件目录。读完本文你将掌握创建快捷方式、派生新配置、多实例并行启动的完整方法并理解该机制在源码层面的实现原理。背景为什么需要多套配置文件LunaTranslator 是一款视觉小说翻译器其翻译引擎、OCR 引擎、Hook 设置、文本处理、词典、TTS 等大量功能都围绕一套全局配置运行。过去如果想用不同的配置例如日语翻译为主的一套配置和OCR 截图翻译为主的一套配置同时打开软件唯一的办法是复制整个软件目录——这不仅占用大量磁盘空间还会带来 DLL 组件重复、更新困难等问题。为此项目引入了从指定目录读取配置的能力同一份软件安装目录通过指定不同的配置目录即可在同一时间以不同的设置并行运行多个实例。官方文档 docs/en/gooduse/multiconfigs.md 给出了完整的操作步骤下文将在此基础上结合源码深入展开。核心机制--userconfig 命令行参数参数的定义与解析在程序入口 src/LunaTranslator/main.py 中create_argparser()使用标准库argparse定义了一个可选参数parser.add_argument(--userconfig, requiredFalse)随后check_userdir(args)负责将参数写入全局状态def check_userdir(args): import gobject userconfig args.userconfig gobject.thisuserconfig userconfig if userconfig else gobject.thisuserconfig sys.path.insert(1, gobject.thisuserconfig)这里有两个关键点默认值兜底gobject.thisuserconfig的默认值是字符串userconfig见 src/LunaTranslator/gobject.py。只有显式传入--userconfigXXXX时配置目录才会被切换为XXXX否则一切行为与旧版本完全一致向后兼容。配置目录被插入sys.path这意味着该目录不仅存放 JSON 配置文件还被当作可导入的 Python 模块搜索路径为后续可能的用户脚本扩展预留了能力。配置目录如何参与配置读写LunaTranslator 的所有运行时配置都通过 src/LunaTranslator/gobject.py 中的getconfig()定位def getconfig(name): return __getdir(name, thisuserconfig)即所有配置文件的根目录就是thisuserconfig指向的目录。在 src/LunaTranslator/myutils/config.py 中配置的读取统一走这条路径def tryreadconfig(path, defaultNone): path gobject.getconfig(path) try: with open(path, r, encodingutf-8) as ff: return json.load(ff) except: return default if default else {}从源码可见下列运行时配置都以 JSON 形式存放在配置目录下见 src/LunaTranslator/myutils/config.py配置文件存放内容config.json全局主配置globalconfig含翻译、界面、文本处理等核心设置translatorsetting.json翻译引擎相关设置ocrsetting.jsonOCR 引擎相关设置postprocessconfig.json文本后处理过滤、替换规则配置transerrorfixdictconfig.json翻译错误修正词典配置ocrerrorfix.jsonOCR 错误修正配置Magpie/config.jsonMagpie 缩放工具相关配置savegamedata_*.json存档 / 游戏识别数据ui_settings.json界面布局等设置PyQtDarkTheme.json深色主题外观配置见 src/files/LunaTranslator_qss/PyQtDarkTheme/setting.py这些文件在首次启动时从内置默认配置LunaTranslator/defaultconfig目录下的config.json、translatorsetting.json、ocrsetting.json、postprocessconfig.json等见 src/LunaTranslator/myutils/config.py生成。也就是说每个配置目录都是一套完整的、独立持久化的配置快照翻译引擎选择、OCR 参数、Hook 过滤规则、快捷键等在各个配置之间互不影响。操作步骤创建指定配置的快捷方式第 1 步创建主程序快捷方式找到 LunaTranslator 的主程序可执行文件Windows 下即 LunaTranslator 的.exe右键选择发送到 → 桌面快捷方式生成一个用于启动软件的快捷方式。第 2 步在快捷方式 Target 末尾追加 --userconfig 参数右键该快捷方式选择属性Properties在目标Target输入框的末尾追加参数--userconfigXXXX其中XXXX是你希望使用的配置文件夹名称。一个完整示例C:\LunaTranslator\LunaTranslator.exe --userconfigconfig_jp保存后使用这个快捷方式启动软件LunaTranslator 就会以config_jp作为配置目录运行。第 3 步两种启动情形的行为差异根据XXXX目录是否存在软件行为有所不同源码层面的依据见上文tryreadconfig对缺失文件返回默认值的处理逻辑XXXX是不存在的文件夹软件以出厂默认设置启动并在运行过程中自动创建该文件夹把默认配置写入其中。这相当于从零开始建立一套全新的配置适合为某个新场景如新的游戏、新的翻译引擎组合单独初始化。XXXX是已存在的文件夹软件直接加载该文件夹中的全部配置并运行。这正是多配置并行使用的核心场景——你可以为每个游戏或每种翻译需求预先准备一套配置启动时各取所需。进阶技巧从现有配置派生新配置官方文档推荐的一个非常实用的做法是复制旧的 userconfig 文件夹来派生新配置打开软件根目录下的默认配置文件夹userconfig将其整个复制一份并重命名为新名字例如userconfig_backup或config_en创建快捷方式在 Target 末尾指定--userconfig新文件夹名并启动。这样新配置会完整继承原配置的翻译引擎、OCR 引擎、词典、Hook 设置等所有内容你只需要在其中做增量修改即可。相比从头配置一套新环境这种方式能大幅节省时间也便于做A/B 配置对比——例如同一款游戏分别用userconfig原有配置与config_tuned调优后的派生配置启动两个实例对照翻译效果。提示由于--userconfig使用的是相对路径XXXX将相对于软件启动时的工作目录解析。建议将快捷方式的起始位置Start in保持为软件安装目录或直接使用绝对路径如--userconfigD:\LunaConfigs\cn以避免路径解析歧义。多实例互不干扰基于配置目录的进程互斥同一套软件以不同配置同时启动多个实例时最怕的就是进程之间相互干扰例如单例锁导致第二个实例启动失败。LunaTranslator 在 src/LunaTranslator/main.py 的checkrunning()中专门处理了这一点# 将 userconfig 作为 mutex 名的一部分使得不同 userconfig 文件夹之间互不干扰 _name LUNA_IS_RUNNING_MUTEX_{}.format( hashlib.md5(os.path.abspath(gobject.thisuserconfig).encode(utf-8)).hexdigest() ) gobject.isRunningMutex NativeUtils.SimpleCreateMutex(_name)进程互斥锁Mutex的名字由userconfig目录的绝对路径 MD5 哈希生成因此不同的配置目录会生成不同的互斥锁名对应实例可以同时运行、互不干扰相同的配置目录共享同一个互斥锁当检测到已有同类实例在运行时软件会弹出提示询问检测到软件已在运行是否再次启动避免同一配置被两个实例同时读写造成配置损坏。这是一个非常巧妙的隔离设计配置的隔离边界目录同时也是进程的隔离边界。快速识别当前配置窗口标题标记当你同时运行多套配置时很容易混淆当前窗口到底用的是哪套配置。为此LunaTranslator 在窗口标题中加入了配置标识。见 src/LunaTranslator/gui/usefulwidget.pydef setWindowTitleWithVersionWithUserconfig(self, t): t self.__gettitlewithversion(t) if gobject.thisuserconfig ! userconfig: t {}[[{}]].format(_-_, gobject.thisuserconfig) return super().setWindowTitle(t)当使用非默认配置目录启动时窗口标题会自动附加_-_配置目录名后缀例如LunaTranslator vX.Y.Z_-_config_jp。也就是说使用默认userconfig启动 → 标题不带后缀使用--userconfigconfig_jp启动 → 标题带_-_config_jp后缀。这样即使多个窗口叠放在一起也能一眼分辨出各自所用的配置避免误操作。适用场景与注意事项典型适用场景为不同游戏分别维护一套 Hook 与翻译配置同时使用在线翻译为主与离线 OCR 为主两套方案并行对照测试新翻译引擎或新版本设置时与稳定配置并行运行、随时回退与其他人共用同一份软件安装目录各自使用独立的个人配置。注意事项--userconfig指定的目录会参与 DLL 校验前的初始化流程见 src/LunaTranslator/main.py且不同配置目录各自独立维护请勿删除仍在使用的配置文件夹默认配置目录名固定为userconfig重命名或删除该目录等同于重置所有设置为出厂默认多实例同时运行时若两个实例共享同一套 OCR / 翻译引擎尤其涉及本地模型或临时文件时仍需注意资源占用问题——配置隔离解决的是设置与进程互斥问题不改变系统硬件资源总量本功能是 Windows 桌面软件层面的命令行参数机制不依赖任何网络服务纯本地生效。进一步阅读完整的软件入门与基础使用见 docs/en/basicuse.md文本处理与后处理配置见 docs/en/textprocess.mdOCR 参数详解见 docs/en/ocrparam.md各功能指南目录见 docs/en/README.md【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
LunaTranslator 多配置文件实战使用 --userconfig 参数实现多实例并行与配置隔离【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator本指南讲解 LunaTranslator 的多配置文件Multiple User Config机制通过命令行参数--userconfig指定独立的配置目录让同一份软件同时以多套完全不同的设置运行无需再为每个配置复制整个软件目录。读完本文你将掌握创建快捷方式、派生新配置、多实例并行启动的完整方法并理解该机制在源码层面的实现原理。背景为什么需要多套配置文件LunaTranslator 是一款视觉小说翻译器其翻译引擎、OCR 引擎、Hook 设置、文本处理、词典、TTS 等大量功能都围绕一套全局配置运行。过去如果想用不同的配置例如日语翻译为主的一套配置和OCR 截图翻译为主的一套配置同时打开软件唯一的办法是复制整个软件目录——这不仅占用大量磁盘空间还会带来 DLL 组件重复、更新困难等问题。为此项目引入了从指定目录读取配置的能力同一份软件安装目录通过指定不同的配置目录即可在同一时间以不同的设置并行运行多个实例。官方文档 docs/en/gooduse/multiconfigs.md 给出了完整的操作步骤下文将在此基础上结合源码深入展开。核心机制--userconfig 命令行参数参数的定义与解析在程序入口 src/LunaTranslator/main.py 中create_argparser()使用标准库argparse定义了一个可选参数parser.add_argument(--userconfig, requiredFalse)随后check_userdir(args)负责将参数写入全局状态def check_userdir(args): import gobject userconfig args.userconfig gobject.thisuserconfig userconfig if userconfig else gobject.thisuserconfig sys.path.insert(1, gobject.thisuserconfig)这里有两个关键点默认值兜底gobject.thisuserconfig的默认值是字符串userconfig见 src/LunaTranslator/gobject.py。只有显式传入--userconfigXXXX时配置目录才会被切换为XXXX否则一切行为与旧版本完全一致向后兼容。配置目录被插入sys.path这意味着该目录不仅存放 JSON 配置文件还被当作可导入的 Python 模块搜索路径为后续可能的用户脚本扩展预留了能力。配置目录如何参与配置读写LunaTranslator 的所有运行时配置都通过 src/LunaTranslator/gobject.py 中的getconfig()定位def getconfig(name): return __getdir(name, thisuserconfig)即所有配置文件的根目录就是thisuserconfig指向的目录。在 src/LunaTranslator/myutils/config.py 中配置的读取统一走这条路径def tryreadconfig(path, defaultNone): path gobject.getconfig(path) try: with open(path, r, encodingutf-8) as ff: return json.load(ff) except: return default if default else {}从源码可见下列运行时配置都以 JSON 形式存放在配置目录下见 src/LunaTranslator/myutils/config.py配置文件存放内容config.json全局主配置globalconfig含翻译、界面、文本处理等核心设置translatorsetting.json翻译引擎相关设置ocrsetting.jsonOCR 引擎相关设置postprocessconfig.json文本后处理过滤、替换规则配置transerrorfixdictconfig.json翻译错误修正词典配置ocrerrorfix.jsonOCR 错误修正配置Magpie/config.jsonMagpie 缩放工具相关配置savegamedata_*.json存档 / 游戏识别数据ui_settings.json界面布局等设置PyQtDarkTheme.json深色主题外观配置见 src/files/LunaTranslator_qss/PyQtDarkTheme/setting.py这些文件在首次启动时从内置默认配置LunaTranslator/defaultconfig目录下的config.json、translatorsetting.json、ocrsetting.json、postprocessconfig.json等见 src/LunaTranslator/myutils/config.py生成。也就是说每个配置目录都是一套完整的、独立持久化的配置快照翻译引擎选择、OCR 参数、Hook 过滤规则、快捷键等在各个配置之间互不影响。操作步骤创建指定配置的快捷方式第 1 步创建主程序快捷方式找到 LunaTranslator 的主程序可执行文件Windows 下即 LunaTranslator 的.exe右键选择发送到 → 桌面快捷方式生成一个用于启动软件的快捷方式。第 2 步在快捷方式 Target 末尾追加 --userconfig 参数右键该快捷方式选择属性Properties在目标Target输入框的末尾追加参数--userconfigXXXX其中XXXX是你希望使用的配置文件夹名称。一个完整示例C:\LunaTranslator\LunaTranslator.exe --userconfigconfig_jp保存后使用这个快捷方式启动软件LunaTranslator 就会以config_jp作为配置目录运行。第 3 步两种启动情形的行为差异根据XXXX目录是否存在软件行为有所不同源码层面的依据见上文tryreadconfig对缺失文件返回默认值的处理逻辑XXXX是不存在的文件夹软件以出厂默认设置启动并在运行过程中自动创建该文件夹把默认配置写入其中。这相当于从零开始建立一套全新的配置适合为某个新场景如新的游戏、新的翻译引擎组合单独初始化。XXXX是已存在的文件夹软件直接加载该文件夹中的全部配置并运行。这正是多配置并行使用的核心场景——你可以为每个游戏或每种翻译需求预先准备一套配置启动时各取所需。进阶技巧从现有配置派生新配置官方文档推荐的一个非常实用的做法是复制旧的 userconfig 文件夹来派生新配置打开软件根目录下的默认配置文件夹userconfig将其整个复制一份并重命名为新名字例如userconfig_backup或config_en创建快捷方式在 Target 末尾指定--userconfig新文件夹名并启动。这样新配置会完整继承原配置的翻译引擎、OCR 引擎、词典、Hook 设置等所有内容你只需要在其中做增量修改即可。相比从头配置一套新环境这种方式能大幅节省时间也便于做A/B 配置对比——例如同一款游戏分别用userconfig原有配置与config_tuned调优后的派生配置启动两个实例对照翻译效果。提示由于--userconfig使用的是相对路径XXXX将相对于软件启动时的工作目录解析。建议将快捷方式的起始位置Start in保持为软件安装目录或直接使用绝对路径如--userconfigD:\LunaConfigs\cn以避免路径解析歧义。多实例互不干扰基于配置目录的进程互斥同一套软件以不同配置同时启动多个实例时最怕的就是进程之间相互干扰例如单例锁导致第二个实例启动失败。LunaTranslator 在 src/LunaTranslator/main.py 的checkrunning()中专门处理了这一点# 将 userconfig 作为 mutex 名的一部分使得不同 userconfig 文件夹之间互不干扰 _name LUNA_IS_RUNNING_MUTEX_{}.format( hashlib.md5(os.path.abspath(gobject.thisuserconfig).encode(utf-8)).hexdigest() ) gobject.isRunningMutex NativeUtils.SimpleCreateMutex(_name)进程互斥锁Mutex的名字由userconfig目录的绝对路径 MD5 哈希生成因此不同的配置目录会生成不同的互斥锁名对应实例可以同时运行、互不干扰相同的配置目录共享同一个互斥锁当检测到已有同类实例在运行时软件会弹出提示询问检测到软件已在运行是否再次启动避免同一配置被两个实例同时读写造成配置损坏。这是一个非常巧妙的隔离设计配置的隔离边界目录同时也是进程的隔离边界。快速识别当前配置窗口标题标记当你同时运行多套配置时很容易混淆当前窗口到底用的是哪套配置。为此LunaTranslator 在窗口标题中加入了配置标识。见 src/LunaTranslator/gui/usefulwidget.pydef setWindowTitleWithVersionWithUserconfig(self, t): t self.__gettitlewithversion(t) if gobject.thisuserconfig ! userconfig: t {}[[{}]].format(_-_, gobject.thisuserconfig) return super().setWindowTitle(t)当使用非默认配置目录启动时窗口标题会自动附加_-_配置目录名后缀例如LunaTranslator vX.Y.Z_-_config_jp。也就是说使用默认userconfig启动 → 标题不带后缀使用--userconfigconfig_jp启动 → 标题带_-_config_jp后缀。这样即使多个窗口叠放在一起也能一眼分辨出各自所用的配置避免误操作。适用场景与注意事项典型适用场景为不同游戏分别维护一套 Hook 与翻译配置同时使用在线翻译为主与离线 OCR 为主两套方案并行对照测试新翻译引擎或新版本设置时与稳定配置并行运行、随时回退与其他人共用同一份软件安装目录各自使用独立的个人配置。注意事项--userconfig指定的目录会参与 DLL 校验前的初始化流程见 src/LunaTranslator/main.py且不同配置目录各自独立维护请勿删除仍在使用的配置文件夹默认配置目录名固定为userconfig重命名或删除该目录等同于重置所有设置为出厂默认多实例同时运行时若两个实例共享同一套 OCR / 翻译引擎尤其涉及本地模型或临时文件时仍需注意资源占用问题——配置隔离解决的是设置与进程互斥问题不改变系统硬件资源总量本功能是 Windows 桌面软件层面的命令行参数机制不依赖任何网络服务纯本地生效。进一步阅读完整的软件入门与基础使用见 docs/en/basicuse.md文本处理与后处理配置见 docs/en/textprocess.mdOCR 参数详解见 docs/en/ocrparam.md各功能指南目录见 docs/en/README.md【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
