From 6a17ec039721d4eb80d8171328eeacd303296742 Mon Sep 17 00:00:00 2001
From: Jay <jayng9663@gmail.com>
Date: Sun, 19 Oct 2025 04:59:34 -0700
Subject: [PATCH 01/30] Add --warmup option to control physics warmup loops

Create a new --warmup argument to specify the number of warmup loops for physics before export. This allows users to control how many times the animation is pre-processed to stabilize physics.
---
 SpineViewerCLI/SpineViewerCLI.cs | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/SpineViewerCLI/SpineViewerCLI.cs b/SpineViewerCLI/SpineViewerCLI.cs
index 4343768..121d73f 100644
--- a/SpineViewerCLI/SpineViewerCLI.cs
+++ b/SpineViewerCLI/SpineViewerCLI.cs
@@ -33,6 +33,7 @@ options:
   --speed FLOAT         Speed of animation (for video), default 1.0
   --color HEX           Background color as a hex RGBA color, default 000000ff (opaque black)
   --quiet               Removes console progress log, default false
+  --warmup INT          Warm Up Physics, default 2 loops before export
 ";
 
         public static void Main(string[] args)
@@ -57,6 +58,8 @@ options:
             float speed = 1;
             Color backgroundColor = Color.Black;
             bool quiet = false;
+            bool warmup = false;
+            int warmUpLoops = 2;
 
             for (int i = 0; i < args.Length; i++)
             {
@@ -126,6 +129,10 @@ options:
                     case "--quiet":
                         quiet = true;
                         break;
+                    case "--warmup":
+                        warmUpLoops = int.Parse(args[++i]);
+                        warmup = true;
+                        break;
                     default:
                         Console.Error.WriteLine($"Unknown argument: {args[i]}");
                         Environment.Exit(2);
@@ -172,6 +179,20 @@ options:
             }
             sp.Update(0);
 
+            if (warmup)
+            {
+                float delta = 1f / fps;
+                for (int i = 0; i < warmUpLoops; i++)
+                {
+                    float t = 0;
+                    while (t < trackEntry.Animation.Duration)
+                    {
+                        sp.Update(delta);
+                        t += delta;
+                    }
+                }
+            }
+
             foreach (var slotName in hideSlots)
             {
                 if (!sp.SetSlotVisible(slotName, false))

From d335645dc158fb3d4c8ca4a320baa48d76666dcb Mon Sep 17 00:00:00 2001
From: ww-rm <43590561+ww-rm@users.noreply.github.com>
Date: Sun, 19 Oct 2025 20:46:42 +0800
Subject: [PATCH 02/30] remove unnecessary frame loops

---
 SpineViewerCLI/SpineViewerCLI.cs | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/SpineViewerCLI/SpineViewerCLI.cs b/SpineViewerCLI/SpineViewerCLI.cs
index 121d73f..9794543 100644
--- a/SpineViewerCLI/SpineViewerCLI.cs
+++ b/SpineViewerCLI/SpineViewerCLI.cs
@@ -181,16 +181,7 @@ options:
 
             if (warmup)
             {
-                float delta = 1f / fps;
-                for (int i = 0; i < warmUpLoops; i++)
-                {
-                    float t = 0;
-                    while (t < trackEntry.Animation.Duration)
-                    {
-                        sp.Update(delta);
-                        t += delta;
-                    }
-                }
+                sp.Update(trackEntry.Animation.Duration * warmUpLoops);
             }
 
             foreach (var slotName in hideSlots)
@@ -370,4 +361,4 @@ options:
             return new(x, y, w, h);
         }
     }
-}
\ No newline at end of file
+}

From 779500ee8ef9239c4badf1cdd56031416e45dae6 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sat, 25 Oct 2025 16:47:00 +0800
Subject: [PATCH 03/30] =?UTF-8?q?=E4=BF=AE=E6=94=B9ApngPred=E5=B1=9E?=
 =?UTF-8?q?=E6=80=A7=E5=90=8D=E4=B8=BAPredMethod?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FFmpegVideoExporter.cs                      | 6 +++---
 SpineViewer/Resources/Strings/en.xaml                       | 4 ++--
 SpineViewer/Resources/Strings/ja.xaml                       | 4 ++--
 SpineViewer/Resources/Strings/zh.xaml                       | 4 ++--
 .../ViewModels/Exporters/FFmpegVideoExporterViewModel.cs    | 6 +++---
 .../Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml    | 4 ++--
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/Spine/Exporters/FFmpegVideoExporter.cs b/Spine/Exporters/FFmpegVideoExporter.cs
index ea04666..b73492d 100644
--- a/Spine/Exporters/FFmpegVideoExporter.cs
+++ b/Spine/Exporters/FFmpegVideoExporter.cs
@@ -62,8 +62,8 @@ namespace Spine.Exporters
         /// <summary>
         /// [Apng] 预测器算法, 取值范围 0-5, 分别对应 none, sub, up, avg, paeth, mixed
         /// </summary>
-        public int ApngPred { get => _apngPred; set => _apngPred = Math.Clamp(value, 0, 5); }
-        private int _apngPred = 5;
+        public int PredMethod { get => _predMethod; set => _predMethod = Math.Clamp(value, 0, 5); }
+        private int _predMethod = 5;
 
         /// <summary>
         /// [Mp4/Webm/Mkv] CRF
@@ -142,7 +142,7 @@ namespace Spine.Exporters
 
         private void SetApngOptions(FFMpegArgumentOptions options)
         {
-            var customArgs = $"-vf unpremultiply=inplace=1 -plays {(_loop ? 0 : 1)} -pred {_apngPred}";
+            var customArgs = $"-vf unpremultiply=inplace=1 -plays {(_loop ? 0 : 1)} -pred {_predMethod}";
             options.ForceFormat("apng").WithVideoCodec("apng").ForcePixelFormat("rgba")
                 .WithCustomArgument(customArgs);
         }
diff --git a/SpineViewer/Resources/Strings/en.xaml b/SpineViewer/Resources/Strings/en.xaml
index 418e0c5..e53a826 100644
--- a/SpineViewer/Resources/Strings/en.xaml
+++ b/SpineViewer/Resources/Strings/en.xaml
@@ -206,8 +206,8 @@
     <s:String x:Key="Str_QualityParameterTooltip" xml:space="preserve">[Webp]&#x0A;Quality parameter, range 0-100, higher value means better quality</s:String>
     <s:String x:Key="Str_LosslessParam">Lossless Compression</s:String>
     <s:String x:Key="Str_LosslessParamTooltip" xml:space="preserve">[Webp]&#x0A;Lossless compression, quality parameter will be ignored</s:String>
-    <s:String x:Key="Str_ApngPred">Predictor Method</s:String>
-    <s:String x:Key="Str_ApngPredTooltip" xml:space="preserve">[Apng]&#x0A;Pred parameter, value range 0-5, corresponding to different encoding strategies: none, sub, up, avg, paeth, and mixed.&#x0A;It affects encoding time and file size.</s:String>
+    <s:String x:Key="Str_PredMethod">Predictor Method</s:String>
+    <s:String x:Key="Str_PredMethodTooltip" xml:space="preserve">[Apng]&#x0A;Pred parameter, value range 0-5, corresponding to different encoding strategies: none, sub, up, avg, paeth, and mixed.&#x0A;It affects encoding time and file size.</s:String>
     <s:String x:Key="Str_CrfParameter">CRF Parameter</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF parameter, range 0-63, lower value means higher quality</s:String>
     <s:String x:Key="Str_ProfileParameter">Profile Parameter</s:String>
diff --git a/SpineViewer/Resources/Strings/ja.xaml b/SpineViewer/Resources/Strings/ja.xaml
index 766eb13..fcecb2c 100644
--- a/SpineViewer/Resources/Strings/ja.xaml
+++ b/SpineViewer/Resources/Strings/ja.xaml
@@ -206,8 +206,8 @@
     <s:String x:Key="Str_QualityParameterTooltip" xml:space="preserve">[Webp]&#x0A;品質パラメータ、範囲は0-100。値が高いほど品質が良い</s:String>
     <s:String x:Key="Str_LosslessParam">無損失圧縮</s:String>
     <s:String x:Key="Str_LosslessParamTooltip" xml:space="preserve">[Webp]&#x0A;無損失圧縮、品質パラメータは無視されます</s:String>
-    <s:String x:Key="Str_ApngPred">予測器方式</s:String>
-    <s:String x:Key="Str_ApngPredTooltip" xml:space="preserve">[Apng]&#x0A;Pred パラメータ。値の範囲は 0～5 で、それぞれ none、sub、up、avg、paeth、mixed の異なるエンコード方式に対応します。&#x0A;エンコード時間とファイルサイズに影響します。</s:String>
+    <s:String x:Key="Str_PredMethod">予測器方式</s:String>
+    <s:String x:Key="Str_PredMethodTooltip" xml:space="preserve">[Apng]&#x0A;Pred パラメータ。値の範囲は 0～5 で、それぞれ none、sub、up、avg、paeth、mixed の異なるエンコード方式に対応します。&#x0A;エンコード時間とファイルサイズに影響します。</s:String>
     <s:String x:Key="Str_CrfParameter">CRF パラメータ</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF パラメータ、範囲0-63。値が小さいほど品質が高い</s:String>
     <s:String x:Key="Str_ProfileParameter">プロファイルパラメータ</s:String>
diff --git a/SpineViewer/Resources/Strings/zh.xaml b/SpineViewer/Resources/Strings/zh.xaml
index 95d462f..a621d3f 100644
--- a/SpineViewer/Resources/Strings/zh.xaml
+++ b/SpineViewer/Resources/Strings/zh.xaml
@@ -206,8 +206,8 @@
     <s:String x:Key="Str_QualityParameterTooltip" xml:space="preserve">[Webp]&#x0A;质量参数，取值范围 0-100，越高质量越好</s:String>
     <s:String x:Key="Str_LosslessParam">无损压缩</s:String>
     <s:String x:Key="Str_LosslessParamTooltip" xml:space="preserve">[Webp]&#x0A;无损压缩，会忽略质量参数</s:String>
-    <s:String x:Key="Str_ApngPred">预测器方法</s:String>
-    <s:String x:Key="Str_ApngPredTooltip" xml:space="preserve">[Apng]&#x0A;Pred 参数，取值范围 0-5，分别对应 none、sub、up、avg、paeth、mixed 几种不同的编码策略，&#x0A;影响编码时间和文件大小</s:String>
+    <s:String x:Key="Str_PredMethod">预测器方法</s:String>
+    <s:String x:Key="Str_PredMethodTooltip" xml:space="preserve">[Apng]&#x0A;Pred 参数，取值范围 0-5，分别对应 none、sub、up、avg、paeth、mixed 几种不同的编码策略，&#x0A;影响编码时间和文件大小</s:String>
     <s:String x:Key="Str_CrfParameter">CRF 参数</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF 参数，取值范围 0-63，越小质量越高</s:String>
     <s:String x:Key="Str_ProfileParameter">Profile 参数</s:String>
diff --git a/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs b/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
index 474c03b..f0faa54 100644
--- a/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
+++ b/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
@@ -57,8 +57,8 @@ namespace SpineViewer.ViewModels.Exporters
         public bool EnableParamLossless =>
             _format == FFmpegVideoExporter.VideoFormat.Webp;
 
-        public int ApngPred { get => _apngPred; set => SetProperty(ref _apngPred, Math.Clamp(value, 0, 5)); }
-        protected int _apngPred = 5;
+        public int PredMethod { get => _predMethod; set => SetProperty(ref _predMethod, Math.Clamp(value, 0, 5)); }
+        protected int _predMethod = 5;
 
         public bool EnableParamApngPred =>
             _format == FFmpegVideoExporter.VideoFormat.Apng;
@@ -102,7 +102,7 @@ namespace SpineViewer.ViewModels.Exporters
                 Loop = _loop,
                 Quality = _quality,
                 Lossless = _lossless,
-                ApngPred = _apngPred,
+                PredMethod = _predMethod,
                 Crf = _crf,
                 Profile = _profile,
             };
diff --git a/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml b/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
index 1d60ef6..fbfaae2 100644
--- a/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
+++ b/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
@@ -247,8 +247,8 @@
                                     <ColumnDefinition Width="Auto" SharedSizeGroup="LabelCol"/>
                                     <ColumnDefinition Width="*"/>
                                 </Grid.ColumnDefinitions>
-                                <Label Content="{DynamicResource Str_ApngPred}" ToolTip="{DynamicResource Str_ApngPredTooltip}"/>
-                                <TextBox Grid.Column="1" Text="{Binding ApngPred}" ToolTip="{DynamicResource Str_ApngPredTooltip}"/>
+                                <Label Content="{DynamicResource Str_PredMethod}" ToolTip="{DynamicResource Str_PredMethodTooltip}"/>
+                                <TextBox Grid.Column="1" Text="{Binding PredMethod}" ToolTip="{DynamicResource Str_PredMethodTooltip}"/>
                             </Grid>
 
                             <!-- CRF 参数 -->

From 74538ddf74da3c5dcaf47d2072f0d36a9e8585fd Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sat, 25 Oct 2025 17:04:39 +0800
Subject: [PATCH 04/30] =?UTF-8?q?apng=E5=92=8Cmov=E6=A0=BC=E5=BC=8F?=
 =?UTF-8?q?=E5=8F=82=E6=95=B0=E6=94=B9=E4=B8=BA=E6=9E=9A=E4=B8=BE=E9=87=8F?=
 =?UTF-8?q?=E7=B1=BB=E5=9E=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FFmpegVideoExporter.cs        | 43 +++++++++++++++----
 SpineViewer/Resources/Strings/en.xaml         |  2 +-
 SpineViewer/Resources/Strings/ja.xaml         |  2 +-
 SpineViewer/Resources/Strings/zh.xaml         |  2 +-
 .../Exporters/FFmpegVideoExporterViewModel.cs | 10 +++--
 .../FFmpegVideoExporterDialog.xaml            | 10 ++++-
 6 files changed, 52 insertions(+), 17 deletions(-)

diff --git a/Spine/Exporters/FFmpegVideoExporter.cs b/Spine/Exporters/FFmpegVideoExporter.cs
index b73492d..b52d0ab 100644
--- a/Spine/Exporters/FFmpegVideoExporter.cs
+++ b/Spine/Exporters/FFmpegVideoExporter.cs
@@ -35,6 +35,33 @@ namespace Spine.Exporters
             Mov,
         }
 
+        /// <summary>
+        /// Apng 格式预测器算法
+        /// </summary>
+        public enum ApngPredMethod
+        {
+            None = 0,
+            Sub = 1,
+            Up = 2,
+            Avg = 3,
+            Paeth = 4,
+            Mixed = 5,
+        }
+
+        /// <summary>
+        /// Mov prores_ks 编码器 profile 参数
+        /// </summary>
+        public enum MovProfile
+        {
+            Auto = -1,
+            Proxy = 0,
+            Light = 1,
+            Standard = 2,
+            High = 3,
+            Yuv4444 = 4,
+            Yuv4444Extreme = 5,
+        }
+
         /// <summary>
         /// 视频格式
         /// </summary>
@@ -60,10 +87,10 @@ namespace Spine.Exporters
         private bool _lossless = false;
 
         /// <summary>
-        /// [Apng] 预测器算法, 取值范围 0-5, 分别对应 none, sub, up, avg, paeth, mixed
+        /// [Apng] 预测器算法
         /// </summary>
-        public int PredMethod { get => _predMethod; set => _predMethod = Math.Clamp(value, 0, 5); }
-        private int _predMethod = 5;
+        public ApngPredMethod PredMethod { get => _predMethod; set => _predMethod = value; }
+        private ApngPredMethod _predMethod = ApngPredMethod.Mixed;
 
         /// <summary>
         /// [Mp4/Webm/Mkv] CRF
@@ -72,10 +99,10 @@ namespace Spine.Exporters
         private int _crf = 23;
 
         /// <summary>
-        /// [Mov] prores_ks 编码器的配置等级, -1 是自动, 越高质量越好, 只有 4 及以上才有透明通道
+        /// [Mov] prores_ks 编码器的配置等级, 越高质量越好, 只有 <see cref="MovProfile.Yuv4444"> 及以上才有透明通道
         /// </summary>
-        public int Profile { get => _profile; set => _profile = Math.Clamp(value, -1, 5); }
-        private int _profile = 5;
+        public MovProfile Profile { get => _profile; set => _profile = value; }
+        private MovProfile _profile = MovProfile.Yuv4444Extreme;
 
         /// <summary>
         /// 获取的一帧, 结果是预乘的
