Orqestria Download
← Zurück zum Katalog

Skill · Version 1.0.0

Desktop-Speicher und Zugangsdaten

Trennt Anwendungsdaten, zuverlässige lokale Schreibvorgänge und systemgeschützte Zugangsdaten in geeignete Speicherorte.

desktop-storage-credentials

Entdecke, wie der Skill hilft

Wann ist der Skill hilfreich?

Nutze dies für konsistente Verantwortung für lokale Datenbanken, Einstellungen und Tokens.

Wobei hilft er dir?

  • Verwendet Systemverzeichnisse für dauerhafte Daten, Caches und Protokolle.
  • Schützt SQLite-Verantwortung und Konfigurationsersetzung gegen unterbrochene Schreibvorgänge.
  • Speichert Geheimnisse im System-Zugangsspeicher mit ausdrücklicher Fehlerbehandlung.

Das könntest du fragen

Verschiebe API-Tokens in den Systemschlüsselbund und erhalte gültige Einstellungen bei unterbrochenem Schreiben. Unterbrich den Austausch der Einstellungsdatei und verweigere Schlüsselbundzugriff. Gültige Einstellungen bleiben erhalten; der Zugangsdatenfehler ist klar und Logs enthalten kein Token.

Ausführliche Dokumentation

Hier findest du die ursprüngliche Anleitung, Beispiele und Prüfschritte des Skills in ihrer Originalsprache.

Details…Weniger anzeigen

Desktop Storage & Credentials

User data on a desktop machine must survive application updates, unexpected power loss, and multi-window access without corruption, while sensitive tokens stay encrypted by the OS credential store.

OS-Standard Directory Layout

Always store files in their designated OS directories—never inside the application installation folder (Program Files or /Applications/App.app), which is read-only for standard users and overwritten on every update:

Data Category macOS Windows Linux (XDG)
User Data & SQLite DB ~/Library/Application Support/<App> %APPDATA%\<App> ~/.config/<App> or ~/.local/share/<App>
Disposable Cache ~/Library/Caches/<App> %LOCALAPPDATA%\<App>\Cache ~/.cache/<App>
Diagnostic Logs ~/Library/Logs/<App> %APPDATA%\<App>\logs ~/.local/state/<App>/logs

SQLite & Config File Integrity on Desktop

  1. Single-Process SQLite Ownership & WAL Mode:
    • Never open and write to the same SQLite database file simultaneously from multiple renderer processes and background workers without coordination (SQLITE_BUSY / lock contention). Route all database writes through the single backend/main owner process.
    • Enable Write-Ahead Logging (PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL; PRAGMA foreign_keys = ON; PRAGMA busy_timeout = 5000;) at connection startup, and run PRAGMA wal_checkpoint(TRUNCATE) on clean shutdown.
  2. Atomic JSON Config Writes:
    • Never overwrite settings.json in place with fs.writeFileSync(configPath, data)—if the OS crashes or battery dies mid-write, the file is truncated to 0 bytes and the app fails to boot on restart!
    • Write to settings.json.tmp.<pid>, flush (fsync), and fs.renameSync atomically over settings.json. Keep a .bak fallback or schema recovery when parsing fails.

Secret & Token Storage via OS Keychain

  • Never store API keys, OAuth tokens, or session secrets in plaintext localStorage or unencrypted JSON:
    • In Electron: use safeStorage.encryptStringAsync() / safeStorage.decryptStringAsync() (backed by macOS Keychain, Windows DPAPI, and Linux libsecret/kwallet) and store the encrypted base64 ciphertext on disk, or store local server auth tokens in owner-only (mode: 0o600) files.
    • In Tauri: use tauri-plugin-stronghold or the keyring crate to store secrets in the native OS credential manager.

Enthaltene Dateien 1

  • SKILL.md

Über dieses Skill-Paket

desktop-storage-credentials

desktop-storage-credentials: Entwickelt Desktop-Apps mit zuverlässigen nativen Grenzen, lokalen Daten, Prozesslebenszyklen, Paketen und Updates.

Details…Weniger anzeigen

desktop-storage-credentials

desktop-storage-credentials: Entwickelt Desktop-Apps mit zuverlässigen nativen Grenzen, lokalen Daten, Prozesslebenszyklen, Paketen und Updates.

Enthält den vollständigen Skill und seine Begleitdateien (1 Dateien). Der genaue, ursprünglich verfasste Anwendungsbereich bleibt unten erhalten.

Ursprüngliche Skill-Beschreibung (Quellsprache)

Use when managing local SQLite databases, configuration files, atomic writes, multi-window concurrency, or OS keychain credential storage (Keychain, DPAPI, libsecret, safeStorage) in desktop apps.

Installiere den Skill, prüfe seine Quelle und Vertrauenseinstellungen und aktiviere ihn für das passende Projekt oder den Agenten.

Voraussetzungen

  • Orqestria auf deinem Computer installiert.