คู่มือผู้ใช้ SoftAgent

ยืนยันสภาพแวดล้อมตรงตามข้อกำหนดและเตรียมการติดตั้ง

1. ยืนยันว่า PC เป้าหมายใช้ Windows 10/11 x64
2. ยืนยันว่ามีสิทธิ์บัญชีผู้ดูแลระบบ (ตัวติดตั้งจะแสดงพรอมต์ UAC elevation)
3. ยืนยันว่าไฟร์วอลล์อนุญาตการรับส่งข้อมูล UDP ขาเข้าบนพอร์ต 6500 (พอร์ตฟังของ SoftAgent)
4. แพ็กเกจตัวติดตั้งเป็น self-contained — ไม่ต้องติดตั้ง .NET runtime บนเครื่องเป้าหมายก่อน

• สามารถรันโปรแกรมในฐานะผู้ดูแลระบบได้ (UAC elevation ผ่านแล้ว)
• UDP พอร์ต 6500 ไม่ถูกใช้งานโดยโปรแกรมอื่น

• PC ที่ถูกควบคุมหลายเครื่องสามารถใช้ตัวติดตั้งเดียวกัน — กำหนดค่าพอร์ตและที่อยู่การรายงานแยกกันในแต่ละเครื่อง
• สำหรับโครงการนิทรรศการ แนะนำให้ตั้ง PC ที่ถูกควบคุมทั้งหมดให้ล็อกอินอัตโนมัติด้วยบัญชีผู้ดูแลระบบ เพื่อให้ scheduled task เริ่มต้นได้อย่างน่าเชื่อถือ

เสร็จสิ้นการติดตั้งและยืนยันว่า SoftAgent ทำงานปกติใน system tray

1. ดับเบิลคลิก SoftAgent-Setup-version.exe และคลิก Yes ในพรอมต์ UAC เพื่ออนุญาตสิทธิ์ผู้ดูแลระบบ
2. ทำตามวิซาร์ดตัวติดตั้งเพื่อเสร็จสิ้นการติดตั้ง (ค่าเริ่มต้น: C:\Program Files\SoftAgent\)
3. ในหน้าเสร็จสิ้น เลือกติ๊ก 'Launch SoftAgent now' หรือเริ่มด้วยตนเองภายหลัง
4. หลังเริ่มต้น SoftAgent จะปรากฏใน system tray (ไม่มีหน้าต่างหลักเปิด)
5. คลิกขวาที่ไอคอน tray และเลือก 'Open Config' — ยืนยันว่าหน้าต่างหลักปรากฏพร้อม 4 แท็บ (Properties / Programs / Watchdog / Settings)

• ไอคอน SoftAgent ปรากฏใน system tray
• Task Manager แสดงกระบวนการ SoftAgent.App และ SoftAgent.Watchdog ทั้งสองกำลังทำงาน
• การคลิกขวาที่ tray แสดง: Open Config / Status / Pause Watchdog / Open Log Directory / About / Exit

SoftAgent ใช้สถาปัตยกรรมสองกระบวนการ: กระบวนการ App จัดการฟังก์ชัน และ Watchdog ตรวจสอบและรีสตาร์ท App อัตโนมัติหากเกิดข้อผิดพลาด — ดูแลกันและกัน

เสร็จสิ้นการกำหนดค่าพื้นฐานและยืนยันว่าเอเจนต์ทำงานผ่าน UDP ping

1. ดับเบิลคลิกไอคอน tray เพื่อเปิดหน้าต่างหลัก สลับไปที่แท็บ Settings
2. ยืนยันว่าพอร์ตฟังเป็น 6500 (หรือเปลี่ยนตามต้องการ) และติ๊ก 'Auto-start' เพื่อลงทะเบียน scheduled task
3. สำหรับการผสานรวม SoftControl ป้อน IP:port ของเครื่อง SoftControl ในช่อง 'Report Address'
4. คลิก 'Save and Apply' เพื่อบันทึกการกำหนดค่า
5. เปิด PowerShell และส่ง ping เพื่อตรวจสอบ:
6. $u = New-Object System.Net.Sockets.UdpClient
7. $b = [Text.Encoding]::UTF8.GetBytes('ping')
8. $u.Send($b, $b.Length, '127.0.0.1', 6500)
9. $r = $u.Receive([ref](New-Object System.Net.IPEndPoint([Net.IPAddress]::Any, 0)))
10. [Text.Encoding]::UTF8.GetString($r)
11. การรับ ok:pong ยืนยันว่าเอเจนต์ทำงานปกติ

