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

ขั้นตอนแรก

ZIAForge รวมการสนทนา การวางแผน การดำเนินการ และการตรวจสอบไว้ในงานเดียว เลือก Code สำหรับโปรเจกต์ Git หรือเลือก Work สำหรับเอกสาร การวิจัย และผลลัพธ์อื่นๆ ในโฟลเดอร์ธรรมดา

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

1. เปิดการตั้งค่า (Settings) แล้วตรวจสอบโฟลเดอร์เวิร์กสเปซและภาษา เมนูเกี่ยวกับ (About) จะแสดงข้อมูลระบุตัวตนที่แน่นอนของบิลด์ที่กำลังทำงานอยู่
2. สำหรับ Code ให้เพิ่มที่เก็บข้อมูล Git ในแถบด้านข้าง สำหรับ Work ให้เลือกโฟลเดอร์แยกต่างหากเมื่อสร้างงาน
3. บันทึกพรีเซ็ตพร้อมระบุ CLI, โมเดล, ระดับการใช้เหตุผล และระดับการเข้าถึง คุณยังสามารถเลือกกำหนดเอง (Custom) ได้โดยตรงโดยไม่ต้องมีพรีเซ็ตที่บันทึกไว้
4. สร้างงาน เลือกเส้นทาง บทบาท และการเลื่อนขั้นแบบแมนนวลหรืออัตโนมัติ ตรวจสอบตัวเลือกก่อนกดเริ่ม (Start)

คำแนะนำที่เกี่ยวข้อง: ภาพรวมของโปรเจกต์ · ความเข้ากันได้ของผู้ให้บริการ.

ติดตั้งแพ็กเกจเดสก์ท็อปที่ถูกต้อง

เลือกแพ็กเกจสำหรับระบบปฏิบัติการและสถาปัตยกรรม CPU ของคุณ: x64 หรือ arm64 ไปป์ไลน์ของบิลด์สามารถสร้างรูปแบบ macOS DMG/ZIP, Windows NSIS ตัวติดตั้ง/ZIP, และ Linux DEB/RPM/AppImage/tar.gz/ZIP ไฟล์ที่สร้างขึ้นหรือบิลด์ข้ามแพลตฟอร์มไม่ใช่ข้อพิสูจน์ว่าตัวติดตั้งและ UI เนทีฟจะทำงานผ่านบนเครื่องของคุณ โปรดดูบันทึกการตรวจสอบของรุ่นเผยแพร่นั้น

บิลด์ของ macOS ที่ใช้ Electron 44 ต้องใช้ macOS 13 ขึ้นไป ให้ใช้แพ็กเกจ arm64 บน Apple Silicon และใช้แพ็กเกจ x64 สำหรับ Intel ออกจากแอปพลิเคชันเวอร์ชันเก่าโดยสมบูรณ์ก่อนทำการแทนที่ แพ็กเกจพรีวิวอาจยังไม่ได้ลงนามและยังไม่ได้รับการรับรอง Notarization อย่าสับสนระหว่างอาร์ทิแฟกต์สำหรับการพัฒนากับรุ่นเผยแพร่สู่สาธารณะที่มีการลงนามแล้ว

Windows ต้องใช้ระบบปฏิบัติการที่รองรับโดยเวอร์ชัน Electron ที่รวมมา และต้องมี Git อยู่ใน PATH ให้เลือกสถาปัตยกรรมที่ตรงกัน พรีวิวที่ยังไม่ได้ลงนามจะไม่มีใบรับรอง Authenticode ไฟล์พกพาแบบ ZIP จะต้องเก็บรักษาไดเรกทอรีแอปพลิเคชันและไฟล์รันไทม์ทั้งหมดอย่างสมบูรณ์ ไม่ใช่มีเพียงแค่ไฟล์สั่งการเท่านั้น

Linux ต้องการเดสก์ท็อปแบบกราฟิกที่เข้ากันได้ ไลบรารีระบบที่จำเป็นสำหรับ Electron และ Git สำหรับข้อมูลรับรองการควบคุมที่เข้ารหัส ให้จัดเตรียม Secret Service ที่ทำงานได้ เช่น gnome-libsecret หรือ KWallet โดยจะไม่ยอมรับแบ็กเอนด์แบบ basic_text ที่ไม่ปลอดภัย หลักฐานการทดสอบเบื้องต้นแบบ Headless หรือบนคอนเทนเนอร์ไม่ได้เป็นการรับรองสำหรับทุกเดสก์ท็อปหรือทุกการแจกจ่าย (distribution)

ติดตั้ง DEB ด้วย apt install ./file.deb หรือติดตั้ง RPM ผ่านตัวจัดการแพ็กเกจของการแจกจ่ายของคุณ ส่วน AppImage ต้องได้รับสิทธิ์การรันและมีการรองรับ FUSE ที่เหมาะสม ทั้งนี้ --appimage-extract-and-run เป็นทางเลือกในจุดที่รองรับ แตกแพ็กเกจ tar.gz และ ZIP พร้อมไฟล์รันไทม์ทั้งหมด แยกข้อมูลผู้ใช้และไฟล์แอปพลิเคชันให้ชัดเจนเมื่อทำการแทนที่แพ็กเกจ

หากต้องการบิลด์จากซอร์สโค้ด ให้ใช้ Node 24, Git และ npm ci รวมถึงตัวติดตั้ง Electron ปกติ การรีบิลด์แบบเนทีฟจำเป็นต้องมีเครื่องมือตามแพลตฟอร์ม: เครื่องมือบรรทัดคำสั่ง Xcode บน macOS; MSVC C++, Windows SDK และ Python บน Windows; คอมไพเลอร์, make, Python, pkg-config และเครื่องมือบรรจุแพ็กเกจที่จำเป็นบน Linux ทำตาม PLATFORM_BUILDS.md สำหรับคำสั่งที่แน่นอนและขีดจำกัดของแพลตฟอร์มในปัจจุบัน

เวอร์ชันของรุ่นเผยแพร่จะถูกสงวนไว้จากส่วนกลางและผลลัพธ์จะไม่สามารถเปลี่ยนแปลงได้ บิลด์การตรวจสอบของ CI ไม่ใช่ตัวติดตั้งที่เผยแพร่ คลังข้อมูลซอร์สโค้ดประกอบด้วยซอร์สโค้ด, lockfile, เอกสาร และสคริปต์ โดยไม่รวมการพึ่งพา (dependencies), ข้อมูลรับรอง, โปรไฟล์ผู้ใช้ และงานวิจัยส่วนตัว อย่าสรุปการตรวจสอบความถูกต้องของ ARM หรือ Windows แบบเนทีฟจากบิลด์ x64 ที่สำเร็จ

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

Code: ห้าเส้นทาง

