DeskamiMalý spoločník na tvojom stole

Formát exportu

Export, súčasť Deskami Plus, zapíše ten istý záznam minútu po minúte, aký si Deskami vedie na tvojom Macu. Nič sa nepridáva, neodhaduje ani nedopĺňa. Táto stránka opisuje, čo v súbore je.

Konvencie

  • Prázdna bunka v CSV alebo null v JSON znamená nemerané. 0 znamená zmerané a bola to nula.
  • Názvy stĺpcov sú vo všetkých jazykoch anglické a pevné; menia sa len spolu s novou hodnotou export_version.
  • Súbory sú v kódovaní UTF-8. V CSV sú hodnoty oddelené čiarkami a prvý riadok je hlavička.
  • Časy sú v UTC vo formáte ISO 8601, napríklad 2026-09-28T07:41:00Z. Dátumy sú vo formáte YYYY-MM-DD: kalendárny deň, pod ktorým sa minúta zaznamenala.
  • Desatinné čísla majú desatinnú bodku; oddeľovač tisícov sa nepoužíva nikdy. Logické hodnoty sú true a false.
  • Za každú minútu, v ktorej sa niečo zaznamenalo, je jeden riadok; za minúty, v ktorých sa nezaznamenalo nič, riadok nie je.

Stĺpce minút

CSV má tieto stĺpce v tomto poradí; v JSON tvoria každú minútu tie isté polia. Názov v zátvorke je stĺpec v surovom databázovom súbore.

  • minute_utc — čas. Začiatok minúty v UTC. (minute_utc, v sekundách unixového času)
  • local_day — dátum. Kalendárny deň, ku ktorému minúta patrí, v časovom pásme, v ktorom bol Mac v tom čase. Určí sa pri zápise; neskoršia zmena časového pásma ho neposunie. (day_key)
  • setup_id — celé číslo. Používané pracovné miesto: kamera plus rozloženie obrazoviek. V JSON sú pracovné miesta vypísané pod setups. (profile_id)
  • seconds_at_desk — 0 až 60. Sekundy, počas ktorých ťa kamera v tejto minúte videla. Keď má camera_off hodnotu false, 0 znamená, že kamera bola zapnutá a nevidela ťa. (present_s)
  • posture_deviation — číslo, 0 alebo viac. O koľko nižšie boli hlava a ramená oproti tvojmu vlastnému vzoru, priemerne za minútu, ako násobok hranice upozornenia platnej v tom čase: 0 pri vzore, 1 na hranici. Prázdne, keď sa držanie tela nemeralo. (posture_dev)
  • posture_peak — číslo, 0 alebo viac. Najvyššia hodnota tej istej miery v rámci minúty. (posture_peak)
  • distance_deviation — číslo, 0 alebo viac. O koľko bližšie k obrazovke bola tvoja tvár než pri vzore, na tej istej stupnici, odčítané z rozostupu očí v obraze. (distance_dev)
  • blinks — celé číslo. Žmurknutia spočítané, kým sa oči dali merať. Prázdne, keď sa nedali. (blinks)
  • incomplete_blinks — celé číslo. Žmurknutia, ktoré sa ani v najužšom okamihu nedostali dosť blízko k zatvoreniu. Prázdne, keď sa nedalo nič posúdiť. (incomplete_blinks)
  • head_pitch_degrees — číslo. Priemerný sklon hlavy v stupňoch, tak ako ho hlási kamera: voči kamere, nie voči tvojmu vzoru. (head_pitch)
  • confidence — 0 až 1. Priemerná spoľahlivosť detekcie tváre. (confidence)
  • light — 0 až 1. Priemerný jas oblasti tváre, od 0 (tma) po 1 (jas). Nie jas miestnosti. (light)
  • eyes_measured — logická hodnota. Oči sa v tejto minúte dali aspoň raz zmerať. Keď je hodnota false, blinks, incomplete_blinks a eye_observed_seconds sú prázdne. (eye_valid)
  • eye_observed_seconds — 0 až 60. Sekundy, počas ktorých sa oči naozaj sledovali. Žmurknutia za minútu sú blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
  • look_aways — celé číslo. Dokončené pohľady do diaľky, návyk 20-20-20. Prázdne, keď sa pohľady do diaľky nemerali. (gaze_breaks)
  • camera_off — logická hodnota. Kamera bola v tejto minúte vypnutá: vypol si ju ty, držala ju iná aplikácia alebo bolo odobraté povolenie. Stĺpce kamery sú potom prázdne; stĺpce aplikácie a aktivity môžu byť aj tak vyplnené. (camera_off)
  • declared_break — logická hodnota. Prestávka podľa teba: dal si Deskami vedieť, že máš prestávku. Minúta sa počíta ako čas mimo stola, nech kamera videla čokoľvek. (declared_break)
  • front_app — text. Identifikátor balíka (bundle identifier) aplikácie, ktorá bola väčšinu minúty vpredu, napríklad com.apple.Safari. Prázdne, keď bolo toto meranie vypnuté, obrazovka bola zamknutá alebo vpredu nebolo nič. Nikdy nie názov okna. (app_id)
  • app_switches — celé číslo. Koľkokrát sa v tejto minúte zmenila aplikácia vpredu. (app_switches)
  • active_seconds — 0 až 60. Sekundy, v ktorých od posledného dotyku klávesnice alebo myši neuplynulo viac ako 15 sekúnd. Číta sa len čas od poslednej udalosti, nikdy klávesy. Prázdne, keď bolo toto meranie vypnuté. (active_s)
  • call_seconds — 0 až 60. Sekundy, v ktorých bola vpredu aplikácia na hovory alebo mala jedna aplikácia naraz otvorený mikrofón aj reproduktor. Prázdne, keď sa to nemeralo, vrátane všetkých minút zaznamenaných predtým, ako to Deskami začalo merať. (meeting_s)

