คู่มือห้องเขียนบท

1. เข้าใจสถานะก่อนแก้

Active Revisionบทที่ระบบใช้งานจริงในหน้า Episode และขั้นตอนสร้าง Veo/VDO จะไม่เปลี่ยนจนกด Activate สำเร็จ

Working Draftสำเนาสำหรับแก้ไข ช่วยให้ทดลองแก้ชื่อเรื่อง Logline ฉาก Action และ Dialogue ได้โดยไม่กระทบ Active Revision

Checkpointจุดบันทึกชื่อกำกับสำหรับย้อนดูงานระหว่างทาง ไม่ใช่การ Publish และไม่เปลี่ยน Active Revision

Candidateทางเลือกที่ AI สร้าง สามารถ Compare, Expand หรือ Apply เข้า Working Draft ก่อนตัดสินใจ

Semantic Diffสรุปว่าเนื้อเรื่องเปลี่ยนอะไร เช่น ชื่อเรื่อง จำนวนฉาก การเรียงฉาก ตัวละคร และบทพูด แทนการโยน raw JSON ให้ผู้ใช้

Forkสร้าง Episode/Revision ใหม่เมื่อต้นฉบับมี Veo หรือ VDO โดยเก็บสื่อไว้ที่ Episode ต้นทาง และไม่คัดลอก URL/Task ID ของสื่อไป Episode ใหม่

หลักความปลอดภัย: ทุกการ Save ใช้ draft_version และทุกการ Activate ใช้ revision/hash/timestamp เดิมเป็น CAS ถ้าข้อมูลเปลี่ยนระหว่างทาง ระบบต้องหยุดและให้ Reload

2. เปิดห้องเขียนบท

เข้าสู่ระบบและเปิดโปรเจกต์ที่มี Episode อย่างน้อยหนึ่งตอน
ที่การ์ด Episode กด คิดบทใหม่ / ห้องเขียนบท แยกจากปุ่มเปิด Episode
ตรวจชื่อ Episode, Active Revision และสถานะ Worker ด้านบนก่อนเริ่ม
เลือกแท็บ แก้บท, AI เสนอ 5 ทาง, เปรียบเทียบ หรือ ประวัติ

เปิด Script Workbench ซึ่งแสดง Episode, Active Revision, Working Draft และแท็บทั้งสี่ — หน้า Workbench ต้องเห็น Episode, Active Revision, Working Draft และ 4 แท็บชัดเจน

3. แก้และบันทึก Working Draft

เปิดแท็บ แก้บท ระบบจะสร้างหรือโหลด Working Draft ของ Episode นี้
เลือกฉากจาก Scene Spine ด้านซ้าย แล้วแก้ Title, Location, Time, Action หรือ Dialogue ตรงกลาง
เมื่อมีการแก้ สถานะจะเปลี่ยนเป็น ยังไม่บันทึก และเลข Draft Version ยังไม่เพิ่ม
กด บันทึกตอนนี้ หรือรอ autosave; เมื่อ API ยืนยันแล้วจึงขึ้น บันทึกแล้ว และ Version เพิ่ม
หากพิมพ์ต่อขณะที่ขึ้น กำลังบันทึก… ระบบต้องเก็บข้อความใหม่ไว้ในหน้าและส่ง Autosave รอบถัดไป ห้ามนำ response รอบก่อนมาทับข้อความใหม่
เปิด Episode เดิมอีกครั้งเพื่อยืนยันว่า Active Revision ยังไม่เปลี่ยนจนกว่าจะ Activate

Working Draft ที่พร้อมแก้ไขและมี scene UID คงที่ — Working Draft ที่สร้างจาก Active Revision พร้อม scene_uid คงที่

แก้ข้อมูลฉากแล้วสถานะ Working Draft เป็นยังไม่บันทึก — แก้ Action หรือ Dialogue แล้วเห็นสถานะยังไม่บันทึก

Working Draft บันทึกสำเร็จและเลข Draft Version เพิ่ม — หลัง Save สำเร็จต้องเห็น Draft Version ใหม่และ Active Revision เดิม

4. Checkpoint, Undo และ Redo

สร้าง Checkpoint ก่อน Apply Candidate หรือก่อนเปลี่ยนหลายฉาก จะย้อนตรวจได้ง่ายกว่าพึ่ง Undo อย่างเดียว

ประวัติ Checkpoint แสดงชื่อกำกับ เวอร์ชัน แฮช และเวลา — Checkpoint แสดง label, version, script hash และเวลา

5. ให้ AI เสนอ Episode ถัดไป 5 แบบ

เปิดแท็บ AI เสนอ 5 ทาง แล้วตรวจว่า Anchor Episode ถูกตอน
กรอกสิ่งที่ต้องมี สิ่งที่ห้ามมี และคำสั่งเพิ่มเติม เช่น “เริ่มจาก end_state เดิม แต่เปลี่ยนต้นเหตุของความขัดแย้ง”
กด เสนอ Episode ถัดไป 5 ทาง เพียงครั้งเดียว ระบบจะส่ง durable job ชนิด script_outline_set
ปิด Modal, ปิด Tab หรือปิด Browser ได้ Worker จะทำงานต่อ
กลับมาเปิด Workbench แล้วเลือก Generation Round ที่ถูกต้อง ต้องเห็น Candidate 5 ใบจาก round เดียวกันเท่านั้น

