R3EXS 1.1.1 → 2.0.0

data/lib/R3EXS/extract_strings.rb

@@ -3,74 +3,98 @@
 require 'zlib'
 require_relative 'ast'
 require_relative 'utils'
+require_relative 'logger'
 
 module R3EXS
+  # 提取 R3EXS 格式的 CommonEvent 文件中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  #
+  # @return [Array<String>]
+  def self.ex_commonevents(target_dir)
+    ex_strings = []
+    Utils.all_commonevent_json_files(target_dir, :R3EXS) do |commonevents, commonevents_paths, _|
+      commonevents.zip(commonevents_paths).each do |commonevent, commonevents_path|
+        ex_strings.concat(commonevent.ex_strings)
+        Logger.debug("Extract     #{commonevents_path}")
+      end
+    end
+    ex_strings
+  end
 
-    # 将指定目录下的所有已经序列化为 R3EXS 后的 JOSN 文件中的字符串提取出来
-    #
-    # @param target_dir [Pathname] 目标目录
-    # @param output_dir [Pathname] 输出目录
-    # @param with_scripts [Boolean] 是否包含脚本
-    # @param with_symbol [Boolean] 是否包含脚本中的符号
-    # @param with_scripts_separate [Boolean] 是否将脚本提取的字符串单独存放
-    #
-    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
-    # @raise [JsonDirError] target_dir 不存在
-    #
-    # @return [void]
-    def R3EXS.ex_strings(target_dir, output_dir, with_scripts, with_symbol, with_scripts_separate)
-        all_ex_strings = []
-
-        # 处理常规的 JSON 文件
-        Utils.all_json_files(target_dir, :R3EXS) do |object, file_basename, parent_relative_dir|
-            file_path = target_dir.join(parent_relative_dir, "#{file_basename}.json")
-            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Extracting from #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
-            if object.is_a?(Array)
-                object.each do |obj|
-                    all_ex_strings.concat(obj.ex_strings)
-                end
-            else
-                all_ex_strings.concat(object.ex_strings)
-            end
-            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Extracted #{Utils::RESET_COLOR}#{file_path}\n" if $global_options[:verbose]
-        end
-
-        # 处理 CommonEvent_\d{5}.json 文件
-        Utils.all_commonevent_json_files(target_dir, :R3EXS) do |commonevents, commonevents_basenames, parent_relative_dir|
-            commonevents.zip(commonevents_basenames).each do |commonevent, commonevent_basename|
-                file_path = target_dir.join(parent_relative_dir, "#{commonevent_basename}.json")
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Extracting from #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
-                all_ex_strings.concat(commonevent.ex_strings)
-                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Extracted #{Utils::RESET_COLOR}#{file_path}\n" if $global_options[:verbose]
-            end
-        end
+  # 提取 Ruby 源码中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param with_symbol [Boolean] 是否包含脚本中的符号
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  #
+  # @return [Array<String>]
+  def self.ex_scripts(target_dir, with_symbol)
+    ex_strings = []
+    Utils.all_rb_files(target_dir) do |scripts, _, scripts_paths, _, _|
+      scripts.zip(scripts_paths).each do |script, scripts_path|
+        ex_strings.concat(StringsExtractor.extract(script, with_symbol))
+        Logger.debug("Extract     #{scripts_path}")
+      end
+    end
+    ex_strings
+  end
 
-        # 处理 \d{5}.rb 文件
-        if with_scripts
-            all_rb_strings    = []
-            strings_extractor = StringsExtractor.new(all_rb_strings, with_symbol)
+  # 提取 R3EXS 格式的 常规 JSON 文件中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  #
+  # @return [Array<String>]
+  def self.ex_regular(target_dir)
+    ex_strings = []
+    Utils.all_regular_json_files(target_dir, :R3EXS) do |obj, file_path|
+      ex_strings.concat(Utils.ex_r3exs(obj))
+      Logger.debug("Extract     #{file_path}")
+    end
+    ex_strings
+  end
 
