# 集中くん 説明書

作成日: 2026年5月14日

## 1. 集中くんとは

「集中くん」は、学習項目ごとに学習時間を記録するWindows向けデスクトップアプリです。

学習項目を選び、タイマーを開始し、終了すると、その学習時間が記録として保存されます。
保存した記録は、あとから一覧で確認・編集・削除できます。

## 2. 起動方法

以下のファイルを起動します。

```text
ShuchuKun\bin\Release\net10.0-windows\publish\ShuchuKun.exe
```

初回起動時に、アプリ用の保存フォルダとSQLiteデータベースが自動作成されます。

標準保存先:

```text
C:\Users\ユーザー名\AppData\Local\Shuchu-kun\
```

## 3. 基本的な使い方

### 3.1 学習項目を追加する

1. `学習項目` タブを開きます。
2. `項目名` に学習項目名を入力します。
3. `追加 / 再表示` を押します。

表示中にできる学習項目は最大3件です。

例:

```text
英語
Oracle Silver DBA
数学
```

### 3.2 学習時間を記録する

1. `メイン` タブを開きます。
2. 学習する項目ボタンを選びます。
3. 必要に応じて `この学習記録に残すメモ` を入力します。
4. `開始` を押します。
5. 学習が終わったら `終了` を押します。

`終了` を押すと、開始日時・終了日時・学習時間・メモが保存されます。

### 3.3 メモについて

メモは、今から保存する学習記録に残すためのものです。

例:

```text
過去問 第3回
単語帳 p.20-35
眠かったけど30分できた
数学の復習、二次関数
```

タイマー終了後、メモ欄は空になります。
ただし、入力した内容は記録一覧に保存されています。

## 4. タイマー表示について

タイマー表示は、軽量動作を優先しています。

そのため、PCの負荷やWindowsの状態によって、画面上の秒表示がたまに飛んで見えることがあります。

これは仕様です。

保存される学習時間は、画面表示ではなく、開始日時と終了日時の差分から計算されます。
そのため、秒表示が飛んでも記録時間の正確性には影響しません。

## 5. 達成チェック

タイマー中は、経過時間に応じて達成チェックが表示されます。

```text
5分
30分
1時間
2時間
3時間
```

チェック状態は保存されません。
現在の経過時間から画面上で自動計算されます。

## 6. 学習項目の管理

### 6.1 アーカイブ

使わなくなった項目は `アーカイブ` できます。

アーカイブした項目はメイン画面には表示されませんが、過去の記録や統計には残ります。

### 6.2 再表示

アーカイブ済み項目を選び、`再表示` を押すと、再びメイン画面に表示できます。

ただし、表示中の項目は最大3件までです。

### 6.3 未使用項目の削除

学習記録が1件もない項目は、`未使用なら削除` で完全削除できます。

学習記録がある項目は削除できません。
統計や過去記録を守るため、その場合はアーカイブしてください。

## 7. 学習記録一覧

`記録一覧` タブでは、保存済みの学習記録を確認できます。

できること:

- 学習項目の変更
- 開始日時の編集
- 終了日時の編集
- メモの編集
- 記録の削除

学習時間は、開始日時と終了日時から再計算されます。

記録を削除すると、統計対象からも外れます。

## 8. 統計

`統計` タブでは、学習項目ごとの学習時間を確認できます。

表示される内容:

- 学習項目名
- 合計学習時間
- 学習回数
- 平均学習時間
- 最終学習日
- 最長学習時間

期間はプルダウンから選択できます。

注意:

```text
1か月は30日、1年は365日として集計します。
```

## 9. CSV出力・取り込み

### 9.1 CSV出力

`データ管理` タブからCSVを出力できます。

出力できるCSV:

- 学習項目CSV
- 学習記録CSV

CSVはUTF-8 BOM付きで出力されます。
Excelで開いたときに文字化けしにくい形式です。

### 9.2 CSV取り込み

CSV取り込み前には、自動で現在のDBがバックアップされます。

取り込み後、以下の件数が表示されます。

- 追加件数
- スキップ件数
- エラー件数

メモに改行、カンマ、ダブルクォートが含まれていても取り込めます。

## 10. バックアップと復元

### 10.1 自動バックアップ

アプリ終了時に自動バックアップが作成されます。

標準では30世代分を保持します。

保存先:

```text
C:\Users\ユーザー名\AppData\Local\Shuchu-kun\Backups\
```

### 10.2 手動バックアップ

`データ管理` タブの `手動バックアップ` から、任意の場所にバックアップを作成できます。

### 10.3 復元

`バックアップ復元` から、SQLiteバックアップファイルを復元できます。

復元時には以下を選べます。

```text
はい      : 現在のデータと復元データを統合する
いいえ    : 現在のデータを復元データで置き換える
キャンセル: 復元を中止する
```

置き換え・統合の前には、現在のDBが自動バックアップされます。

## 11. 背景画像

`背景画像` タブから、任意の画像を背景に設定できます。

対応形式:

- PNG
- JPG / JPEG
- BMP

背景画像が削除・移動されていても、アプリは起動できます。
読み込めない場合は背景なしで表示されます。

## 12. データを移行したいとき

PCを買い替える場合は、以下のいずれかを使います。

おすすめ順:

1. `手動バックアップ` で作成したSQLiteファイルを新PCで復元する。
2. 学習項目CSVと学習記録CSVを出力し、新PCで取り込む。

長期保存を重視する場合は、定期的にCSVも出力しておくと安心です。

## 13. よくある質問

### Q. タイマーの秒が飛んで見えることがあります。

A. 仕様です。軽量動作を優先しているため、画面表示は厳密な1秒更新を保証していません。
保存される学習時間は開始日時と終了日時から計算されるため、記録の正確性には影響しません。

### Q. 間違えて追加した学習項目を消せますか？

A. 学習記録がない項目なら `未使用なら削除` で削除できます。
学習記録がある項目は削除できないため、不要な場合はアーカイブしてください。

### Q. アーカイブした項目は統計から消えますか？

A. 消えません。アーカイブ済み項目も統計対象です。

### Q. アプリを閉じ忘れたらどうなりますか？

A. タイマー中にアプリを閉じた場合、その時点までの学習記録を保存して終了します。

### Q. スリープ中の時間は含まれますか？

A. 含まれます。タイマーを停止していない場合、開始日時から終了日時までを学習時間として扱います。

## 14. トラブル時

### アプリが起動しない、データがおかしい

以下のバックアップフォルダを確認してください。

```text
C:\Users\ユーザー名\AppData\Local\Shuchu-kun\Backups\
```

バックアップファイルがある場合は、`データ管理` タブから復元できます。

### CSV取り込みでエラーが出る

CSVの列順が、集中くんから出力した形式と合っているか確認してください。

基本的には、集中くんから出力したCSVをそのまま取り込む形を推奨します。

