From f77784193759fc2cfe6d556e28e2462d1de1eeb8 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 11:13:41 +0800
Subject: [PATCH 01/10] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=E8=BF=90?=
 =?UTF-8?q?=E8=A1=8C=E9=85=8D=E7=BD=AE=E5=B9=B6=E7=A7=BB=E9=99=A4=E4=BB=A3?=
 =?UTF-8?q?=E7=A0=81=E8=A6=86=E7=9B=96=E7=8E=87=E8=AE=BE=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在所有 Demo 运行配置中添加 -debug 参数
- 移除所有 Demo 运行配置中的代码覆盖率设置
---
 .run/Demo1.run.xml  | 8 +-------
 .run/Demo10.run.xml | 8 +-------
 .run/Demo11.run.xml | 8 +-------
 .run/Demo12.run.xml | 8 +-------
 .run/Demo13.run.xml | 2 +-
 .run/Demo14.run.xml | 2 +-
 .run/Demo2.run.xml  | 8 +-------
 .run/Demo3.run.xml  | 8 +-------
 .run/Demo4.run.xml  | 8 +-------
 .run/Demo5.run.xml  | 8 +-------
 .run/Demo6.run.xml  | 8 +-------
 .run/Demo7.run.xml  | 8 +-------
 .run/Demo8.run.xml  | 8 +-------
 .run/Demo9.run.xml  | 8 +-------
 14 files changed, 14 insertions(+), 86 deletions(-)

diff --git a/.run/Demo1.run.xml b/.run/Demo1.run.xml
index 055866b..aa50447 100644
--- a/.run/Demo1.run.xml
+++ b/.run/Demo1.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo1 -o target/Demo1" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo1 -o target/Demo1 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo10.run.xml b/.run/Demo10.run.xml
index 3f6bf8b..74bb0ba 100644
--- a/.run/Demo10.run.xml
+++ b/.run/Demo10.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo10 -o target/Demo10" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo10 -o target/Demo10 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo11.run.xml b/.run/Demo11.run.xml
index ea7c1fc..d61b202 100644
--- a/.run/Demo11.run.xml
+++ b/.run/Demo11.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo11 -o target/Demo11" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo11 -o target/Demo11 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo12.run.xml b/.run/Demo12.run.xml
index 5d75b19..bce1584 100644
--- a/.run/Demo12.run.xml
+++ b/.run/Demo12.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo12 -o target/Demo12" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo12 -o target/Demo12 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo13.run.xml b/.run/Demo13.run.xml
index 2544ad6..c722dcf 100644
--- a/.run/Demo13.run.xml
+++ b/.run/Demo13.run.xml
@@ -2,7 +2,7 @@
   <configuration default="false" name="Demo13" type="Application" factoryName="Application" folderName="Demo">
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo13 -o target/Demo13" />
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo13 -o target/Demo13 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo14.run.xml b/.run/Demo14.run.xml
index 6071504..a3c55c6 100644
--- a/.run/Demo14.run.xml
+++ b/.run/Demo14.run.xml
@@ -2,7 +2,7 @@
   <configuration default="false" name="Demo14" type="Application" factoryName="Application" folderName="Demo">
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14" />
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo2.run.xml b/.run/Demo2.run.xml
index 3b10a4e..9a1b95d 100644
--- a/.run/Demo2.run.xml
+++ b/.run/Demo2.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo2 -o target/Demo2" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo2 -o target/Demo2 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo3.run.xml b/.run/Demo3.run.xml
index 9d0224e..0b86b8b 100644
--- a/.run/Demo3.run.xml
+++ b/.run/Demo3.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo3 -o target/Demo3" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo3 -o target/Demo3 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo4.run.xml b/.run/Demo4.run.xml
index a84cbe3..8c44d89 100644
--- a/.run/Demo4.run.xml
+++ b/.run/Demo4.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo4 -o target/Demo4" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo4 -o target/Demo4 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo5.run.xml b/.run/Demo5.run.xml
index e392f42..90ef70e 100644
--- a/.run/Demo5.run.xml
+++ b/.run/Demo5.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo5 -o target/Demo5" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo5 -o target/Demo5 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo6.run.xml b/.run/Demo6.run.xml
index a55fc8e..e58b6dc 100644
--- a/.run/Demo6.run.xml
+++ b/.run/Demo6.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo6 -o target/Demo6" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo6 -o target/Demo6 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo7.run.xml b/.run/Demo7.run.xml
index e8479ec..aeab6e2 100644
--- a/.run/Demo7.run.xml
+++ b/.run/Demo7.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo7 -o target/Demo7" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo7 -o target/Demo7 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo8.run.xml b/.run/Demo8.run.xml
index d4554e1..6f6d2d3 100644
--- a/.run/Demo8.run.xml
+++ b/.run/Demo8.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo8 -o target/Demo8" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo8 -o target/Demo8 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo9.run.xml b/.run/Demo9.run.xml
index 1002732..23d6f53 100644
--- a/.run/Demo9.run.xml
+++ b/.run/Demo9.run.xml
@@ -3,13 +3,7 @@
     <option name="ALTERNATIVE_JRE_PATH" value="graalvm-ce-23" />
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo9 -o target/Demo9" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo9 -o target/Demo9 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>