@@ -142,7 +169,7 @@ namespace Spine.Exporters
 
         private void SetApngOptions(FFMpegArgumentOptions options)
         {
-            var customArgs = $"-vf unpremultiply=inplace=1 -plays {(_loop ? 0 : 1)} -pred {_predMethod}";
+            var customArgs = $"-vf unpremultiply=inplace=1 -plays {(_loop ? 0 : 1)} -pred {(int)_predMethod}";
             options.ForceFormat("apng").WithVideoCodec("apng").ForcePixelFormat("rgba")
                 .WithCustomArgument(customArgs);
         }
@@ -179,7 +206,7 @@ namespace Spine.Exporters
             var customArgs = "-vf unpremultiply=inplace=1";
             options.ForceFormat("mov").WithVideoCodec("prores_ks").ForcePixelFormat("yuva444p10le")
                 .WithFastStart()
-                .WithCustomArgument($"-profile {_profile}")
+                .WithCustomArgument($"-profile {(int)_profile}")
                 .WithCustomArgument(customArgs);
         }
     }
diff --git a/SpineViewer/Resources/Strings/en.xaml b/SpineViewer/Resources/Strings/en.xaml
index e53a826..e4bdbfd 100644
--- a/SpineViewer/Resources/Strings/en.xaml
+++ b/SpineViewer/Resources/Strings/en.xaml
@@ -211,7 +211,7 @@
     <s:String x:Key="Str_CrfParameter">CRF Parameter</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF parameter, range 0-63, lower value means higher quality</s:String>
     <s:String x:Key="Str_ProfileParameter">Profile Parameter</s:String>
-    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;Profile parameter, integer between -1 and 5,&#x0A;-1 means automatic, higher values indicate higher quality,&#x0A;Alpha channel encoding is only available when value is 4 or higher</s:String>
+    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;Profile parameter, an integer between -1 and 5,&#x0A;corresponding to: auto, proxy, lt, standard, hq, 4444, and 4444xq.&#x0A;Alpha channel encoding is available only when the value is 4 or higher.</s:String>
 
     <s:String x:Key="Str_FFmpegFormat">Export Format</s:String>
     <s:String x:Key="Str_FFmpegFormatTooltip">FFmpeg export format (equivalent to "-f"), e.g. "mp4", "webm"</s:String>
diff --git a/SpineViewer/Resources/Strings/ja.xaml b/SpineViewer/Resources/Strings/ja.xaml
index fcecb2c..16559c7 100644
--- a/SpineViewer/Resources/Strings/ja.xaml
+++ b/SpineViewer/Resources/Strings/ja.xaml
@@ -211,7 +211,7 @@
     <s:String x:Key="Str_CrfParameter">CRF パラメータ</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF パラメータ、範囲0-63。値が小さいほど品質が高い</s:String>
     <s:String x:Key="Str_ProfileParameter">プロファイルパラメータ</s:String>
-    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;プロファイルパラメータ、-1から5の整数、&#x0A;-1は自動、値が大きいほど品質が高い、&#x0A;値が4以上の場合のみアルファチャンネルをエンコード可能</s:String>
+    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;Profile パラメータ。値は -1 ～ 5 の整数で、&#x0A;それぞれ auto、proxy、lt、standard、hq、4444、4444xq に対応します。&#x0A;値が 4 以上の場合のみアルファチャンネルのエンコードが可能です。</s:String>
 
     <s:String x:Key="Str_FFmpegFormat">エクスポートフォーマット</s:String>
     <s:String x:Key="Str_FFmpegFormatTooltip">FFmpegエクスポートフォーマット。パラメーター“-f”に相当します。例: “mp4”、“webm”</s:String>
diff --git a/SpineViewer/Resources/Strings/zh.xaml b/SpineViewer/Resources/Strings/zh.xaml
index a621d3f..9fc695c 100644
--- a/SpineViewer/Resources/Strings/zh.xaml
+++ b/SpineViewer/Resources/Strings/zh.xaml
@@ -211,7 +211,7 @@
     <s:String x:Key="Str_CrfParameter">CRF 参数</s:String>
     <s:String x:Key="Str_CrfParameterTooltip" xml:space="preserve">[Mp4/Webm/Mkv]&#x0A;CRF 参数，取值范围 0-63，越小质量越高</s:String>
     <s:String x:Key="Str_ProfileParameter">Profile 参数</s:String>
-    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;Profile 参数，取值集合为 -1 到 5 之间的整数，&#x0A;-1 表示自动，0-5 取值越高质量越高，&#x0A;仅在取值大于等于 4 时可以编码透明度通道</s:String>
+    <s:String x:Key="Str_ProfileParameterTooltip" xml:space="preserve">[Mov]&#x0A;Profile 参数，取值范围为 -1 到 5 之间的整数，&#x0A;分别对应 auto、proxy、lt、standard、hq、4444、4444xq 几种配置，&#x0A;仅在取值大于等于 4 时可以编码透明度通道</s:String>
 
     <s:String x:Key="Str_FFmpegFormat">导出格式</s:String>
     <s:String x:Key="Str_FFmpegFormatTooltip">FFmpeg 导出格式，等价于参数 “-f”，例如 “mp4”、“webm”</s:String>
