archive/docs/HEYSTIVE_README_FA.md

# 🎤 هی استیو (Heystive) چیه؟

**هی استیو یه دستیار صوتیِ هوشمند و محلی برای کامپیوتر و موبایلته.**

روی خود سیستم خودت نصب می‌شه، نه روی سرور مردم.

هر وقت بگی **«هی استیو…»** یا روی دکمۀ میکروفونش بزنی، شروع می‌کنه:

* گوش دادن 🎧
* فهمیدن چی می‌خوای 🧠
* و انجام دادن کار برات 🖥

---

## آواتار هی استیو 🎭 (چهره‌ی استیو)

یکی از مهم‌ترین قسمت‌های هی استیو، **آواتارشه**:

* یه **کاراکتر خیلی جذاب و دوست‌داشتنی** که صورتِ هی استیو رو نشون می‌ده
* همیشه توی صفحه هست و **مرکز توجهِ** برنامه است؛ نه یه تزئین ساده!

### چطور کار می‌کنه؟

* وقتی **داره گوش می‌ده**: حالت و نورش عوض می‌شه، گوش‌هاش تیز می‌شن، چشم‌هاش متمرکز می‌شن
* وقتی **فکر می‌کنه**: یه انیمیشن ریز «در حال پردازش» داره (مثلاً چرخش ملایم، نقطه‌های روشن)
* وقتی **حرف می‌زنه**: دهنش/صورتش با صداش و ریتم حرف‌زدن هماهنگ می‌شه
* **آیدل (استراحت)**: تنفس ملایم، پلک‌زدن، حرکات کوچک طبیعی

### هماهنگی با حال و هوای تو 😊

آواتار با **حالت روحی تو** هم هماهنگ می‌شه:

* اگه حس کنه **خسته‌ای یا استرس داری**:
  * نرم‌تر و آروم‌تر می‌شه
  * رنگ‌هاش ملایم‌تر می‌شن
  * انیمیشن‌هاش کندتر و آرام‌تر می‌شن

* اگه فضا **شادتر** و پرانرژیه:
  * انیمیشن‌هاش زنده‌تره
  * رنگ‌ها روشن‌تر
  * حرکات تندتر و پرانرژی‌تر

### انتخاب شخصی‌سازی 🎨

می‌تونی از بین چند **استایل مختلف آواتار** انتخاب کنی:

* **مینیمال**: یه دایره یا شکل ساده با شخصیت
* **کارتونی**: یه شخصیت بامزه و دوست‌داشتنی
* **انتزاعی**: یه موجود خلاقانه و منحصربه‌فرد
* **نیمه سه‌بعدی**: با عمق و جزئیات بیشتر

همه‌ی این استایل‌ها روی **دسکتاپ** و **موبایل** یکسان هستن، فقط برای موبایل بهینه‌تر شدن.

**خلاصه: آواتار فقط یه تصویر تزئینی نیست؛ قلب تجربه‌ی هی استیوئه و باعث می‌شه حس کنی با یه موجود زنده طرفی، نه یه جعبه متن.**

---

## چطور باهات حرف می‌زنه و گوش می‌ده 🎙

* با **صدا** باهاش حرف می‌زنی، اون هم با یه صدای **روون، طبیعی و شبیه آدم** جواب می‌ده
* **فارسی** رو خیلی خوب می‌فهمه و **نیتیو** صحبت می‌کنه، **انگلیسی** رو هم همینطور
* می‌تونه متن‌ها رو برات **بلند بخونه**:
  * ایمیل، نوت، گزارش، TODO و…

### فناوری صدا:

* **آفلاین (بدون اینترنت)**:
  * از مدل‌های محلی استفاده می‌کنه (مثل faster-whisper برای شناسایی صدا، piper-tts برای تبدیل متن به صدا)
  * همه‌چی روی کامپیوترت اجرا می‌شه، نیازی به اینترنت نیست

* **آنلاین (با اینترنت)**:
  * از سرویس‌های ابری گوگل یا Azure استفاده می‌کنه برای کیفیت بهتر
  * اگه اینترنت قطع بشه، خودکار می‌ره روی حالت آفلاین

