5.3 ファイル名一括変更ツール

# 依頼
ファイル名を一括変更するWindowsデスクトップアプリを作ってほしい。
同じフォルダにある RenameKit.md が仕様書である。必ず読んでから作業すること。

# 開発環境
- .NET 10
- WPF（XAML）
- C#
- win-x64
- Visual Studioの画面は使わない。dotnetコマンドだけで作業する。

# プロジェクト・フォルダ作成
- RenameKit という名前のサブフォルダを作成し、以降の作業はサブフォルダで行う。
- すでにサブフォルダがあれば、新規に作らず、そのサブフォルダで作業を進める。
- 名前空間は RenameKit とする。

# 画面
- ウィンドウの題名は「ファイル名一括変更ツール」、幅1400、高さ780とする。
- ウィンドウは画面の中央に表示する。
- 入力欄、ボタン、ラベルは大きく見やすく表示する。
- 画面を横に3つの区画へ分ける。区画の境目はマウスで動かせるようにする。
  - 左（幅280）：フォルダーツリー。上に選択中のフォルダーをフルパスで表示する読み取り専用の入力欄を置く。
  - 中央（残り全部）：ファイル一覧。上に絞り込みの入力欄と「抽出」ボタンを置く。
  - 右（幅520）：変更前後のファイル名一覧。上に変更ルールの入力欄、下に「変更」「取消」ボタンを置く。
- 不可視属性のフォルダーとファイルは表示しない。

# 変更ルール
- 「名前変更」欄に入力した文字を、変更後の名前とする。
- 名前の中の連続したクエスチョンマーク ? は連番の数字に置き換える。? 1つにつき数字1桁とする。
- 「開始番号」欄に連番の始まりの数を入力する。上下の矢印ボタンで増減でき、最小値は0とする。
- 「拡張子」欄に入力があれば、その拡張子へ変更する。空欄なら元の拡張子のままとする。
- 中央の一覧で選んだものについて、変更後の名前を右の一覧へ即座に表示する。

# 動作
- 「変更」ボタンで一括変更を実行する。
- 「取消」ボタンで直前の変更を元に戻す。取り消せるのは直前の1回だけとする。
- 名前が重複する、Windowsで使えない文字を含むなど、実行できない場合は右の一覧に理由を表示し、変更を実行しない。

# データ保存
- 前回選択したフォルダー、絞り込みの内容、変更ルールの内容を記憶し、次回起動時に再現する。
- 保存先は利用者ごとの領域とし、JSON形式で保存する。

# ビルドと実行
- dotnet build でビルドし、警告とエラーが無いことを確認する。
- エラーが出た場合は内容を読んで修正し、警告とエラーが無くなるまでくり返す。
- dotnet run で起動し、ウィンドウが表示されることを確認する。

# 制約
- 外部ライブラリ（NuGetパッケージ）は使わない。
- 外部と通信しない。
- ソースファイルはUTF-8で保存する。
- 初心者が読むので、要所に日本語のコメントを入れてほしい。
- 作成したファイルの一覧と、それぞれの役割を日本語で説明してほしい。

<Window x:Class="RenameKit.MainWindow"
        Title="ファイル名一括変更ツール"
        Width="1400" Height="780"
        MinWidth="1050" MinHeight="600"
        WindowStartupLocation="CenterScreen">
  <!-- 外側の入れ物。上下に貼り付け、残りを中身とします。 -->
  <DockPanel>
    <!-- 上端に貼り付けるメニュー -->
    <Menu DockPanel.Dock="Top" FontSize="15"> … </Menu>

    <!-- 下端に貼り付ける状態表示 -->
    <StatusBar DockPanel.Dock="Bottom">
      <TextBlock x:Name="StatusText" Text="準備完了" />
    </StatusBar>

    <!-- 残りの部分。5つの列に区切ります。 -->
    <Grid Margin="10">
      <Grid.ColumnDefinitions>
        <ColumnDefinition Width="280" MinWidth="180" />  <!-- 左：ツリー -->
        <ColumnDefinition Width="6" />                     <!-- 境目 -->
        <ColumnDefinition Width="*" MinWidth="350" />    <!-- 中央：一覧 -->
        <ColumnDefinition Width="6" />                     <!-- 境目 -->
        <ColumnDefinition Width="520" MinWidth="380" />  <!-- 右：変更前後 -->
      </Grid.ColumnDefinitions>

      <GroupBox Header="フォルダーツリー"> … </GroupBox>
      <GridSplitter Grid.Column="1" Width="6" HorizontalAlignment="Stretch" />
      <GroupBox Grid.Column="2" Header="ファイル一覧"> … </GroupBox>
      <GridSplitter Grid.Column="3" Width="6" HorizontalAlignment="Stretch" />
      <GroupBox Grid.Column="4" Header="変更前後のファイル名"> … </GroupBox>
    </Grid>
  </DockPanel>
</Window>

public static string BuildName(string oldName, bool isDirectory,
                               string pattern, int number, string extension)
{
    // 拡張子を除いた部分（フォルダーの場合は名前そのもの）
    string stem = isDirectory ? oldName : Path.GetFileNameWithoutExtension(oldName);
    // 元の拡張子（先頭のピリオドは取り除く）
    string oldExtension = isDirectory ? "" : Path.GetExtension(oldName).TrimStart('.');

    // 名前変更の指定があれば、連続した ? を連番に置き換える
    if (!string.IsNullOrWhiteSpace(pattern))
        stem = Regex.Replace(pattern, @"\?+", m => number.ToString($"D{m.Length}"));

    // 拡張子の指定があればそちらを、無ければ元の拡張子を使う
    string ext = isDirectory ? ""
               : (string.IsNullOrWhiteSpace(extension) ? oldExtension
                                                       : extension.Trim().TrimStart('.'));

    return ext.Length == 0 ? stem : $"{stem}.{ext}";
}

