humanizer-th 0.0.0-stage → 0.5.1

package/skills/script-th/references/registers.md

@@ -0,0 +1,127 @@
+# ระดับภาษา คำลงท้าย และสรรพนาม
+
+ใช้ไฟล์นี้ตอนขั้นแรกของขั้นตอน (ระบุระดับภาษา) และตอนตรวจ TH14, TH15, TH16 ในแคตตาล็อก `patterns.md`
+
+## 1. เลือกระดับภาษาอย่างไร
+
+ชื่อระดับใช้ตามที่เรียนในวิชาภาษาไทย ซึ่งแบ่งระดับภาษาเป็น 5 ระดับ คือ พิธีการ ทางการ กึ่งทางการ ไม่เป็นทางการ และกันเอง skill นี้ใช้ 4 ระดับหลัง ส่วนระดับพิธีการ (สุนทรพจน์ คำกล่าวในพิธี) อยู่นอกขอบเขต
+
+| ระดับ | ในตำรา | ช่องทางที่ skill นี้จัดให้ |
+|---|---|---|
+| `กันเอง` | ภาษาปาก ใช้กับคนสนิทมาก | แชตกับเพื่อน คนในครอบครัว คนสนิท |
+| `ไม่เป็นทางการ` | ระดับสนทนา ใช้กับคนที่ไม่สนิทมากหรือต้องระวังมารยาท | โพสต์โซเชียล บล็อก แชตกับหัวหน้าหรือเพื่อนร่วมงาน |
+| `กึ่งทางการ` | ประชุมกลุ่มย่อย การบรรยาย | อีเมลงานประจำวัน ข้อความถึงลูกค้า |
+| `ทางการ` | รายงาน ประกาศ จดหมายราชการหรือธุรกิจ | รายงาน หนังสือราชการ เอกสารวิชาการ จดหมายธุรกิจที่เป็นเรื่องเป็นราว |
+
+ถ้าผู้ใช้ไม่ระบุ ให้เดาจากเนื้อหาและช่องทาง แล้วบอกในสรุปว่าเลือกระดับไหน
+
+| สัญญาณในข้อความ | ระดับที่น่าจะใช่ |
+|---|---|
+| ประโยคสั้น มีคำอย่าง "นะ" "เลย" "อะ" "555" ผู้รับเป็นเพื่อนหรือคนสนิท | `กันเอง` |
+| โพสต์เพจ แคปชัน บล็อกส่วนตัว หรือแชตกับหัวหน้าและเพื่อนร่วมงาน | `ไม่เป็นทางการ` |
+| อีเมลงาน ข้อความถึงลูกค้า มี "เรียน" "ขอบคุณครับ/ค่ะ" ต้องการความชัดเจนและสุภาพ | `กึ่งทางการ` |
+| รายงาน หนังสือราชการ เอกสารวิชาการ ไม่มีผู้รับเฉพาะคน | `ทางการ` |
+
+ถ้าสัญญาณขัดกัน (เช่น อีเมลงานที่เขียนสบายๆ มาก) ให้ยึดผู้รับเป็นหลัก ไม่ใช่ตัวข้อความ ถ้ายังเดาไม่ได้จริงๆ ให้ถามคำถามเดียว เช่น "ข้อความนี้ส่งถึงใคร" แล้วเลือกจากคำตอบ
+
+**ห้ามยกระดับภาษาให้สูงกว่าต้นฉบับโดยไม่จำเป็น** ถ้าผู้เขียนเขียน `ไม่เป็นทางการ` อยู่แล้ว ให้คงไว้แล้วตัดเฉพาะร่องรอย AI
+
+## 2. ประโยคเดียวกัน 4 ระดับ
+
+เนื้อหา: ประชุมเลื่อนเป็นพรุ่งนี้บ่ายสองโมง เพราะวิทยากรไม่ว่าง (ตัวอย่างนี้สมมติผู้เขียนเป็นผู้ชาย ถ้าเป็นผู้หญิงเปลี่ยน "ครับ" เป็น "ค่ะ")
+
+| ระดับ | ข้อความ |
+|---|---|
+| `กันเอง` | ประชุมเลื่อนเป็นพรุ่งนี้บ่ายสองนะ วิทยากรไม่ว่าง |
+| `ไม่เป็นทางการ` | ประชุมเลื่อนไปพรุ่งนี้ตอนบ่ายสองนะครับ พอดีวิทยากรไม่ว่าง |
+| `กึ่งทางการ` | ขอแจ้งว่าการประชุมเลื่อนเป็นพรุ่งนี้ เวลา 14.00 น. เนื่องจากวิทยากรไม่สะดวกเข้าร่วมครับ |
+| `ทางการ` | ขอแจ้งเลื่อนการประชุมเป็นวันพรุ่งนี้ เวลา 14.00 น. เนื่องจากวิทยากรไม่สามารถเข้าร่วมได้ |
+
+ทั้ง 4 ระดับสั้นกว่าประโยคแบบ AI ที่เป็นต้นฉบับ เช่น "ขอแจ้งให้ทราบว่าการประชุมได้ถูกเลื่อนออกไปเป็นวันพรุ่งนี้ เวลา 14.00 น. เนื่องจากวิทยากรไม่สามารถเข้าร่วมได้ จึงเรียนมาเพื่อโปรดทราบ" (TH03, TH04, TH16)
+
+## 3. รายละเอียดแต่ละระดับ
+
+### `กันเอง`: แชตกับเพื่อน คนในครอบครัว คนสนิท
+
+- ประโยคสั้น ละประธานได้ทุกครั้งที่บริบทชัด
+- ใช้คำเล็กๆ เชื่อมความ เช่น "แล้วก็" "เลย" "พอดี" แทนคำเชื่อมยาว
+- คำลงท้ายตามความสัมพันธ์ ไม่ต้องใส่ทุกข้อความ
+- ยอมรับได้: คำอังกฤษที่คนใช้จริง ("confirm" "ok") และ "555" ไม่ใส่อีโมจิหรือ "!" (TH29)
+- ระวัง: TH16 (ภาษาราชการใน LINE), TH17 (หัวข้อ ตัวหนา บูลเล็ต), TH14, TH15
+
+### `ไม่เป็นทางการ`: โพสต์โซเชียล บล็อก แชตกับหัวหน้าหรือเพื่อนร่วมงาน
+
+- อ่านสบาย เหมือนเล่าให้คนอ่านฟัง แต่ยังรักษามารยาท
+- แชตกับหัวหน้าหรือรุ่นพี่ใช้ภาษาพูดได้ แต่ใส่คำลงท้ายสุภาพตามที่ผู้เขียนใช้
+- ใช้ "เรา" หรือ "ผม/ฉัน" ได้ตามที่ผู้เขียนใช้ ไม่ต้องเรียกผู้อ่านว่า "คุณ" ทุกประโยค
+- ย่อหน้าสั้น เว้นบรรทัดให้อ่านง่าย ไม่ใส่อีโมจิหรือ "!" (TH29)
+- ระวัง: TH01, TH09, TH13, TH17, TH24, TH25, TH12
+
+### `กึ่งทางการ`: อีเมลงานประจำวัน ข้อความถึงลูกค้า
+
+- สุภาพและกระชับ ไม่แข็งแบบหนังสือราชการ
+- เปิดด้วยเรื่องที่ต้องการบอกภายในประโยคแรก ปิดด้วยสิ่งที่ต้องการให้ผู้รับทำ ถ้ามี
+- คำลงท้ายสุภาพใช้เป็นจังหวะ (ต้นอีเมลหรือท้ายอีเมล และจุดที่ต้องการความนอบน้อม) ไม่ใส่ทุกประโยค
+- ระวัง: TH02, TH03, TH06, TH12, TH16, TH21
+
+### `ทางการ`: รายงาน หนังสือราชการ เอกสารวิชาการ
+
+- ใช้ภาษาเขียน ไม่ใช้ภาษาพูด ("เพราะ" → "เนื่องจาก" ได้ "เลย" → "จึง")
+- ไม่ต้องมีคำลงท้ายสุภาพ ยกเว้นรูปแบบจดหมายที่กำหนดไว้ (เช่น "ขอแสดงความนับถือ")
+- คงคำที่เป็นศัพท์หรือธรรมเนียมของเอกสารประเภทนั้นไว้ เช่น "ดำเนินการ" "เรียน" "โปรดพิจารณา"
+- "ดังนั้น" "อย่างไรก็ตาม" "ทั้งนี้" ใช้ได้ แต่ไม่ควรเกิน 1–2 ครั้งต่อย่อหน้า
+- ยังต้องกระชับ "ไม่อืดยืดยาว" คือตัด TH02, TH03, TH10 ที่เป็นแค่ความยาวเปล่า
+- ระวัง: TH02, TH03, TH05, TH07, TH10, TH22, TH23
+
+## 4. คำลงท้ายและสรรพนาม
+
+### กฎ
+
+1. **ห้ามสลับเพศผู้เขียน** ถ้าต้นฉบับใช้ "ครับ" ให้ใช้ "ครับ" ตลอด ถ้าใช้ "ค่ะ/คะ" ให้ใช้ "ค่ะ/คะ" ตลอด
+2. **ถ้าต้นฉบับมีคำลงท้ายสองเพศปนกัน** ให้ตรวจก่อนว่ามีหลายคนเขียน (เช่น แชตของทีม) หรือเป็นความผิดพลาด (TH15) ถ้าไม่แน่ใจ ให้คงไว้และถามผู้ใช้
+3. **ไม่ใส่คำลงท้ายทุกประโยค** ใส่ที่ต้นหรือท้ายข้อความ และจุดที่ต้องการความนอบน้อมหรือความเป็นมิตรจริงๆ
+4. **ถ้าต้นฉบับไม่มีคำลงท้ายและระดับภาษาต้องใช้** (เช่น `กึ่งทางการ`)
+   - ค่าเริ่มต้น: ไม่ต้องหยุดถามก่อน ให้ส่งผลลัพธ์ที่ใช้โครงประโยคไม่ต้องมีคำลงท้ายเพศ (เช่น "ขอบคุณสำหรับ..." "รบกวน...") แล้วถามในหมายเหตุว่าต้องการให้เติม ครับ/ค่ะ ไหม
+   - ข้อความในนามบริษัท ฝ่าย หรือเพจ มักไม่ต้องมีคำลงท้ายเพศอยู่แล้ว
+   - ถามก่อนเขียน เฉพาะเมื่อขาดคำลงท้ายแล้วจะฟังห้วนจนเสียมารยาทจริงๆ เช่น ข้อความส่วนตัวถึงผู้ใหญ่ใน `กันเอง` และถามเป็นคำถามเดียวว่าเขียนในนามผู้ชายหรือผู้หญิง
+   - ห้ามเดาเพศจากชื่อ
+5. **ห้ามเพิ่มระดับความสุภาพเกินต้นฉบับ** เช่น เติม "นะคะ/นะครับ" ทุกบรรทัดในข้อความที่ผู้เขียนไม่ได้ใช้ (TH15)
+
+### คำลงท้ายที่ไม่ระบุเพศ
+
+ใช้ได้ใน `กันเอง` และ `ไม่เป็นทางการ` เมื่อต้นฉบับไม่มีคำลงท้ายเพศ
+
+| คำ | ความรู้สึก | ตัวอย่าง |
+|---|---|---|
+| นะ | อ่อนลง ขอร้องหรือยืนยันเบาๆ | ประชุมเลื่อนนะ |
+| เลย | เน้น | ดีมากเลย |
+| ละ / แล้ว | บอกว่าเสร็จหรือเปลี่ยนสถานะ | ส่งแล้ว |
+| เนอะ | ชวนให้เห็นด้วย | ร้อนจังเนอะ |
+| อะ / นะ | ภาษาพูดมาก ใช้เฉพาะ `กันเอง` | ไม่ว่างอะ |
+
+### สรรพนาม
+
+| สถานการณ์ | ที่เลือกได้ | หมายเหตุ |
+|---|---|---|
+| ผู้เขียนพูดถึงตัวเอง | ผม / ฉัน / เรา / ชื่อเล่น | ใช้ตามที่ต้นฉบับใช้ ถ้าไม่มีให้ละประธาน |
+| พูดกับผู้อ่านทั่วไป (`ไม่เป็นทางการ`) | ละประธาน / เพื่อนๆ / ทุกคน | หลีกเลี่ยง "คุณ" ซ้ำ (TH14) |
+| พูดกับลูกค้า (`กึ่งทางการ`) | ลูกค้า / ท่าน / คุณ + ชื่อ | เลือกอย่างเดียวทั้งชิ้น ไม่สลับ |
+| พูดถึงองค์กร | เรา / บริษัท / ร้าน / ชื่อแบรนด์ | อย่าสลับ "เรา" กับ "บริษัท" ในย่อหน้าเดียวโดยไม่มีเหตุผล |
+| `ทางการ` | ละประธาน / ชื่อหน่วยงาน / ท่าน (ผู้รับ) | หนังสือราชการใช้ "เรียน" ตามธรรมเนียม |
+
+### ข้อควรระวัง
+
+- **กับผู้ใหญ่และคนที่ไม่สนิท** อย่าลดความสุภาพของต้นฉบับ ถ้าผู้เขียนใส่ "ครับ" "ค่ะ" บ่อย อาจเป็นเพราะผู้รับ ให้ตัดเฉพาะส่วนที่ซ้ำจนรกจริงๆ
+- **ข้อความที่ผู้เขียนเป็นแอดมินเพจหรือแบรนด์** ให้ยึดคำลงท้ายที่เพจใช้ประจำ ถ้าไม่เคยมีให้ถามหรือเลือกแบบเป็นกลางและบอกผู้ใช้
+- **คำพูดที่ยกมา** ไม่แตะคำลงท้ายหรือสรรพนามภายในเครื่องหมายคำพูดของคนอื่น (ข้อห้ามข้อ 2)
+
+## 5. ตารางสรุป
+
+| | `กันเอง` | `ไม่เป็นทางการ` | `กึ่งทางการ` | `ทางการ` |
+|---|---|---|---|---|
+| ความยาวประโยค | สั้นมาก | สั้นถึงกลาง | กลาง | กลางถึงยาว แต่ไม่อืด |
+| ละประธาน | บ่อย | บ่อย | พอควร | ตามธรรมเนียม |
+| คำลงท้าย | ตามความสนิท | เล็กน้อย | ต้นและท้าย | แทบไม่มี |
+| ภาษาพูด | ได้ | ได้พอควร | เลี่ยง | ห้าม |
+| คำเชื่อมยาว (ดังนั้น ทั้งนี้) | เลี่ยง | เลี่ยง | พอควร | ปกติ |
+| อีโมจิ และ "!" | ไม่ใช้ | ไม่ใช้ | ไม่ใช้ | ไม่ใช้ |