diff --git a/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs b/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
index f0faa54..446639e 100644
--- a/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
+++ b/SpineViewer/ViewModels/Exporters/FFmpegVideoExporterViewModel.cs
@@ -19,6 +19,8 @@ namespace SpineViewer.ViewModels.Exporters
     public class FFmpegVideoExporterViewModel(MainWindowViewModel vmMain) : VideoExporterViewModel(vmMain)
     {
         public static ImmutableArray<FFmpegVideoExporter.VideoFormat> VideoFormatOptions { get; } = Enum.GetValues<FFmpegVideoExporter.VideoFormat>().ToImmutableArray();
+        public static ImmutableArray<FFmpegVideoExporter.ApngPredMethod> ApngPredMethodOptions { get; } = Enum.GetValues<FFmpegVideoExporter.ApngPredMethod>().ToImmutableArray();
+        public static ImmutableArray<FFmpegVideoExporter.MovProfile> MovProfileOptions { get; } = Enum.GetValues<FFmpegVideoExporter.MovProfile>().ToImmutableArray();
 
         public FFmpegVideoExporter.VideoFormat Format 
         { 
@@ -57,8 +59,8 @@ namespace SpineViewer.ViewModels.Exporters
         public bool EnableParamLossless =>
             _format == FFmpegVideoExporter.VideoFormat.Webp;
 
-        public int PredMethod { get => _predMethod; set => SetProperty(ref _predMethod, Math.Clamp(value, 0, 5)); }
-        protected int _predMethod = 5;
+        public FFmpegVideoExporter.ApngPredMethod PredMethod { get => _predMethod; set => SetProperty(ref _predMethod, value); }
+        protected FFmpegVideoExporter.ApngPredMethod _predMethod = FFmpegVideoExporter.ApngPredMethod.Mixed;
 
         public bool EnableParamApngPred =>
             _format == FFmpegVideoExporter.VideoFormat.Apng;
@@ -71,8 +73,8 @@ namespace SpineViewer.ViewModels.Exporters
             _format == FFmpegVideoExporter.VideoFormat.Webm ||
             _format == FFmpegVideoExporter.VideoFormat.Mkv;
 
-        public int Profile { get => _profile; set => SetProperty(ref _profile, Math.Clamp(value, -1, 5)); }
-        protected int _profile = 5;
+        public FFmpegVideoExporter.MovProfile Profile { get => _profile; set => SetProperty(ref _profile, value); }
+        protected FFmpegVideoExporter.MovProfile _profile = FFmpegVideoExporter.MovProfile.Yuv4444Extreme;
 
         public bool EnableParamProfile =>
             _format == FFmpegVideoExporter.VideoFormat.Mov;
diff --git a/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml b/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
index fbfaae2..91e3efa 100644
--- a/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
+++ b/SpineViewer/Views/ExporterDialogs/FFmpegVideoExporterDialog.xaml
@@ -248,7 +248,10 @@
                                     <ColumnDefinition Width="*"/>
                                 </Grid.ColumnDefinitions>
                                 <Label Content="{DynamicResource Str_PredMethod}" ToolTip="{DynamicResource Str_PredMethodTooltip}"/>
-                                <TextBox Grid.Column="1" Text="{Binding PredMethod}" ToolTip="{DynamicResource Str_PredMethodTooltip}"/>
+                                <ComboBox Grid.Column="1" 
+                                          SelectedItem="{Binding PredMethod}" 
+                                          ItemsSource="{x:Static vmexp:FFmpegVideoExporterViewModel.ApngPredMethodOptions}" 
+                                          ToolTip="{DynamicResource Str_PredMethodTooltip}"/>
                             </Grid>
 
                             <!-- CRF 参数 -->
@@ -268,7 +271,10 @@
                                     <ColumnDefinition Width="*"/>
                                 </Grid.ColumnDefinitions>
                                 <Label Content="{DynamicResource Str_ProfileParameter}" ToolTip="{DynamicResource Str_ProfileParameterTooltip}"/>
-                                <TextBox Grid.Column="1" Text="{Binding Profile}" ToolTip="{DynamicResource Str_ProfileParameterTooltip}"/>
+                                <ComboBox Grid.Column="1" 
+                                          SelectedItem="{Binding Profile}" 
+                                          ItemsSource="{x:Static vmexp:FFmpegVideoExporterViewModel.MovProfileOptions}" 
+                                          ToolTip="{DynamicResource Str_ProfileParameterTooltip}"/>
                             </Grid>
                         </StackPanel>
                     </GroupBox>

From 7ca431b214bd4ebdab39f0d205487df26c6e5edc Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sat, 25 Oct 2025 17:19:27 +0800
Subject: [PATCH 05/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0System.CommandLine?=
 =?UTF-8?q?=E5=BA=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/SpineViewerCLI.csproj | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/SpineViewerCLI/SpineViewerCLI.csproj b/SpineViewerCLI/SpineViewerCLI.csproj
index 7ccfe44..6184551 100644
--- a/SpineViewerCLI/SpineViewerCLI.csproj
+++ b/SpineViewerCLI/SpineViewerCLI.csproj
@@ -15,6 +15,10 @@
         <NoWarn>$(NoWarn);NETSDK1206</NoWarn>
     </PropertyGroup>
 
+    <ItemGroup>
+      <PackageReference Include="System.CommandLine" Version="2.0.0-rc.2.25502.107" />
+    </ItemGroup>
+
     <ItemGroup>
         <ProjectReference Include="..\SFMLRenderer\SFMLRenderer.csproj" />
         <ProjectReference Include="..\Spine\Spine.csproj" />

From c4956b9c1673d0096ffa054b9a56bd5a4cb13ef1 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 13:26:47 +0800
Subject: [PATCH 06/30] =?UTF-8?q?=E9=87=8D=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../Exporters/Extension.cs                    | 34 +++----------------
 SpineViewer/Extensions/WpfExtension.cs        | 28 +++++++++++++--
 2 files changed, 30 insertions(+), 32 deletions(-)
 rename SpineViewer/Extensions/SFMLExtension.cs => Spine/Exporters/Extension.cs (69%)

diff --git a/SpineViewer/Extensions/SFMLExtension.cs b/Spine/Exporters/Extension.cs
similarity index 69%
rename from SpineViewer/Extensions/SFMLExtension.cs
rename to Spine/Exporters/Extension.cs
index 6882a3a..f6295a0 100644
--- a/SpineViewer/Extensions/SFMLExtension.cs
+++ b/Spine/Exporters/Extension.cs
@@ -1,18 +1,14 @@
 using SFML.Graphics;
 using SFML.System;
-using SkiaSharp;
 using System;
 using System.Collections.Generic;
-using System.IO;
 using System.Linq;
-using System.Runtime.InteropServices;
 using System.Text;
 using System.Threading.Tasks;
-using System.Windows;
 
-namespace SpineViewer.Extensions
+namespace Spine.Exporters
 {
-    public static class SFMLExtension
+    public static class Extension
     {
         /// <summary>
         /// 获取适合指定画布参数下能够覆盖包围盒的画布视区包围盒
@@ -53,31 +49,11 @@ namespace SpineViewer.Extensions
         public static FloatRect GetBounds(this View self)
         {
             return new(
-                self.Center.X - self.Size.X / 2, 
-                self.Center.Y - self.Size.Y / 2, 
-                self.Size.X, 
+                self.Center.X - self.Size.X / 2,
+                self.Center.Y - self.Size.Y / 2,
+                self.Size.X,
                 self.Size.Y
             );
         }
-
-        public static FloatRect ToFloatRect(this Rect self)
-        {
-            return new((float)self.X, (float)self.Y, (float)self.Width, (float)self.Height);
-        }
-
-        public static Vector2f ToVector2f(this Size self)
-        {
-            return new((float)self.Width, (float)self.Height);
-        }
-
-        public static Vector2u ToVector2u(this Size self)
-        {
-            return new((uint)self.Width, (uint)self.Height);
-        }
-
-        public static Vector2i ToVector2i(this Size self)
-        {
-            return new((int)self.Width, (int)self.Height);
-        }
     }
 }
diff --git a/SpineViewer/Extensions/WpfExtension.cs b/SpineViewer/Extensions/WpfExtension.cs
index d5cd487..9ce86e0 100644
--- a/SpineViewer/Extensions/WpfExtension.cs
+++ b/SpineViewer/Extensions/WpfExtension.cs
@@ -1,19 +1,41 @@
-using SkiaSharp;
+using SFML.Graphics;
+using SFML.System;
+using SkiaSharp;
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Runtime.InteropServices;
 using System.Text;
 using System.Threading.Tasks;
-using System.Windows.Media;
 using System.Windows;
+using System.Windows.Media;
 using System.Windows.Media.Imaging;
-using System.Runtime.InteropServices;
 
 namespace SpineViewer.Extensions
 {
     public static class WpfExtension
     {
+        public static FloatRect ToFloatRect(this Rect self)
+        {
+            return new((float)self.X, (float)self.Y, (float)self.Width, (float)self.Height);
+        }
+
+        public static Vector2f ToVector2f(this Size self)
+        {
+            return new((float)self.Width, (float)self.Height);
+        }
+
+        public static Vector2u ToVector2u(this Size self)
+        {
+            return new((uint)self.Width, (uint)self.Height);
+        }
+
+        public static Vector2i ToVector2i(this Size self)
+        {
+            return new((int)self.Width, (int)self.Height);
+        }
+
         /// <summary>
         /// 从本地 WebP 文件读取，并保留透明度，返回一个可以直接用于 WPF Image.Source 的 BitmapSource。
         /// </summary>

From aade44cffbfe861f946635c8908c085718aaf77e Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 15:19:09 +0800
Subject: [PATCH 07/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FrameSequenceExporter.cs | 2 +-
 Spine/Exporters/VideoExporter.cs         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Spine/Exporters/FrameSequenceExporter.cs b/Spine/Exporters/FrameSequenceExporter.cs
index 4655178..3fdddc3 100644
--- a/Spine/Exporters/FrameSequenceExporter.cs
+++ b/Spine/Exporters/FrameSequenceExporter.cs
@@ -24,7 +24,7 @@ namespace Spine.Exporters
             int frameCount = GetFrameCount();
             int frameIdx = 0;
 
-            _progressReporter?.Invoke(frameCount, 0, $"[{frameIdx}/{frameCount}] {output}");
+            _progressReporter?.Invoke(frameCount, 0, $"[{frameIdx}/{frameCount}] {output}"); // 导出帧序列单独在此处调用进度报告
             foreach (var frame in GetFrames(spines))
             {
                 if (ct.IsCancellationRequested)
diff --git a/Spine/Exporters/VideoExporter.cs b/Spine/Exporters/VideoExporter.cs
index e1bb672..164c241 100644
--- a/Spine/Exporters/VideoExporter.cs
+++ b/Spine/Exporters/VideoExporter.cs
@@ -92,7 +92,7 @@ namespace Spine.Exporters
         }
 
         /// <summary>
-        /// 生成帧序列
+        /// 生成帧序列, 用于导出帧序列
         /// </summary>
         protected IEnumerable<SFMLImageVideoFrame> GetFrames(SpineObject[] spines)
         {
@@ -121,7 +121,7 @@ namespace Spine.Exporters
         }
 
         /// <summary>
-        /// 生成帧序列, 支持中途取消和进度输出
+        /// 生成帧序列, 支持中途取消和进度输出, 用于动图视频等单个文件输出
         /// </summary>
         protected IEnumerable<SFMLImageVideoFrame> GetFrames(SpineObject[] spines, string output, CancellationToken ct)
         {

From d3b5814c6f06e2f1164460319ad584eed4f8d135 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 15:52:47 +0800
Subject: [PATCH 08/30] small change

---
 SpineViewer/App.xaml.cs              | 3 ++-
 SpineViewer/Views/MainWindow.xaml.cs | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/SpineViewer/App.xaml.cs b/SpineViewer/App.xaml.cs
index 359deba..af068ba 100644
--- a/SpineViewer/App.xaml.cs
+++ b/SpineViewer/App.xaml.cs
@@ -84,12 +84,13 @@ namespace SpineViewer
             var fileTarget = new NLog.Targets.FileTarget("fileTarget")
             {
                 Encoding = System.Text.Encoding.UTF8,
+                Layout = "${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${level:uppercase=true} - ${processid} - ${callsite-filename:includeSourcePath=false}:${callsite-linenumber} - ${message}",
+                AutoFlush = true,
                 FileName = "${basedir}/logs/app.log",
                 ArchiveFileName = "${basedir}/logs/app.{#}.log",
                 ArchiveNumbering = NLog.Targets.ArchiveNumberingMode.Rolling,
                 ArchiveAboveSize = 1048576,
                 MaxArchiveFiles = 5,
-                Layout = "${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${level:uppercase=true} - ${processid} - ${callsite-filename:includeSourcePath=false}:${callsite-linenumber} - ${message}",
                 ConcurrentWrites = true,
                 KeepFileOpen = false,
             };
diff --git a/SpineViewer/Views/MainWindow.xaml.cs b/SpineViewer/Views/MainWindow.xaml.cs
index 3d2fd34..ce801e9 100644
--- a/SpineViewer/Views/MainWindow.xaml.cs
+++ b/SpineViewer/Views/MainWindow.xaml.cs
@@ -120,11 +120,11 @@ public partial class MainWindow : Window
         var rtbTarget = new NLog.Windows.Wpf.RichTextBoxTarget
         {
             Name = "rtbTarget",
+            Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}",
             WindowName = _mainWindow.Name,
             ControlName = _loggerRichTextBox.Name,
             AutoScroll = true,
             MaxLines = 3000,
-            Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}",
         };
 
         rtbTarget.WordColoringRules.Add(new("[D]", "Gray", "Empty"));

From 9d9edb8bc437d39b5ad01605ad2563e5e59b3e60 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 16:16:43 +0800
Subject: [PATCH 09/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20export=20=E5=91=BD?=
 =?UTF-8?q?=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs      | 463 +++++++++++++++++++++++++++
 SpineViewerCLI/Extension.cs          |  88 +++++
 SpineViewerCLI/SpineViewerCLI.cs     | 395 ++++-------------------
 SpineViewerCLI/SpineViewerCLI.csproj |   1 +
 SpineViewerCLI/Utils.cs              |  67 ++++
 5 files changed, 677 insertions(+), 337 deletions(-)
 create mode 100644 SpineViewerCLI/ExportCommand.cs
 create mode 100644 SpineViewerCLI/Extension.cs
 create mode 100644 SpineViewerCLI/Utils.cs

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
new file mode 100644
index 0000000..35c7900
--- /dev/null
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -0,0 +1,463 @@
+using NLog;
+using SFML.Graphics;
+using Spine;
+using Spine.Exporters;
+using System;
+using System.Collections.Generic;
+using System.CommandLine;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows;
+
+namespace SpineViewerCLI
+{
+    public enum ExportFormat
+    {
+        Png = 0x0100,
+        Jpg = 0x0101,
+        Webp = 0x0102,
+        Bmp = 0x0103,
+        Frames = 0x0200,
+        Gif = 0x0300,
+        Webpa = 0x0301,
+        Apng = 0x0302,
+        Mp4 = 0x0303,
+        Webm = 0x0304,
+        Mkv = 0x0305,
+        Mov = 0x0306,
+        Custom = 0x0400,
+    }
+
+    public class ExportCommand : Command
+    {
+        private static readonly Logger _logger = LogManager.GetCurrentClassLogger();
+        private static readonly string _name = "export";
+        private static readonly string _desc = "Export single model";
+
+        #region >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 基本参数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+
+        public Argument<FileInfo> ArgSkel { get; } = new("skel")
+        {
+            Description = "Path of skel file.",
+        };
+
+        public Option<ExportFormat> OptFormat { get; } = new("--format", "-f")
+        {
+            Description = "Export format.",
+            Required = true,
+        };
+
+        public Option<string> OptOutput { get; } = new("--output", "-o")
+        {
+            Description = "Output file or directory. Use a directory for frame sequence export.",
+            Required = true,
+        };
+
+        public Option<string[]> OptAnimations { get; } = new("--animations", "-a")
+        {
+            Description = "Animations to export. Supports multiple entries, placed in order on tracks starting from 0。",
+            Required = true,
+            Arity = ArgumentArity.OneOrMore,
+            AllowMultipleArgumentsPerToken = true,
+        };
+
+        public Option<FileInfo> OptAtlas { get; } = new("--atlas")
+        {
+            Description = "Path to the atlas file that matches the skel file.",
+        };
+
+        public Option<float> OptScale { get; } = new("--scale")
+        {
+            Description = "Scale factor of the model.",
+            DefaultValueFactory = _ => 1f,
+        };
+
+        public Option<bool> OptPma { get; } = new("--pma")
+        {
+            Description = "Specifies whether the texture uses PMA (premultiplied alpha) format.",
+        };
+
+        public Option<string[]> OptSkins { get; } = new("--skins")
+        {
+            Description = "Skins to export. Multiple skins can be specified.",
+            Arity = ArgumentArity.OneOrMore,
+            AllowMultipleArgumentsPerToken = true,
+        };
+
+        public Option<string[]> OptDisableSlots { get; } = new("--disable-slots")
+        {
+            Description = "Slots to disable during export. Multiple slots can be specified.",
+            Arity = ArgumentArity.OneOrMore,
+            AllowMultipleArgumentsPerToken = true,
+        };
+
+        public Option<float> OptWarmUp { get; } = new("--warm-up")
+        {
+            Description = "Warm-up duration of the animation, used to stabilize physics effects. A negative value will automatically warm up for the maximum duration among all animations.",
+            DefaultValueFactory = _ => 0f,
+        };
+
+        public Option<bool> OptNoProgress { get; } = new("--no-progress")
+        {
+            Description = "Do not display real-time progress.",
+        };
+
+        #endregion
+
+        #region >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 基本导出参数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+
+        public Option<Color> OptColor { get; } = new("--color")
+        {
+            Description = "Background color of content.",
+            //DefaultValueFactory = ...
+            CustomParser = Utils.ParseColor
+        };
+
+        public Option<uint> OptMargin { get; } = new("--margin")
+        {
+            Description = "Size of the margin (in pixels) around the content.",
+            DefaultValueFactory = _ => 0u,
+        };
+
+        public Option<uint> OptMaxResolution { get; } = new("--max-resolution")
+        {
+            Description = "Maximum width or height (in pixels) for exported images.",
+            DefaultValueFactory = _ => 2048u,
+        };
+
+        public Option<float> OptTime { get; } = new("--time")
+        {
+            Description = "Start time offset of the animation.",
+            DefaultValueFactory = _ => 0f,
+        };
+
+        public Option<float> OptDuration { get; } = new("--duration")
+        {
+            Description = "Export duration. Negative values indicate automatic duration calculation.",
+            DefaultValueFactory = _ => -1f,
+        };
+
+        public Option<uint> OptFps { get; } = new("--fps")
+        {
+            Description = "Frame rate for export.",
+            DefaultValueFactory = _ => 30u,
+        };
+
+        public Option<float> OptSpeed { get; } = new("--speed")
+        {
+            Description = "Speed factor for the exported animation.",
+            DefaultValueFactory = _ => 1f,
+        };
+
+        public Option<bool> OptDropLastFrame { get; } = new("--drop-last-frame")
+        {
+            Description = "Whether to drop the incomplete last frame.",
+        };
+
+        #endregion
+
+        #region >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 格式参数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+
+        public Option<uint> OptQuality { get; } = new("--quality")
+        {
+            Description = "Image quality.",
+            DefaultValueFactory = _ => 80u,
+        };
+
+        public Option<bool> OptLoop { get; } = new("--loop")
+        {
+            Description = "Whether the animation should loop.",
+        };
+
+        public Option<bool> OptLossless { get; } = new("--lossless")
+        {
+            Description = "Whether to encode the WebP animation losslessly.",
+        };
+
+        public Option<FFmpegVideoExporter.ApngPredMethod> OptApngPredMethod { get; } = new("--apng-pred")
+        {
+            Description = "Prediction method used for APNG animations.",
+            DefaultValueFactory = _ => FFmpegVideoExporter.ApngPredMethod.Mixed,
+        };
+
+        public Option<uint> OptCrf { get; } = new("--crf")
+        {
+            Description = "CRF (Constant Rate Factor) value for encoding.",
+            DefaultValueFactory = _ => 23u,
+        };
+
+        public Option<FFmpegVideoExporter.MovProfile> OptMovProfile { get; } = new("--mov-profile")
+        {
+            Description = "Profile setting for MOV format export.",
+            DefaultValueFactory = _ => FFmpegVideoExporter.MovProfile.Yuv4444Extreme,
+        };
+
+        #endregion
+
+        #region >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 自定义导出格式参数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
+
+        public Option<string> OptFFFormat { get; } = new("--ff-format")
+        {
+            Description = "format option of ffmpeg",
+        };
+
+        public Option<string> OptFFCodec { get; } = new("--ff-codec")
+        {
+            Description = "codec option of ffmpeg",
+        };
+
+        public Option<string> OptFFPixelFormat { get; } = new("--ff-pixfmt")
+        {
+            Description = "pixel format option of ffmpeg",
+        };
+
+        public Option<string> OptFFBitrate { get; } = new("--ff-bitrate")
+        {
+            Description = "bitrate option of ffmpeg",
+        };
+
+        public Option<string> OptFFFilter { get; } = new("--ff-filter")
+        {
+            Description = "filter option of ffmpeg",
+        };
+
+        public Option<string> OptFFArgs { get; } = new("--ff-args")
+        {
+            Description = "other arguments of ffmpeg",
+        };
+
+        #endregion
+
+        public ExportCommand() : base(_name, _desc)
+        {
+            OptColor.DefaultValueFactory = r =>
+            {
+                var defVal = Color.Black;
+                try
+                {
+                    switch (r.GetValue(OptFormat))
+                    {
+                        case ExportFormat.Png:
+                        case ExportFormat.Webp:
+                        case ExportFormat.Frames:
+                        case ExportFormat.Gif:
+                        case ExportFormat.Webpa:
+                        case ExportFormat.Apng:
+                        case ExportFormat.Webm:
+                            defVal = Color.Transparent;
+                            break;
+                    }
+                }
+                catch (InvalidOperationException) { } // 未提供 OptFormat 的时候 GetValue 会报错
+                return defVal;
+            };
+            OptScale.Validators.Add(r =>
+            {
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var val) && val < 0)
+                    r.AddError($"{OptScale.Name} must be non-negative.");
+            });
+            OptTime.Validators.Add(r =>
+            {
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var val) && val < 0)
+                    r.AddError($"{OptTime.Name} must be non-negative.");
+            });
+
+            // 用反射查找自己所有的公开属性是 Argument 或者 Option 的
+            foreach (var prop in GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
+            {
+                var value = prop.GetValue(this);
+                if (value is Argument arg) Add(arg);
+                else if (value is Option opt) Add(opt);
+            }
+
+            SetAction(ExportAction);
+        }
+
+        private void ExportAction(ParseResult result)
+        {
+            // 读取模型
+            using var spine = new SpineObject(result.GetValue(ArgSkel)!.FullName, result.GetValue(OptAtlas)?.FullName);
+
+            // 设置模型参数
+            spine.Skeleton.ScaleX = spine.Skeleton.ScaleY = result.GetValue(OptScale);
+            spine.UsePma = result.GetValue(OptPma);
+
+            // 设置要导出的动画
+            int trackIdx = 0;
+            foreach (var name in result.GetValue(OptAnimations))
+            {
+                if (!spine.Data.AnimationsByName.ContainsKey(name))
+                {
+                    _logger.Warn("No animation named '{0}', skip it", name);
+                    continue;
+                }
+                spine.AnimationState.SetAnimation(trackIdx, name, true);
+                trackIdx++;
+            }
+
+            // 设置需要启用的皮肤
+            foreach (var name in result.GetValue(OptSkins))
+            {
+                if (!spine.SetSkinStatus(name, true))
+                {
+                    _logger.Warn("Failed to enable skin '{0}'", name);
+                }
+            }
+
+            // 设置需要屏蔽的插槽
+            foreach (var name in result.GetValue(OptDisableSlots))
+            {
+                if (!spine.SetSlotVisible(name, false))
+                {
+                    _logger.Warn("Failed to disable slot '{0}'", name);
+                }
+            }
+
+            // TODO: 设置要启用的插槽
+
+            // 时间轴处理
+            spine.Update(result.GetValue(OptTime));
+            var warmup = result.GetValue(OptWarmUp);
+            spine.Update(warmup < 0 ? spine.GetAnimationMaxDuration() : warmup);
+
+            var exporter = GetExporterFilledWithArgs(result, spine);
+
+            // 创建输出目录
+            string output = result.GetValue(OptOutput);
+            Directory.CreateDirectory(exporter is FrameSequenceExporter ? output : Path.GetDirectoryName(output));
+
+            // 挂载进度报告函数
+            if (!result.GetValue(OptNoProgress))
+            {
+                exporter.ProgressReporter = (total, done, text) =>
+                {
+                    Console.Write($"\r{text}");
+                    if (total == done) Console.WriteLine("");
+                };
+            }
+
+            // 导出
+            exporter.Export(output, spine);
+        }
+
+        private BaseExporter GetExporterFilledWithArgs(ParseResult result, SpineObject spine)
+        {
+            var formatType = (int)result.GetValue(OptFormat) >> 8;
+
+            // 根据模型获取自动分辨率和视区参数
+            var maxResolution = result.GetValue(OptMaxResolution);
+            var margin = result.GetValue(OptMargin);
+            var bounds = formatType == 0x01 ? spine.GetCurrentBounds() : spine.GetAnimationBounds(result.GetValue(OptFps));
+            var resolution = new SFML.System.Vector2u((uint)bounds.Size.X, (uint)bounds.Size.Y);
+            if (resolution.X >= maxResolution || resolution.Y >= maxResolution)
+            {
+                // 缩小到最大像素限制
+                var scale = Math.Min(maxResolution / bounds.Width, maxResolution / bounds.Height);
+                resolution.X = (uint)(bounds.Width * scale);
+                resolution.Y = (uint)(bounds.Height * scale);
+            }
+            var viewBounds = bounds.GetCanvasBounds(resolution, margin);
+
+            var duration = result.GetValue(OptDuration);
+            if (duration < 0) duration = spine.GetAnimationMaxDuration();
+
+            if (formatType == 0x01)
+            {
+                return new FrameExporter(resolution.X + margin * 2, resolution.Y + margin * 2)
+                {
+                    Size = new(viewBounds.Width, -viewBounds.Height),
+                    Center = viewBounds.Position + viewBounds.Size / 2,
+                    Rotation = 0,
+                    BackgroundColor = result.GetValue(OptColor),
+
+                    Format = result.GetValue(OptFormat) switch
+                    {
+                        ExportFormat.Png => SkiaSharp.SKEncodedImageFormat.Png,
+                        ExportFormat.Jpg => SkiaSharp.SKEncodedImageFormat.Jpeg,
+                        ExportFormat.Webp => SkiaSharp.SKEncodedImageFormat.Webp,
+                        ExportFormat.Bmp => SkiaSharp.SKEncodedImageFormat.Bmp,
+                        var v => throw new InvalidOperationException($"{v}"),
+                    },
+                    Quality = (int)result.GetValue(OptQuality),
+                };
+            }
+            else if (formatType == 0x02)
+            {
+                return new FrameSequenceExporter(resolution.X + margin * 2, resolution.Y + margin * 2)
+                {
+                    Size = new(viewBounds.Width, -viewBounds.Height),
+                    Center = viewBounds.Position + viewBounds.Size / 2,
+                    Rotation = 0,
+                    BackgroundColor = result.GetValue(OptColor),
+
+                    Fps = result.GetValue(OptFps),
+                    Speed = result.GetValue(OptSpeed),
+                    KeepLast = !result.GetValue(OptDropLastFrame),
+                    Duration = duration,
+                };
+            }
+            else if (formatType == 0x03)
+            {
+                return new FFmpegVideoExporter(resolution.X + margin * 2, resolution.Y + margin * 2)
+                {
+                    Size = new(viewBounds.Width, -viewBounds.Height),
+                    Center = viewBounds.Position + viewBounds.Size / 2,
+                    Rotation = 0,
+                    BackgroundColor = result.GetValue(OptColor),
+
+                    Fps = result.GetValue(OptFps),
+                    Speed = result.GetValue(OptSpeed),
+                    KeepLast = !result.GetValue(OptDropLastFrame),
+                    Duration = duration,
+
+                    Format = result.GetValue(OptFormat) switch
+                    {
+                        ExportFormat.Gif => FFmpegVideoExporter.VideoFormat.Gif,
+                        ExportFormat.Webpa => FFmpegVideoExporter.VideoFormat.Webp,
+                        ExportFormat.Apng => FFmpegVideoExporter.VideoFormat.Apng,
+                        ExportFormat.Mp4 => FFmpegVideoExporter.VideoFormat.Mp4,
+                        ExportFormat.Webm => FFmpegVideoExporter.VideoFormat.Webm,
+                        ExportFormat.Mkv => FFmpegVideoExporter.VideoFormat.Mkv,
+                        ExportFormat.Mov => FFmpegVideoExporter.VideoFormat.Mov,
+                        var v => throw new InvalidOperationException($"{v}"),
+                    },
+                    Quality = (int)result.GetValue(OptQuality),
+                    Loop = result.GetValue(OptLoop),
+                    Lossless = result.GetValue(OptLossless),
+                    PredMethod = result.GetValue(OptApngPredMethod),
+                    Crf = (int)result.GetValue(OptCrf),
+                    Profile = result.GetValue(OptMovProfile),
+                }
+                ;
+            }
+            else if (formatType == 0x04)
+            {
+                return new CustomFFmpegExporter(resolution.X + margin * 2, resolution.Y + margin * 2)
+                {
+                    Size = new(viewBounds.Width, -viewBounds.Height),
+                    Center = viewBounds.Position + viewBounds.Size / 2,
+                    Rotation = 0,
+                    BackgroundColor = result.GetValue(OptColor),
+
+                    Fps = result.GetValue(OptFps),
+                    Speed = result.GetValue(OptSpeed),
+                    KeepLast = !result.GetValue(OptDropLastFrame),
+                    Duration = duration,
+
+                    Format = result.GetValue(OptFFFormat),
+                    Codec = result.GetValue(OptFFCodec),
+                    PixelFormat = result.GetValue(OptFFPixelFormat),
+                    Bitrate = result.GetValue(OptFFBitrate),
+                    Filter = result.GetValue(OptFFFilter),
+                    CustomArgs = result.GetValue(OptFFArgs),
+                };
+            }
+            else
+            {
+                throw new ArgumentOutOfRangeException($"Unknown format type {formatType}");
+            }
+        }
+    }
+}
diff --git a/SpineViewerCLI/Extension.cs b/SpineViewerCLI/Extension.cs
new file mode 100644
index 0000000..b5b3257
--- /dev/null
+++ b/SpineViewerCLI/Extension.cs
@@ -0,0 +1,88 @@
+using SFML.Graphics;
+using SFML.System;
+using Spine;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    public static class Extension
+    {
+        /// <summary>
+        /// 获取一个对象副本, 继承所有状态
+        /// </summary>
+        public static SpineObject Copy(this SpineObject self, bool keepTrackTime = false)
+        {
+            var spineObject = new SpineObject(self, true);
+
+            // 拷贝轨道动画, 但是仅拷贝第一个条目
+            foreach (var tr in self.AnimationState.IterTracks().Where(t => t is not null))
+            {
+                var t = spineObject.AnimationState.SetAnimation(tr!.TrackIndex, tr.Animation, tr.Loop);
+                t.TimeScale = tr.TimeScale;
+                t.Alpha = tr.Alpha;
+                if (keepTrackTime)
+                    t.TrackTime = tr.TrackTime;
+            }
+
+            // XXX(#105): 部分 3.4.02 版本模型在设置动画后出现附件残留, 因此强制进行一次 Setup
+            if (spineObject.Version == SpineVersion.V34)
+            {
+                spineObject.Skeleton.SetSlotsToSetupPose();
+            }
+
+            spineObject.Update(0);
+            return spineObject;
+        }
+
+        /// <summary>
+        /// 获取当前状态包围盒
+        /// </summary>
+        public static FloatRect GetCurrentBounds(this SpineObject self)
+        {
+            self.Skeleton.GetBounds(out var x, out var y, out var w, out var h);
+            return new(x, y, Math.Max(w, 1e-6f), Math.Max(h, 1e-6f));
+        }
+
+        /// <summary>
+        /// 计算所有轨道第一个条目的动画时长最大值
+        /// </summary>
+        /// <param name="self"></param>
+        /// <returns></returns>
+        public static float GetAnimationMaxDuration(this SpineObject self)
+        {
+            return self.AnimationState.IterTracks().Select(t => t?.Animation.Duration ?? 0).DefaultIfEmpty(0).Max();
+        }
+
+        /// <summary>
+        /// 合并另一个矩形
+        /// </summary>
+        public static FloatRect Union(this FloatRect self, FloatRect rect)
+        {
+            float left = Math.Min(self.Left, rect.Left);
+            float top = Math.Min(self.Top, rect.Top);
+            float right = Math.Max(self.Left + self.Width, rect.Left + rect.Width);
+            float bottom = Math.Max(self.Top + self.Height, rect.Top + rect.Height);
+            return new(left, top, right - left, bottom - top);
+        }
+
+        /// <summary>
+        /// 按给定的帧率获取所有轨道第一个条目动画全时长包围盒大小, 是一个耗时操作, 如果可能的话最好缓存结果
+        /// </summary>
+        public static FloatRect GetAnimationBounds(this SpineObject self, float fps = 30)
+        {
+            using var copy = self.Copy();
+            var bounds = copy.GetCurrentBounds();
+            var maxDuration = copy.GetAnimationMaxDuration();
+            for (float tick = 0, delta = 1 / fps; tick < maxDuration; tick += delta)
+            {
+                bounds = bounds.Union(copy.GetCurrentBounds());
+                copy.Update(delta);
+            }
+            return bounds;
+        }
+    }
+}
diff --git a/SpineViewerCLI/SpineViewerCLI.cs b/SpineViewerCLI/SpineViewerCLI.cs
index 9794543..9a364d4 100644
--- a/SpineViewerCLI/SpineViewerCLI.cs
+++ b/SpineViewerCLI/SpineViewerCLI.cs
@@ -1,364 +1,85 @@
-using System.Globalization;
+using NLog;
 using SFML.Graphics;
 using SFML.System;
+using SkiaSharp;
 using Spine;
 using Spine.Exporters;
-using SkiaSharp;
+using System.CommandLine;
+using System.Globalization;
 
 namespace SpineViewerCLI
 {
-    public class CLI
+    public static class SpineViewerCLI
     {
-        const string USAGE = @"
-usage: SpineViewerCLI.exe [--skel PATH] [--atlas PATH] [--output PATH] [--animation STR] [--skin STR] [--hide-slot STR] [--pma] [--fps INT] [--loop] [--crf INT] [--time FLOAT] [--quality INT] [--width INT] [--height INT] [--centerx INT] [--centery INT] [--zoom FLOAT] [--speed FLOAT] [--color HEX] [--quiet]
-
-options:
-  --skel PATH           Path to the .skel file
-  --atlas PATH          Path to the .atlas file, default searches in the skel file directory
-  --output PATH         Output file path. Extension determines export type (.mp4, .webm for video; .png, .jpg for frame)
-  --animation STR       Animation name
-  --skin STR            Skin name to apply. Can be used multiple times to stack skins.
-  --hide-slot STR       Slot name to hide. Can be used multiple times.
-  --pma                 Use premultiplied alpha, default false
-  --fps INT             Frames per second (for video), default 24
-  --loop                Whether to loop the animation (for video), default false
-  --crf INT             Constant Rate Factor (for video), from 0 (lossless) to 51 (worst), default 23
-  --time FLOAT          Time in seconds to export a single frame. Providing this argument forces frame export mode.
-  --quality INT         Quality for lossy image formats (jpg, webp), from 0 to 100, default 80
-  --width INT           Output width, default 512
-  --height INT          Output height, default 512
-  --centerx INT         Center X offset, default automatically finds bounds
-  --centery INT         Center Y offset, default automatically finds bounds
-  --zoom FLOAT          Zoom level, default 1.0
-  --speed FLOAT         Speed of animation (for video), default 1.0
-  --color HEX           Background color as a hex RGBA color, default 000000ff (opaque black)
-  --quiet               Removes console progress log, default false
-  --warmup INT          Warm Up Physics, default 2 loops before export
-";
-
-        public static void Main(string[] args)
+        public static Option<bool> OptQuiet { get; } = new("--quiet", "-q")
         {
-            string? skelPath = null;
-            string? atlasPath = null;
-            string? output = null;
-            string? animation = null;
-            var skins = new List<string>();
-            var hideSlots = new List<string>();
-            bool pma = false;
-            uint fps = 24;
-            bool loop = false;
-            int crf = 23;
-            float? time = null;
-            int quality = 80;
-            uint? width = null;
-            uint? height = null;
-            int? centerx = null;
-            int? centery = null;
-            float zoom = 1;
-            float speed = 1;
-            Color backgroundColor = Color.Black;
-            bool quiet = false;
-            bool warmup = false;
-            int warmUpLoops = 2;
+            Description = "Suppress console logging (quiet mode).",
+            Recursive = true,
+        };
 
-            for (int i = 0; i < args.Length; i++)
+        public static int Main(string[] args)
+        {
+            InitializeFileLog();
+
+            var cmdExport = new ExportCommand();
+
+            var cmdRoot = new RootCommand("Root Command")
             {
-                switch (args[i])
-                {
-                    case "--help":
-                        Console.Write(USAGE);
-                        Environment.Exit(0);
-                        break;
-                    case "--skel":
-                        skelPath = args[++i];
-                        break;
-                    case "--atlas":
-                        atlasPath = args[++i];
-                        break;
-                    case "--output":
-                        output = args[++i];
-                        break;
-                    case "--animation":
-                        animation = args[++i];
-                        break;
-                    case "--skin":
-                        skins.Add(args[++i]);
-                        break;
-                    case "--hide-slot":
-                        hideSlots.Add(args[++i]);
-                        break;
-                    case "--pma":
-                        pma = true;
-                        break;
-                    case "--fps":
-                        fps = uint.Parse(args[++i]);
-                        break;
-                    case "--loop":
-                        loop = true;
-                        break;
-                    case "--crf":
-                        crf = int.Parse(args[++i]);
-                        break;
-                    case "--time":
-                        time = float.Parse(args[++i]);
-                        break;
-                    case "--quality":
-                        quality = int.Parse(args[++i]);
-                        break;
-                    case "--width":
-                        width = uint.Parse(args[++i]);
-                        break;
-                    case "--height":
-                        height = uint.Parse(args[++i]);
-                        break;
-                    case "--centerx":
-                        centerx = int.Parse(args[++i]);
-                        break;
-                    case "--centery":
-                        centery = int.Parse(args[++i]);
-                        break;
-                    case "--zoom":
-                        zoom = float.Parse(args[++i]);
-                        break;
-                    case "--speed":
-                        speed = float.Parse(args[++i]);
-                        break;
-                    case "--color":
-                        backgroundColor = new Color(uint.Parse(args[++i], NumberStyles.HexNumber));
-                        break;
-                    case "--quiet":
-                        quiet = true;
-                        break;
-                    case "--warmup":
-                        warmUpLoops = int.Parse(args[++i]);
-                        warmup = true;
-                        break;
-                    default:
-                        Console.Error.WriteLine($"Unknown argument: {args[i]}");
-                        Environment.Exit(2);
-                        break;
-                }
-            }
+                OptQuiet,
+                cmdExport,
+            };
 
-            if (string.IsNullOrEmpty(skelPath))
-            {
-                Console.Error.WriteLine("Missing --skel");
-                Environment.Exit(2);
-            }
-            if (string.IsNullOrEmpty(output))
-            {
-                Console.Error.WriteLine("Missing --output");
-                Environment.Exit(2);
-            }
-            var outputExtension = Path.GetExtension(output).TrimStart('.').ToLowerInvariant();
+            var result = cmdRoot.Parse(args);
 
-            var sp = new SpineObject(skelPath, atlasPath);
-            sp.UsePma = pma;
+            if (!result.GetValue(OptQuiet))
+                InitializeConsoleLog();
 
-            foreach (var skinName in skins)
-            {
-                if (!sp.SetSkinStatus(skinName, true))
-                {
-                    var availableSkins = string.Join(", ", sp.Data.Skins.Select(s => s.Name));
-                    Console.Error.WriteLine($"Error: Skin '{skinName}' not found. Available skins: {availableSkins}");
-                    Environment.Exit(2);
-                }
-            }
-
-            if (string.IsNullOrEmpty(animation))
-            {
-                var availableAnimations = string.Join(", ", sp.Data.Animations.Select(a => a.Name));
-                Console.Error.WriteLine($"Missing --animation. Available animations for {sp.Name}: {availableAnimations}");
-                Environment.Exit(2);
-            }
-
-            var trackEntry = sp.AnimationState.SetAnimation(0, animation, loop);
-            if (time.HasValue)
-            {
-                trackEntry.TrackTime = time.Value;
-            }
-            sp.Update(0);
-
-            if (warmup)
-            {
-                sp.Update(trackEntry.Animation.Duration * warmUpLoops);
-            }
-
-            foreach (var slotName in hideSlots)
-            {
-                if (!sp.SetSlotVisible(slotName, false))
-                {
-                    if (!quiet) Console.WriteLine($"Warning: Slot '{slotName}' not found, cannot hide.");
-                }
-            }
-
-            if (time.HasValue)
-            {
-                if (TryGetImageFormat(outputExtension, out var imageFormat))
-                {
-                    if (!quiet) Console.WriteLine($"Exporting single frame at {time.Value:F2}s to {output}...");
-
-                    FrameExporter exporter;
-                    if (width is uint w && height is uint h && centerx is int cx && centery is int cy)
-                    {
-                        exporter = new FrameExporter(w, h)
-                        {
-                            Center = (cx, cy),
-                            Size = (w / zoom, -h / zoom),
-                        };
-                    }
-                    else
-                    {
-                        var frameBounds = GetSpineObjectBounds(sp);
-                        var bounds = GetFloatRectCanvasBounds(frameBounds, new(width ?? 512, height ?? 512));
-                        exporter = new FrameExporter(width ?? (uint)Math.Ceiling(bounds.Width), height ?? (uint)Math.Ceiling(bounds.Height))
-                        {
-                            Center = bounds.Position + bounds.Size / 2,
-                            Size = (bounds.Width, -bounds.Height),
-                        };
-                    }
-                    exporter.Format = imageFormat;
-                    exporter.Quality = quality;
-                    exporter.BackgroundColor = backgroundColor;
-
-                    exporter.Export(output, sp);
-
-                    if (!quiet)
-                        Console.WriteLine("Frame export complete.");
-                }
-                else
-                {
-                    var validImageExtensions = "png, jpg, jpeg, webp, bmp";
-                    Console.Error.WriteLine($"Error: --time argument requires a valid image format extension. Supported formats are: {validImageExtensions}.");
-                    Environment.Exit(2);
-                }
-            }
-            else if (Enum.TryParse<FFmpegVideoExporter.VideoFormat>(outputExtension, true, out var videoFormat))
-            {
-                FFmpegVideoExporter exporter;
-                if (width is uint w && height is uint h && centerx is int cx && centery is int cy)
-                {
-                    exporter = new FFmpegVideoExporter(w, h)
-                    {
-                        Center = (cx, cy),
-                        Size = (w / zoom, -h / zoom),
-                    };
-                }
-                else
-                {
-                    var bounds = GetFloatRectCanvasBounds(GetSpineObjectAnimationBounds(sp, fps), new(width ?? 512, height ?? 512));
-                    exporter = new FFmpegVideoExporter(width ?? (uint)Math.Ceiling(bounds.Width), height ?? (uint)Math.Ceiling(bounds.Height))
-                    {
-                        Center = bounds.Position + bounds.Size / 2,
-                        Size = (bounds.Width, -bounds.Height),
-                    };
-                }
-                exporter.Duration = trackEntry.Animation.Duration;
-                exporter.Fps = fps;
-                exporter.Format = videoFormat;
-                exporter.Loop = loop;
-                exporter.Crf = crf;
-                exporter.Speed = speed;
-                exporter.BackgroundColor = backgroundColor;
-
-                if (!quiet)
-                    exporter.ProgressReporter = (total, done, text) => Console.Write($"\r{text}");
-
-                using var cts = new CancellationTokenSource();
-                exporter.Export(output, cts.Token, sp);
-
-                if (!quiet)
-                    Console.WriteLine("\nVideo export complete.");
-            }
-            else
-            {
-                var validVideoExtensions = string.Join(", ", Enum.GetNames(typeof(FFmpegVideoExporter.VideoFormat)));
-                var validImageExtensions = "png, jpg, jpeg, webp, bmp";
-                Console.Error.WriteLine($"Invalid output extension or missing --time for image export. Supported video formats are: {validVideoExtensions}. Supported image formats (with --time) are: {validImageExtensions}.");
-                Environment.Exit(2);
-            }
-
-            Environment.Exit(0);
+            return result.Invoke();
         }
 
-        private static bool TryGetImageFormat(string extension, out SKEncodedImageFormat format)
+        private static void InitializeFileLog()
         {
-            switch (extension)
+            var config = new NLog.Config.LoggingConfiguration();
+            var fileTarget = new NLog.Targets.FileTarget("fileTarget")
             {
-                case "png":
-                    format = SKEncodedImageFormat.Png;
-                    return true;
-                case "jpg":
-                case "jpeg":
-                    format = SKEncodedImageFormat.Jpeg;
-                    return true;
-                case "webp":
-                    format = SKEncodedImageFormat.Webp;
-                    return true;
-                case "bmp":
-                    format = SKEncodedImageFormat.Bmp;
-                    return true;
-                default:
-                    format = default;
-                    return false;
-            }
+                Encoding = System.Text.Encoding.UTF8,
+                Layout = "${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${level:uppercase=true} - ${processid} - ${callsite-filename:includeSourcePath=false}:${callsite-linenumber} - ${message}",
+                AutoFlush = true,
+                FileName = "${basedir}/logs/cli.log",
+                ArchiveFileName = "${basedir}/logs/cli.{#}.log",
+                ArchiveNumbering = NLog.Targets.ArchiveNumberingMode.Rolling,
+                ArchiveAboveSize = 1048576,
+                MaxArchiveFiles = 5,
+                ConcurrentWrites = true,
+                KeepFileOpen = false,
+            };
+
+            config.AddTarget(fileTarget);
+            config.AddRule(LogLevel.Trace, LogLevel.Fatal, fileTarget);
+            LogManager.Configuration = config;
         }
 
-        public static SpineObject CopySpineObject(SpineObject sp)
+        private static void InitializeConsoleLog()
         {
-            var spineObject = new SpineObject(sp, true);
-            foreach (var tr in sp.AnimationState.IterTracks().Where(t => t is not null))
+            var config = new NLog.Config.LoggingConfiguration();
+            var consoleTarget = new NLog.Targets.ColoredConsoleTarget("consoleTarget")
             {
-                var t = spineObject.AnimationState.SetAnimation(tr!.TrackIndex, tr.Animation, tr.Loop);
-            }
-            spineObject.Update(0);
-            return spineObject;
-        }
+                Encoding = System.Text.Encoding.UTF8,
+                Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}",
+                AutoFlush = true,
+                DetectConsoleAvailable = true,
+                StdErr = true,
+                DetectOutputRedirected = true,
+            };
 
