dotnet-campus · lindexi · Sep 28, 2025 · Sep 12, 2025 · Sep 13, 2025 · Sep 13, 2025
diff --git a/.github/workflows/dotnet-build.yml b/.github/workflows/dotnet-build.yml
@@ -13,15 +13,17 @@ jobs:
       uses: actions/setup-dotnet@v1
       with:
         dotnet-version: |
-          3.1.x
-          6.0.x
           8.0.x
+          9.0.x
 
     - name: Build
-      run: dotnet build --configuration Release
+      run: dotnet build -c release
 
-    - name: Test
-      run: dotnet test --configuration Release
+    - name: Test Debug
+      run: dotnet test -c debug
+
+    - name: Test Release
+      run: dotnet test -c release
 
     - name: Pack
-      run: dotnet pack --configuration Release --no-build
+      run: dotnet pack ./src/DotNetCampus.CommandLine -c release --no-build
diff --git a/.github/workflows/nuget-tag-publish.yml b/.github/workflows/nuget-tag-publish.yml
@@ -17,9 +17,8 @@ jobs:
       uses: actions/setup-dotnet@v1
       with:
         dotnet-version: |
-          3.1.x
-          6.0.x
           8.0.x
+          9.0.x
 
     - name: Install dotnet tool
       run: dotnet tool install -g dotnetCampus.TagToVersion
@@ -29,8 +28,8 @@ jobs:
 
     - name: Build with dotnet
       run: |
-        dotnet build --configuration Release
-        dotnet pack --configuration Release --no-build
+        dotnet build -c release
+        dotnet pack ./src/DotNetCampus.CommandLine -c release --no-build
 
     - name: Install Nuget
       uses: nuget/setup-nuget@v1

diff --git a/Directory.Packages.props b/Directory.Packages.props
@@ -1,14 +1,17 @@
 <Project>
   <ItemGroup>
-    <PackageVersion Include="BenchmarkDotNet" Version="0.15.2" />
-    <PackageVersion Include="dotnetCampus.LatestCSharpFeatures" Version="13.0.0" />
+    <PackageVersion Include="BenchmarkDotNet" Version="0.15.4" />
+    <PackageVersion Include="ConsoleAppFramework" Version="5.6.1" />
+    <PackageVersion Include="DotNetCampus.CodeAnalysisUtils" Version="0.0.1-alpha.3" />
+    <PackageVersion Include="DotNetCampus.CommandLine.Temp40" Version="4.0.1-benchmark.1" />
+    <PackageVersion Include="DotNetCampus.LatestCSharpFeatures" Version="13.0.1" />
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" />
     <PackageVersion Include="Microsoft.CodeAnalysis.CSharp" Version="4.11.0" />
     <PackageVersion Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.11.0" />
     <PackageVersion Include="Microsoft.NET.Test.Sdk" Version="17.14.1" />
     <PackageVersion Include="Microsoft.SourceLink.GitHub" Version="8.0.0" />
-    <PackageVersion Include="MSTest.TestAdapter" Version="3.10.3" />
-    <PackageVersion Include="MSTest.TestFramework" Version="3.10.3" />
+    <PackageVersion Include="MSTest.TestAdapter" Version="3.10.4" />
+    <PackageVersion Include="MSTest.TestFramework" Version="3.10.4" />
     <PackageVersion Include="MSTestEnhancer" Version="2.2.2" />
     <PackageVersion Include="System.Collections.Immutable" Version="8.0.0" />
     <PackageVersion Include="System.CommandLine" Version="2.0.0-beta4.22272.1" />