package/skills/script-th/references/style.md

@@ -0,0 +1,102 @@
+# เลียนสไตล์ผู้เขียน
+
+ใช้เมื่อผู้ใช้ส่งตัวอย่างงานเขียนมา แล้วอยากให้งานใหม่อ่านเหมือนคนเดียวกันเขียน ไฟล์นี้ใช้ร่วมกันทั้งสาม skill
+
+| skill | ตัวอย่างที่มักได้ | ใช้ทำอะไร |
+|---|---|---|
+| `humanizer-th` | โพสต์ อีเมล แชตเก่าของผู้ใช้ | เขียนร่างใหม่หรือเขียนจากโจทย์ให้เป็นสำนวนของผู้ใช้ (โหมด `เลียนสไตล์`) |
+| `localize-th` | ซับตอนก่อน ข้อความในแอปเวอร์ชันเดิม งานแปลเก่าของทีม | แปลส่วนใหม่ให้เข้ากับงานเดิม |
+| `script-th` | บทเก่าของผู้ใช้ หรือตอนก่อนของเรื่องเดียวกัน | เขียนหรือเกลาตอนใหม่ให้เป็นสไตล์เดิม |
+
+## ตัวอย่างที่ใช้ได้
+
+ดู 4 เรื่องนี้ก่อนเริ่ม ถ้าข้อไหนไม่ผ่าน ให้บอกผู้ใช้ในหมายเหตุ
+
+1. **เป็นงานของใคร:** งานของผู้ใช้เอง หรืองานที่ผู้ใช้มีสิทธิ์ใช้ เช่น โพสต์ของเพจที่ตัวเองเป็นแอดมิน ซับที่ทีมตัวเองแปล ถ้าเป็นงานของคนอื่น ดูหัวข้อ "เมื่อตัวอย่างเป็นงานของคนอื่น"
+2. **ประเภทเดียวกับงานที่จะเขียน:** แชตใช้เลียนแชต โพสต์ใช้เลียนโพสต์ คนคนเดียวเขียน LINE หาเพื่อนกับอีเมลหาลูกค้าไม่เหมือนกัน ถ้าตัวอย่างปนหลายประเภท ให้ใช้เฉพาะชิ้นที่ตรงกับงาน หรือแยกโปรไฟล์ตามประเภท ห้ามเอามาเฉลี่ยรวมกัน
+3. **มีพอไหม:** 3 ชิ้นขึ้นไป ยิ่งข้อความสั้นยิ่งต้องใช้หลายชิ้น เช่น แชตควรมี 10 ข้อความขึ้นไป ถ้ามีน้อยกว่านี้ยังทำได้ แต่บอกผู้ใช้ว่าโปรไฟล์ยังหยาบ เพราะลักษณะที่เห็นแค่ครั้งเดียวอาจเป็นเรื่องบังเอิญ
+4. **คนเขียนเองหรือเปล่า:** ถ้าตัวอย่างมีรูปแบบจาก `patterns.md` หลายหมวดในเกือบทุกชิ้น เช่น เปิดลอยๆ (TH01) คำเชื่อมทุกประโยค (TH06) ปิดสรุปซ้ำ (TH12) ตัวอย่างนั้นอาจเป็นข้อความที่ AI เขียน ถ้าเลียนตาม ร่องรอย AI จะติดมาด้วย ให้บอกผู้ใช้ก่อน แล้วเสนอให้ส่งชิ้นอื่น หรือเกลาตัวอย่างก่อน
+
+## ทำโปรไฟล์สำนวน
+
+อ่านตัวอย่างให้ครบทุกชิ้นก่อน แล้วจดลักษณะที่**เห็นซ้ำในหลายชิ้น**ลงตาราง ทุกข้อต้องมีหลักฐานจากตัวอย่าง ยกคำสั้นๆ มาประกอบ ข้อไหนไม่เห็นในตัวอย่าง ให้เขียนว่า "ไม่เห็นในตัวอย่าง" แล้วใช้ค่าเริ่มต้นของ skill ห้ามเดาเติม
+
+| หัวข้อ | ดูอะไร | ตัวอย่างที่จด |
+|---|---|---|
+| ระดับภาษา | ระดับไหนตาม `registers.md` | ไม่เป็นทางการ |
+| เรียกตัวเอง เรียกคนอ่าน | สรรพนาม หรือไม่เรียกเลย | "ผม" ไม่เรียกคนอ่านตรงๆ ใช้ "ใครชอบ..." แทน |
+| คำลงท้าย | คำไหน ถี่แค่ไหน อยู่ตรงไหน | "ครับ" ครั้งเดียวท้ายโพสต์ |
+| ความยาวและการแบ่ง | ประโยคสั้นหรือยาว ย่อหน้ากี่บรรทัด ขึ้นบรรทัดใหม่บ่อยไหม | บรรทัดละวรรค เว้นบรรทัดทุก 2–3 บรรทัด |
+| เปิดและปิด | ขึ้นต้นด้วยอะไร ลงท้ายด้วยอะไร | เปิดด้วยเรื่องที่เจอวันนั้น ปิดด้วยเวลาเปิดร้าน |
+| คำติดปาก | คำหรือวลีที่เจอเกือบทุกชิ้น | "บอกตรงๆ" ตอนบอกความเห็นตัวเอง |
+| ภาษาอังกฤษปน | คำไหนเขียนเป็นอักษรอังกฤษ คำไหนทับศัพท์ | ชื่อเมนูเขียนเป็นอังกฤษ |
+| เครื่องหมายและสัญลักษณ์ | ไม้ยมก "..." "?" "!" อีโมจิ 555 วงเล็บ แฮชแท็ก | ไม่มีอีโมจิ ไม่มี "!" |
+| ตัวเลขและวันที่ | เลขไทยหรือเลขอารบิก เขียนเวลาและราคาแบบไหน | "8 โมงถึงบ่าย 3" ราคาไม่มีคำว่า "บาท" |
+| น้ำเสียง | ขำ ตรง อ่อนน้อม ประชดตัวเอง ชอบเล่าเรื่อง | เล่าเรื่องตัวเองขำๆ ไม่ขายของตรงๆ |
+| สิ่งที่ไม่ทำ | ลักษณะที่ไม่เจอในตัวอย่างเลย | ไม่มีหัวข้อ ไม่มีคำโฆษณา |
+
+ข้อสุดท้ายสำคัญเท่ากับข้ออื่น คนอ่านจำคนเขียนได้จากสิ่งที่เขาไม่ทำพอๆ กับสิ่งที่ทำ
+
+**งานแปลและงานบท** ดูเพิ่มอีก 5 เรื่อง
+
+| หัวข้อ | ใช้กับ | ดูอะไร |
+|---|---|---|
+| สรรพนามของตัวละคร | ซับ เกม บท | ใครเรียกใครว่าอะไร ลงตารางตัวละครตาม `characters.md` |
+| คำศัพท์ | ซับ เกม UI | ชื่อเฉพาะ ชื่อไอเทม คำ UI ที่ใช้ไปแล้ว ลงอภิธานศัพท์ |
+| การพูดกับผู้ใช้ | UI | ใช้ "คุณ" ไหม ใช้ "กรุณา" ไหม ปุ่มเป็นคำกริยาคำเดียวหรือเป็นวลี |
+| ความแรงของภาษา | ซับ เกม บท | คำหยาบ คำสบถ มุก แปลหรือเขียนแรงแค่ไหน |
+| จังหวะ | ซับ บท | ซับตัดบรรทัดตรงไหน ใช้ขีดนำบทสนทนาไหม บทแต่ละฉากยาวแค่ไหน เปิดและปิดตอนแบบไหน |
+
+## เขียนตามโปรไฟล์
+
+1. **เนื้อหามาจากร่างหรือโจทย์เท่านั้น:** ตัวอย่างใช้ดูวิธีเขียน ไม่ใช่แหล่งข้อมูล ห้ามยกเรื่อง ข้อมูล หรือประโยคจากตัวอย่างมาใส่ เช่น ตัวอย่างเล่าเรื่องแมวที่ร้าน งานใหม่ก็ต้องไม่มีแมว ยกเว้นคำทักทาย คำลงชื่อ หรือคำติดปากสั้นๆ ที่ผู้เขียนใช้ประจำ
+2. **ถ้าสไตล์ต้องใช้ข้อมูลที่ไม่มี ห้ามแต่งเอง:** เช่น ผู้เขียนชอบเปิดด้วยเรื่องเล่า แต่ร่างไม่มีเรื่องเล่า ให้เปิดด้วยเรื่องที่มีในร่าง แล้วบอกในหมายเหตุว่าถ้าเล่าให้ฟังว่าเกิดอะไรขึ้น จะเขียนเปิดแบบนั้นให้ได้
+3. **ถี่เท่าตัวอย่าง ไม่ถี่กว่า:** คำติดปากที่เจอชิ้นละครั้ง ใส่ครั้งเดียวก็พอ หรือไม่ใส่เลยถ้าไม่มีจุดที่เข้า ถ้าใส่ทุกย่อหน้าจะกลายเป็นล้อเลียน
+4. **เริ่มจากสิ่งที่คนอ่านเห็นก่อน:** สรรพนาม คำลงท้าย การแบ่งบรรทัด วิธีเปิดและปิด ทำให้ตรงก่อน แล้วค่อยดูคำติดปากและน้ำเสียง
+
+## สไตล์กับรูปแบบใน `patterns.md`
+
+ตัวอย่างของผู้เขียนอาจมีลักษณะที่ `patterns.md` นับเป็นรูปแบบ AI ตัดสินแบบนี้
+
+- **เรื่องรสนิยม** ได้แก่ อีโมจิและ "!" (TH29) คำลงท้ายถี่ (TH15) คำอังกฤษปน (TH19) รูปแบบหัวข้อและรายการ (TH17) จุลภาค (TH18) จุดท้ายประโยค (TH27) เปิดด้วยคำถาม (TH13) ถ้าเห็นซ้ำในหลายชิ้น ถือเป็นสไตล์ของผู้เขียน ใช้ได้ไม่เกินความถี่ในตัวอย่าง ถ้าไม่เห็นในตัวอย่าง ห้ามเติม
+- **สำนวนแปลที่ทำให้อ่านยาก** ได้แก่ TH03 ได้ทำการ, TH04 "ถูก" แบบแปล, TH05 ซึ่งต่อกันยาว, TH07 สำนวนแปล ไม่เลียน แม้ผู้เขียนจะใช้ประจำ เพราะคนอ่านอ่านยากขึ้นจริง ให้บอกในหมายเหตุว่าข้อนี้ไม่ได้เลียน ถ้าผู้ใช้ยืนยันว่าต้องการ ค่อยใส่
+- **คำพูดของผู้ช่วย AI (TH26):** ไม่ใช้เลย
+- **รูปแบบอื่น:** เลียนได้ถ้าเห็นซ้ำในหลายชิ้นและอ่านแล้วไม่สะดุด ถ้าไม่แน่ใจ ให้ไม่ใช้ แล้วบอกในหมายเหตุ
+
+## สิ่งที่ไม่เลียน
+
+- **คำผิด:** สะกดผิดโดยไม่ได้ตั้งใจ เช่น "นะค่ะ" (ที่ถูกคือ "นะคะ") "อนุญาติ" (ที่ถูกคือ "อนุญาต") ไม่เลียน ใช้ตัวสะกดที่ถูก ส่วนการเขียนแบบภาษาพูดที่ตั้งใจ เช่น "มากกก" "เค้า" "ป่ะ" "555" ใช้ได้ตามตัวอย่าง เฉพาะงานระดับกันเองและไม่เป็นทางการ
+- **ข้อมูลส่วนตัว:** ชื่อคน เบอร์โทร ที่อยู่ ที่อยู่ในตัวอย่าง ห้ามนำไปใช้ในงานใหม่
+- **ประโยคเฉพาะตัว:** ห้ามยกประโยคจากตัวอย่างมาทั้งประโยค
+
+## เมื่อตัวอย่างเป็นงานของคนอื่น
+
+- **เขียนแทนโดยเจ้าตัวรู้:** เช่น แอดมินเขียนโพสต์ในนามเจ้าของร้าน เลขาร่างข้อความให้ผู้บริหาร ทีมแปลซีซันใหม่ต่อจากทีมเดิม ทำได้ตามปกติ
+- **นักเขียนหรือคนดัง:** เลียนแนวกว้างๆ ได้ เช่น จังหวะสั้น น้ำเสียงประชด เพื่อฝึกเขียนหรือหาแนว แต่ห้ามลอกประโยคหรือวลีเฉพาะตัว ห้ามเขียนในนามคนนั้น และห้ามทำให้คนอ่านเข้าใจว่าคนนั้นเขียน
+- **ปลอมเป็นคนอื่น:** ถ้าจุดประสงค์คือให้คนอ่านเชื่อว่าอีกคนเป็นคนเขียน ทั้งที่คนนั้นไม่รู้หรือไม่ได้อนุญาต เช่น แชตในชื่อหัวหน้า ข้อความในชื่อคนในครอบครัว โพสต์ในชื่อคนดัง ให้ปฏิเสธ แล้วบอกเหตุผลสั้นๆ
+- **หลบเครื่องมือตรวจจับ AI:** ถ้าผู้ใช้บอกว่าจะใช้สไตล์ของตัวเองเพื่อให้ detector จับไม่ได้ หรือเพื่อส่งงานที่ห้ามใช้ AI ให้บอกตรงๆ ว่า skill นี้ไม่ได้ทำเพื่อเรื่องนั้น
+
+## เก็บโปรไฟล์ไว้ใช้ครั้งหน้า
+
+ถ้าผู้ใช้ขอโปรไฟล์ หรือบอกว่าจะใช้สไตล์นี้อีก ให้ส่งโปรไฟล์ตามแบบด้านล่าง ผู้ใช้เก็บไว้แล้ววางแทนตัวอย่างในครั้งหน้าได้ ถ้าเครื่องมือที่ใช้อยู่เขียนไฟล์ได้และผู้ใช้ขอให้บันทึก ให้บันทึกเป็นไฟล์ในโฟลเดอร์งาน เช่น `style-profile.md`
+
+```text
+โปรไฟล์สำนวน: [ชื่อที่ผู้ใช้ตั้ง เช่น โพสต์เพจร้าน]
+ใช้กับ: [ประเภทงาน]
+ทำจาก: [จำนวนชิ้นของตัวอย่าง]
+
+- ระดับภาษา:
+- เรียกตัวเอง / เรียกคนอ่าน:
+- คำลงท้าย:
+- ความยาวและการแบ่ง:
+- เปิดและปิด:
+- คำติดปาก:
+- ภาษาอังกฤษปน:
+- เครื่องหมายและสัญลักษณ์:
+- ตัวเลขและวันที่:
+- น้ำเสียง:
+- ไม่ทำ:
+- ไม่ได้เลียน: [ลักษณะที่ตั้งใจไม่ตาม และเหตุผล]
+```
+
+ถ้าผู้ใช้ส่งโปรไฟล์ที่เคยทำไว้มา ให้ใช้ตามนั้นได้เลย ไม่ต้องขอตัวอย่างใหม่ ถ้าส่งทั้งโปรไฟล์และตัวอย่างใหม่ ให้ปรับโปรไฟล์ตามตัวอย่างใหม่ แล้วบอกว่าเปลี่ยนข้อไหน

