# Syntrix Nova

KI-Assistent fuer Chrome mit 20+ Cloud Providern, Browser-Steuerung, Screenshot-Vision, Web-Suche und Terminal-Zugriff.

## Version

**v1.0.0**

## Installation

1. Chrome oeffnen und zu `chrome://extensions/` navigieren
2. **Developer Mode** (oben rechts) einschalten
3. **"Load unpacked"** klicken
4. Den Ordner `syntrix-nova/` auswaehlen
5. Syntrix Nova erscheint in der Extension-Leiste

## Ersteinrichtung

1. Auf das Syntrix Nova Icon klicken
2. **Einstellungen** oeffnen (Zahnrad-Icon)
3. Unter **"Provider & API Keys"** mindestens einen Provider konfigurieren
4. API Key eintragen und **"Verbindung testen"** klicken
5. Fertig!

## 20 Cloud Provider

| # | Provider | Format |
|---|---|---|
| 1 | OpenAI | OpenAI-kompatibel |
| 2 | Anthropic | Anthropic nativ |
| 3 | Z.AI | OpenAI-kompatibel |
| 4 | Z.AI Coding Plan | OpenAI-kompatibel |
| 5 | MiniMax | OpenAI-kompatibel |
| 6 | MiniMax (International) | OpenAI-kompatibel |
| 7 | MiniMax (China) | OpenAI-kompatibel |
| 8 | Google Gemini | Google nativ |
| 9 | GitHub Copilot | OAuth |
| 10 | OpenRouter | OpenAI-kompatibel |
| 11 | Mistral AI | OpenAI-kompatibel |
| 12 | DeepSeek | OpenAI-kompatibel |
| 13 | xAI (Grok) | OpenAI-kompatibel |
| 14 | Groq | OpenAI-kompatibel |
| 15 | Cohere | OpenAI-kompatibel |
| 16 | Perplexity | OpenAI-kompatibel |
| 17 | Azure OpenAI | OpenAI-kompatibel |
| 18 | HuggingFace | OpenAI-kompatibel |
| 19 | Cerebras | OpenAI-kompatibel |
| 20 | Ollama Cloud | OpenAI-kompatibel |

## Features

### Chat
- Streaming-Responses (Echtzeit)
- Function Calling / Tool-Use Loop
- Conversation History
- Markdown-Rendering + Code-Highlighting

### Browser-Tools
- **Read Page**: Seiteninhalt lesen
- **Read Selection**: Markierten Text lesen
- **Write DOM**: Text/HTML in Seite einfuegen
- **Execute JS**: JavaScript auf der Seite ausfuehren
- **Fill Forms**: Formularfelder ausfuellen
- **Click Elements**: Elemente anklicken
- **Screenshot**: Screenshot erstellen + Vision-Analyse
- **Navigate**: Tab navigieren
- **Manage Tabs**: Tabs oeffnen, schliessen, wechseln

### Web-Suche
- Google Custom Search API Integration
- In Einstellungen konfigurieren (API Key + CX)

### Terminal (Optional)
- Native Messaging Host fuer Shell-Befehle
- Setup: `native-host/install.bat` ausfuehren
- Benoetigt Node.js

## Dateistruktur

```
syntrix-nova/
├── manifest.json                 # Chrome Extension Manifest V3
├── package.json                  # Projekt-Metadaten + Version
├── popup/                        # Kompakte Popup-UI
├── sidepanel/                    # Persistente Seitenleiste (Haupt-UI)
├── options/                      # Einstellungsseite
├── background/                   # Service Worker
├── content/                      # Content Script (DOM-Interaktion)
├── native-host/                  # Terminal-Zugriff (Native Messaging)
├── lib/                          # Kern-Bibliotheken
│   ├── providers.js              # 20 Provider + Modelle
│   ├── api-client.js             # API-Client (OpenAI, Anthropic, Google)
│   ├── chat-engine.js            # Chat-Loop mit Streaming + Tools
│   ├── tools.js                  # Tool-Definitionen + Ausfuehrung
│   └── utils.js                  # Helpers, Storage, Markdown
├── assets/icons/                 # Extension-Icons
└── docs/                         # Dokumentation
    ├── README.md
    └── CHANGELOG.md
```

## Versionierung

Semantic Versioning (semver): MAJOR.MINOR.PATCH

- `v1.0.0` → Erstveröffentlichung
- `v1.0.1` → Bugfix
- `v1.1.0` → Neues Feature
- `v2.0.0` → Breaking Change

Siehe [CHANGELOG.md](docs/CHANGELOG.md) fuer Details.

## Updates

1. Code-Aenderungen werden im `syntrix-nova/` Ordner gespeichert
2. Chrome: `chrome://extensions/` → Refresh-Icon bei Syntrix Nova
3. Git Commit sichert jede Version lokal

## Lizenz

MIT