-            Utils.all_rb_files(target_dir) do |scripts, scripts_basenames, parent_relative_dir|
-                scripts.zip(scripts_basenames).each do |script, script_basename|
-                    file_path = target_dir.join(parent_relative_dir, "#{script_basename}.rb")
-                    print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Extracting from #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
-                    strings_extractor.visit(Prism.parse(script).value)
-                    print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Extracted #{Utils::RESET_COLOR}#{file_path}\n" if $global_options[:verbose]
-                end
-            end
+  # 提取指定目录下 R3EXS 格式的 JOSN 文件中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  # @param with_scripts [Boolean] 是否包含脚本
+  # @param with_symbol [Boolean] 是否包含脚本中的符号
+  # @param with_scripts_separate [Boolean] 是否将脚本提取的字符串单独存放
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  #
+  # @return [void]
+  def self.ex_strings(target_dir, output_dir, with_scripts, with_symbol, with_scripts_separate)
+    all_ex_strings = []
 
-            if with_scripts_separate
-                # 去除 nil 元素
-                all_rb_strings.compact!
-                Utils.object_json(all_rb_strings.each_with_object({}) { |item, h| h[item] = item }, output_dir.join('ManualTransFile_scripts.json'))
-            else
-                all_ex_strings.concat(all_rb_strings)
-            end
-        end
+    # 处理 CommonEvent_\d{5}.json 文件
+    all_ex_strings.concat(ex_commonevents(target_dir))
 
-        # 去除 nil 元素
-        all_ex_strings.compact!
-        Utils.object_json(all_ex_strings.each_with_object({}) { |item, h| h[item] = item }, output_dir.join('ManualTransFile.json'))
+    # 处理 Script_\d{3}.rb 文件
+    if with_scripts
+      rb_strings = ex_scripts(target_dir, with_symbol)
+      # 单独输出脚本提取的字符串
+      if with_scripts_separate
+        Utils.object_json(rb_strings.to_h { |str| [str, str] }, output_dir.join('ManualTransFile_scripts.json'))
+      else
+        all_ex_strings.concat(rb_strings)
+      end
     end
 
-end
+    # 处理常规 JSON 文件
+    all_ex_strings.concat(ex_regular(target_dir))
+
+    # 去除 nil 元素
+    all_ex_strings.compact!
+    Utils.object_json(all_ex_strings.to_h { |str| [str, str] }, output_dir.join('ManualTransFile.json'))
+  end
+end

data/lib/R3EXS/inject_strings.rb

@@ -3,71 +3,94 @@
 require 'zlib'
 require_relative 'ast'
 require_relative 'utils'
+require_relative 'logger'
 
 module R3EXS
+  # 注入 R3EXS 格式的 CommonEvent 文件中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  # @param manual_trans_hash[Hash{String => String}] 翻译结果
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  #
+  # @return [void]
+  def self.in_commonevents(target_dir, output_dir, manual_trans_hash)
+    Utils.all_commonevent_json_files(target_dir, :R3EXS) do |commonevents, commonevents_paths, _|
+      commonevents.zip(commonevents_paths).each do |commonevent, commonevents_path|
+        file_path = output_dir.join(commonevents_path.relative_path_from(target_dir))
+        commonevent.in_strings(manual_trans_hash)
+        Utils.object_json(commonevent, file_path)
+        Logger.debug("Inject      #{file_path}")
+      end
+    end
+  end
 
-    # 将指定目录下的所有已经序列化为 R3EXS 后的 JOSN 文件按照 ManualTransFile.json 翻译注入
-    #
-    # @param target_dir [Pathname] 目标目录
-    # @param output_dir [Pathname] 输出目录
-    # @param manualtransfile_path [Pathname] ManualTransFile.json 文件路径
-    # @param with_scripts [Boolean] 是否包含脚本
-    #
-    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
-    # @raise [JsonDirError] target_dir 不存在
-    # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
-    # @raise [ManualTransFilePath] ManualTransFile.json 不存在
-    #
-    # @return [void]
-    def R3EXS.in_strings(target_dir, output_dir, manualtransfile_path, with_scripts)
-        manualtransfile_path.exist? or raise ManualTransFilePathError.new(manualtransfile_path.to_s), "ManualTransFile.json not found: #{manualtransfile_path}"
-
-        manual_trans_hash = Oj.load_file(manualtransfile_path.to_s)
-
-        # 处理常规的 JSON 文件
-        Utils.all_json_files(target_dir, :R3EXS) do |object, file_basename, parent_relative_dir|
-            file_path = output_dir.join(parent_relative_dir, "#{file_basename}.json")
-            print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Injecting to #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
-            if object.is_a?(Array)
-                object.each do |obj|
-                    obj.in_strings(manual_trans_hash)
-                end
-            else
-                object.in_strings(manual_trans_hash)
-            end
-            Utils.object_json(object, file_path)
-            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Injected #{Utils::RESET_COLOR}#{file_path}\n" if $global_options[:verbose]
-        end
+  # 注入 Ruby 源码中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  # @param manual_trans_hash[Hash{String => String}] 翻译结果
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [ScriptsInfoPathError] Scripts_info.json 不存在
+  #
+  # @return [void]
+  def self.in_scripts(target_dir, output_dir, manual_trans_hash)
+    Utils.all_rb_files(target_dir) do |scripts, script_info, scripts_paths, script_info_path, _|
+      scripts.zip(scripts_paths).each do |script, scripts_path|
+        file_path = output_dir.join(scripts_path.relative_path_from(target_dir))
+        Utils.script_rb(StringsInjector.inject(script, manual_trans_hash), file_path)
+        Logger.debug("Inject      #{file_path}")
+      end
+      Utils.object_json(script_info, output_dir.join(script_info_path.relative_path_from(target_dir)))
+    end
+  end
 
