opt.: new website (#1138)

* opt.: new website
Fixes #1137

* opt.

* opt.

Co-authored-by: Copilot <copilot@github.com>

* opt.

* opt.

* opt.: docs

* fix

* new: more locales

* opt.: js -> ts

* fix

* fix

Author: lollipopkit

Makefile

@@ -10,10 +10,13 @@ PLATFORM ?=
 ENV_FILE ?=
 XCARCHIVE_PATH ?=
 APP_PATH ?=
+DMG_PATH ?=
+TAP_REPO_PATH ?=
 
 .PHONY: help deps pub-get run run-device analyze test test-one coverage \
 	gen gen-build gen-build-clean gen-l10n build build-android build-ios \
-	build-macos build-linux build-windows clean release-macos-dmg package-dmg
+	build-macos build-linux build-windows clean release-macos-dmg package-dmg \
+	sync-homebrew-cask
 
 help:
 	@printf '%s\n' \
@@ -48,7 +51,11 @@ help:
 		'                     Optional: make release-macos-dmg ENV_FILE=.env.release' \
 		'  package-dmg        Run scripts/release/package-dmg-from-xcarchive.sh' \
 		'                     Example: make package-dmg APP_PATH="/path/Server Box.app"' \
-		'                     Example: make package-dmg XCARCHIVE_PATH=/path/Runner.xcarchive'
+		'                     Example: make package-dmg XCARCHIVE_PATH=/path/Runner.xcarchive' \
+		'  sync-homebrew-cask Generate ~/proj/homebrew-taps/Casks/server-box.rb from a built DMG' \
+		'                     Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"' \
+		'                     Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive' \
+		'                     Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1.dmg'
 
 deps pub-get:
 	$(FLUTTER) pub get
@@ -134,3 +141,19 @@ package-dmg:
 	else \
 		XCARCHIVE_PATH="$(XCARCHIVE_PATH)" bash scripts/release/package-dmg-from-xcarchive.sh; \
 	fi
+
+sync-homebrew-cask:
+	@if [ -z "$(APP_PATH)" ] && [ -z "$(XCARCHIVE_PATH)" ] && [ -z "$(DMG_PATH)" ]; then \
+		echo 'APP_PATH, XCARCHIVE_PATH, or DMG_PATH is required.'; \
+		echo 'Example: make sync-homebrew-cask APP_PATH="/path/Server Box.app"'; \
+		echo 'Example: make sync-homebrew-cask XCARCHIVE_PATH=/path/Runner.xcarchive'; \
+		echo 'Example: make sync-homebrew-cask DMG_PATH=build/artifacts/ServerBox-1.0.1.dmg'; \
+		exit 1; \
+	fi
+	@if [ -n "$(APP_PATH)" ]; then \
+		APP_PATH="$(APP_PATH)" DMG_PATH="$(DMG_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
+	elif [ -n "$(XCARCHIVE_PATH)" ]; then \
+		XCARCHIVE_PATH="$(XCARCHIVE_PATH)" DMG_PATH="$(DMG_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
+	else \
+		DMG_PATH="$(DMG_PATH)" TAP_REPO_PATH="$(TAP_REPO_PATH)" bash scripts/release/sync-homebrew-cask.sh; \
+	fi

README.md

@@ -30,9 +30,10 @@ Especially thanks to <a href="https://github.com/TerminalStudio/dartssh2">dartss
 
 |Platform| From|
 |--|--|
-| iOS / macOS     | [AppStore](https://apps.apple.com/app/id1586449703)                                                                                                                                                                                                                               |
-| Android         | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) / [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox) / [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/) |
-| Linux / Windows | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid)                                                                                                                                 |
+| iOS | [AppStore](https://apps.apple.com/app/id1586449703) |
+| macOS | [AppStore](https://apps.apple.com/app/id1586449703) / brew install --cask server-box |
+| Android | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) / [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox) / [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/) |
+| Linux / Windows | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) |
 
 Please only download pkgs from the source that **you trust**!  
 
@@ -73,17 +74,6 @@ If I forgot to add your name to the contributors list, please add a comment in t
 2. Clone this repo, run `flutter run` to start the app.
 3. Run `dart run fl_build -p PLATFORM` to build the app.
 
