Tool: bash — สำรวจและรันคำสั่ง shell ภายใต้ macOS sandbox

ภาพประกอบ: Tool: bash — สำรวจและรันคำสั่ง shell ภายใต้ macOS sandbox

bash ใช้สำรวจ workspace รันคำสั่งระบบ และทำงาน shell ตามที่ผู้ใช้ขอ การรันถูกครอบด้วย macOS sandbox-exec และ mutation guard ของ Agent TH; จึงไม่ใช่ shell ที่เขียนได้ทุก path

สำรวจไฟล์และค้นโค้ด

ค้นชื่อไฟล์และข้อความใน source ผ่าน shell ได้ เช่น:

rg -n "TODO|FIXME" src
rg --files
find . -maxdepth 2 -type f

read_file ใช้อ่านเนื้อหาและช่วงบรรทัด ส่วน edit เป็นทางหลักสำหรับสร้างหรือแก้ไฟล์แบบมี path validation ร่วมกัน

ขอบเขต macOS sandbox

คำสั่งเริ่มทำงานใน Active Workspace เมื่อเลือกไว้ (ฐานเดียวกับ path สัมพัทธ์ของ read_file/read_image/edit จึง ls แล้วอ่านชื่อเดิมต่อได้ ไม่ต้องพิมพ์ path ยาวซ้ำ) ไม่เช่นนั้นใน workspace โดยการเปลี่ยนโฟลเดอร์เริ่มต้นไม่ขยายสิทธิ์เขียน และรันบน macOS sandbox profile ซึ่งบล็อกการเขียนในระบบและโฟลเดอร์ส่วนตัวที่ป้องกันไว้ และบล็อกการอ่าน credential paths ที่กำหนดไว้ การเขียนปกติจำกัดใน internal workspace และ /tmp; Active Workspace หรือ Approved Edit Folders ใช้ได้เฉพาะผ่าน mutation scope ที่ตรวจสิทธิ์ path เพิ่ม ระบบปฏิเสธ protected target และ symlink ที่ไม่ผ่าน guard

การเปลี่ยนไฟล์ผ่าน Bash มีการตรวจ snapshot/delta เพื่อรายงานไฟล์ที่เปลี่ยนภายในขอบเขตหลักฐานที่กำหนด การอนุญาตอ่าน/เขียนจึงขึ้นกับ code-level path checks และ sandbox ของระบบปฏิบัติการ ไม่ได้ขึ้นกับ prompt อย่างเดียว

ใช้ให้เหมาะกับงาน

  • ค้นชื่อหรือเนื้อหา: rg --files, rg -n, find
  • อ่านและแก้ไฟล์: ใช้ read_file แล้ว edit เพื่อให้ path guard และผลแก้ไขตรวจได้
  • วิเคราะห์ข้อมูลหรือรัน Python: ใช้ python_exec
  • คำสั่งที่ใช้เวลานานและควร poll ภายหลัง: ใช้ bash_bg

คำสั่ง shell ยังอาจมี side effect ตามโปรแกรมที่เรียก จึงควรใช้เฉพาะกับงานที่ผู้ใช้ร้องขอ และตรวจผลก่อนสรุปว่างานสำเร็จ

อ่านเพิ่มเติม

ความคิดเห็น

กำลังโหลดความคิดเห็น...