คู่มือ CLI Skill

ภาพรวมฟังก์ชัน NadouPro CLI

เอกสารนี้สำหรับผู้ใช้และ Agent ที่ใช้ NadouPro CLI ครอบคลุมการติดตั้ง การเข้าสู่ระบบ การค้นหาโมเดล การสร้างเนื้อหา การส่งมอบงาน การจัดการพื้นที่ การประมวลผลสื่อในเครื่อง และการทำงานกับ Canvas ความสามารถของ CLI เปลี่ยนตามเวอร์ชัน บัญชี และสถานการณ์ ให้ยึด nadou capability list --json ผลที่คำสั่งคืน และผลลัพธ์จริง

คำแนะนำ

หลังติดตั้งหรืออัปเกรด ให้รัน nadou version --json และ nadou capability list --json ก่อน เพื่อยืนยันเวอร์ชันปัจจุบันและความสามารถที่ใช้ได้

ข้อควรระวัง

การทำงานที่เกี่ยวกับการเขียน การสร้าง การลบ หรือการทับ ให้ยึดหลัก “ส่งครั้งเดียว ไม่รีทรายอัตโนมัติ เมื่อผลไม่ชัดให้สอบถามงานเดิม” อย่าแชร์หรือบันทึก Cookie, token, Authorization หรือข้อมูลรับรองการเข้าสู่ระบบอื่น

1. เริ่มต้นอย่างรวดเร็ว

1.1 ติดตั้ง

ต้องการ Node.js 16 หรือใหม่กว่า แนะนำติดตั้งจากคลัง npm สาธารณะ:

คำสั่งติดตั้งประโยคเดียว: ช่วยติดตั้ง NadouPro CLI: npm install -g @iqiyi-intl-nadoupro/nadou-cli หลังติดตั้งแล้วรัน nadou version --json เพื่อตรวจ

npm exec --yes --registry=https://registry.npmjs.org/ --package=@iqiyi-intl-nadoupro/nadou-cli@latest -- nadou-install
nadou version --json
nadou skill install --json
nadou skill read --json

ติดตั้งแบบโกลบอลก็ได้:

npm install -g @iqiyi-intl-nadoupro/nadou-cli
nadou version --json

ปัจจุบันรองรับ Windows x64, Linux x64/arm64 และ macOS x64/arm64 npm เลือก dependency ของแพลตฟอร์มให้อัตโนมัติ หากปิด optional dependencies ตอนติดตั้ง ให้ติดตั้งใหม่ด้วยวิธีปกติ

1.2 ตรวจอัปเดตและอัปเกรด

nadou version --check --json
nadou update --json --no-interactive
nadou version --json

หลังอัปเกรด แนะนำรัน nadou skill install --json อีกครั้ง เพื่อให้ Skill ในเครื่องตรงกับเวอร์ชัน CLI

1.3 ตั้งค่าและเข้าสู่ระบบ

การเข้าสู่ระบบจะเปิดหน้าเข้าสู่ระบบฉบับระหว่างประเทศในเบราว์เซอร์ระบบ คลิก “Continue to international sign in” แล้วทำตามวิธีที่หน้าแสดงเพื่อเข้าสู่ระบบด้วยบัญชีไซต์ระหว่างประเทศ Profile เก็บการตั้งค่าที่ไม่ละเอียดอ่อน เช่น พื้นที่และหมดเวลา เซสชันเข้าสู่ระบบเก็บในคลังข้อมูลรับรองของระบบในเครื่อง การตั้งค่าท้องถิ่นและเซสชันของฉบับระหว่างประเทศเก็บแยกกัน หลังติดตั้งฉบับระหว่างประเทศต้องตรวจสถานะการเข้าสู่ระบบของฉบับนั้น

nadou auth login --profile <profile>
nadou auth status --profile <profile> --json
nadou auth whoami --profile <profile> --json

