AtoAxis คำนวณเวลาการเขียนโค้ดอย่างไร

Heartbeat คือ event จาก editor ที่เชื่อมต่ออยู่ อาจมีเวลา file และ project metadata, branch, language, editor และ activity counts ข้อมูลนี้ยืนยันกิจกรรมที่ editor สังเกตได้ ไม่ได้หมายความว่าเวลาวางแผน อ่าน หรือประชุมทุกนาทีจะกลายเป็น coding time

• เวลาใน event วางกิจกรรมบน timeline ของบัญชี
• Metadata ทำให้กรองตาม project, language, branch หรือ editor ได้
• Counts และ attribution แยกจากการคำนวณ duration

AtoAxis รวมหลักฐานที่ทับซ้อนกันก่อน แล้วเรียง interval ที่เหลือ ระยะเวลาของ block คือ union ของ interval จึงไม่นับวินาทีซ้ำจากหลายแหล่ง event เดี่ยวพิสูจน์เพียงจุดเวลา ไม่ได้สร้าง session ยาวต่อท้ายเอง

09:00 interval ───── 09:05 interval ───── 09:10 interval
          เป็น duration block เดียวกัน

ค่าเริ่มต้นของ idle timeout สำหรับกิจกรรมจากคนคือ 15 นาที หาก interval ที่พิสูจน์ได้สองช่วงมี gap ไม่เกินค่านี้ ระบบจะเชื่อม gap ให้กับ interval ก่อนหน้า ตาม session model ที่เข้ากันได้กับ WakaTime หาก gap ยาวกว่านั้น block เดิมจะจบและเริ่ม block ใหม่ ค่า timeout ปรับได้ตาม deployment จึงควรยึดค่าของระบบที่ใช้งานจริง

• gap สั้นระหว่าง event จริงอาจถูกรวมใน block ก่อนหน้า
• gap ยาวกว่าค่าที่ตั้งจะปิด block เดิม ไม่เติมเวลาให้
• หลัง event สุดท้ายจะไม่เติมเวลาเพียงเพราะ session เคย active
• กิจกรรมจาก agent อาจใช้ timeout แยก หาก deployment เปิด timeline แบบแยก

ตัวอย่างสมมติ ไม่ใช่ข้อมูลลูกค้า: interval หนึ่งจบเวลา 09:00 และช่วงถัดไปเริ่ม 09:10 เมื่อ timeout เริ่มต้นคือ 15 นาที gap 10 นาทีจึงเชื่อมกัน หากช่วงถัดไปเริ่ม 09:30 gap 20 นาทีจะยาวเกินไป block แรกจึงจบและเริ่ม block ที่สอง เวลาหลัง interval สุดท้ายไม่ถูกนับ

09:00 ──(gap 10 นาที)── 09:10    เชื่อมกัน
09:10 ──(gap 20 นาที)── 09:30    block ใหม่

ตัวเลขนี้อธิบายกติกา ไม่ใช่การรับประกันยอด dashboard ใด ๆ ให้ดู timeline และหลักฐานของ interval เมื่อยอดไม่ตรงกับความคาดหมาย

• Coding time คือกิจกรรมจาก editor ที่สังเกตได้ ไม่ใช่เวลาทั้งหมดของงาน
• ยอด duration ไม่ใช่คะแนนคุณภาพ คุณค่า สมาธิ หรือ productivity
• ใช้ filter ตาม project, language, branch และ editor เพื่อหา evidence ของยอดนั้น
• อ่าน timeline คู่กับ coverage ก่อนสรุปผล

เชื่อม editor หนึ่งตัว รัน wakaclock-cli status แก้ไฟล์เล็กน้อย และรอ heartbeat แรก หน้า timeline ควรเห็น event และหน้า Overview ควรใช้ duration model เดียวกัน หากไม่เห็น ให้ตรวจ API key, server URL และ local queue ก่อนเพิ่ม client ตัวอื่น

ผู้ทบทวน: ทีมผลิตภัณฑ์ AtoAxis อัปเดตล่าสุด: 20 กันยายน 2026