Deskamiחבר קטן על השולחן שלך

פורמט הייצוא

הייצוא, שהוא חלק מ-Deskami Plus, כותב את אותו רישום של דקה אחר דקה ש-Deskami שומר ב-Mac שלך. שום דבר לא נוסף ולא נאמד, ושום חור לא מתמלא. העמוד הזה מתאר מה יש בקובץ.

מוסכמות

  • תא ריק ב-CSV, או null ב-JSON, פירושו לא נמדד. 0 פירושו נמדד, והיה אפס.
  • שמות העמודות באנגלית בכל השפות, והם קבועים; הם משתנים רק יחד עם export_version חדש.
  • הקבצים ב-UTF-8. קובץ ה-CSV מופרד בפסיקים, ובראשו שורת כותרות.
  • הזמנים ב-UTC בתקן ISO 8601, למשל 2026-09-28T07:41:00Z. התאריכים בפורמט YYYY-MM-DD: היום הקלנדרי שתחתיו נרשמה הדקה.
  • מספרים עשרוניים נכתבים עם נקודה, ואף פעם לא עם מפריד אלפים. ערכים בוליאניים הם true ו-false.
  • יש שורה אחת לכל דקה שבה Deskami רשם משהו, ואין שורה לדקות שבהן הוא לא רשם דבר.

עמודות הדקה

ב-CSV יש את העמודות האלה, בסדר הזה; ב-JSON אותם שדות מרכיבים כל דקה. השם שבסוגריים הוא העמודה בקובץ מסד הנתונים הגולמי.

  • minute_utc — זמן. תחילת הדקה, ב-UTC. (minute_utc, בשניות Unix)
  • local_day — תאריך. היום הקלנדרי שאליו הדקה הזאת שייכת, לפי אזור הזמן שבו היה ה-Mac באותו זמן. הוא נקבע ברגע הכתיבה; שינוי מאוחר יותר של אזור הזמן לא מזיז אותו. (day_key)
  • setup_id — מספר שלם. המערך שהיה בשימוש: מצלמה יחד עם סידור מסכים. ב-JSON המערכים מפורטים תחת setups. (profile_id)
  • seconds_at_desk — 0 עד 60. השניות שבהן המצלמה ראתה אותך בדקה הזאת. כש-camera_off הוא false, הערך 0 פירושו שהמצלמה פעלה ולא ראתה אותך. (present_s)
  • posture_deviation — מספר, 0 ומעלה. כמה נמוך מהייחוס שלך ישבו הראש והכתפיים שלך, בממוצע על פני הדקה, ככפולה של סף התזכורת שהיה בתוקף באותו זמן: 0 בייחוס, 1 בסף. ריק כשהיציבה לא נמדדה. (posture_dev)
  • posture_peak — מספר, 0 ומעלה. הערך הגבוה ביותר של אותו מדד בתוך הדקה. (posture_peak)
  • distance_deviation — מספר, 0 ומעלה. כמה הפנים שלך היו קרובות יותר למסך מאשר בייחוס, באותו סולם, לפי המרווח בין העיניים שלך בתמונה. (distance_dev)
  • blinks — מספר שלם. המצמוצים שנספרו בזמן שאפשר היה למדוד את העיניים. ריק כשאי אפשר היה. (blinks)
  • incomplete_blinks — מספר שלם. מצמוצים שהרגע הצר ביותר שלהם לא התקרב מספיק לסגירה מלאה. ריק כשלא הייתה אפשרות לשפוט. (incomplete_blinks)
  • head_pitch_degrees — מספר. ההטיה הממוצעת של הראש למעלה או למטה, במעלות, כפי שהמצלמה מדווחת אותה: ביחס למצלמה, לא לייחוס שלך. (head_pitch)
  • confidence — 0 עד 1. הביטחון הממוצע של איתור הפנים. (confidence)
  • light — 0 עד 1. הבהירות הממוצעת של אזור הפנים, מ-0 חשוך עד 1 בהיר. לא של החדר. (light)
  • eyes_measured — בוליאני. אפשר היה למדוד את העיניים לפחות פעם אחת בדקה הזאת. כשהוא false, העמודות blinks, incomplete_blinks ו-eye_observed_seconds ריקות. (eye_valid)
  • eye_observed_seconds — 0 עד 60. השניות שבהן העיניים נצפו בפועל. מצמוצים לדקה הם blinks × 60 ÷ eye_observed_seconds. (eye_observed_s)
  • look_aways — מספר שלם. מבטים שהושלמו אל המרחק, הרגל 20-20-20. ריק כשהמבט למרחק לא נמדד. (gaze_breaks)
  • camera_off — בוליאני. המצלמה הייתה כבויה בדקה הזאת: כיבית אותה, אפליקציה אחרת החזיקה בה, או שההרשאה הוסרה. עמודות המצלמה ריקות אז; עמודות האפליקציה והפעילות עשויות עדיין להיות מלאות. (camera_off)
  • declared_break — בוליאני. אמרת ל-Deskami שאתה בהפסקה. הדקה נחשבת לזמן הרחק מהשולחן, לא משנה מה המצלמה ראתה. (declared_break)
  • front_app — טקסט. מזהה החבילה של האפליקציה שהייתה בחזית רוב הדקה, למשל com.apple.Safari. ריק כשהקריאה הזאת כובתה, כשהמסך היה נעול או כששום דבר לא היה בחזית. אף פעם לא כותרת חלון. (app_id)
  • app_switches — מספר שלם. כמה פעמים התחלפה האפליקציה שבחזית בדקה הזאת. (app_switches)
  • active_seconds — 0 עד 60. שניות שבהן נגעו במקלדת או בעכבר במהלך 15 השניות שלפניהן. נקרא רק הזמן שעבר מאז האירוע האחרון, אף פעם לא המקשים. ריק כשהקריאה הזאת כובתה. (active_s)
  • call_seconds — 0 עד 60. שניות שבהן אפליקציית שיחות הייתה בחזית, או שאפליקציה אחת החזיקה את המיקרופון והרמקול פתוחים יחד. ריק כשלא נמדד, כולל כל דקה שנרשמה לפני ש-Deskami התחיל למדוד את זה. (meeting_s)