-        static FloatRect GetSpineObjectBounds(SpineObject sp)
-        {
-            sp.Skeleton.GetBounds(out var x, out var y, out var w, out var h);
-            return new(x, y, Math.Max(w, 1e-6f), Math.Max(h, 1e-6f));
-        }
-        static FloatRect FloatRectUnion(FloatRect a, FloatRect b)
-        {
-            float left = Math.Min(a.Left, b.Left);
-            float top = Math.Min(a.Top, b.Top);
-            float right = Math.Max(a.Left + a.Width, b.Left + b.Width);
-            float bottom = Math.Max(a.Top + a.Height, b.Top + b.Height);
-            return new FloatRect(left, top, right - left, bottom - top);
-        }
-        static FloatRect GetSpineObjectAnimationBounds(SpineObject sp, float fps = 10)
-        {
-            sp = CopySpineObject(sp);
-            var bounds = GetSpineObjectBounds(sp);
-            var maxDuration = sp.AnimationState.IterTracks().Select(t => t?.Animation.Duration ?? 0).DefaultIfEmpty(0).Max();
-            sp.Update(0);
-            for (float tick = 0, delta = 1 / fps; tick < maxDuration; tick += delta)
-            {
-                bounds = FloatRectUnion(bounds, GetSpineObjectBounds(sp));
-                sp.Update(delta);
-            }
-            return bounds;
-        }
-        static FloatRect GetFloatRectCanvasBounds(FloatRect rect, Vector2u resolution)
-        {
-            float sizeW = rect.Width;
-            float sizeH = rect.Height;
-            float innerW = resolution.X;
-            float innerH = resolution.Y;
-            var scale = Math.Max(Math.Abs(sizeW / innerW), Math.Abs(sizeH / innerH));
-            var scaleW = scale * Math.Sign(sizeW);
-            var scaleH = scale * Math.Sign(sizeH);
+            consoleTarget.RowHighlightingRules.Add(new("level == LogLevel.Info", NLog.Targets.ConsoleOutputColor.DarkGray, NLog.Targets.ConsoleOutputColor.NoChange));
+            consoleTarget.RowHighlightingRules.Add(new("level == LogLevel.Warn", NLog.Targets.ConsoleOutputColor.DarkYellow, NLog.Targets.ConsoleOutputColor.NoChange));
+            consoleTarget.RowHighlightingRules.Add(new("level == LogLevel.Error", NLog.Targets.ConsoleOutputColor.Red, NLog.Targets.ConsoleOutputColor.NoChange));
+            consoleTarget.RowHighlightingRules.Add(new("level == LogLevel.Fatal", NLog.Targets.ConsoleOutputColor.White, NLog.Targets.ConsoleOutputColor.DarkRed));
 
-            innerW *= scaleW;
-            innerH *= scaleH;
-
-            var x = rect.Left - (innerW - sizeW) / 2;
-            var y = rect.Top - (innerH - sizeH) / 2;
-            var w = resolution.X * scaleW;
-            var h = resolution.Y * scaleH;
-            return new(x, y, w, h);
+            config.AddTarget(consoleTarget);
+            config.AddRule(LogLevel.Info, LogLevel.Fatal, consoleTarget);
+            LogManager.Configuration = config;
         }
     }
 }