Auto จะประเมินขอบเขตของงาน: คำถามง่ายๆ อาจเสร็จสิ้นด้วยคำตอบเดียว ในขณะที่งานขนาดใหญ่จำเป็นต้องมีการเตรียมการ การแก้ไขข้อบกพร่อง (Fix a bug) จะตรวจสอบหาสาเหตุและเตรียมการแก้ไข เส้นทางข้อกำหนดทางเทคนิคก่อน (Spec first) จะเริ่มต้นด้วยโซลูชันทางเทคนิค ส่วนข้อกำหนดเบื้องต้นก่อน (Requirements first) จะเริ่มต้นด้วยข้อกำหนดและเกณฑ์การยอมรับ

Multi-model จะใช้บริบทที่แยกจากกันสำหรับการสำรวจ การออกแบบ การนำไปปฏิบัติ และการตรวจทาน ชื่อของเส้นทางไม่ได้บังคับว่าจะต้องใช้ผู้ให้บริการที่แตกต่างกัน: แต่ละบทบาทจะใช้พรีเซ็ตหรือการกำหนดค่าแบบกำหนดเอง (Custom) ตามที่คุณเลือก

Worktree จะแยกการเปลี่ยนแปลงของ Git สำหรับงานนั้นๆ ส่วน Branch จะทำงานในเช็กเอาต์ที่เลือกไว้ ให้ตรวจสอบโปรเจกต์ สาขา และโมเดลก่อนเริ่มต้น คำอธิบายของงานจะไม่ถูกส่งต่อไปยังแช็ตทั่วไปด้วย

สำหรับแนวคิดที่ยังมีทางเลือกด้านผลิตภัณฑ์หรือด้านเทคนิคที่ยังไม่ยุติ ให้ใช้ Requirements first และสร้างรากฐานผ่านการสนทนา Auto จะจำแนกประเภทคำขอ ไม่ใช่คำสั่งให้นำทุกวลีสั้นๆ ไปปฏิบัติทันที บันทึกแบบร่าง (Save draft) จะเก็บรักษาคำขอไว้โดยไม่ติดต่อโมเดล การเริ่ม (Start) จะบันทึกและเปิดตัวโฟลว์ที่มีการจัดการหนึ่งครั้ง สำเนางาน 1 ถึง 4 ชุดจะมี ID การสร้างและการตั้งค่าบทบาทที่เป็นอิสระจากกัน

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดสัญญาเวิร์กโฟลว์ Code · โปรไฟล์พรอมต์ของ Code.

การสนทนา Forge

การเริ่ม (Start) จะเปิดการสนทนาส่วนกลาง ตอบกลับอย่างเป็นธรรมชาติ ถามคำถามกลับ เพิ่มข้อจำกัด และพูดคุยถึงทางเลือกทางเทคนิค การสนทนาและคำถามจะยังคงอยู่กับงานนั้นๆ

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

หากต้องการกลับไปทบทวนรากฐานอย่างตั้งใจ ให้เลือก ข้อกำหนดเบื้องต้น (Requirements), ข้อกำหนดทางเทคนิค (Specification) หรือ การวางแผน (Planning) เวอร์ชันใหม่จะต้องได้รับการยอมรับใหม่สำหรับการตัดสินใจที่ขึ้นต่อกัน ขั้นตอนที่เสร็จสมบูรณ์แล้วและหลักฐานจะยังคงอยู่ ส่วนระยะที่ยังไม่เสร็จซึ่งถูกแทนที่จะยังคงอยู่ในประวัติ

เซสชันระยะที่มีการจัดการจะแตกต่างจากแช็ตอิสระ ให้ใช้การสนทนาของ Forge แทนการส่งพรอมต์ด้วยตนเองไปยังเซสชันที่เป็นของเวิร์กโฟลว์โดยตรง

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดสัญญาการสนทนา Forge.

เอกสารและการตัดสินใจ

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

ก่อนที่จะยอมรับแผนที่เสนอ ให้แก้ไขลำดับ คำแนะนำ เกณฑ์การยอมรับ และคำสั่งตรวจสอบ อนุญาตเฉพาะคำสั่งที่เป็นรูปธรรมที่คุณเข้าใจ: คำสั่งเหล่านั้นจะทำงานในโฟลเดอร์ของงาน Multi-model จะเสนอขั้นตอนการนำไปปฏิบัติระดับทั้งงานหนึ่งขั้นตอน โดยมีรายละเอียดอยู่ในเอกสารและคำแนะนำของงานนั้น

การอนุมัติ (Approve) เป็นการตัดสินใจอย่างรอบคอบและแยกต่างหาก Auto จะไม่ข้ามคำถามหรือการยอมรับข้อกำหนด ข้อกำหนดทางเทคนิค และแผนงาน เอกสารที่มีการเปลี่ยนแปลงจากภายนอกจะไม่สามารถนำการอนุมัติเดิมมาใช้ซ้ำได้

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

ตรวจสอบทั้งเอกสารและการตัดสินใจที่แสดงขึ้นมาก่อนกดยอมรับ การยอมรับจะผูกกับ ID ของเกตปัจจุบัน ฉบับแก้ไขของแผน และค่าแฮชของเอกสารที่เก็บรักษาไว้ ให้ร้องขอการเปลี่ยนแปลง (Request changes) เมื่อขอบเขตหรือหลักฐานไม่ถูกต้อง หากการตัดสินใจหมดอายุ ให้โหลดสถานะที่บันทึกไว้ใหม่อีกครั้งก่อนทำการเลือกใหม่ ไฟล์ที่มีการเปลี่ยนแปลงจะไม่สามารถยอมรับภายใต้เวอร์ชันก่อนหน้าได้

คำแนะนำที่เกี่ยวข้อง: เกตของเวิร์กโฟลว์และเวอร์ชันเอกสาร.

การดำเนินการและการตรวจทาน

รายการสิ่งที่ต้องทำ (To-do) จะแสดงขั้นตอนจริง การพยายามปัจจุบัน ผลการตรวจสอบ และผลการตรวจทาน การที่เอเจนต์บอกว่า "done" ไม่ได้ทำให้ขั้นตอนนั้นเสร็จสิ้น: หลักฐานที่จำเป็นตามแผนจะต้องมีอยู่จริง

โหมดแมนนวลจะหยุดชั่วคราวระหว่างขั้นตอนที่เข้าเกณฑ์ Auto จะเลื่อนขั้นตอนที่ผ่านการตรวจสอบแล้วไปข้างหน้าและอนุญาตให้ลองใหม่ได้แบบจำกัดจำนวนครั้ง การหยุดหลังจาก (Stop after) จะสร้างจุดตรวจสอบเสมอ การหยุดชั่วคราว (Pause) จะหยุดการทำงานที่กำลังดำเนินอยู่ของเวิร์กโฟลว์ การปิดแผงหน้าต่างไม่ได้เป็นการหยุดการทำงาน

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

