优化代码生成逻辑：统一转换方法为 toRelativePath0，新增 JavaFile.toRelativePath0 支持；改进注释和参数描述，更清晰表达生成方法逻辑；完善 JS 文件保存功能引入 @OptIn 注解。

Author: ForteScarlet

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/Utils.kt

@@ -1,10 +1,11 @@
 package love.forte.simbot.codegen
 
 import love.forte.codegentle.common.naming.isEmpty
-import love.forte.codegentle.common.naming.toRelativePath
+import love.forte.codegentle.common.naming.nameSequence
+import love.forte.codegentle.java.JavaFile
 import love.forte.codegentle.kotlin.KotlinFile
 
-fun KotlinFile.toRelativePath(
+fun KotlinFile.toRelativePath0(
     filename: String = type.name,
     isScript: Boolean = false,
     separator: String = "/"
@@ -19,6 +20,21 @@ fun KotlinFile.toRelativePath(
     return if (packageName.isEmpty()) {
         filenameWithExtension
     } else {
-        packageName.toRelativePath(separator) + separator + filenameWithExtension
+        packageName.nameSequence().joinToString(separator = separator) { it.name } + separator + filenameWithExtension
+    }
+}
+
+fun JavaFile.toRelativePath0(filename: String = type.name ?: "", separator: String = "/"): String {
+    val filenameWithExtension = if (filename.contains('.')) {
+        filename
+    } else {
+        "$filename.java"
+    }
+
+    val packageName = this.packageName
+    return if (packageName.isEmpty()) {
+        filenameWithExtension
+    } else {
+        packageName.nameSequence().joinToString(separator = separator) { it.name } + separator + filenameWithExtension
     }
 }

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/gen/Showcases.kt

@@ -18,6 +18,7 @@ import love.forte.simbot.codegen.codegen.SimbotComponent
 import love.forte.simbot.codegen.codegen.naming.SimbotNames
 import love.forte.simbot.codegen.codegen.naming.SpringNames
 import love.forte.simbot.codegen.codegen.SimbotComponent.*
+import love.forte.simbot.codegen.toRelativePath0
 
 
 /**
@@ -78,7 +79,7 @@ fun emitSpringMainFile(
     sourceDir: JSZip
 ) {
     val file = genKotlinSpringMainFile("MainApplication", projectPackage)
-    sourceDir.file(file.toRelativePath(), file.writeToKotlinString())
+    sourceDir.file(file.toRelativePath0(), file.writeToKotlinString())
 }
 
 fun genKotlinSpringListenerShowcases(
@@ -245,7 +246,7 @@ fun emitSpringListenerShowcases(
     sourceDir: JSZip
 ) {
     val file = genKotlinSpringListenerShowcases(projectPackage, components)
-    sourceDir.file(file.toRelativePath(), file.writeToKotlinString())
+    sourceDir.file(file.toRelativePath0(), file.writeToKotlinString())
 }
 
 /**

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/gen/core/generators/SourceCodeGenerator.kt

@@ -84,21 +84,22 @@ interface LanguageSpecificSourceCodeGenerator<L : ProgrammingLanguage> : SourceC
     /**
      * 生成应用程序入口文件。
      * 
-     * @param sourceDir 包目录的 JSZip 对象
+     * @param sourceDir 语言源代码目录的 JSZip 对象（如 src/main/kotlin 或 src/main/java）
      * @param context 代码生成的上下文信息
      */
     suspend fun generateApplicationEntry(sourceDir: JSZip, context: GenerationContext)
 
     /**
      * 生成事件处理器文件。
      * 
-     * @param sourceDir 包目录的 JSZip 对象
+     * @param sourceDir 语言源代码目录的 JSZip 对象（如 src/main/kotlin 或 src/main/java）
      * @param context 代码生成的上下文信息
      */
     suspend fun generateEventHandlers(sourceDir: JSZip, context: GenerationContext)
 
     override suspend fun generateSourceCode(sourceDir: JSZip, context: GenerationContext) {
-        // sourceDir already points to the correct package directory from createSourceDirectory
+        // sourceDir 指向语言级别的目录（如 src/main/kotlin），而不是包目录
+        // 具体的包目录结构由各个生成方法内部处理
         generateApplicationEntry(sourceDir, context)
         generateEventHandlers(sourceDir, context)
     }

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/gen/core/generators/java/JavaEventHandlerGenerator.kt

@@ -6,6 +6,7 @@ import love.forte.codegentle.java.toRelativePath
 import love.forte.simbot.codegen.gen.core.Framework
 import love.forte.simbot.codegen.gen.core.GenerationContext
 import love.forte.simbot.codegen.gen.core.ProgrammingLanguage
+import love.forte.simbot.codegen.toRelativePath0
 
 /**
  * Java 事件处理器生成器。
@@ -44,7 +45,7 @@ class JavaEventHandlerGenerator {
 //        val handleDir = sourceDir.folder(JavaTemplates.HANDLER_PACKAGE_SUFFIX)
 //            ?: throw IllegalStateException("无法创建 ${JavaTemplates.HANDLER_PACKAGE_SUFFIX} 目录")
 //        val fileName = JavaTemplates.getHandlerFileName()
-        sourceDir.file(handlerFile.toRelativePath(), handlerFile.toString())
+        sourceDir.file(handlerFile.toRelativePath0(), handlerFile.toString())
     }
 
 }

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/gen/core/generators/java/JavaMainClassGenerator.kt

@@ -6,6 +6,7 @@ import love.forte.simbot.codegen.gen.core.Framework
 import love.forte.simbot.codegen.gen.core.GenerationContext
 import love.forte.simbot.codegen.gen.core.JavaStyle
 import love.forte.simbot.codegen.gen.core.ProgrammingLanguage
+import love.forte.simbot.codegen.toRelativePath0
 
 /**
  * Java 主应用类生成器。
@@ -41,7 +42,7 @@ class JavaMainClassGenerator {
 
         // 生成文件
 //        val fileName = JavaTemplates.getMainClassFileName(mainClassName)
-        packageDir.file(javaFile.toRelativePath(), javaFile.toString())
+        packageDir.file(javaFile.toRelativePath0(), javaFile.toString())
     }
 
 }

composeApp/src/wasmJsMain/kotlin/love/forte/simbot/codegen/gen/core/generators/kotlin/KotlinSourceCodeGeneratorImpl.kt

@@ -26,6 +26,8 @@ class KotlinSourceCodeGeneratorImpl : KotlinSourceCodeGenerator {
     override suspend fun generateApplicationEntry(sourceDir: JSZip, context: GenerationContext) {
         when (context.framework) {
             is Framework.Spring -> {
+                // sourceDir 已经指向 src/main/kotlin，直接调用 emitSpringMainFile
+                // emitSpringMainFile 内部会通过 toRelativePath() 创建正确的包目录结构
                 emitSpringMainFile(context.packageName, sourceDir)
             }
             is Framework.Core -> {

file-saver-kotlin/src/commonMain/kotlin/love/forte/simbot/codegen/filesaver/FileSaver.kt

@@ -1,9 +1,11 @@
+@file:OptIn(ExperimentalWasmJsInterop::class)
+
 package love.forte.simbot.codegen.filesaver
 
-import js.date.Date
 import web.blob.Blob
 import web.file.File
 import web.url.URL
+import kotlin.js.ExperimentalWasmJsInterop
 import kotlin.js.JsModule
 import kotlin.js.definedExternally
 
@@ -38,4 +40,4 @@ external fun saveTextAs(
 
 expect interface FileSaverSaveAsOptions {
     var autoBom: Boolean
-}
+}