diff --git a/SpineViewerCLI/SpineViewerCLI.csproj b/SpineViewerCLI/SpineViewerCLI.csproj
index 6184551..d34e33f 100644
--- a/SpineViewerCLI/SpineViewerCLI.csproj
+++ b/SpineViewerCLI/SpineViewerCLI.csproj
@@ -16,6 +16,7 @@
     </PropertyGroup>
 
     <ItemGroup>
+      <PackageReference Include="NLog" Version="5.4.0" />
       <PackageReference Include="System.CommandLine" Version="2.0.0-rc.2.25502.107" />
     </ItemGroup>
 
diff --git a/SpineViewerCLI/Utils.cs b/SpineViewerCLI/Utils.cs
new file mode 100644
index 0000000..8877f4f
--- /dev/null
+++ b/SpineViewerCLI/Utils.cs
@@ -0,0 +1,67 @@
+using SFML.Graphics;
+using System;
+using System.Collections.Generic;
+using System.CommandLine.Parsing;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    public static class Utils
+    {
+        public static Color ParseColor(ArgumentResult result)
+        {
+            var token = result.Tokens.Count > 0 ? result.Tokens[0].Value : null;
+            if (string.IsNullOrWhiteSpace(token))
+                return Color.Black;
+
+            try
+            {
+                // 去掉开头的 #
+                var hex = token.Trim().TrimStart('#');
+
+                // 支持格式: RGB / ARGB / RRGGBB / AARRGGBB
+                if (hex.Length == 3)
+                {
+                    // #RGB → #RRGGBB
+                    var r = hex[0];
+                    var g = hex[1];
+                    var b = hex[2];
+                    hex = $"{r}{r}{g}{g}{b}{b}";
+                    hex = "FF" + hex; // 加上不透明 alpha
+                }
+                else if (hex.Length == 4)
+                {
+                    // #ARGB → #AARRGGBB
+                    var a = hex[0];
+                    var r = hex[1];
+                    var g = hex[2];
+                    var b = hex[3];
+                    hex = $"{a}{a}{r}{r}{g}{g}{b}{b}";
+                }
+                else if (hex.Length == 6)
+                {
+                    // #RRGGBB → #AARRGGBB
+                    hex = "FF" + hex;
+                }
+                else if (hex.Length != 8)
+                {
+                    result.AddError("Invalid color format. Use #RGB, #ARGB, #RRGGBB, or #AARRGGBB.");
+                    return Color.Black;
+                }
+
+                var aVal = Convert.ToByte(hex[..2], 16);
+                var rVal = Convert.ToByte(hex.Substring(2, 2), 16);
+                var gVal = Convert.ToByte(hex.Substring(4, 2), 16);
+                var bVal = Convert.ToByte(hex.Substring(6, 2), 16);
+                return new(rVal, gVal, bVal, aVal);
+            }
+            catch
+            {
+                result.AddError("Invalid color format.");
+                return Color.Black;
+            }
+        }
+    }
+}

From 81d92246584945e88568b68ec5d9600036999f40 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 16:22:49 +0800
Subject: [PATCH 10/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E9=AA=8C=E8=AF=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 35c7900..a2289a9 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -255,14 +255,19 @@ namespace SpineViewerCLI
             };
             OptScale.Validators.Add(r =>
             {
-                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var val) && val < 0)
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var v) && v < 0)
                     r.AddError($"{OptScale.Name} must be non-negative.");
             });
             OptTime.Validators.Add(r =>
             {
-                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var val) && val < 0)
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var v) && v < 0)
                     r.AddError($"{OptTime.Name} must be non-negative.");
             });
+            OptSpeed.Validators.Add(r =>
+            {
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var v) && v < 0)
+                    r.AddError($"{OptSpeed.Name} must be non-negative.");
+            });
 
             // 用反射查找自己所有的公开属性是 Argument 或者 Option 的
             foreach (var prop in GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))

From f878530184b953cbbcc9ca47c431cfdd14fe0f32 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 16:30:13 +0800
Subject: [PATCH 11/30] =?UTF-8?q?=E9=87=8D=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs |  9 +--------
 SpineViewerCLI/Extension.cs     | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index a2289a9..2af94ef 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -269,14 +269,7 @@ namespace SpineViewerCLI
                     r.AddError($"{OptSpeed.Name} must be non-negative.");
             });
 
-            // 用反射查找自己所有的公开属性是 Argument 或者 Option 的
-            foreach (var prop in GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
-            {
-                var value = prop.GetValue(this);
-                if (value is Argument arg) Add(arg);
-                else if (value is Option opt) Add(opt);
-            }
-
+            this.AddArgsAndOpts();
             SetAction(ExportAction);
         }
 
diff --git a/SpineViewerCLI/Extension.cs b/SpineViewerCLI/Extension.cs
index b5b3257..87d1a91 100644
--- a/SpineViewerCLI/Extension.cs
+++ b/SpineViewerCLI/Extension.cs
@@ -3,7 +3,9 @@ using SFML.System;
 using Spine;
 using System;
 using System.Collections.Generic;
+using System.CommandLine;
 using System.Linq;
+using System.Reflection;
 using System.Text;
 using System.Threading.Tasks;
 
@@ -84,5 +86,20 @@ namespace SpineViewerCLI
             }
             return bounds;
         }
+
+        /// <summary>
+        /// 自动添加所有能找到的类型是 <see cref="Argument"/> 或者 <see cref="Option"/> 的公开属性
+        /// </summary>
+        /// <param name="self"></param>
+        public static void AddArgsAndOpts(this Command self)
+        {
+            // 用反射查找自己所有的公开属性是 Argument 或者 Option 的
+            foreach (var prop in self.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance))
+            {
+                var value = prop.GetValue(self);
+                if (value is Argument arg) self.Add(arg);
+                else if (value is Option opt) self.Add(opt);
+            }
+        }
     }
 }

From 5eba515eacdefd8e388fd9e9066306dcdfdb6e0d Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 17:31:20 +0800
Subject: [PATCH 12/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20query=20=E5=91=BD?=
 =?UTF-8?q?=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/QueryCommand.cs   | 121 +++++++++++++++++++++++++++++++
 SpineViewerCLI/SpineViewerCLI.cs |   2 +
 2 files changed, 123 insertions(+)
 create mode 100644 SpineViewerCLI/QueryCommand.cs

diff --git a/SpineViewerCLI/QueryCommand.cs b/SpineViewerCLI/QueryCommand.cs
new file mode 100644
index 0000000..c460af5
--- /dev/null
+++ b/SpineViewerCLI/QueryCommand.cs
@@ -0,0 +1,121 @@
+using NLog;
+using Spine;
+using System;
+using System.Collections.Generic;
+using System.CommandLine;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    public class QueryCommand : Command
+    {
+        private static readonly Logger _logger = LogManager.GetCurrentClassLogger();
+        private static readonly string _name = "query";
+        private static readonly string _desc = "Query information of single model";
+
+        private static readonly string HalfHeader = new('>', 15);
+        private static readonly char Separator = '\t';
+
+        public Argument<FileInfo> ArgSkel { get; } = new("skel")
+        {
+            Description = "Path of skel file.",
+        };
+
+        public Option<FileInfo> OptAtlas { get; } = new("--atlas")
+        {
+            Description = "Path to the atlas file that matches the skel file.",
+        };
+
+        public Option<bool> OptAll { get; } = new("--all")
+        {
+            Description = "Print all information",
+        };
+
+        public Option<bool> OptSkin { get; } = new("--skin")
+        {
+            Description = "Print skins",
+        };
+
+        public Option<bool> OptAnimation { get; } = new("--animation")
+        {
+            Description = "Print animations",
+        };
+
+        public Option<bool> OptSlot { get; } = new("--slot")
+        {
+            Description = "Print slots",
+        };
+
+        public QueryCommand() : base(_name, _desc)
+        {
+            this.AddArgsAndOpts();
+            SetAction(QueryAction);
+        }
+
+        private void QueryAction(ParseResult result)
+        {
+            // 读取模型
+            using var spine = new SpineObject(result.GetValue(ArgSkel)!.FullName, result.GetValue(OptAtlas)?.FullName);
+
+            var all = result.GetValue(OptAll);
+
+            if (all || result.GetValue(OptSkin))
+            {
+                SkinRecord[] data = spine.Data.SkinsByName.Keys.Select(v => new SkinRecord(v)).ToArray();
+                PrintData("Skins", SkinRecord.Headers, data);
+            }
+            if (all || result.GetValue(OptAnimation))
+            {
+                AnimationRecord[] data = spine.Data.Animations.Select(v => new AnimationRecord(v.Name, v.Duration)).ToArray();
+                PrintData("Animations", AnimationRecord.Headers, data);
+            }
+            if (all || result.GetValue(OptSlot))
+            {
+                SlotRecord[] data = spine.Data.SlotAttachments.Select(v => new SlotRecord(v.Key, v.Value.Keys.ToArray())).ToArray();
+                PrintData("Slots", SlotRecord.Headers, data);
+            }
+        }
+
+        private void PrintData(string dataName, string[] headers, RowRecord[] rows)
+        {
+            var header = $"{HalfHeader} {dataName} {HalfHeader}";
+            var footer = new string('<', header.Length);
+
+            Console.WriteLine(header);
+            Console.WriteLine(string.Join(Separator, headers));
+            foreach (var row in rows) 
+                Console.WriteLine(string.Join(Separator, row.Values));
+            Console.WriteLine(footer);
+        }
+
+    }
+
+    public abstract record RowRecord
+    {
+        public abstract object[] Values { get; }
+    }
+
+    public record SkinRecord(string Name) : RowRecord
+    {
+        public static string[] Headers { get; } = [nameof(Name)];
+
+        public override object[] Values => [Name];
+    }
+
+    public record AnimationRecord(string Name, float Duration) : RowRecord
+    {
+        public static string[] Headers { get; } = [nameof(Name), nameof(Duration)];
+
+        public override object[] Values => [Name, Duration];
+    }
+
+    public record SlotRecord(string Name, string[] Attachments) : RowRecord
+    {
+        public static string[] Headers { get; } = [nameof(Name), nameof(Attachments)];
+
+        public override object[] Values => [Name, string.Join(';', Attachments)];
+    }
+}
diff --git a/SpineViewerCLI/SpineViewerCLI.cs b/SpineViewerCLI/SpineViewerCLI.cs
index 9a364d4..b8fd01a 100644
--- a/SpineViewerCLI/SpineViewerCLI.cs
+++ b/SpineViewerCLI/SpineViewerCLI.cs
@@ -21,11 +21,13 @@ namespace SpineViewerCLI
         {
             InitializeFileLog();
 
+            var cmdQuery = new QueryCommand();
             var cmdExport = new ExportCommand();
 
             var cmdRoot = new RootCommand("Root Command")
             {
                 OptQuiet,
+                cmdQuery,
                 cmdExport,
             };
 

From e14c54c3a4b41a2526b7112c7de47ecfa131bc08 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 17:35:51 +0800
Subject: [PATCH 13/30] =?UTF-8?q?=E8=B0=83=E6=95=B4=E6=97=B6=E9=97=B4?=
 =?UTF-8?q?=E8=BD=B4=E5=A4=84=E7=90=86=E9=A1=BA=E5=BA=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 2af94ef..54f1ece 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -316,9 +316,9 @@ namespace SpineViewerCLI
             // TODO: 设置要启用的插槽
 
             // 时间轴处理
-            spine.Update(result.GetValue(OptTime));
             var warmup = result.GetValue(OptWarmUp);
             spine.Update(warmup < 0 ? spine.GetAnimationMaxDuration() : warmup);
+            spine.Update(result.GetValue(OptTime));
 
             var exporter = GetExporterFilledWithArgs(result, spine);
 

From cc6d1b6c005be5bc60882b16d42d8c27c7473fb9 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 19:35:43 +0800
Subject: [PATCH 14/30] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=B3=A8=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 54f1ece..058f8dd 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -57,7 +57,7 @@ namespace SpineViewerCLI
 
         public Option<string[]> OptAnimations { get; } = new("--animations", "-a")
         {
-            Description = "Animations to export. Supports multiple entries, placed in order on tracks starting from 0。",
+            Description = "Animations to export. Supports multiple entries, placed in order on tracks starting from 0.",
             Required = true,
             Arity = ArgumentArity.OneOrMore,
             AllowMultipleArgumentsPerToken = true,

From 997d55350d7df2647486425699d618b124f6b884 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 21:28:11 +0800
Subject: [PATCH 15/30] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E5=8F=AF=E8=83=BD?=
 =?UTF-8?q?=E7=9A=84=E8=B5=84=E6=BA=90=E6=B3=84=E9=9C=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 058f8dd..9d819c0 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -320,7 +320,7 @@ namespace SpineViewerCLI
             spine.Update(warmup < 0 ? spine.GetAnimationMaxDuration() : warmup);
             spine.Update(result.GetValue(OptTime));
 
-            var exporter = GetExporterFilledWithArgs(result, spine);
+            using var exporter = GetExporterFilledWithArgs(result, spine);
 
             // 创建输出目录
             string output = result.GetValue(OptOutput);

From 31daed9e81799eae49ac354f6ad8d31fe74f80ca Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 21:49:58 +0800
Subject: [PATCH 16/30] =?UTF-8?q?=E7=A7=BB=E9=99=A4=E4=B8=8D=E5=8F=97?=
 =?UTF-8?q?=E6=94=AF=E6=8C=81=E7=9A=84=E5=9B=BE=E5=83=8F=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FrameExporter.cs              | 29 ++++++++++++++++++-
 .../Exporters/FrameExporterViewModel.cs       |  6 +++-
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/Spine/Exporters/FrameExporter.cs b/Spine/Exporters/FrameExporter.cs
index f73f202..9ec7198 100644
--- a/Spine/Exporters/FrameExporter.cs
+++ b/Spine/Exporters/FrameExporter.cs
@@ -18,7 +18,23 @@ namespace Spine.Exporters
         public FrameExporter(uint width = 100, uint height = 100) : base(width, height) { }
         public FrameExporter(Vector2u resolution) : base(resolution) { }
 
-        public SKEncodedImageFormat Format { get => _format; set => _format = value; }
+        public SKEncodedImageFormat Format 
+        { 
+            get => _format; 
+            set {
+                switch (value)
+                {
+                    case SKEncodedImageFormat.Jpeg:
+                    case SKEncodedImageFormat.Png:
+                    case SKEncodedImageFormat.Webp:
+                        _format = value;
+                        break;
+                    default:
+                        _logger.Warn("Omit unsupported exporter format: {0}", value);
+                        break;
+                }
+            }
+        }
         protected SKEncodedImageFormat _format = SKEncodedImageFormat.Png;
 
         public int Quality { get => _quality; set => _quality = Math.Clamp(value, 0, 100); }
@@ -33,5 +49,16 @@ namespace Spine.Exporters
             using var stream = File.OpenWrite(output);
             data.SaveTo(stream);
         }
+
+        /// <summary>
+        /// 获取画面数据, 正常像素, 非预乘
+        /// </summary>
+        public SKData Export(params SpineObject[] spines)
+        {
+            using var frame = GetFrame(spines);
+            var info = new SKImageInfo(frame.Width, frame.Height, SKColorType.Rgba8888, SKAlphaType.Premul);
+            using var skImage = SKImage.FromPixelCopy(info, frame.Image.Pixels);
+            return skImage.Encode(SKEncodedImageFormat.Png, 100);
+        }
     }
 }