JSON

Súbor JSON je jeden objekt. Začína hlavičkou: export_version, app_version, exported_at, time_zone (v čase exportu), database_schema_version, range (kind, from, to) a setups (id, camera_name, created_at).

Potom nasleduje days, jeden objekt za každý zaznamenaný deň v rozsahu. Každý deň nesie vlastný súhrn, minúty a upozornenia:

  • local_day a minutes_at_desk, súčet seconds_at_desk vydelený 60.
  • breaks: úseky mimo stola dlhé 5 minút alebo viac a kratšie ako 2 hodiny, medzi dvoma úsekmi pri stole. Čas s vypnutou kamerou sa nepočíta ani na jednu stranu.
  • posture_fine_minutes (posture_deviation pod 1) a posture_attention_minutes (1 alebo viac).
  • blink_rate: žmurknutia za minútu počas času, keď sa oči sledovali; null, ak sa sledovali menej ako minútu.
  • incomplete_blink_ratio: null, keď sa dalo posúdiť príliš málo žmurknutí.
  • reminders_by_signal: zobrazené upozornenia, spočítané podľa signálu.
  • minutes: stĺpce minút uvedené vyššie, jeden objekt za každú minútu.
  • reminders: jeden objekt za každé upozornenie, s poľami time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink alebo gaze), build_up_seconds (čas nad hranicou pred upozornením), recover_seconds (čas, kým sa hodnota vrátila pod hranicu; null, keď sa meranie skôr zastavilo), asked (či sa zobrazila otázka o tvojom vzore) a answer (null, keď sa otázka nepoložila, inak true alebo false).

PDF

PDF nie je tabuľka: je to samotný súhrn — súhrn dňa, týždeň alebo mesiac — vytlačený na jednej strane presne tak, ako vyzerá na obrazovke. Každé číslo v ňom je to isté číslo ako na obrazovke.

Surový súbor

Nastavenia › Všeobecné › Údaje › Zobraziť vo Finderi ukáže history.sqlite vedľa súborov history.sqlite-wal a history.sqlite-shm. Kým Deskami beží, najnovšie minúty môžu byť ešte v súbore -wal; skopíruj všetky tri súbory alebo Deskami najprv ukonči. Ak ich vymažeš, kým Deskami beží, do niekoľkých sekúnd začne viesť nový, prázdny záznam. Export vždy zapíše úplný stav. Čo databáza obsahuje, je vypísané na stránke o súkromí.