ใน Multi-model การแก้ไขข้อตรวจพบจำเป็นต้องมีการตัดสินใจอย่างชัดเจน การแก้ไขไม่ได้เริ่มรอบการตรวจทานใหม่โดยเงียบๆ: การตรวจทานอีกครั้ง (Review again) จะเปิดรอบใหม่ ความคิดเห็นในการตรวจทานสามารถร้องขอให้ผู้ประสานงานพิจารณาใหม่ได้โดยไม่ต้องทำซ้ำขั้นตอนการนำไปปฏิบัติ

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

บันทึกผู้ตรวจทานอิสระแบบ CLI/API ใน การตั้งค่า → ทีมตรวจทาน (Settings → Review teams) จากนั้นเลือกทีมใน Code หรือ Work ผู้ตรวจทานจะทำงานแบบคู่ขนาน ตามด้วยสถาปนิกรายงานของทีม คุณยังสามารถกำหนดค่าผู้ตรวจทานอิสระโดยไม่ต้องมีทีมที่บันทึกไว้ได้เช่นกัน สถาปนิกรายงานจะได้รับเฉพาะรายงานที่มีโครงสร้างแบบไม่ระบุชื่อเท่านั้น โดยไม่มีไฟล์โปรเจกต์หรือเครื่องมือ การแยกส่วนนี้ปัจจุบันจำเป็นต้องใช้ Claude Code หรือ API

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

เซอร์กิตเบรกเกอร์เริ่มต้นจะหยุดการทำงานหลังจากพยายามล้มเหลว 3 ครั้งในขั้นตอนเดียว หรือพยายามรวม 50 ครั้ง การขัดจังหวะจะใช้โควตาการพยายามไป 1 ครั้ง แต่ตัวมันเองไม่นับว่าเป็นการพยายามที่ล้มเหลว ขีดจำกัดและหลักฐานที่เสร็จสมบูรณ์จะยังคงอยู่แม้รีสตาร์ท การลองใหม่ (Retry) ไม่ได้รีเซ็ตค่าเหล่านี้ โปรดอ่านข้อผิดพลาดที่บันทึกไว้ก่อนที่จะอนุญาตให้พยายามอีกครั้ง

คำแนะนำที่เกี่ยวข้อง: การตรวจสอบและการตรวจทาน.

ทีมตรวจทานแบบคู่ขนานและสถาปนิกรายงาน

เปิด การตั้งค่า → ทีมตรวจทาน (Settings → Review teams) แล้วบันทึกทีม เพิ่มผู้ตรวจทานอิสระด้วย CLI หรือ API, โมเดล, ระดับการใช้เหตุผล และความเชี่ยวชาญเฉพาะทางของตนเอง จากนั้นเลือกสถาปนิกรายงาน เลือกทีมในการกำหนดค่าการตรวจทานของงาน พรีเซ็ตของผู้ดำเนินการสามารถใช้โดยผู้ตรวจทานได้เช่นกัน และตัวเลือกแบบกำหนดเอง (Custom) ยังคงมีให้ใช้งาน โดยบทบาทอิสระจะยังคงมีบริบทแยกต่างหาก

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

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

สถาปนิกที่ทำหน้าที่รายงานเพียงอย่างเดียวปัจจุบันใช้การกำหนดค่าแบบไร้เครื่องมือของ Claude หรือ API ที่รองรับ Codex และ Antigravity ยังคงพร้อมใช้งานในฐานะผู้ตรวจทาน แต่จะถูกปฏิเสธสำหรับบทบาทสถาปนิกที่แยกต่างหากนี้จนกว่าจะมีข้อกำหนดสัญญาแบบไร้เครื่องมือที่ได้รับการตรวจสอบแล้ว พรอมต์ที่ระบุเพียงว่า "no tools" เพียงอย่างเดียวนั้นไม่เพียงพอ

คำแนะนำที่เกี่ยวข้อง: การกำหนดค่าทีมแบบระบุชนิด · การรวมผลการตรวจทาน.

ความเชี่ยวชาญเฉพาะทางของเอเจนต์และนโยบายพรอมต์

โมเดลคือเครื่องมือในการดำเนินการ ส่วนความเชี่ยวชาญเฉพาะทางคือโปรไฟล์คำแนะนำ เลือก ไม่มี (None) เพื่อไม่เพิ่มความเชี่ยวชาญ, มาตรฐาน (Standard) สำหรับคู่มือเริ่มต้น, Auto สำหรับคู่มือในตัวที่เกี่ยวข้อง หรือ แมนนวล (Manual) สำหรับคู่มือที่เลือกและคำแนะนำแบบจำกัดขอบเขตของคุณเอง พรีเซ็ตสามารถบันทึกการเลือกนี้ไว้ได้

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

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

คำแนะนำที่เกี่ยวข้อง: แคตตาล็อกพรอมต์ดั้งเดิม.

Work: จากคำถามสู่เอกสาร

Work ไม่จำเป็นต้องใช้ Git ตัวเลือกเริ่มต้น (Default) จะสร้างโฟลเดอร์งานแยกต่างหาก ส่วนกำหนดเอง (Custom) จะเลือกโฟลเดอร์ที่มีอยู่ผ่านตัวเลือกไฟล์เนทีฟ บันทึกแบบร่าง (Save draft) จะจัดเก็บการตั้งค่าโดยไม่มีการอนุมาน การเริ่ม (Start) จะดำเนินการระยะแรก

Auto จะตอบโดยตรงหรือเสนอแผนที่เหมาะสมพร้อมรายการสิ่งที่ต้องทำจริง ระดมความคิด (Brainstorm) จะสร้าง ideas.md ก่อนที่คุณจะเลือกแนวคิดเพิ่มเติมหรือการประเมิน การวิจัย (Research) จะเก็บรักษา findings.md แหล่งที่มา และข้อจำกัด การเขียน (Write) จะเปลี่ยนจากเจตนาและโครงร่าง outline.md (เมื่อมีประโยชน์) ไปเป็นเอกสารเชิงพรรณนาหรือ draft.md โดยการแก้ไขจะยังคงเก็บรักษาเวอร์ชันก่อนหน้าไว้

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

สร้างสำเนาได้ 1–4 ชุดพร้อมการตั้งค่าผู้ดำเนินการที่เป็นอิสระ งานที่ใช้โฟลเดอร์ซ้อนทับกันจะไม่สามารถเขียนพร้อมกันได้ การประสานงานนี้ใช้กับการทำงานของ ZIAForge ไม่ใช่โปรแกรมภายนอกตามอำเภอใจ

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

กระบวนการเชิงลึก (Deep) จะรวมรายงานของผู้ปฏิบัติงานที่เก็บรักษาไว้เข้าเป็น brainstorm_report.md และถามการตัดสินใจของผู้ใช้เสมอ การติดตามผลเล็กน้อยจะแก้ไขรายงานผ่านผู้ประสานงาน ส่วนการเปลี่ยนแปลงครั้งใหญ่จะเริ่มรอบใหม่ของผู้ปฏิบัติงานที่ถูกระงับไว้ อาร์ทิแฟกต์จะยังคงรักษาเวอร์ชันเดิมไว้

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