JSON

קובץ ה-JSON הוא אובייקט אחד. הוא מתחיל בכותרת: export_version, app_version, exported_at, time_zone (בזמן הייצוא), database_schema_version, range (kind, from, to) ו-setups (id, camera_name, created_at).

אחריה בא days, אובייקט אחד לכל יום מתועד בטווח. כל יום נושא את הסיכום, הדקות והתזכורות שלו:

  • local_day ו-minutes_at_desk, הסכום של seconds_at_desk חלקי 60.
  • breaks: פרקי זמן של 5 דקות ומעלה הרחק מהשולחן, וקצרים משעתיים, בין שני פרקי זמן ליד השולחן. זמן שבו המצלמה כבויה לא נספר לשום צד.
  • posture_fine_minutes (posture_deviation מתחת ל-1) ו-posture_attention_minutes (1 ומעלה).
  • blink_rate: מצמוצים לדקה לאורך הזמן שבו העיניים נצפו; null כשהן נצפו פחות מדקה.
  • incomplete_blink_ratio: null כשמעט מדי מצמוצים ניתנו לשיפוט.
  • reminders_by_signal: התזכורות שהוצגו, לפי אות.
  • minutes: עמודות הדקה שלמעלה, אובייקט אחד לכל דקה.
  • reminders: אובייקט אחד לכל תזכורת, עם time_utc, local_day, setup_id, signal (posture, distance, blink, incompleteBlink או gaze), build_up_seconds (הזמן מעל הסף לפני התזכורת), recover_seconds (הזמן עד החזרה אל מתחת לסף; null כשהמדידה נעצרה קודם), asked (האם הוצגה השאלה על הייחוס שלך) ו-answer (null כשהשאלה לא נשאלה, אחרת true או false).

PDF

קובץ ה-PDF הוא לא טבלה: הוא הסיכום עצמו — סיכום היום, השבוע או החודש — מודפס על עמוד אחד בדיוק כפי שהוא נראה על המסך. כל מספר בו הוא המספר שעל המסך.

הקובץ הגולמי

הגדרות › כללי › נתונים › הצג ב-Finder חושף את history.sqlite, לצד history.sqlite-wal ו-history.sqlite-shm. בזמן ש-Deskami פועל, ייתכן שהדקות החדשות ביותר עדיין נמצאות בקובץ -wal; העתק את שלושת הקבצים, או צא קודם מ-Deskami. אם תמחק אותם בזמן ש-Deskami פועל, הוא מתחיל רישום חדש וריק תוך כמה שניות. הייצוא תמיד כותב תמונת מצב שלמה. מה שמסד הנתונים מכיל רשום בעמוד הפרטיות.