diff --git a/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs b/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
index 5a27099..4157131 100644
--- a/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
+++ b/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
@@ -20,7 +20,11 @@ namespace SpineViewer.ViewModels.Exporters
 {
     public class FrameExporterViewModel(MainWindowViewModel vmMain) : BaseExporterViewModel(vmMain)
     {
-        public static ImmutableArray<SKEncodedImageFormat> FrameFormatOptions { get; } = Enum.GetValues<SKEncodedImageFormat>().ToImmutableArray();
+        public static ImmutableArray<SKEncodedImageFormat> FrameFormatOptions { get; } = [
+            SKEncodedImageFormat.Png, 
+            SKEncodedImageFormat.Webp,
+            SKEncodedImageFormat.Jpeg,
+        ];
 
         public SKEncodedImageFormat Format { get => _format; set => SetProperty(ref _format, value); }
         protected SKEncodedImageFormat _format = SKEncodedImageFormat.Png;

From c02cec9a18f84e59c65e7e14ca6efe8f8bd39ac9 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 22:01:40 +0800
Subject: [PATCH 17/30] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=9B=BE=E5=83=8F?=
 =?UTF-8?q?=E8=B4=A8=E9=87=8F=E9=BB=98=E8=AE=A4=E5=80=BC=E4=B8=BA100?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FrameExporter.cs                         | 9 ++++-----
 .../ViewModels/Exporters/FrameExporterViewModel.cs       | 2 +-
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/Spine/Exporters/FrameExporter.cs b/Spine/Exporters/FrameExporter.cs
index 9ec7198..e9b4806 100644
--- a/Spine/Exporters/FrameExporter.cs
+++ b/Spine/Exporters/FrameExporter.cs
@@ -38,7 +38,7 @@ namespace Spine.Exporters
         protected SKEncodedImageFormat _format = SKEncodedImageFormat.Png;
 
         public int Quality { get => _quality; set => _quality = Math.Clamp(value, 0, 100); }
-        protected int _quality = 80;
+        protected int _quality = 100;
 
         public override void Export(string output, params SpineObject[] spines)
         {
@@ -51,14 +51,13 @@ namespace Spine.Exporters
         }
 
         /// <summary>
-        /// 获取画面数据, 正常像素, 非预乘
+        /// 获取帧图像, 结果是预乘的
         /// </summary>
-        public SKData Export(params SpineObject[] spines)
+        public SKImage Export(params SpineObject[] spines)
         {
             using var frame = GetFrame(spines);
             var info = new SKImageInfo(frame.Width, frame.Height, SKColorType.Rgba8888, SKAlphaType.Premul);
-            using var skImage = SKImage.FromPixelCopy(info, frame.Image.Pixels);
-            return skImage.Encode(SKEncodedImageFormat.Png, 100);
+            return SKImage.FromPixelCopy(info, frame.Image.Pixels);
         }
     }
 }
diff --git a/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs b/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
index 4157131..839805c 100644
--- a/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
+++ b/SpineViewer/ViewModels/Exporters/FrameExporterViewModel.cs
@@ -30,7 +30,7 @@ namespace SpineViewer.ViewModels.Exporters
         protected SKEncodedImageFormat _format = SKEncodedImageFormat.Png;
 
         public int Quality { get => _quality; set => SetProperty(ref _quality, Math.Clamp(value, 0, 100)); }
