mirror of
https://github.com/NeuralNomadsAI/CodeNomad.git
synced 2026-11-17 22:16:13 +00:00
Trim internal implementation commentary and routine-failure explanations from the interface and public help in all ten languages. Areas: Settings, Missions, providers and plugins, projects and remote access, transcript controls and the 28 help pages. Keep security and irreversible-action warnings, accessible names, scope boundaries and facts needed to act. Preserve current dev behavior and labels; the legacy OpenCode replacement confirmation now identifies its exact target. Validated with UI typecheck, ten-locale key and placeholder checks, help tests, unit contracts and affected browser tests.
79 lines
5.6 KiB
Markdown
79 lines
5.6 KiB
Markdown
# Fehlerberichte und Quellcode-Builds
|
|
|
|
Verwenden Sie das Repository für Fehlerberichte, aktuelle Releases und Beiträge. Die [Fehlerbehebung](troubleshooting.md) beschreibt sichere Wiederherstellung vor einer Meldung.
|
|
|
|
## Fehler melden {#report-a-bug}
|
|
|
|
1. Öffnen Sie **Einstellungen → Info → Diagnose**.
|
|
2. Wählen Sie **Fehler melden**, um das GitHub-Issue-Formular zu öffnen.
|
|
3. Prüfen Sie vorausgefüllte Versions-/Clientinformationen. Ergänzen Sie eine minimale Reproduktion, erwartetes Verhalten und tatsächliches Ergebnis und senden Sie dann über GitHub ab.
|
|
|
|
Die Aktion füllt die Versionen von CodeNomad und OpenCode (einschließlich des laufenden OpenCode-Dienstes, wenn er von der installierten Version abweicht), Ihr Betriebssystem, den Clienttyp (in einem Webbrowser mit dessen User-Agent) und das Betriebssystem des Servers vorab aus. Listeneradressen, Arbeitsbereichspfade, Zugangsdaten und Unterhaltungstext werden nicht vorausgefüllt. Formularöffnen ist noch keine Meldung.
|
|
|
|
Benötigen Sie mehr Diagnosen, erzeugen **In Zwischenablage kopieren** oder **.txt herunterladen** einen separaten Bericht. Dieser ausführlichere Bericht kann lokale Pfade und Netzwerkadressen enthalten: Prüfen und schwärzen Sie ihn vor dem Anhängen. Screenshots oder Log-Auszüge können weiterhin Geheimnisse enthalten, selbst wenn der automatische Diagnosebericht Authentifizierungsgeheimnisse ausschließt.
|
|
|
|
## Community und Releases {#community}
|
|
|
|
| Ressource | Verwendung |
|
|
| --- | --- |
|
|
| [CodeNomad-Repository](https://github.com/NeuralNomadsAI/CodeNomad) | Quelltext, Projektaktivität und Dokumentation. |
|
|
| [Issues](https://github.com/NeuralNomadsAI/CodeNomad/issues) | Vor reproduzierbarer Fehlermeldung oder Funktionswunsch vorhandene Meldungen durchsuchen. |
|
|
| [Pull Requests](https://github.com/NeuralNomadsAI/CodeNomad/pulls) | Vorgeschlagene Änderungen prüfen oder Beitrag koordinieren. |
|
|
| [Download-Seite](download.md) | Die neuesten stabilen Desktop-Builds für Ihre Plattform. |
|
|
| [Neuestes Release](https://github.com/NeuralNomadsAI/CodeNomad/releases/latest) | Stabile Download-Artefakte. |
|
|
| [Alle Releases](https://github.com/NeuralNomadsAI/CodeNomad/releases) | Veröffentlichte Vorschauen und Release-Hinweise. |
|
|
| [Neural Nomads](https://github.com/NeuralNomadsAI) | Projektorganisation. |
|
|
| [MIT-Lizenz](../../../LICENSE) | Lizenzbedingungen. |
|
|
|
|
Bei Problemen mit nativer OpenCode-Konfiguration statt CodeNomad-Steuerung beachten Sie [OpenCodes Dokumentation](https://opencode.ai/v2/docs/) und [Upstream-Releases](https://github.com/anomalyco/opencode/releases).
|
|
|
|
## Aus Quellcode bauen {#build-from-source}
|
|
|
|
Verwenden Sie die in `.node-version` festgelegte Node.js-Version, npm, Git und eine kompatible OpenCode-CLI. Führen Sie die Befehle aus einem Entwicklungs-Checkout aus:
|
|
|
|
```sh
|
|
git clone --branch dev https://github.com/NeuralNomadsAI/CodeNomad.git
|
|
cd CodeNomad
|
|
npm ci --workspaces --include=optional
|
|
npm run dev
|
|
```
|
|
|
|
`npm run dev` startet den Electron-Entwicklungshost. Installieren Sie für Tauri zuerst dessen [Plattform-Build-Voraussetzungen](https://v2.tauri.app/start/prerequisites/) einschließlich Rust-Toolchain und führen Sie dann aus:
|
|
|
|
```sh
|
|
npm run dev:tauri
|
|
```
|
|
|
|
Native Paketierung benötigt passende Zielwerkzeuge; bevorzugen Sie Builds auf dem Ziel-OS.
|
|
|
|
### Bauen und validieren {#build-and-validate}
|
|
|
|
| Befehl vom Repository-Stamm aus | Zweck |
|
|
| --- | --- |
|
|
| `npm run build` | Electron-Anwendungsressourcen bauen. |
|
|
| `npm run build:tauri` | Tauri-Anwendung mit nativen Voraussetzungen bauen. |
|
|
| `npm run build:ui` | Browseroberfläche bauen. |
|
|
| `npm run build --workspace @neuralnomads/codenomad` | Eigenständigen Server und gebündelte Dateien bauen. |
|
|
| `npm run build:linux --workspace @neuralnomads/codenomad-electron-app` | Electron-Debian-Release paketieren. |
|
|
| `npm exec --workspace @codenomad/tauri-app -- tauri build --bundles appimage` | Linux-Tauri-AppImage paketieren. |
|
|
| `npm run typecheck` | Konfigurierte TypeScript-Workspaces des Stammprojekts prüfen. |
|
|
| `npm run test:help` | Alle öffentlichen Hilfesprachen und Links validieren. |
|
|
| `npm run build:help` | Eigenständige öffentliche Hilfe nach `dist/help` bauen. |
|
|
|
|
Der Hilfe-Build benötigt keinen laufenden CodeNomad- oder OpenCode-Dienst. Paketierungsdetails siehe [BUILD.md](../../../BUILD.md), gezielte Validierung und PR-Konventionen [CONTRIBUTING.md](../../../CONTRIBUTING.md); verwenden Sie tatsächlich im Zielpaket vorhandene Skripte.
|
|
|
|
## Paketübersicht und Beiträge {#contribute}
|
|
|
|
| Paket | Zuständigkeit |
|
|
| --- | --- |
|
|
| `packages/server` | Arbeitsbereichs-/API-/Git-Steuerung, OpenCode-Verbindung, Authentifizierung, Ereignisse und Sprache. |
|
|
| `packages/ui` | SolidJS-Arbeitsbereich, Bedienelemente, Lokalisierung und Browser-Hilfeeinstieg. |
|
|
| `packages/electron-app` | Electron-Fenster, native Integration und Paketierung. |
|
|
| `packages/tauri-app` | Tauri-Fenster, Plattformintegration und Paketierung. |
|
|
| `packages/remote-tunnel` | Backendseitige OpenTunnel-Transportlaufzeit. |
|
|
|
|
1. Besprechen Sie den Umfang im passenden Issue vor sich überschneidender Implementierung.
|
|
2. Erstellen Sie einen Branch von `dev` und halten Sie die Änderung fokussiert.
|
|
3. Führen Sie Prüfungen des betroffenen Bereichs aus, aktualisieren Sie die Benutzerhilfe zusammen mit dem Verhalten und richten Sie den PR an `dev`.
|
|
|
|
Quellen öffentlicher Hilfe liegen in `docs/help/<locale>/`. Bewahren Sie explizite ID, Ebene und Reihenfolge jeder englischen Überschrift über Übersetzungen hinweg; übersetzte Überschriften dürfen Deep Links nicht brechen. Der [Hilfe-Wartungsvertrag](../../../dev-docs/USER_HELP.md) beschreibt strenge Vollständigkeitsprüfungen und die statische Veröffentlichungspipeline.
|