မောင်သုည

💖 AI Girl Bot (ချစ်လေး) စနစ် - တည်ဆောက်ရန် လမ်းညွှန်ချက် (30 / 06 / 2025) 💖

✨ နိဒါန်း

ဒီ AI Girl Bot (ချစ်လေး) စနစ်ဟာ အခုဆိုရင် (fixed:version v20.0) ကျွန်တော်ရဲ့ AI Girl Bot စနစ်တစ်ခုလုံးကို အစအဆုံး တည်ဆောက်ပုံ၊ ထိန်းသိမ်းပုံ၊ အသုံးပြုပုံများကို အသေးစိတ် ပြုစုရန်အတွက်။

⚙️ အပိုင်း (၁) - Bot စနစ်ခြုံငုံသုံးသပ်ချက်

🚀 အပိုင်း (၂) - GitHub နှင့် Cloudflare Pages တွင် တည်ဆောက်ခြင်း အသေးစိတ်ကို ဖော်ပြထားပါသည်။

၁။ GitHub Repository အတွက် စတင်ပြင်ဆင်ပါ။

၂။ Cloudflare Pages Project တည်ဆောက်ခြင်း

🔑 အပိုင်း (၃) - Cloudflare Pages Environment Variables နှင့် KV Bindings အပြည့်စုံ သတ်မှတ်ပေးပါ။

Bot စနစ် မှန်မှန်ကန်ကန် အလုပ်လုပ်ဖို့အတွက် အောက်ပါ Environment Variables နဲ့ KV Namespace Bindings တွေကို သတ်မှတ်ပေးဖို့ အရေးကြီးပါတယ်။

၁။ Environment Variables များ သတ်မှတ်ခြင်း

Cloudflare Pages Project ရဲ့ Settings -> Environment Variables အောက်မှာ အောက်ပါ Variable များကို "Add variable" ဖြင့် တစ်ခုချင်းစီ ထည့်သွင်းပေးပါ။

Variable Name Value (သင့်တန်ဖိုးကို ဤနေရာတွင် ထည့်ပါ) မှတ်ချက်
TELEGRAM_BOT_TOKEN Bot Token ထည့်ရန် ကိုယ့် Telegram Bot ရဲ့ Token ပါ။ BotFather တွင် Bot လုပ်နိူင်ပါတယ်။
GEMINI_API_KEY Gemini API Key ထည့်ရန် Google Gemini API Key ပါ။ Google AI Studio ကနေ mail ဖြင့် ထုတ်ယူပါ။ AI စွမ်းဆောင်ရည်အတွက် မရှိမဖြစ်လိုအပ်ပါသည်။
LICENSE_SERVER_URL https://license-api-server.pages.dev/ Bot စနစ်တစ်ခုလုံး အလုပ်လုပ်ဖို့အတွက် License Server URL ပါ။ (ကိုယ့်ရဲ့ License API Server URL ကို ထည့်ပါ)
LICENSE_KEY LICENSE_ZERO_003 Bot စနစ်တစ်ခုလုံးအတွက် License Key ပါ။ (ကိုယ့်ရဲ့ License Key ကို ထည့်ပါ)မှတ်ချက်:ကြိုက်နှစ်သက်ရာ
AI_LICENSE_SERVER_URL https://license-api-server.pages.dev/ AI စွမ်းဆောင်ရည်အတွက် License Server URL ပါ။ (ကိုယ့်ရဲ့ အရင် License API Server URL ကိုပဲ ထပ်ထည့်ပါ)
AI_LICENSE_KEY AI_KEY_FOR_KOKO_MAUNG_THONYA_2025_ULTRA_SECURE_V1 AI စွမ်းဆောင်ရည်အတွက် License Key ပါ။ (ကိုယ့်ရဲ့:AI_LICENSE_KEY ကိုထည့်ပါ။)မှတ်ချက်:ကြိုက်နှစ်သက်ရာ(Master Control Active)

၂။ KV Namespace Bindings များ ချိတ်ဆက်ခြင်း

Cloudflare Pages Project ရဲ့ Settings -> Environment Variables အောက်မှာ "KV Namespace Bindings" ဆိုတဲ့ ခေါင်းစဉ်အောက်မှာ အောက်ပါ Bindings များကို "Add binding" ဖြင့် ချိတ်ဆက်ပေးပါ။