-### Release macOS notarized DMG
-
-1. Copy `.env.release.example` to `.env.release`.
-2. Fill in `APPLE_TEAM_ID` and `APPLE_NOTARY_KEYCHAIN_PROFILE`.
-3. Make sure the `Developer ID Application` certificate is already installed in Keychain.
-4. Make sure notarization credentials are already stored via `xcrun notarytool store-credentials`.
-5. Install the provisioning profile used for DMG packaging. The script defaults to `ServerBox DMG Profile`, and you can override it with `APP_PROFILE_NAME`.
-6. Run `bash scripts/release/release-macos-dmg.sh`.
-
-This flow does not modify the default Xcode Release signing config. It injects a temporary `xcconfig` only for archive/export, builds a signed `.app`, packages a DMG, submits it to notarization, staples the result, and optionally uploads the DMG to the GitHub Release for `v<version>`.
-
 ### Translation
 
 - [Guide](https://blog.lpkt.cn/posts/faq/) can be found in my blog.

README_zh.md

@@ -30,8 +30,9 @@
 
 平台|下载
 --|--
-iOS / macOS     | [AppStore](https://apps.apple.com/app/id1586449703)
-Android         | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) / [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox) / [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/)
+| iOS | [AppStore](https://apps.apple.com/app/id1586449703) |
+| macOS | [AppStore](https://apps.apple.com/app/id1586449703) / brew install --cask server-box |
+Android | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) / [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox) / [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/)
 Linux / Windows | [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) / [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid)
 
 请从 **信任** 的来源下载!
@@ -75,17 +76,6 @@ Linux / Windows | [GitHub](https://github.com/lollipopkit/flutter_server_box/rel
 2. 克隆这个仓库, 运行 `flutter run` 启动应用
 3. 运行 `dart run fl_build -p PLATFORM` 构建应用
 
-### 发布 macOS 公证 DMG
-
-1. 复制 `.env.release.example` 为 `.env.release`
-2. 填入 `APPLE_TEAM_ID` 和 `APPLE_NOTARY_KEYCHAIN_PROFILE`
-3. 确保 `Developer ID Application` 证书已经安装到 Keychain
-4. 确保已经通过 `xcrun notarytool store-credentials` 存好了公证凭据
-5. 安装用于 DMG 打包的 provisioning profile。脚本默认使用 `ServerBox DMG Profile`，也可以通过 `APP_PROFILE_NAME` 覆盖
-6. 运行 `bash scripts/release/release-macos-dmg.sh`
-
-这套流程不会修改工程默认的 Xcode Release 签名配置。脚本只会在归档和导出时注入临时 `xcconfig`，生成已签名 `.app`、打包 DMG、提交公证、回填 stapler，并可选把 DMG 上传到 `v<version>` 对应的 GitHub Release。
-
 ### 翻译
 
 [指南](https://blog.lpkt.cn/faq/) 可在我的博客中找到。

docs/astro.config.mjs

@@ -4,6 +4,7 @@ import starlight from '@astrojs/starlight';
 
 // https://astro.build/config
 export default defineConfig({
+	base: '/docs',
 	integrations: [
 		starlight({
 			title: 'Server Box',

docs/src/content/docs/advanced/bulk-import.md

@@ -10,7 +10,7 @@ Import multiple server configurations at once using a JSON file.
 :::danger[Security Warning]
 **Never store plaintext passwords in files!** This JSON example shows a password field for demonstration only, but you should:
 
-- **Prefer SSH keys** (`keyId`) instead of `pwd` - they're more secure
+- **Prefer SSH keys** (`pubKeyId`) instead of `pwd` - they're more secure
 - **Use secret managers** or environment variables if you must use passwords
 - **Delete the file immediately** after import - don't leave credentials lying around
 - **Add to .gitignore** - never commit credential files to version control
@@ -24,7 +24,7 @@ Import multiple server configurations at once using a JSON file.
     "port": 22,
     "user": "root",
     "pwd": "password",
-    "keyId": "",
+    "pubKeyId": "",
     "tags": ["production"],
     "autoConnect": false
   }
@@ -40,9 +40,10 @@ Import multiple server configurations at once using a JSON file.
 | `port` | Yes | SSH port (usually 22) |
 | `user` | Yes | SSH username |
 | `pwd` | No | Password (avoid - use SSH keys instead) |
-| `keyId` | No | SSH key name (from Private Keys - recommended) |
+| `pubKeyId` | No | Private key id (from Private Keys - recommended) |
 | `tags` | No | Organization tags |
 | `autoConnect` | No | Auto-connect on startup |
+| `id` | No | Stable server id; omitted or empty values are generated on import |
 
 ## Import Steps
 
@@ -60,15 +61,15 @@ Import multiple server configurations at once using a JSON file.
     "ip": "prod.example.com",
     "port": 22,
     "user": "admin",
-    "keyId": "my-key",
+    "pubKeyId": "my-key",
     "tags": ["production", "web"]
   },
   {
     "name": "Development",
     "ip": "dev.example.com",
     "port": 2222,
     "user": "dev",
-    "keyId": "dev-key",
+    "pubKeyId": "dev-key",
     "tags": ["development"]
   }
 ]

docs/src/content/docs/de/advanced/bulk-import.md

@@ -10,7 +10,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D
 :::danger[Sicherheitswarnung]
 **Speichern Sie niemals Klartext-Passwörter in Dateien!** Dieses JSON-Beispiel zeigt ein Passwort-Feld nur zur Demonstration, aber Sie sollten:
 
-- **SSH-Schlüssel bevorzugen** (`keyId`) anstelle von `pwd` - diese sind sicherer
+- **SSH-Schlüssel bevorzugen** (`pubKeyId`) anstelle von `pwd` - diese sind sicherer
 - **Passwort-Manager** oder Umgebungsvariablen verwenden, wenn Sie Passwörter verwenden müssen
 - **Löschen Sie die Datei sofort** nach dem Import - lassen Sie keine Anmeldedaten herumliegen
 - **Fügen Sie sie zur .gitignore hinzu** - checken Sie niemals Anmeldedatendateien in die Versionsverwaltung ein
@@ -24,7 +24,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D
     "port": 22,
     "user": "root",
     "pwd": "password",
-    "keyId": "",
+    "pubKeyId": "",
     "tags": ["production"],
     "autoConnect": false
   }
@@ -40,7 +40,7 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D
 | `port` | Ja | SSH-Port (normalerweise 22) |
 | `user` | Ja | SSH-Benutzername |
 | `pwd` | Nein | Passwort (vermeiden - stattdessen SSH-Schlüssel verwenden) |
-| `keyId` | Nein | SSH-Schlüsselname (aus Private Keys - empfohlen) |
+| `pubKeyId` | Nein | Private-Key-ID (aus Private Keys - empfohlen) |
 | `tags` | Nein | Organisations-Tags |
 | `autoConnect` | Nein | Automatische Verbindung beim Start |
 
@@ -60,15 +60,15 @@ Importieren Sie mehrere Serverkonfigurationen gleichzeitig mithilfe einer JSON-D
     "ip": "prod.example.com",
     "port": 22,
     "user": "admin",
-    "keyId": "my-key",
+    "pubKeyId": "my-key",
     "tags": ["production", "web"]
   },
   {
     "name": "Entwicklung",
     "ip": "dev.example.com",
     "port": 2222,
     "user": "dev",
-    "keyId": "dev-key",
+    "pubKeyId": "dev-key",
     "tags": ["development"]
   }
 ]

docs/src/content/docs/de/development/architecture.md

@@ -47,7 +47,7 @@ Server Box folgt den Prinzipien der Clean Architecture mit einer klaren Trennung
 ### Lokale Speicherung: Hive
 
 - **hive_ce**: Community-Edition von Hive
-- Keine manuellen `@HiveField` oder `@HiveType` erforderlich
+- Folgen Sie dem bestehenden Modellmuster: Die meisten Stores verwenden `hive_ce`, einige verfolgte Modelle deklarieren weiterhin explizit `@HiveType` und `@HiveField`
 - Typ-Adapter werden automatisch generiert
 - Persistenter Key-Value-Speicher
 

docs/src/content/docs/de/development/codegen.md

@@ -21,8 +21,11 @@ Führen Sie sie aus nach der Änderung von:
 # Gesamten Code generieren
 dart run build_runner build --delete-conflicting-outputs
 
-# Bereinigen und neu generieren
-dart run build_runner build --delete-conflicting-outputs --clean
+# Generierten Build-Cache bereinigen
+dart run build_runner clean
+
+# Dann neu generieren
+dart run build_runner build --delete-conflicting-outputs
 ```
 
 ## Generierte Dateien
@@ -94,5 +97,5 @@ Generiert `lib/generated/l10n/` aus `lib/l10n/*.arb` Dateien.
 ## Tipps
 
 - Verwenden Sie `--delete-conflicting-outputs`, um Konflikte zu vermeiden.
-- Fügen Sie generierte Dateien zur `.gitignore` hinzu.
+- Behalten Sie generierte Dateien in der Versionsverwaltung, wenn dieses Repository sie bereits verfolgt.
 - Bearbeiten Sie generierte Dateien niemals manuell.

docs/src/content/docs/de/development/testing.md

@@ -18,17 +18,7 @@ flutter test --coverage
 
 ## Teststruktur
 
-Tests befinden sich im Verzeichnis `test/` und spiegeln die Struktur von `lib/` wider:
-
-```
-test/
-├── data/
-│   ├── model/
-│   └── provider/
-├── view/
-│   └── widget/
-└── test_helpers.dart
-```
+Tests befinden sich im Verzeichnis `test/`. Die aktuelle Suite ist überwiegend flach und nach Parser-, Modell- und Utility-Verhalten gruppiert, zum Beispiel `cpu_test.dart`, `container_test.dart` und `ssh_config_test.dart`.
 
 ## Unit-Tests
 
@@ -71,26 +61,13 @@ test('serverStatusProvider gibt Status zurück', () async {
 });
 ```
 
-## Mocking
-
-Mocks für externe Abhängigkeiten verwenden:
-
-```dart
-class MockSshService extends Mock implements SshService {}
+## Externe Abhängigkeiten
 
-test('verbindet zum Server', () async {
-  final mockSsh = MockSshService();
-  when(mockSsh.connect(any)).thenAnswer((_) async => true);
-
-  // Test mit Mock
-});
-```
+Vermeiden Sie Tests, die von echten SSH-Servern abhängen. Parser-, Modell- und Command-Builder-Tests sollten deterministisch bleiben; fügen Sie gezielte Fakes oder Fixtures hinzu, wenn eine Funktion eine Service-Grenze einführt.
 
 ## Integrationstests
 
-Komplette Benutzerabläufe testen (in `integration_test/`):
-
-```dart
+Im aktuellen Repository gibt es keine `integration_test/`-Suite. Fügen Sie Integrationstests nur hinzu, wenn eine Funktion End-to-End-Geräte- oder App-Flow-Abdeckung benötigt.dart
 testWidgets('Server hinzufügen Ablauf', (tester) async {
   await tester.pumpWidget(MyApp());
 

docs/src/content/docs/de/index.mdx

@@ -5,7 +5,7 @@ hero:
   tagline: Verwalten Sie Ihre Linux-Server von überall aus
   actions:
     - text: Loslegen
-      link: /de/introduction/
+      link: /docs/de/introduction/
       icon: right-arrow
       variant: primary
     - text: Auf GitHub ansehen
@@ -41,6 +41,6 @@ import { Card, CardGrid } from '@astrojs/starlight/components';
 
 ## Quick-Links
 
-- **Download**: Verfügbar im [App Store](https://apps.apple.com/app/id1586449703), auf [GitHub](https://github.com/lollipopkit/flutter_server_box/releases) und bei [F-Droid](https://f-droid.org/)
+- **Download**: Verfügbar im [App Store](https://apps.apple.com/app/id1586449703), auf [GitHub](https://github.com/lollipopkit/flutter_server_box/releases), bei [F-Droid](https://f-droid.org/packages/tech.lolli.toolbox), im [CDN](https://cdn.lpkt.cn/serverbox/pkg/?sort=time&order=desc&layout=grid) und bei [OpenAPK](https://www.openapk.net/serverbox/tech.lolli.toolbox/)
 - **Dokumentation**: Entdecken Sie die Anleitungen für den Einstieg in die Server Box
 - **Support**: Treten Sie unserer Community auf GitHub für Diskussionen und Probleme bei