-        # 处理 CommonEvent_\d{5}.json 文件
-        Utils.all_commonevent_json_files(target_dir, :R3EXS) do |commonevents, commonevents_basenames, parent_relative_dir|
-            commonevents.zip(commonevents_basenames).each do |commonevent, commonevent_basename|
-                file_path = output_dir.join(parent_relative_dir, "#{commonevent_basename}.json")
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Injecting to #{Utils::RESET_COLOR}#{file_path}...\r" if $global_options[:verbose]
-                commonevent.in_strings(manual_trans_hash)
-                Utils.object_json(commonevent, file_path)
-                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Injected #{Utils::RESET_COLOR}#{file_path}\n" if $global_options[:verbose]
-            end
-        end
+  # 注入 R3EXS 格式的 常规 JSON 文件中的字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  # @param manual_trans_hash[Hash{String => String}] 翻译结果
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  #
+  # @return [void]
+  def self.in_regular(target_dir, output_dir, manual_trans_hash)
+    Utils.all_regular_json_files(target_dir, :R3EXS) do |obj, json_path|
+      file_path = output_dir.join(json_path.relative_path_from(target_dir))
+      Utils.in_r3exs(obj, manual_trans_hash)
+      Utils.object_json(obj, file_path)
+      Logger.debug("Inject      #{file_path}")
+    end
+  end
 
-        # 处理 \d{5}.rb 文件
-        if with_scripts
-            Utils.all_rb_files(target_dir) do |scripts, scripts_basenames, parent_relative_dir|
-                full_output_dir = output_dir.join(parent_relative_dir)
-                full_output_dir.mkdir unless full_output_dir.exist?
+  # 将指定目录下 R3EXS 格式的 JOSN 文件按照 ManualTransFile.json 翻译注入字符串
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  # @param manualtransfile_path [Pathname] ManualTransFile.json 文件路径
+  # @param with_scripts [Boolean] 是否包含脚本
+  #
+  # @raise [ManualTransFilePath] ManualTransFile.json 不存在
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
+  #
+  # @return [void]
+  def self.in_strings(target_dir, output_dir, manualtransfile_path, with_scripts)
+    manualtransfile_path.exist? or raise ManualTransFilePathError, "ManualTransFile.json not found: #{manualtransfile_path}"
+    manual_trans_hash = Oj.load_file(manualtransfile_path.to_s)
 
-                script_info_file_path = target_dir.join(parent_relative_dir, 'Scripts_info.json')
-                script_info_file_path.exist? or raise ScriptsInfoPathError.new(script_info_file_path.to_s), "Scripts_info.json not found: #{script_info_file_path}"
-                # 记得把 Scripts_info.json  也复制过去
-                FileUtils.cp(script_info_file_path, full_output_dir)
+    # 处理 CommonEvent_\d{5}.json 文件
+    in_commonevents(target_dir, output_dir, manual_trans_hash)
 
-                scripts.zip(scripts_basenames).each do |script, script_basename|
-                    output_file_path = full_output_dir.join("#{script_basename}.rb")
-                    output_file_path.binwrite(StringsInjector.new(manual_trans_hash).rewrite(script, Prism.parse(script).value))
-                    print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Injected #{Utils::RESET_COLOR}#{output_file_path}\n" if $global_options[:verbose]
-                end
-            end
-        end
-    end
+    # 处理 Script_\d{3}.rb 文件
+    in_scripts(target_dir, output_dir, manual_trans_hash) if with_scripts
 