• การส่ง ping ได้รับการตอบสนอง ok:pong
• ช่องทำเครื่องหมาย Auto-start ในแท็บ Settings ถูกบันทึกแล้ว
• การรัน schtasks /Query /TN SoftAgent แสดง scheduled task ที่ลงทะเบียนแล้ว

• เปลี่ยนพอร์ตแต่ลืมคลิก 'Save and Apply' ทำให้การเปลี่ยนแปลงไม่มีผล
• ป้อนพอร์ตคอนโซลจัดการ HTTP แทนพอร์ตฟัง UDP

เข้าใจรูปแบบคำสั่งและระดับความเสี่ยงเพื่อใช้ SoftAgent อย่างปลอดภัย

1. รูปแบบคำสั่ง: verb หรือ verb:arg (อาร์กิวเมนต์ตามหลังเครื่องหมายโคลอนแรก) เช่น volume:80 หรือ ping
2. การตอบสนองสำเร็จ: ok:<code> เช่น ok:pong หรือ ok:volume
3. การตอบสนองล้มเหลว: err:<code> เช่น err:wol.invalidMac
4. สามระดับความเสี่ยง: ปลอดภัย (ไม่รบกวน ทำซ้ำได้) / รบกวน (ขัดจังหวะ session/กระบวนการแต่ไม่สูญเสียข้อมูล) / ทำลาย (ปิดเครื่อง/รีสตาร์ท/logoff ฯลฯ)
5. คำสั่งทำลายจะแสดงกล่องยืนยันใน UI เมื่อทริกเกอร์จากระยะไกล ผู้เรียกมีหน้าที่ยืนยันความตั้งใจ

• การส่ง ping ได้รับ ok:pong ยืนยันว่าการเชื่อมต่อและรูปแบบคำสั่งถูกต้อง
• การส่ง describe ได้รับรายการความสามารถ JSON พร้อมคำสั่งที่รองรับทั้งหมดและระดับความเสี่ยง

คำสั่ง describe คืนรายการความสามารถทั้งหมดของ SoftAgent instance นี้ รวมถึงชื่อ คำอธิบาย ระดับความเสี่ยง และว่าต้องการการยืนยันของแต่ละคำสั่ง — มีประโยชน์สำหรับการค้นหาความสามารถเมื่อผสานรวมกับ SoftControl หรือระบบ AI

เข้าใจคำสั่งปลอดภัยสำหรับการควบคุมระดับเสียงและการตรวจสอบสถานะประจำวัน

1. ตรวจสอบการเชื่อมต่อ: ping (ตอบสนอง ok:pong ยืนยันว่าเอเจนต์ออนไลน์)
2. รับรายการความสามารถ: describe (คืน JSON แสดงคำสั่งทั้งหมดพร้อมคำอธิบายและระดับความเสี่ยง)
3. ค้นหาอุปกรณ์: discover (คืน JSON snapshot สัญญาณชีพพร้อม hostname, IP, MAC, ระดับเสียง, สถานะ guard)
4. เพิ่มระดับเสียงหนึ่งขั้น: volup (ค่าเริ่มต้น +5% ต่อครั้ง)
5. ลดระดับเสียงหนึ่งขั้น: voldown (ค่าเริ่มต้น -5% ต่อครั้ง)
6. สลับปิดเสียง: mute (สลับระหว่างปิดเสียงและเปิดเสียง)
7. รับที่อยู่ MAC ของ NIC หลัก: getmac (คืนรูปแบบขีดคั่นตัวพิมพ์ใหญ่ เช่น AA-BB-CC-DD-EE-FF)
8. ส่ง Wake-on-LAN magic packet: wol:AA-BB-CC-DD-EE-FF (ปลุกเครื่องที่มี MAC ที่ระบุ)
9. จำลองแป้นพิมพ์: key:^s (Ctrl+S), key:{F5} (ปุ่ม F5), key:Hello (พิมพ์ตัวอักษร)

• คำสั่ง ping คืน ok:pong
• volup/voldown เปลี่ยนระดับเสียงของเครื่องที่ถูกควบคุม
• คำสั่ง wol ปลุกเครื่องเป้าหมาย (ต้องเปิดใช้ WoL บนเป้าหมาย)