Variable Name KV Namespace Name (အသစ်ဖန်တီးရန်) မှတ်ချက်
BOT_DATA_KV BOT_DATA_KV Owner က သိမ်းဆည်းထားတဲ့ Key Text Content နဲ့ File ID တွေကို သိမ်းဖို့။ (အသစ်တစ်ခု ဖန်တီးပြီး နာမည် BOT_DATA_KV ပေးပါ)
CHAT_HISTORY_KV CHAT_HISTORY_KV Group Chat Summarization အတွက် Chat History တွေ သိမ်းဖို့။ (အသစ်တစ်ခု ဖန်တီးပြီး နာမည် CHAT_HISTORY_KV ပေးပါ)
SUMMARY_KV SUMMARY_KV Group Summary HTML Page တွေကို ယာယီသိမ်းဖို့။ (အသစ်တစ်ခု ဖန်တီးပြီး နာမည် SUMMARY_KV ပေးပါ)

ဘယ်လိုချိတ်ဆက်ရမလဲဆိုရင် ဥပမာ (BOT_DATA_KV အတွက်):

အထူးဂရုပြုရန်: Environment Variables တွေနဲ့ KV Bindings တွေ ပြောင်းလဲပြီးတာနဲ့ Cloudflare Pages ကနေ Project ကို Re-deploy လုပ်ပေးဖို့ လိုအပ်ပါတယ်။ ဒါမှ အပြောင်းအလဲတွေအတွက် ပြန်ပြီးအဆင်ပြေမှာပါ။

🔗 အပိုင်း (၄) - Webhook သတ်မှတ်ခြင်း

Cloudflare Pages Function ကို Telegram ကနေ Update တွေ ပို့ပေးဖို့ Webhook ကို သတ်မှတ်ရပါမယ်။

၁။ Project URL ကို ရှာပါ:

၂။ Webhook Register လုပ်ပါ:

၃။ (ရွေးချယ်ရန်) Webhook Unregister လုပ်ရန်:

💬 အပိုင်း (၅) - AI Girl Bot (ချစ်လေး) အသုံးပြုပုံလမ်းညွှန်

အောက်ပါ Commands များကို AI Girl Bot (ချစ်လေး) နှင့် စကားပြောဆိုရာတွင် အသုံးပြုနိုင်ပါတယ်။

၁။ အထွေထွေ အသုံးပြုမှုများ (General Usage)

၂။ Owner-Specific Data Management Commands (ကိုယ့်တစ်ယောက်ထဲအတွက်သာ)

ဤ Commands များသည် OWNER_ADMIN_IDS တွင် သတ်မှတ်ထားသော ကိုယ့်ရဲ့ Telegram ID မှသာ အလုပ်လုပ်ပါမည်။ Bot ရဲ့ Private Chat (သို့မဟုတ်) Group Chat နှစ်ခုလုံးမှ သုံးနိုင်ပါတယ်။

(က) Key Text Content သိမ်းဆည်းခြင်း (/setkey)

(ခ) File သိမ်းဆည်းခြင်း (/setfile)

(ဂ) သိမ်းထားသော Key Text Content ပြန်ထုတ်ခြင်း (/key)

(ဃ) သိမ်းထားသော File ပြန်ထုတ်ခြင်း (/file)

(င) သိမ်းထားသော Key ဖျက်ခြင်း (/deletekey)

(စ) သိမ်းထားသော File ဖျက်ခြင်း (/deletefile)

၃။ အထောက်အကူပြု Commands များ (Utility Commands)

🎉 နိဂုံး

*** ကျွန်တော်ရဲ့ AI Girl Bot (ချစ်လေး) စနစ်ဟာ (Fixed Versions v20.0) ဖြစ်ပါတယ်။

* ဒီ Documentation ဟာ ကျွန်တော်ရဲ့ အထောက်အကူပြုမယ့် လမ်းညွှန်မှု Note ဖြစ်ပါတယ်။

💖 Ai Girl Bot(ချစ်လေး) by မောင်သုည 💖

💖 ThankYou For All 💖