package/skills/script-th/references/video-prompts.md

@@ -0,0 +1,103 @@
+# พรอมต์สำหรับเว็บสร้างวิดีโอ
+
+ไฟล์นี้ใช้ตอนแปลงบทเป็นพรอมต์ทีละช็อต เครื่องมือแต่ละตัวเปลี่ยนความสามารถบ่อย ทั้งความยาวคลิปและภาษาที่พูดได้ ก่อนทำทั้งเรื่องให้ผู้ใช้ลองช็อตเดียวก่อนเสมอ
+
+## 1. วิธีใส่เสียง
+
+ถามผู้ใช้ว่าจะใช้วิธีไหน ถ้าผู้ใช้ไม่รู้ ให้แนะนำตามตารางนี้
+
+| วิธี | ทำอย่างไร | เหมาะกับ | ข้อควรระวัง |
+|---|---|---|---|
+| ก. เสียงจากโมเดลวิดีโอ | ใส่บทพูดไทยในพรอมต์ ให้โมเดลสร้างภาพและเสียงพร้อมกัน | งานเร็ว คลิปสั้น ฉากพูดน้อย | หลายเครื่องมือยังพูดไทยได้ไม่ดี อาจออกเสียงเพี้ยนหรือพูดเป็นภาษาอื่น ต้องลองก่อน |
+| ข. วิดีโอเงียบ + เสียง AI + ลิปซิงก์ | สร้างภาพที่ตัวละครขยับปาก สร้างเสียงพากย์ไทยแยก แล้วใช้เครื่องมือลิปซิงก์ให้ปากตรงเสียง | งานที่ต้องการเสียงไทยชัด คุมคำอ่านได้ | ใช้หลายเครื่องมือ ใช้เวลามากกว่า |
+| ค. เสียงบรรยายหรือซับอย่างเดียว | สร้างภาพโดยไม่มีบทพูดในปาก ใส่เสียงบรรยายหรือซับตอนตัดต่อ | งานที่อยากได้ผลชัวร์ เล่าเรื่องผ่านเสียงบรรยาย | ไม่มีฉากตัวละครพูดใส่กล้อง |
+
+ถ้าผู้ใช้ไม่ระบุ และต้องการให้ตัวละครพูดภาษาไทยชัด ให้แนะนำวิธี ข. และบอกว่าวิธี ก. ลองได้ แต่ผลภาษาไทยไม่แน่นอน
+
+## 2. การ์ดช็อต
+
+ส่งพรอมต์ทีละช็อตในรูปแบบนี้ เพื่อให้ผู้ใช้คัดลอกเฉพาะช่องพรอมต์ไปวางได้
+
+```
+ช็อต 3 | ฉาก 1 | 8 วินาที | ผู้พูด: มะลิ
+
+พรอมต์:
+Vertical 9:16, cinematic, natural light. MALI: a Thai woman in her late 20s, shoulder-length black hair, white blouse, small silver earrings. Medium close-up in a small Bangkok cafe in the afternoon. Mali puts her coffee cup down hard and looks straight at the man across the table, eyes glossy but jaw tight. Slow push-in. She says in Thai: "สามปีนะ สามปีที่ฉันเชื่อนายทุกคำ" Quiet cafe ambience, no music. No subtitles, no captions, no on-screen text.
+
+บทพูด: มะลิ: สามปีนะ สามปีที่ฉันเชื่อนายทุกคำ (11 พยางค์ ประมาณ 3 วินาที)
+เสียง: เสียงร้านกาแฟเบาๆ
+หมายเหตุ: [ถ้ามี]
+```
+
+- วิธี ข. ไม่ใส่บทพูดในพรอมต์ ให้เขียนว่า `She is speaking, mouth moving naturally.` แล้วให้บทพากย์ไปทำต่อตาม `voice.md`
+- วิธี ค. ไม่ต้องมีคนพูด ใส่ `No one is speaking.` ถ้าต้องการกันไม่ให้โมเดลสร้างเสียงพูดมั่ว
+
+## 3. หลักการเขียนพรอมต์
+
+### ภาษา
+
+เขียนส่วนบรรยายภาพเป็นภาษาอังกฤษ เพราะโมเดลวิดีโอส่วนใหญ่ทำตามพรอมต์อังกฤษได้แม่นกว่า ส่วนบทพูดใช้ภาษาไทยตามที่จะให้ตัวละครพูด ถ้าผู้ใช้อยากได้พรอมต์ภาษาไทยทั้งหมด ทำให้ได้ แต่บอกว่าอาจได้ผลไม่แม่นเท่า
+
+### ลำดับในพรอมต์
+
+1. รูปแบบภาพ: สัดส่วน สไตล์ แสง
+2. ตัวละคร: ชื่อเป็นตัวพิมพ์ใหญ่ตามด้วยคำบรรยายหน้าตาที่ล็อกไว้
+3. สถานที่และเวลา
+4. การกระทำและสีหน้า
+5. มุมกล้องและการเคลื่อนกล้อง
+6. บทพูด (เฉพาะวิธี ก.)
+7. เสียงประกอบ
+8. สิ่งที่ไม่ต้องการ
+
+### คุมหน้าตาตัวละคร
+
+- ใช้คำบรรยายหน้าตาจากตารางตัวละคร **คัดลอกทั้งประโยคเหมือนเดิมทุกช็อต** ห้ามเปลี่ยนคำ แม้แต่ลำดับคำ
+- เสื้อผ้าเหมือนเดิมตลอดฉาก เปลี่ยนเมื่อเปลี่ยนวันหรือเปลี่ยนฉากเท่านั้น
+- ถ้าเครื่องมือรองรับภาพอ้างอิงหรือการบันทึกตัวละคร ให้แนะนำผู้ใช้ใช้ด้วย ได้ผลดีกว่าคำบรรยายอย่างเดียว
+- ห้ามบรรยายหน้าตาด้วยชื่อดาราหรือคนจริง (ข้อห้ามข้อ 1)
+- ช็อตเดียวไม่ควรมีตัวละครเกิน 2 คน
+
+### ฉากไทย
+
+ใส่รายละเอียดที่ทำให้ภาพเป็นไทย ไม่ใช่ฉากเอเชียทั่วไป เช่น Bangkok condo, Thai street food stall, songthaew, 7-Eleven in Thailand, Thai school uniform (white shirt, navy skirt), Thai temple, motorbike taxi in orange vest
+
+### บทพูดในพรอมต์ (วิธี ก.)
+
+- บอกผู้พูดชัด เช่น `She says in Thai:` หรือ `MALI says in Thai:`
+- หนึ่งช็อตมีคนพูดคนเดียว
+- บทสั้น พูดจบในเวลาคลิปโดยมีช่วงว่างต้นและท้าย ดูวิธีนับใน `voice.md`
+- บางเครื่องมือออกเสียงดีขึ้นเมื่อบทอยู่ในเครื่องหมายคำพูด บางตัวกลับเอาข้อความไปขึ้นเป็นตัวหนังสือบนจอ ให้ผู้ใช้ลองทั้งสองแบบในช็อตแรก แล้วใช้แบบที่ได้ผลทั้งเรื่อง
+- บทพูดในพรอมต์ใช้ข้อความแบบเดียวกับบทพากย์ (ตัวเลขเขียนเป็นคำ ไม่มีตัวย่อ)
+
+### มุมกล้อง
+
+ใช้คำที่โมเดลเข้าใจ ช็อตละการเคลื่อนกล้องเดียว
+
+| ต้องการ | เขียนว่า |
+|---|---|
+| เห็นหน้าชัด เน้นอารมณ์ | close-up |
+| เห็นครึ่งตัว คุยกัน | medium shot / medium close-up |
+| เห็นทั้งตัวและสถานที่ | wide shot |
+| มองข้ามไหล่คนฟัง | over-the-shoulder shot |
+| กล้องค่อยๆ เข้าใกล้ | slow push-in |
+| กล้องถือ สั่นเล็กน้อย ตึงเครียด | handheld |
+
+### อารมณ์
+
+บรรยายอารมณ์ด้วยสิ่งที่เห็น ไม่ใช่ชื่ออารมณ์อย่างเดียว เช่น `eyes glossy, jaw tight` ดีกว่า `sad and angry`
+
+### สิ่งที่ไม่ต้องการ
+
+ปิดท้ายทุกพรอมต์ด้วย `No subtitles, no captions, no on-screen text.` เพราะโมเดลวิดีโอมักเขียนตัวหนังสือไทยออกมาผิด ซับให้ใส่ตอนตัดต่อ และถ้าไม่ต้องการเพลง ใส่ `no music`
+
+## 4. ปัญหาที่พบบ่อย
+
+| ปัญหา | ลองแก้ |
+|---|---|
+| ตัวละครพูดไทยเพี้ยน หรือพูดเป็นภาษาอื่น | ตัดบทให้สั้นลง ใช้คำง่ายขึ้น ใส่ "in Thai" ให้ชัด ถ้ายังไม่ได้ เปลี่ยนเป็นวิธี ข. |
+| มีตัวหนังสือมั่วบนจอ | ใส่ประโยคสิ่งที่ไม่ต้องการ ตัดคำบรรยายที่ชวนให้มีตัวหนังสือ เช่น ป้าย หน้าจอโทรศัพท์ หนังสือพิมพ์ ออกจากพรอมต์ ลองเอาเครื่องหมายคำพูดรอบบทพูดออก |
+| หน้าตัวละครเปลี่ยนระหว่างช็อต | ใช้คำบรรยายหน้าตาเดิมทุกตัวอักษร ใช้ภาพอ้างอิง ลดจำนวนตัวละครในช็อต |
+| ปากไม่ตรงเสียง | บทสั้นลง ใช้มุมกว้างขึ้นหรือมุมข้ามไหล่ หรือเปลี่ยนเป็นวิธี ข. |
+| คลิปจบก่อนพูดจบ | บทยาวเกิน (SC08) แบ่งเป็นสองช็อต |
+| ตัวละครพูดบทของอีกคน | แยกช็อตให้มีคนพูดคนเดียว บอกชื่อผู้พูดก่อนบทพูดทุกครั้ง |
+| ภาพดูไม่เป็นไทย | เพิ่มรายละเอียดฉากไทยตามหัวข้อ 3 |

