humanizer-th 0.0.0-stage → 0.5.0

package/skills/localize-th/references/translation.md

@@ -0,0 +1,255 @@
+# หลักการแปลและรูปแบบภาษาแปล
+
+ไฟล์นี้ใช้ทุกครั้งที่แปลอังกฤษเป็นไทย ส่วนแรกคือหลักการ ส่วนที่สองคือรูปแบบภาษาแปล LT01–LT12 ที่ทำให้คนอ่านรู้ว่าเป็นงานแปล
+
+รูปแบบภาษาแบบ AI ทั่วไป (TH01–TH29) อยู่ใน `patterns.md` ใช้คู่กัน ถ้าซ้ำกัน ให้อ้างรหัสที่ตรงกว่า เช่น "ถูก" แบบแปลจาก passive ใช้ TH04
+
+## หลักการ
+
+1. **อ่านทั้งฉากหรือทั้งหน้าจอก่อน** บรรทัดเดียวมักแปลได้หลายแบบ บริบทเป็นตัวตัดสิน
+2. **แปลเจตนา ไม่ใช่แปลคำ** ถามตัวเองว่าคนไทยในสถานการณ์นี้จะพูดว่าอะไร แล้วเขียนแบบนั้น
+3. **ความหมายต้องครบ** ย่อคำได้ เรียงประโยคใหม่ได้ แต่ข้อมูล อารมณ์ และเจตนาต้องอยู่ครบ
+4. **รักษาน้ำเสียง** ตัวละครที่หยาบต้องยังหยาบ ข้อความ UI ที่เป็นกันเองต้องยังเป็นกันเอง ไม่ทำให้สุภาพขึ้นหรือห้วนลง
+5. **อ่านทวนโดยไม่ดูต้นฉบับ** ถ้าสะดุดตรงไหน ตรงนั้นยังเป็นภาษาแปล
+
+### ความแรงของคำหยาบ
+
+แปลให้แรงเท่าต้นฉบับ ถ้าผู้ใช้กำหนดเรตไว้ ให้ใช้ตามเรต
+
+| ระดับ | ตัวอย่างอังกฤษ | ตัวอย่างไทย |
+|---|---|---|
+| เบา | damn, oh crap, shoot | บ้าเอ๊ย / โธ่เว้ย / ให้ตายสิ / แย่แล้ว |
+| กลาง | hell, bastard, shit | เวร / ชิบหาย / ไอ้บ้า / ไอ้สารเลว |
+| แรง | คำหยาบที่สุดในภาษาอังกฤษ | ใช้คำหยาบไทยที่แรงเท่ากัน เฉพาะเรื่องที่เรตผู้ใหญ่ |
+
+ไม่ต้องแปลคำหยาบทุกคำ ภาษาอังกฤษใช้คำหยาบเป็นคำเสริมบ่อยกว่าภาษาไทย ถ้าใส่ทุกคำจะฟังแรงเกินต้นฉบับ ให้เลือกใส่ตรงที่เน้นอารมณ์
+
+## ดัชนี
+
+| รหัส | รูปแบบ |
+|---|---|
+| LT01 | สรรพนามครบทุกประโยค |
+| LT02 | แปลตามพจนานุกรม ผิดบริบท |
+| LT03 | "มัน" "สิ่งนี้" แทน it, this, that |
+| LT04 | สำนวนอังกฤษแปลตรงตัว |
+| LT05 | คำอุทานแปลตรง |
+| LT06 | มารยาทแบบฝรั่ง |
+| LT07 | คำเรียกแสดงความรักและคำเรียกเพื่อน |
+| LT08 | คำถามท้ายประโยค |
+| LT09 | เวลา วันที่ และหน่วยในบทพูด |
+| LT10 | ความสุภาพไม่ตรงระดับ |
+| LT11 | ทับศัพท์หรือปล่อยอังกฤษไม่เหมาะ |
+| LT12 | แปลครบทุกคำจนยาว |
+
+## รูปแบบภาษาแปล
+
+### LT01 สรรพนามครบทุกประโยค
+
+**ทำไมดูเป็นงานแปล:** ประโยคอังกฤษต้องมีประธาน ภาษาไทยไม่ต้อง พอแปล I, you, he, she ทุกตัว บทพูดจะแข็งและซ้ำ
+
+**ต้นฉบับ:**
+> I don't know. I told you I was busy.
+
+**แปลแข็ง:**
+> ฉันไม่รู้ ฉันบอกคุณแล้วว่าฉันยุ่ง
+
+**แปลดี:**
+> ไม่รู้สิ บอกแล้วไงว่ายุ่ง
+
+**ไม่ต้องแก้เมื่อ:**
+- ต้องการเน้นว่าเป็นคนนี้ เช่น "ฉันนี่แหละที่ทำ"
+- ตัดแล้วไม่รู้ว่าใครทำอะไรกับใคร โดยเฉพาะฉากที่มีหลายคน
+
+### LT02 แปลตามพจนานุกรม ผิดบริบท
+
+**ทำไมดูเป็นงานแปล:** คำอังกฤษหลายคำมีหลายความหมาย ถ้าเลือกความหมายแรกในพจนานุกรม จะได้ประโยคที่ถูกทุกคำแต่ผิดเรื่อง
+
+| คำ | ความหมายที่มักเลือกผิด | ความหมายตามบริบท |
+|---|---|---|
+| save | ช่วยชีวิต | บันทึก (UI) / เก็บเงิน / ประหยัด |
+| charge | ชาร์จ | คิดเงิน / ตั้งข้อหา / พุ่งเข้าใส่ |
+| fire | ไฟ | ไล่ออก / ยิง |
+| run | วิ่ง | เปิดใช้ (โปรแกรม) / บริหาร / ลงสมัคร |
+| deal | ข้อตกลง | ตกลง / รับมือ (deal with) / ของถูก |
+| play | เล่น | เปิด (เพลง วิดีโอ) / แสดง |
+| miss | พลาด | คิดถึง |
+| figure | ตัวเลข | คิดออก (figure out) / หุ่น |
+
+**ต้นฉบับ:**
+> We need to save before the boss fight.
+
+**แปลแข็ง:**
+> เราต้องช่วยชีวิตก่อนการต่อสู้กับบอส
+
+**แปลดี:**
+> เซฟเกมก่อนตีบอสนะ
+
+**ไม่ต้องแก้เมื่อ:**
+- ความหมายแรกตรงกับบริบทอยู่แล้ว
+
+### LT03 "มัน" "สิ่งนี้" แทน it, this, that
+
+**ทำไมดูเป็นงานแปล:** it, this, that ในภาษาอังกฤษมักไม่ต้องแปล หรือควรแปลเป็นสิ่งที่พูดถึงจริงๆ ดูเพิ่มที่ TH08
+
+**ต้นฉบับ:**
+> This is amazing. It's exactly what I wanted.
+
+**แปลแข็ง:**
+> สิ่งนี้มันยอดเยี่ยมมาก มันคือสิ่งที่ฉันต้องการเลย
+
+**แปลดี:**
+> สุดยอดเลย อยากได้แบบนี้แหละ
+
+**ไม่ต้องแก้เมื่อ:**
+- "มัน" หมายถึงสัตว์หรือสิ่งของที่พูดถึงอยู่ และคนไทยก็พูดแบบนั้น เช่น "แมวมันหิว"
+- บทพูดแบบกันเองที่ใช้ "มัน" เป็นคำเสริม เช่น "มันก็ต้องลองดูแหละ"
+
+### LT04 สำนวนอังกฤษแปลตรงตัว
+
+**ทำไมดูเป็นงานแปล:** สำนวนแปลตรงตัวแล้วคนไทยไม่เข้าใจ หรือเข้าใจผิด
+
+| ต้นฉบับ | แปลตรงตัว | ที่คนไทยพูด |
+|---|---|---|
+| break a leg | ขอให้ขาหัก | ขอให้โชคดี / สู้ๆ |
+| piece of cake | ชิ้นเค้ก | ง่ายจะตาย / หมูๆ |
+| I'm dying | ฉันกำลังจะตาย | ขำจะตายอยู่แล้ว / ไม่ไหวแล้ว (ตามบริบท) |
+| it's not rocket science | ไม่ใช่วิทยาศาสตร์จรวด | ไม่ได้ยากขนาดนั้น |
+| my bad | ความเลวของฉัน | โทษที / ผิดเอง |
+| cut it out | ตัดมันออก | พอได้แล้ว / เลิกเถอะ |
+
+**ไม่ต้องแก้เมื่อ:**
+- เรื่องตั้งใจเล่นกับความหมายตรงตัวของสำนวน ให้แปลเพื่อรักษามุก แล้วบอกในบันทึก
+
+### LT05 คำอุทานแปลตรง
+
+**ทำไมดูเป็นงานแปล:** "โอ้พระเจ้า" "ว้าว" "เอาล่ะ" ในทุกฉาก เป็นภาษาซับแปลที่คนไทยจำได้ทันที
+
+| ต้นฉบับ | แปลแข็ง | ทางเลือก |
+|---|---|---|
+| Oh my God | โอ้พระเจ้า | ตายแล้ว / พระเจ้าช่วย / อะไรเนี่ย |
+| Wow | ว้าว | โห / เฮ้ย / สุดยอด |
+| Well, ... | เอาล่ะ ... / ก็ ... | ละไว้ / คือว่า / ก็นะ |
+| Oh no | โอ้ไม่ | แย่แล้ว / ไม่นะ / ซวยแล้ว |
+| Come on | มาเถอะ | เร็วเข้า / เอาน่า / ไม่เอาน่า (ตามบริบท) |
+| Hey | เฮ้ | นี่ / เฮ้ย / ชื่อคนที่เรียก |
+
+**ไม่ต้องแก้เมื่อ:**
+- ตัวละครเป็นคนเคร่งศาสนาและพูดถึงพระเจ้าจริงๆ
+- "เฮ้" "ว้าว" เข้ากับตัวละครวัยรุ่นที่พูดแบบนั้นอยู่แล้ว ใช้ได้บ้าง แต่อย่าใช้ทุกครั้ง
+
+### LT06 มารยาทแบบฝรั่ง
+
+**ทำไมดูเป็นงานแปล:** ฝรั่งพูด thank you, sorry, how are you บ่อยกว่าคนไทย แปลครบทุกครั้งแล้วบทพูดจะฟังห่างเหิน
+
+**ต้นฉบับ:**
+> - Hey, how are you?
+> - Good, thanks. You?
+
+**แปลแข็ง:**
+> - สวัสดี คุณสบายดีไหม
+> - สบายดี ขอบคุณ แล้วคุณล่ะ
+
+**แปลดี (เพื่อนเจอกัน):**
+> - อ้าว เป็นไงบ้าง
+> - ก็ดี แล้วแกล่ะ
+
+**ไม่ต้องแก้เมื่อ:**
+- เป็นการทักทายทางการ เช่น งานเลี้ยงธุรกิจ คนเพิ่งรู้จักกัน
+- ข้อความ UI ที่ต้องขอบคุณผู้ใช้จริงๆ เช่น หลังชำระเงิน
+
+### LT07 คำเรียกแสดงความรักและคำเรียกเพื่อน
+
+**ทำไมดูเป็นงานแปล:** honey, sweetie, babe, dude, bro, man แปลเป็น "ที่รัก" "เพื่อน" ทุกครั้ง ฟังเหมือนซับหนังฝรั่งยุคเก่า
+
+**ทางเลือก:**
+- คู่รัก: ชื่อเล่น / ตัวเอง / เค้า / ละไว้ ใช้ "ที่รัก" เฉพาะตอนที่ตัวละครหวานจริงๆ
+- แม่เรียกลูก (honey, sweetie): ลูก / ชื่อเล่น
+- เพื่อนผู้ชาย (dude, bro, man): ละไว้ / ชื่อเล่น / เพื่อน (นานๆ ครั้ง) / มึง (ถ้าเรตและความสัมพันธ์ได้)
+- คนแปลกหน้า (sir, ma'am): คุณ / พี่ / ลุง / ป้า / ละไว้ ดู `characters.md`
+
+**ไม่ต้องแก้เมื่อ:**
+- ตัวละครตั้งใจพูดแบบฝรั่ง เช่น ตัวละครที่เพิ่งกลับจากเมืองนอกในเรื่องไทย
+
+### LT08 คำถามท้ายประโยค
+
+**ทำไมดูเป็นงานแปล:** right? isn't it? don't you? แปลเป็น "ใช่ไหม" ทุกครั้ง
+
+**ต้นฉบับ:**
+> You're coming tomorrow, right?
+
+**แปลแข็ง:**
+> คุณจะมาพรุ่งนี้ ใช่ไหม
+
+**แปลดี:**
+> พรุ่งนี้มาใช่มั้ย / พรุ่งนี้มานะ
+
+**ทางเลือก:** ใช่มั้ย / ไม่ใช่เหรอ / ใช่ป่ะ / นะ / เนอะ / ล่ะสิ เลือกตามระดับภาษาและอารมณ์
+
+**ไม่ต้องแก้เมื่อ:**
+- ตัวละครกำลังถามยืนยันจริงจัง เช่น ฉากสอบสวน
+
+### LT09 เวลา วันที่ และหน่วยในบทพูด
+
+**ทำไมดูเป็นงานแปล:** "บ่ายสามโมง" คนไทยพูด "15.00 น." คนไทยเขียน "3 p.m." ไม่มีใครพูด ในบทพูดให้ใช้แบบที่คนไทยพูด
+
+| ต้นฉบับ | แปลแข็ง | ในบทพูด |
+|---|---|---|
+| 3 a.m. | 3 นาฬิกา | ตีสาม |
+| 8 p.m. | 8 โมงเย็น | สองทุ่ม |
+| 7:30 a.m. | 7:30 น. | เจ็ดโมงครึ่ง |
+| twenty bucks | ยี่สิบเหรียญ | ยี่สิบดอลลาร์ (หรือคงตามที่ผู้ใช้กำหนด) |
+
+**กฎ:**
+- ห้ามเปลี่ยนค่าของตัวเลข แปลงได้แค่วิธีเขียนหรือวิธีพูด
+- หน่วยวัด (ไมล์ ฟุต ปอนด์) คงตามต้นฉบับเป็นค่าเริ่มต้น แปลงเป็นหน่วยเมตริกเมื่อผู้ใช้ขอ หรือเมื่อตัวเลขไม่สำคัญต่อเรื่องและคนดูไม่เข้าใจหน่วยเดิม
+- ในไฟล์ UI ห้ามแปลงรูปแบบวันที่หรือเวลาเอง ถ้ามาจากตัวแปร ดู `ui.md`
+
+**ไม่ต้องแก้เมื่อ:**
+- ตัวละครอ่านเวลาจากเอกสารหรือหน้าจอ หรือเป็นทหารที่พูดเวลาแบบ 24 ชั่วโมง
+
+### LT10 ความสุภาพไม่ตรงระดับ
+
+**ทำไมดูเป็นงานแปล:** please แปลเป็น "กรุณา" ทุกครั้ง could you แปลเป็น "คุณช่วย...ได้ไหม" ภาษาไทยบอกความสุภาพด้วยคำลงท้ายและคำอย่าง "หน่อย" "ช่วย" "รบกวน"
+
+**ต้นฉบับ:**
+> Could you please pass me the salt?
+
+**แปลแข็ง:**
+> คุณกรุณาช่วยส่งเกลือให้ฉันได้ไหม
+
+**แปลดี:**
+> ส่งเกลือให้หน่อยสิ / ขอเกลือหน่อยครับ
+
+**ไม่ต้องแก้เมื่อ:**
+- ป้ายประกาศหรือข้อความทางการ ที่คนไทยก็ใช้ "กรุณา" เช่น "กรุณาปิดเสียงโทรศัพท์"
+
+### LT11 ทับศัพท์หรือปล่อยอังกฤษไม่เหมาะ
+
+**ทำไมดูเป็นงานแปล:** บางงานทับศัพท์ทุกคำจนคนทั่วไปไม่เข้าใจ บางงานแปลคำที่คนไทยใช้ทับศัพท์กันหมดแล้ว จนฟังแปลก ดูเพิ่มที่ TH19
+
+**หลักเลือก:**
+1. อภิธานศัพท์ของผู้ใช้มาก่อน
+2. คำที่คนไทยกลุ่มเป้าหมายใช้ทับศัพท์จนเป็นปกติ ให้ทับศัพท์ เช่น แอป ไลก์ แชร์ เลเวล สกิล
+3. คำที่มีคำไทยใช้กันทั่วไป ให้ใช้คำไทย เช่น settings = การตั้งค่า, password = รหัสผ่าน
+4. ทับศัพท์ให้สะกดตามหลักราชบัณฑิตยสถาน ดู `glossary.md`
+5. ชื่อแบรนด์ ชื่อแอป ชื่อรุ่น คงเป็นอังกฤษ เว้นแต่แบรนด์นั้นมีชื่อไทยที่ใช้เป็นทางการ
+
+**ไม่ต้องแก้เมื่อ:**
+- งานสำหรับกลุ่มเฉพาะที่ใช้ศัพท์อังกฤษกันอยู่แล้ว เช่น เครื่องมือของนักพัฒนา
+
+### LT12 แปลครบทุกคำจนยาว
+
+**ทำไมดูเป็นงานแปล:** really, actually, just, literally, a, the, s ของพหูพจน์ ถูกแปลทุกตัว ได้ประโยคยาวที่มี "จริงๆ" "จริงๆ แล้ว" "แค่" "หนึ่ง" "หลายๆ" เต็มไปหมด
+
+**ต้นฉบับ:**
+> I just really need a coffee right now.
+
+**แปลแข็ง:**
+> ฉันแค่ต้องการกาแฟหนึ่งแก้วจริงๆ ในตอนนี้
+
+**แปลดี:**
+> ขอกาแฟสักแก้วเถอะ
+
+**ไม่ต้องแก้เมื่อ:**
+- คำนั้นสำคัญต่อความหมาย เช่น "I just got here" = "เพิ่งมาถึง" ต้องมี "เพิ่ง"
+- จำนวนสำคัญ เช่น "one more chance" = "อีกครั้งเดียว"

package/skills/localize-th/references/ui.md

@@ -0,0 +1,117 @@
+# ข้อความในแอปและเว็บไซต์
+
+ข้อความ UI ถูกอ่านแบบกวาดตา ผู้ใช้ไม่ได้อ่านทีละคำ ข้อความที่ดีจึงสั้น บอกชัดว่ากดแล้วเกิดอะไร และเป็นคำที่คนไทยเห็นในแอปอื่นจนคุ้นแล้ว
+
+## 1. หลักการ
+
+1. **สั้นและตรง** ปุ่มใช้คำกริยา 1–3 คำ หัวข้อใช้คำนาม ข้อความอธิบายไม่เกิน 1–2 ประโยค
+2. **ไม่ใส่ครับ ค่ะ** ข้อความ UI เป็นเสียงของระบบ ไม่มีเพศ เว้นแต่แบรนด์ตั้งบุคลิกไว้ เช่น แอปที่มีตัวการ์ตูนพูดกับผู้ใช้
+3. **ไม่ใช้ "คุณ" ทุกข้อความ** ภาษาอังกฤษใส่ you และ your เกือบทุกประโยค ภาษาไทยละได้ (TH14) เช่น "Your password" เป็น "รหัสผ่าน"
+4. **ไม่ใช้ "!" และอีโมจิ** เว้นแต่ต้นฉบับใช้และแบรนด์ต้องการจริงๆ (TH29)
+5. **คำเดียวกันแปลเหมือนกันทั้งแอป** ถ้า "Delete" เป็น "ลบ" ที่หน้าหนึ่ง ต้องเป็น "ลบ" ทุกหน้า
+6. **ระดับภาษา** แอปทั่วไปใช้ `ไม่เป็นทางการ` ถึง `กึ่งทางการ` แอปธนาคาร ประกัน หน่วยงานรัฐ ใช้ `กึ่งทางการ` เกมใช้ `ไม่เป็นทางการ`
+
+## 2. ปุ่ม
+
+- บอกสิ่งที่จะเกิด ไม่ใช่แค่ "ตกลง" เช่น ในหน้าต่างยืนยันการลบ ให้ใช้ "ลบ" ดีกว่า "ตกลง"
+- ใช้คำกริยาที่คนไทยคุ้น ดูตารางใน `glossary.md`
+- ถ้ามีข้อจำกัดความยาว (จากคอมเมนต์ในไฟล์ หรือผู้ใช้บอก) ต้องไม่เกิน ถ้าเกินไม่ได้จริงๆ ให้เสนอคำสั้นกว่า 2 ตัวเลือกในบันทึก
+
+| ต้นฉบับ | แปลแข็ง | ควรใช้ |
+|---|---|---|
+| Proceed to checkout | ดำเนินการต่อไปยังการชำระเงิน | ชำระเงิน |
+| Click here to learn more | คลิกที่นี่เพื่อเรียนรู้เพิ่มเติม | ดูเพิ่มเติม |
+| Get started | เริ่มต้นใช้งาน | เริ่มใช้งาน / เริ่มเลย |
+| Submit | ส่งข้อมูล | ส่ง |
+
+## 3. ข้อความแจ้งข้อผิดพลาด
+
+บอกว่าเกิดอะไรขึ้น แล้วบอกว่าผู้ใช้ทำอะไรต่อได้ ไม่โทษผู้ใช้ และไม่ใช้ภาษาเทคนิคเกินจำเป็น
+
+| ต้นฉบับ | แปลแข็ง | ควรใช้ |
+|---|---|---|
+| Failed to load data. Please try again. | การโหลดข้อมูลล้มเหลว กรุณาลองใหม่อีกครั้ง | โหลดข้อมูลไม่ได้ ลองอีกครั้ง |
+| Unable to connect to the server. | ไม่สามารถเชื่อมต่อกับเซิร์ฟเวอร์ได้ | เชื่อมต่อไม่ได้ ตรวจอินเทอร์เน็ตแล้วลองอีกครั้ง |
+| Invalid email address. | ที่อยู่อีเมลไม่ถูกต้อง | อีเมลไม่ถูกต้อง |
+| Something went wrong. | มีบางอย่างผิดพลาด | เกิดข้อผิดพลาด ลองอีกครั้ง |
+| This field is required. | ช่องนี้เป็นสิ่งจำเป็น | กรอกช่องนี้ด้วย / จำเป็นต้องกรอก |
+
+คำที่ควรเลี่ยง: "ล้มเหลว" "ไม่สามารถ...ได้" (TH21) "การ...ล้มเหลว" (TH02) ใช้ "...ไม่ได้" "...ไม่สำเร็จ" แทน
+
+## 4. ข้อความแจ้งผลและข้อความยืนยัน
+
+| ต้นฉบับ | แปลแข็ง | ควรใช้ |
+|---|---|---|
+| Saved successfully! | บันทึกสำเร็จแล้ว! | บันทึกแล้ว |
+| Your changes have been saved. | การเปลี่ยนแปลงของคุณได้รับการบันทึกแล้ว | บันทึกการเปลี่ยนแปลงแล้ว |
+| Are you sure you want to delete this? | คุณแน่ใจหรือไม่ว่าคุณต้องการลบสิ่งนี้? | ลบรายการนี้ไหม |
+| This action cannot be undone. | การกระทำนี้ไม่สามารถยกเลิกได้ | ลบแล้วกู้คืนไม่ได้ |
+
+## 5. ตัวแปรและ placeholder
+
+ตัวแปรคือส่วนที่โปรแกรมจะใส่ค่าจริงทีหลัง ต้องอยู่ครบและสะกดเหมือนเดิมทุกตัวอักษร
+
+| แบบ | ตัวอย่าง | พบใน |
+|---|---|---|
+| วงเล็บปีกกา | `{name}` `{0}` `{{count}}` | JavaScript, i18next, .NET, Vue |
+| printf | `%s` `%d` `%@` `%1$s` `%.2f` | Android, iOS, C, PHP, gettext |
+| ICU | `{count, plural, other {# รายการ}}` | FormatJS, ARB (Flutter), Android บางแบบ |
+| เกม | `[PlayerName]` `<item>` `$gold$` | แล้วแต่เอนจิน |
+| แท็ก | `<b>...</b>` `<a href="...">...</a>` `<br>` | HTML, Android, Unity |
+| ขึ้นบรรทัด | `\n` | ทุกแบบ |
+
+**กฎ:**
+
+1. ห้ามแปลคำในตัวแปร `{name}` ห้ามเป็น `{ชื่อ}`
+2. ย้ายตำแหน่งตัวแปรในประโยคได้ เพื่อให้ลำดับคำเป็นภาษาไทย
+3. ถ้ามีตัวแปรแบบ `%s` หลายตัวที่ไม่มีเลขตำแหน่ง และภาษาไทยต้องสลับลำดับ ห้ามสลับ ให้คงลำดับเดิม แล้วแจ้งในบันทึกว่าควรเปลี่ยนเป็น `%1$s` `%2$s`
+4. แปลข้อความในแท็กได้ แต่ห้ามแปลชื่อแท็กและค่าในแท็ก เช่น `href`
+5. ข้อความรอบตัวแปรต้องอ่านได้กับทุกค่าที่เป็นไปได้ เช่น `{count} items` เป็น `{count} รายการ` ใช้ได้ทั้ง 1 และ 100
+
+**ตัวอย่าง:**
+
+```
+en: "Welcome back, {name}!"
+th: "ยินดีต้อนรับกลับมา {name}"
+
+en: "%1$s liked your photo"
+th: "%1$s ถูกใจรูปภาพของคุณ"
+
+en: "You have {count} new messages"
+th: "มีข้อความใหม่ {count} ข้อความ"
+```
+
+## 6. พหูพจน์
+
+ภาษาไทยไม่เปลี่ยนรูปคำตามจำนวน ตามมาตรฐาน CLDR ภาษาไทยมีรูปพหูพจน์แบบเดียวคือ `other`
+
+- **ICU:** คงโครง `{count, plural, ...}` ไว้ แปลข้อความในทุก branch ที่ต้นฉบับมี ข้อความไทยของแต่ละ branch เหมือนกันได้ แต่ต้องมี `other` เสมอ
+- **Android `<plurals>`:** ภาษาไทยใช้แค่ `<item quantity="other">` ถ้าโครงการต้องการให้มีครบทุก item ตามต้นฉบับ ให้ใส่ข้อความเดียวกัน
+- **iOS `.stringsdict`:** ใช้ key `other`
+- **gettext (PO):** ภาษาไทย `nplurals=1` ใส่แค่ `msgstr[0]`
+
+```
+en: "{count, plural, one {# file} other {# files}}"
+th: "{count, plural, one {# ไฟล์} other {# ไฟล์}}"
+```
+
+## 7. ความยาวและการแสดงผล
+
+- ข้อความไทยมักกว้างพอๆ กับอังกฤษหรือสั้นกว่า แต่สระบนล่างและวรรณยุกต์ต้องการความสูงบรรทัดมากกว่า ถ้าผู้ใช้บอกว่าข้อความถูกตัด ให้เสนอคำสั้นลง
+- ภาษาไทยไม่เว้นวรรคระหว่างคำ ระบบตัดบรรทัดบางระบบตัดกลางคำ ข้อความยาวในพื้นที่แคบควรสั้นพอที่จะไม่ต้องตัดบรรทัด
+- เว้นวรรคหน้าและหลังตัวเลขและคำภาษาอังกฤษตามที่ทั้งแอปใช้ เลือกแบบเดียวทั้งไฟล์
+
+## 8. วันที่ เวลา ตัวเลข เงิน
+
+- รูปแบบวันที่และเวลาที่มาจากตัวแปร ปล่อยให้ระบบจัดตาม locale ห้ามเขียนทับ
+- ข้อความที่เขียนวันที่ตายตัว ใช้รูปแบบที่แอปใช้อยู่ ถ้าไม่มี ให้ใช้ "25 ต.ค. 2026" หรือตามที่ผู้ใช้กำหนด ปี พ.ศ. ใช้เมื่อแอปหรือผู้ใช้กำหนด
+- เงินบาท ใช้ "฿" หรือ "บาท" แบบเดียวทั้งแอป
+- ห้ามเปลี่ยนค่าของตัวเลข
+
+## 9. เว็บไซต์
+
+- **หัวข้อหลักและข้อความโฆษณา:** แปลแบบเขียนใหม่ได้ (transcreation) แต่ต้องไม่เกินจริงกว่าต้นฉบับ (TH09) และไม่เติมข้อมูล
+- **title และ meta description:** แปลให้สั้นพอสำหรับผลการค้นหา คงชื่อแบรนด์ไว้ต้นหรือท้ายตามต้นฉบับ
+- **URL, slug, id, class:** ห้ามแปล
+- **alt ของรูปภาพ:** แปล
+- **หน้ากฎหมาย** (ข้อตกลงการใช้งาน นโยบายความเป็นส่วนตัว): ใช้ `ทางการ` แปลให้ครบทุกข้อ และแนะนำในบันทึกให้ฝ่ายกฎหมายตรวจ

package/skills/localize-th/references/word-swaps.md

@@ -0,0 +1,206 @@
+# ตารางคำและสำนวนแข็ง → ทางเลือกที่เป็นธรรมชาติ
+
+ใช้ตอนแก้ (`เขียนใหม่`, `แก้เฉพาะจุด`) เพื่อหาคำแทนอย่างรวดเร็ว ทุกแถวเชื่อมกับรหัสรูปแบบใน `patterns.md`
+
+## วิธีใช้
+
+- **ตารางนี้เป็นตัวช่วย ไม่ใช่ find-and-replace** ต้องอ่านทั้งประโยคก่อน บางครั้งต้องเรียงประโยคใหม่ ไม่ใช่แค่เปลี่ยนคำ
+- ดูคอลัมน์ "ระดับภาษา" ทุกครั้ง ทางเลือกบางตัวใช้ได้เฉพาะ `กันเอง`/`ไม่เป็นทางการ`
+- "(ตัด)" แปลว่าลบทิ้งได้เมื่อประโยคยังมีความหมายครบ ถ้าตัดแล้วข้อมูลหายให้เก็บไว้
+- ถ้าคำนั้นอยู่ในเครื่องหมายคำพูดของคนอื่น ลิงก์ โค้ด หรือชื่อเฉพาะ ห้ามแตะ
+- ตัวย่อระดับภาษา: **ทุกระดับ** = `กันเอง` `ไม่เป็นทางการ` `กึ่งทางการ` `ทางการ`
+
+## TH01 ประโยคเปิดลอยๆ
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ในยุคดิจิทัลปัจจุบัน | (ตัด) เข้าเรื่องเลย | ทุกระดับ | เก็บไว้ถ้ายุคสมัยเป็นเนื้อหาจริง |
+| ในโลกที่เปลี่ยนแปลงอย่างรวดเร็ว | (ตัด) | ทุกระดับ | ถ้าต้องการเกริ่น ใช้ข้อเท็จจริงแทน |
+| ปฏิเสธไม่ได้เลยว่า | (ตัด) | ทุกระดับ | ตัดแล้วประโยคที่เหลือยังพูดได้ตรงๆ |
+
+## TH02 ทำนามด้วย การ/ความ เกินจำเป็น
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ทำการตรวจสอบ | ตรวจ / เช็ก | `กันเอง` `ไม่เป็นทางการ` ใช้ "เช็ก" | |
+| ทำการแก้ไข | แก้ | ทุกระดับ | |
+| ดำเนินการส่ง | ส่ง | ทุกระดับ | "ดำเนินการ" ในหนังสือราชการอาจคงไว้ |
+| มีความเข้าใจ | เข้าใจ | ทุกระดับ | |
+| เกิดการเปลี่ยนแปลง | เปลี่ยน | ทุกระดับ | |
+| ให้ความช่วยเหลือ | ช่วย | ทุกระดับ | "ให้ความสำคัญ" เป็นสำนวนตายตัว ไม่ต้องแก้ |
+
+## TH03 ได้ทำการ / มีการ / ได้มีการ
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ได้ทำการ + กริยา | (ตัด "ได้ทำการ") ใช้กริยาตรง | ทุกระดับ | อาจเติม "แล้ว" ท้ายประโยคถ้าต้องบอกว่าเสร็จ |
+| ได้มีการปรับปรุง | ปรับปรุง | ทุกระดับ | |
+| มีการประชุม (ผู้ทำชัด) | ประชุม | ทุกระดับ | ถ้าไม่ระบุผู้ทำ "มีการประชุม" ใช้ได้ |
+
+## TH04 ประโยค "ถูก" แบบแปลจาก passive
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ถูกพัฒนาโดย X | X พัฒนา | ทุกระดับ | |
+| ได้รับการออกแบบมา | ออกแบบมา / X ออกแบบ | ทุกระดับ | "ได้รับการ" กับของดี ใช้ได้ในงานทางการ |
+| ถูกสร้างขึ้นเพื่อ | สร้างขึ้นเพื่อ / ทำมาเพื่อ | `ไม่เป็นทางการ` ใช้ "ทำมาเพื่อ" | |
+
+## TH05 ซึ่ง...ซึ่ง... ต่อกันยาว
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ..., ซึ่งทำให้ | แยกประโยค หรือใช้ "จึง" / "เลย" | `กันเอง` `ไม่เป็นทางการ` ใช้ "เลย" | ตัดเป็นประโยคสั้น |
+| ..., ซึ่งส่งผลให้ | จึง / ทำให้ | `กึ่งทางการ` `ทางการ` | |
+
+## TH06 คำเชื่อมทุกประโยค
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| นอกจากนี้ | แล้วก็ / ยังมี / (ตัด) | `กันเอง` `ไม่เป็นทางการ` | `ทางการ` คงไว้ได้ ถ้าไม่ซ้ำ |
+| ยิ่งไปกว่านั้น | แถม / (ตัด) | `กันเอง` `ไม่เป็นทางการ` | |
+| อย่างไรก็ตาม | แต่ | `กันเอง` `ไม่เป็นทางการ` `กึ่งทางการ` | `ทางการ` ใช้ได้ |
+| ดังนั้น | เลย / จึง | `กันเอง` `ไม่เป็นทางการ` ใช้ "เลย" | งานวิชาการใช้ "ดังนั้น" ได้ตามปกติ |
+| ทั้งนี้ | (ตัด) | ทุกระดับ | หนังสือราชการใช้เป็นสำนวนมาตรฐาน |
+| ในขณะเดียวกัน | พร้อมกัน / ส่วน | ทุกระดับ | |
+
+## TH07 สำนวนแปลตรงจากอังกฤษ
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ทำให้แน่ใจว่า | ตรวจให้ดีว่า / เช็กให้ชัวร์ว่า | `กันเอง` ใช้ "เช็กให้ชัวร์" | |
+| ในแง่ของ | ด้าน / เรื่อง | ทุกระดับ | |
+| ในส่วนของ | ส่วน / เรื่อง | `กันเอง` `ไม่เป็นทางการ` | ในรายงานใช้ได้ ถ้าไม่ถี่ |
+| มันเป็นสิ่งสำคัญที่จะ | ควร / ต้อง | ทุกระดับ | เชื่อมกับ TH08 |
+| เป็นที่น่าสังเกตว่า | (ตัด) / ที่น่าสนใจคือ | ทุกระดับ | |
+| เล่นบทบาทสำคัญ | สำคัญต่อ / ช่วย | `กันเอง` `ไม่เป็นทางการ` `กึ่งทางการ` | งานวิชาการ "มีบทบาทสำคัญ" ใช้ได้ |
+| ในขณะที่ (เทียบ) | ส่วน / แต่ | ทุกระดับ | ถ้าหมายถึงเวลาเดียวกัน ไม่ต้องแก้ |
+| ดำดิ่งสู่ | เจาะลึก / มาดู | `กันเอง` `ไม่เป็นทางการ` | |
+| ก้าวไปอีกขั้น | ดีขึ้น / พัฒนาขึ้น | ทุกระดับ | |
+
+## TH08 "มัน" เป็นประธานหุ่น
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| มันเป็นเรื่องยากที่จะ... | ...ไม่ใช่เรื่องง่าย | ทุกระดับ | |
+| มันช่วยให้ | ช่วยให้ | ทุกระดับ | ตัด "มัน" ทิ้ง |
+
+## TH09 คำโฆษณาเกินจริง
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ยกระดับ | ทำให้ดีขึ้น / ปรับปรุง | ทุกระดับ | บอกด้วยว่าดีขึ้นอย่างไร ถ้าต้นฉบับมีข้อมูล |
+| ขับเคลื่อน | ผลักดัน / (ตัด) | ทุกระดับ | "ขับเคลื่อนด้วย AI" → "ใช้ AI" |
+| ปลดล็อก | เปิดให้... ได้ / ทำให้...ได้ | ทุกระดับ | |
+| ไร้รอยต่อ | ใช้ต่อกันลื่น / (ระบุสิ่งที่ลื่น) | ทุกระดับ | |
+| ครบวงจร | ครบ / ทำได้ทุกขั้นตอน | ทุกระดับ | คงไว้ได้ถ้าบริการครบจริง |
+| พลิกโฉม | เปลี่ยน | ทุกระดับ | |
+| ปฏิวัติวงการ | (ตัด) ใช้ข้อเท็จจริงแทน | ทุกระดับ | ห้ามเพิ่มข้อมูลที่ต้นฉบับไม่มี |
+| ทรงพลัง | แรง / เก่ง / (ตัด) | `กันเอง` `ไม่เป็นทางการ` | |
+
+## TH10 คำขยายเกิน
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| อย่างมีประสิทธิภาพ | (ตัด) / ได้เร็ว / ได้ดี | ทุกระดับ | |
+| เป็นอย่างมาก | มาก | ทุกระดับ | |
+| อย่างยิ่ง | มาก / ที่สุด | ทุกระดับ | "ขอขอบคุณอย่างยิ่ง" ใช้ได้ |
+| อย่างต่อเนื่อง | เรื่อยๆ / ตลอด | `กันเอง` `ไม่เป็นทางการ` | ถ้ามีตัวเลขกำกับ ให้คงไว้ |
+
+## TH12 ปิดท้ายแบบสรุปซ้ำ
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| โดยสรุปแล้ว | (ตัดทั้งย่อหน้า) | ทุกระดับ | รายงานที่มีหัวข้อ "บทสรุป" คงไว้ |
+| ท้ายที่สุดแล้ว | สุดท้าย | ทุกระดับ | |
+| หวังว่าข้อมูลนี้จะเป็นประโยชน์ | (ตัด) | ทุกระดับ | |
+| หากมีข้อสงสัยเพิ่มเติม สามารถสอบถามได้เสมอ | ถ้าสงสัยตรงไหน ถามได้เลย | `กันเอง` `ไม่เป็นทางการ` | `กึ่งทางการ` ระบุช่องทางติดต่อแทน |
+
+## TH13 คำถามเปิดเรื่องแบบโฆษณา
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| คุณเคยสงสัยไหมว่า... | (ตัด) เข้าเรื่องเลย / เคยไหม... | `กันเอง` `ไม่เป็นทางการ` | |
+| วันนี้เรามีคำตอบ | (ตัด) / มาดูกัน | `ไม่เป็นทางการ` | "มาดูกัน" ใช้ได้ถ้าไม่ซ้ำ |
+
+## TH14 ใช้ "คุณ" ถี่เกิน
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| คุณสามารถ...ได้ | (ละ "คุณ") ...ได้ | ทุกระดับ | |
+
+## TH16 ระดับภาษาไม่ตรงช่องทาง
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ขอแจ้งให้ทราบว่า | แจ้งว่า / (ตัด) | `กันเอง` `ไม่เป็นทางการ` `กึ่งทางการ` | หนังสือราชการคงไว้ได้ |
+| จึงเรียนมาเพื่อโปรดทราบ | (ตัด) | `กันเอง` `ไม่เป็นทางการ` | อีเมลงานใช้ "ขอบคุณครับ/ค่ะ" แทน |
+| เนื่องจาก | เพราะ / พอดี | `กันเอง` `ไม่เป็นทางการ` | `กึ่งทางการ` `ทางการ` คงไว้ได้ |
+| ขอความกรุณา | รบกวน | `กึ่งทางการ` | |
+
+## TH19 คำทับศัพท์ไม่จำเป็นหรือสะกดไม่คงที่
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| อีเมล์ | อีเมล | ทุกระดับ | สะกดตามราชบัณฑิตยสภา |
+| อัพเดท | อัปเดต | ทุกระดับ | |
+| เวปไซต์ / เว็บไซด์ | เว็บไซต์ | ทุกระดับ | |
+| แอพ / แอพพลิเคชั่น | แอป / แอปพลิเคชัน | ทุกระดับ | |
+| คอนเฟิร์ม | ยืนยัน | `กึ่งทางการ` `ทางการ` | `กันเอง` คงคำเดิมได้ |
+| พรีเซนต์ | นำเสนอ | `กึ่งทางการ` `ทางการ` | |
+
+## TH20 กั๊กคำซ้อน
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| อาจจะสามารถ...ได้ | อาจ...ได้ | ทุกระดับ | เก็บคำกั๊กไว้ 1 คำ |
+| ในระดับหนึ่ง | บ้าง / พอสมควร | ทุกระดับ | |
+| ขึ้นอยู่กับหลายปัจจัย | แล้วแต่กรณี / (ระบุปัจจัย) | `กันเอง` `ไม่เป็นทางการ` | ห้ามเพิ่มปัจจัยที่ต้นฉบับไม่มี |
+
+## TH21 "สามารถ...ได้" เกินจำเป็น
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| สามารถ + กริยา + ได้ | กริยา + ได้ | ทุกระดับ | |
+| มีความสามารถในการ... | ...ได้ / เก่ง... | ทุกระดับ | |
+
+## TH22 "ของ" ซ้อน
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ของบริษัทของเรา | ของเรา / บริษัทเรา | ทุกระดับ | |
+
+## TH23 กรอบประโยคว่าง
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| เป็นสิ่งที่ + กริยา | ที่ + กริยา / กริยาตรง | ทุกระดับ | |
+| เป็นการ + กริยา | กริยาตรง | ทุกระดับ | |
+| ถือเป็น | เป็น | ทุกระดับ | |
+
+## TH24 ภาษาสวยหรูเกินเนื้อหา
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| เปี่ยมไปด้วย | มี / เต็มไปด้วย | ทุกระดับ | |
+| ผสมผสานอย่างลงตัว | ผสมกัน (บอกว่าผสมอะไร) | ทุกระดับ | |
+| มนต์เสน่ห์ | เสน่ห์ / (ระบุ) | `กันเอง` `ไม่เป็นทางการ` | |
+| ราวกับ | เหมือน | `กันเอง` `ไม่เป็นทางการ` | |
+
+## TH25 "ไม่ใช่แค่... แต่คือ..."
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| ไม่ใช่แค่ X แต่คือ Y | พูด Y ตรงๆ | ทุกระดับ | คงไว้ถ้าใช้แก้ความเข้าใจผิดจริง |
+
+## TH26 คำพูดของผู้ช่วย AI หลุดมาในงาน
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| แน่นอนค่ะ! นี่คือ... | (ตัด) | ทุกระดับ | |
+| หากต้องการปรับเพิ่มเติม แจ้งได้เลย | (ตัด) | ทุกระดับ | ถ้ามีช่องว่าง เช่น [ชื่อร้าน] ให้แจ้งผู้ใช้ ห้ามเติมเอง |
+
+## TH29 อีโมจิและเครื่องหมายตกใจ (!)
+
+| คำ/สำนวนแข็ง | ทางเลือก | ระดับภาษา | หมายเหตุ |
+|---|---|---|---|
+| อีโมจิทุกตัว และ "!" | (ตัด) | ทุกระดับ | ยกเว้นในคำพูดที่ยกมา หรือผู้ใช้สั่งให้คงไว้ |