Exportformátum

Az exportálás, amely a Deskami Plus része, ugyanazt a percről percre vezetett nyilvántartást írja ki, amelyet a Deskami a Mac-eden tárol. Semmit nem tesz hozzá, semmit nem becsül és semmit nem pótol. Ez az oldal leírja, mi van a fájlban.

Formai szabályok

Az üres cella a CSV-ben, illetve a null a JSON-ban azt jelenti: nincs mérés. A 0 azt jelenti: mért nulla — volt mérés, és az eredmény nulla.
Az oszlopnevek minden nyelven angolok és rögzítettek; csak egy új export_version értékkel együtt változnak.
A fájlok UTF-8 kódolásúak. A CSV vesszővel tagolt, és fejlécsorral kezdődik.
Az időpontok UTC-ben, ISO 8601 formátumban szerepelnek, például 2026-09-28T07:41:00Z. A dátumok YYYY-MM-DD alakúak: az a naptári nap, amelyhez a Deskami a percet rögzítette.
A tizedesjel pont, ezreselválasztó soha nincs. A logikai értékek true és false.
Minden olyan perchez, amelyben a Deskami bármit rögzített, egy sor tartozik; azokhoz a percekhez, amelyekben nem, nincs sor.

Percoszlopok

A CSV ezeket az oszlopokat tartalmazza, ebben a sorrendben; a JSON-ban ugyanezek a mezők alkotnak egy-egy percet. A zárójelben álló név a nyers adatbázisfájl oszlopa.

minute_utc — időpont. A perc kezdete, UTC-ben. (minute_utc, Unix-időben, másodpercekben)
local_day — dátum. A naptári nap, amelyhez a perc tartozik, abban az időzónában, amelyben a Mac akkor volt. Íráskor rögzül; egy későbbi időzónaváltás nem mozdítja el. (day_key)
setup_id — egész szám. A használatban lévő összeállítás: egy kamera és egy képernyő-elrendezés együtt. A JSON-ban az összeállítások a setups alatt szerepelnek. (profile_id)
seconds_at_desk — 0 és 60 között. Hány másodpercig látott téged a kamera ebben a percben. Ha a camera_off értéke false, a 0 azt jelenti, hogy a kamera be volt kapcsolva, és nem látott téged. (present_s)
posture_deviation — szám, 0 vagy több. Mennyivel volt lejjebb a fejed és a vállad a saját referenciádnál, a percre átlagolva, az akkor érvényes figyelmeztetési küszöb többszöröseként: 0 a referenciánál, 1 a küszöbnél. Üres, ha nem volt testtartásmérés. (posture_dev)
posture_peak — szám, 0 vagy több. Ugyanennek a mértéknek a legnagyobb értéke a percen belül. (posture_peak)
distance_deviation — szám, 0 vagy több. Mennyivel volt közelebb az arcod a képernyőhöz, mint a referenciánál, ugyanazon a skálán, abból kiolvasva, milyen távol vannak egymástól a szemeid a képen. (distance_dev)
blinks — egész szám. A pislogások száma, amíg a szem mérhető volt. Üres, ha nem volt mérhető. (blinks)
incomplete_blinks — egész szám. Azok a pislogások, amelyeknél a szem a legszűkebb pillanatban sem került elég közel a zárt állapothoz. Üres, ha nem lehetett megítélni. (incomplete_blinks)
head_pitch_degrees — szám. A fej átlagos előre-hátra dőlése fokban, ahogy a kamera jelenti: a kamerához képest, nem a referenciádhoz. (head_pitch)
confidence — 0 és 1 között. Az arcészlelés átlagos megbízhatósága. (confidence)
light — 0 és 1 között. Az arc területének átlagos fényessége, a 0 sötéttől az 1 világosig. Nem a szobáé. (light)
eyes_measured — logikai érték. A szem ebben a percben legalább egyszer mérhető volt. Ha az értéke false, a blinks, az incomplete_blinks és az eye_observed_seconds üres. (eye_valid)
eye_observed_seconds — 0 és 60 között. Hány másodpercig volt a szem ténylegesen megfigyelve. A percenkénti pislogásszám: blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
look_aways — egész szám. Befejezett távolba nézések, a 20-20-20 szokás. Üres, ha a Deskami nem mérte a távolba nézést. (gaze_breaks)
camera_off — logikai érték. A kamera ebben a percben ki volt kapcsolva: te kapcsoltad ki, egy másik app foglalta, vagy visszavonták az engedélyt. A kamerás oszlopok ilyenkor üresek; az app- és aktivitásoszlopok ettől még ki lehetnek töltve. (camera_off)
declared_break — logikai érték. Jelezted a Deskaminak, hogy nem dolgozol. A perc az asztaltól távol töltött időnek számít, bármit látott is a kamera. (declared_break)
front_app — szöveg. A perc nagyobb részében elöl lévő app csomagazonosítója (bundle identifier), például com.apple.Safari. Üres, ha ez a leolvasás ki volt kapcsolva, a képernyő zárolva volt, vagy semmi sem volt elöl. Soha nem ablakcím. (app_id)
app_switches — egész szám. Hányszor változott ebben a percben az elöl lévő app. (app_switches)
active_seconds — 0 és 60 között. Azok a másodpercek, amelyekben az utolsó 15 másodpercen belül hozzányúltak a billentyűzethez vagy az egérhez. Csak az utolsó esemény óta eltelt időt olvassa, soha a billentyűket. Üres, ha ez a leolvasás ki volt kapcsolva. (active_s)
call_seconds — 0 és 60 között. Azok a másodpercek, amelyekben hívásapp volt elöl, vagy egy app egyszerre tartotta nyitva a mikrofont és a hangszórót. Üres, ha nincs mérés; így üres minden olyan percben is, amelyet a Deskami még azelőtt rögzített, hogy ezt mérni kezdte. (meeting_s)

