این راهنما روش استفاده از KUMIHAN｜تراز در Gemini CLI و برنامهٔ Gemini را توضیح می‌دهد.
دربارهٔ نسخهٔ v0.1.0 این نسخه برای آزمودن نصب در محیط خودتان منتشر شده است. عملکرد آن در هر ابزار هنوز به‌طور کامل بررسی نشده است، بنابراین ممکن است درست کار نکند.
1. انتخاب روش نصب
| جایی که می‌خواهید از آن استفاده کنید | روش پیشنهادی |
|---|---|
| Gemini CLI (هر ۴ مهارت با هم) | A. نصب به‌عنوان افزونه |
| Gemini CLI (فقط مهارت‌های لازم) | B. انتخاب و نصب مهارت‌ها |
| برنامهٔ Gemini (وب، Mac، تلفن هوشمند) | C. بارگذاری مهارت‌ها |
A. Gemini CLI: نصب به‌عنوان افزونه
با این روش، هر ۴ مهارت یک‌جا نصب می‌شوند.
- فایل ZIP افزونه را دریافت کنید.
- با باز کردن فایل ZIP، پوشهٔ
kumihan-faایجاد می‌شود. - با مشخص کردن پوشه، افزونه را نصب کنید.
gemini extensions install "/absolute/path/kumihan-fa"
اگر صفحهٔ تأیید نمایش داده شد، محتوا را بررسی کنید و ادامه دهید. افزونه پس از نصب در همهٔ پروژه‌ها فعال می‌شود.
اگر از فایل ZIP نصب کرده باشید، به‌روزرسانی خودکار انجام نمی‌شود. با انتشار نسخهٔ جدید، فایل ZIP را جایگزین کنید.
B. Gemini CLI: انتخاب و نصب مهارت‌ها
با این روش، فقط مهارت‌های لازم را برای هر پروژه جداگانه نصب می‌کنید. اگر با روش A نصب کرده‌اید، به این مراحل نیازی نیست.
برای مثال، برای نصب kumihan-fa دستور زیر را در پروژهٔ مورد نظر اجرا کنید.
gemini skills install https://github.com/landco-llc/kumihan --path plugins/kumihan-fa/skills/kumihan-fa --scope workspaceبرای نصب مهارت‌های دیگر، --path را به این صورت تغییر دهید.
plugins/kumihan-fa/skills/kumihan-fa-web— صفحه‌های وبplugins/kumihan-fa/skills/kumihan-fa-documents— گزارش و اسلایدplugins/kumihan-fa/skills/kumihan-fa-review— بازبینی
گزینهٔ --scope workspace یعنی استفاده «فقط در این پروژه». اگر آن را حذف کنید، مهارت در همهٔ پروژه‌ها در دسترس خواهد بود.
برای به‌روزرسانی
همان دستور را دوباره اجرا کنید. مهارت نصب‌شده جایگزین می‌شود؛ بنابراین اگر محتوای آن را ویرایش کرده‌اید، ابتدا تغییرات خود را ذخیره کنید.
C. برنامهٔ Gemini: بارگذاری مهارت‌ها
- فایل‌های ZIP مهارت‌هایی را که می‌خواهید استفاده کنید دریافت کنید.
- kumihan-fa — نقطهٔ شروع
- kumihan-fa-web — صفحه‌های وب
- kumihan-fa-documents — گزارش و اسلاید
- kumihan-fa-review — بازبینی
- در Gemini، Customize (اگر آن را نمی‌بینید، More) → Skills → Upload را باز کنید.
- فایل‌های ZIP را یکی‌یکی انتخاب کنید، محتوا را بررسی کنید و Create را بزنید.
توجه
- این قابلیت برای حساب‌های شخصی Google کاربران ۱۸ سال به بالا در دسترس است. در حال حاضر با حساب‌های کاری یا آموزشی قابل استفاده نیست.
- گزینهٔ «Keep Activity» (ذخیرهٔ فعالیت) باید روشن باشد.
- این قابلیت به‌تدریج عرضه می‌شود، بنابراین ممکن است هنوز برای شما نمایش داده نشود. برای جزئیات، راهنمای رسمی Gemini را ببینید.
- فایل ZIP افزونه (مخصوص Gemini CLI) در اینجا کار نمی‌کند.
- مهارت‌های بارگذاری‌شده به‌طور خودکار به‌روز نمی‌شوند. با انتشار نسخهٔ جدید، دوباره آن‌ها را بارگذاری کنید.
2. امتحان کردن
پیشنهاد می‌کنیم ابتدا با درخواستی شروع کنید که هیچ فایلی را تغییر نمی‌دهد.
قصد دارم یک ارائهٔ اسلایدی به زبان فارسی تهیه کنم. به چه نکته‌هایی باید توجه کنم؟ لطفاً هیچ فایلی را تغییر نده.
بررسی درستی فایل‌ها (اختیاری)
اگر می‌خواهید مطمئن شوید فایل‌های دریافت‌شده سالم هستند، از SHA256SUMS.txt استفاده کنید.
فایل SHA256SUMS.txt را در همان پوشه‌ای بگذارید که فایل‌های ZIP دریافت‌شده در آن قرار دارند و دستور زیر را در ترمینال اجرا کنید. اگر shasum در دسترس نیست، مقدار SHA-256 را با Get-FileHash در Windows PowerShell یا ابزاری مشابه تطبیق دهید.
shasum -a 256 -c --ignore-missing SHA256SUMS.txtاگر در سطر فایل دریافت‌شده OK نمایش داده شود، فایل سالم است.
ابزارهای دیگر: ChatGPT / Codex · Claude
صفحه‌ها و شرایط ارائهٔ خدمات ممکن است تغییر کنند. برای آخرین اطلاعات، راهنمای رسمی هر سرویس را ببینید (تاریخ بررسی این صفحه: ۱۴ اکتبر ۲۰۲۶).