subgraph FLIP["Flipper Zero — Specter.fap"]
  A["ST25R3916 NFC chip<br/>external-field detector"] --> S["Sampler thread<br/>~500 samples/s"]
  S --> M["<b>How much?</b><br/>carrier duty-cycle<br/>peak · average · contacts"]
  S --> C["<b>What rhythm?</b><br/>burst / gap edge timing<br/>period · jitter"]
  M --> G["EMF gauge · waveform<br/>geiger clicks · LED · vibe"]
  M --> V["Survey verdict<br/>CLEAN / TRACE / ACTIVE"]
  C --> K["Emitter class<br/>CONTINUOUS / POLLING /<br/>INTERMITTENT + pulse train"]
  V --> L["📖 SD logbook"]
  K --> L
end

**どれだけ強いか → 強度。** 短い時間窓の中で、Specterはキャリアが存在する*時間の割合*を測定し、それを**FIELD %**に平滑化します。Flipperの真上にあるリーダーはメーターを振り切ります。弱いまたは遠いリーダーはわずかに動かすだけです。それが針、近接ワード、クリック率を駆動します。

**どんなリズムか → 同一性。** 別途、そのビットのすべての遷移が計時されます。200 msごとに20 ms起きるリーダーは、ほとんどジッタのないバースト/ギャップパターンを生成します。なぜなら、そのポーリングループは水晶でタイミングを取られたステートマシンによって駆動されているからです。手の動きやRFノイズはそれほど安定していません。その違いが**POLLING**と**INTERMITTENT**を分けるものです。

### 判断レイヤーは実機コンピュータ上でテストされる