โหมดแมนนวลจะหยุดชั่วคราวระหว่างระยะที่เข้าเกณฑ์ รวมถึงโครงร่างการเขียน (Write) ที่สำคัญ Auto สามารถดำเนินการต่อผ่านโครงร่างนั้นได้ คำถาม แผนที่เสนอให้ดำเนินการ ทิศทางการระดมความคิด และการตรวจทานรายงานเชิงลึกยังคงเป็นการตัดสินใจอย่างชัดเจนแม้จะอยู่ใน Auto การอ้างอิงเพียงอย่างเดียวไม่ได้พิสูจน์ว่ามีการสืบค้นเว็บเกิดขึ้น และไฟล์ไบนารีที่เก็บรักษาไว้เพียงอย่างเดียวไม่ได้พิสูจน์การแสดงผลของมัน

คำแนะนำที่เกี่ยวข้อง: โหมดและการตัดสินใจของ Work.

พรีเซ็ต โมเดล และการเข้าถึง

พรีเซ็ตจะบันทึก CLI/API, โมเดล, ระดับการใช้เหตุผล และสิทธิ์ ส่วนท้ายของแช็ตจะมีส่วนของพรีเซ็ต, CLI, โมเดล และตัวเลือก ตัวเลือกแบบกำหนดเอง (Custom) สามารถทำงานได้โดยไม่ต้องมีพรีเซ็ต ส่วนสร้างพรีเซ็ต (Create preset) จะบันทึกการเลือกปัจจุบัน

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

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

ใน Forge ป้ายชื่อบทบาทมีความสำคัญ: การเตรียมการสามารถใช้ผู้วางแผน (Planner) แยกต่างหากได้ ส่วนท้ายจะเปลี่ยนบทบาทที่แสดง ผู้ตรวจทานและผู้ช่วยจะถูกเลือกในการตั้งค่าเวิร์กโฟลว์ นโยบายสำหรับการนำไปปฏิบัติที่ผ่านการตรวจสอบแล้วอาจถูกล็อก

สิทธิ์จะแตกต่างกันไปตามผู้ให้บริการ สิทธิ์อ่านอย่างเดียว (Read only) และเขียนเวิร์กสเปซ (Workspace write) จะมีให้ใช้งานเมื่ออะแดปเตอร์รองรับ Antigravity จะใช้การตั้งค่าเนทีฟของ CLI หรือการเข้าถึงเต็มรูปแบบที่เลือกอย่างชัดเจน การเข้าถึงเต็มรูปแบบไม่ใช่แซนด์บ็อกซ์

ความเชี่ยวชาญเฉพาะทางจะเป็นการเพิ่มคำแนะนำในพรอมต์ ไม่ใช่การเพิ่มโมเดลหรือสิทธิ์อื่น พรีเซ็ตและบทบาทรองรับ ไม่มี (None), มาตรฐาน (Standard), Auto และ แมนนวล (Manual) โดย Auto จะเลือกโปรไฟล์จากข้อความขั้นตอนโดยไม่มีการเรียกโมเดลเพิ่มเติม ส่วน Manual จะยอมรับความเชี่ยวชาญได้สูงสุดสี่ด้านและคำแนะนำแบบกำหนดเอง การกำหนดหมายที่เสนอโดยผู้วางแผนสามารถแก้ไขได้ก่อนที่จะยอมรับแผน

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

คำแนะนำที่เกี่ยวข้อง: ความสามารถของผู้ให้บริการ.

แช็ต การหยุด และคิวข้อความ

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

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

ในแช็ตทั่วไป คิว (Queue) จะบันทึกคำขอในภายหลังแยกต่างหากจากแบบร่างปัจจุบัน การหยุดคิวชั่วคราว (Pause queue) จะระงับการส่งข้อความถัดไป การหยุด (Stop) และออกจากแอป (Quit) จะหยุดคิวชั่วคราว หลังจากการรีสตาร์ท ให้กดดำเนินการต่อ (Resume) ก่อน แล้วจึงกดดำเนินการต่อคิว (Continue queue) อย่างชัดเจน

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

แช็ตระยะที่มีการจัดการจะใช้เวิร์กโฟลว์ของตนเอง ไม่ใช่คิวทั่วไป การติดตามระยะ (Follow stage) จะแสดงระยะปัจจุบัน การเลือกแท็บอื่นด้วยตนเองจะเป็นการหยุดการติดตาม บันทึกของ CLI จะแสดงข้อมูลการวินิจฉัยแยกต่างหากจากการตอบกลับ

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

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

คำแนะนำที่เกี่ยวข้อง: คิวข้อความที่ทนทานต่อการสูญหาย.

ไฟล์, Git และการเสร็จสมบูรณ์

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

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

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

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

ตัวแก้ไขไฟล์รองรับการเน้นไวยากรณ์ตามนามสกุล ค้นหาและแทนที่ ประวัติการเลิกทำ การตัดคำ และแบบร่างแยกตามแท็บ การบันทึกจะคงการเข้ารหัส UTF-8/UTF-16 ที่รองรับ และปฏิเสธข้อขัดแย้งจากการแก้ไขภายนอก การเข้ารหัสอื่นและเนื้อหาไบนารีจำเป็นต้องใช้ตัวแก้ไขภายนอก แบบร่างที่ยังไม่บันทึกจะขัดขวางการออกจากแอปพลิเคชัน (Quit) จนกว่าเจ้าของจะบันทึกหรือยกเลิกทิ้ง

การเน้นไวยากรณ์เต็มรูปแบบจะเปิดใช้งานสูงสุดไม่เกิน 8 MiB ไฟล์ข้อความขนาดใหญ่กว่านั้นจะเปิดในหน้าต่างขนาด 256 KiB; ขนาด 8–64 MiB สามารถโหลดทั้งหมดอย่างชัดเจนได้โดยไม่มีการเน้นไวยากรณ์ หากเกิน 64 MiB ให้ใช้การแก้ไขแบบหน้าต่างและการค้นหารายการถัดไปแบบจำกัดขอบเขต นี่คือโหมดไฟล์ขนาดใหญ่ที่มีข้อจำกัด ไม่ใช่ความสามารถเทียบเท่า Sublime Text สำหรับเอกสารขนาดใหญ่ใดๆ ก็ตาม

