Merge branch 'fix/doc'

Author: mad-p

Claude.md

@@ -125,7 +125,7 @@ log stream --predicate 'process == "MacTcode"'
 以下はこの作業セッションで実装／追加した内容の短いサマリです。将来の解析やデバッグ時に参照してください。
 
 - InputStats の拡張
-  - ストローク（T‑Code基本キー）単位の頻度統計を追加しました。
+  - ストローク（T-Code基本キー）単位の頻度統計を追加しました。
   - 追加メソッド: `recordStroke(key:)`, `recordNonStrokeEvent()`, `resetStrokeStats()`, `writeStrokeStatsToFile()`, `loadStrokeStatsMaybe()`。
   - 内部データ構造: `keyCount[40]`, `basicCharCount[1600]`, `bigram[1600]`, `panes`, `alternation`。
   - 書き出しは既存の統計同期タイミング（`tc-record.txt` と同時）で行います。累積保存です（リセットしない）。

ConfigParams.md

@@ -9,6 +9,8 @@ MacTcodeは`config.json`形式の設定ファイルを使用してカスタマ
 1. `~/Library/Containers/jp.mad-p.inputmethod.MacTcode/Data/Library/Application Support/MacTcode/config.json` (ユーザー設定)
 2. アプリケーション内の`config.json` (デフォルト設定)
 
+IMEメニューから「設定ファイルフォルダを開く」を選ぶとユーザー設定のフォルダをファインダーで表示します。
+
 ## 設定ファイルの構造
 
 設定ファイルは以下の5つのカテゴリに分かれています：
@@ -170,14 +172,16 @@ MacTcodeは`config.json`形式の設定ファイルを使用してカスタマ
 
 ## 設定ファイルのセットアップ
 
-### 1. サンプル設定ファイルをコピー
+### 1. サンプル設定ファイルを作成
+
+IMEメニューから「サンプル設定ファイルを作成」を選ぶと、現在の設定が `sample-config.json` として設定ファイルフォルダ内に作成されます。これをコピーして `config.json` を作成し、編集してください。
 
 ```bash
-# ディレクトリを作成
-# MacTcodeを一度起動するとディレクトリが作られます
+# ディレクトリにcd
+cd ~/Library/Containers/jp.mad-p.inputmethod.MacTcode/Data/Library/Application\ Support/MacTcode/
 
 # サンプル設定ファイルをコピー
-cp sample-config.json ~/Library/Containers/jp.mad-p.inputmethod.MacTcode/Data/Library/Application\ Support/MacTcode/config.json
+cp sample-config.json config.json
 ```
 
 ### 2. 設定を編集

README.md

@@ -57,6 +57,7 @@ MacTcodeは設定ファイルを使用してカスタマイズできます。
 ```
 
 MacTcodeを一度起動するとディレクトリが作られます。
+IMEメニューから「設定ファイルフォルダを開く」を選ぶとファインダーで表示します。
 
 ### 設定ファイルの構造
 
@@ -70,13 +71,7 @@ MacTcodeを一度起動するとディレクトリが作られます。
 
 ### サンプル設定ファイル
 
-プロジェクトルートの`sample-config.json`ファイルに完全なサンプル設定があります。このファイルをコピーして使用してください：
-
-```bash
-cp sample-config.json ~/Library/Containers/jp.mad-p.inputmethod.MacTcode/Data/Library/Application\ Support/MacTcode/config.json
-```
-
-MacTcodeを一度起動するとコピー先ディレクトリが作られます。
+IMEメニューから「サンプル設定ファイルを作成」を選ぶと、現在の設定が `sample-config.json` として設定ファイルフォルダ内に作成されます。これをコピーして `config.json` を作成し、編集してください。
 
 ### 主な設定項目
 
@@ -113,23 +108,18 @@ MacTcodeは入力操作の統計情報を自動的に記録します。
 - **交ぜ書き**: 交ぜ書き変換の実行回数と全体に占める割合（%）
 - **機能**: キーマップ内に割り当てられている機能(部首/交ぜ書き変換のトリガを含む)の実行回数と全体に占める割合（%）
 
-+### ストローク頻度統計（`stroke-stats.json`）
-+
-+`stroke-stats.json` は `tc-record.txt` と同じディレクトリに保存される累積統計ファイルです。主な内容は次のとおりです。
-+
-+- `keyCount`: 長さ40の配列。インデックス0..39 がそれぞれT‑Codeの基本キーに対応し、使用回数を格納します。
-+- `basicCharCount`: 長さ1600の配列（1打目*40 + 2打目）。基本文字（2打）の頻度を格納します。
-+- `bigram`: 長さ1600の配列（1打目*40 + 2打目）。バイグラム（連続した2キー）の頻度を格納します。
-+- `panes`: オブジェクト {"RL":Int, "RR":Int, "LL":Int, "LR":Int}。左右ペインの組合せ頻度を格納します。
-+- `alternation`: オブジェクト {"alternate":Int, "consecutive":Int, "first":Int}。交互打鍵/連続打鍵/第1打目の頻度を格納します。
-+- `lastUpdated`: 最終更新時刻のISO8601文字列
-+
-+記録対象はT‑Codeの基本キー（`Translator.strToKey` が0..39を返すキー）のみです。部首・交ぜ書き変換やモード切替、機能実行などはバイグラムの連続性を断ちます。
-+
-+### `strokeStatsEnabled` 設定
-+
-+- `system.strokeStatsEnabled`（デフォルト `true`）で、ストローク頻度統計の収集を有効/無効にできます。`false` にすると `stroke-stats.json` の収集・書き出しが行われなくなります。
-+
+### ストローク頻度統計（`stroke-stats.json`）
+
+`stroke-stats.json` は `tc-record.txt` と同じディレクトリに保存される累積統計ファイルです。主な内容は次のとおりです。
+
+- `keyCount`: 長さ40の配列。インデックス0..39 がそれぞれT-Codeの基本キーに対応し、使用回数を格納します。
+- `basicCharCount`: 長さ1600の配列（1打目*40 + 2打目）。基本文字（2打）の頻度を格納します。
+- `bigram`: 長さ1600の配列（1打目*40 + 2打目）。バイグラム（連続した2キー）の頻度を格納します。
+- `panes`: オブジェクト {"RL":Int, "RR":Int, "LL":Int, "LR":Int}。左右ペインの組合せ頻度を格納します。
+- `alternation`: オブジェクト {"alternate":Int, "consecutive":Int, "first":Int}。交互打鍵/連続打鍵/第1打目の頻度を格納します。
+- `lastUpdated`: 最終更新時刻のISO8601文字列
+
+記録対象はT-Codeの基本キーのみです。部首・交ぜ書き変換やモード切替、機能実行などはバイグラムの連続性を断ちます。
 
 ### 統計出力のタイミング
 
@@ -162,6 +152,11 @@ MacTcodeは入力操作の統計情報を自動的に記録します。
 }
 ```
 