From b826fc43aa80f68bec29e3c5f08f9479225a5b5b Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 11:23:55 +0800
Subject: [PATCH 02/10] =?UTF-8?q?chore:=E4=BC=98=E5=8C=96=20Native=20Image?=
 =?UTF-8?q?=20=E7=9B=B8=E5=85=B3=E4=BB=A3=E7=A0=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除 module-info.java 中对 org.graalvm.nativeimage 的直接引用
- 修改 VMUtils 中的 isNativeImage 方法，使用反射调用 ImageInfo
---
 src/main/java/module-info.java                    | 1 -
 src/main/java/org/jcnc/snow/vm/utils/VMUtils.java | 5 +++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/java/module-info.java b/src/main/java/module-info.java
index 3597cae..3f8a7b3 100644
--- a/src/main/java/module-info.java
+++ b/src/main/java/module-info.java
@@ -4,7 +4,6 @@ module org.jcnc.snow.compiler {
     uses CLICommand;
     requires java.desktop;
     requires java.logging;
-    requires org.graalvm.nativeimage;
     exports org.jcnc.snow.compiler.ir.core;
     exports org.jcnc.snow.compiler.ir.instruction;
 }
diff --git a/src/main/java/org/jcnc/snow/vm/utils/VMUtils.java b/src/main/java/org/jcnc/snow/vm/utils/VMUtils.java
index ca8d25a..8298df8 100644
--- a/src/main/java/org/jcnc/snow/vm/utils/VMUtils.java
+++ b/src/main/java/org/jcnc/snow/vm/utils/VMUtils.java
@@ -1,6 +1,5 @@
 package org.jcnc.snow.vm.utils;
 
-import org.graalvm.nativeimage.ImageInfo;
 import org.jcnc.snow.vm.engine.VirtualMachineEngine;
 
 /**
@@ -52,9 +51,11 @@ public class VMUtils {
      */
     public static boolean isNativeImage() {
         try {
-            return ImageInfo.inImageCode();
+            Class<?> imageInfo = Class.forName("org.graalvm.nativeimage.ImageInfo");
+            return (Boolean) imageInfo.getMethod("inImageCode").invoke(null);
         } catch (Throwable t) {
             return false;
         }
     }
+
 }

From 4860aba07fe39765dec2ad89bf4dfb21ec0bb7d3 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 11:32:51 +0800
Subject: [PATCH 03/10] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=E9=A1=B9?=
 =?UTF-8?q?=E7=9B=AE=E7=89=88=E6=9C=AC=E8=87=B3=20v0.5.0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 修改 pom.xml 中的版本号为 0.5.0
- 更新 README.md 中的版本徽章为 v0.5.0
- 在 issue 模板中更新软件版本选项，将 v0.4.2 替换为 v0.5.0
---
 .gitee/ISSUE_TEMPLATE/bug.yml | 2 +-
 README.md                     | 4 ++--
 pom.xml                       | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.gitee/ISSUE_TEMPLATE/bug.yml b/.gitee/ISSUE_TEMPLATE/bug.yml
index 8c52224..8f2368e 100644
--- a/.gitee/ISSUE_TEMPLATE/bug.yml
+++ b/.gitee/ISSUE_TEMPLATE/bug.yml
@@ -69,7 +69,7 @@ body:
     attributes:
       label: 软件版本/分支
       options:
-        - v0.4.2
+        - v0.5.0
         - main
         - dev
         - 其他
diff --git a/README.md b/README.md
index da8a7f2..8a58d7b 100644
--- a/README.md
+++ b/README.md
@@ -11,8 +11,8 @@
     <a href="https://gitee.com/jcnc-org/snow/blob/main/LICENSE">
         <img src="https://img.shields.io/badge/%20license-Apache--2.0%20-blue" alt="">
     </a>
-    <a href="https://gitee.com/jcnc-org/snow/tree/v0.4.2/">
-        <img src="https://img.shields.io/badge/version-v0.4.2-blue" alt="">
+    <a href="https://gitee.com/jcnc-org/snow/tree/v0.5.0/">
+        <img src="https://img.shields.io/badge/version-v0.5.0-blue" alt="">
     </a>
 </p>
 
diff --git a/pom.xml b/pom.xml
index 53b5d38..ec86d77 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,7 +7,7 @@
 
     <groupId>org.jcnc.snow</groupId>
     <artifactId>Snow</artifactId>