เปิดโฟลเดอร์ (Open folder) จะใช้บริบทงานหรือบริบทสาขา/เวิร์กทรีปัจจุบัน แทนที่จะแอบเปิดเฉพาะที่เก็บเดิมโดยเงียบๆ แถวไฟล์สามารถแสดงไดเรกทอรีหลักของไฟล์นั้นได้ เส้นทางไฟล์จะได้รับการตรวจสอบโดยแบ็กเอนด์เทียบกับสิทธิ์ที่ลงทะเบียนไว้ของงาน ไฟล์ไบนารีไม่สามารถแก้ไขเป็นข้อความธรรมดาได้ โปรดใช้โปรแกรมดูเป้าหมายของไฟล์นั้นและคงไบต์ดั้งเดิมไว้

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

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดสัญญาตัวแก้ไขแบบระบุชนิด · นโยบายของ Git.

การเชื่อมต่อ API

เมนูการเชื่อมต่อ (Connections) ใช้สำหรับเพิ่มเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ตามที่เลือกอย่างชัดเจน ให้ป้อนชื่อ, URL หลัก, โมเดล และคีย์หากจำเป็น เซิร์ฟเวอร์จำนวนมากกำหนดให้ URL หลักลงท้ายด้วย /v1 โปรดอ่านเอกสารประกอบของเอนด์พอยต์ที่คุณใช้งาน

จำเป็นต้องใช้ HTTPS ยกเว้นลูปแบ็กแบบ HTTP โปรดใช้เอนด์พอยต์ธรรมดาโดยไม่ฝังข้อมูลรับรองลงใน URL คีย์จะใช้การเข้ารหัสของ OS ที่รองรับและจะไม่แสดงกลับมาที่ UI หากมีการเปลี่ยนเอนด์พอยต์จะต้องป้อนคีย์ใหม่อีกครั้ง การเว้นว่างในช่องคีย์จะคงคีย์เดิมที่บันทึกไว้ ส่วนการลบคีย์ที่บันทึกไว้จะเป็นการล้างคีย์นั้นออกอย่างชัดเจน

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

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

คำแนะนำที่เกี่ยวข้อง: การเชื่อมต่อ API.

การตั้งค่า ภาษา และการรีเซ็ตอย่างปลอดภัย

การตั้งค่าทั่วไปใช้สำหรับเลือกเวิร์กสเปซ ภาษาของอินเทอร์เฟซ และค่าเริ่มต้น การเชื่อมต่อ (Connections) ใช้จัดการเอนด์พอยต์ของ API พรีเซ็ตและทีมตรวจทานจะเก็บรักษาการกำหนดค่าบทบาท การควบคุมระยะไกลจัดการข้อมูลรับรองในเครื่อง ขอบเขตเซิร์ฟเวอร์ และสิทธิ์ของเจ้าของ การอัปเดต (Updates) จัดการแหล่งที่มา/แชนเนลของรุ่นเผยแพร่ ส่วนเกี่ยวกับ (About) จะแสดงบิลด์ที่กำลังทำงานอยู่อย่างแน่นอน

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

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

คำแนะนำที่เกี่ยวข้อง: คำแนะนำการแปลภาษา · การกู้คืนข้อมูล.

ถามผู้ช่วยความช่วยเหลือ

เปิดความช่วยเหลือ เลือกพรีเซ็ตที่เชื่อมต่อและบันทึกไว้ในแผงผู้ช่วย แล้วถามเกี่ยวกับ ZIAForge คำตอบจะใช้คู่มือภาษาอังกฤษมาตรฐานฉบับปัจจุบันและภาษาอินเทอร์เฟซที่คุณเลือก ปุ่มอ้างอิงหมวดหมู่จะเปิดหัวข้อคู่มือที่เกี่ยวข้อง เพื่อให้คุณสามารถเปรียบเทียบคำอธิบายกับข้อมูลอ้างอิงได้

ผู้ช่วยนี้จะเก็บการสนทนาส่วนตัวแยกต่างหากได้สูงสุด 100 รายการที่บันทึกไว้ และขนาด 3 MiB ป้อนคำถามได้สูงสุด 12,000 อักขระ ปุ่ม Send จะส่งคำถาม ปุ่ม Stop จะยกเลิกคำตอบที่กำลังทำงานอยู่โดยยังคงเก็บคำถามของคุณไว้ และปุ่ม Clear จะลบการสนทนาความช่วยเหลือนี้ ฉบับร่างที่ยังไม่ได้ส่งและการเลือกพรีเซ็ตจะยังคงอยู่แม้ปิดหรือเปิดความช่วยเหลือใหม่ในเซสชันแอปเดียวกัน แต่ฉบับร่างจะไม่ถูกบันทึกลงในดิสก์ ผู้ช่วยจะไม่ส่งคำสั่งของแอปพลิเคชัน เปลี่ยนแปลงเวิร์กโฟลว์ หรือยอมรับเกต คำแนะนำไม่ใช่การตรวจสอบงาน บัญชี หรือการเชื่อมต่อภายนอกแบบเรียลไทม์

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

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

คำแนะนำที่เกี่ยวข้อง: การบำรุงรักษาคู่มือมาตรฐานและการแปล · ผู้ช่วยแอปพลิเคชันและสิทธิ์.

ผู้ช่วยและ Telegram

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

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

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

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

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

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดการควบคุมแอปพลิเคชัน.

ใช้งานบ็อต Telegram ส่วนตัวของคุณ

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

ใช้ /start, /menu หรือ /status เพื่อดูภาพรวมของเวอร์ชันที่กำลังรันอยู่ จำนวนโปรเจกต์/งาน และสถานะของงาน ปุ่มต่างๆ จะเปิด Projects, Tasks, Screenshot, Help และ Language รายการจะแสดงแปดรายการต่อหน้า พร้อมการนำทาง Back, Refresh, Home และ Previous/Next ปุ่มโปรเจกต์จะกรองรายการงาน การ์ดงานจะแสดงความคืบหน้าของเวิร์กโฟลว์ที่บันทึกไว้ โมเดล/พรีเซ็ต และคำถามที่รอดำเนินการหากมี

เปิด Chats ของงานเพื่อดูตัวอย่างการสนทนาที่เปิดอยู่/ล่าสุด และแช็ตตามเฟสของเวิร์กโฟลว์ แต่ละตัวอย่างจะแสดงข้อความล่าสุดของผู้ใช้/ผู้ช่วยสูงสุดหกข้อความ โดยย่อให้เห็นเป็น 200 อักขระต่อข้อความ เหตุผลส่วนตัวจะไม่แสดง การอ่านประวัติไม่ได้เริ่มต้นผู้ให้บริการ การดูตัวอย่างเป็นแบบอ่านอย่างเดียว: ข้อความธรรมดาและ /ask TEXT ยังคงส่งไปยังผู้ช่วยของแอปพลิเคชัน และจะไม่ส่งไปยังแช็ตงานที่คุณกำลังดูอยู่โดยปริยาย