---

## چند صدای مختلف و استایل گفتار 🧑‍🎤

* هی استیو چند تا **پروفایل صدا** داره:
  * صدای **آرام و ملایم**
  * صدای **شاد و پرانرژی**
  * صدای **رسمی و حرفه‌ای**
  * و…

* می‌تونی برای **فارسی** و **انگلیسی** صدای جداگانه انتخاب کنی

* تو تنظیمات می‌تونی:
  * سرعت حرف زدن رو تنظیم کنی
  * بگی همیشه با این صدا حرف بزن
  * یا بذاری خودش بر اساس موقعیت و حالت تو، لحنش رو کمی تغییر بده

---

## تشخیص حال و هوای تو 😊💙

هی استیو با دقت به:

* **لحن حرف زدن**ت (سرعت، ارتفاع صدا، مکث‌ها)
* و **جمله‌هایی که می‌نویسی یا می‌گی** (احساسات، کلمات)

یه **حدس دوستانه** می‌زنه که:

* الان **خسته‌ای، کلافه‌ای، شلوغ‌پریشی، متمرکزی یا سرحال و شادی**

### چطور عکس‌العمل نشون می‌ده؟

* اگر حس کنه **خسته‌ای یا تحت فشاری**:
  * آروم‌تر حرف می‌زنه
  * جواب‌هاش کوتاه‌تر و مهربون‌تر می‌شه
  * آواتار هم نرم‌تر، رنگ‌هاش ملایم‌تر، و انیمیشن‌هاش آرام‌تر می‌شه

* اگر اوضاع **خوبه و سرحالی**:
  * جوابات می‌تونه کمی پرانرژی‌تر باشه
  * آواتار هم زنده‌تر و روشن‌تر می‌شه

> ⚠️ **مهم**: این فقط یه حس و حدس ساده و دوستانه‌ست؛ **تشخیص پزشکی یا رسمی نیست**. می‌تونی این قابلیت رو از تنظیمات خاموش کنی.

---

## کار با فایل‌ها و پوشه‌ها 🗂

هی استیو می‌تونه مثل یه دستیار کامپیوتری واقعی:

* توی پوشه‌ها **بگرده**
* فایل جدید **درست کنه** (مثلاً یادداشت روزانه، گزارش، TODO)
* فایل **باز کنه، ویرایش کنه، جابه‌جا کنه، اسم عوض کنه**
* فایل‌ها رو **بخونه** و خلاصه کنه

### مثال:

> **تو**: «هی استیو، یه فایل یادداشت جدید برای امروز بساز و بازش کن.»

> **هی استیو**: «باشه، ساختم و باز کردم. می‌خوای چیزی بنویسم توش؟»

### امنیت:

* قبل از کارهای حساس مثل:
  * **پاک کردن** فایل‌ها
  * **جابه‌جایی** دسته‌جمعی

همیشه **ازت می‌پرسه**:

> «مطمئنی این کار رو انجام بدم؟»

---

## کار با برنامه‌ها و سیستم 🖥

* می‌تونه **برنامه‌ها** رو برات باز کنه:

  > «VS Code رو توی این پوشه باز کن.»
  >
  > «مرورگر رو باز کن و جیمیل رو بیار بالا.»

* می‌تونه **پوشه** رو توی File Explorer / Finder باز کنه

* می‌تونه **ترمینال/Command Prompt** رو توی یه مسیر مشخص اجرا کنه

* می‌تونه **وضعیت سیستم** رو چک کنه:
  * مصرف رم
  * مصرف CPU
  * فضای دیسک
  * برنامه‌های سنگین

---

## آنلاین و آفلاین کار می‌کنه 🌐❌

هی استیو طوری طراحی شده که:

### حالت آفلاین (بدون اینترنت) ✅