public static IReadOnlyList<RenamePair> Execute(IEnumerable<RenamePair> requested)
{
    // 名前が変わらないものは対象から外す
    var pairs = requested.Where(p => !StringComparer.OrdinalIgnoreCase
                                        .Equals(p.OldPath, p.NewPath)).ToList();
    Validate(pairs);   // 実行前の検査（重複、使えない文字、予約名）

    var staged = new List<(string Temporary, string Target)>();
    try
    {
        // 第1段階：すべてを一時的な名前に変える
        foreach (var pair in pairs)
        {
            string temporary = Path.Combine(Path.GetDirectoryName(pair.OldPath)!,
                                            $".RenameKit-{Guid.NewGuid():N}.tmp");
            Move(pair.OldPath, temporary);
            staged.Add((temporary, pair.NewPath));
        }
        // 第2段階：一時的な名前から目的の名前に変える
        foreach (var item in staged) Move(item.Temporary, item.Target);
        return pairs;
    }
    catch
    {
        // 失敗したら、後ろから順に元の名前へ戻す
        for (int i = staged.Count - 1; i >= 0; i--)
        {
            string current = Exists(staged[i].Target) ? staged[i].Target
                                                      : staged[i].Temporary;
            try { if (Exists(current)) Move(current, pairs[i].OldPath); } catch { }
        }
        throw;
    }
}

# 依頼
RenameKit に、動作の記録（ログ）をファイルへ書き出す機能を追加してほしい。

# 保存先
- %LOCALAPPDATA%\pahoo.org\RenameKit\log\ に保存する。
- ファイル名は RenameKit_yyyyMMdd.log とし、日付ごとに分ける。
- 30日より古いログファイルは、起動時に自動で削除する。

# 記録する内容
- 1行につき「日時 種別 内容」の順に、タブ区切りで書く。
- 日時は yyyy-MM-dd HH:mm:ss.fff 形式とする。
- 種別は INFO（通常）、WARN（注意）、ERROR（異常）の3種類とする。
- 次のできごとを記録する。
  - アプリの起動と終了（バージョン番号も記録する）
  - フォルダーを開いたとき（フォルダーのフルパスと、見つかった件数）
  - 名前の変更を実行したとき（対象の件数、変更前と変更後の名前）
  - 変更を取り消したとき（件数）
  - エラーが起きたとき（種別 ERROR で、エラーの内容と発生個所）

# 条件
- 外部ライブラリ（NuGetパッケージ）は使わない。
- ログの書き込みに失敗しても、アプリの動作は止めない。
- ファイル名やフォルダー名以外の個人情報は記録しない。
- 追加後、dotnet build でビルドし、dotnet run で起動して、ログファイルが作られることを確認してほしい。

<Package Name="ファイル名一括変更ツール"
         Manufacturer="studio pahoo"
         Version="0.2.0"
         UpgradeCode="B297165D-C951-43D6-B6AF-9930DC361B69"
         Scope="perMachine" Language="1041" Codepage="932">

  <!-- 古い版が入っていたら置き換えます -->
  <MajorUpgrade DowngradeErrorMessage="新しいバージョンが既にインストールされています。" />

  <!-- インストール先を選べる画面を使います -->
  <ui:WixUI Id="WixUI_InstallDir" InstallDirectory="INSTALLFOLDER" />
  <WixVariable Id="WixUIDialogBmp"   Value="resourceWiX\dialog.bmp" />
  <WixVariable Id="WixUIBannerBmp"   Value="resourceWiX\banner.bmp" />
  <WixVariable Id="WixUILicenseRtf"  Value="resourceWiX\license.rtf" />

  <!-- 入れる場所：C:\Program Files\pahoo.org\RenameKit -->
  <StandardDirectory Id="ProgramFiles64Folder">
    <Directory Id="PahooFolder" Name="pahoo.org">
      <Directory Id="INSTALLFOLDER" Name="RenameKit">
        <Directory Id="HelpFolder" Name="help" />
      </Directory>
    </Directory>
  </StandardDirectory>

  <!-- 入れるファイル -->
  <ComponentGroup Id="ApplicationFiles" Directory="INSTALLFOLDER">
    <Component Id="MainExecutable" Guid="*">
      <File Id="RenameKitExe" Source="publish\RenameKit.exe" KeyPath="yes" />
    </Component>
    …
  </ComponentGroup>

  <!-- デスクトップとスタートメニューのショートカット -->
  <Component Id="Shortcuts" Directory="ProgramMenuPahoo" Guid="*">
    <Shortcut Id="StartMenuShortcut" Name="ファイル名一括変更ツール"
              Target="[#RenameKitExe]" Icon="RenameKitIcon" />
    <Shortcut Id="DesktopShortcut" Directory="DesktopFolder"
              Name="ファイル名一括変更ツール"
              Target="[#RenameKitExe]" Icon="RenameKitIcon" />
    <RemoveFolder Id="RemoveProgramMenuPahoo" Directory="ProgramMenuPahoo"
                  On="uninstall" />
  </Component>
</Package>