• ใช้ discover เพื่อรับสถานะปัจจุบันของเครื่องที่ถูกควบคุมอย่างรวดเร็ว (IP ระดับเสียง สถานะ guard) — มีประโยชน์สำหรับการตรวจสุขภาพแบบ batch ของ SoftControl
• key: ใช้ไวยากรณ์ Microsoft SendKeys: ^ คือ Ctrl, % คือ Alt, + คือ Shift, ปุ่มพิเศษในวงเล็บปีกกาเช่น {ENTER}

เข้าใจการล็อกหน้าจอ การเริ่ม/หยุดกระบวนการ และคำสั่งยกเลิกการปิดเครื่อง

1. ล็อกหน้าจอ: lock (ล็อก workstation ปัจจุบัน — ล็อกอินใหม่เพื่อกู้คืน)
2. ยกเลิกการปิดเครื่อง/รีสตาร์ทที่รอดำเนินการแบบหน่วงเวลา: cancelshutdown (ใช้ระหว่าง countdown การปิดเครื่อง)
3. เริ่ม watchdog item ตาม ID: run:id (เช่น run:db-player เริ่ม item ที่ชื่อ db-player)
4. หยุด watchdog item ตาม ID: stop:id (หยุดและหยุด watchdog — กระบวนการจะไม่รีสตาร์ทอัตโนมัติ)
5. เริ่มโปรแกรมที่จัดการตาม index: startpro:0 (เริ่มโปรแกรมที่ index 0 ในรายการโปรแกรมที่จัดการ)
6. หยุดโปรแกรมที่จัดการตาม index: killpro:0
7. หยุดโปรแกรมที่จัดการทั้งหมด: killall

• หลัง lock เครื่องที่ถูกควบคุมแสดงหน้าจอล็อก
• หลัง run:id watchdog item ที่สอดคล้องเริ่มต้น — สถานะเปลี่ยนจาก Stopped เป็น Running ในแท็บ Watchdog
• cancelshutdown ที่ส่งระหว่าง countdown การปิดเครื่องยกเลิกการปิดเครื่อง

• ใช้ run/stop กับ watchdog ID (ตัวระบุที่เสถียร) แทน startpro/killpro กับ index (index เปลี่ยนเมื่อลบหรือจัดเรียง item ใหม่)
• Watchdog ID กำหนดค่าในแท็บ Watchdog ของ SoftAgent อัปเดตคำสั่ง SoftControl หากเปลี่ยนชื่อ ID

ดำเนินการทำลายอย่างปลอดภัย เช่น ปิดเครื่อง รีสตาร์ท และ logoff

1. ปิดเครื่องแบบหน่วงเวลา (แนะนำ): shutdown:60 (ปิดเครื่องหลัง 60 วินาที cancelshutdown สามารถยกเลิกระหว่าง countdown)
2. ปิดเครื่องทันที (ใช้ด้วยความระมัดระวัง): shutdown (ไม่มีหน่วงเวลา ยกเลิกไม่ได้)
3. รีสตาร์ทแบบหน่วงเวลา (แนะนำ): reboot:60 (รีสตาร์ทหลัง 60 วินาที)
4. รีสตาร์ทเข้า BIOS/UEFI: reboot:firmware (ต้องการการรองรับ UEFI firmware)
5. Logoff ผู้ใช้ปัจจุบัน: logoff (ยืนยันว่าไม่มีข้อมูลที่ยังไม่ได้บันทึกก่อนดำเนินการ)
6. เปิด/ปิด UAC: uac:off / uac:on (เปลี่ยน registry ต้องรีสตาร์ทเพื่อให้มีผล ต้องการสิทธิ์ admin)
7. เปิด/ปิด edge gestures ของหน้าจอสัมผัส: edgeswipe:off / edgeswipe:on
8. เปิด/ปิด Windows startup auto-repair: autorepair:off / autorepair:on

• หลัง shutdown:60 ระบบแสดงการแจ้งเตือน countdown 'กำลังปิดเครื่องใน 60 วินาที'
• cancelshutdown ที่ส่งระหว่าง countdown ยกเลิกการปิดเครื่อง

• ส่ง shutdown โดยไม่มีหน่วงเวลา ทำให้ยกเลิกไม่ได้ — เครื่องที่ถูกควบคุมปิดทันที
• หลัง uac:off ไม่รีบูตและสมมติว่า UAC ถูกปิดใช้งานแล้ว (ต้องรีสตาร์ทเพื่อให้มีผล)

