</div>

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/121/96f422606110041227c4c4a5a6dfa138bbb5ae0a7443ff02bde46bf1ee2d548d.png" alt="ST3GG バナー" width="600">
<br><sub><i>この画像には隠しデータが含まれています。見つけられますか？</i></sub>
</p>

---

## ⊰ ST3GG とは？ ⊱

[STE.GG](https://ste.gg)‍​‌​‌​​​​​‌​​‌‌​​​‌​​‌​​‌​‌​​‌‌‌​​‌​‌‌​​‌​​‌​​​​​​‌​​‌‌​​​‌​​‌‌‌‌​‌​‌​‌‌​​‌​​​‌​‌​‌​‌​​‌‌​​‌​​​​​​‌​‌‌​​‌​‌​​‌‌‌‌​‌​‌​‌​‌‍ は、画像、音声、文書、ネットワークパケットなどに秘密データを隠す、多機能でオープンソースのステガノグラフィツールキットです。**100以上のエンコード手法** をあらゆるファイル形式で利用できます。

**100%ブラウザ上で動作**（静的サイト、サーバー不要）、または **Python CLI/TUI/WebUI** としても動作します。データがユーザーのマシンから外部に送信されることは決してありません。すべての手法はエンコードとデコードの両方に対応しています。すべての攻撃面は同時に検出面でもあります。

> *⊰•-•✧ ある秘密は、目の前に隠されている ✧•-•⊱*

---

## ⊰ なぜ ST3GG なのか？ ⊱

| 機能 | 他のツール | **ST3GG** |
|---------|-------------|-----------|
| チャンネルオプション | RGBのみ | **15プリセット** (R, G, B, A, RG, RB, RA, GB, GA, BA, RGB, RGA, RBA, GBA, RGBA) |
| ビット深度 | 1ビット固定 | **チャンネルあたり1～8ビット**（調整可能）|
| エンコード戦略 | 順次 | **4戦略**（順次、インターリーブ、拡散、ランダム化）|
| ネスト型ステガノグラフィ | - | **最大11階層**（マトリョーシカモード）|
| チャンネル暗号 | - | **革新的なクロスチャンネルホッピング**（SPECTER）|
| 圧縮耐性 | - | **F5 は JPEG/ソーシャルメディアに耐える; DCT は圧縮耐性設計**|
| スマートデコード | - | **120以上の自動設定検出**|
| 暗号化 | 基本/なし | **AES-256-GCM + XOR**|
| 画像フォーマット | PNGのみ | **PNG、JPEG、WebP、GIF**|
| ファイルタイプ | 画像のみ | **画像、音声、テキスト、文書、ネットワーク、アーカイブ、コード**|
| サンプルライブラリ | なし | **100以上のプリエンコード済みサンプルファイル**|
| ブラウザベース | - | **100%クライアントサイドJS、サーバー不要**|
| AIエージェント | - | **全手法を網羅したAI搭載デコード**|

---

## ⊰ 全体像：攻撃と防御 ⊱

ST3GG は **両用** ツールキットです — ステガノグラフィの戦場の両側のために構築されています。

### RED TEAM / 攻撃 — 汚染シミュレーション

データ漏洩は常にデータ漏洩らしい姿をしているわけではありません。ST3GG はレッドチームと研究者が、**知られているすべてのデータ密輸ベクター** をシミュレートし、防御が実際にそれらを捕捉できるかテストすることを可能にします：

- **100以上のエンコード手法** — 画像、音声、テキスト、文書、ネットワークパケット、アーカイブ、コードファイルに対応
- **ポリグロットファイル生成** — 2つのフォーマットとして同時に有効なファイル（PNG+ZIP）
- **ネットワークプロトコル隠蔽チャネル** — DNSクエリ、ICMPペイロード、TCPシーケンス番号、HTTPヘッダに隠されたデータ
- **Unicodeステガノグラフィ** — 目に見えないホモグリフ、ゼロ幅文字、異体字セレクタ、紛らわしい空白
- **圧縮耐性エンコード** — F5モードはJPEG係数に直接作用（ソーシャルメディアでの生存実績あり）; DCTモードは圧縮耐性設計
- **多層ネスト** — 最大11階層の再帰的ステガノグラフィ（マトリョーシカモード）
- **ゴーストモード** — AES-256暗号化 + ビットスクランブル + ノイズデコイによる最大限の回避

*DLP がそれを捕捉できないなら、攻撃者より先にそれについて知る必要があります。*

### BLUE TEAM / 防御 — ALLSIGHT 総合検出

ステガノグラフィペイロードを作成する同じツールキットが、**それらを検出しデコードもします**。ST3GG の分析エンジンは、知られているすべてのデータ密輸面を網羅する全スペクトルの可視性を提供します：

- **20以上の検出関数** — χ二乗分析、ビットプレーンエントロピー、ヒストグラム分析、シグネチャスキャン、STEGヘッダ検出
- **AI搭載網羅的分析** — 自律エージェントがアップロードされたファイルタイプに対してすべてのデコード手法をテスト
- **ファイルタイプ識別** — 20以上のフォーマットのマジックバイト検出（PNG、JPEG、GIF、BMP、WebP、TIFF、ICO、SVG、WAV、AIFF、AU、MIDI、PCAP、PDF、ZIP、GZip、TAR、SQLite など）
- **Unicodeステガノグラフィ検出** — ゼロ幅文字、ホモグリフ、異体字セレクタ、結合文字、紛らわしい空白、絵文字パターン
- **空白分析** — 末尾のスペース/タブエンコード、Unicode空白バリアントの検出
- **メタデータフォレンジック** — base64/hex 文字列抽出、EXIF解析、PNGチャンク検査
- **ネットワークパケット分析** — PCAP解析による隠蔽チャネル指標の検出
- **200以上の自動テスト** — 既知手法に対する誤検出ゼロの検出精度を検証

*すべてを見ろ。何も見逃すな。それが ALLSIGHT だ。*

> *⊰•-•✧ 最良の防御は、攻撃を理解することから始まる ✧•-•⊱*

---

## ⊰ 誰のためのものか？ ⊱

ST3GG は単なるおもちゃではありません。さまざまなコミュニティが、まったく異なる — そして非常に現実的な — 理由でステガノグラフィツールを利用します。

### ペネトレーションテスター & レッドチーム
エンゲージメント中にステガノグラフィチャネルを通じたデータ漏洩をシミュレーション。エンドポイントのDLP、SIEMルール、ネットワーク監視が、100以上のベクターにわたる隠密データ密輸を捕捉するかテスト。すべてのファイルタイプにわたる敵対的ペイロードを生成し、検出カバレッジを検証。

### ブルーチーム & SOC アナリスト
ALLSIGHT を使用して、疑わしいファイルに隠されたペイロードをスキャン。既知のすべてのエンコード手法に対する網羅的分析を実行。包括的なサンプルライブラリから検出ルールを構築。アナリストに、実際の環境でのステガノグラフィ痕跡がどのようなものかを訓練。

### CTFプレイヤー & 競技ハッカー
Capture The Flag 競技のための究極のステガノグラフィツールキット。すべてのチャンネル/ビット/戦略の組み合わせでエンコード・デコード。スマートスキャンで未知の設定を自動検出。多層マトリョーシカチャレンジを自動的にアンラップ。

### デジタルフォレンジック & インシデントレスポンス
押収されたメディアを分析し、ステガノグラフィ通信チャネルを検出。画像添付ファイル、文書メタデータ、音声ファイル、ネットワークキャプチャに隠されたデータを検出。使用されたエンコード手法を特定し、隠されたペイロードを抽出。

### プライバシー研究者 & ジャーナリスト
プライバシーを保護する通信チャネルとしてのステガノグラフィを探求。容量、ステルス性、圧縮耐性のトレードオフを理解。実際の否認可能な通信のために、どの手法がソーシャルメディアの再エンコードに耐えるかをテスト。

### アカデミック & 学生
あらゆるモダリティにわたるステガノグラフィ手法の全体像を研究。100以上のサンプルファイルを教育用データセットとして使用。既知のエンコードに対する新しい検出アルゴリズムをベンチマーク。コードベースは十分に文書化され、AGPL-3.0ライセンス — 個人、研究者、オープンソースプロジェクトは無料。

### AIセーフティ & LLMセキュリティ
AIシステムがステガノグラフィコンテンツをどのように処理するかテスト — 画像内の隠し命令、プロンプト内の目に見えないUnicode、コンテンツフィルターをバイパスするポリグロットファイル。AIシステムが防御する必要があるデータ密輸の表面領域を理解。

### データ漏洩防止（DLP）ベンダー
ST3GG の100以上のエンコード手法に対してDLPソリューションをベンチマーク。お客様の製品が、DNSクエリ名、TCPシーケンス番号、または目に見えないUnicode文字に隠されたデータを検出できないなら、お客様はそれを知る権利があります。ST3GG はあなたの敵対的テストスイートです。

### AIエージェントセキュリティ & レッドチーミング
ステガノグラフィの次のフロンティアは、**エージェント間の隠密通信** と **隠しペイロードによるプロンプトインジェクション** です。ST3GG はこの新たな攻撃面のためのツールキットです：

- **画像によるプロンプトインジェクション** — 視覚エージェントが処理する画像に隠し命令を埋め込む。エージェントには普通の写真が見えるが、隠しペイロードに「これまでの指示をすべて無視しろ」と書かれている。
- **エージェントデータ漏洩** — エージェントが出力フィルターを通り抜けて、生成した画像に盗んだデータをエンコードするよう騙せるかテスト。
- **隠密エージェントチャネル** — 共有ツールコンテキスト内で無害に見えるファイルを通じて、エージェントが隠し命令をやり取りする。
- **エージェント出力ウォーターマーキング** — エージェントが生成した画像に証明や追跡データを埋め込み、帰属を可能にする。
- **コンテンツフィルター回避** — 自動レビューを通り抜ける画像ペイロードに禁止コンテンツを隠し、モデレーションシステムをテスト。
- **マルチモーダル汚染** — 人間には正常に見えるが、エージェントの動作を変える隠しデータを含む画像を作成。

**ST3GG を Python ライブラリとしてエージェントパイプラインで使用：**```python
from steg_core import encode, decode, detect_encoding, StegConfig, get_channel_preset
from analysis_tools import detect_unicode_steg, detect_file_type, TOOL_REGISTRY
from PIL import Image

# Encode a hidden payload into an image
img = Image.open("carrier.png")
config = StegConfig(channels=get_channel_preset("RGB"), bits_per_channel=1)
stego = encode(img, b"hidden agent instructions", config)
stego.save("stego.png")

# Detect and decode hidden data
detected = detect_encoding(Image.open("stego.png"))
if detected:
    payload = decode(Image.open("stego.png"))
    print(f"Found: {payload.decode()}")

# Scan for ALL steganography types
tools = TOOL_REGISTRY.list_tools()  # 48 detection tools
result = detect_unicode_steg(open("message.txt", "rb").read())
if result['found']:
    print(f"Hidden Unicode: {result['invisible_chars']} chars")

2つのモード: **マニュアルパターン**（自分で定義）または**パスワードモード**（パスフレーズ + オプションの暗号化から派生）。埋め込みは**LSB**（大容量）または**DCT**（圧縮耐性）で行います。

### ゴーストモード — 最大級のステルス性

本当に重要な場面のための三重の難読化:

1. **AES-256-GCM暗号化** — 認証付き、軍事グレード
2. **ビットスクランブリング** — シード付きPRNGを用いたフィッシャー–イェーツシャッフル
3. **50%ノイズデコイ** — 埋め込まれたビットの半分はランダムノイズ

攻撃者は、チャネルパターン、スクランブル解除のパスワード、そして復号鍵のすべてを知っている必要があります。トレードオフ: 容量が半分になります。

### マトリョーシカモード — 再帰的な入れ子

画像の中に画像を、最大**11層**まで入れ子にできます。スマートデコーダはPNGマジックバイトを自動検出し、すべての層を再帰的に展開します。秘密を隠すロシアの入れ子人形です。

### DCTモード — 圧縮耐性

従来のLSBは、JPEG圧縮（品質99%でも）で完全に破壊されます。DCTモードは8x8ピクセルブロックの周波数領域係数に埋め込み、圧縮耐性を備えています。**実証済み**のソーシャルメディア生存性には、行列符号化を介してJPEG DCT係数に直接作用する**F5モード**を使用します。

> **LSB** → PNGのみ（ロスレス）。**DCT** → 圧縮耐性。**F5** → JPEG/ソーシャルメディアで生き残る。

### AIエージェント — 公開 & 隠蔽

AIエージェントには2つのモードがあります:

**🔍 公開** — 任意のファイルをアップロードします。エージェントは既知のすべての復号方法を自動的にテストし、隠されたデータを見つけ、ダウンロード可能なアーティファクトとして抽出します。

**🔮 隠蔽** — 秘密のメッセージを入力し、キャリア画像をアップロード（または生成）すると、エージェントは最適なエンコード方式を使用してデータを隠します。ワンクリックで秘密からステゴ画像へ。

OpenRouter搭載。Claude、GPT、Gemini、その他のモデルで動作します。

---

## ⊰ 100以上のステガノグラフィ手法 ⊱

ST3GGは画像にデータを隠すだけではありません。**あらゆるモダリティ**をカバーします:

### 画像手法
PNG、BMP、TIFF、GIF、WebP、ICO、PPM、PGMにわたるLSB埋め込み（RGB、RGBA、グレースケール）— さらにアルファチャンネルLSB、PNGフィルタタイプ符号化、パレットインデックス操作、DCT周波数領域、PNG+ZIPポリグロット、メタデータ注入（EXIF、XMP、tEXtチャンク）、IEND後のテーリングデータ。

### テキスト＆ユニコード手法
ゼロ幅文字（ZWSP/ZWNJ/ZWJ）、不可視インク（Unicodeタグ文字U+E0000）、同形異字体置換（キリル/ラテン）、異体字セレクタ、結合分音記号（CGJ）、紛らわしい空白（en/em/thin/hairスペース）、空白符号化（スペース=0/タブ=1）、絵文字置換、大文字小文字符号化。

### 音声手法
WAV、AIFF、AU形式でのサンプルLSB。無音区間タイミング（ギャップの長さがビットを符号化）。MIDI SysExメッセージ埋め込み。

### ネットワークプロトコル手法
DNSトンネリング（クエリラベルのbase32）、ICMPペイロード注入、TCP covertチャネル（ISN + タイムスタンプ）、HTTPヘッダースマグリング（カスタムX-ヘッダー、クッキー）。

### ドキュメント＆アーカイブ手法
PDF（メタデータストリーム + XMP + EOF後）、HTML（コメント + 隠し要素 + データ属性 + ゼロ幅）、XML（CDATA + PI + 名前空間）、JSON（Unicodeエスケープ + キー順序）、CSV/YAML/TOML/INI（コメント符号化 + 空白）、RTF（隠しテキストグループ）、Markdown（HTMLコメント + リンクリファレンス）、ZIP/TAR/GZip（コメント + 拡張ヘッダー + 追加フィールド）、SQLite（隠しテーブル）など。

### コード手法
Python、JavaScript、C、CSS、Shell、SQL、LaTeX — すべてステガノグラフィコメント、16進バイトテーブル、ゼロ幅docstring、バイト単位のキャリブレーションエントリ付き。

> *⊰•-•✧ 全カタログはこちら: [`examples/README.md`](https://github.com/elder-plinius/st3gg/blob/main/examples/README.md) ✧•-•⊱*

---

## ⊰ クイックスタート ⊱

### PyPIからインストール```bash
pip install stegg

### 追加機能付きインストール```bash
pip install stegg[tui]      # Terminal UI (Textual)
pip install stegg[web]      # Web UI (NiceGUI)
pip install stegg[crypto]   # AES-256-GCM encryption
pip install stegg[mcp]      # MCP server for AI agents
pip install stegg[all]      # Everything

すべてが100％クライアントサイドで実行されます。データがお使いのマシンを離れることはありません。

### ソースから```bash
git clone https://github.com/elder-plinius/st3gg.git
cd st3gg
pip install -e ".[all]"

### AIエージェント統合

AIエージェント向けの2つのインターフェース — コンテキストコストのニーズに基づいて選択:```bash
# CLI (subprocess, zero context cost — output stays out of LLM context)
stegg-cli encode -i carrier.png -t "secret" -o stegged.png
stegg-cli decode -i stegged.png
stegg-cli analyze suspect.png --full

# MCP server (stdio transport — results go into agent context)
stegg-mcp  # or: uv run --extra mcp python3 mcp_server.py

A 1920x1080 image with RGB 1-bit holds ~760KB. With RGBA 4-bit: **~4MB**.

---

## ⊰ 暗号 ⊱

| 方式 | 強度 | 速度 | 使用例 |
|--------|----------|-------|----------|
| **AES-256-GCM** | 最大 | 中程度 | Ghost Mode |
| **XOR Obfuscation** | 最小限 | 高速 | 基本スクランブルのみ（暗号化ではない） |
| **None** | - | 最速 | 秘密性が必要ない場合 |

---

## ⊰ サンプルライブラリ ⊱

ST3GGには**100以上の事前エンコードされたサンプルファイル**が付属しており、あらゆる手法を網羅しています — 画像、音声、ドキュメント、ネットワークキャプチャ、コードファイルなど。それぞれに分析ツールが見つけられる隠しメッセージが含まれています。```bash
# Regenerate all examples
python examples/generate_examples.py

# Run the full test suite (200+ tests)
python test_examples.py

---

## ⊰ セキュリティノート ⊱

- 標準的なLSBステガノグラフィは**統計的に検出可能**です — カイ二乗検定やビットプレーン分析で露見する可能性があります
- **SPECTERチャンネル暗号**はチャンネルを予測不能にホッピングすることで耐性を高めます
- **ゴーストモード**は暗号化 + スクランブル + ノイズを追加し、最大の隠蔽性を実現します
- **DCTモード**は圧縮耐性を目的に設計; **F5モード**はJPEG再圧縮に耐えることが実証されています
- **LSB**はあらゆるJPEG圧縮で破壊されます — PNG形式のみ使用してください
- 埋め込む前に機密データは必ず**暗号化**してください
- 最大のセキュリティを得るには: **ゴーストモード + DCT + 強力なパスワード**

---

## ⊰ ロードマップ ⊱```
╔══════════════════════════════════════════════════════════════════╗
║                    ST3GG EVOLUTION ROADMAP                       ║
╠══════════════════════════════════════════════════════════════════╣
║                                                                  ║
║  ✅ SHIPPED                                                      ║
║  ────────                                                        ║
║  ✓ 112 steganographic techniques across all modalities           ║
║  ✓ 15 channel presets × 8 bit depths = 120 LSB combinations     ║
║  ✓ 8 encoding methods (LSB, DCT, PVD, F5, Chroma, Palette,     ║
║    Spread Spectrum, SPECTER channel cipher)                      ║
║  ✓ AI Agent with Reveal + Conceal modes                          ║
║  ✓ 13 text steganography methods with encode + decode            ║
║  ✓ 50 registered analysis/decode tools                           ║
║  ✓ RS Analysis + Sample Pairs Analysis (academic steganalysis)   ║
║  ✓ Raw PNG parser (bypasses canvas premultiplied alpha)          ║
║  ✓ Password-derived headers (stealth mode)                       ║
║  ✓ AES-256-GCM with PBKDF2 600k iterations                      ║
║  ✓ AI carrier image generation (OpenRouter + procedural)         ║
║  ✓ 109 example files, 568 automated tests                        ║
║  ✓ pip install stegg                                              ║
║  ✓ 100% browser-based at ste.gg                                  ║
║                                                                  ║
║  🔜 NEXT UP                                                      ║
║  ──────────                                                      ║
║  ○ Spread + Randomized strategies in browser                     ║
║    (defined but only interleaved is implemented)                 ║
║  ○ Password brute-forcer with wordlist support                   ║
║    (Stegseek does 10M/sec — we should match it)                 ║
║  ○ Content-adaptive embedding (HUGO/WOW-inspired)                ║
║    (embed in texture, skip smooth areas)                         ║
║  ○ Steghide format compatibility                                 ║
║    (read/write steghide's embedding format)                      ║
║  ○ Weighted Stego (WS) analysis                                  ║
║    (more accurate LSB detection than chi-square)                 ║
║  ○ Calibrated RS/SPA for real-world detection accuracy           ║
║                                                                  ║
║  🔮 FUTURE                                                       ║
║  ──────────                                                      ║
║  ○ ML-based steganalysis                                         ║
║    (CNN trained on StegoAppDB — Aletheia-grade detection)        ║
║  ○ nsF5 / S-UNIWARD embedding                                    ║
║    (academic state-of-the-art, minimal detectability)            ║
║  ○ Adversarial steganography                                     ║
║    (GAN-based embedding that defeats ML detectors)               ║
║  ○ Video steganography (frame-by-frame + temporal)               ║
║  ○ Network protocol live capture + injection                     ║
║    (real-time covert channel creation, not just PCAPs)           ║
║  ○ WebAssembly acceleration for browser-side analysis            ║
║  ○ Plugin system for community-contributed techniques            ║
║  ○ Mobile-native app (iOS/Android)                               ║
║  ○ VS Code / JetBrains extension for inline text steg            ║
║  ○ MCP server for Claude Code / AI agent integration             ║
║                                                                  ║
║  🌊 MOONSHOTS                                                    ║
║  ────────────                                                    ║
║  ○ Quantum-resistant steganographic protocols                    ║
║  ○ Blockchain-anchored provenance watermarking                   ║
║  ○ Cross-modal steganography (hide audio in images,              ║
║    images in text, text in network traffic)                      ║
║  ○ Federated steganalysis (distributed detection network)        ║
║  ○ Self-modifying steganographic payloads                        ║
║  ○ Steganographic filesystem (deniable encryption layer)         ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

特に貢献を歓迎する分野：
- **MLステガノーシス（ML steganalysis）** — ステゴデータセットで検出モデルを学習
- **新しいエンコーディング手法** — 学術的手法（HUGO、WOW、HILL、UNIWARD）
- **フォーマット対応** — HEIC、AVIF、FLAC、MP4ステガノグラフィ
- **Steghide互換性** — steghideのフォーマットをネイティブで読み書き
- **パフォーマンス** — ブラウザ側解析のためのWebAssembly
- **モバイル** — レスポンシブ改善、ネイティブアプリラッパー

---

## ⊰ ライセンス ⊱

**AGPL-3.0** — 個人、研究者、教育者、オープンソースプロジェクト向けの無料オープンソースです。詳細は[LICENSE](https://github.com/elder-plinius/st3gg/blob/main/LICENSE)をご覧ください。

**エンタープライズ/商用利用？** コードをオープンソース化せずにプロプライエタリ製品やSaaSでST3GGを使用したい場合は、商用ライセンスについてお問い合わせください。

このツールは、**許可されたセキュリティ研究**、**CTF競技**、**デジタルフォレンジック教育**、**プライバシー研究**を目的としています。責任を持って使用してください。

---

<div align="center">```
⊰•-•✧•-•-⦑ ST3GG ⦒-•-•✧•-•⊱
  every pixel has a story
    you just can't see it
           🦕︁