-    <version>0.4.2</version>
+    <version>0.5.0</version>
 
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

From ebc322668e6baaf393387c0ee31b77856c6f3336 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 12:36:28 +0800
Subject: [PATCH 04/10] =?UTF-8?q?chore:=20=E6=9B=B4=E6=96=B0=E8=BF=90?=
 =?UTF-8?q?=E8=A1=8C=E9=85=8D=E7=BD=AE=E5=B9=B6=E6=B7=BB=E5=8A=A0=E6=96=B0?=
 =?UTF-8?q?=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .run/Bug1.run.xml    |  6 ------
 .run/Demo14.run.xml  |  2 +-
 .run/Help.run.xml    |  6 ------
 .run/Snow.run.xml    | 15 +++++++++++++++
 .run/Version.run.xml |  6 ------
 5 files changed, 16 insertions(+), 19 deletions(-)
 create mode 100644 .run/Snow.run.xml

diff --git a/.run/Bug1.run.xml b/.run/Bug1.run.xml
index f9c6da7..3c8e9ce 100644
--- a/.run/Bug1.run.xml
+++ b/.run/Bug1.run.xml
@@ -4,12 +4,6 @@
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
     <option name="PROGRAM_PARAMETERS" value="compile run -d playground/BugFarm/Bug1 -o target/Bug1" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.compiler.parser.preprocessor.lexer.impl.api.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Demo14.run.xml b/.run/Demo14.run.xml
index a3c55c6..6071504 100644
--- a/.run/Demo14.run.xml
+++ b/.run/Demo14.run.xml
@@ -2,7 +2,7 @@
   <configuration default="false" name="Demo14" type="Application" factoryName="Application" folderName="Demo">
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14 -debug" />
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Help.run.xml b/.run/Help.run.xml
index 849a3b4..89a7af9 100644
--- a/.run/Help.run.xml
+++ b/.run/Help.run.xml
@@ -3,12 +3,6 @@
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
     <option name="PROGRAM_PARAMETERS" value="--help" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.cli.SnowCLI" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
     <method v="2">
       <option name="Make" enabled="true" />
     </method>
diff --git a/.run/Snow.run.xml b/.run/Snow.run.xml
new file mode 100644
index 0000000..30b2c4f
--- /dev/null
+++ b/.run/Snow.run.xml
@@ -0,0 +1,15 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="Snow" type="Application" factoryName="Application">
+    <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
+    <module name="Snow" />
+    <extension name="coverage">
+      <pattern>
+        <option name="PATTERN" value="org.jcnc.snow.cli.SnowCLI" />
+        <option name="ENABLED" value="true" />
+      </pattern>
+    </extension>
+    <method v="2">
+      <option name="Make" enabled="true" />
+    </method>
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/.run/Version.run.xml b/.run/Version.run.xml
index 5816f30..954c579 100644
--- a/.run/Version.run.xml
+++ b/.run/Version.run.xml
@@ -3,12 +3,6 @@
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
     <option name="PROGRAM_PARAMETERS" value="--version" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="org.jcnc.snow.cli.SnowCLI" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
     <method v="2">
       <option name="Make" enabled="true" />
     </method>

From 210fdb62f03e3cd96ed5cbeec15764761e16a243 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 12:36:56 +0800
Subject: [PATCH 05/10] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E5=85=A8?=
 =?UTF-8?q?=E5=B1=80=E8=B0=83=E8=AF=95=E9=80=89=E9=A1=B9=E5=B9=B6=E6=9B=B4?=
 =?UTF-8?q?=E6=96=B0=E7=9B=B8=E5=85=B3=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在 CLIUtils 中添加了全局调试标志集合，支持 "-debug" 和 "--debug" 选项
- 在 CompileTask 中更新了调试选项的处理逻辑，支持新的 "--debug" 标志
- 在 SnowCLI 中引入了 Mode 和 SnowConfig 类，以支持调试模式的配置
---
 src/main/java/org/jcnc/snow/cli/SnowCLI.java          |  2 ++
 src/main/java/org/jcnc/snow/cli/utils/CLIUtils.java   | 11 ++++++++++-
 .../java/org/jcnc/snow/pkg/tasks/CompileTask.java     |  2 +-
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/src/main/java/org/jcnc/snow/cli/SnowCLI.java b/src/main/java/org/jcnc/snow/cli/SnowCLI.java
index 0ce6ba0..d05b0bf 100644
--- a/src/main/java/org/jcnc/snow/cli/SnowCLI.java
+++ b/src/main/java/org/jcnc/snow/cli/SnowCLI.java
@@ -4,6 +4,8 @@ import org.jcnc.snow.cli.api.CLICommand;
 import org.jcnc.snow.cli.commands.*;
 import org.jcnc.snow.cli.utils.CLIUtils;
 import org.jcnc.snow.cli.utils.VersionUtils;