อย่ากดซ้ำเมื่อยัง Queued/Running: ดู Job ID และ Pair ID ก่อน ระบบมี idempotency แต่การกดซ้ำด้วยคำสั่งใหม่อาจสร้างค่าใช้จ่ายเพิ่ม

แบบฟอร์ม AI เสนอห้าทางพร้อมคำสั่ง สิ่งที่ต้องมี และสิ่งที่ห้ามมี — คำสั่ง, must-use, must-avoid และปุ่มส่งงานพื้นหลัง

ผลลัพธ์ Candidate ห้าทางใน Generation Round เดียวกัน — ห้า Candidate ต้องต่างกันด้าน conflict, setting, twist และ ending และอยู่ใน Variant Set เดียวกัน

6. Semantic Compare และเลือกทาง

เปิด Candidate แล้วกด เปรียบเทียบ เพื่อดูข้อมูลที่คนเขียนบทใช้ตัดสินใจ ไม่ใช่ raw JSON:

หัวข้อ	ต้องตอบคำถามอะไร
Logline / Conflict	แรงขับของตอนต่างจากทางอื่นจริงหรือเพียงเปลี่ยนถ้อยคำ
Beats / Scene changes	เพิ่ม ลบ ย้าย หรือแก้ฉากใด และจังหวะเรื่องเปลี่ยนอย่างไร
Character delta	ตัวละครตัดสินใจหรือเปลี่ยนสภาวะอะไรเมื่อจบตอน
Continuity	เริ่มจาก `end_state` ของ Anchor Episode ถูกต้องหรือไม่
Ending / Payoff	จบแบบเฉลย ค้างคา หักมุม หรือส่ง setup ไปตอนใด

เลือก Candidate สองใบจาก Generation Round เดียวกัน
อ่าน Summary และรายการเปลี่ยนระดับ Field/Scene
ถ้าเป็น Outline ให้กด ขยายเป็นบทเต็ม และรอ Worker จบก่อน Apply
กด นำเข้า Working Draft; ระบบยังไม่ Activate และเก็บ Candidate อื่นไว้เลือกภายหลัง

Semantic Compare แสดงความต่างของ Candidate แบบอ่านง่าย — เปรียบเทียบ Summary, fields และ scenes แบบอ่านง่าย

Candidate ถูกนำเข้า Working Draft โดยยังไม่เปลี่ยน Active Revision — หลัง Apply ต้องเห็น source candidate, Draft Version ใหม่ และ Active Revision เดิม

7. Validate ก่อน Activate

กด ตรวจบท หลัง Save ล่าสุด ระบบจะตรวจโครงสร้าง Episode, scene_uid, ตัวละคร, continuity และข้อบังคับที่พิสูจน์แบบ deterministic ได้

ผ่าน: lifecycle เป็น validated และปุ่ม Activate พร้อมใช้
ไม่ผ่าน: Working Draft ยังเปิดอยู่ แก้รายการ Error แล้ว Save + Validate ใหม่
คำแนะนำเชิงศิลป์จาก AI ไม่ควรถูกแสดงเป็น deterministic PASS

ผลตรวจบทแยกข้อผิดพลาดบังคับจากคำแนะนำเชิงสร้างสรรค์ — Validation แยก Error ที่บังคับจากคำแนะนำเชิงสร้างสรรค์

8. Activate หรือ Fork

สร้าง Checkpoint และตรวจว่า Draft Version ปัจจุบัน Validate ผ่าน
ตรวจ Semantic Diff รอบสุดท้าย แล้วกด Activate Draft
ถ้า Episode ไม่มี Veo/VDO ระบบสร้าง Active Revision ใหม่และเก็บ Revision เก่าไว้ใน History
ถ้ามี Veo/VDO ระบบต้องหยุดด้วย media_requires_fork และแสดงปุ่ม Fork Draft
กด Fork เมื่อยืนยันว่าจะสร้าง Episode ใหม่ สื่อของ Episode ต้นทางต้องไม่ถูกลบหรือย้าย และ Episode ใหม่ต้องไม่มี video URL/task ID ของต้นทางติดไป

ผลที่ถูกต้อง: Activate/Fork เปลี่ยน Working Draft เป็น applied; การ Restore Revision เก่าต้องสร้าง Revision ใหม่ ไม่ลบประวัติ

หน้าต่าง Activate หรือ Fork พร้อมคำเตือนการรักษาสื่อเดิม — คำเตือน Fork ต้องบอกชัดว่าสื่อเดิมจะถูกรักษา

ประวัติ Active Revision Archived Revision และ Checkpoint ตามเวลา — History แสดง Active, archived revisions และ checkpoints ตามเวลา

9. แก้ Stale Draft / สอง Tab ชนกัน

