`run.sh` スクリプトは自動的に以下を実行します：
- ✅ Go および Python 環境のチェックと検証
- ✅ Python 仮想環境の作成
- ✅ Python 依存関係のインストール
- ✅ Go 依存関係のダウンロード
- ✅ プロジェクトのビルド
- ✅ サーバーの起動

**起動の確認:**

1. ターミナルに `● ONLINE` とそれに続く実際の Web UI URL が表示されることを確認します。
2. その URL を開きます。デフォルトの HTTPS モードではローカルの自己署名証明書を使用するため、ブラウザの警告を一度だけ受け入れてください。
3. 新規インストールの場合、`ADMIN SETUP REQUIRED` の下に表示される一度きりの `admin` パスワードを保存し、サインインしてすぐに変更します。

**ネットワークのデフォルト:** `run.sh` はサーバーを **`--https`** とリポジトリの **`config.yaml`** で起動します（ローカルの自己署名 TLS。多数の同時ストリームに適しています）。プレーンな HTTP の場合は **`./run.sh --http`** を使用します。本番環境では、**`config.yaml`** の **`server.tls_cert_path`** / **`server.tls_key_path`** を設定します（そこにあるコメントを参照）。手動実行の場合は、**`--https`** または **`CYBERSTRIKE_HTTPS=1`** を追加します。**`-config`** が間違っている場合、バイナリは stderr に短い使用法のヒントを出力します。

**初回設定:**
1. **AI チャネルの設定**（初回使用前に必須）
   - 起動後、**`https://127.0.0.1:8080/`**（または **`https://localhost:8080/`**。**8080** は `config.yaml` の `server.port` に置き換えてください）を開き、自己署名証明書の警告を一度だけ受け入れます。`./run.sh --http` を使用した場合は、代わりに **`http://`** を使用します。
   - `System Settings` → `Basic Settings` → `AI Channel Configuration` に移動し、チャネルを追加または編集して、プロバイダー、Base URL、API キー、モデル、トークン制限を入力します。**Save changes** をクリックします。左側のチャネルリストでは、デフォルトの設定、コピー、削除、一括プローブがサポートされています。
     ```yaml
     ai:
       default_channel: openai-main
       channels:
         openai-main:
           name: OpenAI Main
           provider: openai_compatible
           api_key: "${OPENAI_API_KEY}"
           base_url: "https://api.openai.com/v1"  # or https://api.deepseek.com/v1
           model: "gpt-4o"  # or deepseek-chat, qwen3-max, etc.
           max_total_tokens: 120000
           max_completion_tokens: 16384
     ```
   - または、起動前に `config.yaml` を直接編集します。`ai.default_channel` は、チャネルを明示的に選択しない新しい会話やタスクに使用されます。チャットページでは、セッションごとに保存済みの任意のチャネルを選択することもできます。
2. **ログイン** - 初回起動時に、コンソールに自動生成された初期 `admin` パスワードが出力されます。アカウントは **Platform permissions → User management** から作成します。
3. **セキュリティツールのインストール（オプション）** - 必要に応じて `tools/` からツールをインストールします。不足しているツールは実行時にスキップまたは代替されます。一般的な例:

   **macOS（Homebrew）:**   ```bash
   brew install nmap masscan sqlmap nikto gobuster ffuf hydra hashcat nuclei subfinder

`tools/` ディレクトリで完全なリストを確認してください。各ツールのインストール詳細については、公式ドキュメントを参照してください。

**代替の起動方法:**```bash
# Direct Go run (set up env yourself); add --https to match run.sh defaults
go run cmd/server/main.go --https

# Manual build
go build -o cyberstrike-ai cmd/server/main.go
./cyberstrike-ai --https

`openai` は後方互換性を保つためのランタイムフィールドです。新しいモデル設定は `ai.channels` に保持してください。実際の認証情報をコミットしないでください。サービスを localhost の外部に公開する前に、[設定リファレンス](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md)、[推奨プロファイル](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md)、および[セキュリティ強化ガイド](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md)を確認してください。

## 関連ドキュメント

- **新規ユーザー:** [デプロイ](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/deployment.md) → [設定](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration.md) → [トラブルシューティング](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/troubleshooting.md)
- **運用担当者:** [設定プロファイル](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/configuration-profiles.md) → [セキュリティ強化](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/security-hardening.md) → [ランブック](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/runbooks.md)
- **インテグレーター:** [API リファレンス](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-reference.md) → [API レシピ](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/api-recipes.md) → [MCP フェデレーション](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/mcp-federation.md)
- **コントリビューター:** [開発者ガイド](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/developer-guide.md) → [テスト](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/testing.md) → [コントリビューション](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/contributing-guide.md)
- **全トピック:** [英語ドキュメント](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/en-US/README.md) · [バイリンガルドキュメント索引](https://github.com/ed1s0nz/cyberstrikeai/blob/main/docs/README.md)

## プロジェクト構成```
CyberStrikeAI/
├── cmd/                 # Server, MCP stdio entrypoints, tooling
├── internal/            # Agent, MCP core, handlers, C2 (`internal/c2`), security executor
├── web/                 # Static SPA + templates
├── tools/               # YAML tool recipes (100+ examples provided)
├── roles/               # Role configurations (12+ predefined security testing roles)
├── skills/              # Agent Skills dirs (SKILL.md + optional files; demo: cyberstrike-eino-demo)
├── agents/              # Multi-agent Markdown (orchestrator.md + sub-agent *.md)
├── docs/                # Topic docs (deployment, config, security, API, knowledge base, C2, WebShell, etc.)
├── images/              # Docs screenshots & diagrams
├── scripts/             # Repository maintenance checks, including documentation validation
├── config.yaml          # Runtime configuration
├── run.sh               # Convenience launcher
└── README*.md

## 高度なプレイブック```
Load the recon-engagement template, run amass/subfinder, then brute-force dirs on every live host.
Use external Burp-based MCP server for authenticated traffic replay, then pass findings back for graphing.
Compress the 5 MB nuclei report, summarize critical CVEs, and attach the artifact to the conversation.
Build an attack chain for the latest engagement and export the node list with severity >= high.