คำสั่งปิดเครื่องต้องการสิทธิ์ผู้ดูแลระบบ หากสิทธิ์ไม่เพียงพอ จะคืนรหัสข้อผิดพลาดที่ชัดเจนเช่น err:power.denied — ไม่ล้มเหลวแบบเงียบ

เสร็จสิ้นการกำหนดค่าพื้นฐานเพื่อให้ SoftAgent ค้นพบและถูกควบคุมโดย SoftControl ได้ถูกต้อง

1. เปิดหน้าต่างหลัก SoftAgent และสลับไปที่แท็บ Settings
2. พอร์ตฟัง (ค่าเริ่มต้น 6500): SoftControl และคอนโทรลเลอร์อื่นส่งคำสั่ง UDP ไปยังพอร์ตนี้
3. ที่อยู่การรายงาน (รูปแบบ IP:port): SoftAgent ส่ง JSON สัญญาณชีพเป็นระยะไปยังที่อยู่นี้ ป้อน IP และพอร์ตฟังของ SoftControl
4. ช่วงเวลาสัญญาณชีพ (วินาที): ค่าเริ่มต้น 10 วินาที สัญญาณชีพประกอบด้วย hostname, IP, MAC, ระดับเสียง, สถานะ guard ฯลฯ
5. หน่วงเวลาเริ่มต้นอัตโนมัติ (วินาที): หน่วงเวลาหลังล็อกอินก่อน SoftAgent เริ่ม (มีประโยชน์สำหรับรอความพร้อมของเครือข่าย)
6. คลิก 'Save and Apply' หลังการเปลี่ยนแปลง — การเปลี่ยนพอร์ตแสดงการแจ้งเตือน 'Restart Required' ถาวร การเปลี่ยนแปลงอื่นมีผลทันที

• การกำหนดค่ามีผลทันทีหลังบันทึก (การเปลี่ยนพอร์ตต้องรีสตาร์ท)
• หากกำหนดค่าที่อยู่การรายงาน SoftControl ควรเริ่มรับ JSON สัญญาณชีพเป็นระยะจาก SoftAgent นี้

• สำหรับ PC ที่ถูกควบคุมหลายเครื่อง แนะนำใช้พอร์ตเดียวกัน (6500) ทั้งหมดเพื่อลดความซับซ้อนในการป้อนคำสั่ง batch ใน SoftControl
• การปล่อยที่อยู่การรายงานว่างหมายความว่า SoftAgent จะไม่ส่งสัญญาณชีพเชิงรุกแต่จะยังตอบสนองต่อคำสั่ง UDP

แก้ไขการกำหนดค่า IP ของเครื่องที่ถูกควบคุมผ่านอินเทอร์เฟซ SoftAgent โดยไม่ต้องใช้ RDP

1. เปิดหน้าต่างหลัก สลับไปที่แท็บ Properties และเลือก NIC เป้าหมายในดรอปดาวน์ของแผงเครือข่าย
2. หลังเลือก NIC IP ปัจจุบัน subnet mask gateway DNS และที่อยู่ MAC จะถูกกรอกอัตโนมัติ
3. สลับโหมด 'Static IP / DHCP': ช่องแก้ไขได้ในโหมด Static; อ่านอย่างเดียวในโหมด DHCP
4. กรอก IP เป้าหมาย subnet mask gateway และ DNS (โหมด Static)
5. คลิก 'Change IP Settings' และยืนยันในกล่องยืนยัน
6. การเปลี่ยน IP เป็นการดำเนินการทำลาย — การเชื่อมต่อปัจจุบันจะขาดหลังเปลี่ยน เชื่อมต่อใหม่ด้วย IP ใหม่

• หลังเปลี่ยน เครื่องที่ถูกควบคุมสามารถ ping สำเร็จที่ IP ใหม่
• JSON สัญญาณชีพ SoftAgent แสดง IP ที่อัปเดตแล้ว

การเปลี่ยน IP เป็นการทำลาย ก่อนดำเนินการ ยืนยันว่า IP ใหม่เข้าถึงได้บน LAN เพื่อหลีกเลี่ยงการสูญเสียการเข้าถึงจากระยะไกลกับเครื่องที่ถูกควบคุม