diff --git a/DotNetCampus.CommandLine.sln b/DotNetCampus.CommandLine.sln
@@ -28,6 +28,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DotNetCampus.CommandLine.Te
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DotNetCampus.CommandLine.Performance", "tests\DotNetCampus.CommandLine.Performance\DotNetCampus.CommandLine.Performance.csproj", "{56B65FC1-CE75-4981-A880-954D891901D6}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "DotNetCampus.CommandLine.FakeObjects", "tests\DotNetCampus.CommandLine.FakeObjects\DotNetCampus.CommandLine.FakeObjects.csproj", "{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -76,6 +78,14 @@ Global
 		{56B65FC1-CE75-4981-A880-954D891901D6}.Release|Any CPU.Build.0 = Release|Any CPU
 		{56B65FC1-CE75-4981-A880-954D891901D6}.Release|x86.ActiveCfg = Release|Any CPU
 		{56B65FC1-CE75-4981-A880-954D891901D6}.Release|x86.Build.0 = Release|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Debug|x86.Build.0 = Debug|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Release|Any CPU.Build.0 = Release|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Release|x86.ActiveCfg = Release|Any CPU
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -84,6 +94,7 @@ Global
 		{6B8F7500-B161-408D-BFA3-AE77CB8CF4D8} = {F26EAA27-AA79-4B28-890C-D759F1D1A374}
 		{70991994-BB0C-4D00-9B74-E8736D0AD7C1} = {7DDA8183-3606-4B08-86E3-A4537860448F}
 		{56B65FC1-CE75-4981-A880-954D891901D6} = {7DDA8183-3606-4B08-86E3-A4537860448F}
+		{413E4F7B-4E26-4D88-B7E9-13A6831A9E42} = {7DDA8183-3606-4B08-86E3-A4537860448F}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {52E30C59-C5C8-4517-811A-667BFA2BFABB}

diff --git a/Nuget.config b/Nuget.config
@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+    <packageSources>
+        <add key="Benchmark-Local" value="./tests/DotNetCampus.CommandLine.Performance/CompareTo" />
+    </packageSources>
+</configuration>
diff --git a/README.md b/README.md
@@ -9,9 +9,9 @@
 [zh-hans]: /docs/zh-hans/README.md
 [zh-hant]: /docs/zh-hant/README.md
 
-DotNetCampus.CommandLine is a simple yet high-performance command line parsing library for .NET. Thanks to the power of source code generators, it provides efficient parsing capabilities with a developer-friendly experience.
+DotNetCampus.CommandLine is a simple and high-performance command line parsing library for .NET. Benefiting from source generators (and interceptors), it delivers efficient parsing and a friendly development experience across multiple command line styles. All features live under the `DotNetCampus.Cli` namespace.
 
-Parsing a typical command line takes only about 0.8μs (microseconds), making it one of the fastest command line parsers available in .NET.
+Benchmarks show parsing a typical command line takes well under a microsecond in many scenarios, placing it among the fastest .NET command line parsers while still pursuing full‑featured syntax support.
 
 ## Get Started
 
@@ -37,63 +37,81 @@ class Program
 Define a class that maps command line arguments:
 
 ```csharp
-class Options
+public class Options
 {
-    [Value(0)]
-    public required string FilePath { get; init; }
+    [Option("debug")]
+    public required bool IsDebugMode { get; init; }
 
-    [Option('s', "silence")]
-    public bool IsSilence { get; init; }
+    [Option('c', "count")]
+    public required int TestCount { get; init; }
 
-    [Option('m', "mode")]
-    public string? StartMode { get; init; }
+    [Option('n', "test-name")]
+    public string? TestName { get; set; }
 
-    [Option("startup-sessions")]
-    public IReadOnlyList<string> StartupSessions { get; init; } = [];
+    [Option("test-category")]
+    public string? TestCategory { get; set; }
+
+    [Option('d', "detail-level")]
+    public DetailLevel DetailLevel { get; set; } = DetailLevel.Medium;
+
+    [Value(0, int.MaxValue)]
+    public IReadOnlyList<string> TestItems { get; init; } = null!;
+}
+
+public enum DetailLevel
+{
+    Low,
+    Medium,
+    High,
 }
 ```
 
-Then use different command line styles to populate instances of this type:
+Then use different command line styles to populate instances of this type (the library supports multiple styles):
 
-### Windows PowerShell Style
+| Style           | Example                                                                                    |
+| --------------- | ------------------------------------------------------------------------------------------ |
+| DotNet          | `demo.exe 1.txt 2.txt -c:20 --test-name:BenchmarkTest --detail-level=High --debug`         |
+| Windows Classic | `demo.exe 1.txt 2.txt 3.txt -c 20 -TestName BenchmarkTest -DetailLevel High -Debug`        |
+| CMD             | `demo.exe 1.txt 2.txt 3.txt /c 20 /TestName BenchmarkTest /DetailLevel High /Debug`        |
+| Gnu             | `demo.exe 1.txt 2.txt 3.txt -c 20 --test-name BenchmarkTest --detail-level High --debug`   |
+| Flexible        | `demo.exe 1.txt 2.txt 3.txt --count:20 /TestName BenchmarkTest --detail-level=High -Debug` |
 