* روی **فایل‌ها، پوشه‌ها، برنامه‌ها** کار می‌کنه
* می‌تونه **نوت‌ها** و **حافظه‌ی محلی** رو بخونه و بنویسه
* می‌تونه با **مدل‌های محلی** صدات رو پردازش کنه (STT/TTS آفلاین)
* می‌تونه **اسکریپت‌ها** بسازه و اجرا کنه

**اگه چیزی نیاز به اینترنت داره**:

> «برای این کار نیاز به اینترنت دارم - الان توی حالت آفلاینم. می‌تونم یه جایگزین محلی پیشنهاد بدم؟»

### حالت آنلاین (با اینترنت) 🌐

امکانات بیشتر:

* **جستجوی وب**: سرچ کردن اطلاعات، خطاها، آموزش‌ها
* **صدای بهتر**: از سرویس‌های ابری برای TTS/STT باکیفیت‌تر
* **خلاصه‌سازی صفحات وب**: صفحات وب رو می‌خونه و خلاصه می‌کنه
* **API‌های خارجی**: هوا، اخبار، و…

### حالت خودکار (Auto) 🔄

* **اینترنت داری؟** → از قابلیت‌های آنلاین استفاده می‌کنه
* **اینترنت قطع شد؟** → به‌طور خودکار می‌ره روی حالت آفلاین و کارهای محلی رو ادامه می‌ده

---

## حافظه و نوت‌برداری 📒

هی استیو فقط جواب لحظه‌ای نمی‌ده؛ می‌تونه **چیزها رو به خاطر بسپره**:

### چی رو یادش می‌مونه؟

* **نوت‌ها و یادداشت‌ها**:

  > «این رو به‌عنوان توضیح پروژه X ذخیره کن.»

* **توضیح پروژه‌ها** و **مستندات محلی**

* **خلاصه‌ی مکالمات** (اختیاری - می‌تونی خاموش کنی)

### جستجو:

* بعداً می‌تونی بگی:

  > «یادداشت‌های پروژه X رو بیار.»

  و می‌تونه حتی برات **خلاصه‌اش** کنه.

* از جستجوی کلمه کلیدی یا جستجوی معنایی (RAG) استفاده می‌کنه

* همه‌ی این حافظه **محلی** هست و **آفلاین** کار می‌کنه

---

## کارهای چندمرحله‌ای و برنامه‌ریزی 🧠

هی استیو فقط کارهای تک‌مرحله‌ای ساده انجام نمی‌ده؛ می‌تونه:

* یه سری کار **پشت‌سر هم** انجام بده

### مثال:

> **تو**: «هی استیو، لاگ‌های این پروژه رو بررسی کن، نمی‌دونم چرا دیتابیس کانکت نمی‌شه!»

> **هی استیو**:
> 1. لاگ‌های پروژه رو پیدا می‌کنه
> 2. بررسی می‌کنه چرا سرور کرش می‌کنه
> 3. یه خلاصه بهت می‌گه
> 4. یه فایل گزارش درست می‌کنه و ذخیره می‌کنه

### پلن قبل از اجرا:

قبل از کارهای بزرگ، یه **پلن کوتاه** می‌گه:

> «اول این رو چک می‌کنم، بعد این فایل رو می‌خونم، آخرش یه گزارش می‌نویسم؛ انجام بدم؟»

و بعد از تأیید تو، مرحله‌به‌مرحله جلو می‌ره.

---

## امنیت و اجازه گرفتن 🛡

برای کارهای حساس، هی استیو همیشه **می‌پرسه**:

* **پاک کردن** فایل‌ها و پوشه‌ها
* **اجرای اسکریپت‌ها** و برنامه‌های جدید
* **نصب** یا **تغییر چیزهای مهم** سیستم

> «مطمئنی انجام بدم؟»

### صداقت:

* اگر خطایی پیش بیاد یا نتونه کاری رو انجام بده:

> **صادقانه می‌گه چی شد** و تظاهر نمی‌کنه که کار انجام شده

---

## همگام‌سازی با موبایل 📱💻

هی استیو می‌تونه روی **دسکتاپ** (ویندوز، مک، لینوکس) و **موبایل** (iOS و اندروید) هم نصب بشه و با هم **سینک** بشن (اگه خودت فعالش کنی):

