最终还是在 CommandLine 里把 Runner 放进去了。不过两者都支持

Author: walterlv

src/DotNetCampus.CommandLine.Analyzer/Generators/InterceptorGenerator.cs

@@ -151,7 +151,7 @@ private void GenerateCommandLineAddHandlerCode(TypeDeclarationSourceTextBuilder
             .AddTypeConstraints("where T : class, global::DotNetCampus.Cli.ICommandHandler")
             .AddRawStatement(GenerateComment(model))
             .AddRawStatements($"""
-                return commandLine.ToRunner().AddHandler<T>(global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CommandNameGroup, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CreateInstance);
+                return commandLine.AsRunner().AddHandler<T>(global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CommandNameGroup, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CreateInstance);
                 """));
     }
 
@@ -166,7 +166,7 @@ private void GenerateCommandLineAddHandlerActionCode(TypeDeclarationSourceTextBu
             .AddTypeConstraints("where T : class")
             .AddRawStatement(GenerateComment(model))
             .AddRawStatements($"""
-                return commandLine.ToRunner().AddHandler<T>(handler, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CommandNameGroup, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CreateInstance);
+                return commandLine.AsRunner().AddHandler<T>(handler, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CommandNameGroup, global::{model.CommandObjectType.ContainingNamespace}.{model.GetBuilderTypeName()}.CreateInstance);
                 """));
     }
 

src/DotNetCampus.CommandLine/CommandLine.cs

@@ -9,8 +9,13 @@ namespace DotNetCampus.Cli;
 /// <summary>
 /// 为应用程序提供统一的命令行参数解析功能。
 /// </summary>
-public class CommandLine
+public class CommandLine : ICommandRunnerBuilder
 {
+    /// <summary>
+    /// 存储与此命令行解析类型关联的命令行执行器。
+    /// </summary>
+    private CommandRunner? _runner;
+
     /// <summary>
     /// 存储特殊处理过 URL 的命令行参数。
     /// </summary>
@@ -129,14 +134,34 @@ public string ToRawString()
         return string.Join(" ", RawArguments.Select(x => x.Contains(' ') ? $"\"{x}\"" : x));
     }
 
+    /// <summary>
+    /// 将当前命令行对象视作一个命令行执行器，以支持根据命令自动选择命令处理器运行。<br/>
+    /// 随后后，可通过 AddHandler 方法添加多个命令处理器。
+    /// </summary>
+    /// <returns>命令行执行器。</returns>
+    /// <remarks>
+    /// 与 <see cref="ToRunner"/> 方法不同，本方法每次都会返回同一个命令行执行器实例。<br/>
+    /// 如果多次调用本方法，后续对命令行执行器的修改会影响之前获得的命令行执行器。
+    /// </remarks>
+    public ICommandRunnerBuilder AsRunner() => _runner ??= new CommandRunner(this);
+
     /// <summary>
     /// 创建一个命令行执行器，以支持根据命令自动选择命令处理器运行。<br/>
     /// 创建后，可通过 AddHandler 方法添加多个命令处理器。
     /// </summary>
     /// <returns>命令行执行器。</returns>
-    [Pure]
+    /// <remarks>
+    /// 与 <see cref="AsRunner"/> 方法不同，本方法每次都会返回一个新的命令行执行器实例。<br/>
+    /// 如果多次调用本方法，后续对命令行执行器的修改不会影响之前获得的命令行执行器。
+    /// </remarks>
     public ICommandRunnerBuilder ToRunner() => new CommandRunner(this);
 
+    /// <inheritdoc />
+    CommandRunner ICoreCommandRunnerBuilder.AsRunner() => _runner ??= new CommandRunner(this);
+
+    /// <inheritdoc />
+    CommandRunningResult ICommandRunnerBuilder.Run() => AsRunner().Run();
+
     /// <summary>
     /// 当某个方法本应该被源生成器拦截时，却仍然被调用了，就调用此方法抛出异常。
     /// </summary>

src/DotNetCampus.CommandLine/CommandRunnerBuilderExtensions.cs

@@ -15,11 +15,6 @@ public static class CommandRunnerBuilderExtensions
     /// <param name="builder">命令行执行器构造的链式调用。</param>
     /// <typeparam name="T">命令处理器的类型。</typeparam>
     /// <returns>命令行执行器构造的链式调用。</returns>
-    /// <remarks>
-    /// 请注意，<see cref="CommandLine"/> 对象是不可变的，所以你需要使用这个方法的返回值，否则当你再次调用 AddHandler 时，之前添加的处理器将会丢失。<br/>
-    /// 如果你需要分多次添加处理器，请先调用 <see cref="CommandLine.ToRunner"/> 方法获得 <see cref="ICommandRunnerBuilder"/> 对象；
-    /// 在这个对象上多次调用 AddHandler 方法是安全的。
-    /// </remarks>
     public static IAsyncCommandRunnerBuilder AddHandler<T>(this CommandLine builder)
     {
         throw CommandLine.MethodShouldBeInspected();
@@ -34,7 +29,7 @@ public static IAsyncCommandRunnerBuilder AddHandler<T>(this CommandLine builder)
     /// <returns>命令行执行器构造的链式调用。</returns>
     public static StatedCommandRunnerBuilder<TState> ForState<TState>(this CommandLine builder, TState state)
     {
-        return new StatedCommandRunnerBuilder<TState>(builder.ToRunner().AsRunner(), state);
+        return new StatedCommandRunnerBuilder<TState>(((ICommandRunnerBuilder)builder).AsRunner(), state);
     }
 
     /// <inheritdoc cref="AddHandler{T}(CommandLine,Func{T, Task{int}})" />
@@ -62,11 +57,6 @@ public static IAsyncCommandRunnerBuilder AddHandler<T>(this CommandLine builder,
     /// <param name="handler">用于处理已解析的命令行参数的委托。</param>
     /// <typeparam name="T">命令处理器的类型。</typeparam>
     /// <returns>命令行执行器构造的链式调用。</returns>
-    /// <remarks>
-    /// 请注意，<see cref="CommandLine"/> 对象是不可变的，所以你需要使用这个方法的返回值，否则当你再次调用 AddHandler 时，之前添加的处理器将会丢失。<br/>
-    /// 如果你需要分多次添加处理器，请先调用 <see cref="CommandLine.ToRunner"/> 方法获得 <see cref="ICommandRunnerBuilder"/> 对象；
-    /// 在这个对象上多次调用 AddHandler 方法是安全的。
-    /// </remarks>
     public static IAsyncCommandRunnerBuilder AddHandler<T>(this CommandLine builder, Func<T, Task<int>> handler)
     {
         throw CommandLine.MethodShouldBeInspected();

tests/DotNetCampus.CommandLine.Tests/AddHandlerTests.cs

@@ -230,8 +230,8 @@ public void ChainedCalls_ReturnCorrectBuilderTypes()
         var commandLine = CommandLine.Parse(args, Flexible);
 
         // Act
-        var syncBuilder = commandLine.AddHandler<SimpleOptions>(_ => { });
-        var asyncBuilder = commandLine.AddHandler<SimpleOptions>(async _ => {
+        var syncBuilder = commandLine.ToRunner().AddHandler<SimpleOptions>(_ => { });
+        var asyncBuilder = commandLine.ToRunner().AddHandler<SimpleOptions>(async _ => {
             await Task.Delay(1);
             return 0;
         });