แทน <profile> ด้วยชื่อ Profile ที่เครื่องนี้ใช้จริง หากใช้ Profile เริ่มต้น ละเว้นพารามิเตอร์นี้ได้ตามคำแนะนำของ CLI อย่าคัดลอก วาง หรือบันทึก Cookie, token และ Authorization ด้วยมือ

เข้าสู่ระบบในโหมดเซิร์ฟเวอร์

เซิร์ฟเวอร์ คอนเทนเนอร์ หรือสภาพแวดล้อมที่ไม่มีส่วนติดต่อแบบกราฟิกอาจเปิดเบราว์เซอร์ในเครื่องหรือเข้าถึงที่เก็บข้อมูลรับรองของระบบปฏิบัติการไม่ได้ ในสภาพแวดล้อมเหล่านี้ ให้ใช้การเข้าสู่ระบบในโหมดเซิร์ฟเวอร์แยกต่างหาก:

nadou auth login --server --profile <profile>
nadou auth status --profile <profile> --json
nadou auth whoami --profile <profile> --json

CLI จะแสดง URL สำหรับเข้าสู่ระบบและรหัสยืนยันในเทอร์มินัล และรอ 10 นาทีตามค่าเริ่มต้น ผู้ใช้สามารถป้อนรหัสในเบราว์เซอร์บนอุปกรณ์ใดก็ได้ เข้าสู่ระบบ และยืนยันบัญชี หน้าเข้าสู่ระบบรองรับการสลับบัญชีด้วย

โหมดนี้บันทึกข้อมูลรับรองในไฟล์ส่วนตัวของ CLI เพื่อให้โพรเซส CLI ต่าง ๆ ใช้สถานะการเข้าสู่ระบบร่วมกันได้ หากไม่ได้เก็บไดเรกทอรีสถานะไว้อย่างถาวร จะต้องเข้าสู่ระบบใหม่หลังจากคอนเทนเนอร์ถูกทำลาย พฤติกรรมนี้ใช้เฉพาะการเข้าสู่ระบบที่ระบุ --server อย่างชัดเจน ส่วนวิธีเข้าสู่ระบบอื่นยังคงใช้ที่เก็บข้อมูลรับรองของระบบ

1.4 ตรวจก่อนใช้ Agent

เซสชัน Agent อาจใช้ PATH ไดเรกทอรีการตั้งค่า หรือคลังข้อมูลรับรองของระบบต่างจากเทอร์มินัลทั่วไป หากเจอ “หาคำสั่งไม่เจอ” “อ่านการตั้งค่าไม่ได้” หรือ “ยืนยันตัวตนล้มเหลว” ให้รีสตาร์ต Agent ก่อน แล้วรัน:

1. nadou version --json

2. nadou auth status --profile <profile> --json

3. nadou auth whoami --profile <profile> --json

เข้าสู่ระบบใหม่เฉพาะเมื่อยืนยันแล้วว่าสถานะการเข้าสู่ระบบใช้ไม่ได้จริง

หากได้รับ CREDENTIAL_STORE_UNAVAILABLE และเซิร์ฟเวอร์หรือคอนเทนเนอร์ปัจจุบันไม่มีที่เก็บข้อมูลรับรองของระบบ อย่าเรียกใช้การเข้าสู่ระบบแบบเริ่มต้นซ้ำ ให้ใช้คำสั่งนี้แทน:

nadou auth login --server --profile <profile>

2. ภาพรวมความสามารถและข้อตกลงร่วม

2.1 ผิวคำสั่ง

โดเมนความสามารถ	คำสั่งหลัก	หน้าที่
ระบบและ Skill	version, update, config, doctor, skill, capability	เวอร์ชัน การตั้งค่า การวินิจฉัย การซิงค์ Skill และการค้นหาความสามารถ
ตัวตนและพื้นที่	auth, points, space	เข้าสู่ระบบ คะแนน พื้นที่ ไดเรกทอรี และเป้าหมายการส่งมอบ
โมเดลและการสร้าง	model, text, image, video, material	ค้นหาโมเดล งานข้อความ/รูป/วิดีโอ และการจัดการวัสดุ
งานและการส่งมอบ	task, schedule, evidence	ประเมิน ส่ง สังเกต ดาวน์โหลด ตั้งเวลา รายงาน และหลักฐานการตรวจรับ
Canvas	canvas	แคนวาส Graph โหนด เส้นเชื่อม Timeline และการส่งออกชิ้นสุดท้าย
สื่อในเครื่อง	media	ประมวลผลไฟล์ในเครื่อง ไม่ทดแทนงานสร้างฝั่งเซิร์ฟเวอร์

