Orqestria Letöltés
← Vissza a katalógushoz

Skill · 1.0.0 verzió

Asztali adattárolás és hitelesítők

Megfelelő tárolási helyre választja szét az alkalmazásadatokat, biztonságos helyi írást és rendszerrel védett hitelesítőket.

desktop-storage-credentials

Nézd meg, miben segít

Mikor hasznos?

Akkor használd, ha helyi adatbázis, konfiguráció és token következetes kezelést igényel.

Miben segít neked?

  • A rendszer könyvtárait használja tartós adatra, gyorsítótárra és naplóra.
  • Védi az SQLite tulajdonlását és konfigurációcserét a megszakadt írás ellen.
  • Rendszerszintű hitelesítőtárban kezeli a titkokat kifejezett hibakezeléssel.

Például ezt kérheted

Helyezd az API-tokeneket a rendszer kulcstárába, és megszakadt íráskor őrizd meg az érvényes beállítást. Szakítsd meg a beállításfájl cseréjét, és tiltsd a kulcstár elérését. Maradjon meg az érvényes beállítás, látható hitelesítési hibával, naplózott token nélkül.

Részletes dokumentáció

Itt a skill eredeti útmutatóját, példáit és ellenőrzési szempontjait olvashatod az eredeti nyelven.

Részletek…Összecsukás

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.

Csomagban lévő fájlok 1

  • SKILL.md

A skillcsomag bemutatása

desktop-storage-credentials

desktop-storage-credentials: Megbízható natív kapcsolatokkal, helyi adatkezeléssel, folyamat-életciklussal, csomagolással és frissítéssel készít asztali alkalmazásokat.

Részletek…Összecsukás

desktop-storage-credentials

desktop-storage-credentials: Megbízható natív kapcsolatokkal, helyi adatkezeléssel, folyamat-életciklussal, csomagolással és frissítéssel készít asztali alkalmazásokat.

A teljes skillt és a hozzá tartozó fájlokat tartalmazza (1 fájl). Az alábbi eredeti leírás rögzíti a pontos alkalmazási területét.

A skill eredeti leírása (a forrás nyelvén)

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.

Telepítsd a skillt, nézd át a forrását és a megbízhatósági beállításait, majd engedélyezd a megfelelő projektben vagy ügynöknél.

Előfeltételek

  • A számítógépedre telepített Orqestria.