99 lines
9.4 KiB
Markdown
99 lines
9.4 KiB
Markdown
# مشخصات درس‌نامه: ابزارهای دسکتاپ (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 و اپ‌های دسکتاپ تکمیل‌کننده در بخش مناسب لحاظ شده باشد.
|