คำสั่งครบและขอบเขตที่เปิดอยู่ตอนนี้ให้ยึด nadou capability list --json ความสามารถรายการเดียวใช้ nadou capability describe <command> --json เพื่อดูหน้าที่ ข้อจำกัด ความไม่พร้อมกัน และคำสั่งตัวอย่าง

2.2 เอาต์พุตและพารามิเตอร์โกลบอล

คำสั่งทั้งหมดรองรับเอาต์พุต --json ที่เสถียร การสังเกตนาน สตรีมเหตุการณ์ และเนื้อหาไดเรกทอรีแบบเรียกซ้ำใช้ --jsonl ได้ พารามิเตอร์โกลบอลที่ใช้บ่อย ได้แก่ --profile, --timeout, --trace-id, --no-interactive และ --yes

• --json: คืนผลโครงสร้างที่โปรแกรมประมวลผลได้

• --jsonl: พิมพ์เหตุการณ์หรือผลเรียกซ้ำทีละบรรทัด เหมาะกับการสังเกตต่อเนื่อง

• --no-interactive: ปิดพรอมต์โต้ตอบ ไม่ได้หมายถึงการยืนยันค่าใช้จ่าย

• --yes: ยืนยันการลบ ทับไฟล์ และการทำงานทำลาย ไม่ได้หมายถึงการอนุญาตค่าใช้จ่าย

• --trace-id: ใช้เชื่อมข้อมูลไล่ปัญหาของเวิร์กโฟลว์หนึ่งครั้ง ไม่ใช่ task ID หรือคีย์อำนาจซ้ำ

2.3 ขอบเขต Profile พื้นที่ และโปรเจกต์

Profile เก็บการตั้งค่าที่ไม่ละเอียดอ่อน เช่น สภาพแวดล้อม ที่อยู่เกตเวย์ หมดเวลา โหมดยืนยันตัวตน พื้นที่เริ่มต้น และโมเดลเริ่มต้น บริบทพื้นที่ โมเดล และ Canvas ต้องค้นหาและเลือกแยกกัน การสลับพื้นที่จะไม่สร้างหรือกู้การผูกโปรเจกต์อื่นโดยนัย

2.4 การกำหนดเส้นทางสถานการณ์

สถานการณ์	ตัวรับที่แนะนำ	จุดปฏิบัติ
ข้อความ รูป วิดีโอ หรือความสามารถอะตอมอื่นเพียงรายการเดียว	งานอะตอม	ยืนยันพารามิเตอร์ พื้นที่เป้าหมาย สิทธิ์ และการใช้โดยประมาณก่อนส่ง
หลายวัสดุ หลายขั้น ความสอดคล้องตัวละคร MV โฆษณา หรือหนังสั้น	พื้นที่/ไดเรกทอรีเป้าหมาย + Canvas	ระบุบัญชี พื้นที่ และไดเรกทอรีก่อน จบบทหรือสตอรี่บอร์ดแล้วค่อยเข้าขั้นต้นทุนสูง
แก้ Canvas ที่มีอยู่	อ่านและแก้ Canvas เดิม	อ่านแคนวาสสดก่อนเขียน แล้วอ่านกลับหลังเขียน หากทับ ลบ หรือชนกัน ให้ยืนยันก่อน
สร้างตามเวลา	โหมดตั้งเวลาที่ CLI เปิดอยู่ตอนนี้	ยืนยันเวลา โซนเวลา บัญชี พื้นที่ และการใช้โดยประมาณก่อนสร้าง

