DeskamiMalo društvo na tvom stolu

Format izvoza

Izvoz, dio Deskami Plusa, zapisuje istu evidenciju minutu po minutu koju Deskami vodi na tvom Macu. Ništa se ne dodaje, ne procjenjuje niti nadopunjuje. Ova stranica opisuje što je u datoteci.

Konvencije

  • Prazna ćelija u CSV-u ili null u JSON-u znači nije izmjereno. 0 znači izmjereno i bilo je nula.
  • Nazivi stupaca u svim su jezicima na engleskom i fiksni; mijenjaju se samo zajedno s novom vrijednošću export_version.
  • Datoteke su u UTF-8. U CSV-u su vrijednosti odvojene zarezima, a prvi je redak zaglavlje.
  • Vremena su u UTC-u prema ISO 8601, npr. 2026-09-28T07:41:00Z. Datumi su u obliku YYYY-MM-DD: kalendarski dan pod kojim je minuta zabilježena.
  • Decimalni brojevi pišu se s točkom, nikad s razdjelnikom tisućica. Logičke vrijednosti su true i false.
  • Za svaku minutu u kojoj je Deskami nešto zabilježio postoji jedan redak, a za minute u kojima nije, retka nema.

Stupci minuta

CSV ima ove stupce, ovim redom; u JSON-u ista polja čine svaku minutu. Naziv u zagradi je stupac u sirovoj datoteci baze podataka.

  • minute_utc — vrijeme. Početak minute, u UTC-u. (minute_utc, u sekundama Unix vremena)
  • local_day — datum. Kalendarski dan kojem minuta pripada, u vremenskoj zoni u kojoj je Mac tada bio. Određuje se pri zapisu; kasnija promjena vremenske zone ne pomiče ga. (day_key)
  • setup_id — cijeli broj. Sklop u upotrebi: kamera plus raspored ekrana. U JSON-u su sklopovi navedeni pod setups. (profile_id)
  • seconds_at_desk — od 0 do 60. Sekunde u kojima te je kamera u ovoj minuti vidjela. Kad je camera_off false, 0 znači da je kamera bila uključena i nije te vidjela. (present_s)
  • posture_deviation — broj, 0 ili više. Koliko su ti glava i ramena bili niže od tvoje vlastite reference, u prosjeku kroz minutu, kao višekratnik praga upozorenja koji je tada vrijedio: 0 na referenci, 1 na pragu. Prazno kad držanje nije mjereno. (posture_dev)
  • posture_peak — broj, 0 ili više. Najveća vrijednost iste mjere unutar minute. (posture_peak)
  • distance_deviation — broj, 0 ili više. Koliko ti je lice bilo bliže ekranu nego u referenci, na istoj ljestvici, očitano iz razmaka između očiju na slici. (distance_dev)
  • blinks — cijeli broj. Treptaji izbrojeni dok su se oči mogle mjeriti. Prazno kad nisu mogle. (blinks)
  • incomplete_blinks — cijeli broj. Treptaji čiji se najuži trenutak nije dovoljno približio zatvorenom oku. Prazno kad procjena nije bila moguća. (incomplete_blinks)
  • head_pitch_degrees — broj. Prosječni nagib glave u stupnjevima, kako ga javlja kamera: u odnosu na kameru, a ne na tvoju referencu. (head_pitch)
  • confidence — od 0 do 1. Prosječna pouzdanost detekcije lica. (confidence)
  • light — od 0 do 1. Prosječna svjetlina područja lica, od 0 (tamno) do 1 (svijetlo). Ne svjetlina prostorije. (light)
  • eyes_measured — logička vrijednost. Oči su se u ovoj minuti barem jednom mogle izmjeriti. Kad je false, blinks, incomplete_blinks i eye_observed_seconds su prazni. (eye_valid)
  • eye_observed_seconds — od 0 do 60. Sekunde u kojima su oči stvarno promatrane. Broj treptaja u minuti je blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
  • look_aways — cijeli broj. Završeni pogledi u daljinu, navika 20-20-20. Prazno kad se gledanje u daljinu nije mjerilo. (gaze_breaks)
  • camera_off — logička vrijednost. Kamera je u ovoj minuti bila isključena: isključio si je ti, držala ju je druga aplikacija ili je dopuštenje povučeno. Stupci kamere tada su prazni; stupci aplikacija i aktivnosti ipak mogu biti popunjeni. (camera_off)
  • declared_break — logička vrijednost. Rekao si Deskamiju da imaš pauzu. Minuta se računa kao vrijeme izvan stola, bez obzira na to što je kamera vidjela. (declared_break)
  • front_app — tekst. Identifikator paketa (bundle identifier) aplikacije koja je većinu minute bila u prvom planu, npr. com.apple.Safari. Prazno kad je to očitanje isključeno, kad je ekran zaključan ili kad ništa nije u prvom planu. Nikad naslov prozora. (app_id)
  • app_switches — cijeli broj. Koliko se puta u ovoj minuti promijenila aplikacija u prvom planu. (app_switches)
  • active_seconds — od 0 do 60. Sekunde u kojima su tipkovnica ili miš bili dodirnuti unutar posljednjih 15 sekundi. Čita se samo vrijeme od posljednjeg događaja, nikad tipke. Prazno kad je to očitanje isključeno. (active_s)
  • call_seconds — od 0 do 60. Sekunde u kojima je u prvom planu bila aplikacija za pozive ili je jedna aplikacija istodobno imala otvoren mikrofon i zvučnik. Prazno kad nije mjereno, uključujući svaku minutu zabilježenu prije nego što je Deskami to počeo mjeriti. (meeting_s)

