feat(config): テキスト並列差分の閾値/チャンクサイズをKB単位で設定可能にする

- config.json に TextDiffParallelThresholdKilobytes / TextDiffChunkSizeKilobytes を追加
- FileDiffService の固定値を廃止し、設定値をKB→Bytes変換して適用
- ConfigSettings と関連ユニットテストを更新
- README（日本語/英語）の設定例と性能説明を更新

Author: Widthdom

FolderDiffIL4DotNet.Tests/Models/ConfigSettingsTests.cs

@@ -13,6 +13,8 @@ public void Constructor_DefaultDiskCacheLimits_Are1000And512()
 
             Assert.Equal(1000, config.ILCacheMaxDiskFileCount);
             Assert.Equal(512, config.ILCacheMaxDiskMegabytes);
+            Assert.Equal(512, config.TextDiffParallelThresholdKilobytes);
+            Assert.Equal(64, config.TextDiffChunkSizeKilobytes);
             Assert.False(config.ShouldIgnoreILLinesContainingConfiguredStrings);
             Assert.NotNull(config.ILIgnoreLineContainingStrings);
             Assert.Empty(config.ILIgnoreLineContainingStrings);
@@ -25,6 +27,8 @@ public void JsonDeserialize_MissingDiskCacheLimits_UsesDefaults()
             Assert.NotNull(config);
             Assert.Equal(1000, config.ILCacheMaxDiskFileCount);
             Assert.Equal(512, config.ILCacheMaxDiskMegabytes);
+            Assert.Equal(512, config.TextDiffParallelThresholdKilobytes);
+            Assert.Equal(64, config.TextDiffChunkSizeKilobytes);
             Assert.False(config.ShouldIgnoreILLinesContainingConfiguredStrings);
             Assert.NotNull(config.ILIgnoreLineContainingStrings);
             Assert.Empty(config.ILIgnoreLineContainingStrings);
@@ -40,6 +44,16 @@ public void JsonDeserialize_ExplicitZeroDiskCacheLimits_KeepsZero()
             Assert.Equal(0, config.ILCacheMaxDiskMegabytes);
         }
 