เรียกใช้ / ดำเนินการต่อ (Run / Continue) จะอ่านเวิร์กโฟลว์ Code หรือ Work ในปัจจุบันซ้ำ และเริ่มเวิร์กโฟลว์ที่บันทึกไว้ซึ่งมีสิทธิ์ หยุดชั่วคราว (Pause) จะขอให้หยุดชั่วคราว ทั้งสองคำสั่งไม่ยอมรับข้อกำหนด สเปก แผน ผลการตรวจสอบ หรือคำถาม การตัดสินใจที่รอดำเนินการจะขัดขวางไม่ให้เรียกใช้ (Run) ทำการตัดสินใจในแอปพลิเคชัน หรือใช้คำสั่งแบบกำหนดชนิดข้อมูลที่ได้รับอนุญาตอย่างชัดเจนพร้อมเกตและการแก้ไขที่ตรงกันในปัจจุบัน

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

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

เมื่อเปิดใช้งาน ตัวดึงข้อมูล (poller) จะละทิ้งรายการที่ค้างอยู่ก่อนหน้าและบันทึกการยอมรับการอัปเดตก่อนส่ง เพื่อไม่ให้คำสั่งที่ถูกขัดจังหวะถูกเล่นซ้ำโดยอัตโนมัติเมื่อเริ่มระบบใหม่ สิ่งนี้ป้องกันการเล่นซ้ำ แต่ไม่รับประกันความสมบูรณ์ ตรวจสอบสถานะ/บริบทก่อนที่จะออกงานใหม่โดยเจตนาหลังจากเกิดข้อผิดพลาด ไม่มีการแจ้งเตือนสถานะงานโดยอัตโนมัติ

คำสั่งที่ชัดเจนยังคงใช้งานได้: /projects, /tasks, /task TASK_ID, /run TASK_ID, /pause TASK_ID, /screenshot และ /ask TEXT คำสั่ง /new {JSON} จะสร้างงานผ่าน createTask แบบกำหนดชนิดข้อมูล ส่วน /command {JSON} จะส่งคำสั่งตามแคตตาล็อกที่ชัดเจน ให้อ่านแคตตาล็อกปัจจุบันสำหรับโครงสร้างอาร์กิวเมนต์ โดยจะใช้การอนุญาตฝั่งแบ็กเอนด์และการอนุญาตโฟลเดอร์เดียวกันกับในแอปพลิเคชัน

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

คำแนะนำที่เกี่ยวข้อง: บ็อตส่วนตัวและคำสั่ง.

สิทธิ์เข้าถึงคอมพิวเตอร์ระดับระบบเฉพาะเจ้าของ

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

เมื่อเปิดใช้งานไว้อย่างชัดเจน computer.run จะยอมรับไฟล์สั่งการ อาร์เรย์ของอาร์กิวเมนต์ และไดเรกทอรีทำงานสัมบูรณ์ที่เป็นทางเลือก โดยไม่มีการแก้ไขสตริงผ่านเชลล์ มีการจำกัดเวลา 30 วินาที และจำกัดเอาต์พุตไว้ที่ 1 MiB ไดเรกทอรีที่ระบุซึ่งขาดหายไปหรือไม่ถูกต้องจะถูกปฏิเสธ การละเว้น cwd จะใช้ไดเรกทอรีการตั้งค่าของแอป ไม่ใช่ HOME การออกจากโปรแกรม (Quit) จะยกเลิกคำสั่งที่เป็นของตนเองที่ยังทำงานอยู่และรอการล้างกระบวนการ

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

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดการควบคุมเฉพาะเจ้าของ.

เบราว์เซอร์และอินสแตนซ์ระยะไกล

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

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

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

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

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

คำแนะนำที่เกี่ยวข้อง: การควบคุม HTTP และอินสแตนซ์.

OpenClaw, Hermes และเอเจนต์ภายนอกอื่นๆ

ใช้ API ควบคุมแอปพลิเคชันที่ผ่านการยืนยันตัวตน หรือบริดจ์ stdio ของ MCP ที่รวมมาด้วย เปิดใช้งานเซิร์ฟเวอร์ในเครื่อง เลือกการอ่านหรือการดำเนินการ และกำหนดค่าแต่ละไคลเอนต์ด้วย URL และโทเค็นของอินสแตนซ์นั้น จำเป็นต้องมี Node.js 22 หรือใหม่กว่าเพื่อรันบริดจ์ MCP แบบสแตนด์อโลน แอป Electron ไม่ได้ติดตั้งไคลเอนต์เอเจนต์ของคุณ URL ของเบราว์เซอร์ไม่ใช่จุดปลาย HTTP MCP แบบสตรีมได้ ให้ระบุเป็น ZIAFORGE_URL ให้กับบริดจ์ stdio

บริดจ์จะเปิดเผย ziaforge_status, ziaforge_commands, ziaforge_command และ ziaforge_screenshot เริ่มต้นด้วย status และแคตตาล็อกคำสั่งปัจจุบัน จากนั้นอ่าน system.context สำหรับงานที่เลือก คำสั่งแบบกำหนดชนิดข้อมูลจะเป็นไปตามการตรวจสอบการแก้ไข เกต โฟลเดอร์งาน และการล้างข้อมูลเช่นเดียวกับ UI ในเครื่อง

แคตตาล็อกคำสั่งปัจจุบันรวมถึง documentation.guide ซึ่งเป็นคู่มือภาษาอังกฤษมาตรฐาน พร้อมด้วยพาธต้นฉบับและ sourceSha256 สถาปนิกแอปพลิเคชันภายในจะได้รับข้อมูลอ้างอิงเดียวกันผ่านเครื่องมือของตน สิ่งนี้ทำให้เอเจนต์มีบริบทผลิตภัณฑ์ทั้งหมดโดยไม่ต้องพึ่งพาบันทึกเก่า เอกสารประกอบไม่เคยให้สิทธิ์การเข้าถึงหรือใช้แทนการตัดสินใจของมนุษย์ในปัจจุบัน

เอเจนต์ควรหารือเกี่ยวกับข้อกำหนด การตัดสินใจทางเทคนิค และการวางแผนจากแนวคิดสั้นๆ ของมนุษย์ เอเจนต์ต้องรักษาเกตที่ชัดเจนของมนุษย์ โมเดลที่เลือก นโยบายกำหนดเอง/Auto และการตรวจสอบที่จำเป็น เอเจนต์ต้องไม่คิดการอนุมัติขึ้นมาเอง เล่นซ้ำคำสั่งที่ไม่แน่นอนภายใต้ ID ใหม่ หรือเผยแพร่การเปลี่ยนแปลง Git โดยไม่ได้รับความยินยอมจากเจ้าของ

