zhamao-framework เป็นเฟรมเวิร์กการพัฒนาแชทบอท + เว็บเซิร์ฟเวอร์ประสิทธิภาพสูง
กลุ่มนักพัฒนา QQ: 670821194 คลิกเพื่อเข้าร่วมแชทกลุ่ม
หากมีนักพัฒนาที่ยินดีทำงานร่วมกันเพื่อพัฒนากรอบการทำงานเอง โปรดส่ง PR หรือ Issue เพื่อเข้าร่วมในการพัฒนา! หากคุณมีแนวคิดที่ดีกว่าเกี่ยวกับการออกแบบหลักของเฟรมเวิร์กเอง คุณสามารถจัดตั้งทีมพัฒนาร่วมกับผู้เขียน (ปัจจุบันมีเพียง 2 คนเท่านั้น) เพื่อมีส่วนร่วมในการพัฒนาระบบนิเวศ OneBot V12 และเฟรมเวิร์กเอง
ดูคอลัมน์โครงการสำหรับงานเวอร์ชันที่กำลังดำเนินอยู่ที่เกี่ยวข้อง!
เฟรมเวิร์ก Zhamao เขียนด้วย PHP และเน้นไปที่บริการ API และโรบ็อตแชทเป็นหลัก ซึ่งรวมถึง Websocket, HTTP และไลบรารีการตรวจสอบและคำขออื่น ๆ รหัสผู้ใช้เป็นแบบโมดูลาร์และสามารถเขียนฟังก์ชันต่าง ๆ ได้อย่างง่ายดายโดยใช้คำอธิบายประกอบ
วัตถุประสงค์หลักของเฟรมเวิร์กคือเซิร์ฟเวอร์ HTTP และเฟรมเวิร์กการสร้างหุ่นยนต์ โดยเฉพาะอย่างยิ่งสำหรับการประมวลผลข้อความแชทบอทจะสะดวกและครอบคลุมมากขึ้น มีกลไกการสนทนาและกลไกการโทรภายในมากมาย และคุณสามารถออกแบบปลั๊กอินของคุณเองได้หลายวิธี
#[BotCommand('Hello')]public function สวัสดี(BotContext $ctx) { $ctx->reply("สวัสดี ฉันชื่อ Zha Mao!"); // การตอบกลับที่จำเป็นอย่างง่าย} #[Route('/index')]public function index() { return "<h1>hello!</h1>"; // การพัฒนาบริการ HTTP อย่างรวดเร็ว}
ปัจจุบันเฟรมเวิร์กรองรับการทำงานโดยตรงในสภาพแวดล้อม Linux, WSL, macOS และ Windows สำหรับสภาพแวดล้อม Linux และ macOS คุณสามารถใช้สคริปต์การติดตั้งเพียงคลิกเดียวด้านล่าง
หากคุณต้องการติดตั้งและปรับใช้ในสภาพแวดล้อมอื่น คุณสามารถใช้ Docker เพื่อปรับใช้อย่างรวดเร็วหรือติดตั้งสภาพแวดล้อมด้วยตนเอง จากนั้นจึงติดตั้งเฟรมเวิร์กสำหรับรายละเอียด
# Linux, macOS คลิกถัดไปเพื่อตรวจจับสภาพแวดล้อม PHP และติดตั้งเฟรมเวิร์ก bash <(curl -fsSL https://zhamao.xin/v3.sh)# เริ่มเฟรมเวิร์ก cd zhamao-v3 ./เซิร์ฟเวอร์ zhamao
สคริปต์การติดตั้งเพียงคลิกเดียวยังช่วยให้คุณปรับแต่งพารามิเตอร์ได้ เช่น:
# สคริปต์จะตรวจจับ PHP ของระบบตามค่าเริ่มต้น หากคุณต้องการข้ามการตรวจจับโดยตรงและติดตั้งเวอร์ชัน PHP อิสระ ให้เพิ่มตัวแปรสภาพแวดล้อมนี้ส่งออก ZM_NO_LOCAL_PHP = "ใช่" # หากสคริปต์ติดตั้งเวอร์ชันอิสระของ PHP เวอร์ชันเริ่มต้น คือ 8.1 หากคุณต้องการใช้เวอร์ชันอื่น ให้เพิ่มตัวแปรสภาพแวดล้อมนี้เพื่อระบุเวอร์ชันที่ส่งออก ZM_DOWN_PHP_VERSION="8.2"# ตามค่าเริ่มต้น สคริปต์จะจัดเก็บ `zhamao-app` ของเฟรมเวิร์กไว้ในไดเร็กทอรีปัจจุบัน ไดเร็กทอรีสำหรับการติดตั้ง หากคุณต้องการใช้ไดเร็กทอรีอื่น ให้เพิ่มตัวแปรสภาพแวดล้อมนี้ Export ZM_CUSTOM_DIR="my-custom-app"# สคริปต์จะใช้อิมเมจการเร่งความเร็วภายในประเทศของ Alibaba Cloud สำหรับโปรเจ็กต์นี้ตามค่าเริ่มต้น เพิ่มตัวแปรสภาพแวดล้อมนี้export ZM_COMPOSER_PACKAGIST="yes"# หลังจากดำเนินการตัวแปรสภาพแวดล้อมก่อนหน้านี้ จากนั้นดำเนินการสคริปต์การติดตั้งด้วยคลิกเดียว คุณสามารถใช้พารามิเตอร์ที่กำหนดเองได้! ทุบตี <(curl -fsSL https://zhamao.xin/v3.sh)
ดูเอกสารประกอบสำหรับวิธีการติดตั้งอื่น
ดูเอกสาร (สร้างเองในจีน): https://framework.zhamao.xin/
ลิงค์สำรอง (โฮสติ้งต่างประเทศ): https://framework.zhamao.me/
การสนับสนุนดั้งเดิมสำหรับไคลเอนต์โรบ็อตหลายตัวเพื่อเชื่อมต่อพร้อมกัน
กลไกการเชื่อมโยงเหตุการณ์คำอธิบายประกอบที่ยืดหยุ่น ซึ่งสามารถใช้คำอธิบายประกอบและคำอธิบายประกอบแอตทริบิวต์ดั้งเดิมได้ในเวลาเดียวกัน
ระบบปลั๊กอินที่สมบูรณ์ ปลั๊กอินสามารถเขียนและบรรจุหรือแจกจ่ายเพื่อให้ผู้อื่นใช้งานได้
เขียนในรูปแบบปลั๊กอิน สามารถรวมเข้ากับส่วนประกอบ Composer อื่นๆ ได้อย่างอิสระ หรือเขียนเป็นไฟล์เดียวเพื่อดำเนินการได้
รองรับการบรรจุโมดูลและการโหลดแบบร้อน ทำให้สะดวกยิ่งขึ้นในการแชร์โมดูล
ตัวแปรแคชส่วนกลางที่อาศัยอยู่ในหน่วยความจำสามารถใช้งานได้ทุกที่ โดยนำเสนอโซลูชันการแคชที่หลากหลาย
มาพร้อมกับ MySQL, SQLite, Redis และพูลการเชื่อมต่อฐานข้อมูลอื่นๆ
เป็นเซิร์ฟเวอร์ HTTP และเซิร์ฟเวอร์ WebSocket และคุณสามารถสร้างอินเทอร์เฟซ HTTP API ของคุณเองได้
สภาพแวดล้อม PHP ในตัวที่เป็นทางเลือก ไม่จำเป็นต้องคอมไพล์และติดตั้งด้วยตนเอง โดย crazywhalecc/static-php-cli
หากคุณพบปัญหาใดๆ ในระหว่างการใช้งาน คุณสามารถส่งปัญหาหรือทางแยกได้ด้วยตัวเอง แก้ไขและส่งคำขอดึง
ปัจจุบัน โครงการนี้ดูแลโดยคนเพียงสองคนเท่านั้น ซึ่งใช้พลังงานมาก ดังนั้นจึงยินดีเป็นอย่างยิ่งที่จะมีส่วนร่วมในกรอบการทำงานนี้
โครงการนี้ได้รับการพัฒนาในเวลาว่างของผู้เขียน หากคุณพบว่ามีประโยชน์ คุณอาจต้องการบริจาค
เราจะใช้เงินบริจาคสำหรับค่าใช้จ่ายเซิร์ฟเวอร์ของ Explosive Bot และเอกสารประกอบกรอบการทำงานที่ขับเคลื่อนโดยโครงการนี้ รายการบริจาค
หากคุณไม่ต้องการมีส่วนร่วมโดยตรงในการพัฒนาเฟรมเวิร์ก คุณสามารถแชร์โมดูลที่คุณเขียนเพื่อช่วยปรับปรุงระบบนิเวศของเฟรมเวิร์กได้
เฟรมเวิร์กและ SDK เป็นส่วนหลักของเฟรมเวิร์กโอเพ่นซอร์สของโครงการ Explosive Robot หุ่นยนต์ระเบิดเป็นหุ่นยนต์ประสิทธิภาพสูงที่เขียนโดยผู้เขียน ซึ่งได้รับรางวัลชนะเลิศในการแข่งขันการออกแบบคอมพิวเตอร์แห่งชาติ
หุ่นยนต์ระเบิดของผู้เขียนทำงานอย่างเสถียรมา ห้าปี แล้วนับตั้งแต่ต้นปี 2018 และยังคงทำซ้ำต่อไป
คุณสามารถส่งปัญหาหรือเข้าร่วมกลุ่ม (670821194) เพื่อแก้ไขปัญหา
เมื่ออัปเดตเนื้อหาของโปรเจ็กต์นี้ โปรดใส่ใจกับการอัปเดต GitHub อย่างทันท่วงที โปรดสำรองข้อมูลปลั๊กอินหรือรหัสโปรเจ็กต์ของคุณก่อนที่จะอัปเดต
กรอบงานโครงการเป็นโอเพ่นซอร์สโดยใช้โปรโตคอล Apache-2.0 และต้องปฏิบัติตามโปรโตคอลเมื่อแจกจ่ายหรือเขียนใหม่และแก้ไข ส่วนปลั๊กอินของโปรเจ็กต์ (โฟลเดอร์อื่นนอกเหนือจากโฟลเดอร์ src/Globals
และ src/ZM
) สามารถแจกจ่ายและแก้ไขได้โดยไม่ต้องปฏิบัติตามโปรโตคอล Apache-2.0 (การประกาศลิขสิทธิ์) เมื่อไม่ได้อ้างอิงโค้ดภายในกรอบงาน
หมายเหตุ : เมื่อคุณใช้ซอฟต์แวร์โรบ็อตโปรโตคอล AGPL-3.0
เช่น mirai เพื่อเชื่อมต่อกับเฟรมเวิร์ก การใช้เฟรมเวิร์กนี้กำหนดให้คุณต้องแจกจ่ายส่วนที่คุณเขียนหรือแก้ไขโดยใช้โปรโตคอล AGPL-3.0
ใหม่
เมื่อบริจาครหัส โปรดเก็บข้อมูลที่ละเอียดอ่อนในไฟล์การกำหนดค่าส่วนกลางของคุณให้ปลอดภัย และอย่าอัปโหลดไฟล์การกำหนดค่าที่มีข้อมูลส่วนบุคคลไปยังเว็บไซต์ เช่น GitHub
ขอขอบคุณ JetBrains ที่ให้การสนับสนุนเครื่องมือพัฒนา PhpStorm สำหรับโครงการโอเพ่นซอร์สนี้:
ขอขอบคุณนักพัฒนา @sunxyw สำหรับคำแนะนำในการสร้างมาตรฐานการพัฒนาโครงการ