ถ้า Tab A บันทึก Version ใหม่ก่อน Tab B คำขอจาก Tab B ต้องได้ HTTP 409 draft_version_conflict ไม่ใช่เขียนทับงานล่าสุด

หยุดพิมพ์ใน Tab ที่ขึ้น Conflict
คัดลอกข้อความที่ยังไม่บันทึกไว้ชั่วคราวถ้าจำเป็น
กด โหลด Draft ล่าสุด
เทียบความต่าง นำเฉพาะการแก้ที่ต้องการกลับมา แล้ว Save ใหม่

ห้ามแก้ conflict ด้วยการลด Version หรือส่ง request เดิมซ้ำจาก DevTools เพราะจะทำลายหลักฐานลำดับการแก้

10. งานพื้นหลังและหลักฐาน

Next 5 และการ Expand Candidate ใช้ durable worker ปิดเว็บได้ เมื่อกลับมาเปิดให้ตรวจหน้า Jobs และ Evidence strip:

Job status ต้องเป็น Completed และ Progress 100
Request ID, Pair ID, Mode Hash และ Text Hash ต้องตรงระหว่าง UI กับ API
Generation Round ต้องไม่รวม Candidate จากรอบอื่น
ส่วนเขียนบทไม่มีขั้น Audio จึงต้องแสดง Audio: N/A ไม่ใช่สร้างหลักฐานเสียงปลอม

11. Troubleshooting

ปุ่ม Save ใช้ไม่ได้

ตรวจว่ามี Working Draft, scene_uid ไม่ซ้ำ และไม่มีงาน Save ก่อนหน้าค้างอยู่ หากเป็น Conflict ให้ Reload Draft แทนการกดซ้ำ

Next 5 ไม่ครบห้าใบ

ตรวจ Job terminal response และเลือก Variant Set ที่ถูกต้อง ระบบ final acceptance ต้องมี Candidate ID ไม่ซ้ำกัน 5 ค่า ห้ามรวมของเก่ามาเติมให้ครบ

Candidate Apply ไม่ได้

ต้อง Expand เป็น full draft, status ready และ candidate ต้องผูกกับ project/episode/base revision เดียวกับ Working Draft

Validate ผ่านแต่ Activate 409

ถ้า code เป็น draft_version_conflict หรือ draft_base_mismatch ให้ Reload; ถ้าเป็น media_requires_fork ให้ใช้ Fork เพื่อรักษาสื่อ

ปิด Browser แล้วงานหาย

เปิด Jobs ตรวจ Worker Online และ Job ID เดิม งานที่ submit สำเร็จต้อง recover จากฐานข้อมูล ไม่ควรสร้าง Job ใหม่ทันที

12. เกณฑ์ทดสอบ UI+API

ห้ามประกาศ PASS จากภาพอย่างเดียวหรือ API อย่างเดียว แต่ละ Testcase ต้องมี:

ภาพ UI จริง 5 ขั้น: 01_open_page, 02_input_ready, 03_click_generate, 04_result_state, 05_audio_ready_or_error
request.json, response.json, timing.json จาก Playwright browser network จริง
Sidecar ของทุกภาพที่ผูก SHA-256, viewport, URL, เวลา และ 4 identity fields
Pair completeness 100%, pair consistency 100%, checks ผ่านทั้งหมด และ critical errors 0

Testcase	สิ่งที่พิสูจน์
`TC_P0_DRAFT_SAVE_001`	แก้ระหว่าง Save ที่กำลังทำงาน แล้วคิว Autosave รอบถัดไปโดยไม่ทำข้อความหาย; Active เดิมไม่เปลี่ยน
`TC_P0_CHECKPOINT_ACTIVATE_002`	Checkpoint + Validate + Activate
`TC_P0_BACKGROUND_NEXT5_003`	Next 5 ทำต่อหลังปิด Browser
`TC_P0_APPLY_CANDIDATE_004`	Apply Candidate เข้า Draft
`TC_P0_SEMANTIC_COMPARE_005`	Semantic Compare ไม่ใช่ raw JSON
`TC_P0_STALE_CONFLICT_006`	Stale version ถูกปฏิเสธ
`TC_P0_MEDIA_FORK_007`	Fork รักษา Media ที่ต้นทางและไม่คัดลอก media binding ไปตอนใหม่
`TC_P0_MANUAL_HTML_008`	คู่มือเปิดได้และ probe identity ตรงกัน
`TC_P0_CHECKPOINT_RESTORE_009`	ย้อน Checkpoint เข้า Working Draft โดย Active Revision เดิมไม่เปลี่ยน
`TC_P0_REVISION_RESTORE_010`	Restore Revision ขณะมี Draft เปิดแล้วปิด Draft ฐานเก่าอย่างปลอดภัย

ทางลัด

กลับหน้า Director Studio · คู่มือหลัก · Script Authoring evidence probe

Security: ห้ามวาง MiniMax key, JWT, Authorization, Cookie หรือ browser storage state ในภาพ คู่มือ รายงาน หรือ Git