-        protected int _quality = 80;
+        protected int _quality = 100;
 
         private string FormatSuffix
         {

From aace461ae013143fea1ef944716c8a29efc30347 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 22:05:48 +0800
Subject: [PATCH 18/30] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=96=B9=E6=B3=95?=
 =?UTF-8?q?=E5=90=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FrameExporter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Spine/Exporters/FrameExporter.cs b/Spine/Exporters/FrameExporter.cs
index e9b4806..7af0b5c 100644
--- a/Spine/Exporters/FrameExporter.cs
+++ b/Spine/Exporters/FrameExporter.cs
@@ -53,7 +53,7 @@ namespace Spine.Exporters
         /// <summary>
         /// 获取帧图像, 结果是预乘的
         /// </summary>
-        public SKImage Export(params SpineObject[] spines)
+        public SKImage ExportMemoryImage(params SpineObject[] spines)
         {
             using var frame = GetFrame(spines);
             var info = new SKImageInfo(frame.Width, frame.Height, SKColorType.Rgba8888, SKAlphaType.Premul);

From a61bb43250768e26181d34d341ed2d573d2f7eec Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 22:14:34 +0800
Subject: [PATCH 19/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0preview=E5=91=BD?=
 =?UTF-8?q?=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/PreviewCommand.cs     | 133 +++++++++++++++++++++++++++
 SpineViewerCLI/SpineViewerCLI.cs     |  11 +--
 SpineViewerCLI/SpineViewerCLI.csproj |   2 +
 3 files changed, 139 insertions(+), 7 deletions(-)
 create mode 100644 SpineViewerCLI/PreviewCommand.cs

diff --git a/SpineViewerCLI/PreviewCommand.cs b/SpineViewerCLI/PreviewCommand.cs
new file mode 100644
index 0000000..8b0fa56
--- /dev/null
+++ b/SpineViewerCLI/PreviewCommand.cs
@@ -0,0 +1,133 @@
+using NLog;
+using Spectre.Console;
+using Spine;
+using Spine.Exporters;
+using System;
+using System.Collections.Generic;
+using System.CommandLine;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    public class PreviewCommand : Command
+    {
+        private static readonly Logger _logger = LogManager.GetCurrentClassLogger();
+        private static readonly string _name = "preview";
+        private static readonly string _desc = "Preview a model";
+        private static readonly int MaxResolution = 1024;
+
+        public Argument<FileInfo> ArgSkel { get; } = new("skel")
+        {
+            Description = "Path of skel file.",
+        };
+
+        public Option<FileInfo> OptAtlas { get; } = new("--atlas")
+        {
+            Description = "Path to the atlas file that matches the skel file.",
+        };
+
+        public Option<bool> OptPma { get; } = new("--pma")
+        {
+            Description = "Specifies whether the texture uses PMA (premultiplied alpha) format.",
+        };
+
+        public Option<string[]> OptSkins { get; } = new("--skins")
+        {
+            Description = "Skins to enable. Multiple skins can be specified.",
+            Arity = ArgumentArity.OneOrMore,
+            AllowMultipleArgumentsPerToken = true,
+        };
+
+        public Option<string[]> OptAnimations { get; } = new("--animations")
+        {
+            Description = "Animations to export. Supports multiple entries, placed in order on tracks starting from 0.",
+            Arity = ArgumentArity.OneOrMore,
+            AllowMultipleArgumentsPerToken = true,
+        };
+
+        public Option<float> OptTime { get; } = new("--time")
+        {
+            Description = "Start time offset of the animation.",
+            DefaultValueFactory = _ => 0f,
+        };
+
+        public PreviewCommand() : base(_name, _desc)
+        {
+            OptTime.Validators.Add(r =>
+            {
+                if (r.Tokens.Count > 0 && float.TryParse(r.Tokens[0].Value, out var v) && v < 0)
+                    r.AddError($"{OptTime.Name} must be non-negative.");
+            });
+
+            this.AddArgsAndOpts();
+            SetAction(PreviewAction);
+        }
+
+        private void PreviewAction(ParseResult result)
+        {
+            // 读取模型
+            using var spine = new SpineObject(result.GetValue(ArgSkel)!.FullName, result.GetValue(OptAtlas)?.FullName);
+
+            spine.UsePma = result.GetValue(OptPma);
+
+            // 设置要导出的动画
+            int trackIdx = 0;
+            foreach (var name in result.GetValue(OptAnimations))
+            {
+                if (!spine.Data.AnimationsByName.ContainsKey(name))
+                {
+                    _logger.Warn("No animation named '{0}', skip it", name);
+                    continue;
+                }
+                spine.AnimationState.SetAnimation(trackIdx, name, true);
+                trackIdx++;
+            }
+
+            // 设置需要启用的皮肤
+            foreach (var name in result.GetValue(OptSkins))
+            {
+                if (!spine.SetSkinStatus(name, true))
+                {
+                    _logger.Warn("Failed to enable skin '{0}'", name);
+                }
+            }
+
+            // 设置时间偏移量
+            spine.Update(result.GetValue(OptTime));
+
+            using var exporter = GetExporterFilledWithArgs(result, spine);
+            using var skImage = exporter.ExportMemoryImage(spine);
+            using var skData = skImage.Encode();
+            var img = new CanvasImage(skData.AsSpan());
+            AnsiConsole.Write(img);
+        }
+
+        private FrameExporter GetExporterFilledWithArgs(ParseResult result, SpineObject spine)
+        {
+            // 根据模型获取自动分辨率和视区参数
+            var bounds = spine.GetCurrentBounds();
+            var resolution = new SFML.System.Vector2u((uint)bounds.Size.X, (uint)bounds.Size.Y);
+            if (resolution.X >= MaxResolution || resolution.Y >= MaxResolution)
+            {
+                // 缩小到最大像素限制
+                var scale = Math.Min(MaxResolution / bounds.Width, MaxResolution / bounds.Height);
+                resolution.X = (uint)(bounds.Width * scale);
+                resolution.Y = (uint)(bounds.Height * scale);
+            }
+            var viewBounds = bounds.GetCanvasBounds(resolution);
+
+            return new FrameExporter(resolution)
+            {
+                Size = new(viewBounds.Width, -viewBounds.Height),
+                Center = viewBounds.Position + viewBounds.Size / 2,
+                Rotation = 0,
+                BackgroundColor = SFML.Graphics.Color.Transparent,
+
+                Format = SkiaSharp.SKEncodedImageFormat.Png,
+                Quality = 100,
+            };
+        }
+    }
+}
diff --git a/SpineViewerCLI/SpineViewerCLI.cs b/SpineViewerCLI/SpineViewerCLI.cs
index b8fd01a..8615ad9 100644
--- a/SpineViewerCLI/SpineViewerCLI.cs
+++ b/SpineViewerCLI/SpineViewerCLI.cs
@@ -1,7 +1,6 @@
 using NLog;
-using SFML.Graphics;
-using SFML.System;
 using SkiaSharp;
+using Spectre.Console;
 using Spine;
 using Spine.Exporters;
 using System.CommandLine;
@@ -21,14 +20,12 @@ namespace SpineViewerCLI
         {
             InitializeFileLog();
 
-            var cmdQuery = new QueryCommand();
-            var cmdExport = new ExportCommand();
-
             var cmdRoot = new RootCommand("Root Command")
             {
                 OptQuiet,
-                cmdQuery,
-                cmdExport,
+                new QueryCommand(),
+                new PreviewCommand(),
+                new ExportCommand(),
             };
 
             var result = cmdRoot.Parse(args);
diff --git a/SpineViewerCLI/SpineViewerCLI.csproj b/SpineViewerCLI/SpineViewerCLI.csproj
index d34e33f..a40d269 100644
--- a/SpineViewerCLI/SpineViewerCLI.csproj
+++ b/SpineViewerCLI/SpineViewerCLI.csproj
@@ -17,6 +17,8 @@
 
     <ItemGroup>
       <PackageReference Include="NLog" Version="5.4.0" />
+      <PackageReference Include="Spectre.Console" Version="0.52.0" />
+      <PackageReference Include="Spectre.Console.ImageSharp" Version="0.52.0" />
       <PackageReference Include="System.CommandLine" Version="2.0.0-rc.2.25502.107" />
     </ItemGroup>
 

From 5498508700dd5c0cdf48ff7a49996092e336205a Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 23:16:40 +0800
Subject: [PATCH 20/30] =?UTF-8?q?=E7=A7=BB=E9=99=A4=E4=B8=8D=E5=8F=97?=
 =?UTF-8?q?=E6=94=AF=E6=8C=81=E7=9A=84=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 9d819c0..21dd364 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -18,7 +18,6 @@ namespace SpineViewerCLI
         Png = 0x0100,
         Jpg = 0x0101,
         Webp = 0x0102,
-        Bmp = 0x0103,
         Frames = 0x0200,
         Gif = 0x0300,
         Webpa = 0x0301,

From 3459f3af03fe14abccafae50e61cc3d802fc42d1 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Sun, 26 Oct 2025 23:59:57 +0800
Subject: [PATCH 21/30] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=BF=9B=E5=BA=A6?=
 =?UTF-8?q?=E5=9B=9E=E8=B0=83done=E5=80=BC=E9=94=99=E8=AF=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Spine/Exporters/FrameSequenceExporter.cs | 4 ++--
 Spine/Exporters/VideoExporter.cs         | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Spine/Exporters/FrameSequenceExporter.cs b/Spine/Exporters/FrameSequenceExporter.cs
index 3fdddc3..9fd035a 100644
--- a/Spine/Exporters/FrameSequenceExporter.cs
+++ b/Spine/Exporters/FrameSequenceExporter.cs
@@ -24,7 +24,7 @@ namespace Spine.Exporters
             int frameCount = GetFrameCount();
             int frameIdx = 0;
 
-            _progressReporter?.Invoke(frameCount, 0, $"[{frameIdx}/{frameCount}] {output}"); // 导出帧序列单独在此处调用进度报告
+            _progressReporter?.Invoke(frameCount, 0, $"[0/{frameCount}] {output}"); // 导出帧序列单独在此处调用进度报告
             foreach (var frame in GetFrames(spines))
             {
                 if (ct.IsCancellationRequested)
@@ -37,7 +37,7 @@ namespace Spine.Exporters
                 var savePath = Path.Combine(output, $"frame_{_fps}_{frameIdx:d6}.png");
                 var info = new SKImageInfo(frame.Width, frame.Height, SKColorType.Rgba8888, SKAlphaType.Premul);
 
-                _progressReporter?.Invoke(frameCount, frameIdx, $"[{frameIdx + 1}/{frameCount}] {savePath}");
+                _progressReporter?.Invoke(frameCount, frameIdx + 1, $"[{frameIdx + 1}/{frameCount}] {savePath}");
                 try
                 {
                     using var skImage = SKImage.FromPixelCopy(info, frame.Image.Pixels);
diff --git a/Spine/Exporters/VideoExporter.cs b/Spine/Exporters/VideoExporter.cs
index 164c241..9cf2a97 100644
--- a/Spine/Exporters/VideoExporter.cs
+++ b/Spine/Exporters/VideoExporter.cs
@@ -128,7 +128,7 @@ namespace Spine.Exporters
             int frameCount = GetFrameCount();
             int frameIdx = 0;
 
-            _progressReporter?.Invoke(frameCount, 0, $"[{frameIdx}/{frameCount}] {output}");
+            _progressReporter?.Invoke(frameCount, 0, $"[0/{frameCount}] {output}");
             foreach (var frame in GetFrames(spines))
             {
                 if (ct.IsCancellationRequested)
@@ -138,7 +138,7 @@ namespace Spine.Exporters
                     break;
                 }
 
-                _progressReporter?.Invoke(frameCount, frameIdx, $"[{frameIdx + 1}/{frameCount}] {output}");
+                _progressReporter?.Invoke(frameCount, frameIdx + 1, $"[{frameIdx + 1}/{frameCount}] {output}");
                 yield return frame;
                 frameIdx++;
             }

From df36d465281dc6a7366b7c31fc221437a3d6f4d9 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 00:00:44 +0800
Subject: [PATCH 22/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=8A=A8=E6=80=81?=
 =?UTF-8?q?=E8=BF=9B=E5=BA=A6=E6=9D=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 35 +++++++++++++++++++++------------
 1 file changed, 22 insertions(+), 13 deletions(-)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index 21dd364..e4d9022 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -1,5 +1,5 @@
 using NLog;
-using SFML.Graphics;
+using Spectre.Console;
 using Spine;
 using Spine.Exporters;
 using System;
@@ -107,7 +107,7 @@ namespace SpineViewerCLI
 
         #region >>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 基本导出参数 <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
 
-        public Option<Color> OptColor { get; } = new("--color")
+        public Option<SFML.Graphics.Color> OptColor { get; } = new("--color")
         {
             Description = "Background color of content.",
             //DefaultValueFactory = ...
@@ -233,7 +233,7 @@ namespace SpineViewerCLI
         {
             OptColor.DefaultValueFactory = r =>
             {
-                var defVal = Color.Black;
+                var defVal = SFML.Graphics.Color.Black;
                 try
                 {
                     switch (r.GetValue(OptFormat))
@@ -245,7 +245,7 @@ namespace SpineViewerCLI
                         case ExportFormat.Webpa:
                         case ExportFormat.Apng:
                         case ExportFormat.Webm:
-                            defVal = Color.Transparent;
+                            defVal = SFML.Graphics.Color.Transparent;
                             break;
                     }
                 }
@@ -326,17 +326,27 @@ namespace SpineViewerCLI
             Directory.CreateDirectory(exporter is FrameSequenceExporter ? output : Path.GetDirectoryName(output));
 
             // 挂载进度报告函数
-            if (!result.GetValue(OptNoProgress))
+            if (exporter is VideoExporter ve && !result.GetValue(OptNoProgress))
             {
-                exporter.ProgressReporter = (total, done, text) =>
+                AnsiConsole.Progress().Columns(
+                [
+                    new TaskDescriptionColumn(),
+                    new ProgressBarColumn(),
+                    new PercentageColumn(),
+                    new RemainingTimeColumn(),
+                    new SpinnerColumn(),
+                ]).Start(ctx =>
                 {
-                    Console.Write($"\r{text}");
-                    if (total == done) Console.WriteLine("");
-                };
+                    var task = ctx.AddTask($"Exporting '{spine.Name}'");
+                    task.MaxValue = ve.GetFrameCount();
+                    ve.ProgressReporter = (total, done, text) => task.Value = done;
+                    ve.Export(output, spine);
+                });
+            }
+            else
+            {
+                exporter.Export(output, spine);
             }
-
-            // 导出
-            exporter.Export(output, spine);
         }
 
         private BaseExporter GetExporterFilledWithArgs(ParseResult result, SpineObject spine)
@@ -374,7 +384,6 @@ namespace SpineViewerCLI
                         ExportFormat.Png => SkiaSharp.SKEncodedImageFormat.Png,
                         ExportFormat.Jpg => SkiaSharp.SKEncodedImageFormat.Jpeg,
                         ExportFormat.Webp => SkiaSharp.SKEncodedImageFormat.Webp,
-                        ExportFormat.Bmp => SkiaSharp.SKEncodedImageFormat.Bmp,
                         var v => throw new InvalidOperationException($"{v}"),
                     },
                     Quality = (int)result.GetValue(OptQuality),

From 701d1fcf9050b2690f7a9d6a4c6620743b6c79ea Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 07:35:05 +0800
Subject: [PATCH 23/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E6=97=A5=E5=BF=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/ExportCommand.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/SpineViewerCLI/ExportCommand.cs b/SpineViewerCLI/ExportCommand.cs
index e4d9022..e2fd764 100644
--- a/SpineViewerCLI/ExportCommand.cs
+++ b/SpineViewerCLI/ExportCommand.cs
@@ -347,6 +347,8 @@ namespace SpineViewerCLI
             {
                 exporter.Export(output, spine);
             }
+
+            _logger.Info($"{spine.SkelPath} export completed");
         }
 
         private BaseExporter GetExporterFilledWithArgs(ParseResult result, SpineObject spine)

From 29d7e8d9d8efaf58d8f269415252cc839159922a Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 22:26:33 +0800
Subject: [PATCH 24/30] =?UTF-8?q?=E7=A7=BB=E9=99=A4=E4=BE=9D=E8=B5=96?=
 =?UTF-8?q?=E5=BA=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/CanvasAscii.cs        | 188 +++++++++++++++++++++++++++
 SpineViewerCLI/CanvasImageAscii.cs   | 151 +++++++++++++++++++++
 SpineViewerCLI/PreviewCommand.cs     |   3 +-
 SpineViewerCLI/SpineViewerCLI.csproj |   1 -
 4 files changed, 340 insertions(+), 3 deletions(-)
 create mode 100644 SpineViewerCLI/CanvasAscii.cs
 create mode 100644 SpineViewerCLI/CanvasImageAscii.cs

diff --git a/SpineViewerCLI/CanvasAscii.cs b/SpineViewerCLI/CanvasAscii.cs
new file mode 100644
index 0000000..bdb5052
--- /dev/null
+++ b/SpineViewerCLI/CanvasAscii.cs
@@ -0,0 +1,188 @@
+using Spectre.Console;
+using Spectre.Console.Rendering;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    public class CanvasAscii : Renderable
+    {
+        private readonly Color?[,] _pixels;
+
+        /// <summary>
+        /// Gets the width of the canvas.
+        /// </summary>
+        public int Width { get; }
+
+        /// <summary>
+        /// Gets the height of the canvas.
+        /// </summary>
+        public int Height { get; }
+
+        /// <summary>
+        /// Gets or sets the render width of the canvas.
+        /// </summary>
+        public int? MaxWidth { get; set; }
+
+        /// <summary>
+        /// Gets or sets a value indicating whether or not
+        /// to scale the canvas when rendering.
+        /// </summary>
+        public bool Scale { get; set; } = true;
+
+        /// <summary>
+        /// Gets or sets the pixel width.
+        /// </summary>
+        public int PixelWidth { get; set; } = 2;
+
+        /// <summary>
+        /// Gets or sets the pixel lettters, ordered by transparency.
+        /// </summary>
+        public string PixelLetters { get; set; } = "$@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/|()1{}[]?-_+~<>i!lI;:,^`'."; // ".:-=+*#%@" ... "@%#*+=-:."
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CanvasAscii"/> class.
+        /// </summary>
+        /// <param name="width">The canvas width.</param>
+        /// <param name="height">The canvas height.</param>
+        public CanvasAscii(int width, int height)
+        {
+            if (width < 1)
+            {
+                throw new ArgumentException("Must be > 1", nameof(width));
+            }
+
+            if (height < 1)
+            {
+                throw new ArgumentException("Must be > 1", nameof(height));
+            }
+
+            Width = width;
+            Height = height;
+
+            _pixels = new Color?[Width, Height];
+        }
+
+        /// <summary>
+        /// Sets a pixel with the specified color in the canvas at the specified location.
+        /// </summary>
+        /// <param name="x">The X coordinate for the pixel.</param>
+        /// <param name="y">The Y coordinate for the pixel.</param>
+        /// <param name="color">The pixel color.</param>
+        /// <returns>The same <see cref="CanvasAscii"/> instance so that multiple calls can be chained.</returns>
+        public CanvasAscii SetPixel(int x, int y, Color color)
+        {
+            _pixels[x, y] = color;
+            return this;
+        }
+
+        /// <inheritdoc/>
+        protected override Measurement Measure(RenderOptions options, int maxWidth)
+        {
+            if (PixelWidth < 0)
+            {
+                throw new InvalidOperationException("Pixel width must be greater than zero.");
+            }
+
+            var width = MaxWidth ?? Width;
+
+            if (maxWidth < width * PixelWidth)
+            {
+                return new Measurement(maxWidth, maxWidth);
+            }
+
+            return new Measurement(width * PixelWidth, width * PixelWidth);
+        }
+
+        /// <inheritdoc/>
+        protected override IEnumerable<Segment> Render(RenderOptions options, int maxWidth)
+        {
+            if (PixelWidth < 0)
+            {
+                throw new InvalidOperationException("Pixel width must be greater than zero.");
+            }
+
+            if (PixelLetters.Length <= 0)
+            {
+                throw new InvalidOperationException("Pixel letters can't be empty.");
+            }
+
+            var pixels = _pixels;
+            var emptyPixel = new string(' ', PixelWidth);
+            var width = Width;
+            var height = Height;
+
+            // Got a max width?
+            if (MaxWidth != null)
+            {
+                height = (int)(height * ((float)MaxWidth.Value) / Width);
+                width = MaxWidth.Value;
+            }
+
+            // Exceed the max width when we take pixel width into account?
+            if (width * PixelWidth > maxWidth)
+            {
+                height = (int)(height * (maxWidth / (float)(width * PixelWidth)));
+                width = maxWidth / PixelWidth;
+
+                // If it's not possible to scale the canvas sufficiently, it's too small to render.
+                if (height == 0)
+                {
+                    yield break;
+                }
+            }
+
+            // Need to rescale the pixel buffer?
+            if (Scale && (width != Width || height != Height))
+            {
+                pixels = ScaleDown(width, height);
+            }
+
+            for (var y = 0; y < height; y++)
+            {
+                for (var x = 0; x < width; x++)
+                {
+                    var color = pixels[x, y];
+                    if (color.HasValue)
+                    {
+                        yield return new Segment(emptyPixel, new Style(background: color));
+                    }
+                    else
+                    {
+                        yield return new Segment(emptyPixel);
+                    }
+                }
+
+                yield return Segment.LineBreak;
+            }
+        }
+
+        private Color?[,] ScaleDown(int newWidth, int newHeight)
+        {
+            var buffer = new Color?[newWidth, newHeight];
+            var xRatio = ((Width << 16) / newWidth) + 1;
+            var yRatio = ((Height << 16) / newHeight) + 1;
+
+            for (var i = 0; i < newHeight; i++)
+            {
+                for (var j = 0; j < newWidth; j++)
+                {
+                    buffer[j, i] = _pixels[(j * xRatio) >> 16, (i * yRatio) >> 16];
+                }
+            }
+
+            return buffer;
+        }
+
+        private static float GetBrightness(Color c) => (0.299f * c.R + 0.587f * c.G + 0.114f * c.B) / 255f;
+
+        private string GetPixelLetter(Color c)
+        {
+            var index = Math.Min((int)(GetBrightness(c) * PixelLetters.Length), PixelLetters.Length - 1);
+            return new(PixelLetters[index], PixelWidth);
+        }
+    }
+}
diff --git a/SpineViewerCLI/CanvasImageAscii.cs b/SpineViewerCLI/CanvasImageAscii.cs
new file mode 100644
index 0000000..16d9f09
--- /dev/null
+++ b/SpineViewerCLI/CanvasImageAscii.cs
@@ -0,0 +1,151 @@
+using SkiaSharp;
+using Spectre.Console;
+using Spectre.Console.Rendering;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewerCLI
+{
+    internal class CanvasImageAscii : Renderable
+    {
+        private static readonly SKSamplingOptions _defaultSamplingOptions = new(new SKCubicResampler());
+
+        /// <summary>
+        /// Gets the image width.
+        /// </summary>
+        public int Width => Image.Width;
+
+        /// <summary>
+        /// Gets the image height.
+        /// </summary>
+        public int Height => Image.Height;
+
+        /// <summary>
+        /// Gets or sets the render width of the canvas.
+        /// </summary>
+        public int? MaxWidth { get; set; }
+
+        /// <summary>
+        /// Gets or sets the render width of the canvas.
+        /// </summary>
+        public int PixelWidth { get; set; } = 2;
+
+        /// <summary>
+        /// Gets or sets the <see cref="SKSamplingOptions"/> that should
+        /// be used when scaling the image. Defaults to bicubic sampling.
+        /// </summary>
+        public SKSamplingOptions? SamplingOptions { get; set; }
+
+        internal SKBitmap Image { get; }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CanvasImageAscii"/> class.
+        /// </summary>
+        /// <param name="filename">The image filename.</param>
+        public CanvasImageAscii(string filename)
+        {
+            Image = SKBitmap.Decode(filename);
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CanvasImageAscii"/> class.
+        /// </summary>
+        /// <param name="data">Buffer containing an image.</param>
+        public CanvasImageAscii(ReadOnlySpan<byte> data)
+        {
+            Image = SKBitmap.Decode(data);
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CanvasImageAscii"/> class.
+        /// </summary>
+        /// <param name="data">Stream containing an image.</param>
+        public CanvasImageAscii(Stream data)
+        {
+            Image = SKBitmap.Decode(data);
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CanvasImageAscii"/> class.
+        /// </summary>
+        /// <param name="image">The <see cref="SKImage"/> object.</param>
+        public CanvasImageAscii(SKImage image)
+        {
+            Image = SKBitmap.FromImage(image);
+        }
+
+        /// <inheritdoc/>
+        protected override Measurement Measure(RenderOptions options, int maxWidth)
+        {
+            if (PixelWidth < 0)
+            {
+                throw new InvalidOperationException("Pixel width must be greater than zero.");
+            }
+
+            var width = MaxWidth ?? Width;
+            if (maxWidth < width * PixelWidth)
+            {
+                return new Measurement(maxWidth, maxWidth);
+            }
+
+            return new Measurement(width * PixelWidth, width * PixelWidth);
+        }
+
+        /// <inheritdoc/>
+        protected override IEnumerable<Segment> Render(RenderOptions options, int maxWidth)
+        {
+            var image = Image;
+
+            var width = Width;
+            var height = Height;
+
+            // Got a max width?
+            if (MaxWidth != null)
+            {
+                height = (int)(height * ((float)MaxWidth.Value) / Width);
+                width = MaxWidth.Value;
+            }
+
+            // Exceed the max width when we take pixel width into account?
+            if (width * PixelWidth > maxWidth)
+            {
+                height = (int)(height * (maxWidth / (float)(width * PixelWidth)));
+                width = maxWidth / PixelWidth;
+            }
+
+            // Need to rescale the pixel buffer?
+            if (width != Width || height != Height)
+            {
+                var samplingOptions = SamplingOptions ?? _defaultSamplingOptions;
+                image = image.Resize(new SKSizeI(width, height), samplingOptions);
+            }
+
+            var canvas = new CanvasAscii(width, height)
+            {
+                MaxWidth = MaxWidth,
+                PixelWidth = PixelWidth,
+                Scale = false,
+            };
+
+            // XXX: 也许是 SkiaSharp@3.119.0 的 bug, 此处像素值一定是非预乘的格式
+            for (var x = 0; x < image.Width; x++)
+            {
+                for (var y = 0; y < image.Height; y++)
+                {
+                    var p = image.GetPixel(x, y);
+                    if (p.Alpha == 0) continue;
+                    float a = p.Alpha / 255f;
+                    byte r = (byte)(p.Red * a);
+                    byte g = (byte)(p.Green * a);
+                    byte b = (byte)(p.Blue * a);
+                    canvas.SetPixel(x, y, new(r, g, b));
+                }
+            }
+
+            return ((IRenderable)canvas).Render(options, maxWidth);
+        }
+    }
+}
diff --git a/SpineViewerCLI/PreviewCommand.cs b/SpineViewerCLI/PreviewCommand.cs
index 8b0fa56..3a8c954 100644
--- a/SpineViewerCLI/PreviewCommand.cs
+++ b/SpineViewerCLI/PreviewCommand.cs
@@ -99,8 +99,7 @@ namespace SpineViewerCLI
 
             using var exporter = GetExporterFilledWithArgs(result, spine);
             using var skImage = exporter.ExportMemoryImage(spine);
-            using var skData = skImage.Encode();
-            var img = new CanvasImage(skData.AsSpan());
+            var img = new CanvasImageAscii(skImage);
             AnsiConsole.Write(img);
         }
 
diff --git a/SpineViewerCLI/SpineViewerCLI.csproj b/SpineViewerCLI/SpineViewerCLI.csproj
index a40d269..a924239 100644
--- a/SpineViewerCLI/SpineViewerCLI.csproj
+++ b/SpineViewerCLI/SpineViewerCLI.csproj
@@ -18,7 +18,6 @@
     <ItemGroup>
       <PackageReference Include="NLog" Version="5.4.0" />
       <PackageReference Include="Spectre.Console" Version="0.52.0" />
-      <PackageReference Include="Spectre.Console.ImageSharp" Version="0.52.0" />
       <PackageReference Include="System.CommandLine" Version="2.0.0-rc.2.25502.107" />
     </ItemGroup>
 

From 617157044c6aa2c932ad9d2fee4e29327de2b5ea Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:33:25 +0800
Subject: [PATCH 25/30] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E9=80=8F=E6=98=8E?=
 =?UTF-8?q?=E5=BA=A6=E5=8F=82=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 SpineViewerCLI/CanvasAscii.cs      | 79 ++++++++++++++++++++----------
 SpineViewerCLI/CanvasImageAscii.cs | 18 +++++--
 SpineViewerCLI/PreviewCommand.cs   |  7 ++-
 3 files changed, 75 insertions(+), 29 deletions(-)

diff --git a/SpineViewerCLI/CanvasAscii.cs b/SpineViewerCLI/CanvasAscii.cs
index bdb5052..b46dbcf 100644
--- a/SpineViewerCLI/CanvasAscii.cs
+++ b/SpineViewerCLI/CanvasAscii.cs
@@ -1,4 +1,5 @@
-using Spectre.Console;
+using SkiaSharp;
+using Spectre.Console;
 using Spectre.Console.Rendering;
 using System;
 using System.Collections.Generic;
@@ -10,7 +11,7 @@ namespace SpineViewerCLI
 {
     public class CanvasAscii : Renderable
     {
-        private readonly Color?[,] _pixels;
+        private readonly SKColor?[,] _pixels;
 
         /// <summary>
         /// Gets the width of the canvas.
@@ -39,9 +40,14 @@ namespace SpineViewerCLI
         public int PixelWidth { get; set; } = 2;
 
         /// <summary>
-        /// Gets or sets the pixel lettters, ordered by transparency.
+        /// Gets or sets the pixel characters, ordered by transparency.
         /// </summary>
-        public string PixelLetters { get; set; } = "$@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/|()1{}[]?-_+~<>i!lI;:,^`'."; // ".:-=+*#%@" ... "@%#*+=-:."
+        public string PixelCharacters { get; set; } = ".,:;-=+*?oSXBGWM$&%#@";
+
+        /// <summary>
+        /// Whether to use pixel characters instead of spaces.
+        /// </summary>
+        public bool UsePixelCharacters { get; set; } = false;
 
         /// <summary>
         /// Initializes a new instance of the <see cref="CanvasAscii"/> class.
@@ -63,7 +69,7 @@ namespace SpineViewerCLI
             Width = width;
             Height = height;
 
-            _pixels = new Color?[Width, Height];
+            _pixels = new SKColor?[Width, Height];
         }
 
         /// <summary>
@@ -73,7 +79,7 @@ namespace SpineViewerCLI
         /// <param name="y">The Y coordinate for the pixel.</param>
         /// <param name="color">The pixel color.</param>
         /// <returns>The same <see cref="CanvasAscii"/> instance so that multiple calls can be chained.</returns>
-        public CanvasAscii SetPixel(int x, int y, Color color)
+        public CanvasAscii SetPixel(int x, int y, SKColor color)
         {
             _pixels[x, y] = color;
             return this;
@@ -105,7 +111,7 @@ namespace SpineViewerCLI
                 throw new InvalidOperationException("Pixel width must be greater than zero.");
             }
 
-            if (PixelLetters.Length <= 0)
+            if (UsePixelCharacters && PixelCharacters.Length <= 0)
             {
                 throw new InvalidOperationException("Pixel letters can't be empty.");
             }
@@ -141,28 +147,53 @@ namespace SpineViewerCLI
                 pixels = ScaleDown(width, height);
             }
 
-            for (var y = 0; y < height; y++)
+            if (UsePixelCharacters)
             {
-                for (var x = 0; x < width; x++)
+                for (var y = 0; y < height; y++)
                 {
-                    var color = pixels[x, y];
-                    if (color.HasValue)
+                    for (var x = 0; x < width; x++)
                     {
-                        yield return new Segment(emptyPixel, new Style(background: color));
+                        var color = pixels[x, y];
+                        if (color.HasValue)
+                        {
+                            var c = color.Value;
+                            yield return new Segment(GetPixelChar(c), new Style(foreground: new(c.Red, c.Green, c.Blue)));
+                        }
+                        else
+                        {
+                            yield return new Segment(emptyPixel);
+                        }
                     }
-                    else
-                    {
-                        yield return new Segment(emptyPixel);
-                    }
-                }
 
-                yield return Segment.LineBreak;
+                    yield return Segment.LineBreak;
+                }
+            }
+            else
+            {
+                for (var y = 0; y < height; y++)
+                {
+                    for (var x = 0; x < width; x++)
+                    {
+                        var color = pixels[x, y];
+                        if (color.HasValue)
+                        {
+                            var c = color.Value;
+                            yield return new Segment(emptyPixel, new Style(background: new(c.Red, c.Green, c.Blue)));
+                        }
+                        else
+                        {
+                            yield return new Segment(emptyPixel);
+                        }
+                    }
+
+                    yield return Segment.LineBreak;
+                }
             }
         }
 
-        private Color?[,] ScaleDown(int newWidth, int newHeight)
+        private SKColor?[,] ScaleDown(int newWidth, int newHeight)
         {
-            var buffer = new Color?[newWidth, newHeight];
+            var buffer = new SKColor?[newWidth, newHeight];
             var xRatio = ((Width << 16) / newWidth) + 1;
             var yRatio = ((Height << 16) / newHeight) + 1;
 
@@ -177,12 +208,10 @@ namespace SpineViewerCLI
             return buffer;
         }
 
-        private static float GetBrightness(Color c) => (0.299f * c.R + 0.587f * c.G + 0.114f * c.B) / 255f;
-
-        private string GetPixelLetter(Color c)
+        private string GetPixelChar(SKColor c)
         {
-            var index = Math.Min((int)(GetBrightness(c) * PixelLetters.Length), PixelLetters.Length - 1);
-            return new(PixelLetters[index], PixelWidth);
+            var index = Math.Min((int)(c.Alpha / 255f * PixelCharacters.Length), PixelCharacters.Length - 1);
+            return new(PixelCharacters[index], PixelWidth);
         }
     }
 }
diff --git a/SpineViewerCLI/CanvasImageAscii.cs b/SpineViewerCLI/CanvasImageAscii.cs
index 16d9f09..e57bc63 100644
--- a/SpineViewerCLI/CanvasImageAscii.cs
+++ b/SpineViewerCLI/CanvasImageAscii.cs
@@ -33,6 +33,16 @@ namespace SpineViewerCLI
         /// </summary>
         public int PixelWidth { get; set; } = 2;
 
+        /// <summary>
+        /// Gets or sets the pixel characters, ordered by transparency.
+        /// </summary>
+        public string PixelCharacters { get; set; } = ".,:;-=+*?oSXBGWM$&%#@";
+
+        /// <summary>
+        /// Whether to use pixel characters instead of spaces.
+        /// </summary>
+        public bool UsePixelCharacters { get; set; } = false;
+
         /// <summary>
         /// Gets or sets the <see cref="SKSamplingOptions"/> that should
         /// be used when scaling the image. Defaults to bicubic sampling.
@@ -127,13 +137,15 @@ namespace SpineViewerCLI
             {
                 MaxWidth = MaxWidth,
                 PixelWidth = PixelWidth,
+                PixelCharacters = PixelCharacters,
+                UsePixelCharacters = UsePixelCharacters,
                 Scale = false,
             };
 
             // XXX: 也许是 SkiaSharp@3.119.0 的 bug, 此处像素值一定是非预乘的格式
-            for (var x = 0; x < image.Width; x++)
+            for (var y = 0; y < image.Height; y++)
             {
-                for (var y = 0; y < image.Height; y++)
+                for (var x = 0; x < image.Width; x++)
                 {
                     var p = image.GetPixel(x, y);
                     if (p.Alpha == 0) continue;
@@ -141,7 +153,7 @@ namespace SpineViewerCLI
                     byte r = (byte)(p.Red * a);
                     byte g = (byte)(p.Green * a);
                     byte b = (byte)(p.Blue * a);
-                    canvas.SetPixel(x, y, new(r, g, b));
+                    canvas.SetPixel(x, y, new(r, g, b, p.Alpha));
                 }
             }
 
diff --git a/SpineViewerCLI/PreviewCommand.cs b/SpineViewerCLI/PreviewCommand.cs
index 3a8c954..94911f3 100644
--- a/SpineViewerCLI/PreviewCommand.cs
+++ b/SpineViewerCLI/PreviewCommand.cs
@@ -53,6 +53,11 @@ namespace SpineViewerCLI
             DefaultValueFactory = _ => 0f,
         };
 
