meleki/gott
1
0 Fork 0
Code Activity

docs: Dokumentation an aktuellen Code-Stand anpassen

Browse Source 
Neue Features dokumentiert: Claude CLI Integration, DB Explorer, MCP-Server (Internal API),
Key-Scanner-System (KeyPatterns, KeyCheckDispatcher, GitHubEventScannerService),
Multi-Provider Key-Checker (OpenAI, Google, Stripe), AnthropicService partial-class Aufteilung,
2 neue Tools (github_code_search, serper_web_search → 19 Tools), OpenAI als Provider,
typing-phrases.js, AppPaths, payload-preview Endpoint.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
MelekiandClaude Opus 4.6 committed 2026-03-19 10:03:30 +01:00
1 parent d1c8aa62f2
commit 486a1be6b5
3 files changed
+239 -64
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

ARCHITECTURE.md
+194 -45
View File
@@ -1,6 +1,6 @@
# ARCHITECTURE.md – Gott # ARCHITECTURE.md – Gott
**Gott** ist eine selbst-gehostete AI-Chat-Plattform, gebaut auf **.NET 10** mit **Anthropic Claude API** als Haupt-Provider sowie **OpenAI-kompatiblen Providern** (Nvidia, Pollinations, Gemini). Sie bietet Multi-User-Support, persistente Agent-Memory, 17 Tools (Dateien, Shell, Suche, Memory, Remote-Execution), semantische Suche via lokalen Embeddings, Telegram-Integration, Cronjobs, Remote-Verbindungen und eine Krea-Bildgenerierung – alles über ein Vanilla-JavaScript-Frontend gesteuert. **Gott** ist eine selbst-gehostete AI-Chat-Plattform, gebaut auf **.NET 10** mit **Anthropic Claude API** als Haupt-Provider (inkl. Claude CLI-Integration) sowie **OpenAI-kompatiblen Providern** (Nvidia, Pollinations, Gemini, OpenAI). Sie bietet Multi-User-Support, persistente Agent-Memory, 19 Tools (Dateien, Shell, Suche, Memory, Remote-Execution, Web-Search, GitHub Code Search), semantische Suche via lokalen Embeddings, Telegram-Integration, Cronjobs, Remote-Verbindungen, Krea-Bildgenerierung und einen Multi-Provider Key-Scanner – alles über ein Vanilla-JavaScript-Frontend gesteuert.
--- ---
@@ -33,18 +33,23 @@
19. [Multi-Agent System (Preparer + Review + Finalizer)](#multi-agent-system-preparer--review--finalizer) 19. [Multi-Agent System (Preparer + Review + Finalizer)](#multi-agent-system-preparer--review--finalizer)
20. [Interaktive Rückfragen (ask_user_choice)](#interaktive-rückfragen-ask_user_choice) 20. [Interaktive Rückfragen (ask_user_choice)](#interaktive-rückfragen-ask_user_choice)
21. [Plan-Modus](#plan-modus) 21. [Plan-Modus](#plan-modus)
22. [Nachrichten teilen (Shared Messages)](#nachrichten-teilen-shared-messages) 22. [Web-Search](#web-search)
23. [Workspace & File-Explorer](#workspace--file-explorer) 23. [Nachrichten teilen (Shared Messages)](#nachrichten-teilen-shared-messages)
24. [Avatar-System](#avatar-system) 24. [Workspace & File-Explorer](#workspace--file-explorer)
25. [LaTeX/Math-Rendering](#latexmath-rendering) 25. [Avatar-System](#avatar-system)
26. [Windows Desktop App](#windows-desktop-app) 26. [LaTeX/Math-Rendering](#latexmath-rendering)
27. [OpenClaw Import](#openclaw-import) 27. [Windows Desktop App](#windows-desktop-app)
28. [Remote-Verbindungen](#remote-verbindungen) 28. [OpenClaw Import](#openclaw-import)
29. [Semantische Suche (Embedding)](#semantische-suche-embedding) 29. [Remote-Verbindungen](#remote-verbindungen)
30. [API-Key-Verwaltung](#api-key-verwaltung) 30. [Semantische Suche (Embedding)](#semantische-suche-embedding)
31. [Deployment](#deployment) 31. [API-Key-Verwaltung](#api-key-verwaltung)
32. [Konfiguration](#konfiguration) 32. [Key-Scanner-System](#key-scanner-system)
33. [Datenbank-Migrationen](#datenbank-migrationen) 33. [Claude CLI Integration](#claude-cli-integration)
34. [Datenbank-Explorer](#datenbank-explorer)
35. [MCP-Server-Integration (Internal API)](#mcp-server-integration-internal-api)
36. [Deployment](#deployment)
37. [Konfiguration](#konfiguration)
38. [Datenbank-Migrationen](#datenbank-migrationen)
--- ---
@@ -61,20 +66,23 @@
│ Auth │ Chat │ Hist │ Sess │Agent │ Tele │ Cron │ Krea │Adm │ │ Auth │ Chat │ Hist │ Sess │Agent │ Tele │ Cron │ Krea │Adm │
│ │ SSE │ │ │ │ gram │ jobs │ Img │ in │ │ │ SSE │ │ │ │ gram │ jobs │ Img │ in │
│ │ │ │ │ │ │ │ │Keys│ │ │ │ │ │ │ │ │ │Keys│
│ │ CLI │ │ │ │ │ │ │DbEx│
├──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴────┤ ├──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴────┤
│ Services Layer │ │ Services Layer │
│ AnthropicService · OpenAiService · ChatService · ToolService│ │ AnthropicService · OpenAiService · ChatService · ToolService│
│ DatabaseService · MemoryService · SkillService · SseHelper │ │ ClaudeCliService · DatabaseService · MemoryService · SkillService│
│ EmbeddingService · VectorSearchService │ │ SseHelper · EmbeddingService · VectorSearchService │
│ RemoteConnectionManager · TelegramService │ │ RemoteConnectionManager · TelegramService │
│ CronjobService · KreaService │ │ CronjobService · KreaService · KeyCheckDispatcher │
│ KeyScannerService · GitHubEventScannerService │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ SQLite (data/gott.db) via Dapper │ │ SQLite (data/gott.db) via Dapper │
│ ONNX Runtime (Embeddings) │ │ ONNX Runtime (Embeddings) │
│ Filesystem (data/agents/, data/skills/) │ │ Filesystem (data/agents/, data/skills/) │
├─────────────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────────────┤
│ Anthropic Claude API (claude-sonnet/opus/haiku) │ │ Anthropic Claude API (claude-sonnet/opus/haiku) │
│ OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini) │ │ Claude CLI (OAuth-basiert, kein API-Key nötig) │
│ OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini, OpenAI) │
│ Krea API (Bildgenerierung) │ │ Krea API (Bildgenerierung) │
│ Telegram Bot API │ │ Telegram Bot API │
└─────────────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────────────┘
@@ -89,7 +97,7 @@
| **Runtime** | .NET 10 (ohne Nullable, ohne Implicit Usings) | | **Runtime** | .NET 10 (ohne Nullable, ohne Implicit Usings) |
| **Web** | ASP.NET Minimal API, Kestrel | | **Web** | ASP.NET Minimal API, Kestrel |
| **Datenbank** | SQLite via Microsoft.Data.Sqlite + Dapper | | **Datenbank** | SQLite via Microsoft.Data.Sqlite + Dapper |
| **AI** | Anthropic Claude API (Streaming SSE + Non-Streaming), OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini) | | **AI** | Anthropic Claude API (Streaming SSE + Non-Streaming), Claude CLI (OAuth), OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini, OpenAI) |
| **Images** | SixLabors.ImageSharp (Resize, Thumbnails) | | **Images** | SixLabors.ImageSharp (Resize, Thumbnails) |
| **Cron** | Cronos (Cron-Expression-Parsing) | | **Cron** | Cronos (Cron-Expression-Parsing) |
| **Frontend** | Vanilla JavaScript SPA (kein Framework) | | **Frontend** | Vanilla JavaScript SPA (kein Framework) |
@@ -136,10 +144,14 @@ gott/
│ ├── DatabaseService.Integrations.cs # Telegram, Cronjobs, API Keys, OpenClaw Import │ ├── DatabaseService.Integrations.cs # Telegram, Cronjobs, API Keys, OpenClaw Import
│ ├── AuthService.cs # Token-basierte Authentifizierung │ ├── AuthService.cs # Token-basierte Authentifizierung
│ ├── ChatService.cs # Kontext-Aufbau, History-Builder │ ├── ChatService.cs # Kontext-Aufbau, History-Builder
│ ├── AnthropicService.cs # Claude API (Streaming + Non-Streaming) │ ├── AnthropicService.cs # Claude API – Haupt-Service (partial class)
│ ├── OpenAiService.cs # OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini) │ ├── AnthropicService.Streaming.cs # Claude API – Streaming-Logic (StreamChat)
│ ├── AnthropicService.Agents.cs # Claude API – Sub-Agent-Logic (Preparer, Review, Finalizer)
│ ├── AnthropicService.Cli.cs # Claude API – CLI-basiertes Streaming (StreamChatViaCli)
│ ├── ClaudeCliService.cs # Claude Code CLI Wrapper (OAuth-basiert, kein API-Key nötig)
│ ├── OpenAiService.cs # OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini, OpenAI)
│ ├── SseHelper.cs # Shared SSE-Utilities (WriteSseEvent, TryWriteSse, FinalizeChain) │ ├── SseHelper.cs # Shared SSE-Utilities (WriteSseEvent, TryWriteSse, FinalizeChain)
│ ├── ToolService.cs # Tool-Definitionen + Ausführung (17 Tools) │ ├── ToolService.cs # Tool-Definitionen + Ausführung (19 Tools)
│ ├── SystemPromptBuilder.cs # Modularer System-Prompt aus Blöcken │ ├── SystemPromptBuilder.cs # Modularer System-Prompt aus Blöcken
│ ├── MemoryService.cs # Agent-Gedächtnis (Dateisystem) │ ├── MemoryService.cs # Agent-Gedächtnis (Dateisystem)
│ ├── SkillService.cs # Skill-Verwaltung (Dateisystem) │ ├── SkillService.cs # Skill-Verwaltung (Dateisystem)
@@ -152,28 +164,37 @@ gott/
│ ├── KreaService.cs # Krea Image Generation API │ ├── KreaService.cs # Krea Image Generation API
│ ├── ImageService.cs # Bild-Resize + WebP-Konvertierung (512px + 256px Thumbnail) │ ├── ImageService.cs # Bild-Resize + WebP-Konvertierung (512px + 256px Thumbnail)
│ ├── StreamingTracker.cs # Tracking aktiver Streams + CancellationTokenSource für Stop │ ├── StreamingTracker.cs # Tracking aktiver Streams + CancellationTokenSource für Stop
│ ├── WorkspaceHelper.cs # Workspace-Pfad-Auflösung (relativ → absolut) │ ├── WorkspaceHelper.cs # Workspace-Pfad-Auflösung (relativ → absolut)
│ ├── AppPaths.cs # Zentrale Pfade (WwwRoot) – Dev vs. Publish-Modus
│ ├── KeyScannerService.cs # API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper) │ ├── KeyScannerService.cs # API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper)
│ ├── GitHubEventScannerService.cs # Echtzeit-Scanner: GitHub Public Events API (PushEvent-Diffs nach Keys scannen)
│ ├── KeyPatterns.cs # Zentrale Key-Pattern-Definitionen für alle Scanner (Regex + Typ-Erkennung)
│ ├── KeyCheckDispatcher.cs # Zentraler Dispatcher für Key-Checks aller Provider (normalisiertes Ergebnis)
│ ├── AnthropicKeyChecker.cs # Anthropic Key-Validierung + Usage-Header-Auswertung │ ├── AnthropicKeyChecker.cs # Anthropic Key-Validierung + Usage-Header-Auswertung
│ ├── OpenAiKeyChecker.cs # OpenAI Key-Validierung (Models-Endpoint, Rate-Limits)
│ ├── GoogleKeyChecker.cs # Google/Gemini Key-Validierung (Models + Quota-Check)
│ ├── StripeKeyChecker.cs # Stripe Key-Validierung (Balance, Account-Info)
│ └── ServerSettingsService.cs # Server-Settings Verwaltung (In-Memory-Cache + DB) │ └── ServerSettingsService.cs # Server-Settings Verwaltung (In-Memory-Cache + DB)
│ │
├── Endpoints/ # HTTP API (Minimal API) ├── Endpoints/ # HTTP API (Minimal API)
│ ├── AuthEndpoint.cs # Login, Logout, Me │ ├── AuthEndpoint.cs # Login, Logout, Me, Autologin
│ ├── ChatEndpoint.cs # POST /api/chat (SSE Streaming) │ ├── ChatEndpoint.cs # POST /api/chat (SSE Streaming + CLI-Fallback)
│ ├── HistoryEndpoint.cs # History, Archive, Attachments, Marks │ ├── HistoryEndpoint.cs # History, Archive, Attachments, Marks, Chain-Details
│ ├── SessionEndpoint.cs # CRUD + SystemPrompt, Exec, Git-Status │ ├── SessionEndpoint.cs # CRUD + SystemPrompt, SystemPromptBlocks, PayloadPreview, Streaming, Exec, Git-Status
│ ├── AgentEndpoint.cs # CRUD │ ├── AgentEndpoint.cs # CRUD + Available (inkl. public agents)
│ ├── WorkspaceEndpoint.cs # File-Tree, File-Read/Write, Browse, Agent-Files │ ├── WorkspaceEndpoint.cs # File-Tree, File-Read/Write, Browse, Agent-Files, Raw-Download
│ ├── TelegramEndpoint.cs # Bot-CRUD, Webhook, Session-Config, Registration │ ├── TelegramEndpoint.cs # Bot-CRUD, Webhook, Session-Config, Registration
│ ├── OpenClawEndpoint.cs # OpenClaw Session Import │ ├── OpenClawEndpoint.cs # OpenClaw Session Import
│ ├── CronjobEndpoint.cs # CRUD + Toggle, Manual Run │ ├── CronjobEndpoint.cs # CRUD + Toggle, Manual Run
│ ├── KreaEndpoint.cs # Generate, List, File-Serve │ ├── KreaEndpoint.cs # Generate, List, File-Serve
│ ├── SkillEndpoint.cs # List, Agent-Skill-Mapping, Output-Files │ ├── SkillEndpoint.cs # List, Agent-Skill-Mapping, Output-Files
│ ├── ModelsEndpoint.cs # Provider-Modelle (nvidia, pollinations, gemini, refresh) │ ├── ModelsEndpoint.cs # Provider-Modelle (nvidia, pollinations, gemini, openai, refresh)
│ ├── SharedEndpoint.cs # Nachrichten teilen (öffentliche Links) │ ├── SharedEndpoint.cs # Nachrichten teilen (öffentliche Links)
│ ├── AdminEndpoint.cs # Admin: User-CRUD, Impersonate (Admin-only) │ ├── AdminEndpoint.cs # Admin: User-CRUD, Impersonate, Login-Link (Admin-only)
│ ├── ApiKeysEndpoint.cs # Admin: API-Key-CRUD, Activate/Deactivate, Check, Scan, Adopt (Admin-only) │ ├── ApiKeysEndpoint.cs # Admin: API-Key-CRUD, Check, CheckAll, Scan, Event-Scanner, Adopt + User: Available, Select (Admin-only / User)
│ ├── RemoteEndpoint.cs # Remote-Verbindungen: WebSocket, Assign/Unassign, PowerShell-Script │ ├── RemoteEndpoint.cs # Remote-Verbindungen: WebSocket, Assign/Unassign, PowerShell-Script
│ ├── InternalEndpoint.cs # Interne API für MCP-Server (Remote-Execute, Ask-User-Choice, Memory-CRUD, Token-gesichert)
│ ├── DatabaseExplorerEndpoint.cs # Admin: DB-Tabellen lesen (Tables, TableData) (Admin-only)
│ ├── ServerSettingsEndpoint.cs # Admin: Server-Settings lesen/schreiben (Admin-only) │ ├── ServerSettingsEndpoint.cs # Admin: Server-Settings lesen/schreiben (Admin-only)
│ ├── ProfileEndpoint.cs # Profil, Persona, Passwort │ ├── ProfileEndpoint.cs # Profil, Persona, Passwort
│ ├── SettingsEndpoint.cs # User-Settings (JSON blob) │ ├── SettingsEndpoint.cs # User-Settings (JSON blob)
@@ -236,17 +257,20 @@ gott/
│ │ ├── emoji.userdata.js # Häufig genutzte Emojis │ │ ├── emoji.userdata.js # Häufig genutzte Emojis
│ │ ├── tooltip.js # Tooltip-System │ │ ├── tooltip.js # Tooltip-System
│ │ ├── title.js # Tab-Titel-Management + Embedding-Warnung │ │ ├── title.js # Tab-Titel-Management + Embedding-Warnung
│ │ ├── typing-phrases.js # Zufällige Typing-Indicator-Texte (Wienerisch)
│ │ ├── pages/ # Seiten-Komponenten │ │ ├── pages/ # Seiten-Komponenten
│ │ │ ├── chat-page.js # Haupt-Chat-Ansicht (inkl. Remote-Button, Usage-Badge-Overlay, Key-Switch-Modal) │ │ │ ├── chat-page.js # Haupt-Chat-Ansicht (inkl. Remote-Button, Usage-Badge-Overlay, Key-Switch-Modal)
│ │ │ ├── dashboard.js # Dashboard / Home (inkl. API-Keys-Link) │ │ │ ├── dashboard.js # Dashboard / Home (inkl. API-Keys-Link, DB-Explorer-Link)
│ │ │ ├── session-page.js # Session-Einstellungen │ │ │ ├── session-page.js # Session-Einstellungen
│ │ │ ├── agent-page.js # Agent-Editor │ │ │ ├── agent-page.js # Agent-Editor
│ │ │ ├── telegram-bot-page.js # Telegram-Bot-Editor │ │ │ ├── telegram-bot-page.js # Telegram-Bot-Editor
│ │ │ ├── cronjob-page.js # Cronjob-Verwaltung │ │ │ ├── cronjob-page.js # Cronjob-Verwaltung
│ │ │ ├── profile-page.js # Profil-Bearbeitung │ │ │ ├── profile-page.js # Profil-Bearbeitung
│ │ │ ├── admin-page.js # Admin: Benutzerverwaltung │ │ │ ├── admin-page.js # Admin: Benutzerverwaltung
│ │ │ ├── api-keys-page.js # Admin: API-Key-Verwaltung + Check + GitHub-Scanner │ │ │ ├── api-keys-page.js # Admin: API-Key-Verwaltung + Check + GitHub-Scanner + Event-Scanner
│ │ │ ├── db-explorer-page.js # Admin: Datenbank-Explorer (Tabellen + Daten)
│ │ │ ├── settings-page.js # App-Einstellungen │ │ │ ├── settings-page.js # App-Einstellungen
│ │ │ ├── server-settings-page.js # Admin: Servereinstellungen
│ │ │ ├── login-page.js # Login-Formular │ │ │ ├── login-page.js # Login-Formular
│ │ │ └── shared-page.js # Öffentliche geteilte Nachricht │ │ │ └── shared-page.js # Öffentliche geteilte Nachricht
│ │ └── lib/ # Vendor-Libraries │ │ └── lib/ # Vendor-Libraries
@@ -404,9 +428,9 @@ RemoteConnectionManager → AuthService → DatabaseService → EnsureDefaultUse
→ ImageService, StreamingTracker, MemoryService, SkillService → ImageService, StreamingTracker, MemoryService, SkillService
→ EmbeddingService → VectorSearchService → EmbeddingService → VectorSearchService
→ ToolService → ChatService → ToolService → ChatService
→ AnthropicService (Token aus DB: api_keys) → OpenAiService (+ LoadModelsAsync) → AnthropicService (Token aus DB: api_keys) → ClaudeCliService → OpenAiService (+ LoadModelsAsync)
→ TelegramService → KreaService → TelegramService → KreaService
→ CronjobService (BackgroundService) + EmbeddingBackgroundService (BackgroundService) → CronjobService (BackgroundService) + EmbeddingBackgroundService (BackgroundService) + GitHubEventScannerService (BackgroundService)
``` ```
### Services ### Services
@@ -416,10 +440,12 @@ RemoteConnectionManager → AuthService → DatabaseService → EnsureDefaultUse
| `DatabaseService` | Singleton | SQLite CRUD, Schema-Init, Migrationen, alle DB-Operationen | | `DatabaseService` | Singleton | SQLite CRUD, Schema-Init, Migrationen, alle DB-Operationen |
| `AuthService` | Singleton | Token-Erzeugung/-Validierung, Passwort-Hashing (SHA256) | | `AuthService` | Singleton | Token-Erzeugung/-Validierung, Passwort-Hashing (SHA256) |
| `ChatService` | Singleton | Chat-Kontext aufbauen, History aus DB rekonstruieren | | `ChatService` | Singleton | Chat-Kontext aufbauen, History aus DB rekonstruieren |
| `AnthropicService` | Singleton | Claude API Kommunikation (Streaming SSE + Non-Streaming), passive Usage-Aktualisierung nach jedem Request | | `AnthropicService` | Singleton | Claude API Kommunikation (partial class: Core, Streaming, Agents, Cli), passive Usage-Aktualisierung nach jedem Request |
| `OpenAiService` | Singleton | OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini) mit Tool-Calling, Streaming + Non-Streaming, Modell-Caching | | `ClaudeCliService` | Singleton | Claude Code CLI Wrapper (OAuth-basiert, kein API-Key nötig), prüft CLI-Verfügbarkeit beim Start |
| `ToolService` | Singleton | Tool-Definitionen bereitstellen, Tool-Aufrufe ausführen | | `OpenAiService` | Singleton | OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini, OpenAI) mit Tool-Calling, Streaming + Non-Streaming, Modell-Caching |
| `ToolService` | Singleton | Tool-Definitionen bereitstellen, Tool-Aufrufe ausführen (19 Tools) |
| `WorkspaceHelper` | Static | Workspace-Pfad-Auflösung (relativ → absolut), Path-Traversal-Schutz | | `WorkspaceHelper` | Static | Workspace-Pfad-Auflösung (relativ → absolut), Path-Traversal-Schutz |
| `AppPaths` | Static | Zentrale Pfade (WwwRoot), Dev-Modus vs. Publish-Modus Erkennung |
| `SystemPromptBuilder` | Static | Modularer System-Prompt aus konfigurierbaren Blöcken + Reminder-Generierung | | `SystemPromptBuilder` | Static | Modularer System-Prompt aus konfigurierbaren Blöcken + Reminder-Generierung |
| `MemoryService` | Singleton | Agent-Gedächtnis auf Dateisystem (MEMORY.md, IDENTITY.md etc.) | | `MemoryService` | Singleton | Agent-Gedächtnis auf Dateisystem (MEMORY.md, IDENTITY.md etc.) |
| `SkillService` | Singleton | Skill-Discovery und -Management aus Dateisystem | | `SkillService` | Singleton | Skill-Discovery und -Management aus Dateisystem |
@@ -434,7 +460,13 @@ RemoteConnectionManager → AuthService → DatabaseService → EnsureDefaultUse
| `ImageService` | Singleton | Bild-Resize + WebP-Konvertierung (512px + 256px Thumbnail) für Avatare und Session-Bilder | | `ImageService` | Singleton | Bild-Resize + WebP-Konvertierung (512px + 256px Thumbnail) für Avatare und Session-Bilder |
| `StreamingTracker` | Singleton | Trackt aktive Streams + CancellationTokenSource pro Session für Stop-Button | | `StreamingTracker` | Singleton | Trackt aktive Streams + CancellationTokenSource pro Session für Stop-Button |
| `KeyScannerService` | Singleton | API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), täglicher Scan | | `KeyScannerService` | Singleton | API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), täglicher Scan |
| `GitHubEventScannerService` | Background | Echtzeit-Scanner: GitHub Public Events API (PushEvent-Diffs nach geleakten Keys), 30s Poll-Intervall |
| `KeyPatterns` | Static | Zentrale Key-Pattern-Definitionen für alle Scanner (Regex, Typ-Erkennung, Display-Names) |
| `KeyCheckDispatcher` | Static | Zentraler Dispatcher für Key-Checks aller Provider, normalisiertes UnifiedKeyCheckResult |
| `AnthropicKeyChecker` | Static | Anthropic Key-Validierung via API-Request, Usage-Header-Auswertung (Plan, 7d/5h Usage) | | `AnthropicKeyChecker` | Static | Anthropic Key-Validierung via API-Request, Usage-Header-Auswertung (Plan, 7d/5h Usage) |
| `OpenAiKeyChecker` | Static | OpenAI Key-Validierung (GET /v1/models, Rate-Limits, Organization) |
| `GoogleKeyChecker` | Static | Google/Gemini Key-Validierung (Models-Listing + Quota-Check via GenerateContent) |
| `StripeKeyChecker` | Static | Stripe Key-Validierung (Balance, Account-Info, Payouts/Charges) |
| `ServerSettingsService` | Singleton | Server-Settings Verwaltung (In-Memory-Cache + DB), Cleanup obsoleter Settings | | `ServerSettingsService` | Singleton | Server-Settings Verwaltung (In-Memory-Cache + DB), Cleanup obsoleter Settings |
### Endpoints (API) ### Endpoints (API)
@@ -446,8 +478,8 @@ Alle Endpoints folgen dem **Minimal API**-Pattern mit Extension Methods (`MapXxx
| **Auth** | `/api/auth/` | `POST login`, `POST logout`, `GET me`, `GET autologin` | | **Auth** | `/api/auth/` | `POST login`, `POST logout`, `GET me`, `GET autologin` |
| **Chat** | `/api/chat` | `POST` (SSE Streaming), `POST stop` | | **Chat** | `/api/chat` | `POST` (SSE Streaming), `POST stop` |
| **History** | `/api/history` | `GET history`, `GET poll`, `POST archive`, `GET archives`, `GET archive/{id}`, `GET attachments/{id}`, `PUT messages/{id}/mark`, `PUT messages/{id}/delete`, `GET chains/{id}` | | **History** | `/api/history` | `GET history`, `GET poll`, `POST archive`, `GET archives`, `GET archive/{id}`, `GET attachments/{id}`, `PUT messages/{id}/mark`, `PUT messages/{id}/delete`, `GET chains/{id}` |
| **Sessions** | `/api/sessions/` | CRUD + `GET system-prompt`, `GET system-prompt-blocks`, `GET streaming`, `POST exec`, `GET git-status` (Liste inkl. inline Git-Status + Thumbnail) | | **Sessions** | `/api/sessions/` | CRUD + `GET system-prompt`, `GET system-prompt-blocks`, `GET payload-preview`, `GET streaming`, `POST exec`, `GET git-status` (Liste inkl. inline Git-Status + Thumbnail) |
| **Agents** | `/api/agents/` | CRUD (Liste inkl. inline Skills + Thumbnail) | | **Agents** | `/api/agents/` | CRUD + `GET available` (inkl. public agents, inline Skills + Thumbnail) |
| **Admin** | `/api/admin/` | `GET users`, `POST users`, `PUT users/{id}`, `PUT users/{id}/password`, `DELETE users/{id}`, `POST users/{id}/impersonate`, `POST users/{id}/login-link` (Admin-only) | | **Admin** | `/api/admin/` | `GET users`, `POST users`, `PUT users/{id}`, `PUT users/{id}/password`, `DELETE users/{id}`, `POST users/{id}/impersonate`, `POST users/{id}/login-link` (Admin-only) |
| **Workspace** | `/api/workspace/` | `GET tree`, `GET/PUT file`, `GET browse`, `POST mkdir`, `DELETE dir`, `POST browse/mkdir`, `GET agent/tree`, `GET/PUT agent/file`, `POST agent/mkdir`, `GET raw` | | **Workspace** | `/api/workspace/` | `GET tree`, `GET/PUT file`, `GET browse`, `POST mkdir`, `DELETE dir`, `POST browse/mkdir`, `GET agent/tree`, `GET/PUT agent/file`, `POST agent/mkdir`, `GET raw` |
| **Telegram** | `/api/telegram/` | Bot-CRUD (`/bots`, `/bots/available`), `POST webhook/{botId}` (unauthenticated), Session-Config, Webhook-Management | | **Telegram** | `/api/telegram/` | Bot-CRUD (`/bots`, `/bots/available`), `POST webhook/{botId}` (unauthenticated), Session-Config, Webhook-Management |
@@ -459,9 +491,11 @@ Alle Endpoints folgen dem **Minimal API**-Pattern mit Extension Methods (`MapXxx
| **Settings** | `/api/settings` | `GET`, `PUT` | | **Settings** | `/api/settings` | `GET`, `PUT` |
| **Backup** | `/api/backup` | `POST` (Admin only, tar.gz Download) | | **Backup** | `/api/backup` | `POST` (Admin only, tar.gz Download) |
| **Shared** | `/api/shared/`, `/api/messages/{id}/share` | Share erstellen, öffentlich abrufen, auflisten, löschen | | **Shared** | `/api/shared/`, `/api/messages/{id}/share` | Share erstellen, öffentlich abrufen, auflisten, löschen |
| **Models** | `/api/models/` | `GET nvidia`, `GET pollinations`, `GET gemini`, `POST refresh` | | **Models** | `/api/models/` | `GET nvidia`, `GET pollinations`, `GET gemini`, `GET openai`, `POST refresh` |
| **API Keys** | `/api/admin/api-keys/` | CRUD + `PUT activate/deactivate`, `POST check`, `POST scan`, `GET scan/status`, `GET scanned`, `POST scanned/{id}/adopt`, `POST scanned/{id}/recheck`, `DELETE scanned/{id}` (Admin-only) | | **API Keys** | `/api/admin/api-keys/` | CRUD + `PUT {id}/public`, `POST check`, `POST check-all`, `POST scan`, `GET scan/status`, `GET scanned`, `GET scanned/summary`, `POST scanned/recheck-all`, `POST scanned/{id}/recheck`, `POST scanned/{id}/adopt`, `DELETE scanned/{id}`, `GET event-scanner/status`, `GET event-scanner/log`, `GET scanner/logs` (Admin) + `/api/api-keys/` `GET available`, `PUT select/{keyId}`, `GET selected` (User) |
| **Remote** | `/api/remote` | WebSocket-Endpoint für Remote-Clients, `GET connections`, `POST assign/unassign`, `GET /remote.ps1` | | **Remote** | `/api/remote` | WebSocket-Endpoint für Remote-Clients, `GET connections`, `POST assign/unassign`, `GET /remote.ps1` |
| **Internal** | `/api/internal/` | `POST remote-execute`, `POST ask-user-choice`, `POST memory-read/write/list` (Token-gesichert für MCP-Server) + `POST /api/chat/choice-respond` (normale Auth) |
| **DB Explorer** | `/api/admin/db/` | `GET tables`, `GET tables/{name}` (Admin-only) |
| **Info** | `/api/info` | `GET` (Build-Zeitstempel + Embedding-Verfügbarkeit) | | **Info** | `/api/info` | `GET` (Build-Zeitstempel + Embedding-Verfügbarkeit) |
| **ServerSettings** | `/api/admin/server-settings` | `GET`, `PUT` (Admin-only, liest/schreibt `appsettings.Production.json`) | | **ServerSettings** | `/api/admin/server-settings` | `GET`, `PUT` (Admin-only, liest/schreibt `appsettings.Production.json`) |
@@ -523,6 +557,8 @@ Das Frontend ist eine **Single-Page Application** ohne Build-Step, komplett in V
| `#/profile` | `profile-page.js` | Profil | | `#/profile` | `profile-page.js` | Profil |
| `#/settings` | `settings-page.js` | App-Einstellungen | | `#/settings` | `settings-page.js` | App-Einstellungen |
| `#/admin` | `admin-page.js` | Benutzerverwaltung (Admin-only) | | `#/admin` | `admin-page.js` | Benutzerverwaltung (Admin-only) |
| `#/api-keys` | `api-keys-page.js` | API-Key-Verwaltung + GitHub-Scanner + Event-Scanner (Admin) |
| `#/db-explorer` | `db-explorer-page.js` | Datenbank-Explorer (Admin-only) |
| `#/server-settings` | `server-settings-page.js` | Servereinstellungen (Admin-only) | | `#/server-settings` | `server-settings-page.js` | Servereinstellungen (Admin-only) |
| `#/login` | `login-page.js` | Login | | `#/login` | `login-page.js` | Login |
| `#/shared/{token}` | `shared-page.js` | Öffentliche geteilte Nachricht (kein Auth) | | `#/shared/{token}` | `shared-page.js` | Öffentliche geteilte Nachricht (kein Auth) |
@@ -546,6 +582,7 @@ Das Frontend ist eine **Single-Page Application** ohne Build-Step, komplett in V
- **files.js** – File-Upload, Workspace-Refs - **files.js** – File-Upload, Workspace-Refs
- **session.js** – Session-State-Management (currentSessionId, currentAgentId, getCurrentAgentId()) - **session.js** – Session-State-Management (currentSessionId, currentAgentId, getCurrentAgentId())
- **file-explorer.js** – Workspace File-Explorer Panel (Dateien, Ordner erstellen/löschen, Folder-Browser) - **file-explorer.js** – Workspace File-Explorer Panel (Dateien, Ordner erstellen/löschen, Folder-Browser)
- **typing-phrases.js** – Zufällige Typing-Indicator-Texte (Wienerisch/Österreichisch)
- **avatar-editor.js** – Wiederverwendbares Avatar-Editor-Modal (Upload, Paste, AI-Generate, Scale) - **avatar-editor.js** – Wiederverwendbares Avatar-Editor-Modal (Upload, Paste, AI-Generate, Scale)
- **commands-ui.js** – Custom-Commands UI-Komponente - **commands-ui.js** – Custom-Commands UI-Komponente
@@ -620,9 +657,9 @@ Der Chat-Flow von User-Input bis zur gerenderten Antwort:
3. ChatEndpoint: 3. ChatEndpoint:
a) User-Message + Attachments in DB speichern a) User-Message + Attachments in DB speichern
b) ChatService.PrepareContext() → Agent, Model, System-Prompt, Chain b) ChatService.PrepareContext() → Agent, Model, System-Prompt, Chain
c) API-Key auflösen: `GetAgentApiKeyRecord(userId, agentId)` – Anthropic ohne Key → Fehler, OpenAI ohne Key → OK (keyless Provider) c) API-Key auflösen: `GetAgentApiKeyRecord(userId, agentId)` – Anthropic ohne Key → CLI-Fallback oder Fehler, OpenAI ohne Key → OK (keyless Provider)
d) ChatService.BuildHistoryFromDb() → vollständige Message-History d) ChatService.BuildHistoryFromDb() → vollständige Message-History
e) Model-Routing: Anthropic → AnthropicService.StreamChat(), OpenAI-Provider (nvidia:/pollinations:/gemini:) → OpenAiService.StreamChat() e) Model-Routing: Anthropic → AnthropicService.StreamChat() (oder StreamChatViaCli() bei CLI-Modus), OpenAI-Provider (nvidia:/pollinations:/gemini:/openai:) → OpenAiService.StreamChat()
↓ ↓
4. Agentic Loop (AnthropicService oder OpenAiService): 4. Agentic Loop (AnthropicService oder OpenAiService):
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
@@ -756,6 +793,15 @@ Dieses Tool wird **nicht ausgeführt**, sondern als SSE-Event an den Client weit
Nutzt Anthropics eingebaute Web-Suche als Server-Side-Tool. Nutzt Anthropics eingebaute Web-Suche als Server-Side-Tool.
### GitHub Code Search + Serper Web Search (eigene Tools)
| Tool | Beschreibung |
|-----------------------|-----------------------------------------------------|
| `github_code_search` | Durchsucht öffentliche GitHub-Repos nach Code (GitHub Code Search API) |
| `serper_web_search` | Internet-Suche via Google (Serper.dev API) |
Diese Tools werden zusätzlich zur Anthropic Web-Suche bereitgestellt und direkt vom ToolService ausgeführt.
### Plan-Modus: Read-only Tools ### Plan-Modus: Read-only Tools
Im Plan-Modus werden nur folgende Tools bereitgestellt: `read_file`, `list_files`, `glob`, `grep`, `execute`, `todo_write`, `memory_*`, `memory_search`, `remote_execute`, `ask_user_choice`. Write-Tools (`write_file`, `edit_file`, `delete_file`) werden gefiltert. Im Plan-Modus werden nur folgende Tools bereitgestellt: `read_file`, `list_files`, `glob`, `grep`, `execute`, `todo_write`, `memory_*`, `memory_search`, `remote_execute`, `ask_user_choice`. Write-Tools (`write_file`, `edit_file`, `delete_file`) werden gefiltert.
@@ -1831,6 +1877,109 @@ Durchsucht mehrere Quellen nach geleakten API-Keys:
--- ---
## Key-Scanner-System
Das Key-Scanner-System besteht aus drei Komponenten, die zusammenarbeiten:
### KeyPatterns (static)
Zentrale Definition aller Key-Patterns (Regex + Suchbegriffe + Typ-Erkennung). Wird von `KeyScannerService` und `GitHubEventScannerService` gemeinsam genutzt.
**Unterstützte Key-Typen:** Anthropic (OAuth + API), OpenAI (Project + Service + Legacy), Google/Gemini, AWS, GitHub (PAT + OAuth), GitLab, HuggingFace, Stripe (Live + Test), SendGrid, Slack, Krea AI.
### KeyCheckDispatcher (static)
Zentraler Dispatcher für Key-Checks aller Provider. Normalisiert die Provider-spezifischen Ergebnisse in ein einheitliches `UnifiedKeyCheckResult` mit standardisiertem DB-Status (`valid`, `invalid`, `rate_limited`, `quota_exceeded`, `error`).
**Provider-Checker:**
| Provider | Checker | Prüfmethode |
|----------|---------|-------------|
| `anthropic` | `AnthropicKeyChecker` | Minimale API-Anfrage + Usage-Header-Auswertung |
| `openai` | `OpenAiKeyChecker` | GET /v1/models + Rate-Limit-Headers |
| `google` | `GoogleKeyChecker` | GET /v1/models + Quota-Check (GenerateContent) |
| `stripe` | `StripeKeyChecker` | GET /v1/balance + Account-Info |
### GitHubEventScannerService (BackgroundService)
Echtzeit-Scanner: Pollt die GitHub Public Events API alle 30 Sekunden, filtert PushEvents und scannt Commit-Diffs nach geleakten API-Keys.
- **Konfiguration:** `GitHubEventScanner` (bool, aktiviert/deaktiviert), `GitHubToken` (für höhere Rate-Limits)
- **Deduplication:** Ringbuffer für Event-IDs (max 10.000)
- **Performance:** Max 30 Commit-Diffs pro Poll-Zyklus, Diffs > 100KB werden übersprungen
- **Live-Log:** Internes Ringbuffer (max 50 Einträge), abrufbar über `GET /api/admin/api-keys/event-scanner/log`
- **Status:** `GET /api/admin/api-keys/event-scanner/status` → isRunning, lastPoll, eventsPerHour
---
## Claude CLI Integration
Die Claude Code CLI kann als alternativer Streaming-Weg verwendet werden (OAuth-basiert, kein API-Key nötig).
### Architektur
- **ClaudeCliService** – Wrapper für die Claude Code CLI (`~/.claude/local/claude`). Prüft beim Start ob die CLI verfügbar ist.
- **AnthropicService.Cli.cs** – `StreamChatViaCli()`: Streaming-Chat über die CLI statt der HTTP-API. Verwendet das lokale OAuth-Token aus `~/.claude/.credentials.json`.
### Ablauf
1. `ChatEndpoint` prüft ob kein API-Key vorhanden und die CLI verfügbar ist
2. Bei Verfügbarkeit wird `StreamChatViaCli()` statt `StreamChat()` aufgerufen
3. Die CLI wird als Kindprozess gestartet mit JSON-Streaming-Output
4. SSE-Events werden identisch zum HTTP-API-Streaming generiert
### Voraussetzungen
- Claude Code CLI installiert (`~/.claude/local/claude`)
- Gültiges OAuth-Token in `~/.claude/.credentials.json`
---
## Datenbank-Explorer
Admin-only-Feature zum direkten Inspizieren der SQLite-Datenbank über die Web-UI.
### Backend
`DatabaseExplorerEndpoint.cs` bietet zwei Endpoints:
- `GET /api/admin/db/tables` – Listet alle Tabellen mit Spalten- und Zeilenanzahl
- `GET /api/admin/db/tables/{name}` – Liest Tabellendaten (mit Paging: `?limit=100&offset=0`, Sortierung: `?sort=column&order=desc`)
### Frontend
`db-explorer-page.js` (`#/db-explorer`) – Admin-only Seite mit klickbarer Tabellenliste und Daten-Grid. Erreichbar über das Dashboard (Button "Datenbank").
---
## MCP-Server-Integration (Internal API)
`InternalEndpoint.cs` stellt eine interne API bereit, die von externen MCP-Servern genutzt werden kann.
### Authentifizierung
- Beim Start wird ein einmaliger `InternalToken` generiert (GUID)
- Alle `/api/internal/*`-Endpoints erfordern `X-Internal-Token`-Header
- Ausnahme: `POST /api/chat/choice-respond` nutzt normale Cookie-Auth
### Endpoints
| Endpoint | Funktion |
|----------|----------|
| `POST /api/internal/remote-execute` | Shell-Befehl auf Remote-Client ausführen (via WebSocket) |
| `POST /api/internal/ask-user-choice` | Short-Poll für User-Choice-Antworten (202 = pending, 200 = answered) |
| `POST /api/chat/choice-respond` | Frontend: User-Antwort auf Choice-Frage speichern |
| `POST /api/internal/memory-read` | Memory-Datei eines Agents lesen |
| `POST /api/internal/memory-write` | Memory-Datei schreiben/appenden |
| `POST /api/internal/memory-list` | Memory-Dateien eines Agents auflisten |
### User-Choice-Flow (CLI-Modus)
1. MCP-Server ruft `ask-user-choice` auf → gibt Frage + Optionen an Frontend
2. Frontend zeigt Choice-Buttons
3. User klickt → `choice-respond` speichert Antwort
4. MCP-Server pollt `ask-user-choice` → erhält Antwort
---
## Deployment ## Deployment
**WICHTIG:** Das Deployment ist ein **manueller Vorgang**, der durch den Benutzer auf dem Server durchgeführt werden muss. Das System führt kein automatisches Deployment durch. **WICHTIG:** Das Deployment ist ein **manueller Vorgang**, der durch den Benutzer auf dem Server durchgeführt werden muss. Das System führt kein automatisches Deployment durch.
ARCHITECTURE_QUICK.md
+37 -14
View File
@@ -6,7 +6,7 @@
## Tech-Stack ## Tech-Stack
**.NET 10** Minimal API · **SQLite** + Dapper · **Anthropic Claude API** (SSE Streaming) · **OpenAI-kompatible APIs** (Nvidia, Pollinations, Gemini) · **ONNX Runtime** (Sentence-Embeddings) · **Vanilla JS** SPA · **KaTeX** (Math) · **Kestrel** auf Port 19000 **.NET 10** Minimal API · **SQLite** + Dapper · **Anthropic Claude API** (SSE Streaming + Claude CLI) · **OpenAI-kompatible APIs** (Nvidia, Pollinations, Gemini, OpenAI) · **ONNX Runtime** (Sentence-Embeddings) · **Vanilla JS** SPA · **KaTeX** (Math) · **Kestrel** auf Port 19000
--- ---
@@ -19,12 +19,21 @@ gott/
├── Models/ # Records (reine Daten, inkl. ApiKeyRecord) ├── Models/ # Records (reine Daten, inkl. ApiKeyRecord)
├── Services/ # Business-Logic (Singletons + Static Helpers) ├── Services/ # Business-Logic (Singletons + Static Helpers)
│ ├── DatabaseService*.cs # Partial Classes (Core, Sessions, Agents, Users, Integrations) │ ├── DatabaseService*.cs # Partial Classes (Core, Sessions, Agents, Users, Integrations)
│ ├── AnthropicService*.cs # Partial Classes (Core, Streaming, Agents, Cli)
│ ├── ClaudeCliService.cs # Claude Code CLI Wrapper (OAuth-basiert)
│ ├── SseHelper.cs # Shared SSE-Utilities │ ├── SseHelper.cs # Shared SSE-Utilities
│ ├── EmbeddingService.cs # Lokales Sentence-Embedding (ONNX) │ ├── EmbeddingService.cs # Lokales Sentence-Embedding (ONNX)
│ ├── VectorSearchService.cs # Semantische Suche │ ├── VectorSearchService.cs # Semantische Suche
│ ├── RemoteConnectionManager.cs # WebSocket Remote-Verbindungen │ ├── RemoteConnectionManager.cs # WebSocket Remote-Verbindungen
│ ├── AppPaths.cs # Zentrale Pfade (WwwRoot, Dev vs. Publish)
│ ├── KeyScannerService.cs # GitHub API-Key-Scanner │ ├── KeyScannerService.cs # GitHub API-Key-Scanner
│ └── AnthropicKeyChecker.cs # Anthropic Key-Validierung + Usage-Auswertung │ ├── GitHubEventScannerService.cs # Echtzeit-Scanner (GitHub Events API)
│ ├── KeyPatterns.cs # Zentrale Key-Pattern-Definitionen (Regex + Typ-Erkennung)
│ ├── KeyCheckDispatcher.cs # Zentraler Key-Check-Dispatcher (alle Provider)
│ ├── AnthropicKeyChecker.cs # Anthropic Key-Validierung + Usage-Auswertung
│ ├── OpenAiKeyChecker.cs # OpenAI Key-Validierung
│ ├── GoogleKeyChecker.cs # Google/Gemini Key-Validierung
│ └── StripeKeyChecker.cs # Stripe Key-Validierung
├── Endpoints/ # HTTP API (Minimal API MapXxx-Pattern) ├── Endpoints/ # HTTP API (Minimal API MapXxx-Pattern)
├── Middleware/ # AuthMiddleware ├── Middleware/ # AuthMiddleware
├── Templates/ # Vorlagen für neue Agents (IDENTITY, SOUL, USER) ├── Templates/ # Vorlagen für neue Agents (IDENTITY, SOUL, USER)
@@ -45,7 +54,8 @@ gott/
│ ├── js/archive.js # Archiv-Loading │ ├── js/archive.js # Archiv-Loading
│ ├── js/reply.js # Reply/Quote-Handling │ ├── js/reply.js # Reply/Quote-Handling
│ ├── js/files.js # File-Upload, Workspace-Refs │ ├── js/files.js # File-Upload, Workspace-Refs
│ ├── js/pages/ # Seiten-Komponenten (inkl. api-keys-page.js, telegram-bot-page.js) │ ├── js/typing-phrases.js # Zufällige Typing-Indicator-Texte
│ ├── js/pages/ # Seiten-Komponenten (inkl. api-keys-page.js, telegram-bot-page.js, db-explorer-page.js)
│ └── css/ # Styles (theme.css = CSS Variables) │ └── css/ # Styles (theme.css = CSS Variables)
├── WindowsApp/ # WPF + WebView2 Desktop Client ├── WindowsApp/ # WPF + WebView2 Desktop Client
└── Build/ # ⛔ NICHT editieren! └── Build/ # ⛔ NICHT editieren!
@@ -104,8 +114,8 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
| Auth | `/api/auth/` | `POST login`, `POST logout`, `GET me`, `GET autologin` | | Auth | `/api/auth/` | `POST login`, `POST logout`, `GET me`, `GET autologin` |
| Chat | `/api/chat` | `POST` → SSE Stream, `POST stop` | | Chat | `/api/chat` | `POST` → SSE Stream, `POST stop` |
| History | `/api/history` | GET history, poll, archive, marks, delete | | History | `/api/history` | GET history, poll, archive, marks, delete |
| Sessions | `/api/sessions/` | CRUD + system-prompt, exec, git-status (Liste inkl. inline Git-Status) | | Sessions | `/api/sessions/` | CRUD + system-prompt, system-prompt-blocks, payload-preview, streaming, exec, git-status |
| Agents | `/api/agents/` | CRUD (Liste inkl. inline Skills) | | Agents | `/api/agents/` | CRUD + available (inkl. public agents, inline Skills) |
| Admin | `/api/admin/` | User CRUD, impersonate, login-link (Admin-only) | | Admin | `/api/admin/` | User CRUD, impersonate, login-link (Admin-only) |
| Workspace | `/api/workspace/` | tree, file read/write, mkdir, rmdir, browse, agent-files | | Workspace | `/api/workspace/` | tree, file read/write, mkdir, rmdir, browse, agent-files |
| Telegram | `/api/telegram/` | Bot-CRUD, webhook/{botId} (unauth), session-config, registration | | Telegram | `/api/telegram/` | Bot-CRUD, webhook/{botId} (unauth), session-config, registration |
@@ -117,9 +127,11 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
| Settings | `/api/settings` | GET, PUT (JSON blob) | | Settings | `/api/settings` | GET, PUT (JSON blob) |
| Backup | `/api/backup` | POST → tar.gz download (Admin) | | Backup | `/api/backup` | POST → tar.gz download (Admin) |
| Shared | `/api/shared/`, `/api/messages/{id}/share` | Share erstellen, öffentlich abrufen, löschen | | Shared | `/api/shared/`, `/api/messages/{id}/share` | Share erstellen, öffentlich abrufen, löschen |
| Models | `/api/models/` | `GET nvidia`, `GET pollinations`, `GET gemini`, `POST refresh` | | Models | `/api/models/` | `GET nvidia`, `GET pollinations`, `GET gemini`, `GET openai`, `POST refresh` |
| API Keys | `/api/admin/api-keys/` | CRUD + activate/deactivate, `POST check` (Key-Validierung), scan (GitHub-Scanner), scanned (gefundene Keys), adopt (Key übernehmen) (Admin-only) | | API Keys | `/api/admin/api-keys/` | CRUD + check, check-all, scan, event-scanner, scanned (recheck/adopt/delete), scanner-logs (Admin) + `/api/api-keys/` available, select, selected (User) |
| Remote | `/api/remote` | WebSocket für Remote-Clients, `GET connections`, `POST assign/unassign` | | Remote | `/api/remote` | WebSocket für Remote-Clients, `GET connections`, `POST assign/unassign` |
| Internal | `/api/internal/` | MCP-Server: remote-execute, ask-user-choice, memory-read/write/list (Token-gesichert) |
| DB Explorer | `/api/admin/db/` | tables, table-data (Admin-only) |
| Info | `/api/info` | GET → Build-Zeitstempel + Embedding-Verfügbarkeit | | Info | `/api/info` | GET → Build-Zeitstempel + Embedding-Verfügbarkeit |
| ServerSettings | `/api/admin/server-settings` | `GET`, `PUT` (Admin-only, liest/schreibt `appsettings.Production.json`) | | ServerSettings | `/api/admin/server-settings` | `GET`, `PUT` (Admin-only, liest/schreibt `appsettings.Production.json`) |
@@ -132,10 +144,11 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
| **DatabaseService** | Alles DB: Schema, Migrationen, CRUD | | **DatabaseService** | Alles DB: Schema, Migrationen, CRUD |
| **AuthService** | Token-Auth, Passwort-Hashing (SHA256) | | **AuthService** | Token-Auth, Passwort-Hashing (SHA256) |
| **ChatService** | Chat-Kontext aufbauen, History aus DB laden | | **ChatService** | Chat-Kontext aufbauen, History aus DB laden |
| **AnthropicService** | Claude API: SSE Streaming + Non-Streaming, passive Usage-Aktualisierung nach jedem Request | | **AnthropicService** | Claude API: SSE Streaming + Non-Streaming + CLI-Fallback, passive Usage-Aktualisierung (partial class: Core, Streaming, Agents, Cli) |
| **OpenAiService** | OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini) mit Tool-Calling, Streaming (`StreamChat`) + Non-Streaming (`ChatNonStreaming` für Telegram/Cronjobs/Sub-Agents), Modell-Caching | | **ClaudeCliService** | Claude Code CLI Wrapper (OAuth-basiert, kein API-Key nötig) |
| **OpenAiService** | OpenAI-kompatible Provider (Nvidia, Pollinations, Gemini, OpenAI) mit Tool-Calling, Streaming + Non-Streaming, Modell-Caching |
| **SseHelper** | Shared SSE-Utilities: WriteSseEvent, TryWriteSse, FinalizeChain, TruncateToolResult (static) | | **SseHelper** | Shared SSE-Utilities: WriteSseEvent, TryWriteSse, FinalizeChain, TruncateToolResult (static) |
| **ToolService** | Tool-Definitionen + Ausführung (17 Tools) | | **ToolService** | Tool-Definitionen + Ausführung (19 Tools, inkl. github_code_search, serper_web_search) |
| **WorkspaceHelper** | Workspace-Pfad-Auflösung (relativ → absolut), Path-Traversal-Schutz (static) | | **WorkspaceHelper** | Workspace-Pfad-Auflösung (relativ → absolut), Path-Traversal-Schutz (static) |
| **SystemPromptBuilder** | System-Prompt aus modularen Blöcken zusammenbauen + Reminder-Generierung (static) | | **SystemPromptBuilder** | System-Prompt aus modularen Blöcken zusammenbauen + Reminder-Generierung (static) |
| **MemoryService** | Agent-Gedächtnis auf Dateisystem | | **MemoryService** | Agent-Gedächtnis auf Dateisystem |
@@ -149,8 +162,15 @@ User 1──* TelegramBot 1──* Session (via telegram_bot_id)
| **EmbeddingBackgroundService** | Backfill bestehender Messages + Live-Embedding neuer Messages/Memory-Files | | **EmbeddingBackgroundService** | Backfill bestehender Messages + Live-Embedding neuer Messages/Memory-Files |
| **RemoteConnectionManager** | WebSocket-basierte Remote-Verbindungen, Command-Execution auf Remote-Clients | | **RemoteConnectionManager** | WebSocket-basierte Remote-Verbindungen, Command-Execution auf Remote-Clients |
| **StreamingTracker** | Tracking aktiver Streams + CancellationTokenSource pro Session für Stop | | **StreamingTracker** | Tracking aktiver Streams + CancellationTokenSource pro Session für Stop |
| **AppPaths** | Zentrale Pfade (WwwRoot, Dev vs. Publish-Modus) (static) |
| **KeyScannerService** | API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), täglicher Scan | | **KeyScannerService** | API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), täglicher Scan |
| **GitHubEventScannerService** | Echtzeit-Scanner: GitHub Public Events API (PushEvent-Diffs nach geleakten Keys), 30s Poll-Intervall |
| **KeyPatterns** | Zentrale Key-Pattern-Definitionen für alle Scanner (Regex, Typ-Erkennung, Display-Names) (static) |
| **KeyCheckDispatcher** | Zentraler Dispatcher für Key-Checks aller Provider, normalisiertes Ergebnis (static) |
| **AnthropicKeyChecker** | Key-Validierung via Anthropic API, Usage-Header-Auswertung (Plan, 7d/5h Usage) | | **AnthropicKeyChecker** | Key-Validierung via Anthropic API, Usage-Header-Auswertung (Plan, 7d/5h Usage) |
| **OpenAiKeyChecker** | OpenAI Key-Validierung (Models-Endpoint, Rate-Limits, Organization) |
| **GoogleKeyChecker** | Google/Gemini Key-Validierung (Models + Quota-Check) |
| **StripeKeyChecker** | Stripe Key-Validierung (Balance, Account-Info, Payouts/Charges) |
| **ServerSettingsService** | Server-Settings Verwaltung (In-Memory-Cache + DB), Cleanup obsoleter Settings | | **ServerSettingsService** | Server-Settings Verwaltung (In-Memory-Cache + DB), Cleanup obsoleter Settings |
--- ---
@@ -163,12 +183,12 @@ User-Input → POST /api/chat (SSE)
→ History aus DB laden (letzte N Chains) → History aus DB laden (letzte N Chains)
→ SystemPromptBuilder: 11 Blöcke zusammensetzen (+ Plan-Modus/Preparer-Blöcke) → SystemPromptBuilder: 11 Blöcke zusammensetzen (+ Plan-Modus/Preparer-Blöcke)
→ Tool-Definitionen vom ToolService holen (im Plan-Modus: nur Read-only) → Tool-Definitionen vom ToolService holen (im Plan-Modus: nur Read-only)
→ API-Key auflösen: GetAgentApiKeyRecord(userId, agentId) – Anthropic ohne Key → Fehler, keyless Provider → OK → API-Key auflösen: GetAgentApiKeyRecord(userId, agentId) – Anthropic ohne Key → CLI-Fallback oder Fehler, keyless Provider → OK
→ Preparer-Phase (optional, wenn PreparerAgentId gesetzt): → Preparer-Phase (optional, wenn PreparerAgentId gesetzt):
→ RunPreparer() → Provider-Weiche: Anthropic → RunAgentChat(), OpenAI → ChatNonStreaming() → RunPreparer() → Provider-Weiche: Anthropic → RunAgentChat(), OpenAI → ChatNonStreaming()
→ Antwort ohne [QUESTION] → automatisch weiterleiten (Default = Forward) → Antwort ohne [QUESTION] → automatisch weiterleiten (Default = Forward)
→ [QUESTION] → Rückfrage an User, Flow stoppt → [QUESTION] → Rückfrage an User, Flow stoppt
→ AnthropicService.StreamChat() / OpenAiService.StreamChat() → AnthropicService.StreamChat() / StreamChatViaCli() / OpenAiService.StreamChat()
→ API Call (SSE) → API Call (SSE)
→ Token-für-Token an Client streamen → Token-für-Token an Client streamen
→ Bei tool_use → ToolService.Execute() → Ergebnis zurück → neuer API Call → Bei tool_use → ToolService.Execute() → Ergebnis zurück → neuer API Call
@@ -194,7 +214,7 @@ User-Input → POST /api/chat (SSE)
--- ---
## Tool-System (17 Tools) ## Tool-System (19 Tools)
| Tool | Funktion | | Tool | Funktion |
|------|----------| |------|----------|
@@ -215,6 +235,8 @@ User-Input → POST /api/chat (SSE)
| `remote_execute` | Shell-Befehl auf verbundenem Remote-Client ausführen (via WebSocket) | | `remote_execute` | Shell-Befehl auf verbundenem Remote-Client ausführen (via WebSocket) |
| `send_to_session` | Nachricht an eine andere Session senden und Agent-Antwort auslösen | | `send_to_session` | Nachricht an eine andere Session senden und Agent-Antwort auslösen |
| `ask_user_choice` | Interaktive Rückfrage mit 2-5 Auswahlmöglichkeiten (wenn AllowUserChoice aktiv) | | `ask_user_choice` | Interaktive Rückfrage mit 2-5 Auswahlmöglichkeiten (wenn AllowUserChoice aktiv) |
| `github_code_search` | Durchsucht öffentliche GitHub-Repos nach Code (GitHub Code Search API) |
| `serper_web_search` | Internet-Suche via Google (Serper.dev API) |
**Sicherheit:** Alle Pfade werden auf das Workspace-Verzeichnis beschränkt (`..` wird blockiert). Tools sind pro Agent konfigurierbar (Feld `tools` als komma-separierte Liste). **Sicherheit:** Alle Pfade werden auf das Workspace-Verzeichnis beschränkt (`..` wird blockiert). Tools sind pro Agent konfigurierbar (Feld `tools` als komma-separierte Liste).
@@ -257,7 +279,8 @@ User-Input → POST /api/chat (SSE)
| `#/profile` | `profile-page.js` | Profil | | `#/profile` | `profile-page.js` | Profil |
| `#/settings` | `settings-page.js` | Einstellungen | | `#/settings` | `settings-page.js` | Einstellungen |
| `#/admin` | `admin-page.js` | Benutzerverwaltung (Admin) | | `#/admin` | `admin-page.js` | Benutzerverwaltung (Admin) |
| `#/api-keys` | `api-keys-page.js` | API-Key-Verwaltung + GitHub-Scanner (Admin) | | `#/api-keys` | `api-keys-page.js` | API-Key-Verwaltung + GitHub-Scanner + Event-Scanner (Admin) |
| `#/db-explorer` | `db-explorer-page.js` | Datenbank-Explorer (Admin) |
| `#/server-settings` | `server-settings-page.js` | Servereinstellungen (Admin) | | `#/server-settings` | `server-settings-page.js` | Servereinstellungen (Admin) |
| `#/login` | `login-page.js` | Login | | `#/login` | `login-page.js` | Login |
| `#/shared/{token}` | `shared-page.js` | Geteilte Nachricht (öffentlich, kein Auth) | | `#/shared/{token}` | `shared-page.js` | Geteilte Nachricht (öffentlich, kein Auth) |
README.md
+8 -5
View File
@@ -2,7 +2,7 @@
# // gott # // gott
Self-hosted AI-Coding-Agent mit **Anthropic Claude API** als Haupt-Provider sowie **OpenAI-kompatiblen Providern** (Nvidia, Pollinations, Google Gemini). Stellt eine Web-UI bereit, über die man in Sessions mit konfigurierbaren Agenten chatten kann. Die Agenten haben Tool-Zugriff (Dateien lesen/schreiben/bearbeiten, Shell-Befehle ausführen, Suchen, Todos, Memory) auf ein definiertes Workspace-Verzeichnis. Self-hosted AI-Coding-Agent mit **Anthropic Claude API** als Haupt-Provider (inkl. Claude CLI-Integration) sowie **OpenAI-kompatiblen Providern** (Nvidia, Pollinations, Google Gemini, OpenAI). Stellt eine Web-UI bereit, über die man in Sessions mit konfigurierbaren Agenten chatten kann. Die Agenten haben Tool-Zugriff (Dateien lesen/schreiben/bearbeiten, Shell-Befehle ausführen, Web-/Code-Suche, Todos, Memory) auf ein definiertes Workspace-Verzeichnis.
--- ---
@@ -15,8 +15,8 @@ Self-hosted AI-Coding-Agent mit **Anthropic Claude API** als Haupt-Provider sowi
- **Interaktive Rückfragen** – `ask_user_choice`-Tool: Agent stellt dem User klickbare Auswahlmöglichkeiten - **Interaktive Rückfragen** – `ask_user_choice`-Tool: Agent stellt dem User klickbare Auswahlmöglichkeiten
- **Plan-Modus** – Read-only-Modus zum Analysieren und Planen ohne Änderungen (Toggle im Chat) - **Plan-Modus** – Read-only-Modus zum Analysieren und Planen ohne Änderungen (Toggle im Chat)
- **Web-Search** – Integrierte Web-Suche mit Quellenangaben (URLs + Titel) in Chat und geteilten Nachrichten - **Web-Search** – Integrierte Web-Suche mit Quellenangaben (URLs + Titel) in Chat und geteilten Nachrichten
- **Multi-Provider** – Anthropic Claude (Haupt-Provider), Nvidia (g4f.space), Pollinations (kostenlos), Google Gemini (kostenloser Free Tier) - **Multi-Provider** – Anthropic Claude (Haupt-Provider, inkl. Claude CLI), Nvidia (g4f.space), Pollinations (kostenlos), Google Gemini (kostenloser Free Tier), OpenAI
- **17 Tools** – `read_file`, `write_file`, `edit_file`, `list_files`, `delete_file`, `execute`, `background_execute`, `glob`, `grep`, `todo_write`, `memory_read`, `memory_write`, `memory_list`, `memory_search`, `remote_execute`, `send_to_session`, `ask_user_choice` - **19 Tools** – `read_file`, `write_file`, `edit_file`, `list_files`, `delete_file`, `execute`, `background_execute`, `glob`, `grep`, `todo_write`, `memory_read`, `memory_write`, `memory_list`, `memory_search`, `remote_execute`, `send_to_session`, `ask_user_choice`, `github_code_search`, `serper_web_search`
- **Streaming** – Echtzeit-Antworten via Server-Sent Events (SSE) - **Streaming** – Echtzeit-Antworten via Server-Sent Events (SSE)
- **Stop-Button** – Laufende Requests zuverlässig abbrechen (inkl. laufender Shell-Befehle) - **Stop-Button** – Laufende Requests zuverlässig abbrechen (inkl. laufender Shell-Befehle)
- **Skill-System** – Wiederverwendbare Prompt-Bausteine, zuordenbar pro Agent - **Skill-System** – Wiederverwendbare Prompt-Bausteine, zuordenbar pro Agent
@@ -27,7 +27,10 @@ Self-hosted AI-Coding-Agent mit **Anthropic Claude API** als Haupt-Provider sowi
- **Bildgenerierung** – Krea AI Integration für Bildgenerierung - **Bildgenerierung** – Krea AI Integration für Bildgenerierung
- **Semantische Suche** – Lokale Sentence-Embeddings (all-MiniLM-L6-v2 ONNX) für `memory_search` über vergangene Nachrichten und Memory-Dateien - **Semantische Suche** – Lokale Sentence-Embeddings (all-MiniLM-L6-v2 ONNX) für `memory_search` über vergangene Nachrichten und Memory-Dateien
- **Remote-Verbindungen** – WebSocket-basierte Remote-Clients (PowerShell), AI-Agent kann Befehle auf entfernten Rechnern ausführen - **Remote-Verbindungen** – WebSocket-basierte Remote-Clients (PowerShell), AI-Agent kann Befehle auf entfernten Rechnern ausführen
- **API-Key-Verwaltung** – Admin-UI zum Verwalten von API-Keys (Anthropic) inkl. Key-Check, API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), passive Usage-Aktualisierung bei jeder Chat-Nachricht, Usage-Badge im Chat mit Key-Switch-Modal (pro Agent) - **API-Key-Verwaltung** – Admin-UI zum Verwalten von API-Keys (Anthropic, OpenAI, Google, Stripe) inkl. Multi-Provider Key-Check, API-Key-Scanner (GitHub Code Search, GitHub Issues/PRs, HuggingFace Hub, Google/Serper), GitHub Events Echtzeit-Scanner, passive Usage-Aktualisierung bei jeder Chat-Nachricht, Usage-Badge im Chat mit Key-Switch-Modal (pro Agent)
- **Claude CLI** – Alternativer Streaming-Weg über die Claude Code CLI (OAuth-basiert, kein API-Key nötig)
- **Datenbank-Explorer** – Admin-UI zum direkten Inspizieren der SQLite-Datenbank
- **MCP-Server-Integration** – Interne API für externe MCP-Server (Remote-Execute, Ask-User-Choice, Memory-CRUD)
- **Nachrichten teilen** – Einzelne Nachrichten per öffentlichem Link teilen - **Nachrichten teilen** – Einzelne Nachrichten per öffentlichem Link teilen
- **Archivierung** – Chat-Verläufe archivieren und durchsuchen - **Archivierung** – Chat-Verläufe archivieren und durchsuchen
- **OpenClaw Import** – Chatverlauf aus OpenClaw-Instanzen importieren - **OpenClaw Import** – Chatverlauf aus OpenClaw-Instanzen importieren
@@ -42,7 +45,7 @@ Self-hosted AI-Coding-Agent mit **Anthropic Claude API** als Haupt-Provider sowi
|---------|-------------| |---------|-------------|
| **Backend** | .NET 10 Minimal API, C# | | **Backend** | .NET 10 Minimal API, C# |
| **Datenbank** | SQLite + Dapper | | **Datenbank** | SQLite + Dapper |
| **AI** | Anthropic Claude API + OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini) | | **AI** | Anthropic Claude API (+ Claude CLI) + OpenAI-kompatible APIs (Nvidia, Pollinations, Gemini, OpenAI) |
| **Embeddings** | Microsoft.ML.OnnxRuntime + all-MiniLM-L6-v2 (Sentence-Embeddings) | | **Embeddings** | Microsoft.ML.OnnxRuntime + all-MiniLM-L6-v2 (Sentence-Embeddings) |
| **Frontend** | Vanilla JS SPA (kein Framework), CSS Variables | | **Frontend** | Vanilla JS SPA (kein Framework), CSS Variables |
| **Mathe** | KaTeX (LaTeX-Rendering) | | **Mathe** | KaTeX (LaTeX-Rendering) |