กำหนดค่าเซิร์ฟเวอร์ MCP ที่มีชื่อหลายตัวสำหรับการติดตั้งหลายรายการ การสลับอินสแตนซ์เป็นการตัดสินใจเกี่ยวกับการกำหนดเส้นทาง ไม่ใช่การซิงโครไนซ์ ตัวอย่างการกำหนดค่า OpenClaw และ Hermes อยู่ใน AGENT_CONTROL.md โดยต้องตรวจสอบการตั้งค่าและความเข้ากันได้เฉพาะของไคลเอนต์สำหรับเวอร์ชันไคลเอนต์ที่ติดตั้ง

แคช requestId ภายนอกจะคัดลอกคำขอที่ซ้ำกันออกไปได้ในขอบเขตจำกัดเท่านั้นขณะที่แอปกำลังทำงาน การดำเนินการที่คงทนจะใช้ข้อมูลระบุตัวตนของตนเอง: createRequestId สำหรับการสร้างงาน, commandId สำหรับการตัดสินใจเวิร์กโฟลว์, clientMessageId สำหรับข้อความ และ operationId สำหรับการแก้ไข Git ให้รักษาข้อมูลระบุตัวตนดั้งเดิมและเพย์โหลดไว้หลังจากการตอบรับที่ไม่ทราบผล และอ่านสถานะที่บันทึกไว้ก่อนที่จะออกงานใหม่โดยเจตนา

คำแนะนำที่เกี่ยวข้อง: คำแนะนำไคลเอนต์ MCP.

CLI ภายในเครื่องและขีดจำกัดของระบบอัตโนมัติ

ตัวจัดส่ง ziaf จะควบคุมแอปที่กำลังทำงานอยู่และเวิร์กโฟลว์ที่บันทึกไว้เดียวกัน จากซอร์สโค้ด ให้ใช้ npm run ziaf -- list, npm run ziaf -- status --task TASK_ID --json, npm run ziaf -- start --task TASK_ID หรือ npm run ziaf -- pause --task TASK_ID การตอบรับ Start ที่สำเร็จไม่ได้หมายความว่างวดงานเสร็จสิ้นแล้ว

--until-success จะเปิดใช้งาน Auto สำหรับเวิร์กโฟลว์ที่บันทึกไว้โดยเจตนา แต่คำถาม การตรวจสอบ เกตการยอมรับ ขีดจำกัด และจุดตรวจสอบยังคงมีผลใช้บังคับ Ctrl+C จะออกจากตัวจัดส่งที่กำลังสังเกตการณ์อยู่ แต่ไม่ได้หยุดเวิร์กโฟลว์ของแอปพลิเคชันโดยปริยาย ดู CLI.md สำหรับรหัสการออก จุดปลายภายในเครื่อง และการจัดการโปรไฟล์

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

คำแนะนำที่เกี่ยวข้อง: คำสั่งตัวจัดส่ง.

เวอร์ชันและการอัปเดต

About จะแสดงเวอร์ชันที่กำลังทำงานอยู่อย่างแม่นยำ การอัปเดตสาธารณะต้องใช้ที่เก็บการเผยแพร่ของ GitHub ที่เชื่อถือได้และแชนเนลที่เสถียร (stable) หรือพรีวิว (preview) การตรวจสอบ การดาวน์โหลด และการติดตั้งมีสถานะแยกจากกัน ข้อผิดพลาดไม่ได้หมายความว่าการอัปเดตได้รับการติดตั้งแล้ว

การติดตั้งอัตโนมัติมีไว้สำหรับรุ่น macOS ที่มีการลงนาม บิลด์สำหรับการพัฒนาที่ไม่ได้ลงนามจะไม่ได้รับการติดตั้งโดยอัตโนมัติผ่านกลไกนี้ สำหรับการแทนที่ด้วยตนเอง ให้ออกจากแอปปัจจุบันโดยสมบูรณ์และใช้อาร์ติแฟกต์ที่ผ่านการตรวจสอบแล้ว

การตรวจสอบอัตโนมัติจะทำงานทันทีเมื่อเปิดใช้งาน จากนั้นจะทำงานทุกหกชั่วโมง

Stable จะไม่รวมรุ่นพรีวิว ส่วน preview จะอนุญาตให้มีรุ่นสำหรับการพัฒนาด้วย การตรวจสอบที่สำเร็จจะสร้างเฉพาะข้อมูลเมทาดาทาของรุ่นที่มีอยู่เท่านั้น การดาวน์โหลดและการติดตั้งจำเป็นต้องมีแพ็กเกจของแพลตฟอร์มและฟีดการเผยแพร่ที่กำหนดค่าไว้ การส่งมอบ Linux DEB เป็นเส้นทางการติดตั้งแยกต่างหาก อย่าสรุปว่า DEB จะได้รับการอัปเกรดโดยอัตโนมัติผ่านกลไกการอัปเดตของ macOS

คำแนะนำที่เกี่ยวข้อง: ความพร้อมของรุ่นเผยแพร่.

การเริ่มใหม่และการกู้คืน

บน macOS ให้ใช้ Quit / ⌘Q เพื่อปิดการทำงานโดยสมบูรณ์ การปิดหน้าต่างอาจทำให้แอปยังคงทำงานอยู่ ออกจากแอปเวอร์ชันเก่าอย่างสมบูรณ์ก่อนที่จะแทนที่แอปพลิเคชัน

หลังจากเปิดใช้งาน ให้เลือกงานเดิม ประวัติและฉบับร่างจะกลับมา การดำเนินการต่อ (Resume) จะคืนค่าบริบทระดับระบบ/ภายในเครื่อง แต่จะไม่ส่งฉบับร่าง ไม่ยกเลิกการหยุดคิวชั่วคราว หรือไม่อนุญาตให้ทำซ้ำการดำเนินการที่ไม่ทราบผล

หากหน้าจอกู้คืน (Recovery) ปรากฏขึ้น ห้ามแก้ไข JSON ด้วยตนเอง ตรวจสอบประเภทเอกสารที่ได้รับผลกระทบ เก็บรักษาไฟล์ต้นฉบับไว้ และเลือกข้อมูลสำรองที่ผ่านการตรวจสอบแล้ว การกู้คืนคิวที่เก่ากว่าจะทำเครื่องหมายรายการเหล่านั้นว่าไม่แน่นอน

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

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

คำแนะนำที่เกี่ยวข้อง: ข้อกำหนดการกู้คืน.

การแก้ไขปัญหา

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

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

เวิร์กโฟลว์หยุดทำงาน: เปิดเฟสปัจจุบัน คำถาม ใบเสร็จการตรวจสอบ หรือบันทึก CLI จัดการกับสาเหตุเฉพาะ: คำถามที่ยังไม่ได้ตอบ คำสั่ง สิทธิ์ของโฟลเดอร์ หรือขีดจำกัดความพยายาม การดำเนินการต่อ (Continue) ไม่สามารถเปลี่ยนการตรวจสอบที่ล้มเหลวให้เป็นสำเร็จได้

