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

织流 Loom ایک مقامی طور پر چلنے والا ایجنٹ پائپ لائن ورک بینچ ہے، جس کا مقصد ریاضیاتی ماڈلنگ، تحقیقی رپورٹس، طویل دستاویزات کی تحریر جیسے پیچیدہ کاموں کی پوری زنجیر کو حل کرنا ہے۔ یہ کام کو قابل ترمیم کثیر المرحلہ عمل میں تقسیم کرتا ہے، ہر مرحلے کو مہارت (skill)، مصنوعہ فائل نام، کردار (عمل/جائزہ/ترمیم)، انجن اور ماڈل سے منسلک کیا جا سکتا ہے، اور چیک پوائنٹ پر رک کر تصدیق کا انتظار کرنے کی سہولت بھی ہے۔ بنیادی خصوصیات: - **عمل کی ترتیب**: بصری طور پر مراحل شامل/حذف کریں، ہر مرحلے کو لچکدار طریقے سے ترتیب دیں۔ - **مہارت کا ذخیرہ**: ہر مرحلے کے پرامپٹ اصولوں کا انتظام، نئی تخلیق، ترمیم، نقل محفوظ کرنا، اور معیاری skill پیکج (zip / SKILL.md) درآمد کرنا۔ - **عمل درآمد**: SSE کے ذریعے حقیقی وقت میں اسٹریمنگ عمل درآمد، ٹرانسکرپٹ علاقے میں ٹول کالز اور آؤٹ پٹ مرحلہ وار ظاہر ہوتے ہیں، اوپر دائیں کونے میں پروسیس کارڈ ہر مرحلے کی حالت دکھاتا ہے، ورک اسپیس فائل پینل میں ایجنٹ کی لکھی جا رہی فائلیں حقیقی وقت میں فہرست ہوتی ہیں (markdown موقع پر رینڈر، تصاویر/PDF اندرونی پیش نظارہ)۔ - **مکالماتی جزوی ترمیم**: مکمل ہونے کے بعد غیر مطمئن ہونے پر، کسی مرحلے کی طرف اشارہ کر کے بتائیں کہ کیسے تبدیل کرنا ہے، صرف وہی مرحلہ دوبارہ لکھا جائے گا، پورا عمل دوبارہ چلانے کی ضرورت نہیں۔ - **عمل کی درآمد/برآمد**: ایک عمل = ایک JSON فائل، شیئر، بیک اپ، واپس درآمد کی جا سکتی ہے۔ ایک سخت اصول: متن صرف مقامی CLI ایجنٹ ہی تیار کر سکتا ہے۔ Loom خود کسی بڑے ماڈل API سے براہ راست جڑ کر مواد نہیں بناتا، سیٹنگز میں API پریسیٹ صرف endpoint/کلید/ماڈل کو Claude Code یا Codex CLI میں داخل کرنے کے لیے ہیں۔ استعمال سے پہلے ان میں سے ایک انسٹال اور لاگ ان کرنا ضروری ہے: Claude Code (`claude` کمانڈ دستیاب ہو) یا Codex CLI (`codex` کمانڈ دستیاب ہو)۔ سورس کوڈ سے چلانا: ```bash pip install -r requirements.txt python run.py # http://127.0.0.1:8000 python run.py --port 8001 # پورٹ تبدیل کریں python run.py --auto-kill # پورٹ پرانا پروسیس استعمال کر رہا ہو تو خودکار آزاد کریں ``` رجعت ٹیسٹ (نیٹ ورک کی ضرورت نہیں): ```bash python -m pytest -q ``` ڈائریکٹری ڈھانچہ: - `app/`: FastAPI بیک اینڈ، جس میں `main.py` (روٹنگ اور تمام /api)، `runner.py` (عمل درآمد انجن: چیک پوائنٹ، SSE ایونٹ اسٹریم، ورک اسپیس، مصنوعات)، `agents.py` (Claude / Codex CLI اڈاپٹر لیئر)، `updater.py` (اپ ڈیٹ چیک، انسٹالر ڈاؤن لوڈ، sha256 تصدیق)۔ - `static/`: فرنٹ اینڈ (خالص HTML/CSS/JS، کوئی فریم ورک نہیں، کوئی بلڈ اسٹیپ نہیں)۔ - `tests/`: pytest رجعت ٹیسٹ، بشمول اسٹیٹک اثاثہ کنٹریکٹ ٹیسٹ۔ - `loom_launch.py`: پیک شدہ انٹری (pywebview مقامی ونڈو، ناکامی پر براؤزر پر واپس)۔ - `run.py`: سورس انٹری۔ - `make_release.py`: PyInstaller onedir + Inno Setup → release/Loom-<ورژن>-setup.exe۔ - `upload_cos.py`: انسٹالر اور latest.json کو Tencent Cloud COS پر اپ لوڈ کریں۔ ڈیٹا ڈائریکٹری: سورس میں `modex-data/`، انسٹال کے بعد exe کے ساتھ `data/` (SQLite + ورک اسپیس + خود ساختہ مہارتیں + برآمدات)۔ اپ گریڈ اسے اوور رائٹ نہیں کرتا، ان انسٹال بھی اسے حذف نہیں کرتا۔ پیکنگ اور ریلیز: ```bash python make_icon.py # صرف آئیکن تبدیل کرنے پر ضروری python make_release.py --version 1.0.1 --notes "…" # setup.exe + latest.json تیار python upload_cos.py # COS پر اپ لوڈ (مقامی کلید فائل ضروری، ریپو میں شامل نہیں) ``` انسٹالر صرف ایپلیکیشن اور انحصارات لے کر جاتا ہے، ڈویلپمنٹ مشین کا `modex-data/` شامل نہیں ہوتا (`make_release.py` میں واضح چیک موجود ہے)۔ رازداری: کوئی سرور اکاؤنٹ سسٹم نہیں، کوئی ٹریکنگ نہیں، کوئی مواد اپ لوڈ نہیں ہوتا۔ عمل، پرامپٹس، مصنوعات سب مقامی رہتے ہیں۔ واحد بیرونی درخواست اپ ڈیٹ چیک کے وقت ورژن مینی فیسٹ پڑھنا، اور ایجنٹ CLI کا خود ماڈل سروس سے رابطہ ہے۔ ڈاؤن لوڈ: https://lxlrwxs.top/modelflow/ ｜ Windows 10/11 درکار ｜ مکمل مقامی عمل، کوئی اکاؤنٹ نہیں، کوئی ٹیلی میٹری نہیں۔