Format eksportu

Eksport, część Deskami Plus, zapisuje ten sam rejestr minuta po minucie, który Deskami przechowuje na twoim Macu. Nic nie jest dodawane, szacowane ani uzupełniane. Ta strona opisuje, co jest w pliku.

Konwencje

Pusta komórka w CSV albo null w JSON oznacza nie zmierzono. 0 oznacza zmierzono i wyszło zero.
Nazwy kolumn są po angielsku w każdym języku i są stałe; zmieniają się tylko razem z nową wartością export_version.
Pliki są w UTF-8. CSV jest rozdzielany przecinkami i ma wiersz nagłówka.
Czas jest podawany w UTC w formacie ISO 8601, np. 2026-09-28T07:41:00Z. Daty mają format YYYY-MM-DD i oznaczają dzień kalendarzowy, pod którym zapisano minutę.
Separatorem dziesiętnym jest kropka; separatora tysięcy nie ma nigdy. Wartości logiczne to true i false.
Jest jeden wiersz dla każdej minuty, w której Deskami coś zapisał, i żadnego wiersza dla minut, w których nie zapisał nic.

Kolumny minut

CSV ma te kolumny, w tej kolejności; w JSON te same pola tworzą każdą minutę. Nazwa w nawiasie to kolumna w surowym pliku bazy danych.

minute_utc — czas. Początek minuty, w UTC. (minute_utc, w sekundach Unix)
local_day — data. Dzień kalendarzowy, do którego należy ta minuta, w strefie czasowej, w której był wtedy Mac. Jest ustalany przy zapisie; późniejsza zmiana strefy czasowej go nie przesuwa. (day_key)
setup_id — liczba całkowita. Używane stanowisko: kamera plus układ ekranów. W JSON stanowiska są wymienione w setups. (profile_id)
seconds_at_desk — od 0 do 60. Sekundy, przez które kamera widziała cię w tej minucie. Gdy camera_off ma wartość false, 0 oznacza, że kamera była włączona i cię nie widziała. (present_s)
posture_deviation — liczba, 0 lub więcej. Jak nisko pod twoim własnym punktem odniesienia były twoja głowa i ramiona, średnio w ciągu minuty, jako wielokrotność progu przypomnienia obowiązującego w tamtej chwili: 0 w punkcie odniesienia, 1 na progu. Puste, gdy postawa nie była mierzona. (posture_dev)
posture_peak — liczba, 0 lub więcej. Największa wartość tej samej miary w ciągu minuty. (posture_peak)
distance_deviation — liczba, 0 lub więcej. O ile bliżej ekranu była twoja twarz niż w punkcie odniesienia, w tej samej skali, odczytane z rozstawu twoich oczu w obrazie. (distance_dev)
blinks — liczba całkowita. Mrugnięcia policzone wtedy, gdy oczy dało się zmierzyć. Puste, gdy się nie dało. (blinks)
incomplete_blinks — liczba całkowita. Mrugnięcia, w których oko w najwęższym momencie nie zbliżyło się wystarczająco do zamknięcia. Puste, gdy ocena nie była możliwa. (incomplete_blinks)
head_pitch_degrees — liczba. Średnie pochylenie głowy do przodu lub do tyłu w stopniach, tak jak podaje je kamera: względem kamery, a nie twojego punktu odniesienia. (head_pitch)
confidence — od 0 do 1. Średnia pewność wykrycia twarzy. (confidence)
light — od 0 do 1. Średnia jasność obszaru twarzy, od 0 (ciemno) do 1 (jasno). Nie jasność pokoju. (light)
eyes_measured — wartość logiczna. Oczy dało się zmierzyć co najmniej raz w tej minucie. Gdy ma wartość false, blinks, incomplete_blinks i eye_observed_seconds są puste. (eye_valid)
eye_observed_seconds — od 0 do 60. Sekundy, przez które oczy były faktycznie obserwowane. Mrugnięcia na minutę to blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
look_aways — liczba całkowita. Pełne spojrzenia w dal, nawyk 20-20-20. Puste, gdy spojrzenia w dal nie były mierzone. (gaze_breaks)
camera_off — wartość logiczna. Kamera była w tej minucie wyłączona: wyłączono ją ręcznie, zajmowała ją inna aplikacja albo cofnięto zgodę. Kolumny kamery są wtedy puste; kolumny aplikacji i aktywności mogą być wypełnione. (camera_off)
declared_break — wartość logiczna. Przerwa zgłoszona przez ciebie w Deskami. Minuta liczy się jako czas poza biurkiem, niezależnie od tego, co widziała kamera. (declared_break)
front_app — tekst. Identyfikator pakietu (bundle identifier) aplikacji, która była na wierzchu przez większą część minuty, np. com.apple.Safari. Puste, gdy ten odczyt był wyłączony, ekran był zablokowany albo nic nie było na wierzchu. Nigdy tytuł okna. (app_id)
app_switches — liczba całkowita. Ile razy w tej minucie zmieniła się aplikacja na wierzchu. (app_switches)
active_seconds — od 0 do 60. Sekundy, w których klawiatury lub myszy dotknięto w ciągu poprzednich 15 sekund. Odczytywany jest tylko czas od ostatniego zdarzenia, nigdy klawisze. Puste, gdy ten odczyt był wyłączony. (active_s)
call_seconds — od 0 do 60. Sekundy, w których na wierzchu była aplikacja do rozmów albo jedna aplikacja miała jednocześnie otwarty mikrofon i głośnik. Puste, gdy nie było to mierzone, w tym w każdej minucie zapisanej, zanim Deskami zaczął to mierzyć. (meeting_s)