-end
+    # 处理常规的 JSON 文件
+    in_regular(target_dir, output_dir, manual_trans_hash)
+  end
+end

data/lib/R3EXS/json_rvdata2.rb

@@ -2,114 +2,128 @@
 
 require 'zlib'
 require_relative 'utils'
+require_relative 'logger'
 
 module R3EXS
-
-    # 将指定目录下的所有JSON文件转换为 rvdata2 文件
-    #
-    # @param [Pathname] target_dir 目标目录
-    # @param [Pathname] output_dir 输出目录
-    # @param [Pathname] original_dir 原始 rvdata2 文件目录
-    # @param [Boolean] complete 是否完全转换
-    # @param [Boolean] with_scripts 是否转换Scripts
-    #
-    # @raise [RPGJsonFileError] json 文件不是 RPG 模块中的对象
-    # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
-    # @raise [Rvdata2FileError] 原始 rvdata2 文件可能损坏
-    # @raise [JsonDirError] target_dir 不存在
-    # @raise [Rvdata2DirError] original_dir 不存在
-    # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
-    #
-    # @return [void]
-    def R3EXS.json_rvdata2(target_dir, output_dir, original_dir, complete, with_scripts)
-        # 处理常规的 JSON 文件
-        Utils.all_json_files(target_dir, (complete) ? :RPG : :R3EXS) do |object, file_basename, parent_relative_dir|
-            output_file_path = output_dir.join(parent_relative_dir, "#{file_basename}.rvdata2")
-            if complete
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{output_file_path}...\r" if $global_options[:verbose]
-                Utils.object_rvdata2(object, output_file_path)
-            else
-                # 检查 original_dir 是否存在
-                original_dir.exist? or raise Rvdata2DirError.new(original_dir.to_s), "Original rvdata2 directory not found: #{original_dir}"
-                original_file_path = original_dir.join(parent_relative_dir, "#{file_basename}.rvdata2")
-                print "#{Utils::ESCAPE}#{Utils::BLUE_COLOR}Reading and Deserializing #{Utils::RESET_COLOR}#{original_file_path}...\r" if $global_options[:verbose]
-                original_object = Marshal.load(original_file_path.binread)
-
-                # 这里的类型检查要用紧凑模式，因为 rvdata2 文件中可能存在 nil 元素，必须忽略
-                begin
-                    Utils.check_type(original_object, file_basename, true, :RPG)
-                rescue RPGTypeError
-                    raise Rvdata2FileError.new(original_file_path.to_s), "Invalid rvdata2 file: #{original_file_path}"
-                end
-
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{output_file_path}...\r" if $global_options[:verbose]
-
-                # 根据是否为数组进行不同的处理
-                if object.is_a?(Array)
-                    object.each do |obj|
-                        obj.inject_to(original_object[obj.index])
-                    end
-                else
-                    object.inject_to(original_object)
-                end
-                Utils.object_rvdata2(original_object, output_file_path)
-            end
-            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{output_file_path}\n" if $global_options[:verbose]
-        end
-
-        # 处理 CommonEvent_\d{5}.json 文件
-        Utils.all_commonevent_json_files(target_dir, (complete) ? :RPG : :R3EXS) do |commonevents, _, parent_relative_dir|
-            output_file_path = output_dir.join(parent_relative_dir.parent, 'CommonEvents.rvdata2')
-            if complete
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{output_file_path}...\r" if $global_options[:verbose]
-                Utils.object_rvdata2(commonevents, output_file_path)
-            else
-                # 检查 original_dir 是否存在
-                original_dir.exist? or raise Rvdata2DirError.new(original_dir.to_s), "Original rvdata2 directory not found: #{original_dir}"
-                original_file_path = original_dir.join(parent_relative_dir.parent, 'CommonEvents.rvdata2')
-                print "#{Utils::ESCAPE}#{Utils::BLUE_COLOR}Reading and Deserializing #{Utils::RESET_COLOR}#{original_file_path}...\r" if $global_options[:verbose]
-                original_object = Marshal.load(original_file_path.binread)
-
-                # 这里的类型检查要用紧凑模式，因为 rvdata2 文件中可能存在 nil 元素，必须忽略
-                begin
-                    Utils.check_type(original_object, 'CommonEvents', true, :RPG)
-                rescue RPGTypeError
-                    raise Rvdata2FileError.new(original_file_path.to_s), "Invalid rvdata2 file: #{original_file_path}"
-                end
-
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{output_file_path}...\r" if $global_options[:verbose]
-
-                commonevents.each do |commonevent|
-                    commonevent.inject_to(original_object[commonevent.index])
-                end
-
-                Utils.object_rvdata2(original_object, output_file_path)
-            end
-            print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{output_file_path}\n" if $global_options[:verbose]
-        end
-
-        # 处理 \d{5}.rb 文件
-        if with_scripts
-            Utils.all_rb_files(target_dir) do |scripts, _, parent_relative_dir|
-                output_file_path      = output_dir.join(parent_relative_dir.parent, 'Scripts.rvdata2')
-                script_info_file_path = target_dir.join(parent_relative_dir, 'Scripts_info.json')
-                script_info_file_path.exist? or raise ScriptsInfoPathError.new(script_info_file_path.to_s), "Scripts_info.json not found: #{script_info_file_path}"
-
-                print "#{Utils::ESCAPE}#{Utils::MAGENTA_COLOR}Serializing to #{Utils::RESET_COLOR}#{output_file_path}...\r" if $global_options[:verbose]
-
-                print "#{Utils::ESCAPE}#{Utils::YELLOW_COLOR}Reading from #{Utils::RESET_COLOR}#{script_info_file_path}...\r" if $global_options[:verbose]
-                scripts_info_array = Oj.load_file(script_info_file_path.to_s)
-
-                output_scripts_array = []
-                scripts_info_array.each do |script_info|
-                    index  = script_info[:index]
-                    script = scripts[index]
-                    output_scripts_array << [114514, script_info[:name], Zlib::Deflate.deflate(script)]
-                end
-                Utils.object_rvdata2(output_scripts_array, output_file_path)
-                print "#{Utils::ESCAPE}#{Utils::GREEN_COLOR}Serialized #{Utils::RESET_COLOR}#{output_file_path}\n" if $global_options[:verbose]
-            end
-        end
+  # 将 CommonEvent 文件反序列化为 rvdata2 文件
+  #
+  # @param target_dir [Pathname]  目标目录
+  # @param output_dir [Pathname]  输出目录
+  # @param original_dir [Pathname]  原始 rvdata2 文件目录
+  # @param complete [Boolean]  是否完全转换
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [RPGJsonFileError] json 文件不是 RPG 模块中的对象
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  # @raise [Rvdata2PathError] 原始 rvdata2 文件不存在
+  #
+  # @return [void]
+  def self.commonevents_rvdata2(target_dir, output_dir, original_dir, complete)
+    if complete
+      Utils.all_commonevent_json_files(target_dir, :RPG) do |commonevents, _, rvdata2_file_path|
+        file_path = output_dir.join(rvdata2_file_path.relative_path_from(target_dir))
+        Utils.object_rvdata2(commonevents, file_path)
+        Logger.debug("Serialize   #{file_path}")
+      end
+    else
+      Utils.all_commonevent_json_files(target_dir, :R3EXS) do |commonevents, _, rvdata2_file_path|
+        file_path = output_dir.join(rvdata2_file_path.relative_path_from(target_dir))
+        original_file_path = original_dir.join(rvdata2_file_path.relative_path_from(target_dir))
+        # 检查 original_file_path 是否存在
+        original_file_path.exist? or raise Rvdata2PathError, "Original rvdata2 file not found: #{original_file_path}"
+
+        original_commonevents = Marshal.load(original_file_path.binread)
+        Logger.debug("Deserialize #{original_file_path}")
+        Utils.r3exs_rpg(commonevents, original_commonevents)
+        Utils.object_rvdata2(original_commonevents, file_path)
+        Logger.debug("Serialize   #{file_path}")
+      end
     end