### چی سینک می‌شه؟

1. **تنظیمات مهم**:
   * زبان، نوع صدا، استایل آواتار
   * تنظیمات حریم خصوصی

2. **یادداشت‌ها و نوت‌ها**:
   * نوت‌هایی که روی دسکتاپ می‌نویسی، روی موبایل هم نمایش داده می‌شن
   * و برعکس

3. **یادآورها و TODO ها**:
   * کارهایی که روی یکی اضافه می‌کنی، روی اون یکی هم ظاهر می‌شه
   * نوتیفیکیشن روی هر دو

4. **خلاصه‌ی مکالمات** (اختیاری):
   * اگه بخوای، می‌تونی خلاصه‌ی مکالمات اخیرت رو سینک کنی
   * می‌تونی این رو کاملاً خاموش کنی

### چطور سینک می‌شه؟

* **شبکه محلی** (ترجیحی برای حریم خصوصی):
  * وقتی دسکتاپ و موبایل روی یه شبکه‌ای هستن، مستقیماً با هم ارتباط برقرار می‌کنن (P2P)

* **سینک ابری** (اختیاری):
  * از Google Drive، iCloud، یا Dropbox خودت استفاده می‌کنه
  * همه‌چی رمزنگاری شده

* **تو کنترلی**:
  * خودت تصمیم می‌گیری چی سینک بشه و چطور

### کنترل از راه دور 🎮

از موبایل می‌تونی **دستور** به دسکتاپ بفرستی:

> **از موبایل می‌گی**: «روی کامپیوترم VS Code رو برای پروژه X باز کن.»

> **دسکتاپ**: VS Code رو باز می‌کنه

* نیاز به مجوز و تنظیمات داره
* از شبکه محلی یا relay امن ابری استفاده می‌کنه

### آواتار روی موبایل هم هست! 🎭📱

* همون آواتار جذاب و زنده که روی دسکتاپ هست، روی موبایل هم هست
* طراحی یکسان، فقط برای صفحه کوچکتر بهینه شده
* همون انیمیشن‌ها، همون شخصیت

---

## اولویت پیاده‌سازی 🚀

### فاز 1: دسکتاپ (اولویت اول) 💻

* برنامه کامل دسکتاپ
* آواتار زنده و جذاب
* صدای طبیعی (آفلاین و آنلاین)
* همه قابلیت‌ها (فایل، برنامه، وب، سیستم)
* حافظه محلی
* تشخیص مود

### فاز 2: موبایل (اولویت دوم) 📱

* برنامه موبایل (iOS و Android)
* آواتار (همون طراحی دسکتاپ، بهینه‌شده برای موبایل)
* صدا (STT/TTS موبایل)
* قابلیت‌های اصلی موبایل

### فاز 3: سینک (اولویت سوم) 🔄

* سینک شبکه محلی
* سینک ابری
* کنترل از راه دور

---

## خلاصه‌ی خیلی کوتاه ✨

**هی استیو =**

* یه **دستیار صوتی محلی** برای دسکتاپ و موبایلت 🎤
* با یه **آواتار خیلی جذاب، زنده و دوست‌داشتنی** که قلب برنامه است 🎭💙
* که:
  * باهات **طبیعی و روون** حرف می‌زنه (فارسی و انگلیسی) 🗣
  * فایل‌ها و برنامه‌ها رو برات **مدیریت می‌کنه** 🗂🖥
  * **حال و هوات** رو تا حدی می‌فهمه و لحنش رو باهاش تنظیم می‌کنه 😊💭
  * روی **دسکتاپ و موبایل** می‌تونه **سینک** باشه 🔄📱💻
  * هم **با اینترنت**، هم **بدون اینترنت** کار می‌کنه 🌐❌
  * کارهای **واقعی و مفید** انجام می‌ده، نه فقط چت ✅
  * **حریم خصوصیت** رو محترم می‌شماره - همه‌چی محلی، سینک اختیاریه 🔒

---

**بیا یه چیز باحال بسازیم! 🚀**