+- **`strokeStatsEnabled`**: ストローク頻度統計の出力
+  - デフォルト値: `true`
+  - ストローク頻度統計の収集を有効/無効にできます。`false` にすると `stroke-stats.json` の収集・書き出しが行われなくなります。
+
+
 詳細な設定方法については[ConfigParams.md](ConfigParams.md)を参照してください。
 
 ## 参考文献

STROKE_STATS.md StrokeStats.mdSTROKE_STATS.md renamed to StrokeStats.md

@@ -2,7 +2,7 @@
 
 目的
 
-- T‑Code の基本キーに関する詳細な頻度統計を累積保存するためのファイル仕様。
+- T-Code の基本キーに関する詳細な頻度統計を累積保存するためのファイル仕様。
 - ファイル名: `stroke-stats.json`
 - 保存場所: `UserConfigs.i.configFileURL("stroke-stats.json")`（`tc-record.txt` と同じディレクトリ）
 
@@ -14,7 +14,7 @@
 主要フィールド
 
 - `keyCount`: 整数配列（長さ 40）
-  - インデックス 0..39 が各 T‑Code 基本キーに対応
+  - インデックス 0..39 が各 T-Code 基本キーに対応
   - 値はそのキー単体の使用回数（累積）
 
 - `basicCharCount`: 整数配列（長さ 1600 = 40 * 40）
@@ -51,14 +51,14 @@
 
 連続性（バイグラム計算）についてのルール
 
-- バイグラム／交互打鍵の "連続" と見なすのは、同じ入力シーケンス内で連続する T‑Code 基本キー（0..39）だけです。
+- バイグラム／交互打鍵の "連続" と見なすのは、同じ入力シーケンス内で連続する T-Code 基本キー（0..39）だけです。
 - 以下のイベントは "連続性を断つ" とみなし、次の基本キーは `first` としてカウントされます:
   - 部首変換の適用（`InputStats.i.incrementBushuCount()` が呼ばれた場合）
   - 交ぜ書き変換の適用（`incrementMazegakiCount()`）
   - 機能実行（モード切替やアクション、`incrementFunctionCount()`）
   - モードの push/pop
   - 候補の確定（`candidateSelected`）や PendingKakutei の受容
-  - printable でも `Translator.strToKey` が 0..39 を返さないキー（T‑Code 基本外の入力）
+  - printable でも `Translator.strToKey` が 0..39 を返さないキー（T-Code 基本外の入力）
 
 書き出しタイミング
 
@@ -109,5 +109,5 @@ print('bigram[2,7] =', bigram[idx])
 
 更新履歴
 
-- 2026-02-21: 初版（STROKE_STATS.md）
+- 2026-02-21: 初版（StrokeStats.md）