-```powershell
-> demo.exe "C:\Users\lvyi\Desktop\demo.txt" -s -Mode Edit -StartupSessions A B C
-```
+## Command Styles and Features
 
-### Windows CMD Style
+Multiple command line styles are supported; select one when parsing (Flexible is default). Styles differ in case sensitivity, accepted prefixes, separators, and naming forms. A detailed capability matrix (boolean literals, collection parsing forms, naming conventions, URL form, etc.) is documented in the full English guide under `docs/en/README.md`.
 
-```cmd
-> demo.exe "C:\Users\lvyi\Desktop\demo.txt" /s /Mode Edit /StartupSessions A B C
-```
+Core capabilities:
+- Rich option syntax: long & short options; separators `= : space`; multi-value & repeat forms
+- Boolean literals: `true/false`, `yes/no`, `on/off`, `1/0`
+- Collections & dictionaries: repeat, comma, semicolon forms; key-value dictionaries
+- Positional arguments: via `[Value(index)]` (ranges supported with `(index, length)` overload — second parameter is count)
+- Property semantics: `required`, `init`, nullable reference/value types unified behavior
+- Commands & subcommands: multi-word `[Command]` supported with handler chaining or `ICommandHandler`
+- URL protocol parsing: `scheme://command/sub/positional1?...` for integration scenarios
+- High performance: source generators + interceptors, minimizing allocations
+- AOT compatible: no reflection; even enum name lookups are avoided at runtime
 
-### Linux/GNU Style
+For the full feature matrix (including whether a style supports space-separated collections, explicit boolean values, multi-char short option groups, etc.), see the English documentation table.
 
-```bash
-$ demo.exe "C:/Users/lvyi/Desktop/demo.txt" -s --mode Edit --startup-sessions A --startup-sessions B --startup-sessions C
-```
+### Naming
 
-### .NET CLI Style
-```
-> demo.exe "C:\Users\lvyi\Desktop\demo.txt" -s:true --mode:Edit --startup-sessions:A;B;C
-```
+Define options using kebab-case in attributes (e.g., `[Option("test-name")]`). The analyzer warns (`DCL101`) if not kebab-case; we still treat what you write as kebab-case so users may invoke with PascalCase/camelCase depending on style.
 
-## Command Styles and Features
+### Required Options and Default Values
+
+Modifiers: `required` (must be supplied), `init` (immutable after construction), `?` (nullable). Initial value semantics follow the table in `docs/en/README.md`: required & missing → exception; nullable + init → null; non-nullable collection → empty; non-nullable scalar → default value (value types) or empty string for `string`; otherwise keep initializer.
+
+### Commands and Subcommands
+
+Register handlers with `AddHandler<T>()` or implement `ICommandHandler`. Multi-word `[Command("remote add")]` expresses subcommands. Ambiguity throws `CommandNameAmbiguityException`. Use `RunAsync` if any handler is async.
+
+### URL Protocol
+
+You may express a command invocation as a URL: `dotnet-campus://1.txt/2.txt?count=20&test-name=BenchmarkTest&detail-level=High&debug` enabling shell integration or deep links.
+
+### Performance
 
-The library supports multiple command line styles through `CommandLineStyle` enum:
-- Flexible (default): Intelligently recognizes multiple styles
-- GNU: GNU standard compliant
-- POSIX: POSIX standard compliant
-- DotNet: .NET CLI style
-- PowerShell: PowerShell style
-
-Advanced features include:
-- Support for various data types including collections and dictionaries
-- Positional arguments with `ValueAttribute`
-- Required properties with C# `required` modifier
-- Command handling with command support
-- URL protocol parsing
-- High performance thanks to source generators
+Benchmarks (see docs for detailed tables) show very low latency (hundreds of ns typical) and minimal allocations compared to earlier versions and other libraries, while preserving rich syntax coverage.
 
 ## Engage, Contribute and Provide Feedback
 
@@ -107,7 +125,7 @@ Click here to file a new issue:
 
 ### Contributing Guide
 
-Be kindly.
+Be kind.
 
 ## License