Skip to content

Commit 724c702

Browse files
docs(i18n): add materialized translations for all locales
Add placeholder translations generated by the materialization script for sections that were missing from non-English locales: product-overview, quick-start, installation, guides, llm-guide, faq, legal, release-notes, and related-software-installation. Locales covered: de-DE, es-ES, fr-FR, ja-JP, ko-KR, pt-BR, ru-RU, zh-Hant. Co-Authored-By: Hagicode <noreply@hagicode.com> Signed-off-by: newbe36524 <newbe36524@qq.com>
1 parent d0ae256 commit 724c702

205 files changed

Lines changed: 32219 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: Desktop-Knotenumgebung
3+
description: Erklärt, warum HagiCode Desktop Node.js bündelt und wie es gebündelte Knotenpfade bevorzugt, während der Benutzer Desktop ausführt.
4+
sidebar:
5+
order: 20
6+
---
7+
8+
HagiCode Desktop wird mit einer Desktop-verwalteten Node-Toolchain geliefert. Es übernimmt nicht die globale Node-Installation auf Ihrem Computer. Sein Zweck besteht darin, dem Desktop-Start und den laufzeitbezogenen Abläufen eine stabile und überprüfbare Laufzeitgrundlage zu geben.
9+
10+
Lesen Sie diese FAQ, wenn Sie sie sehen `portable-fixed/toolchain` In der Diagnostik muss man wissen, welche `node` Desktop verwendet, oder fragen Sie sich, warum die Knotenversion Ihres Systems das Desktop-Laufzeitverhalten nicht direkt definiert.
11+
12+
## Warum Desktop-Bundles Node
13+
14+
Desktop muss die gleichen unterstützenden Abläufe über Betriebssysteme, Installationskanäle und Benutzerumgebungen hinweg ausführen. Wenn es nur von der vorhandenen Node-Installation des Benutzers abhängen würde, müsste der Support gleichzeitig mit veralteten Versionen, fehlenden npm, falscher Pfadreihenfolge, verschmutzten globalen Paketen und organisationsspezifischen Registrierungsrichtlinien umgehen.
15+
16+
Desktop beschreibt dies genauer als isolierte Node/npm-Laufzeit für verwaltete CLIs anstelle der Wiederverwendung der systemweiten Umgebung. Dieses Design hat folgende Hauptvorteile:
17+
18+
- **Konsistente Versionen**: Desktop verwendet einen angehefteten Node-22-Laufzeitvertrag, anstatt die lokale Hauptversion des Benutzers zu erraten.
19+
- **Kontrollierte Startabläufe**: Vom Desktop verwaltete Befehle können das Paket bevorzugen `node` und `npm` Einträge.
20+
- **Klare Konfigurationsgrenzen**: Die CLI-bezogene Konfiguration wird von der hostweiten globalen Konfiguration getrennt gehalten, sodass Updates, Switches und Wiederherstellungen weniger wahrscheinlich durch Unterschiede in der Systemumgebung gestört werden.
21+
- **Reduzierte Konflikte**: Gebündelte Pfade gelten für von Desktop erstellte Befehlsumgebungen und ersetzen nicht den globalen Knoten des Benutzers in seinem Terminal.
22+
- **Nicht-intrusives Host-Verhalten**: Durch diese Isolation wird vermieden, dass der Toolchain-Status in die vorhandene Node-/npm-Umgebung des Benutzers geschrieben wird, und die Deinstallation von Desktop beeinträchtigt nicht den Node, npm oder die Konfiguration, die bereits auf dem Computer vorhanden ist.
23+
24+
## Wie Desktop den Knotenpfad auswählt
25+
26+
Wenn Sie Desktop normal ausführen, bevorzugt Desktop die mit der App installierte Node-Toolchain, anstatt zuerst die Node-Installation von Ihrem System zu lesen. Dadurch bleibt die Node-Version in Ihrem Terminal von der Node-Version getrennt, die Desktop während der Ausführung erwartet.
27+
28+
Wenn die gebündelte Toolchain aktiviert ist, stellen von Desktop erstellte Befehlsumgebungen gebündelte Toolchain-Pfade an den Anfang `PATH`. Selbst wenn auf Ihrem System eine andere Node-Version installiert ist, werden von Desktop verwaltete Flows daher zuerst in den gebündelten Node und npm von Desktop aufgelöst.
29+
30+
Dies betrifft nur Laufzeitumgebungen, die von Desktop erstellt wurden. Wenn du rennst `node`, `npm`oder andere Befehle direkt in Ihrem Systemterminal verwenden, verwenden sie weiterhin Ihre normale Systemumgebung und Shell-Konfiguration.
31+
32+
In Diagnose- oder untergeordneten Prozessumgebungen, die von Desktop gestartet werden, wird möglicherweise eine Variable wie diese angezeigt:
33+
34+
```bash
35+
HAGICODE_PORTABLE_TOOLCHAIN_ROOT=/path/to/portable-fixed/toolchain
36+
```
37+
38+
Diese Variable bedeutet, dass die vom Desktop verwaltete Laufzeitumgebung das gebündelte Toolchain-Stammverzeichnis erkannt hat. Wenn Sie diesen Pfad sehen, bedeutet das nicht, dass Desktop Ihren Systemknoten geändert hat. Dies bedeutet lediglich, dass Desktop die mit der App gelieferte Node-Umgebung in seinem eigenen Laufzeitbereich verwendet.
39+
40+
## Wo Desktop verwaltete NPM-Pakete installiert
41+
42+
Desktop speichert Laufzeitdateien und veränderbare NPM-Paketdateien an verschiedenen Orten. Der gebündelte Toolchain-Pfad wie z `portable-fixed/toolchain/node` ist die unveränderliche Quelle für den Desktop-verwalteten `node` und `npm` Befehle. Verwaltete globale Pakete werden stattdessen im Electron-Benutzerdatenverzeichnis installiert:
43+
44+
```text
45+
userData/node22/npmGlobal
46+
```
47+
48+
Wenn Desktop später auf Knoten 24 verschoben wird, verwendet es einen separaten Paketbaum, z `userData/node24/npmGlobal`. Für Knoten 22 installierte Pakete bleiben auf der Festplatte, werden aber erst dann als für Knoten 24 installiert behandelt, wenn sie im neuen Node-Major-Präfix neu installiert werden.
49+
50+
Der Desktop-Abhängigkeitsstatus überprüft nur die aktive `userData/node<major>/npmGlobal` Präfix. Paketdateien außerhalb dieses Präfixes werden vom Abhängigkeitsmanagement ignoriert.
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: FAQ
3+
description: Sehen Sie sich allgemeine HagiCode-Laufzeithinweise, Startvorbehalte, Erklärungen zur Laufzeitumgebung und zukünftige Einträge zur Fehlerbehebung an einem Ort an.
4+
sidebar:
5+
order: 1
6+
---
7+
8+
import { CardGrid, LinkCard } from '@astrojs/starlight/components';
9+
10+
Auf dieser Seite werden häufig gestellte Fragen, Laufzeitanleitungen und Einstiegspunkte zur Fehlerbehebung für HagiCode gesammelt.
11+
12+
Aktuelle FAQ-Einträge behandeln die Startkompatibilität der Desktop-Plattform und die gebündelte Node-Toolchain, die von Desktop-verwalteten Flows verwendet wird.
13+
14+
## Aktuelle FAQ-Einträge
15+
16+
<CardGrid>
17+
<LinkCard
18+
Titel="@@TR_37@@"
19+
href="/de-DE/faq/steam-linux-startup"
20+
Beschreibung="@@TR_40@@"
21+
/>
22+
<LinkCard
23+
Titel="@@TR_0@@"
24+
href="/de-DE/faq/desktop-node-environment"
25+
Beschreibung="@@TR_44@@"
26+
/>
27+
</CardGrid>
28+
29+
## Was dieser Abschnitt behandelt
30+
31+
Der FAQ-Bereich ist der Ort für:
32+
33+
- Einschränkungen beim Start und bei der Laufzeit
34+
- Kompatibilitätshinweise zu Plattformen, Vertriebskanälen, Verpackungen oder gebündelten Laufzeiten
35+
- Fehlerbehebungsthemen, die eine stabile eigenständige Erklärungsseite verdienen
36+
37+
Wenn Sie gerade Fehler beim Startverhalten von Steam für Linux beheben, öffnen Sie [Hinweise zum Start von Steam Linux](/de-DE/faq/steam-linux-startup). Wenn Sie bestätigen müssen, welcher Node Desktop verwendet wird oder warum die Diagnose erwähnt wird `portable-fixed/toolchain`, öffnen [Desktop-Knotenumgebung](/de-DE/faq/desktop-node-environment).
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: Hinweise zum Start von Steam Linux
3+
description: Erklärt, warum der Standardstart von Steam für Linux das Electron-Sandboxing deaktiviert, welche Sicherheitskompromisse damit verbunden sind und wie man hagicode-desktop direkt startet, um die Standard-Sandbox beizubehalten.
4+
sidebar:
5+
order: 10
6+
---
7+
8+
Wenn Sie HagiCode Desktop über Steam für Linux starten, priorisiert der Standardstartpfad derzeit die Startkompatibilität vor der Beibehaltung des Standard-Sandbox-Schutzes von Electron.
9+
10+
Dies wird nicht als ideale langfristige technische Lösung dargestellt. Es handelt sich um den aktuellen Kompatibilitäts-Fallback für den ungelösten Konflikt zwischen der Steam-Sandbox und der Electron-Sandbox beim Start.
11+
12+
## Beginnen Sie mit der Kurzversion
13+
14+
Stellen Sie sich das aktuelle Verhalten als zwei Startmöglichkeiten vor:
15+
16+
1. **Standard-Steam-Start**: Kompatibilität zuerst, startet mit `--disable-setuid-sandbox -no-sandbox`und vermeidet den bekannten Startkonflikt zuverlässiger, behält jedoch nicht die Standard-Sandbox von Electron bei.
17+
2. **Manueller Direktstart von `hagicode-desktop`**: erfordert, dass Sie das tatsächliche Installationsverzeichnis eingeben und die Desktop-Binärdatei selbst starten, wodurch die Steam-Launcher-Flags vermieden werden und die Standard-Sandbox von Electron erhalten bleibt.
18+
19+
:::Vorsicht[Der Standard-Steam-Pfad ist nicht risikofrei]
20+
`--disable-setuid-sandbox -no-sandbox` ist der aktuelle Kompatibilitätspfad, entfernt aber auch eine der standardmäßigen Laufzeitschutzschichten von Electron.
21+
:::
22+
23+
## Warum der standardmäßige Steam-Start das Electron-Sandboxing deaktiviert
24+
25+
Unter Linux führt Steam eine eigene Sandbox-Schicht rund um die Anwendungsumgebung ein. Wenn HagiCode Desktop als Electron-Anwendung in dieser Umgebung gestartet wird, kann die standardmäßige Aktivierung von Electron-Sandboxing derzeit zu einem Sandbox-Konflikt und Startabstürzen führen.
26+
27+
Aus diesem Grund wird der aktuelle Standard-Steam-Startpfad angehängt `--disable-setuid-sandbox -no-sandbox`. Das Ziel ist klar:
28+
29+
- Halten Sie die App in Steam startfähig
30+
- Vermeiden Sie den Absturzpfad beim sofortigen Start
31+
- Verwenden Sie einen Kompatibilitätsstandard, während eine sauberere technische Lösung noch nicht verfügbar ist
32+
33+
:::note[Aktueller Status]
34+
Das Team verfügt noch nicht über eine klarere technische Lösung, die die Standard-Sandbox von Electron in der Steam-Sandbox-Umgebung aktiviert hält und gleichzeitig die aktuellen Startfehler vermeidet.
35+
:::
36+
37+
## Startoption A: Verwenden Sie den Standard-Steam-Start
38+
39+
Wenn Ihre Priorität darin besteht, „die App über Steam zu öffnen und zuverlässig einzusteigen“, bleiben Sie beim standardmäßigen Steam-Startpfad.
40+
41+
Seine Eigenschaften sind:
42+
43+
- es entspricht dem aktuellen Standardverhalten des Pakets
44+
- Sie müssen das Installationsverzeichnis nicht überprüfen
45+
- Es verwendet automatisch die Kompatibilitätsflags `--disable-setuid-sandbox -no-sandbox`
46+
- Der Nachteil besteht darin, dass die Standard-Sandbox von Electron nicht erhalten bleibt
47+
48+
Dieser Pfad eignet sich für Benutzer, die:
49+
50+
- Sie möchten das Standard-Steam-Starterlebnis
51+
- Legen Sie zunächst Wert auf die Startzuverlässigkeit
52+
- Sie möchten keinen manuellen Startbefehl verwalten
53+
54+
## Startoption B: Starten `hagicode-desktop` direkt
55+
56+
Wenn Ihre Priorität darin besteht, das Standard-Sandbox-Verhalten von Electron beizubehalten, verwenden Sie für diesen Start nicht den Standard-Steam-Launcher-Pfad. Gehen Sie stattdessen in das installierte HagiCode Desktop-Verzeichnis und führen Sie Folgendes aus `hagicode-desktop` direkt binär.
57+
58+
Verwenden Sie diesen allgemeinen Prozess:
59+
60+
1. Suchen Sie das eigentliche HagiCode Desktop-Installationsverzeichnis in Ihrer Steam-Bibliothek
61+
2. Geben Sie das Verzeichnis ein, das die enthält `hagicode-desktop` binär
62+
3. Lauf `hagicode-desktop` direkt
63+
4. Vermeiden Sie es, diese Sitzung über die Standard-Startschaltfläche von Steam zu starten
64+
65+
:::tip[Warum dadurch die Standard-Electron-Sandbox erhalten bleibt]
66+
Wenn Sie starten `hagicode-desktop` Direkt vermeiden Sie den standardmäßigen Steam-Startpfad und seine Kompatibilitätsflags, sodass die App im Standardmodus von Electron startet, anstatt zu erben `--disable-setuid-sandbox -no-sandbox`.
67+
:::
68+
69+
:::Hinweis[Diese Anleitung bleibt absichtlich pfadunabhängig]
70+
Es gibt keinen einzelnen Installationspfad, der für jede Linux-Distribution, jeden Steam-Bibliotheksspeicherort oder jedes benutzerdefinierte Benutzer-Setup korrekt ist. Die stabile Anweisung besteht darin, zuerst Ihr eigenes Installationsverzeichnis zu finden und zu starten `hagicode-desktop` von dort.
71+
:::
72+
73+
## So wählen Sie aus
74+
75+
Verwenden Sie diese Faustregel:
76+
77+
- Wenn Sie den kompatibelsten „Start über Steam“-Pfad wünschen, wählen Sie **Standard-Steam-Start**
78+
- Wenn Sie die Standard-Sandbox von Electron beibehalten möchten, wählen Sie **Manueller Direktstart von `hagicode-desktop`**
79+
80+
Hierbei handelt es sich um einen Kompromiss zwischen der Kompatibilitäts-First-Standardeinstellung und dem Sandbox-erhaltenden manuellen Pfad und nicht um den Anspruch, dass eine Auswahl für jeden Benutzer allgemein richtig ist.

0 commit comments

Comments
 (0)