เมื่อผู้ใช้กล่าวถึง NadouPro ข้อความ รูป วิดีโอ วัสดุ พื้นที่ แคนวาส โหนด รูปอ้างอิง เฟรมแรก/ท้าย อย่างชัดเจน ให้ใช้ Nadou Skill เป็นหลัก หาก CLI ปัจจุบันไม่รองรับความสามารถนั้น ให้บอกชัด อย่าทดแทนด้วยความสามารถใกล้เคียง

3. ค้นหาโมเดลและสร้างเนื้อหา

3.1 ค้นหาโมเดลและสถานการณ์ก่อน

nadou model list --type image --json
nadou model list --type video --json
nadou model family "<ชื่อที่แสดงของโมเดล>" --json
nadou model scenarios "<model-id>" --json
nadou model get <model-id> --json
nadou model schema <model-id> --json
nadou model use image <image-model> --profile <profile>
nadou model use video <video-model> --profile <profile>

ชื่อที่แสดง พารามิเตอร์ และสถานการณ์ที่ใช้ได้มาจากแค็ตตาล็อกฝั่งเซิร์ฟเวอร์ อย่าเดาชื่อโมเดลใน Agent หรือสคริปต์ อ่านสถานการณ์หรือ Schema ก่อน แล้วจึงส่งพารามิเตอร์ที่ตรงกัน

3.2 ความสามารถในการสร้างและสถานการณ์

คำสั่ง	สถานการณ์ที่ใช้บ่อย	อินพุตสำคัญ
nadou text	text2text, image_to_text	พรอมต์ รูปอ้างอิง HTTPS ที่เลือกได้
nadou image	text2img, image_ref, panorama, three_view, inpaint	พรอมต์ รูปอ้างอิง มาสก์ สัดส่วน ความละเอียด จำนวน
nadou video	text2video, first_last_frame, multi_reference, video_edit, motion_control	พรอมต์ ความยาว สัดส่วน ความละเอียด วิดีโอ/รูป/เสียงอ้างอิง

พรอมต์ให้ผ่าน --prompt, --prompt-file หรือ --stdin ได้ สูงสุด 1 MiB และต้องเป็น UTF-8 ที่ถูกต้อง เมื่อ Agent ใช้ --json, --jsonl หรือ --no-interactive ต้องระบุแหล่งพรอมต์อย่างชัดเจน หลังพรีวิวและยืนยันค่าใช้จ่าย การสร้างจริงต้องมี --submit เงื่อนไขของพารามิเตอร์ตำแหน่งให้ยึดความช่วยเหลือของคำสั่ง --dry-run สร้างและตรวจคำขอเท่านั้น ไม่ส่งงาน รูปและวิดีโอส่งโดยไม่รอเป็นค่าเริ่มต้น ใช้ --wait จึงจะสังเกตความเสร็จในคำสั่งเดียวกัน

CLI ปัจจุบันไม่มีคำสั่งสร้างเสียง AI อิสระ งานวิดีโออาจใช้เสียงอ้างอิง การตั้งค่าเสียง หรือพารามิเตอร์คงเสียงต้นตามสถานการณ์ แต่ไม่เท่ากับการสร้างเสียงอิสระ

3.3 ค่าใช้จ่าย การยืนยัน และการส่งมอบ

การยืนยันค่าใช้จ่าย

งานที่อาจเกิดค่าใช้จ่าย แนะนำลำดับ “dry-run → สอบถามคะแนน → ประเมิน → อธิบายการใช้โดยประมาณและยืนยัน → ส่งจริง” แม้ยอดคงเหลือว่าง ไม่จำกัด หรือยืนยันชั่วคราวไม่ได้ ก็ห้ามข้ามการประเมิน การอธิบายงบ และการยืนยันสุดท้าย

คำสั่งที่คู่กันมักเป็น nadou points summary, nadou task estimate และ nadou task submit การประเมินไม่ล็อกราคาสุดท้าย ก่อนส่งยังต้องยืนยันตามผลที่คืนจริง