+        [Fact]
+        public void JsonDeserialize_TextDiffParallelSettings_AreApplied()
+        {
+            var json = "{\"TextDiffParallelThresholdKilobytes\":128,\"TextDiffChunkSizeKilobytes\":8}";
+            var config = JsonSerializer.Deserialize<ConfigSettings>(json);
+            Assert.NotNull(config);
+            Assert.Equal(128, config.TextDiffParallelThresholdKilobytes);
+            Assert.Equal(8, config.TextDiffChunkSizeKilobytes);
+        }
+
         [Fact]
         public void JsonDeserialize_IlIgnoreContainsSettings_AreApplied()
         {

Models/ConfigSettings.cs

@@ -59,6 +59,16 @@ public sealed class ConfigSettings
         /// </summary>
         public int MaxParallelism { get; set; }
 
+        /// <summary>
+        /// テキスト差分で並列チャンク比較へ切り替えるサイズ閾値（KiB）。既定値は 512。
+        /// </summary>
+        public int TextDiffParallelThresholdKilobytes { get; set; } = 512;
+
+        /// <summary>
+        /// テキスト差分の並列チャンク比較で使用するチャンクサイズ（KiB）。既定値は 64。
+        /// </summary>
+        public int TextDiffChunkSizeKilobytes { get; set; } = 64;
+
         /// <summary>
         /// IL 逆アセンブル結果をキャッシュして再実行時の再逆アセンブルを回避するか
         /// </summary>

README.en.md

@@ -177,6 +177,8 @@ Place `config.json` next to the executable. Example:
   "ILIgnoreLineContainingStrings": [],
   "ShouldOutputFileTimestamps": true,
   "MaxParallelism": 0,
+  "TextDiffParallelThresholdKilobytes": 512,
+  "TextDiffChunkSizeKilobytes": 64,
   "EnableILCache": true,
   "ILCacheDirectoryAbsolutePath": "",
   "ILCacheStatsLogIntervalSeconds": 60,
@@ -199,6 +201,8 @@ Place `config.json` next to the executable. Example:
 | `ILIgnoreLineContainingStrings` | List of strings used for IL line-ignore filtering (substring match, multiple values allowed), e.g. `buildserver`. |
 | `ShouldOutputFileTimestamps` | Adds last modified timestamps to each file line inside the report. |
 | `MaxParallelism` | Degree of parallelism for file comparisons. `0` or omitted uses the logical core count. |
+| `TextDiffParallelThresholdKilobytes` | Size threshold (KiB) that switches text diffing to parallel chunk mode. Default `512`. Values `<= 0` fall back to default. |
+| `TextDiffChunkSizeKilobytes` | Chunk size (KiB) for parallel text diffing. Default `64`. Values `<= 0` fall back to default. |
 | `EnableILCache` | Caches IL disassembly results (MD5 + tool/version) in memory and optionally on disk. |
 | `ILCacheDirectoryAbsolutePath` | Custom cache folder. Blank defaults to `<exe>/ILCache` with LRU + TTL control. |
 | `ILCacheStatsLogIntervalSeconds` | Interval (seconds) for logging IL cache statistics. `<= 0` falls back to 60 seconds. |
@@ -256,7 +260,7 @@ After writing the report, the following files are marked read-only (failures onl
 | IL cache | Reuses IL text based on MD5 + tool label (command + version). | In-memory cache (LRU up to 2000 items, TTL 12h) with optional disk persistence. |
 | MD5 pre-warming | Precomputes MD5 for all targets in parallel before diffing. | Evens out cache key generation time. |
 | IL cache prefetch | Promotes disk cache entries into memory before diffing. | Further reduces disassembler launches. |
-| Parallel text diff | Files ≥512 KiB are split into 64 KiB chunks compared in parallel. | Only determines equality (no diff output). |
+| Parallel text diff | Files at/above `TextDiffParallelThresholdKilobytes` (KiB) are split by `TextDiffChunkSizeKilobytes` (KiB) and compared in parallel. | Only determines equality (no diff output). |
 | Tool failure blacklist | Skips IL tools that failed repeatedly (default: 3 times) for 10 minutes. | Reduces repeated launch overhead. |
 
 ### IL cache notes

README.md

@@ -201,6 +201,8 @@ CI との関係:
 	"ILIgnoreLineContainingStrings": [],
 	"ShouldOutputFileTimestamps": true,
 	"MaxParallelism": 0,
+	"TextDiffParallelThresholdKilobytes": 512,
+	"TextDiffChunkSizeKilobytes": 64,
 	"EnableILCache": true,
 	"ILCacheDirectoryAbsolutePath": "",
 	"ILCacheStatsLogIntervalSeconds": 60,
@@ -223,6 +225,8 @@ CI との関係:
 | ILIgnoreLineContainingStrings | IL 比較時に無視したい文字列のリスト（部分一致、複数指定可）。例: `"buildserver"`。 |
 | ShouldOutputFileTimestamps | `diff_report.md` の各ファイル行に最終更新日時を併記するか否か（ `true`  で併記）。 |
 | MaxParallelism | ファイル比較の並列度。0 または未指定で論理コア数、自動判定。1 で逐次実行。 |
+| TextDiffParallelThresholdKilobytes | テキスト差分で並列チャンク比較へ切り替える閾値（KiB）。既定値 `512`。`0` 以下は既定値を使用。 |
+| TextDiffChunkSizeKilobytes | テキスト差分の並列比較で使うチャンクサイズ（KiB）。既定値 `64`。`0` 以下は既定値を使用。 |
 | EnableILCache | IL 逆アセンブル結果（MD5 + ツール / バージョン単位）をメモリ & 任意ディスクにキャッシュし再実行時の逆アセンブルをスキップ。 |
 | ILCacheDirectoryAbsolutePath | キャッシュ格納ディレクトリ。空 / 未指定で実行ディレクトリ配下 `ILCache`。容量制御 (LRU) と TTL（現在 12h）あり。 |
 | ILCacheStatsLogIntervalSeconds | IL キャッシュの内部統計（ヒット率など）をログへ出力する間隔（秒）。0 以下で 60 秒が既定。 |
@@ -274,7 +278,7 @@ dotnet run "/Users/UserA/workspace/old" "/Users/UserA/workspace/new" "YYYYMMDD"
 | IL キャッシュ | MD5 + ツールラベル (コマンド + バージョン) で IL テキストを再利用 | LRU (capacity=2000), TTL=12h, ディスク永続化可 |
 | MD5 プリウォーム | 全対象ファイルの MD5 を先読み並列計算 | キャッシュキー生成の待ち時間平準化 |
 | IL キャッシュ先読み | 既存ディスク IL キャッシュをメモリへ昇格 | 初回以降の逆アセンブル起動を更に削減 |
-| 並列テキスト差分 | 512KB 以上のテキストを 64KB チャンクで並列バイト比較 | 完全一致判定のみ（差分位置抽出なし） |
+| 並列テキスト差分 | `TextDiffParallelThresholdKilobytes` 以上（KiB）のテキストを `TextDiffChunkSizeKilobytes`（KiB）単位で並列バイト比較 | 完全一致判定のみ（差分位置抽出なし） |
 | ツール失敗ブラックリスト | 同一ツール連続失敗 (既定 3 回) で 10 分間スキップ | 起動オーバーヘッド削減 |
 
 ### IL キャッシュ補足

Services/FileDiffService.cs

@@ -26,14 +26,14 @@ public sealed class FileDiffService
         private const int BYTES_PER_KILOBYTE = 1024;
 
         /// <summary>
-        /// テキスト差分の高速化を検討するサイズ閾値（バイト）
+        /// テキスト差分の高速化を検討するサイズ閾値（バイト）の既定値。
         /// </summary>
-        private const int TEXT_DIFF_PARALLEL_THRESHOLD_BYTES = 512 * BYTES_PER_KILOBYTE;
+        private const int DEFAULT_TEXT_DIFF_PARALLEL_THRESHOLD_BYTES = 512 * BYTES_PER_KILOBYTE;
 
         /// <summary>
-        /// テキスト差分比較時のチャンクサイズ（バイト）
+        /// テキスト差分比較時のチャンクサイズ（バイト）の既定値。
         /// </summary>
-        private const int TEXT_DIFF_CHUNK_SIZE_BYTES = 64 * BYTES_PER_KILOBYTE;
+        private const int DEFAULT_TEXT_DIFF_CHUNK_SIZE_BYTES = 64 * BYTES_PER_KILOBYTE;
         #endregion
 
         /// <summary>
@@ -127,6 +127,12 @@ public async Task<bool> FilesAreEqualAsync(string fileRelativePath, int maxParal
                 // 3) テキスト拡張子ならテキスト比較: ネットワーク最適化時は逐次、それ以外は閾値に応じて並列比較を選択。
                 if (_config.TextFileExtensions.Contains(Path.GetExtension(file1AbsolutePath).ToLower()))
                 {
+                    int textDiffParallelThresholdBytes = GetEffectiveBytesFromConfiguredKilobytes(
+                        configuredKilobytes: _config.TextDiffParallelThresholdKilobytes,
+                        defaultBytes: DEFAULT_TEXT_DIFF_PARALLEL_THRESHOLD_BYTES);
+                    int textDiffChunkSizeBytes = GetEffectiveBytesFromConfiguredKilobytes(
+                        configuredKilobytes: _config.TextDiffChunkSizeKilobytes,
+                        defaultBytes: DEFAULT_TEXT_DIFF_CHUNK_SIZE_BYTES);
                     bool areTextFilesEqual;
                     try
                     {
@@ -138,10 +144,15 @@ public async Task<bool> FilesAreEqualAsync(string fileRelativePath, int maxParal
                         else
                         {
                             var file1Info = new FileInfo(file1AbsolutePath);
-                            if (file1Info.Length >= TEXT_DIFF_PARALLEL_THRESHOLD_BYTES)
+                            if (file1Info.Length >= textDiffParallelThresholdBytes)
                             {
                                 // 大きいファイルは並列チャンク比較で高速化
-                                areTextFilesEqual = await DiffTextFilesParallelAsync(file1AbsolutePath, file2AbsolutePath, largeFileSizeThresholdBytes: TEXT_DIFF_PARALLEL_THRESHOLD_BYTES, maxParallel);
+                                areTextFilesEqual = await DiffTextFilesParallelAsync(
+                                    file1AbsolutePath,
+                                    file2AbsolutePath,
+                                    largeFileSizeThresholdBytes: textDiffParallelThresholdBytes,
+                                    chunkSizeBytes: textDiffChunkSizeBytes,
+                                    maxParallel: maxParallel);
                             }
                             else
                             {
@@ -177,9 +188,10 @@ public async Task<bool> FilesAreEqualAsync(string fileRelativePath, int maxParal
         /// <param name="file1AbsolutePath">ファイル1の絶対パス</param>
         /// <param name="file2AbsolutePath">ファイル2の絶対パス</param>
         /// <param name="largeFileSizeThresholdBytes">並列化閾値（バイト）。これ未満は逐次比較。</param>
+        /// <param name="chunkSizeBytes">チャンクサイズ（バイト）。</param>
         /// <param name="maxParallel">最大並列度</param>
         /// <returns>一致すれば true。エラーや引数不正時は false。</returns>
-        private static async Task<bool> DiffTextFilesParallelAsync(string file1AbsolutePath, string file2AbsolutePath, long largeFileSizeThresholdBytes, int maxParallel)
+        private static async Task<bool> DiffTextFilesParallelAsync(string file1AbsolutePath, string file2AbsolutePath, long largeFileSizeThresholdBytes, int chunkSizeBytes, int maxParallel)
         {
             try
             {
@@ -205,7 +217,7 @@ private static async Task<bool> DiffTextFilesParallelAsync(string file1AbsoluteP
                 }
 
                 // 大きなファイルは固定サイズのチャンクに分割し、読み取り→比較を並列実行する。
-                int chunkCount = (int)((file1Info.Length + TEXT_DIFF_CHUNK_SIZE_BYTES - 1) / TEXT_DIFF_CHUNK_SIZE_BYTES);
+                int chunkCount = (int)((file1Info.Length + chunkSizeBytes - 1) / chunkSizeBytes);
                 var differences = 0;
                 await Parallel.ForEachAsync(Enumerable.Range(0, chunkCount), new ParallelOptions { MaxDegreeOfParallelism = maxParallel }, async (index, cancellationToken) =>
                 {
@@ -214,16 +226,16 @@ private static async Task<bool> DiffTextFilesParallelAsync(string file1AbsoluteP
                     {
                         return;
                     }
-                    var buffer1 = new byte[TEXT_DIFF_CHUNK_SIZE_BYTES];
-                    var buffer2 = new byte[TEXT_DIFF_CHUNK_SIZE_BYTES];
+                    var buffer1 = new byte[chunkSizeBytes];
+                    var buffer2 = new byte[chunkSizeBytes];
                     int read1, read2;
                     using (var file1Stream = new FileStream(file1AbsolutePath, FileMode.Open, FileAccess.Read, FileShare.Read))
                     using (var file2Stream = new FileStream(file2AbsolutePath, FileMode.Open, FileAccess.Read, FileShare.Read))
                     {
-                        file1Stream.Seek((long)index * TEXT_DIFF_CHUNK_SIZE_BYTES, SeekOrigin.Begin);
-                        file2Stream.Seek((long)index * TEXT_DIFF_CHUNK_SIZE_BYTES, SeekOrigin.Begin);
-                        read1 = await file1Stream.ReadAsync(buffer1.AsMemory(0, TEXT_DIFF_CHUNK_SIZE_BYTES), cancellationToken);
-                        read2 = await file2Stream.ReadAsync(buffer2.AsMemory(0, TEXT_DIFF_CHUNK_SIZE_BYTES), cancellationToken);
+                        file1Stream.Seek((long)index * chunkSizeBytes, SeekOrigin.Begin);
+                        file2Stream.Seek((long)index * chunkSizeBytes, SeekOrigin.Begin);
+                        read1 = await file1Stream.ReadAsync(buffer1.AsMemory(0, chunkSizeBytes), cancellationToken);
+                        read2 = await file2Stream.ReadAsync(buffer2.AsMemory(0, chunkSizeBytes), cancellationToken);
                     }
                     // 同じオフセットのチャンクでも読み取りバイト数が異なれば即時不一致。
                     if (read1 != read2)
@@ -249,5 +261,24 @@ private static async Task<bool> DiffTextFilesParallelAsync(string file1AbsoluteP
                 return false;
             }
         }
+
+        /// <summary>
+        /// KiB 指定の設定値をバイトへ変換します。設定値が 0 以下または変換でオーバーフローする場合は既定値を返します。
+        /// </summary>
+        private static int GetEffectiveBytesFromConfiguredKilobytes(int configuredKilobytes, int defaultBytes)
+        {
+            if (configuredKilobytes <= 0)
+            {
+                return defaultBytes;
+            }
+
+            long bytes = (long)configuredKilobytes * BYTES_PER_KILOBYTE;
+            if (bytes > int.MaxValue)
+            {
+                return defaultBytes;
+            }
+
+            return (int)bytes;
+        }
     }
 }

config.json

@@ -82,6 +82,8 @@
   "ILIgnoreLineContainingStrings": [],
   "ShouldOutputFileTimestamps": true,
   "MaxParallelism": 0,
+  "TextDiffParallelThresholdKilobytes": 512,
+  "TextDiffChunkSizeKilobytes": 64,
   "EnableILCache": true,
   "ILCacheDirectoryAbsolutePath": "",
   "ILCacheStatsLogIntervalSeconds": 60,

version.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://raw.githubusercontent.com/dotnet/Nerdbank.GitVersioning/main/src/NerdBank.GitVersioning/version.schema.json",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "publicReleaseRefSpec": [
     "^refs/heads/main$",
     "^refs/tags/v\\d+\\.\\d+(?:\\.\\d+)?$"