Jared

ลิงค์ดาวน์โหลด

โปรดตรวจสอบหน้าเผยแพร่สำหรับการดาวน์โหลดที่รวบรวมไว้ล่วงหน้าที่เป็นปัจจุบัน

เจเร็ดคืออะไร?

บอท iMessage ที่ทรงพลังและขยายได้ง่าย ทำให้สามารถเพิ่มฟีเจอร์แชทบอทในการสนทนา iMessage ได้ ประกอบด้วยคำสั่งพื้นฐานบางอย่างในตัว การรวม API เกม อีโมตแบบกำหนดเอง และอื่นๆ อีกมากมายสามารถเพิ่มได้โดยใช้ webhooks, REST API หรือโดยการติดตั้งปลั๊กอิน

คำขอดึงข้อมูลและปัญหา GitHub ใหม่ใด ๆ จะได้รับการชื่นชมอย่างมาก! หากคุณต้องการพัฒนาปลั๊กอินสำหรับ Jared โปรดดูส่วนปลั๊กอินด้านล่าง ฉันพร้อมเสมอบน Twitter หากคุณมีความคิด/ข้อเสนอแนะใดๆ

การติดตั้ง

Jared ต้องใช้เครื่องที่ใช้ macOS โดยมีบัญชีข้อความที่ใช้งานอยู่เข้าสู่ระบบ โดยได้รับการทดสอบบน 10.14 Mojave และใหม่กว่าเท่านั้น อาจใช้งานได้กับ macOS เวอร์ชันเก่า แต่ไม่รับประกันเนื่องจากอาจมีการเปลี่ยนแปลงสคีมาของฐานข้อมูลข้อความ หากคุณไม่ต้องการให้ Jared โพสต์เหมือนคุณ ขอแนะนำให้คุณสร้าง Apple ID และบัญชีผู้ใช้ใหม่บน Mac ของคุณ และเรียกใช้งานในเบื้องหลังภายใต้ผู้ใช้รายนั้น ด้วยวิธีนี้จะไม่ได้ใช้ Apple ID หลักของคุณ

1. ดาวน์โหลด Jared.app และย้ายไปยังโฟลเดอร์แอปพลิเคชัน

ดูส่วนการดาวน์โหลดที่ด้านบน

2. เรียกใช้ Jared.app อนุญาตให้ Jared "การเข้าถึงดิสก์แบบเต็ม" ในการตั้งค่าระบบ

สิ่งนี้จำเป็นเนื่องจากสิทธิ์ของ macOS ที่จำกัดการเข้าถึงฐานข้อมูลข้อความ

3. ให้สิทธิ์เข้าถึงข้อความอัตโนมัติ

หากคุณใช้งาน macOS Catalina หรือใหม่กว่า คุณจะต้องอนุญาตให้ Jared เข้าถึงเพื่อทำให้แอพข้อความเป็นแบบอัตโนมัติ ซึ่งจะทำให้ Jared สามารถส่งข้อความได้

4. (ไม่บังคับ) อนุญาตให้เข้าถึงผู้ติดต่อ

คุณสามารถเลือกอนุญาตให้ Jared เข้าถึงผู้ติดต่อของคุณ เพื่อให้สามารถระบุและอัพเดตชื่อของผู้ติดต่อได้ ผู้ติดต่อใช้เพื่อตั้งค่า/เรียกข้อมูลชื่อเท่านั้น

5. (ทางเลือก) เริ่มเซิร์ฟเวอร์ REST API

หากคุณต้องการใช้ REST API คุณจะต้องเปิดใช้งาน หากคุณเปิดใช้งานไฟร์วอลล์บน Mac ของคุณ คุณจะเห็นกล่องโต้ตอบแจ้งให้คุณอนุญาตให้ Jared เข้าถึงพอร์ตที่เชื่อมโยงอยู่

คำสั่งที่สร้างขึ้น

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

• /help : แสดงคำสั่งทั้งหมด /help,[command name] จะให้ข้อมูลเกี่ยวกับเส้นทางเฉพาะแก่คุณ
• /reload : โหลดปลั๊กอินซ้ำ
• /enable : เปิดใช้งานจาเร็ด
• /disable : ปิดการใช้งาน Jared
• /ping : ตรวจสอบว่าแชทบอทพร้อมใช้งานหรือไม่
• /version : รับเวอร์ชันของ Jared ที่กำลังทำงานอยู่
• /send : ส่งข้อความซ้ำๆ
• /schedule : กำหนดเวลาข้อความ
• /name : เปลี่ยนสิ่งที่จาเร็ดโทรหาคุณ
• /whoami : เอาชื่อของคุณมา
• /barf : ส่งคืนการแสดงข้อความ json ของคุณ ซึ่งใช้สำหรับการดีบัก
• Thank you Jared : ขอบคุณ จาเร็ด

การกำหนดค่า

ไฟล์การกำหนดค่าอยู่ที่ ~/Library/Application Support/Jared/config.json ซึ่งช่วยให้คุณ:

• กำหนดค่าเว็บฮุค
• ตั้งค่าพอร์ต REST API
• ปิดการใช้งานเส้นทางเฉพาะ

ดูตัวอย่างใน config-sample.json

ส่วนขยาย

Jared มี API ที่หลากหลายเพื่อให้คุณสามารถเพิ่มคำสั่งของคุณเอง สร้างข้อความอัตโนมัติ และอื่นๆ ได้อย่างง่ายดาย สำหรับเอกสารประกอบ API ทั้งหมด โปรดดูที่ฮับเอกสารประกอบ

ปลั๊กอิน

สามารถเพิ่มเส้นทางเพิ่มเติมได้ผ่านปลั๊กอินแบบแยกส่วน ซึ่งเขียนด้วยโค้ด Swift ดั้งเดิม ปลั๊กอินถูกโหลดแบบไดนามิกจากโฟลเดอร์ ~/Library/Application Support/Jared/Plugins หากต้องการติดตั้งโมดูล ให้ลากโมดูลไปที่นั่น จากนั้นส่ง /reload ไปที่ Jared หรือคลิก Reload Plugins ใน UI

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

เว็บฮุค

Jared รองรับ webhooks ในการส่งข้อมูลเซิร์ฟเวอร์ของคุณเกี่ยวกับข้อความขาเข้าและขาออก เซิร์ฟเวอร์ของคุณสามารถตอบสนองต่อคำขอเหล่านี้เพื่อส่งข้อความ หรือใช้ REST API เพื่อส่งข้อความได้ตลอดเวลา หากต้องการกำหนดค่า webhooks ให้เพิ่มลงใน config.json ที่กล่าวถึงข้างต้น หากต้องการข้อมูลเพิ่มเติมเกี่ยวกับ webhooks API โปรดดูเอกสารประกอบของ webhook

ส่วนที่เหลือ API

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

เจเร็ดทำงานอย่างไร

Jared อ่านจากฐานข้อมูล Messages ตามช่วงเวลาที่กำหนดและสืบค้นข้อความใหม่ โดยจัดเตรียมกรอบการกำหนดเส้นทางสำหรับการดำเนินการกับข้อความ และใช้ AppleScript เพื่อส่งข้อความขาออก นอกจากนี้ยังมีมัลติเธรดเพื่อให้สามารถดูแลคำขอหลายรายการพร้อมกันได้ Jared อนุญาตให้ขยายผ่านไฟล์ปลั๊กอิน .bundle , webhooks และ REST API ซึ่งอนุญาตให้เพิ่มคำสั่งโดยไม่ต้องแก้ไขฐานโค้ด Jared หลัก

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