+import org.jcnc.snow.common.Mode;
+import org.jcnc.snow.common.SnowConfig;
 
 import java.util.Arrays;
 import java.util.Map;
diff --git a/src/main/java/org/jcnc/snow/cli/utils/CLIUtils.java b/src/main/java/org/jcnc/snow/cli/utils/CLIUtils.java
index ca36951..efa44b3 100644
--- a/src/main/java/org/jcnc/snow/cli/utils/CLIUtils.java
+++ b/src/main/java/org/jcnc/snow/cli/utils/CLIUtils.java
@@ -26,12 +26,21 @@ public class CLIUtils {
             "-v", "--version"
     );
 
+    /**
+     * 全局调试标志集合，支持 "-debug"、"--debug"。
+     */
+    public static final Set<String> GLOBAL_DEBUG_FLAGS = Set.of(
+            "--debug"
+    );
+
     /**
      * 全局选项列表，包括帮助和版本选项的描述。
      */
     public static final List<Option> GLOBAL_OPTIONS = List.of(
             new Option(List.of("-h", "--help"), "Show this help message and exit"),
-            new Option(List.of("-v", "--version"), "Print snow programming language version and exit")
+            new Option(List.of("-v", "--version"), "Print snow programming language version and exit"),
+            new Option(List.of("-debug", "--debug"), "Enable debug mode with verbose internal logs")
+
     );
 
     /**
diff --git a/src/main/java/org/jcnc/snow/pkg/tasks/CompileTask.java b/src/main/java/org/jcnc/snow/pkg/tasks/CompileTask.java
index c908125..c7423a9 100644
--- a/src/main/java/org/jcnc/snow/pkg/tasks/CompileTask.java
+++ b/src/main/java/org/jcnc/snow/pkg/tasks/CompileTask.java
@@ -154,7 +154,7 @@ public final class CompileTask implements Task {
             String arg = args[i];
             switch (arg) {
                 case "run" -> runAfterCompile = true;
-                case "-debug" -> SnowConfig.MODE = Mode.DEBUG;
+                case "-debug", "--debug" -> SnowConfig.MODE = Mode.DEBUG;
                 case "-o" -> {
                     if (i + 1 < args.length) outputName = args[++i];
                     else {

From 34e5de0454614e1f0eee8a41678d90c050483188 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 12:45:01 +0800
Subject: [PATCH 06/10] =?UTF-8?q?chore:=20=E5=9C=A8=20Demo14=E8=BF=90?=
 =?UTF-8?q?=E8=A1=8C=E9=85=8D=E7=BD=AE=E4=B8=AD=E6=B7=BB=E5=8A=A0=E8=B0=83?=
 =?UTF-8?q?=E8=AF=95=E5=8F=82=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在 Demo14.run.xml 文件中添加了 -debug 参数到 PROGRAM_PARAMETERS 选项
- 此修改便于在运行 Demo14 时进行调试
---
 .run/Demo14.run.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.run/Demo14.run.xml b/.run/Demo14.run.xml
index 6071504..a3c55c6 100644
--- a/.run/Demo14.run.xml
+++ b/.run/Demo14.run.xml
@@ -2,7 +2,7 @@
   <configuration default="false" name="Demo14" type="Application" factoryName="Application" folderName="Demo">
     <option name="MAIN_CLASS_NAME" value="org.jcnc.snow.cli.SnowCLI" />
     <module name="Snow" />
-    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14" />
+    <option name="PROGRAM_PARAMETERS" value="compile run -d playground/Demo/Demo14 -o target/Demo14 -debug" />
     <method v="2">
       <option name="Make" enabled="true" />
     </method>

From 688d6d73930b30e065367ea0bd72cb92dc0e0552 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 12:59:26 +0800
Subject: [PATCH 07/10] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3=E5=86=85=E5=AE=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除加粗样式
- 更新 CLI 命令列表，增加 debug 命令
- 添加词法分析和语义分析的示例输出
- 调整编译流程和命令选项的描述
---
 README.md | 277 ++++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 197 insertions(+), 80 deletions(-)

diff --git a/README.md b/README.md
index 8a58d7b..af18ac8 100644
--- a/README.md
+++ b/README.md
@@ -54,11 +54,11 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 | 类别       | 关键特性                                                                                              |
 |----------|---------------------------------------------------------------------------------------------------|
 | 语言层      | `module` / `import` / `function` / `loop` / `if–else` / Pratt 表达式解析<br>静态类型检查 & 作用域分析             |
-| 编译器前端    | **Lexer / Parser / Semantic Analyzer** 全栈自研，生成 JSON-AST                                           |
+| 编译器前端    | Lexer / Parser / Semantic Analyzer 全栈自研，生成 JSON-AST                                               |
 | IR & 后端  | 三地址式 IR ➜ 线性扫描寄存器分配 ➜ SnowVM 指令                                                                   |
 | 虚拟机      | 栈 + 寄存器混合架构、GUI 局部变量监视                                                                            |
 | snow pkg | - `.cloud` DSL 描述项目、依赖与构建<br>- 预设 `clean / compile / run / package / publish` 任务<br>- 离线缓存与远程仓库解析 |
-| CLI      | `snow init`, `snow compile`, `snow run`, `snow clean`, `snow build`, `snow generate`              |
+| CLI      | init, compile,  run, clean,  build, generate,debug                                                |
 
 ## Snow-Lang 官网
 
@@ -104,7 +104,7 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 
 4. **运行成功**
     
-   `````snow   
+    `````snow   
     ## 编译器输出
     ### Snow 源代码
     #### Main.snow
@@ -118,6 +118,59 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
             end body
         end function
     end module
+    line   col    type             lexeme
+    ----------------------------------------------------
+    1      1      KEYWORD          module
+    1      7      COLON            :
+    1      9      IDENTIFIER       Main
+    1      13     NEWLINE          \n
+    
+    2      5      KEYWORD          import
+    2      11     COLON            :
+    2      12     IDENTIFIER       Math
+    2      16     NEWLINE          \n
+    
+    3      5      KEYWORD          function
+    3      13     COLON            :
+    3      15     IDENTIFIER       main
+    3      19     NEWLINE          \n
+    
+    4      9      KEYWORD          return_type
+    4      20     COLON            :
+    4      22     TYPE             int
+    4      25     NEWLINE          \n
+    
+    5      9      KEYWORD          body
+    5      13     COLON            :
+    5      14     NEWLINE          \n
+    
+    6      13     IDENTIFIER       Math
+    6      17     DOT              .
+    6      18     IDENTIFIER       add
+    6      21     LPAREN           (
+    6      22     NUMBER_LITERAL   6
+    6      23     COMMA            ,
+    6      24     NUMBER_LITERAL   1
+    6      25     RPAREN           )
+    6      26     NEWLINE          \n
+    
+    7      13     KEYWORD          return
+    7      20     NUMBER_LITERAL   0
+    7      21     NEWLINE          \n
+    
+    8      9      KEYWORD          end
+    8      13     KEYWORD          body
+    8      17     NEWLINE          \n
+    
+    9      5      KEYWORD          end
+    9      9      KEYWORD          function
+    9      17     NEWLINE          \n
+    
+    10     1      KEYWORD          end
+    10     5      KEYWORD          module
+    10     1      EOF              
+    ## 词法分析通过，没有发现错误
+    
     #### Math.snow
     module: Math
         function: add
@@ -126,121 +179,179 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
                 declare n2: int
             return_type: int
             body:
-            return n1 + n2
+               return n1 + n2
             end body
         end function
     end module
+    line   col    type             lexeme
+    ----------------------------------------------------
+    1      1      KEYWORD          module
+    1      7      COLON            :
+    1      9      IDENTIFIER       Math
+    1      13     NEWLINE          \n
+    
+    2      5      KEYWORD          function
+    2      13     COLON            :
+    2      15     IDENTIFIER       add
+    2      18     NEWLINE          \n
+    
+    3      9      KEYWORD          parameter
+    3      18     COLON            :
+    3      19     NEWLINE          \n
+    
+    4      13     KEYWORD          declare
+    4      21     IDENTIFIER       n1
+    4      23     COLON            :
+    4      25     TYPE             int
+    4      28     NEWLINE          \n
+    
+    5      13     KEYWORD          declare
+    5      21     IDENTIFIER       n2
+    5      23     COLON            :
+    5      25     TYPE             int
+    5      28     NEWLINE          \n
+    
+    6      9      KEYWORD          return_type
+    6      20     COLON            :
+    6      22     TYPE             int
+    6      25     NEWLINE          \n
+    
+    7      9      KEYWORD          body
+    7      13     COLON            :
+    7      14     NEWLINE          \n
+    
+    8      12     KEYWORD          return
+    8      19     IDENTIFIER       n1
+    8      22     PLUS             +
+    8      24     IDENTIFIER       n2
+    8      26     NEWLINE          \n
+    
+    9      9      KEYWORD          end
+    9      13     KEYWORD          body
+    9      17     NEWLINE          \n
+    
+    10     5      KEYWORD          end
+    10     9      KEYWORD          function
+    10     17     NEWLINE          \n
+    
+    11     1      KEYWORD          end
+    11     5      KEYWORD          module
+    11     1      EOF        
+    
+    ## 词法分析通过，没有发现错误
+    
+    ## 语义分析通过，没有发现错误
+    
     ### AST
     [
-    {
+      {
         "type": "Module",
         "name": "Main",
         "imports": [
-        {
-            "module": "Math",
-            "type": "Import"
-        }
+          {
+            "type": "Import",
+            "module": "Math"
+          }
         ],
         "functions": [
-        {
+          {
             "type": "Function",
             "name": "main",
             "parameters": [
-            
+              
             ],
             "returnType": "int",
             "body": [
-            {
+              {
                 "type": "ExpressionStatement",
                 "expression": {
-                "type": "CallExpression",
-                "callee": {
+                  "type": "CallExpression",
+                  "callee": {
                     "type": "MemberExpression",
                     "object": {
-                    "type": "Identifier",
-                    "name": "Math"
+                      "type": "Identifier",
+                      "name": "Math"
                     },
                     "member": "add"
-                },
-                "arguments": [
+                  },
+                  "arguments": [
                     {
-                    "type": "NumberLiteral",
-                    "value": "6"
+                      "type": "NumberLiteral",
+                      "value": "6"
                     },
                     {
-                    "type": "NumberLiteral",
-                    "value": "1"
+                      "type": "NumberLiteral",
+                      "value": "1"
                     }
-                ]
+                  ]
                 }
-            },
-            {
+              },
+              {
                 "type": "Return",
                 "value": {
-                "type": "NumberLiteral",
-                "value": "0"
+                  "type": "NumberLiteral",
+                  "value": "0"
                 }
-            }
+              }
             ]
-        }
+          }
         ]
-    },
-    {
+      },
+      {
         "type": "Module",
         "name": "Math",
         "imports": [
-        
+          
         ],
         "functions": [
-        {
+          {
             "type": "Function",
             "name": "add",
             "parameters": [
-            {
+              {
                 "name": "n1",
                 "type": "int"
-            },
-            {
+              },
+              {
                 "name": "n2",
                 "type": "int"
-            }
+              }
             ],
             "returnType": "int",
             "body": [
-            {
+              {
                 "type": "Return",
                 "value": {
-                "type": "BinaryExpression",
-                "left": {
+                  "type": "BinaryExpression",
+                  "left": {
                     "type": "Identifier",
                     "name": "n1"
-                },
-                "operator": "+",
-                "right": {
+                  },
+                  "operator": "+",
+                  "right": {
                     "type": "Identifier",
                     "name": "n2"
+                  }
                 }
-                }
-            }
+              }
             ]
-        }
+          }
         ]
-    }
+      }
     ]
     ### IR
     func main() {
-    %0 = CONST 6
-    %1 = CONST 1
-    %2 = CALL Math.add, %0, %1
-    %3 = CONST 0
-    RET %3
+      %0 = CONST 6
+      %1 = CONST 1
+      %2 = CALL Math.add, %0, %1
+      %3 = CONST 0
+      RET %3
     }
     func add(%0, %1) {
-    %2 = ADD_I32 %0, %1
-    RET %2
+      %2 = ADD_I32 %0, %1
+      RET %2
     }
-
-
+    
     ### VM code
     0000: I_PUSH     6
     0001: I_STORE    0
@@ -248,35 +359,41 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
     0003: I_STORE    1
     0004: I_LOAD     0
     0005: I_LOAD     1
-    0006: CALL       12 2
+    0006: CALL       13 2
     0007: I_STORE    2
     0008: I_PUSH     0
     0009: I_STORE    3
     0010: I_LOAD     3
     0011: HALT       
-    0012: I_LOAD     0
-    0013: I_LOAD     1
-    0014: I_ADD      
-    0015: I_STORE    2
-    0016: I_LOAD     2
-    0017: RET        
+    0012: HALT       
+    0013: I_LOAD     0
+    0014: I_LOAD     1
+    0015: I_ADD      
+    0016: I_STORE    2
+    0017: I_LOAD     2
+    0018: RET        
+    0019: RET        
     Written to D:\Devs\IdeaProjects\Snow\target\Demo1.water
-
+    
     === Launching VM ===
-    Calling function at address: 12
+    
+    Calling function at address: 13
+    
     Return 7
+    
     Process has ended
 
     Operand Stack state:[0]
-
+    
     --- Call Stack State ---
-
-
+    
     ### VM Local Variable Table:
     0: 6
     1: 1
     2: 7
     3: 0
+    
+    === VM exited ===
     `````
     
 ## 编译 Snow 源代码
@@ -287,36 +404,36 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 
 #### 独立编译步骤: 
 
-1. **运行编译器: **
+1. **运行编译器:**
    你可以通过以下命令来编译单个或多个 `.snow` 文件，或者递归编译一个目录中的所有 `.snow` 源文件为`.water`虚拟机指令。
 
-    * **单个文件编译: **
+    * **单个文件编译:**
 
       ```bash
       Snow complete [SnowCode].snow
       ```
 
-    * **多个文件编译: **
+    * **多个文件编译:**
 
       ```bash
       Snow complete [SnowCode1].snow [SnowCode2].snow [SnowCode3].snow -o [Name]
       ```
 
-    * **目录递归编译: **
+    * **目录递归编译:**
 
       ```bash
       Snow -d path/to/source_dir
       ```
 
-2. **查看编译输出: **
+2. **查看编译输出:**
    编译过程会输出源代码、抽象语法树（AST）、中间表示（IR）以及虚拟机指令等内容。你可以看到如下几个分段输出: 
 
     * **AST**（抽象语法树）部分以 JSON 格式输出。
     * **IR**（中间表示）部分会列出逐行的中间代码。
     * **VM code**（虚拟机指令）会展示虚拟机的字节码指令。
 
-3. **默认执行模式: **
-   编译器会在 **DEBUG 模式** 下运行，显示详细的执行过程和状态，并且在虚拟机中执行编译后的代码，最后会打印出所有局部变量的值。
+3. **默认执行模式:**
+   编译器会在 **RUN 模式** 下运行，**DEBUG 模式**显示详细的执行过程和状态，并且在虚拟机中执行编译后的代码，最后会打印出所有局部变量的值。
 
 ---
 
@@ -326,18 +443,18 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 
 #### 集成编译命令: 
 
-1. **基本用法: **
+1. **基本用法:**
 
    ```bash
      snow [OPTIONS] <command>
    ```
 
-2. **命令选项: **
+2. **命令选项:**
 
     * `-h, --help`: 显示帮助信息并退出。
     * `-v, --version`: 打印 Snow 编程语言的版本并退出。
 
-3. **可用命令: **
+3. **可用命令:**
 
     * `compile`: 将 `.snow` 源文件编译成虚拟机字节码文件（`.water`）。此命令会使用 `.cloud` 文件来指导编译过程。
     * `clean`: 清理构建输出和本地缓存，移除中间产物，释放磁盘空间。
@@ -347,7 +464,7 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
     * `generate`: 根据 `project.cloud` 生成项目目录结构。
     * `build`: 构建当前项目，按顺序解析依赖、编译和打包。
 
-4. **例如，执行集成编译命令: **
+4. **例如，执行集成编译命令:**
 
    ```bash
    snow compile [SnowCode].snow
@@ -355,7 +472,7 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 
     * 此命令会使用 `.cloud` 文件中的配置信息来指导编译过程，并生成 `.water`。
 
-5. **使用帮助: **
+5. **使用帮助:**
    如果你需要了解某个命令的详细选项，可以使用: 
 
    ```bash

From f81dba021032337f0b7043c9a7cb0e70ad73f99a Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 13:00:52 +0800
Subject: [PATCH 08/10] =?UTF-8?q?docs:=E4=BC=98=E5=8C=96=20README=20?=
 =?UTF-8?q?=E4=B8=AD=E8=AF=AD=E8=A8=80=E7=89=B9=E6=80=A7=E6=8F=8F=E8=BF=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除了代码关键字的 Markdown 格式加粗，保持一致性
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index af18ac8..aeb36a9 100644
--- a/README.md
+++ b/README.md
@@ -53,7 +53,7 @@ Snow 语言受到 LLM 驱动代码生成趋势的启发,强调简单而清晰的
 
 | 类别       | 关键特性                                                                                              |
 |----------|---------------------------------------------------------------------------------------------------|
-| 语言层      | `module` / `import` / `function` / `loop` / `if–else` / Pratt 表达式解析<br>静态类型检查 & 作用域分析             |
+| 语言层      | module / import / function / loop / if–else / Pratt 表达式解析<br>静态类型检查 & 作用域分析                       |
 | 编译器前端    | Lexer / Parser / Semantic Analyzer 全栈自研，生成 JSON-AST                                               |
 | IR & 后端  | 三地址式 IR ➜ 线性扫描寄存器分配 ➜ SnowVM 指令                                                                   |
 | 虚拟机      | 栈 + 寄存器混合架构、GUI 局部变量监视                                                                            |

From 589b0a96b92e8799566b2b4bb646bfda84117f6c Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 13:04:08 +0800
Subject: [PATCH 09/10] =?UTF-8?q?docs:=20=E5=9C=A8=20README=20=E4=B8=AD?=
 =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=94=AF=E6=8C=81=E6=88=91=E4=BB=AC=E7=9A=84?=
 =?UTF-8?q?=E7=AB=A0=E8=8A=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index aeb36a9..1e47407 100644
--- a/README.md
+++ b/README.md
@@ -579,6 +579,12 @@ end module
 “SnowLang 项目”为由许轲（Luke）发起的独立开源项目。  
 未来，项目可能会成立正式的组织或实体，以进一步负责本项目的开发和管理。
 
+## 支持我们
+
+如果你喜欢我们的项目，欢迎给我们一个 Star！  
+你们的关注和支持，是我们团队持续进步的动力源泉！谢谢大家！
+
+
 ## 加入我们
 
 - 微信: `xuxiaolankaka`

From a86fb4826d87ef677eb8d37f80180207336c05f0 Mon Sep 17 00:00:00 2001
From: Luke <luke.k.xu@hotmail.com>
Date: Thu, 24 Jul 2025 13:31:34 +0800
Subject: [PATCH 10/10] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=93=8D?=
 =?UTF-8?q?=E4=BD=9C=E7=A0=81=E6=96=87=E6=A1=A3=E7=BB=93=E6=9E=84=E5=92=8C?=
 =?UTF-8?q?=E5=86=85=E5=AE=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加新的 Reference Control 分类
- 更新各分类的名称和描述，使其更加清晰
---
 docs/SnowVM-OpCode/SnowVM-OpCode.md | 33 +++++++++++++++++------------
 1 file changed, 20 insertions(+), 13 deletions(-)

diff --git a/docs/SnowVM-OpCode/SnowVM-OpCode.md b/docs/SnowVM-OpCode/SnowVM-OpCode.md
index 4bd5d46..26343b7 100644
--- a/docs/SnowVM-OpCode/SnowVM-OpCode.md
+++ b/docs/SnowVM-OpCode/SnowVM-OpCode.md
@@ -1,7 +1,8 @@
 # SnowVM-OpCode
 
-## 1. Byte8 区域（0x0000-0x001F）
+## Type Control (0x0000-0x00BF)
 
+### Byte8	 (0x0000-0x001F)
 | 指令名      | 十六进制   | 说明             |
 |----------|--------|----------------|
 | B\_ADD   | 0x0000 | byte8 加法       |
@@ -26,7 +27,7 @@
 
 ---
 
-## 2. Short16 区域（0x0020-0x003F）
+### Short16 (0x0020-0x003F)
 
 | 指令名      | 十六进制   | 说明               |
 |----------|--------|------------------|
@@ -52,7 +53,7 @@
 
 ---
 
-## 3. Int32 区域（0x0040-0x005F）
+### Int32 (0x0040-0x005F)
 
 | 指令名      | 十六进制   | 说明             |
 |----------|--------|----------------|
@@ -78,7 +79,7 @@
 
 ---
 
-## 4. Long64 区域（0x0060-0x007F）
+### Long64 区域（0x0060-0x007F）
 
 | 指令名      | 十六进制   | 说明              |
 |----------|--------|-----------------|
@@ -104,7 +105,7 @@
 
 ---
 
-## 5. Float32 区域（0x0080-0x009F）
+### Float32 区域（0x0080-0x009F）
 
 | 指令名      | 十六进制   | 说明               |
 |----------|--------|------------------|
@@ -127,7 +128,7 @@
 
 ---
 
-## 6. Double64 区域（0x00A0-0x00BF）
+### Double64 区域（0x00A0-0x00BF）
 
 | 指令名      | 十六进制   | 说明                |
 |----------|--------|-------------------|
@@ -150,7 +151,7 @@
 
 ---
 
-## 7. 类型转换（0x00C0-0x00DF）
+## Type Conversion (0x00C0-0x00DF)
 
 | 指令名 | 十六进制   | 说明                 |
 |-----|--------|--------------------|
@@ -185,11 +186,17 @@
 | D2L | 0x00DC | double64 转 long64  |
 | D2F | 0x00DD | double64 转 float32 |
 
-
-
 ---
+## Reference Control (0x00E0-0x00EF)
+| 指令名      | 十六进制   | 说明                        |
+|----------|--------|---------------------------|
+| R\_PUSH  | 0x00E0 | 将对象引用压入操作数栈               |
+| R\_LOAD  | 0x00E1 | 从本地变量表加载对象引用并压入操作数栈       |
+| R\_STORE | 0x00E2 | 将操作数栈顶的对象引用弹出并存入本地变量表指定槽位 |
 
-## 8. 栈控制（0x0100-0x01FF）
+
+
+## Stack Control (0x0100-0x01FF)
 
 | 指令名  | 十六进制   | 说明       |
 |------|--------|----------|
@@ -199,7 +206,7 @@
 
 ---
 
-## 9. 流程控制（0x0200-0x02FF）
+## Flow Control (0x0200-0x02FF)
 
 | 指令名  | 十六进制/十进制 | 说明    |
 |------|----------|-------|
@@ -209,7 +216,7 @@
 
 ---
 
-## 10. 寄存器控制（0x0300-0x03FF）
+##  Register Control (0x0300-0x03FF)
 
 | 指令名 | 十六进制   | 说明      |
 |-----|--------|---------|
@@ -217,7 +224,7 @@
 
 ---
 
-## 11. 系统控制（0x0400-0x04FF）
+## System Control (0x0400-0x04FF)
 
 | 指令名         | 十六进制   | 说明   |
 |-------------|--------|------|