عن المشروع

تيك هو تطبيق ماك مجاني ومفتوح المصدر ينقل قوائم المهام الخاصة بك من شريط القوائم إلى سطح المكتب كملاحظات لاصقة عائمة. كل ملاحظة هي قائمة تحقق مستقلة يمكنك سحبها وتغيير حجمها وتخصيصها، مما يسهل إبقاء المهام مرئية أثناء العمل. ## الميزات الرئيسية - **ملاحظات لاصقة عائمة** – لوحات بدون حدود قابلة للسحب وتغيير الحجم. يمكنك اختياريًا إبقاء ملاحظة عائمة فوق النوافذ الأخرى أو إظهارها في جميع المساحات. يتم تذكر المواضع والحالات بين عمليات الإطلاق. - **قوائم متعددة** – إنشاء قوائم جديدة من شريط القوائم، أو باستخدام ⌘N، أو زر + داخل الملاحظة، أو قائمة الإرساء. يتم تسمية القوائم الجديدة تلقائيًا القائمة 1، القائمة 2، إلخ. - **مهام غنية** – دعم مهام فرعية حتى 3 مستويات عمقًا (إكمال مهمة أصلية يكمل مهامها الفرعية)، وملاحظات متعددة الأسطر (Shift-Return)، وتنسيق ماركداون سطري (غامق، مائل، كود، يتوسطه خط، روابط). اضغط للتحرير، واسحب لإعادة الترتيب، أو اسحب لليمين للتضمين. - **ملاحظات صلبة أو زجاجية سائلة** – اختر سمات ألوان لكل ملاحظة أو مادة شفافة تسمح برؤية سطح المكتب من خلالها. - **الطي** – انقر نقرًا مزدوجًا على شريط عنوان الملاحظة لطيها إلى الرأس فقط. - **لوحة بحث بأسلوب Raycast** – لوحة أوامر عائمة ومركزية للبحث أو الفتح أو حذف أي قائمة، مع تنقل كامل بلوحة المفاتيح. - **الإطلاق عند تسجيل الدخول** – بدء تلقائي اختياري، بالإضافة إلى أيقونة شريط قوائم مخصصة وهووية إرساء أصلية. ## المتطلبات - macOS 14 (Sonoma) أو أحدث. ## التثبيت 1. قم بتنزيل أحدث `Tic-vX.Y.Z.zip` من [صفحة الإصدارات](https://github.com/kasvith/tic/releases)، وفك ضغطه، وانقل `Tic.app` إلى `/Applications`. 2. تيك موقّع بشكل مخصص (غير موثّق)، لذلك قد يحظره Gatekeeper عند الإطلاق الأول. امسح علامة الحجر الصحي باستخدام: ```sh xattr -c /Applications/Tic.app ``` ثم افتحه بشكل طبيعي. بدلاً من ذلك، انقر بزر الماوس الأيمن على `Tic.app` ← فتح ← فتح. 3. لبدء تشغيل تيك تلقائيًا، فعّل **الإطلاق عند تسجيل الدخول** من قائمة شريط القوائم. ## البناء من المصدر تيك هو حزمة Swift، لذلك لا حاجة إلى `.xcodeproj`. ```sh swift run # بناء + تشغيل (تطوير) swift build -c release # بناء إصدار swift test # تشغيل مجموعة الاختبارات (اختبار Swift) ./scripts/package.sh # تجميع dist/Tic.app (أضف --open لتشغيله) open Package.swift # التحرير في Xcode ``` ## الاستخدام - تعرض أيقونة شريط القوائم قوائمك الأخيرة (مع قائمة فرعية **المزيد من القوائم** للباقي) وتوفر وصولاً سريعًا إلى **البحث في القوائم…** و**قائمة جديدة** (⌘N) و**الإطلاق عند تسجيل الدخول**. - مرر فوق ملاحظة لكشف عناصر التحكم الخاصة بها: اللون، صلب/زجاجي، عائم في الأعلى، طي، **+** قائمة جديدة، وإغلاق. انقر على العنوان لإعادة تسميته؛ الحقل السفلي يضيف المهام (Return يحافظ على التركيز). - مرر فوق مهمة لكشف **✕** (حذف) و**＋** سطرًا تحتها – انقر عليه لإضافة مهمة فرعية متداخلة تحت الصف. تختفي المهام الفارغة عند النقر بعيدًا. ## اختصارات لوحة المفاتيح | الاختصار | الإجراء | | --- | --- | | **Return** | إنهاء تحرير مهمة / إضافة المهمة المكتوبة | | **Shift-Return** (أو **⌥ Return**) | سطر جديد داخل نفس المهمة | | **Shift-Tab** | جعل المهمة مهمة فرعية (تضمين مستوى أعمق) | | **⌃ Shift-Tab** | إلغاء تضمين مهمة فرعية (إخراجها مرة أخرى) | | **⌘N** | قائمة جديدة | | **نقر مزدوج** على شريط العنوان | طي الملاحظة لأعلى / لأسفل | يمكنك أيضًا سحب مهمة لإعادة ترتيبها، أو سحبها لليمين لتضمينها – يظهر مؤشر الإفلات أين (وفي أي مستوى) ستهبط. أثناء التحرير، يظهر تلميح صغير للمفاتيح (⇧⏎ سطر، ⇧⇥ تضمين) في الحقل حتى لا تضطر إلى حفظ الجدول. ## البنية يستخدم تيك طرق عرض SwiftUI مستضافة داخل `NSPanel`s الخاصة بـ AppKit (الطريقة الوحيدة لتحقيق سلوك لاصق حقيقي لسطح المكتب)، مدعومة بـ SQLite عبر GRDB. يربط منسق `AppModel` شريط القوائم بطبقة النوافذ. راجع `CLAUDE.md` للتحليل الكامل. **المكدس:** Swift 6 · SwiftUI + AppKit · GRDB (SQLite) · `SMAppService` (عنصر تسجيل الدخول). ## التطوير والإصدارات - **CI** (`.github/workflows/ci.yml`) يبني ويختبر ويفحص على كل دفع/PR. - يتم إنشاء **سجل التغييرات** من [الالتزامات التقليدية](https://www.conventionalcommits.org) باستخدام [git-cliff](https://git-cliff.org) (`cliff.toml`) ويُحفظ في `CHANGELOG.md`. - **الإصدارات مبنية على العلامات:** ادفع علامة `v*` وسيقوم سير عمل الإصدار ببناء `Tic.app`، وإنشاء ملاحظات الإصدار، ونشر إصدار GitHub مع التطبيق المضغوط. ```sh git tag v0.1.0 && git push origin v0.1.0 ``` يوجد الفن المصدر للأيقونة في `Assets/` (AppIcon / Flat / MenuBar). ## الترخيص صدر بموجب [رخصة MIT](LICENSE). © 2026 كاسون فيثاناجي.