การสร้างรูป/วิดีโออิสระกับการส่งมอบผลเป็นสองขั้น เป้าหมายเริ่มต้นคือไดเรกทอรีรากส่วนตัว พื้นที่ทีม ไดเรกทอรี และนโยบายคัดลอกหรือย้ายต้องระบุชัด CLI ไม่ดาวน์โหลดผลเป็นค่าเริ่มต้น และไม่รันประมวลผลสื่อในเครื่องเป็นค่าเริ่มต้น

4. งาน การตั้งเวลา การส่งมอบ และหลักฐาน

4.1 วงจรชีวิตของงาน

คำสั่งที่ใช้บ่อย ได้แก่ task estimate, task submit, task status, task wait, task events, task outputs, task report, task history, task download, task download-batch และ task terminate

task events ใช้สังเกตต่อเนื่องได้ การดาวน์โหลดเป็นชุดใช้ manifest ที่ทำต่อได้ เหมาะกับงานยาวหรือการส่งมอบหลายผล การส่งงานเขียนไม่รีทรายอัตโนมัติ หากโปรเซสถูกขัด เครือข่ายหมดเวลา หรือถอดรหัสการตอบไม่ได้ ให้สอบถาม task, request หรือบันทึกสถานะเดิมก่อน อย่าสร้างการส่งใหม่เพื่อลองอีกครั้ง

4.2 งานตั้งเวลา

โหมด	วิธีใช้	ข้อจำกัดหลัก
server	สร้างรูป/วิดีโอ หรือบางโหนด Canvas	ไม่รับประกันกำหนดข้อความทั่วไป การจัดการแผน หรือการจัด DAG
local	สร้างรูป/วิดีโอทั่วไป และข้อความอิสระ	ไม่รวม Canvas บริบทโปรเจกต์ หรือ URL อ้างอิงภายนอก

ความสามารถตั้งเวลาต้องเลือก disabled, local หรือ server อย่างชัดเจน และใช้โซนเวลา IANA ก่อนสร้างให้ยืนยันเวลา โซนเวลา บัญชี พื้นที่ และการใช้โดยประมาณ แล้วเลือกโหมดตาม capability ปัจจุบัน

ตัวอย่าง: nadou schedule create --body-file request.json --scheduled-at <time> --timezone <iana-timezone> --max-points <confirmed points cap> ขอบเขตที่รองรับให้ยึดผลที่คำสั่งคืน

4.3 พื้นที่ ไดเรกทอรี และวัสดุ

• space current/list/use: ดูและสลับพื้นที่

• space directory create/list/contents: จัดการไดเรกทอรีและดูเนื้อหา เนื้อหาแบบเรียกซ้ำใช้ --recursive --jsonl ได้

• space file rename: เปลี่ยนชื่อไฟล์อย่างชัดเจน

• space artifact deliver: คัดลอกหรือย้ายผลงานที่เชื่อถือได้ไปยังพื้นที่หรือไดเรกทอรีเป้าหมาย

• material upload: อัปโหลดวัสดุในเครื่อง รองรับอัปโหลดเป็นชิ้นและพารามิเตอร์ลายน้ำที่เลือกได้

• material delete: ลบวัสดุ การลบถาวรต้องใช้ --permanent อย่างชัดเจนและยืนยัน

การอัปโหลดวัสดุไม่เท่ากับการส่งมอบผลงาน และไม่สร้างโหนด Canvas อัตโนมัติ

4.4 หลักฐานการตรวจรับ

evidence generation สร้างหลักฐานในเครื่องแบบมีเวอร์ชันจาก task ID ที่รู้แล้วได้ evidence delivery รวม manifest การดาวน์โหลด ไฟล์สื่อ ผลตรวจทางเทคนิค และการยืนยันโดยคนเป็นหลักฐานส่งมอบได้ evidence validate ตรวจเฉพาะโครงสร้าง เส้นทาง แฮช และการอ้างอิงของหลักฐาน ไม่กระตุ้นรีทราย ดาวน์โหลด ส่งมอบ หรือเขียน Canvas

