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

Gancho — جس کا ہسپانوی میں مطلب "ہک" ہے — Apple پلیٹ فارم فیملی کے لیے ایک MIT-لائسنس یافتہ، local-first کلپ بورڈ ہسٹری اور منتخب کردہ snippet لائبریری ہے۔ README کے مطابق یہ ورژن v0.8.3 میں ہے اور 1.0 کی طرف بڑھ رہا ہے، جس میں macOS بنیادی تخلیقی سطح ہے، iPhone/iPad ایپس میں extension سپورٹ موجود ہے، ایک iPad-مطابق visionOS بلڈ کی منصوبہ بندی ہے، اور watchOS صرف pins اور حالیہ آئٹمز تک محدود ہے۔ Android، Windows اور Linux کو صرف مستقبل کے تجزیے کے طور پر درج کیا گیا ہے، جن کے لیے کوئی یقینی commitment نہیں ہے۔ macOS پر کیپچر اور پرائیویسی کو ایک pasteboard مانیٹر کے ذریعے سنبھالا جاتا ہے جو adaptive low-power polling استعمال کرتا ہے، جو اسکرین لاک اور پرائیویٹ موڈ پر رک جاتا ہے، اپنی تحریروں کو دبا دیتا ہے، Universal Clipboard آئٹمز کو نشان زد کرتا ہے اور ٹیکسٹ، RTF، HTML، تصاویر اور فائل URLs جیسے بھرپور پے لوڈز کو محفوظ رکھتا ہے۔ ConcealedType، TransientType یا AutoGeneratedType کے طور پر نشان زدہ Pasteboard اقسام مواد پڑھنے سے پہلے کیپچر کو روک دیتی ہیں، اور ایک پری لوڈڈ پاس ورڈ مینیجر اور بینکنگ denylist کے ساتھ ساتھ "ignore next copy" ایکشن بھی شامل ہے۔ ایک آن-ڈیوائس ڈیٹیکٹر کارڈ نمبرز (Luhn)، AWS/Stripe/GitHub/Slack کیز، PEM کیز اور ممکنہ پاس ورڈز کی تلاش کرتا ہے، اور مختصر میعاد کے ساتھ ماسکڈ پری ویوز دکھاتا ہے۔ iOS، iPadOS اور visionOS پر، کیپچر صرف ارادی (intentional) ہوتا ہے — کوئی بیک گراؤنڈ pasteboard پولنگ نہیں ہوتی۔ پروجیکٹ کا بیان ہے کہ کلپ بورڈ مواد کبھی بھی لاگز، ٹیلی میٹری، کریش رپورٹس، اینالیٹکس یا سپورٹ بنڈلز میں نہیں لکھا جاتا۔ اسٹوریج کے لیے GRDB/SQLite کا استعمال کیا گیا ہے جس میں content-addressed disk blobs، lazy thumbnails، paged metadata-only لسٹس، ورژن شدہ migrations، ڈیوائس کے مطابق deduplication اور JSON/CSV ایکسپورٹ شامل ہیں۔ سرچ FTS5 پر مبنی ہے جس میں exact، fuzzy اور regex موڈز کے ساتھ ساتھ قسم، سورس ایپ اور تاریخ کے فلٹرز موجود ہیں، جسے 100k-آئٹم پرفارمنس ہارنس کے ذریعے سپورٹ کیا گیا ہے۔ ایک 512-dimension آن-ڈیوائس embedding index "Ask your clipboard" فیچر اور خودکار بورڈ تجاویز کو پاور کرتا ہے، جبکہ مین ہسٹری سرچ FTS5 ہی رہتا ہے۔ ایک retention انجن عالمی اور فی-قسم کی میعاد (expiry)، حساس مواد کی خودکار میعاد اور بیک گراؤنڈ پرجنگ لاگو کرتا ہے، جبکہ pins اس سے مستثنیٰ ہیں۔ macOS ایپ ایک مینو-بار ایجنٹ ہے جس میں ایک resizable floating ہسٹری پینل (Shift-Cmd-V)، کی بورڈ-فرسٹ type-to-search، کمپوزایبل فلٹرز، قابلِ ترمیم عنوانات، فی-قسم پری ویوز، ایک read-only فل-کنٹنٹ پری ویو، اور ایک مصنوعی Cmd-V کے ذریعے پیسٹ-بیک کی سہولت ہے۔ Pins، ملٹی-ممبرشپ بورڈز اور بورڈز اور snippets کے لیے ایک متحد Library نافذ ہیں، ساتھ ہی batch add-to-stack، add-to-board اور undo کے ساتھ ڈیلیٹ، ملٹی-سلیکشن، فائل کلپس کو ڈریگ کرنا، ساختہ redaction کے ساتھ curated Spotlight donation، اور ایک گائیڈڈ Maccy/CSV ہسٹری امپورٹ (جس میں read-only پری ویو، ویلیڈیشن، atomic deduplication اور کینسلیشن شامل ہے) موجود ہے۔ Raycast واضح طور پر امپورٹ سورس نہیں ہے، کیونکہ اس کا دستاویزی کلپ بورڈ API صرف چھ حالیہ اندراجات ظاہر کرتا ہے اور اس کے انکرپٹڈ بیک اپ کا کوئی دستاویزی تھرڈ پارٹی ڈی کوڈنگ اسکیم نہیں ہے۔ iPhone اور iPad ایپ صرف Save بٹن، UIPasteControl، ایک Share Extension اور App Intents/Shortcuts کے ذریعے ارادی کیپچر فراہم کرتی ہے، ساتھ ہی ہسٹری کے ساتھ ایک کی بورڈ ایکسٹینشن، وجٹس، iPad اسپلٹ ویو اور سورس-ایپ فلٹرنگ موجود ہے۔ اس کا آن-ڈیوائس انٹیلیجنس اسٹیک صفر نیٹ ورک کے ساتھ کام کرتا ہے: ایک deterministic tier-0 کلاسیفائر جو 5 ملی سیکنڈ سے کم وقت میں 17 اقسام کے مواد کو پہچانتا ہے، Apple Intelligence عنوانات، اسکرین شاٹ OCR، سیمیٹک انڈیکسنگ، Dev Actions (JWT decode، JSON فارمیٹنگ، Base64، URL پارسنگ، کلر کنورژن، UUID فارمیٹس) جو App Intents کے طور پر بھی دستیاب ہیں، Smart Paste ری رائٹس/ترجمہ/PII redaction، ہسٹری پر مبنی grounded Q&A، اور خودکار بورڈ تجاویز۔ انٹیلیجنس اسکرین پر ہر مرحلے کا اپنا ٹوگل موجود ہے۔ سنک (Sync) کے لیے SyncEngine باؤنڈری کے پیچھے صارف کے نجی iCloud ڈیٹا بیس پر CKSyncEngine استعمال ہوتا ہے، جس میں سنک اسٹیٹس واضح ہوتا ہے۔ انٹیگریشنز میں ایک gancho CLI، ایک مقامی opt-in MCP سرور (جس میں میعاد ختم ہونے والے اور قابلِ واپسی فی-کلائنٹ گرانٹس، واضح بورڈ/ٹائم سیاق و سباق، آزاد read/write اجازتیں اور ایک metadata-only ایکسیس لاگ شامل ہے)، اور ایک VS Code "Save Selection" کمانڈ شامل ہے۔ مونیٹائزیشن StoreKit 2 پرچیز، ریسٹور اور entitlement پلمبنگ کے ساتھ ایک سیاق و سباق کے مطابق پے وال اور فری-ٹیر حدود کا استعمال کرتی ہے؛ ڈائریکٹ ڈاؤن لوڈ بلڈ Lemon Squeezy کے ذریعے ادائیگی کے خفیہ راز (payments secret) کو ایمبیڈ کیے بغیر Pro لائسنس خرید، ایکٹیویٹ، ری ویلیڈیٹ اور ڈی ایکٹیویٹ کر سکتا ہے، اور Pro انکرپٹڈ iCloud سنک کو ان لاک کرتا ہے۔ اختیاری گمنام تشخیص (diagnostics) واضح رضامندی تک بند رہتے ہیں، اور پرائیویسی سینٹر کی ایکٹیویٹی رسید ڈیوائس پر 13 مہینوں تک فی-ایپ ٹوٹلز رکھتی ہے جسے سنک یا ایکسپورٹ نہیں کیا جاتا۔ انجینئرنگ کے لحاظ سے پروجیکٹ XcodeGen، Swift 6 strict concurrency، ایک دو لسانی انگریزی/ہسپانوی String Catalog گیٹ، accessibility سپورٹ، اور ایک واحد SwiftPM پیکیج (GanchoKit) استعمال کرتا ہے جس میں آٹھ لائبریری پروڈکٹس اور ایک CLI شامل ہے۔ CI میں بلڈ، ٹیسٹ اور لنٹ، ایک نافذ شدہ پروڈکشن-سورس کوریج فلور، سیریلائزڈ StoreKit آٹومیشن اور اسکیل پرفارمنس شامل ہیں۔ بلڈنگ کے لیے macOS 15.4+، Xcode 26+ اور XcodeGen درکار ہے، جس میں ٹیسٹ، iOS ڈیوائس انسٹالز، پیکیجنگ، ریلیز QA اور سائٹ چیکس کے لیے دستاویزی make ٹارگٹس موجود ہیں۔ README میں GRDB.swift، SQLCipher، KeyboardShortcuts، Sauce اور TelemetryDeck کو بنیادی اوپن سورس کام کے طور پر کریڈٹ دیا گیا ہے۔ لائسنس: MIT، © 2026 Johnny Young۔