กำหนดค่าเริ่มต้นอัตโนมัติเพื่อให้ SoftAgent กลับมาทำงานอัตโนมัติหลัง PC ที่ถูกควบคุมรีสตาร์ท

1. ในแท็บ Settings ของหน้าต่างหลัก ติ๊ก 'Auto-start'
2. คลิก 'Save and Apply'
3. ตรวจสอบด้วย: schtasks /Query /TN SoftAgent ใน PowerShell — ยืนยันว่า scheduled task ถูกลงทะเบียนแล้ว
4. ทริกเกอร์ task: ONLOGON (ทริกเกอร์หลัง user ล็อกอิน) ด้วยระดับสิทธิ์ HIGHEST
5. เพื่อตั้งหน่วงเวลาเริ่มต้น (รอเครือข่ายหรือบริการที่ขึ้นอยู่) ตั้งวินาทีในช่อง 'Auto-start Delay'
6. เพื่อปิด auto-start ยกเลิกการติ๊ก 'Auto-start' และบันทึก

• schtasks /Query /TN SoftAgent แสดง task ที่มีอยู่และเปิดใช้งาน
• หลังรีสตาร์ท PC ที่ถูกควบคุม SoftAgent ปรากฏอัตโนมัติใน system tray หลังล็อกอิน

เสร็จสิ้นการตั้งค่าคำสั่ง SoftAgent ใน SoftControl สำหรับการควบคุมเครื่องที่ถูกควบคุมด้วยปุ่ม

1. เข้า admin panel ของ SoftControl และเปิด Command Management
2. สร้างคำสั่งใหม่ เลือกโปรโตคอล UDP
3. ตั้งที่อยู่เป้าหมายเป็น IP ของ PC ที่ถูกควบคุม (เช่น 192.168.1.101)
4. ตั้งพอร์ตเป็นพอร์ตฟังของ SoftAgent (ค่าเริ่มต้น 6500)
5. ตั้งข้อความคำสั่งเป็นคำสั่งที่เฉพาะเจาะจง เช่น: volup (เพิ่มระดับเสียง), mute (สลับปิดเสียง), lock (ล็อกหน้าจอ), shutdown:60 (ปิดเครื่องใน 60 วินาที)
6. บันทึกและทดสอบคำสั่งแยกกัน — ยืนยันว่าเครื่องที่ถูกควบคุมตอบสนองถูกต้อง
7. ผูกคำสั่งที่ตรวจสอบแล้วกับปุ่มบนอินเทอร์เฟซหน้าบ้านของ SoftControl

• หลัง SoftControl ส่งคำสั่ง UDP SoftAgent ของเครื่องที่ถูกควบคุมดำเนินการกระทำ
• Log ของ SoftControl แสดงว่าส่งคำสั่งสำเร็จ (การตอบสนอง OK)

• สร้างชุดคำสั่งสำหรับแต่ละเครื่องที่ถูกควบคุม โดยใช้ชื่ออุปกรณ์เป็นคำนำหน้า (เช่น 'Hall-PC-01_Shutdown') เพื่อง่ายต่อการบำรุงรักษา
• สำหรับการดำเนินการ batch เช่น ปิดนิทรรศการ ใช้ command groups ของ SoftControl — เพิ่มคำสั่ง shutdown สำหรับหลายเครื่องในกลุ่มเดียวและทริกเกอร์ครั้งเดียว

กำหนดค่าการรายงานสัญญาณชีพเพื่อตรวจสอบสถานะออนไลน์ของเครื่องที่ถูกควบคุมจาก SoftControl

1. ในการตั้งค่า SoftAgent กำหนดที่อยู่การรายงานเป็น IP:port ของ SoftControl (อินเทอร์เฟซ UDP ภายนอกของ SoftControl ค่าเริ่มต้น 8818)
2. SoftAgent ส่งสัญญาณชีพหนึ่งครั้งทันทีเมื่อเริ่มต้น จากนั้นต่อเนื่องตามช่วงเวลาที่กำหนด (ค่าเริ่มต้น 10 วินาที)
3. JSON สัญญาณชีพประกอบด้วย: agentId (ตัวระบุอุปกรณ์เฉพาะ), hostname, ip/mac (ข้อมูลเครือข่าย), volume/muted (สถานะเสียง), guards (สถานะกระบวนการ watchdog), uptimeSeconds
4. เพื่อ query สถานะปัจจุบันของเครื่องที่ถูกควบคุมอย่างแข็งขัน ส่ง discover จาก SoftControl — SoftAgent คืน snapshot สัญญาณชีพ
5. ช่อง guards ในสัญญาณชีพบ่งชี้ว่ากระบวนการ watchdog ทำงานปกติหรือไม่ เผยให้เห็นการเกิดข้อผิดพลาดหรือสถานะ give-up