JSON

A JSON-fájl egyetlen objektum. Fejléccel kezdődik: export_version, app_version, exported_at, time_zone (az exportálás idején), database_schema_version, range (kind, from, to) és setups (id, camera_name, created_at).

Ezután jön a days: a tartomány minden rögzített napjához egy objektum. Minden nap a saját összegzését, perceit és figyelmeztetéseit hordozza:

local_day és minutes_at_desk: a seconds_at_desk összege osztva 60-nal.
breaks: legalább 5 perces, de 2 óránál rövidebb, asztaltól távol töltött szakaszok két asztalnál töltött szakasz között. A kikapcsolt kamerás idő egyik irányba sem számít.
posture_fine_minutes (posture_deviation 1 alatt) és posture_attention_minutes (1 vagy felette).
blink_rate: a percenkénti pislogásszám arra az időre, amíg a szem meg volt figyelve; null, ha a megfigyelés egy percnél rövidebb volt.
incomplete_blink_ratio: null, ha túl kevés pislogást lehetett megítélni.
reminders_by_signal: a megjelenített figyelmeztetések, jelenként megszámolva.
minutes: a fenti percoszlopok, percenként egy objektum.
reminders: figyelmeztetésenként egy objektum, ezekkel a mezőkkel: time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink vagy gaze), build_up_seconds (a küszöb felett töltött idő a figyelmeztetés előtt), recover_seconds (az idő, amíg újra a küszöb alá került; null, ha a mérés előbb leállt), asked (megjelent-e a referenciádra vonatkozó kérdés) és answer (null, ha nem volt kérdés, egyébként true vagy false).

PDF

A PDF nem táblázat: maga az összegzés — a napi összegzés, a hét vagy a hónap — egyetlen oldalra nyomtatva, pontosan úgy, ahogy a képernyőn látszik. Minden szám benne ugyanaz, mint a képernyőn.

A nyers fájl

A Beállítások › Általános › Adatok › Megjelenítés a Finderben megmutatja a history.sqlite fájlt a history.sqlite-wal és a history.sqlite-shm mellett. Amíg a Deskami fut, a legújabb percek még a -wal fájlban lehetnek; másold át mindhárom fájlt, vagy előbb lépj ki a Deskamiból. Ha törlöd őket, amíg a Deskami fut, néhány másodpercen belül új, üres nyilvántartást kezd. Az exportálás mindig teljes pillanatképet ír. Hogy mit tartalmaz az adatbázis, azt az adatvédelmi oldal sorolja fel.