โฟลเดอร์หายไปหรือถูกแทนที่: คืนค่าการเข้าถึงโฟลเดอร์เดิมหรือสร้างงานใหม่ แอปต้องไม่ดำเนินการต่อจาก HOME หากคุณสังเกตเห็น cwd อื่น ให้หยุดรอบการทำงานและเก็บข้อมูลการวินิจฉัยไว้

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

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

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

Telegram ไม่พร้อมใช้งาน: ยืนยันโทเค็นบ็อต เจ้าของที่เป็นตัวเลข แช็ตส่วนตัว และสถานะในเครื่อง เว็บฮุกหรือตัวดึงข้อมูล (poller) ที่ขัดแย้งกันสามารถปิดกั้นการดึงข้อมูลได้ ZIAForge จะไม่ลบเว็บฮุกหรือเข้าแทนที่ตัวดึงข้อมูลอื่นโดยอัตโนมัติ คำสั่งที่ถูกปฏิเสธหรือขัดจังหวะที่ขอบเขตที่ไม่ทราบจะไม่ถูกเล่นซ้ำโดยอัตโนมัติ

คำแนะนำที่เกี่ยวข้อง: การทดสอบและการวินิจฉัย.

รายงานปัญหาและตรวจสอบหลักฐาน

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

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

สำหรับผู้ร่วมพัฒนา qa:doctor จะอ่านข้อมูลระบุตัวตนสภาพแวดล้อม/บิลด์ และ qa:inspect จะเปิดโปรไฟล์แยกต่างหากพร้อมสตับของผู้ให้บริการ ฟิกซ์เจอร์จะพิสูจน์เส้นทางแอปพลิเคชันที่ทดสอบโดยไม่ต้องติดต่อกับโมเดล การอนุมานจริง การเชื่อมต่อ Telegram เดสก์ท็อป Linux แบบเนทีฟ การลงนาม และการตรวจสอบอาร์ติแฟกต์ที่แพ็กเกจแล้วเป็นหลักฐานที่แยกต่างหาก ดูคำสั่งที่ทำซ้ำได้และการทำความสะอาดใน TESTING.md

คำแนะนำที่เกี่ยวข้อง: คำสั่งรวบรวมหลักฐาน.

ข้อมูลในเครื่องและขอบเขต

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

บน Linux การบันทึกข้อมูลประจำตัวของ API การควบคุม Telegram และอินสแตนซ์จำเป็นต้องใช้ GNOME Secret Service หรือ KWallet ที่ปลดล็อกแล้ว หากไม่มีที่จัดเก็บข้อมูลลับที่รองรับ ZIAForge จะปฏิเสธที่จะบันทึกข้อมูลลับเหล่านี้แทนที่จะใช้ตัวสำรอง basic_text ของ Electron

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

แยกแยะประเภทหลักฐาน: ฟิกซ์เจอร์จะทดสอบแอปพลิเคชันโดยไม่ใช้โมเดล การรันจริงแบบเนทีฟจะทดสอบ CLI/บัญชีจริง การตรวจสอบแพ็กเกจจะรับรองอาร์ติแฟกต์เฉพาะ การผ่านรายการหนึ่งไม่ได้เป็นการรับประกันรายการอื่นๆ

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

คำแนะนำที่เกี่ยวข้อง: แหล่งที่มาและการเผยแพร่.

ทำความเข้าใจและแก้ไขโปรเจกต์โอเพนซอร์สนี้

อ่าน AGENTS.md และ CONTRIBUTING.md ก่อน จากนั้นดู PROJECT_MAP.md สำหรับขอบเขตซอร์สโค้ดปัจจุบัน สัญญากำหนดชนิดข้อมูลที่นำไปใช้งานและเอกสารเวิร์กโฟลว์/ผู้ให้บริการปัจจุบันจะเป็นตัวกำกับพฤติกรรม CONCEPT.md และส่วนที่เน้นเทอร์มินัลเป็นหลักของ ARCHITECTURE.md จะรักษาเจตนาดั้งเดิมในอดีตและต้องไม่สับสนกับข้อกล่าวอ้างของรุ่นปัจจุบัน

ไฟล์ต้นฉบับความช่วยเหลือภาษาอังกฤษคือ docs/help/en.json ห้ามแก้ไข USER_GUIDE.md หรือ website/guide.html ที่สร้างขึ้นด้วยตนเอง ให้เปลี่ยนส่วนมาตรฐาน อัปเดตสัญญาที่ได้รับผลกระทบ แล้วเรียกใช้ node scripts/help/generate.cjs ความช่วยเหลือในแอปจะอ่านจากต้นฉบับเดียวกัน ตรวจสอบสิ่งที่เพิ่มเข้ามากับการนำไปใช้งานจริง รวมถึงขีดจำกัด สิทธิ์ และเส้นทางที่ไม่รองรับ

แต่ละโลแคลของอินเทอร์เฟซทั้ง 56 ภาษาจะมีสถานะความช่วยเหลือแยกต่างหากใน docs/help/locales.json ความช่วยเหลือที่ขาดหายไปหรือไม่สมบูรณ์จะกลับไปใช้ภาษาอังกฤษ เนื้อหาที่แปลด้วยเครื่องอย่างสมบูรณ์จะได้รับการติดป้ายกำกับและผูกไว้กับแฮชต้นฉบับภาษาอังกฤษ โดยไม่มีการอ้างว่าผ่านการตรวจสอบโดยมนุษย์ การแปลที่ได้รับการตรวจสอบโดยมนุษย์จะบันทึกผู้ตรวจทานเพิ่มเติม การแปลทุกชุดต้องคงไว้ซึ่งรหัสหมวดหมู่ การกระทำ ตัวระบุไฟล์/คำสั่ง และขีดจำกัดทางเทคนิค ใช้ทิศทางการเขียนที่ถูกต้อง และได้รับการรีเฟรชเมื่อต้นฉบับภาษาอังกฤษมีการเปลี่ยนแปลง

ก่อนจัดส่ง ให้รัน node scripts/help/generate.cjs --check เพื่อตรวจหาเอาต์พุตที่สร้างขึ้นที่ล้าสมัย โครงสร้างโลแคลที่ไม่ถูกต้อง หรือลิงก์สัญญาในเครื่องที่ใช้งานไม่ได้ การตรวจสอบการแปล UI และการตรวจสอบพฤติกรรมของแอปพลิเคชันยังคงแยกจากกัน HELP_MAINTENANCE.md มีขั้นตอนการอัปเดตสำหรับผู้ร่วมพัฒนาและ AI เอกสารต้องไม่อ้างว่าผ่านการทดสอบที่ยังไม่ได้รัน

คำแนะนำที่เกี่ยวข้อง: แผนผังโปรเจกต์ปัจจุบัน · การบำรุงรักษาเอกสารประกอบ · คำแนะนำสำหรับผู้ร่วมพัฒนา · คำแนะนำสำหรับเอเจนต์.