Files
vibe-coding-college-specs/chapters/03-workspace-setup/02-lesson-desktop-apps/spec.md

9.4 KiB
Raw Blame History

مشخصات درس‌نامه: ابزارهای دسکتاپ (Cursor، Antigravity و اپ‌های دسکتاپ AI)

  • شناسه در سیلابس: L3.3
  • فصل: فصل ۳: راه‌اندازی محیط کار (Ch 3)
  • نوع محتوا: 📘 درس‌نامه متنی
  • زمان تقریبی مطالعه: ۱۵ دقیقه
  • پیش‌نیازهای مستقیم: L3.2 (آماده‌سازی سیستم)

۱. اهداف یادگیری (Learning Objectives - Bloom's Taxonomy)

دانشجو پس از مطالعهٔ این درس‌نامه باید بتواند:

  • به‌کار ببندد (Apply): ویرایشگر هوشمند Cursor را روی سیستم‌عامل خود (ویندوز، مک، لینوکس) با استفاده از راهنمای کشویی دانلود و نصب کند.
  • درک کند (Understand): آناتومی و بخش‌های اصلی رابط کاربری Cursor شامل: درخت فایل‌ها (File Tree)، پنجره چت هوش مصنوعی (Ctrl+L) و حالت کامپوزر یا ایجنت چندفایلی (Ctrl+I) چگونه کار می‌کنند.
  • به‌کار ببندد (Apply): مدل‌های هوش مصنوعی مورد نظر (Claude 3.5 Sonnet و GPT-4o) را در تنظیمات ادیتور انتخاب و آماده به کار سازد.
  • درک کند (Understand): جایگاه سایر ابزارهای دسکتاپ مانند Antigravity IDE و اپلیکیشن‌های کمکی رومیزی (ChatGPT Desktop و Claude Desktop) در چرخه توسعه محصول چیست.
  • به‌کار ببندد (Apply): کلیدهای میانبر اصلی کار با هوش مصنوعی در ادیتور دسکتاپ را به حافظه بسپارد و اولین تعامل تستی را اجرا کند.

۲. محدوده و مرزهای محتوا (Scope & Boundaries)

آنچه باید پوشش داده شود (In-Scope):

  1. معرفی Cursor به عنوان خانه اصلی کدنویسی در این دوره:
    • چرا Cursor بر پایه VS Code ساخته شده و چرا تجربه کاربری آن برای کار با ایجنت‌های هوش مصنوعی ایده‌آل است.
  2. راهنمای نصب چندسکویی Cursor (با منوهای کشویی جداگانه):
    • <details><summary>راهنمای نصب در ویندوز (Windows)</summary> ... </details>: دانلود اینستالر، نصب و تنظیم در منوی راست‌کلیک.
    • <details><summary>راهنمای نصب در مک‌اواس (macOS)</summary> ... </details>: دانلود پکیج dmg یا یونیورسال، انتقال به Applications و فعال‌سازی فرمان code/cursor در ترمینال.
    • <details><summary>راهنمای نصب در لینوکس (Linux - AppImage / Deb)</summary> ... </details>: شیوه اجرای پکیج با دسترسی اجرایی (chmod +x).
  3. تور تصویری رابط کاربری Cursor (Interface Tour):
    • سایدبار و نوار فایل‌ها (File Explorer).
    • تب ویرایشگر اصلی و پیش‌نمایش.
    • پنل چت هوشمند (Ctrl+L / Cmd+L) برای سوالات و توضیحات کد.
    • حالت کامپوزر / ایجنت (Ctrl+I / Cmd+I) برای ایجاد و ویرایش همزمان چندین فایل در پروژه.
  4. انتخاب و جابجایی مدل‌ها (Model Selection):
    • نحوه سوئیچ بین Claude 3.5 Sonnet، GPT-4o و مدل‌های بهینه دیگر در تنظیمات.
  5. معرفی ابزارهای تکمیلی دسکتاپ (Antigravity و همراهان هوشمند):
    • معرفی Antigravity IDE و ویژگی‌های مدرن ارکستراسیون ایجنت‌ها.
    • اپلیکیشن‌های دسکتاپ ChatGPT و Claude Desktop برای اشتراک‌گذاری سریع صفحه و چت فراداده‌ای.
  6. کال‌اوت‌های Quera:
    • <details class="violet">: کلیدهای میانبر جادویی Cursor که هر وایب کدری باید مثل موم در دست داشته باشد.
    • <details class="green">: انتقال تنظیمات و افزونه‌ها از VS Code به Cursor تنها با یک کلیک در نخستین ورود (One-Click Migration).

آنچه نباید وارد آن شویم (Out-of-Scope):

  • راه‌اندازی ایجنت‌های خط فرمان و ترمینال مثل Claude Code (در درس ۳.۴).
  • پیکربندی عمیق سرورهای MCP (در درس ۳.۷).

۳. مفاهیم کلیدی و کلمات تخصصی (Key Concepts & Terms)

اصطلاح انگلیسی معادل فارسی مصوب توضیح یک‌خطی ساده
Cursor IDE محیط توسعه کرسر ویرایشگر پیشرفته بر پایه VS Code با هوش مصنوعی بومی‌سازی‌شده در هسته
Composer / Agent Mode حالت کامپوزر / ایجنت قابلیت ویرایش، ساخت و اصلاح خودکار همزمان چندین فایل با یک پرامپت در ادیتور
In-line Editing ویرایش درون‌خطی درخواست اصلاح یا بازنویسی بخشی از یک فایل مشخص با کلید میانبر Ctrl+K
Context Indexing نمایه‌سازی کانتکست کدبیس فرآیند اسکن خودکار تمام فایل‌های پروژه توسط ادیتور برای فهم بهتر روابط کدها
One-Click Migration مهاجرت با یک کلیک انتقال فوری تمامی تم‌ها، کلیدها و افزونه‌ها از VS Code به محیط Cursor

۴. جایگاه‌های تصاویر و نمودارها (Visual & Diagram Placeholders)

راهنمای ایجنت نویسنده: تمام تصاویر باید در پوشهٔ images/ قرار گرفته و در قالب جدول تک‌خانه‌ای وسط‌چین با کپشن تفصیلی درج شوند:

  1. تصویر کاور درس: images/cover.png
    • موضوع: کاور مدرن نمایش‌دهنده رابط نرم‌افزار Cursor با کدهای رنگی و پنجره‌های تعاملی کامپوزر در فضای کار تاریک.
  2. تور رابط کاربری کرسر: images/cursor-interface-tour.png
    • موضوع: اسکرین‌شات برچسب‌گذاری‌شده از نمای اصلی Cursor شامل نوار ابزار، بخش کاوشگر فایل، ادیتور کد و پنل چت هوش مصنوعی.
  3. قدرت کامپوزر چندفایلی در عمل: images/composer-mode-demo.png
    • موضوع: نمایش تصویری پنجره Composer در حال تغییر همزمان ۳ فایل با تیک‌های سبز تایید تغییرات.
  4. انتخاب مدل‌های هوش مصنوعی در تنظیمات: images/cursor-models-settings.png
    • موضوع: اسکرین‌شات راهنمای بخش منوی انتخاب مدل‌ها (Claude 3.5 Sonnet / GPT-4o) در تنظیمات Cursor.
  5. اکوسیستم اپ‌های دسکتاپ: images/desktop-apps-ecosystem.png
    • موضوع: تصویر شماتیک چهارگانه: Cursor + Antigravity + Claude Desktop + ChatGPT Desktop.

۵. بخش‌بندی و ساختار محتوایی پیشنهادی درس‌نامه (README.md)

  1. تیتر اصلی: # ابزارهای دسکتاپ: ورود به دنیای ویرایشگرهای هوشمند
  2. مقدمه: چرا یک ویرایشگر متصل به هوش مصنوعی صدها برابر کارآمدتر از تب‌های مرورگر است؟
  3. جدول کاور درس
  4. دانلود و نصب Cursor:
    • ۳ زبانه کشویی اختصاصی برای Windows، macOS و Linux.
  5. باکس نکته Quera (<details class="green">): انتقال آنی اکستنشن‌ها و تنظیمات از VS Code به Cursor.
  6. کالبدشکافی رابط کاربری Cursor (تور تصویری): شرح فایل‌ها، ادیتور و تب‌ها.
  7. دو ستون اصلی تعامل: چت (Ctrl+L) در برابر کامپوزر (Ctrl+I): تفاوت پرسش ساده با ایجنت چندفایلی.
  8. تنظیم مدل‌های هوش مصنوعی: انتخاب مدل ایده‌آل برای پروژه.
  9. باکس کلیدهای میانبر جادویی Quera (<details class="violet">): فهرست کلیدهای پرکاربرد روزمره.
  10. آشنایی با Antigravity IDE و اپ‌های همراه دسکتاپ: پنجره‌ای رو به آینده ابزارهای پیشرفته.
  11. جمع‌بندی درس‌نامه: اجرای اولین دستور آزمایشی در Cursor و آماده شدن برای ابزارهای خط فرمان.

۶. معیارهای پذیرش (Acceptance Criteria for Reviewer)

  • دستورالعمل‌های نصب برای سه سیستم‌عامل در منوهای کشویی جداگانه قرار داشته باشند.
  • تور تصویری بخش‌های مختلف Cursor (چت، کامپوزر و سایدبار) به دقت توصیف شده باشد.
  • کلیدهای میانبر اصلی در هر دو حالت کیبورد ویندوز (Ctrl) و مک (Cmd) ذکر شده باشند.
  • اشاره به Antigravity IDE و اپ‌های دسکتاپ تکمیل‌کننده در بخش مناسب لحاظ شده باشد.