• SoftControl รับ JSON สัญญาณชีพเป็นระยะจาก SoftAgent
• การส่ง discover ได้รับการตอบสนอง JSON พร้อม hostname, IP, ระดับเสียง และข้อมูลอื่น

กำหนดค่า watchdog รีสตาร์ทเมื่อเกิดข้อผิดพลาดสำหรับแอปนิทรรศการ

1. เปิดหน้าต่างหลัก SoftAgent และสลับไปที่แท็บ Watchdog
2. คลิก 'Browse...' เพื่อเลือก .exe ที่จะดูแล เลือกตั้งชื่อและ watchdog ID (ตัวระบุที่เสถียรใช้สำหรับคำสั่ง run/stop)
3. คลิก 'Add' เพื่อใส่ในรายการ watchdog สวิตช์แยกควบคุมว่า watchdog ของ item นี้เปิดใช้งานหรือไม่
4. สวิตช์ watchdog หลักอยู่ด้านบนของแท็บ — การปิดใช้งานหยุด watchdog ทั้งหมด (ซิงค์กับเมนู tray 'Pause Watchdog')
5. สัญลักษณ์สถานะแสดงสถานะของแต่ละ item: Running / Stopped / Crashed / GaveUp (watchdog ยกเลิกหลังเกิดข้อผิดพลาดมากเกินไปในช่วงเวลา)
6. หลังเกิดข้อผิดพลาด SoftAgent รีสตาร์ทด้วย exponential backoff (เริ่มต้น 5 วินาที เพิ่มเป็นสองเท่าแต่ละครั้ง ยกเลิกหลังเกินขีดจำกัดในช่วงเวลา)

• โปรแกรมที่ดูแลแสดงสถานะ 'Running' ในรายการ watchdog
• การปิดกระบวนการที่ดูแลด้วยตนเองและ SoftAgent รีสตาร์ทอัตโนมัติหลังหน่วงเวลา
• ช่อง guards ของ JSON สัญญาณชีพแสดงสถานะ watchdog ล่าสุด

อย่าเปลี่ยน watchdog ID โดยพลการ — คำสั่ง run/stop ของ SoftControl ขึ้นอยู่กับมัน หากเปลี่ยนชื่อ ID ให้อัปเดตคำสั่ง SoftControl ที่สอดคล้องด้วย

กู้คืนช่องทางควบคุมคำสั่ง UDP

1. ยืนยันว่า SoftAgent มองเห็นได้ใน system tray (กระบวนการกำลังทำงาน)
2. ยืนยันว่าพอร์ตที่ส่งตรงกับพอร์ตฟังที่กำหนดค่าของ SoftAgent (ค่าเริ่มต้น 6500)
3. ตรวจสอบว่า Windows Firewall อนุญาตการรับส่งข้อมูล UDP ขาเข้าบนพอร์ต 6500
4. ลอง ping จาก localhost (127.0.0.1) ก่อนเพื่อแยกปัญหาเครือข่าย จากนั้นลองจากระยะไกล
5. ตรวจสอบไฟล์ log ใน %ProgramData%\SoftAgent\logs\ สำหรับบันทึกการรับคำสั่ง

• การส่ง ping ไปยัง 127.0.0.1 ได้รับ ok:pong ยืนยันว่า SoftAgent และพอร์ต UDP ทำงาน
• การส่ง ping จากเครื่องระยะไกลยังได้รับการตอบสนอง ยืนยันว่าเส้นทางเครือข่ายปลอดโปร่ง

ทำให้แน่ใจว่า SoftAgent ทำงานด้วยสิทธิ์ผู้ดูแลระบบเพื่อรองรับคำสั่งระดับระบบทั้งหมด

