> ## Documentation Index
> Fetch the complete documentation index at: https://shinydapps-bd9fa40b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code 拡張機能

> Lightningの支払いをリアルタイムで監視 — VS Code内で直接、ステータスバー、チャート、CSVエクスポート、Bitcoinで支払うProサブスクリプション。

**ShinyDapps Payments** 拡張機能は、エディタを離れることなくl402-kitの支払いデータを表示します。一度インストールして、Lightningアドレスを設定するだけで、satsがステータスバーに届くのを確認できます。

<Card title="マーケットプレイスからインストール" icon="download" href="https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402">
  ShinyDapps.shinydapps-l402 — VS Code 1.85以降に対応
</Card>

***

## クイックセットアップ

1. [VS Code マーケットプレイス](https://marketplace.visualstudio.com/items?itemName=ShinyDapps.shinydapps-l402)から拡張機能をインストールします。
2. コマンドパレットを開きます（`Ctrl+Shift+P` / `Cmd+Shift+P`）。
3. **ShinyDapps: Configure Lightning Address** を実行します。
4. Lightningアドレス（例：`you@blink.sv`）を入力します。

ステータスバーの `⚡ 0 sats (0)` がすぐに点灯します。30秒ごとにポーリングされ、自動的に更新されます。

または、VS Codeの設定で手動で設定することもできます：

```json theme={null}
{
  "shinydapps.lightningAddress": "you@blink.sv"
}
```

***

## 表示内容

### ステータスバー

`⚡ 1,234 sats (42)` — 獲得した合計satsと支払い回数が常に表示されます。
アイテムにホバーすると、詳細なツールチップが表示されます。無料プランの場合、ツールチップにはProで完全な履歴が利用可能になる旨も表示されます。

### ダッシュボードパネル

ステータスバーのアイテムをクリックするか、**ShinyDapps: Open Dashboard** を実行してフルパネルを開きます。パネルには以下が含まれます：

| セクション    | 説明                                  |
| -------- | ----------------------------------- |
| 統計カード    | 合計支払い数、合計sats、USD換算額、ライブBTC価格       |
| 棒グラフ     | 時系列での獲得sats（範囲は以下を参照）               |
| 支払いテーブル  | 直近50件のトランザクション：タイムスタンプ、エンドポイント、sats |
| BTCティッカー | mempool.spaceからのライブ価格（サット/ドル表示）     |

パネルはサイドバーにも表示されます（アクティビティバー → ⚡ アイコン）。

### 言語サポート

11言語が組み込み済み：English、Português、Español、中文、日本語、Français、Deutsch、Русский、हिन्दी、العربية、Italiano。ダッシュボード上部のドロップダウンから切り替えられます。

***

## 無料 vs Pro

| 機能                 | 無料      | Pro                      |
| ------------------ | ------- | ------------------------ |
| 支払い履歴              | 直近30日間  | 全期間                      |
| チャート範囲             | 1D · 7D | 1D · 7D · 30D · 1Y · ALL |
| CSVエクスポート          | —       | ✓                        |
| ステータスバー + ライブポーリング | ✓       | ✓                        |
| BTC価格ティッカー         | ✓       | ✓                        |
| 言語                 | 11      | 11                       |

### Proへのアップグレード

Proは**月額\$9**で、Lightning経由のBitcoinで支払います — クレジットカード不要、アカウント不要。

ダッシュボード内の **Upgrade with Bitcoin →** をクリックするか、直接以下にアクセスしてください：

```
https://l402kit.com/api/checkout?address=YOU@DOMAIN.COM&tier=pro
```

チェックアウトページでBOLT11インボイスが生成され、QRコードが表示され、支払いがポーリングされます。確認が取れると、Proは即座に有効化されます — 再起動は不要です。

<Note>
  拡張機能は起動時にProのステータスを確認します。支払い直後の場合は、ダッシュボードの **↺** 更新ボタンをクリックして即座に有効化してください。
</Note>

***

## 通知

エディタが開いている間に**最初の支払いが届いた**とき、拡張機能はVS Codeの通知を発火させます：

> ⚡ First payment received! Open your dashboard to see it.

通知内の **Open Dashboard** をクリックすると、パネルに直接ジャンプします。

***

## プライバシーとデータ

* 拡張機能は、Lightningアドレスにスコープされた\*\*公開（読み取り専用）\*\*キーを使用してSupabaseから支払いデータを読み取ります。
* 認証トークンはローカルに保存されません — VS Code設定にはLightningアドレスのみ保存されます。
* ダッシュボード内の **Danger Zone → Delete all my data** からいつでも全データを削除できます。これによりSupabaseから支払い履歴とProサブスクリプションが削除されます。

***

## 危険ゾーン

ダッシュボードにはセルフサービスのデータ削除フローが含まれています：

1. ダッシュボード下部の **Danger Zone** を展開します。
2. 確認のためLightningアドレスを入力します。
3. **Delete my data** をクリックします。

そのアドレスのすべての支払い履歴とProアクセスが完全に削除されます。

***

## トラブルシューティング

<AccordionGroup>
  <Accordion title="ステータスバーに ⚡ — (offline) と表示される">
    拡張機能がSupabaseに接続できませんでした。インターネット接続を確認し、**↺** をクリックして更新してみてください。
  </Accordion>

  <Accordion title="トランザクション成功後に支払いが表示されない">
    拡張機能は30秒ごとにポーリングします。**↺** をクリックして即座に強制更新してください。それでも支払いが表示されない場合は、VS Code設定のLightningアドレスがl402-kitに登録されているものと完全に一致しているか確認してください（大文字・小文字を区別します）。
  </Accordion>

  <Accordion title="Proが有効化されたがチャートに 🔒 が表示される">
    **↺** をクリックして更新してください。Proのステータスはロード時に確認されます — 手動で更新すると即座に再検証されます。
  </Accordion>

  <Accordion title="支払いは表示されているが件数が少なく見える">
    無料プランでは、**直近30日間**の履歴のみが読み込まれます。全期間のデータを表示するにはProにアップグレードしてください。古い記録がある場合、Proバナーに非表示になっている支払い数が表示されます。
  </Accordion>
</AccordionGroup>