ผ่านการตรวจทางเทคนิคไม่เท่ากับการตรวจคุณภาพสร้างสรรค์ การส่งมอบจริงแนะนำเก็บเวอร์ชัน task ID request ID ที่ปกปิด แฮชของผล ผลตรวจสื่อ และการยืนยันโดยคนที่จำเป็น อย่าเก็บ token, Cookie หรือ Authorization เต็ม

4.5 การโต้ตอบของ Agent การนำเสนอผล และการกู้คืน

ก่อนส่ง หากบัญชี พื้นที่ ไดเรกทอรี หรือ Canvas ไม่เป็นหนึ่งเดียว ต้องอธิบายตัวเลือกและตำแหน่งบันทึกที่คาดไว้ก่อน หากพารามิเตอร์โมเดล บทบาทเฟรมแรก/ท้าย หรือขนาดงานชุดไม่ชัด ต้องเติมข้อมูลก่อน หากเกี่ยวกับงานชุด ต้นทุนสูง ลบ ทับ ย้าย หรือความขัดแย้งร่วมงาน ต้องอธิบายผลกระทบและได้รับการยืนยันก่อน

• รูป: บอกจำนวนจริง คืนแต่ละผลจริงและเส้นทางพื้นที่

• วิดีโอหรือสื่ออื่น: คืนทางเข้าเล่น/ดาวน์โหลดจริงและเส้นทางพื้นที่ หน้างานหรือภาพย่อทดแทนผลสุดท้ายไม่ได้

• ข้อความ: แสดงเนื้อหาตรง ๆ หากไม่ได้บันทึกลงพื้นที่ ให้อธิบายเหตุผลชัด

• Canvas ที่ซับซ้อน: แสดงผลสุดท้าย เส้นทางพื้นที่ ชื่อ Canvas และทางเข้าจริง และแยกขั้นที่เสร็จกับยังไม่เสร็จ

• สำเร็จบางส่วน: ส่งมอบรายการที่สำเร็จก่อน แล้วลิสต์รายการที่ล้มเหลวและตัวเลือกทำซ้ำแยกกัน อย่าแต่งทั้งออเดอร์ให้ดูสำเร็จหมดหรือล้มเหลวหมด

ข้อควรระวังในการส่งมอบ

เส้นทางพื้นที่และทางเข้าผลจริงเป็นส่วนหนึ่งของข้อมูลส่งมอบ หากไม่มีค่าที่เซิร์ฟเวอร์คืนจริง หรือดาวน์โหลดยังไม่เสร็จ อย่าเรียกเส้นทางในเครื่อง หน้างาน หรือสถานะกลางว่าเป็นผลสุดท้าย

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

5. ประมวลผลสื่อในเครื่อง

nadou media ประมวลผลไฟล์ในเครื่องเท่านั้น ไม่เรียกบริการสร้างผ่านเครือข่าย ไม่แก้ไฟล์อินพุต และปฏิเสธการทับเอาต์พุตที่มีอยู่เป็นค่าเริ่มต้น รองรับตรวจ ปรับมาตรฐาน ต่อ ผสม สกัดเฟรม ตรวจทางเทคนิค ประมวลผลซับไตเติล และมิกซ์เสียงวิดีโอ

พรีเซ็ตมาตรฐานที่ใช้บ่อย ได้แก่ แนวนอน แนวตั้ง และสี่เหลี่ยม 1080p เอาต์พุตทั่วไปคือ MP4/H.264, yuv420p, 30fps, AAC-LC, 48kHz, สเตอริโอ verify เป็นการตรวจทางเทคนิค creative_review_required ในรายงานยังหมายถึงต้องให้คนดู

การประมวลผลสื่อในเครื่องกับ Canvas Timeline/การส่งออกชิ้นสุดท้ายเป็นคนละความสามารถ อันแรกประมวลผลไฟล์ในเครื่อง อันหลังอ่านเขียนไทม์ไลน์ที่ผูกกับ Canvas Graph และรันงานชิ้นสุดท้ายฝั่งเซิร์ฟเวอร์

