feat: add chapter 03-workspace-setup specs

This commit is contained in:
2026-09-05 21:50:11 +08:00
parent 652dba5bc4
commit 5a2b30cad0
9 changed files with 997 additions and 0 deletions

View File

@@ -0,0 +1,98 @@
# مشخصات درس‌نامه: ابزارهای دسکتاپ (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 و اپ‌های دسکتاپ تکمیل‌کننده در بخش مناسب لحاظ شده باشد.