FAQ / Troubleshooting
ปัญหาที่พบบ่อยและวิธีแก้แบบเร็ว — แต่ละข้อบอกอาการแล้วตามด้วยวิธีจัดการ
ติดตั้ง & เปิดโปรแกรม
เปิดโปรแกรมแล้วขึ้นว่า port 3737 ถูกใช้อยู่
โปรแกรมจะเลื่อนไปใช้ port ถัดไปให้เอง (เช่น 3738 หรือ 3739) โดยอัตโนมัติ ให้ดูที่หน้าต่าง terminal ว่าโปรแกรมแจ้ง URL เป็น port ไหน แล้วเปิดเบราว์เซอร์ไปที่ URL นั้น
รัน npm install แล้ว error
ตรวจว่าเครื่องมี Node.js เวอร์ชัน 18 ขึ้นไป ติดตั้งอยู่ แล้วลองรันใหม่อีกครั้ง ถ้าอยู่หลังเครือข่ายบริษัท (proxy) อาจต้องตั้งค่า proxy ให้ npm ก่อน ดูขั้นตอนติดตั้งที่ ติดตั้ง & เปิดโปรแกรม
เปิดโปรแกรมแล้วเบราว์เซอร์ไม่เด้งขึ้นเอง
เปิดเบราว์เซอร์เองแล้วพิมพ์ http://localhost:3737 (หรือ port ที่โปรแกรมแจ้งไว้ในหน้าต่าง terminal)
ตัวโปรแกรมยังทำงานอยู่ แค่หน้าเว็บไม่ได้ถูกเปิดให้อัตโนมัติเท่านั้น
เชื่อมต่อ Jira & token
ขึ้นข้อความว่า token ใช้ไม่ได้ / เจอ 401
แปลว่า API token ผิด หมดอายุ หรือถูกยกเลิก ให้ไปที่หน้า Settings สร้าง token ใหม่ (แบบ scoped) แล้วบันทึกอีกครั้ง ดูรายละเอียดที่ token ใช้ไม่ได้ (401)
ลบหรือแก้ worklog ใน Timesheet ไม่ได้ / ขึ้นว่าขาด scope
token ของคุณยังไม่มี scope delete:issue-worklog:jira ให้ไป
สร้าง token ใหม่ โดย ติ๊ก scope นี้ด้วย แล้วบันทึก
ดูการใช้งานที่ Timesheet Manager
401 คือตัว token ใช้ไม่ได้ทั้งใบ ส่วน ขาด scope คือ token ใช้ได้แต่ไม่ได้รับสิทธิ์ บางอย่าง (เช่นสิทธิ์ลบ worklog) — แก้ทั้งคู่ด้วยการสร้าง token ใหม่ให้ครบ scope
เลือก board แล้ว issue ไม่ขึ้น / Task ในบอร์ดไม่ครบ
กดปุ่ม refresh issues ในหน้า Settings เพื่อดึงรายการใหม่ และตรวจว่าเลือก board ถูกตัว จากนั้นลองค้นหา issue ด้วย key หรือชื่อใน dropdown ดูขั้นตอนที่ เชื่อมต่อ Jira (token + board)
นำเข้าไฟล์ประชุม (Meeting Logwork)
นำเข้าไฟล์แล้วไม่ถูกจัดกลุ่มตามโปรเจกต์
ระบบจัดกลุ่มจากแท็ก [โปรเจกต์] ในคอลัมน์ Description — ตรวจว่าชื่อประชุมขึ้นต้นด้วย
วงเล็บเหลี่ยม เช่น [Payment] Daily Standup แถวที่ไม่มีวงเล็บจะถูกจัดเป็นกลุ่มแยก
ดูที่ Meeting Logwork
นำเข้าไฟล์ไม่สำเร็จ / รูปแบบไฟล์ผิด
ไฟล์ต้องเป็นนามสกุล .xlsx และมีคอลัมน์ครบ 3 คอลัมน์: Description,
Date, Duration (min) (จะมีคอลัมน์ Status เพิ่มก็ได้)
ถ้าหัวคอลัมน์ไม่ตรง ระบบจะอ่านไม่ออก
ประชุมบางรายการหายไปหลังนำเข้า
อาจถูกตัวกรองประชุมที่ยกเลิกข้ามให้อัตโนมัติ (เจอคำว่ายกเลิกในชื่อ หรือคอลัมน์ Status เป็น Cancelled) รายการเหล่านี้ไม่หายจริง — จะถูกหรี่ไว้พร้อมป้าย "ถูกข้าม" และกด "นับ row นี้ด้วย" เพื่อนำกลับมาได้ ดูที่ ข้ามประชุมที่ถูกยกเลิก
การบันทึกเวลา
ทำไมวันเสาร์-อาทิตย์ไม่ถูกบันทึก
เป็นพฤติกรรมปกติ — ทุกโหมดจะ ข้ามวันเสาร์-อาทิตย์อัตโนมัติ รายการที่ตรงวันหยุดสุดสัปดาห์ จะไม่ถูกยิงเข้า Jira