-
-end
+  end
+
+  # 将 Ruby 源码反序列化为 rvdata2 文件
+  #
+  # @param target_dir [Pathname] 目标目录
+  # @param output_dir [Pathname] 输出目录
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [ScriptsInfoPathError] Scripts_info.json 不存在
+  #
+  # @return [void]
+  def self.scripts_rvdata2(target_dir, output_dir)
+    Utils.all_rb_files(target_dir) do |scripts, script_info, _, _, rvdata2_file_path|
+      file_path = output_dir.join(rvdata2_file_path.relative_path_from(target_dir))
+
+      output_scripts = []
+      script_info.each do |info|
+        index = info[:index]
+        script = scripts[index]
+        output_scripts << [114_514, info[:name], Zlib::Deflate.deflate(script)]
+      end
+      Utils.object_rvdata2(output_scripts, file_path)
+      Logger.debug("Serialize   #{file_path}")
+    end
+  end
+
+  # 将常规 JSON 文件反序列化为 rvdata2 文件
+  #
+  # @param target_dir [Pathname]  目标目录
+  # @param output_dir [Pathname]  输出目录
+  # @param original_dir [Pathname]  原始 rvdata2 文件目录
+  # @param complete [Boolean]  是否完全转换
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [RPGJsonFileError] json 文件不是 RPG 模块中的对象
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  # @raise [Rvdata2PathError] 原始 rvdata2 文件不存在
+  #
+  # @return [void]
+  def self.regular_rvdata2(target_dir, output_dir, original_dir, complete)
+    if complete
+      Utils.all_regular_json_files(target_dir, :RPG) do |obj, obj_path|
+        file_path = output_dir.join(obj_path.relative_path_from(target_dir)).sub_ext('.rvdata2')
+        Utils.object_rvdata2(obj, file_path)
+        Logger.debug("Serialize   #{file_path}")
+      end
+    else
+      Utils.all_regular_json_files(target_dir, :R3EXS) do |obj, obj_path|
+        file_path = output_dir.join(obj_path.relative_path_from(target_dir)).sub_ext('.rvdata2')
+        original_file_path = original_dir.join(obj_path.relative_path_from(target_dir)).sub_ext('.rvdata2')
+        # 检查 original_file_path 是否存在
+        original_file_path.exist? or raise Rvdata2PathError, "Original rvdata2 file not found: #{original_file_path}"
+
+        original_object = Marshal.load(original_file_path.binread)
+        Logger.debug("Deserialize #{original_file_path}")
+        Utils.r3exs_rpg(obj, original_object)
+        Utils.object_rvdata2(original_object, file_path)
+        Logger.debug("Serialize   #{file_path}")
+      end
+    end
+  end
+
+  # 将指定目录下的所有JSON文件反序列化为 rvdata2 文件
+  #
+  # @param target_dir [Pathname]  目标目录
+  # @param output_dir [Pathname]  输出目录
+  # @param original_dir [Pathname]  原始 rvdata2 文件目录
+  # @param complete [Boolean]  是否完全转换
+  # @param with_scripts [Boolean]  是否转换Scripts
+  #
+  # @raise [JsonDirError] target_dir 不存在
+  # @raise [RPGJsonFileError] json 文件不是 RPG 模块中的对象
+  # @raise [R3EXSJsonFileError] json 文件不是 R3EXS 模块中的对象
+  # @raise [Rvdata2PathError] 原始 rvdata2 文件不存在
+  # @raise [ScriptsInfoPathError] Scripts_info.json 文件不存在
+  #
+  # @return [void]
+  def self.json_rvdata2(target_dir, output_dir, original_dir, complete, with_scripts)
+    # 处理 CommonEvent_\d{5}.json 文件
+    commonevents_rvdata2(target_dir, output_dir, original_dir, complete)
+
+    # 处理 Script_\d{3}.rb 文件
+    scripts_rvdata2(target_dir, output_dir) if with_scripts
+
+    # 处理常规 JSON 文件
+    regular_rvdata2(target_dir, output_dir, original_dir, complete)
+  end
+end

data/lib/R3EXS/logger.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module R3EXS
+  # 一个简单的 Logger
+  class Logger
+    # Low-level information, mostly for developers.
+    DEBUG = 0
+    # Generic (useful) information about system operation.
+    INFO = 1
+    # A warning.
+    WARN = 2
+
+    @level = INFO
+
+    class << self
+      attr_accessor :level
+
+      def debug(message)
+        logger(DEBUG, message) if level <= DEBUG
+      end
+
+      def info(message)
+        logger(INFO, message) if level <= INFO
+      end
+
+      def warn(message)
+        logger(WARN, message) if level <= WARN
+      end
+
+      def logger(level, message)
+        case level
+        when DEBUG
+          puts("#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} [DEBUG]: #{message}")
+        when INFO
+          puts("#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} [INFO]: #{message}")
+        when WARN
+          ::Kernel.warn("#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} [WARN]: #{message}")
+        else
+          ::Kernel.warn("#{Time.now.strftime('%Y-%m-%d %H:%M:%S')} [UNKNOWN]: #{message}")
+        end
+      end
+    end
+  end
+end