1. ยืนยันว่า SoftAgent ทำงานด้วยสิทธิ์ admin: auto-start ใช้ scheduled task HIGHEST privilege; สำหรับการเริ่มด้วยตนเอง คลิกขวาที่ exe และ 'Run as administrator'
2. หากคำสั่งถูกทริกเกอร์ผ่าน SoftControl ตัว SoftControl เองไม่ต้องการสิทธิ์ admin — สิทธิ์ถูกกำหนดโดย SoftAgent ฝั่งที่ถูกควบคุม
3. ตรวจสอบคอลัมน์ 'Elevated' สำหรับ SoftAgent.App.exe ในแท็บ Details ของ Task Manager — ควรแสดง 'Yes'
4. หากไม่ได้ทำงานในฐานะ admin ให้ออกจาก SoftAgent และรีสตาร์ทในฐานะผู้ดูแลระบบ

• แท็บ Details ของ Task Manager แสดง 'Yes' ในคอลัมน์ Elevated สำหรับ SoftAgent.App.exe
• คำสั่ง volup/voldown ตอบสนองปกติ (ไม่ต้องการสิทธิ์ admin — มีประโยชน์สำหรับการตรวจสอบพื้นฐาน)
• คำสั่ง lock ล็อกหน้าจอเครื่องที่ถูกควบคุม (ระดับ Disruptive — ยืนยันว่าสิทธิ์ถูกต้อง)

วินิจฉัยและแก้ไขความล้มเหลวของ auto-start

1. รัน schtasks /Query /TN SoftAgent ใน PowerShell เพื่อยืนยันว่า scheduled task มีอยู่
2. หาก task ไม่มีอยู่ เปิดแท็บ Settings ของ SoftAgent ติ๊ก 'Auto-start' ใหม่ และบันทึก
3. ยืนยันว่า PC ใช้ auto-login (ปกติในนิทรรศการ) แทนการรอการล็อกอินด้วยตนเอง — ทริกเกอร์ task คือ ONLOGON ต้องการให้ user ล็อกอิน
4. หากตั้งค่า auto-login ยืนยันว่าบัญชี auto-login มีสิทธิ์รัน task (ต้องการบัญชีผู้ดูแลระบบ)
5. ตรวจสอบ log ล่าสุดใน %ProgramData%\SoftAgent\logs\ สำหรับเหตุผลที่เริ่มต้นล้มเหลว

• เอาต์พุต schtasks /Query /TN SoftAgent ประกอบด้วยทริกเกอร์ ONLOGON และสิทธิ์ HIGHEST
• หลังรีสตาร์ท PC ที่ถูกควบคุมและล็อกอิน SoftAgent ปรากฏอัตโนมัติใน system tray

เข้าใจว่าทำไม watchdog ถึงยกเลิกและกู้คืนการตรวจสอบแอปเป้าหมาย

1. ในแท็บ Watchdog ของหน้าต่างหลัก SoftAgent ตรวจสอบสัญลักษณ์สถานะ — ยืนยันสถานะ 'GaveUp'
2. ตรวจสอบไฟล์ log ใน %ProgramData%\SoftAgent\logs\ สำหรับเหตุผลเฉพาะของการเกิดข้อผิดพลาด (ข้อผิดพลาดก่อนการเกิดข้อผิดพลาดแต่ละครั้ง)
3. แก้ไขสาเหตุที่แท้จริงของการเกิดข้อผิดพลาดของแอปที่ดูแล (ข้อผิดพลาดในการกำหนดค่า dependency ที่ขาดหาย port conflict ฯลฯ)
4. หลังแก้ไข สลับสวิตช์แยกของ watchdog item ปิดแล้วเปิดในแท็บ Watchdog (หรือส่ง run:id จาก SoftControl) เพื่อเรียก watchdog ใหม่
5. ยืนยันว่าสถานะ watchdog item เปลี่ยนเป็น 'Running' และคงที่ตามเวลา

• หลังแก้ไขแอปที่ดูแล สถานะ watchdog เปลี่ยนจาก 'GaveUp' เป็น 'Running'
• JSON สัญญาณชีพแสดงสถานะ watchdog item ที่สอดคล้องอัปเดตเป็น running

GaveUp เป็นพฤติกรรมที่ตั้งใจเพื่อป้องกันการรีสตาร์ทวนซ้ำอนันต์จากส่งผลกระทบต่อทรัพยากรระบบ วิธีแก้จริงคือแก้ไขสาเหตุที่แท้จริงของการเกิดข้อผิดพลาด — ไม่ใช่การเรียก watchdog ใหม่ซ้ำๆ ด้วยตนเอง