package/skills/script-th/references/voice.md

@@ -0,0 +1,107 @@
+# บทพากย์สำหรับเสียง AI ภาษาไทย
+
+เสียง AI (text-to-speech) อ่านตามตัวอักษรที่เห็น ไม่รู้ว่า "350" ควรอ่านว่าอะไร ไม่รู้ว่า "สระ" ในประโยคนี้คือสระน้ำหรือสระ อ ไม่รู้ว่าตัวละครกำลังโกรธหรือกระซิบ บทพากย์ที่ดีจึงต้อง **เขียนสิ่งที่อยากให้ได้ยิน ไม่ใช่สิ่งที่อยากให้เห็น**
+
+## 1. ความยาว
+
+บทที่ยาวเกินคลิปทำให้เสียงพูดเร็วผิดธรรมชาติ หรือถูกตัด นับพยางค์ก่อนส่งให้ AI อ่าน
+
+**วิธีประมาณ (ใช้เป็นจุดเริ่ม แล้วฟังผลจริง):**
+
+- เวลาที่พูดได้ = ความยาวคลิป ลบ 1.5 วินาที (เผื่อช่วงเงียบต้นและท้ายคลิป)
+- พูดปกติ ประมาณ 4 พยางค์ต่อวินาที พูดเร็วหรือโกรธ ประมาณ 5 พูดช้าหรือเศร้า ประมาณ 3
+
+| ความยาวคลิป | เวลาที่พูดได้ | พยางค์โดยประมาณ (พูดปกติ) |
+|---|---|---|
+| 5 วินาที | 3.5 วินาที | ไม่เกิน 14 |
+| 8 วินาที | 6.5 วินาที | ไม่เกิน 26 |
+| 10 วินาที | 8.5 วินาที | ไม่เกิน 34 |
+
+ตัวเลขชุดนี้เป็นค่าประมาณ ความเร็วจริงขึ้นกับเสียงที่เลือกและการตั้งค่าของเครื่องมือ ให้ผู้ใช้ลองฟังช็อตแรก แล้วปรับจำนวนพยางค์ตามนั้นทั้งเรื่อง
+
+**นับพยางค์:** หนึ่งพยางค์คือหนึ่งเสียงสระ เช่น "สามปีนะ" = 3 พยางค์ "กินข้าวยัง" = 3 พยางค์ ตัวเลขและตัวย่อนับตามที่อ่านออกเสียง เช่น "350" = "สามร้อยห้าสิบ" = 4 พยางค์
+
+## 2. ตัวเลข
+
+เขียนเป็นคำตามที่ต้องการให้อ่าน
+
+| เขียนแบบนี้ AI อาจอ่านผิด | เขียนในบทพากย์ |
+|---|---|
+| 350 บาท | สามร้อยห้าสิบบาท |
+| 081-234-5678 | ศูนย์ แปด หนึ่ง สอง สาม สี่ ห้า หก เจ็ด แปด |
+| 14:30 น. | บ่ายสองโมงครึ่ง |
+| 2569 (ปี) | สองพันห้าร้อยหกสิบเก้า |
+| 1.5 | หนึ่งจุดห้า |
+| 50% | ห้าสิบเปอร์เซ็นต์ |
+| ห้อง 302 | ห้องสามศูนย์สอง (หรือ สามร้อยสอง ตามที่ตัวละครพูด) |
+| ที่ 1 | ที่หนึ่ง |
+
+## 3. ตัวย่อ เครื่องหมาย และอีโมจิ
+
+| เขียนแบบนี้ | เขียนในบทพากย์ |
+|---|---|
+| กทม. | กรุงเทพ |
+| ฯลฯ | และอื่นๆ |
+| ดร. | ดอกเตอร์ |
+| รพ. | โรงพยาบาล |
+| & | และ |
+| / | หรือ (ตามความหมาย) |
+| 555 | ใส่ทิศทางเสียง (หัวเราะ) แทน หรือเขียน ฮ่าๆ |
+| อีโมจิ | ลบออก |
+
+ไม้ยมก (ๆ) เสียง AI ส่วนใหญ่อ่านได้ ถ้าเครื่องมือที่ใช้อ่านผิด ให้เขียนคำซ้ำเต็ม เช่น "ช้าๆ" เป็น "ช้า ช้า"
+
+## 4. คำอังกฤษ ชื่อ และคำอ่านยาก
+
+- **คำอังกฤษที่ตัวละครพูด** เขียนเป็นภาษาไทยตามเสียงที่ต้องการ เช่น "meeting" เป็น "มีตติ้ง" "OK" เป็น "โอเค"
+- **ชื่อคนและชื่อสถานที่** ที่อ่านได้หลายแบบ เขียนตามเสียง เช่น "ณัฐ" เป็น "นัด" "พิษณุโลก" ส่วนใหญ่อ่านถูก ไม่ต้องแก้ ฟังก่อนแล้วค่อยแก้เฉพาะคำที่ผิด
+- **คำพ้องรูป** (เขียนเหมือนกัน อ่านต่างกัน) เช่น เพลา (เพ-ลา / เพลา) สระ (สะ / สะ-หระ) เสลา (สะ-เหลา / เส-ลา) ถ้า AI อ่านผิด ให้เขียนตามเสียง หรือเปลี่ยนเป็นคำอื่น
+- คำที่เขียนตามเสียงใส่เฉพาะช่อง "ข้อความให้ AI อ่าน" ส่วนช่องซับให้คงตัวสะกดที่ถูกต้อง
+
+## 5. จังหวะ
+
+| ต้องการ | เขียน |
+|---|---|
+| หยุดสั้น | เว้นวรรค |
+| หยุดยาว | ขึ้นประโยคใหม่ หรือขึ้นบรรทัดใหม่ |
+| ลังเล ลากเสียง | ... (บางเครื่องมืออ่านเป็นช่วงเงียบ บางเครื่องมือข้าม ให้ลองฟัง) |
+
+- ประโยคยาวมาก เสียง AI จะอ่านราบเรียบเหมือนอ่านข่าว แบ่งเป็นประโยคสั้น
+- เครื่องมือบางตัวหยุดตามเครื่องหมายจุลภาค ใช้ในบทพากย์ได้ถ้าเครื่องมือนั้นได้ผล แต่อย่าใส่ในซับ
+
+## 6. อารมณ์และทิศทางเสียง
+
+- ใส่ทิศทางเสียงในวงเล็บแยกจากข้อความ เช่น `(กระซิบ)` `(เสียงสั่น พูดช้า)` `(ตะโกน)` เพื่อให้ผู้ใช้ตั้งค่าเสียงหรือเลือกเสียงให้ตรง
+- เครื่องมือบางตัวรับคำสั่งอารมณ์ในข้อความได้ เช่น แท็กภาษาอังกฤษในวงเล็บเหลี่ยม ให้ใช้ตามคู่มือของเครื่องมือนั้น ถ้าผู้ใช้บอกชื่อเครื่องมือ และอย่าใส่แท็กในเครื่องมือที่ไม่รองรับ เพราะจะถูกอ่านออกเสียง
+- ไม่ใช้ "!" บอกอารมณ์ด้วยคำลงท้าย (นะ สิ เถอะ เลย) ทิศทางเสียง และการตั้งค่าความเร็ว
+- คำลงท้ายช่วยให้เสียง AI มีอารมณ์ขึ้น เช่น "ไปเถอะ" ฟังอ่อนกว่า "ไป" แต่อย่าใส่ทุกประโยค
+
+## 7. เสียงของตัวละคร
+
+- เลือกเสียงให้ตรงกับเพศ อายุ และคำลงท้ายของตัวละคร ตัวละครที่พูด "ค่ะ" ต้องใช้เสียงผู้หญิง เว้นแต่เรื่องตั้งใจให้ต่าง
+- ใช้เสียงเดิมกับตัวละครเดิมทุกตอน
+- จดชื่อเสียงหรือค่าที่ตั้งไว้ในตารางตัวละคร เพื่อใช้ซ้ำ
+
+## 8. รูปแบบบทพากย์
+
+```
+| ช็อต | ตัวละคร | ทิศทางเสียง | ข้อความให้ AI อ่าน | ข้อความขึ้นซับ | พยางค์ / เวลา |
+|---|---|---|---|---|---|
+| 3 | มะลิ | เสียงสั่น พูดช้า | สามปีนะ สามปีที่ฉันเชื่อนายทุกคำ | สามปีนะ สามปีที่ฉันเชื่อนายทุกคำ | 11 / 8 วินาที |
+| 4 | ต้น | เบา เลี่ยงสายตา | ผมโอนให้แล้ว สามหมื่นห้า | ผมโอนให้แล้ว 35,000 | 7 / 5 วินาที |
+```
+
+- ถ้าข้อความให้ AI อ่านกับข้อความขึ้นซับเหมือนกันทั้งเรื่อง ตัดช่องซับออกได้
+- ใต้ตารางใส่ `หมายเหตุ:` สำหรับคำที่เขียนตามเสียง และช็อตที่พยางค์เกินกำหนด
+
+## 9. หลังฟังผล
+
+ถ้าผู้ใช้บอกว่า AI อ่านผิดหรือฟังไม่ดี ให้แก้ตามนี้
+
+| อาการ | แก้ |
+|---|---|
+| อ่านคำผิด | เขียนตามเสียง หรือเปลี่ยนเป็นคำอื่นที่ความหมายเดียวกัน |
+| พูดเร็วเกิน | ตัดคำ หรือแบ่งช็อต |
+| ฟังเหมือนอ่านข่าว | แบ่งประโยคให้สั้น เพิ่มคำลงท้าย ใส่ทิศทางเสียง |
+| หยุดผิดที่ | ย้ายการเว้นวรรค หรือแยกประโยค |
+| อารมณ์ไม่ออก | ปรับทิศทางเสียง เลือกเสียงอื่น หรือเขียนบทให้อารมณ์อยู่ในคำ ไม่ใช่ในเครื่องหมาย |