Specterが数値を*主張*に変える箇所 —「これはポーリングリーダーだ」「この部屋はクリーンだ」「針がこの値を示すべきだ」— は、ハードウェア依存のない純粋なCであり、デバイス上で発見されるのではなく、ホストテストによって固定されています。```bash
make -C test     # 300 checks: classifier, verdict, meter scaling, presence

The `.fap` は `dist/specter.fap` に出力されます。`ufbt launch` はそれを `apps/NFC/` にコピーして起動します。

> `icons/` 内のアイコン、`images/` 内のスクリーンショットとバナーは生成されます — 次のコマンドで再生成してください:
> `python3 tools_gen_icons.py`、`python3 tools_gen_mockups.py`、`python3 tools_gen_banner.py`（`pillow` が必要です）。

---

## 🎮 使い方

**スイープの一連の流れ：**

1. **Specter** を起動します。**Sweep** 画面で **LEFT** を押し、そのまま3秒間保持して部屋のノイズフロアに較正します。
2. Flipper を水平に保ち、検査対象（カード端末、ドアリーダー、ATM のリップ下側、小包、机など）の上を **ゆっくり** 動かします。
   - **波形が静か / 平坦** → 範囲内にアクティブなリーダーなし。
   - **針が上がり、クリック音が速くなる** → エミッターに近づいています。ピークに向かって進み続けてください。
   - **`● ACTIVE READER` + アラーム枠** → アクティブなリーダーがすぐそこにあります。
3. 何か見つかりましたか？ 戻って **Fingerprint** を開きます。Flipper をその対象に当てたまま静止させ、リズムが落ち着くのを待ちます — 通常は数秒で十分です。**OK** を押して発見を保存します。
4. 部屋全体を調べる場合は？ **Site Survey** を開き、バーが満タンになるまで空間を歩き回り、判定を読み取ります。
5. その場を離れますか？ Flipper を **Watch Mode** にしておけば、見張りを続け、不在中にリーダーが現れると起動して警報を鳴らします。
6. 保存したすべての検出結果をタイムスタンプ付きで **Logbook** で確認できます — またはカードから `logbook.csv` を取り出してスプレッドシートに入力します。

> 💡 まず既知の正常なリーダー（NFC で動作する自分のスマートフォンや、信頼できる非接触端末）をスイープして、
> 強い正規のフィールドがメーターにどう見えるか、そのフィンガープリントが何と読まれるかを確認してください。それから
> 探索に出かけましょう。

### 操作

| 画面 | キー | 動作 |
|---|---|---|
| **Sweep** | `OK` | ピーク / コンタクトをリセット |
| | `hold OK` | 現在の読み取りを記録 |
| | `LEFT` | ノイズフロアを較正（3秒） |
| **Fingerprint** | `OK` | 発見をログブックに保存 |
| | `hold OK` | 測定を再開 |
| **Site Survey** | `OK` | サーベイを再度実行 |
| **Watch Mode** | `OK` | 再セット（カウントと時計をクリア） |
| *どこでも* | `BACK` | 1つ上のレベルへ |

---

## 🔬 正直な制限

- **13.56 MHz（HF）のみ対応。** Specter は **NFC バンド**（非接触決済スキマー、最新のアクセスリーダーのほとんど、交通系・ホテル用リーダーが使用する帯域）を感知します。**125 kHz（LF）** リーダー（旧型の HID Prox / EM4100 ドアパネル）は **確認できません**。Flipper の LF 経路には同等のフィールド検出ビットがないためです。
- **感知するのはリーダーの *キャリア* であり、読み取る内容ではありません。** Specter が教えてくれるのは、*アクティブなリーダーがここにあり、おおよそどれだけ近く、どのリズムでポーリングしているか* だけです。リーダーが行う何かをデコード、識別、キャプチャすることはありません。
- **強度は相対的であり、較正されていません。** `FIELD %` や近接を示す言葉は、スイープのための比較用の「近い / 遠い」ガイドであり、cm 単位の測定距離ではありません。キャリアのデューティサイクルを標準的なポーリング帯域と比較した *スケーリング* された読み取りです（[メーターの読み方](#-reading-the-meter--fixed-in-23) を参照）。ポーリングが異常に疎なリーダーは、同じ距離でも低く読まれ、連続波モードのリーダーはより遠くからピークを示します。
- **メーターは上限に達します。** `MAX` は、このリーダーがキャリアを保持できる最大限まで上がっていることを意味します — その先では、近づいても実際には数値は大きくなりません。代わりに `PK` ピークホールドを使って位置を比較してください。
- **リズムの分解能は約2 msです。** これがサンプリング周期です。これに近いタイミングは **`~`** 付きで表示され、信頼度もそれに応じて割り引かれます — Specter は、裏付けできない精密そうな数値を示すよりも、自らの分解能の限界を明示することを選びます。
- **`CLEAN` は、選択した感度でのクリーンを意味します。** 実際のタップでのみ起動する休眠中のスキマーや、遮蔽されたスキマーは、*どの* しきい値でも見えません。読み取りがないことは、存在しないことを保証するものではありません。
- **同時に使える無線は1つだけ。** Specter はスイープ中に NFC チップを占有するため、他の NFC アプリを先に閉じてください（他のアプリが無線を保持していると *NFC を使用できません* と表示されます）。

---

## ⚖️ 法的・倫理的な注意

Specter は **防御専用・受信のみ** のツールです — **送信は一切行わず**、フィールドに電力を供給せず、リーダーに触れることもありません。**自分自身の** POS エリア、ドア、机、持ち物、または **明示的に許可された** ハードウェアの評価に使用してください。使用方法については利用者に責任があります。現地の法律を理解しておいてください。

---

## 🗺️ ロードマップ

- [x] 再起動後も感度 / サウンド / バイブ / LED を保持
- [x] 検出結果の「ログブック」をタイムスタンプ付きで SD カードに保存
- [x] 画面オフでのバックグラウンドスイープ — *ステルスモード*
- [x] より細かい範囲制御のための調整可能なしきい値 — *自動較正 + カスタム感度*
- [x] ポーリングリズムによるエミッターのフィンガープリント
- [x] 部屋の判定付きタイマー式サイトサーベイ
- [x] ログブックを CSV でエクスポートしてレポート — *.txt と並行してリアルタイムに書き込み*
- [x] 検出時起動アラーム付きの長時間無人監視モード
- [x] 実際のポーリングリーダーに対してメーターがフルレンジを使うようにする
- [x] 探索中の「近い / 遠い」トレンド矢印
- [ ] LF（125 kHz）コイルベースのリーダー感知を別モードとして調査
- [ ] オンデバイスでのログブックのタイプ別フィルタリング

---

## 🗂️ プロジェクト構成```
Specter-FlipperZero/
├── application.fam               # Flipper app manifest (category: NFC)
├── specter.c / specter_i.h       # app entry, wiring, alert feedback, stealth
├── helpers/
│   ├── field_detector.{c,h}      # worker thread: samples the field-present bit,
│   │                             #   duty-cycle + edge timing + calibration
│   ├── emitter_classify.{c,h}    # pure: cadence -> CONTINUOUS/POLLING/INTERMITTENT
│   ├── survey_verdict.{c,h}      # pure: survey stats -> CLEAN/TRACE/ACTIVE
│   ├── field_scale.{c,h}         # pure: raw carrier duty -> full-scale meter
│   ├── present_hold.h            # pure: debounce presence across poll gaps
│   ├── specter_settings.{c,h}    # persisted settings (saved_struct)
│   └── specter_log.{c,h}         # SD logbook, RTC-stamped .txt + live .csv
├── views/
│   ├── sweep_view.{c,h}          # the EMF gauge / waveform / alarm screen
│   ├── fingerprint_view.{c,h}    # classification card + pulse-train trace
│   ├── survey_view.{c,h}         # progress + verdict card
│   └── watch_view.{c,h}          # unattended guard: clock + count + alarm
├── scenes/                       # scene-manager navigation
├── test/                         # host tests for the pure decision layers
├── icons/                        # 1-bit Flipper icons (generated)
├── images/                       # banner + screen mockups (generated)
└── tools_gen_*.py                # regenerate icons / mockups / banner