6. การจัดการ Canvas และ Graph

6.1 หลักการทำงาน

1. อ่านสถานะล่าสุดของแคนวาสเป้าหมายด้วย canvas get ก่อน

2. สร้างการเขียนหนึ่งครั้งตามโหนด เส้นเชื่อม และเลย์เอาต์ปัจจุบัน

3. หลังเขียนให้อ่านอีกครั้ง เพื่อยืนยันสถานะโหนด เส้นเชื่อม และผล

4. หากเจอล็อก ความขัดแย้งร่วมงาน ปัญหาสิทธิ์ หรือผลไม่ชัด ให้หยุดเขียนต่อ ดูสถานะการทำงานเดิมก่อนแล้วอธิบายผลกระทบ

CLI ตรวจฟิลด์ที่เขียนได้ตามชนิดโหนด ผู้ใช้สนใจเฉพาะคำสั่ง อินพุต เอาต์พุต สถานะ และการจัดการข้อผิดพลาด ไม่ต้องประกอบที่อยู่บริการ URL ทรัพยากร หรือสถานะงานเอง

6.2 คำสั่งที่ใช้บ่อย

หมวด	คำสั่ง
วงจรชีวิต	canvas list/create/get/rename/move/delete/restore
อ่าน	canvas get, canvas node list, canvas assets list
Graph	canvas graph mutate
โหนด	canvas node list/create/patch/delete/estimate/generate/wait
เส้นเชื่อม	canvas edge connect/patch/delete
Timeline	canvas media timeline validate/write/read
ชิ้นสุดท้าย	canvas media export prepare/submit/observe

6.3 แคนวาส โหนด และวัสดุ

canvas list ใช้ค้นหาแคนวาสที่เข้าถึงได้ตอนนี้ canvas get ใช้อ่าน Graph สด canvas node list ใช้ดูโหนดตามชนิด canvas assets list ใช้ดูวัสดุย้อนหลังหรือภาพฉายของผล อย่าถือผลรายการเป็นสแนปช็อตสดก่อนเขียน

โหนดสื่อกำหนดเองควรใช้คำสั่งโหนด Canvas สาธารณะ และใช้อินพุตที่เป็นฟิลด์ที่รองรับ เช่น รหัสวัสดุ อย่าปลอม URL, metadata, คอลแบ็ก หรือสถานะงานนอก CLI ความขัดแย้งของแคนวาส ล็อก และล้มเหลวบางส่วนให้จัดการตามข้อความผิดพลาดจริง อย่าสร้างโหนดทดแทนเพื่อปิดปัญหาเดิม

6.4 Timeline และชิ้นสุดท้าย

ไฟล์ Timeline ให้ตรวจออฟไลน์ก่อน แล้วเลือกขั้นตอนชิ้นสุดท้ายตาม capability ปัจจุบัน การเขียน Timeline เตรียมส่งออก ส่ง และสังเกตเป็นงานอิสระต่อกัน แต่ละขั้นทำเพียงครั้งเดียว หากสอบถามสถานะได้กำลังประมวลผล ไม่พบ หรือไม่ทราบ ให้สอบถามการทำงานเดิมต่อเท่านั้น อย่าสลับเส้นทางหรือส่งซ้ำ

ชิ้นสุดท้ายจริงจะเสร็จได้หรือไม่ขึ้นกับโหนด Canvas ที่ใช้ได้ Timeline สถานะงาน และความสามารถที่เปิดอยู่ตอนนี้ เมื่อเผยแพร่หรือส่งมอบ ให้ยึดผลที่คำสั่งคืนจริงและผลสุดท้าย

7. ขอบเขตความสามารถของ CLI ปัจจุบัน

ผิวที่ CLI เปิดอาจเปลี่ยนตามเวอร์ชัน บัญชี และสถานการณ์