JSON

Plik JSON to jeden obiekt. Zaczyna się od nagłówka: export_version, app_version, exported_at, time_zone (z chwili eksportu), database_schema_version, range (kind, from, to) i setups (id, camera_name, created_at).

Potem jest days, po jednym obiekcie na każdy zapisany dzień z zakresu. Każdy dzień ma własne podsumowanie, minuty i przypomnienia:

local_day i minutes_at_desk, czyli suma seconds_at_desk podzielona przez 60.
breaks: odcinki poza biurkiem trwające co najmniej 5 minut i krócej niż 2 godziny, między dwoma odcinkami przy biurku. Czas z wyłączoną kamerą nie liczy się ani w jedną, ani w drugą stronę.
posture_fine_minutes (posture_deviation poniżej 1) i posture_attention_minutes (1 lub więcej).
blink_rate: mrugnięcia na minutę w czasie, gdy oczy były obserwowane; null przy obserwacji krótszej niż minuta.
incomplete_blink_ratio: null, gdy zbyt mało mrugnięć dało się ocenić.
reminders_by_signal: pokazane przypomnienia, policzone według sygnału.
minutes: opisane wyżej kolumny minut, po jednym obiekcie na minutę.
reminders: po jednym obiekcie na przypomnienie, z polami time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink albo gaze), build_up_seconds (czas powyżej progu przed przypomnieniem), recover_seconds (czas do powrotu poniżej progu; null, gdy pomiar skończył się wcześniej), asked (czy pokazano pytanie o twój punkt odniesienia) i answer (null, gdy pytania nie było, w przeciwnym razie true albo false).

PDF

PDF nie jest tabelą: to samo podsumowanie — podsumowanie dnia, tydzień albo miesiąc — wydrukowane na jednej stronie dokładnie tak, jak wygląda na ekranie. Każda liczba w nim to liczba z ekranu.

Surowy plik

Ustawienia › Ogólne › Dane › Pokaż w Finderze wskazuje plik history.sqlite, obok którego leżą history.sqlite-wal i history.sqlite-shm. Gdy Deskami działa, najnowsze minuty mogą być jeszcze w pliku -wal; skopiuj wszystkie trzy pliki albo najpierw zakończ Deskami. Jeśli je usuniesz, gdy Deskami działa, w ciągu kilku sekund zacznie prowadzić nowy, pusty rejestr. Eksport zawsze zapisuje pełną migawkę. To, co zawiera baza danych, wymienia strona o prywatności.