+        public Option<bool> OptUseChars { get; } = new("--use-chars")
+        {
+            Description = "Whether to use characters instead of colored spaces for pixels",
+        };
+
         public PreviewCommand() : base(_name, _desc)
         {
             OptTime.Validators.Add(r =>
@@ -99,7 +104,7 @@ namespace SpineViewerCLI
 
             using var exporter = GetExporterFilledWithArgs(result, spine);
             using var skImage = exporter.ExportMemoryImage(spine);
-            var img = new CanvasImageAscii(skImage);
+            var img = new CanvasImageAscii(skImage) { UsePixelCharacters = result.GetValue(OptUseChars) };
             AnsiConsole.Write(img);
         }
 

From b54c6a17777d0936e44ec03e0d7b3fb2babcce70 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:43:52 +0800
Subject: [PATCH 26/30] update to v0.16.9

---
 Spine/Spine.csproj                   | 2 +-
 SpineViewer/SpineViewer.csproj       | 2 +-
 SpineViewerCLI/SpineViewerCLI.csproj | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Spine/Spine.csproj b/Spine/Spine.csproj
index 8bcc50c..1e0cc28 100644
--- a/Spine/Spine.csproj
+++ b/Spine/Spine.csproj
@@ -7,7 +7,7 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.16.8</Version>
+        <Version>0.16.9</Version>
     </PropertyGroup>
 
     <PropertyGroup>
diff --git a/SpineViewer/SpineViewer.csproj b/SpineViewer/SpineViewer.csproj
index c839c81..f61cea0 100644
--- a/SpineViewer/SpineViewer.csproj
+++ b/SpineViewer/SpineViewer.csproj
@@ -7,7 +7,7 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.16.8</Version>
+        <Version>0.16.9</Version>
         <OutputType>WinExe</OutputType>
         <UseWPF>true</UseWPF>
     </PropertyGroup>
diff --git a/SpineViewerCLI/SpineViewerCLI.csproj b/SpineViewerCLI/SpineViewerCLI.csproj
index a924239..23f7aaa 100644
--- a/SpineViewerCLI/SpineViewerCLI.csproj
+++ b/SpineViewerCLI/SpineViewerCLI.csproj
@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <ImplicitUsings>enable</ImplicitUsings>
@@ -7,7 +7,7 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.0.1</Version>
+        <Version>0.16.9</Version>
         <OutputType>Exe</OutputType>
     </PropertyGroup>
 

From 7780fbda281a3b7dcc3a472aa3060721d59707a0 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:43:57 +0800
Subject: [PATCH 27/30] update ignore

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 8a30d25..2df685e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -396,3 +396,5 @@ FodyWeavers.xsd
 
 # JetBrains Rider
 *.sln.iml
+
+launchSettings.json

From 317ee718823807b3ba9f733424c712fb434e1732 Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:45:16 +0800
Subject: [PATCH 28/30] update changelog

---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5d4e46c..5980e05 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## v0.16.9
+
+- 重构 CLI 工具
+
 ## v0.16.8
 
 - 去除首次的最小化提示弹框

From 49f95ddbb7e292e8b36f3c69d8a3a111d4b2491e Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:48:21 +0800
Subject: [PATCH 29/30] add readme

---
 SpineViewerCLI/README.md | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 SpineViewerCLI/README.md

diff --git a/SpineViewerCLI/README.md b/SpineViewerCLI/README.md
new file mode 100644
index 0000000..077ed1c
--- /dev/null
+++ b/SpineViewerCLI/README.md
@@ -0,0 +1,3 @@
+# SpineViewerCLI
+
+基于 [System.Command](https://www.nuget.org/packages/System.CommandLine) 的命令行工具.

From 7a29fee641bce21831bd2fb8426fbf2d346271ab Mon Sep 17 00:00:00 2001
From: ww-rm <ww-rm@qq.com>
Date: Mon, 27 Oct 2025 23:50:39 +0800
Subject: [PATCH 30/30] update readme

---
 README.en.md | 1 +
 README.md    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/README.en.md b/README.en.md
index d224c63..7e98874 100644
--- a/README.en.md
+++ b/README.en.md
@@ -143,6 +143,7 @@ For detailed usage and documentation, see the [Wiki](https://github.com/ww-rm/Sp
 - [HandyControl](https://github.com/HandyOrg/HandyControl)
 - [NLog](https://github.com/NLog/NLog)
 - [SkiaSharp](https://github.com/mono/SkiaSharp)
+- [Spectre.Console](https://github.com/spectreconsole/spectre.console)
 
 ---
 
diff --git a/README.md b/README.md
index 799b175..268500a 100644
--- a/README.md
+++ b/README.md
@@ -142,6 +142,7 @@ https://github.com/user-attachments/assets/37b6b730-088a-4352-827a-c338127a16f0
 - [HandyControl](https://github.com/HandyOrg/HandyControl)
 - [NLog](https://github.com/NLog/NLog)
 - [SkiaSharp](https://github.com/mono/SkiaSharp)
+- [Spectre.Console](https://github.com/spectreconsole/spectre.console)
 
 ---