เวิร์กโฟลว์เต็มบนหน้าผลิตภัณฑ์ไม่จำเป็นต้องเปิดผ่าน CLI แล้ว เช่น โต๊ะผู้กำกับ การแก้ไขและกำกับรูปเต็ม การจัดการไฟล์โต๊ะทำงาน โต๊ะตัดต่อ การแก้แทร็กเสียง และผู้ช่วยเขียนบท CLI มีคำสั่งประมวลผลรูปบางส่วนแล้ว เช่น image-tool upscale ขอบเขตจริงให้ยึดความช่วยเหลือของคำสั่งปัจจุบันและผลที่คืนจริง หากต้องการความสามารถเหล่านี้ ให้ใช้ทางเข้าผลิตภัณฑ์โดยตรง และยึดหน้าผลิตภัณฑ์กับ capability ปัจจุบันของ CLI

8. หาสาเหตุและส่งคำติชม

8.1 ปัญหาที่พบบ่อย

• หาโหนดแคนวาสไม่เจอ: ใช้ canvas get ดึง Graph สดก่อน แล้วยืนยันว่ารหัสแคนวาส ชนิดโหนด สถานะโหนด และ task ที่ผูกยังใช้ได้อยู่หรือไม่

• คำสั่งสร้างจบก่อนได้ task ID: แปลว่างานยังไม่ได้ส่ง อย่าบรรยายว่า “สร้างล้มเหลว” และอย่าส่งซ้ำ

• หมดเวลาหลังได้ task ID แล้ว: สอบถาม task เดิมต่อ อย่าสร้างใหม่

• ผลเขียน Canvas ไม่ชัด: สอบถามสถานะการทำงานเดิม ยืนยันสถานะแคนวาสสุดท้ายแล้วค่อยตัดสินขั้นถัดไป

• Agent มองไม่เห็นสถานะเข้าสู่ระบบของเทอร์มินัล: รีสตาร์ต Agent ก่อน ตรวจ PATH ไดเรกทอรีการตั้งค่า และคลังข้อมูลรับรองของระบบ แล้วรันคำสั่งตรวจในหัวข้อ 1.4

8.2 แม่แบบคำติชม

คำติชมอย่างน้อยต้องมี คำสั่งที่รัน เวอร์ชัน CLI ระบบปฏิบัติการและสถาปัตยกรรม โมเดลที่ใช้ รหัส Canvas หรือ task ID request ID/trace ID ที่ปกปิด รหัสข้อผิดพลาด สถานะสุดท้าย และ URL ผลจริง

อย่าแนบ Cookie, token, Authorization ส่วนหัวคำขอเต็ม ข้อมูลรับรองในเครื่อง หรือข้อมูลละเอียดอ่อนที่ยังไม่ปกปิด

8.3 คำถามที่พบบ่อย

ทำไมหลัง dry-run ยังต้องมี estimate และการยืนยัน?

dry-run ตรวจโครงสร้างและพารามิเตอร์ของคำขอเท่านั้น ไม่ได้หมายถึงการประเมินฝั่งเซิร์ฟเวอร์ การตัดสินยอดคงเหลือ หรือการส่งสุดท้าย งานที่เกี่ยวกับค่าใช้จ่ายยังต้องสอบถามคะแนน ประเมิน อธิบายงบ ได้รับการยืนยัน แล้วส่งจริงหนึ่งครั้ง

จะให้ Skill สอดคล้องกับ CLI ได้อย่างไร?

หลังอัปเกรด CLI ให้รัน nadou skill install --json คู่กัน และใช้ nadou capability list --json ตัดสินว่าคำสั่งปัจจุบันเปิดจริงหรือไม่ ตอน Agent ทำงาน ให้ใช้ Skill ทางการที่ซิงค์บนเครื่องนี้เป็นหลัก

ทำไมยังไม่เห็นผลสุดท้าย?

สอบถามสถานะและ outputs ของ task เดิมก่อน แล้วยืนยันพื้นที่และไดเรกทอรีส่งมอบ อย่าส่งงานใหม่เพราะทางเข้าช้า ภาพย่อหายชั่วคราว หรือสอบถามครั้งหนึ่งล้มเหลว