JSON

JSON datoteka je jedan objekt. Počinje zaglavljem: export_version, app_version, exported_at, time_zone (u trenutku izvoza), database_schema_version, range (kind, from, to) i setups (id, camera_name, created_at).

Zatim dolazi days, jedan objekt za svaki zabilježeni dan u rasponu. Svaki dan nosi vlastiti sažetak, minute i upozorenja:

  • local_day i minutes_at_desk, zbroj seconds_at_desk podijeljen sa 60.
  • breaks: razdoblja izvan stola od 5 minuta ili više, a kraća od 2 sata, između dva razdoblja za stolom. Vrijeme s isključenom kamerom ne računa se ni na jednu stranu.
  • posture_fine_minutes (posture_deviation ispod 1) i posture_attention_minutes (1 ili više).
  • blink_rate: treptaji u minuti tijekom vremena u kojem su oči promatrane; null kad je promatranja bilo manje od jedne minute.
  • incomplete_blink_ratio: null kad se moglo procijeniti premalo treptaja.
  • reminders_by_signal: prikazana upozorenja, prebrojena po signalu.
  • minutes: gore navedeni stupci minuta, jedan objekt po minuti.
  • reminders: jedan objekt po upozorenju, s poljima time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink ili gaze), build_up_seconds (vrijeme iznad praga prije upozorenja), recover_seconds (vrijeme do povratka ispod praga; null kad je mjerenje prije toga prestalo), asked (je li prikazano pitanje o tvojoj referenci) i answer (null kad pitanje nije postavljeno, inače true ili false).

PDF

PDF nije tablica: to je sam sažetak — sažetak dana, tjedan ili mjesec — ispisan na jednoj stranici točno onako kako izgleda na ekranu. Svaki broj u njemu je broj s ekrana.

Sirova datoteka

Postavke › Općenito › Podaci › Prikaži u Finderu pokazuje history.sqlite, uz history.sqlite-wal i history.sqlite-shm. Dok Deskami radi, najnovije minute možda su još u datoteci -wal; kopiraj sve tri datoteke ili prvo izađi iz Deskamija. Ako ih obrišeš dok Deskami radi, u roku od nekoliko sekundi počet će voditi novu, praznu evidenciju. Izvoz uvijek zapisuje potpunu snimku stanja. Što baza podataka sadrži, navedeno je na stranici o privatnosti.