منصوبے کے بارے میں

# ABB — چیٹ سافٹ ویئر کو اپنا AI اسسٹنٹ بنائیں ABB ایک مستقل مینیو بار (Windows ٹرے) میں موجود مقامی AI اسسٹنٹ ہے جو Feishu، WeChat اور DingTalk کے بوٹ پیغامات کو پیکج کے ساتھ شامل AI ایجنٹ (buzz-agent) سے جوڑتا ہے۔ صارفین کو کمانڈ لائن ٹولز انسٹال کرنے کی ضرورت نہیں، وہ براہ راست چیٹ میں مقامی ماڈلز کو استعمال کر کے معلومات تلاش کرنے، کوڈ لکھنے، دستاویزات ترتیب دینے، وقت پر یاد دہانی وغیرہ جیسے کام مکمل کر سکتے ہیں۔ ## بنیادی خصوصیات - **ملٹی پلیٹ فارم رسائی**: Feishu (آفیشل لانگ کنکشن)، WeChat (QR کوڈ لاگ ان)، DingTalk (انٹرپرائز انٹرنل ایپ) کو سپورٹ کرتا ہے، ایک ساتھ متعدد بوٹس منسلک کیے جا سکتے ہیں، ہر ایک کی اپنی آزاد ماڈل کنفیگریشن ہوتی ہے۔ - **فوری استعمال کے لیے تیار**: ایگزیکیوشن لیئر پیکج کے ساتھ شامل ہے، اضافی انسٹالیشن کی ضرورت نہیں؛ ماڈلز Anthropic نیٹو اور کسی بھی OpenAI کمپیٹیبل فراہم کنندہ (DeepSeek، Tongyi، Kimi وغیرہ) کو سپورٹ کرتے ہیں، سیٹنگز میں خود شامل کیا جا سکتا ہے۔ - **پرائیویسی اور سیکیورٹی**: تمام چیٹ مواد، کیز اور ماڈل کالز صرف مقامی مشین پر پروسیس ہوتی ہیں (ڈیٹا ڈائریکٹری `~/.agent-bridge`)، ABB کا کوئی سرور نہیں ہے، ڈیٹا کسی تھرڈ پارٹی کے ذریعے منتقل نہیں ہوتا۔ - **ملٹی ٹرن گفتگو**: ہر بوٹ کی اپنی آزاد میموری ہوتی ہے، `/new` سے نیا سیشن بنایا جا سکتا ہے، `/cancel` سے ٹاسک منسوخ کیا جا سکتا ہے؛ حوالہ شدہ پیغامات خود بخود حوالہ شدہ مواد کے ساتھ آتے ہیں۔ - **شیڈولڈ ٹاسک**: قدرتی زبان میں بنائیں (جیسے "ہر روز صبح 9 بجے مجھے اسٹینڈ اپ میٹنگ کی یاد دلائیں")، وقت پر نتائج خود بخود چیٹ میں واپس بھیجے جاتے ہیں۔ - **ڈیلیٹ پروٹیکشن**: ڈیفالٹ طور پر ری سائیکل بن میکانزم فعال ہے، ڈیلیٹ آپریشنز واپس کیے جا سکتے ہیں اور ٹریس کیے جا سکتے ہیں؛ خطرناک ڈیلیٹ (≥50MB یا کوڈ خصوصیات پر مشتمل) کے لیے دوسری تصدیق درکار ہے؛ git موجود ہونے پر خود بخود اسنیپ شاٹ محفوظ ہوتا ہے۔ - **کراس سیشن ڈیلیوری**: ایجنٹ پیغامات/ٹاسک نتائج دوسرے بوٹس کے سیشنز میں بھیج سکتا ہے، شیڈولڈ ٹاسک کے متعدد اہداف کو سپورٹ کرتا ہے۔ ## فوری آغاز 1. [Releases](https://github.com/gqf2008/abb/releases) سے متعلقہ پلیٹ فارم کا انسٹالیشن پیکج ڈاؤن لوڈ کریں (macOS صرف Apple Silicon، Windows بغیر ایڈمن انسٹالیشن کے)۔ 2. ABB کھولیں، سیٹنگز میں Feishu/WeChat/DingTalk بوٹ شامل کریں (WeChat QR کوڈ لاگ ان کافی ہے)۔ 3. بوٹ کی پرائیویٹ چیٹ میں پہلا پیغام بھیجیں، گفتگو شروع ہو جائے گی۔ ## اجازت یافتہ صارف کی تنہائی (سیکیورٹی ڈیفالٹ) اجازت نامے کے ذریعے داخل ہونے والے اجازت یافتہ صارفین (نان owner) ڈیفالٹ طور پر محدود موڈ میں چلتے ہیں: وہ صرف اس بوٹ کے ورک اسپیس کے اندر فائلیں پڑھ/لکھ سکتے ہیں، صرف وائٹ لسٹ شدہ کمانڈز چلا سکتے ہیں، انٹرنیٹ تک رسائی یا ورک اسپیس سے باہر کے راستوں تک رسائی نہیں رکھتے۔ owner سیشن متاثر نہیں ہوتا، اس پابندی کو سیٹنگز میں بند کیا جا سکتا ہے۔ ## عمومی سوالات - **Intel Mac سپورٹ؟** فی الحال سپورٹ نہیں، صرف Apple Silicon (arm64) انسٹالیشن پیکج فراہم کیا جاتا ہے۔ - **کون سے ماڈلز سپورٹ ہیں؟** کوئی بھی Anthropic نیٹو / OpenAI کمپیٹیبل فراہم کنندہ، سیٹنگز میں شامل کریں۔ - **شیڈولڈ ٹاسک کام نہیں کر رہا؟** یقینی بنائیں کہ ٹرے سروس چل رہی ہے (سبز حالت)، ٹاسک کے نتائج اس سیشن میں واپس بھیجے جائیں گے جہاں سے بنایا گیا تھا۔ ## ڈویلپر بلڈ اسی مصنف کی [slint-pixel](https://github.com/gqf2008/slint-pixel) کمپوننٹ لائبریری پر انحصار کرتا ہے، اسے ہم سطح ڈائریکٹری میں کلون کر کے بلڈ کریں: ```sh git clone https://github.com/gqf2008/abb.git git clone https://github.com/gqf2008/slint-pixel.git cd abb && cargo build --release ``` ## لائسنس ABB کا مرکزی حصہ MIT استعمال کرتا ہے، پیکج کے ساتھ شامل تھرڈ پارٹی اجزاء (buzz-agent، rg، jq، uv، gh وغیرہ) اپنے اپنے لائسنس برقرار رکھتے ہیں۔