پرسش‌های پیش از نصب

kamishibai مناسب چه کسانی است؟

کسانی که می‌خواهند با محتوای خودشان زبان یاد بگیرند و ماه‌ها یا سال‌ها به آن برگردند. تو واژه‌ها را از کتاب، زیرنویس، درس یا گفت‌وگو انتخاب می‌کنی و kamishibai کارت می‌سازد. جای دورهٔ آموزشی را نمی‌گیرد؛ موضوع‌ها و ترتیب یادگیری را به‌جای تو انتخاب نمی‌کند.

Anki مرور فاصله‌دار را برنامه‌ریزی می‌کند: کارت‌های آشنا با فاصله‌های بیشتر و فراموش‌شده‌ها زودتر برمی‌گردند. تعداد کارت‌های تازه و حد روزانه در Anki تنظیم می‌شود.

چرا مانگا؟

باور دارم نسل تازهٔ عامل‌های AI اجازه می‌دهد به همان راحتی که قبلاً وبلاگ می‌نوشتیم، نرم‌افزار شخصی بسازیم؛ تجربه‌مان را در قالب روش‌هایی به اشتراک بگذاریم که دیگران به‌آسانی از آن‌ها استفاده کنند. kamishibai راه من برای آزمودن این ایده است. پیش از هر چیز، ابزاری است که هر روز خودم استفاده می‌کنم و بر پایهٔ همان تجربه توسعه می‌دهم.

مانگاکا داستان، طراحی و شخصیت‌ها را با نگاه خودش به اثری یکپارچه تبدیل می‌کند. با این شیوهٔ مؤلف‌محور احساس نزدیکی می‌کنم. زبان تصویری kamishibai از همین‌جا می‌آید؛ دوست دارم نگاه مستقل پروژه هم در ایده و هم در ظاهرش دیده شود.

چه چیزی می‌توانم وارد kamishibai کنم؟

در حالت اصلی، فهرست واژه‌ها یا عبارت‌هایی که می‌خواهی یاد بگیری. لازم نیست آن‌ها را به شکل واژه‌نامه‌ای تبدیل کنی؛ برنامه تلاش می‌کند متن را بشناسد و معنی‌هایی پیشنهاد دهد. برای هر معنی انتخابی یک کارت جدا با جمله ساخته می‌شود.

اگر جمله مناسب نیست، تغییر دلخواه را توضیح بده و دوباره بساز. متن‌های آمادهٔ کارت را هم می‌توانی در قالب cards JSON بدهی که پایین‌تر توضیح داده شده است.

Anki چه می‌کند و kamishibai چه؟

kamishibai محتوا را آماده می‌کند: جمله، توضیح، صدا و تصویر را می‌سازد و در فایل .apkg، یعنی دسته‌کارت قابل باز شدن در Anki، جمع می‌کند.

Anki مرور را سامان می‌دهد: کارت‌ها را نشان می‌دهد، ارزیابی تو را نگه می‌دارد و زمان مرور بعدی را تعیین می‌کند.

kamishibai یک PDF هم می‌سازد تا بتوانی آن را چاپ و برش بزنی و بدون صفحه‌نمایش درس بخوانی.

باید برنامه‌نویسی بلد باشم؟

نه. بعد از نصب، kamishibai را در ترمینال، پنجره‌ای با رابط متنی، اجرا می‌کنی. برنامه مرحله‌به‌مرحله از افزودن واژه و انتخاب معنی تا بررسی کارت و گرفتن دسته‌کارت راهنمایی‌ات می‌کند. نیازی به نوشتن کد نیست.

برای خودکارسازی، دستورهای جداگانه با پاسخ JSON وجود دارد. اسکریپت‌ها و عامل‌های AI از آن‌ها استفاده می‌کنند؛ برای کار معمول لازم نیستند.

چه کسی محتوای کارت را تعیین می‌کند؟

تو واژه‌ها و معنی‌ها را انتخاب می‌کنی و مدل‌های AI طبق قواعد kamishibai محتوا می‌سازند. قواعد، ساختار کارت و نیازهای جمله، توضیح، صدا و تصویر را تعیین می‌کنند.

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

چه زبان‌هایی پشتیبانی می‌شوند؟

۳۱ زبان پشتیبانی می‌شود: انگلیسی، چینی، اسپانیایی، ژاپنی، فرانسوی، آلمانی، کره‌ای، روسی، ایتالیایی، پرتغالی، هندی، عربی، ترکی، لهستانی، اوکراینی، اندونزیایی، ویتنامی، تایلندی، یونانی، عبری، هلندی، چکی، صربی با خط لاتین، گرجی، ارمنی شرقی، فارسی ایران، سوئدی، رومانیایی، مجاری، فنلاندی و لاتین (با تلفظ کلاسیک).

هر دسته یک جفت زبان دارد: زبان یادگیری و زبان ترجمه و توضیح. می‌توانی دو زبان دلخواه از فهرست را با هم ترکیب کنی. کیفیت به توانایی مدل‌ها در کار با آن جفت بستگی دارد.

برای زبان دیگر، در GitHub درخواست بده تا ببینیم چه کاری می‌شود کرد.

پیش از شروع چه لازم دارم؟

برای ساخت کارت لازم است:

برای مرور، Anki → را نصب کن.

اگر زبان انتخابی به بررسی محلی نوشتهٔ تصاویر نیاز داشته باشد، هنگام ساخت اولین تصویرها مدل‌های تشخیص متن (OCR) هم دانلود می‌شوند.

kamishibai روی چه سیستم‌هایی اجرا می‌شود؟

نسخهٔ آماده برای macOS، Linux و Windows وجود دارد.

  • macOS و Linux: نصب با Homebrew یا اسکریپت نصب.
  • Windows: اجرای اسکریپت نصب با Git Bash، MSYS یا Cygwin.

دستورها و پیوند اسکریپت در بخش نصب هستند.

هزینه چقدر است؟

kamishibai رایگان و متن‌باز است. درخواست‌های Gemini با کلید API تو جداگانه هزینه دارند.

برآورد تقریبی ۱۵ دلار برای ۱۰۰ کارت با متن، صدا و تصویر است. هزینهٔ نهایی به حجم محتوا، ساخت دوباره و تعرفهٔ مدل‌ها بستگی دارد. مدل‌ها در برنامه انتخاب شده‌اند و برای شروع لازم نیست تنظیمشان کنی.

با روزی چهار کارت تازه، صد کارت برای ۲۵ روز کافی است؛ مرور جمله‌های آموخته‌شده بعد از آن هم ادامه دارد. برای همین واژه‌هایی را انتخاب می‌کنم که واقعاً می‌خواهم به کار ببرم و کیفیت را بر کمترین هزینهٔ ساخت ترجیح می‌دهم.

واژه‌ها کجا ارسال و کلید کجا ذخیره می‌شود؟

تنظیمات، جلسه‌ها، حافظهٔ نهان و فایل‌های آماده روی رایانهٔ تو هستند. kamishibai سرور اختصاصی ساخت کارت ندارد.

برای تولید و بررسی، برنامه با کلید تو واژه‌ها، جمله‌ها و تصاویر مورد بررسی را به Gemini می‌فرستد. همگام‌سازی Anki دسته‌کارت و رسانه‌ها را به AnkiWeb هم منتقل می‌کند.

کلید در فایل محلی تنظیمات است، نه مخزن رمزهای سیستم. این فایل را به دیگران نده و در مخزن عمومی کد قرار نده.

ممکن است کارت‌ها اشتباه داشته باشند؟

بله. بااین‌حال، تجربهٔ من این است که نسل فعلی مدل‌ها نتیجهٔ نسبتاً باثباتی دارد و برای کیفیت کارت‌ها زیاد کار می‌کنم.

صدا در حال حاضر باثبات‌ترین بخش و نزدیک به گفتار طبیعی است. مدل‌ها دشواری جمله را کمتر دقیق رعایت می‌کنند؛ از سطح انتخابی پیروی می‌کنند اما گاهی جمله ساده‌تر یا سخت‌تر می‌شود.

بیشترین خطا در تصویرهاست؛ AI هنوز ممکن است برای کسی دست سوم بکشد. برای همین مدل‌های جداگانهٔ AI تصویرها را ارزیابی می‌کنند. تصویر مردود دوباره ساخته می‌شود.

بررسی خودکار درستی تمام محتوا را تضمین نمی‌کند. جملهٔ مشکوک را با واژه‌نامه یا معلم بررسی کن و در صورت نیاز کارت را دوباره بساز.

Agent Ready دقیقاً یعنی چه؟

عامل AI مانند Claude Code می‌تواند با kamishibai کار کند. تو کار را شرح می‌دهی و عامل با دستورهای برنامه انجامش می‌دهد. مثلاً:

  • انتخاب واژه از یک موضوع یا متن تو.
  • انتخاب معنی و ساخت کارت.
  • بررسی نتیجه و ساخت دوبارهٔ کارت نامناسب پیش از ورود به Anki.

JSON CLI دستورهایی دارد که بدون گفت‌وگو در ترمینال، دادهٔ JSON برمی‌گردانند. عامل می‌تواند در پس‌زمینه تولید کند و چند جلسه را هم‌زمان پیش ببرد.

پیوند llms.txt را به عامل بده؛ روش نصب، به‌روزرسانی و دریافت دستورهای داخلی نسخهٔ نصب‌شده آنجاست. هزینهٔ خود عامل و ساخت‌های بیشتر ممکن است هزینهٔ کل را افزایش دهد.

کارت‌های شخصی در JSON چه زمانی به کار می‌آیند؟

وقتی حفظ متن آماده مهم است، مثلاً جمله‌های درس یا گفت‌وگوهای کوتاه. به‌جای واژه‌ها، محتوای کارت را در cards JSON، فایل متنی با ساختار مشخص، می‌دهی.

همهٔ فیلدهای اجباری کارت لازم‌اند، نه فقط جمله. می‌توانی فایل را خودت یا با عامل AI آماده کنی. متن بدون بازنویسی حفظ می‌شود. kamishibai صدا و تصویر را اضافه می‌کند و سپس دستهٔ Anki در APKG و PDF چاپی می‌سازد.

ساختار، فیلدهای اجباری و نمونه‌ها در cards-json.md →

می‌توانم کارت‌ها را روی گوشی مرور کنم؟

بله. kamishibai کارت‌ها را روی رایانه می‌سازد و در برنامهٔ موبایل Anki مرور می‌کنی.

  • فایل آمادهٔ .apkg را در Anki رایانه باز کن. اگر دوبار کلیک واردش نکرد، File → Import را انتخاب کن.
  • مجموعه را با AnkiWeb همگام کن.
  • در موبایل به همان حساب وارد شو و همگام‌سازی را اجرا کن تا کارت، تصویر و صدا دانلود شوند.

برای یادگیری بدون صفحه‌نمایش، PDF را چاپ کن، برگه‌ها را ببر و کارت‌ها را تا بزن. کاغذ صدا و زمان‌بندی خودکار مرور ندارد.

چه کسی متن، صدا و تصویر را می‌سازد؟

مدل‌های خانوادهٔ Gemini متن، صدا و تصویر را تولید می‌کنند. kamishibai دستور می‌دهد، بخشی از نتیجه را بررسی و کارت‌ها را آماده می‌کند.

صدا را مدل می‌سازد، نه گویندهٔ انسانی. پیش از یادگیری آن را همراه بقیهٔ محتوا بررسی کن.

اگر پاسخ را به یاد نیاوردم چه کنم؟

اگر معنی جمله یا واژهٔ کلیدی یادت نیامد، «دوباره» (Again) را بزن. Anki کارت را زودتر برمی‌گرداند؛ چه تازه باشد و چه ماه‌ها آن را بلد بوده باشی.

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

اگر یک کارت همیشه سخت است، جمله را بررسی کن: موقعیت روشن است؟ چیزهای ناآشنا زیاد نیست؟ گاهی ساده‌کردن یا عوض‌کردن مثال بهتر از حفظ دوبارهٔ همان متن است.

چه زمانی می‌توانم انتظار نتیجه داشته باشم؟

زمان دقیقی وجود ندارد. نتیجه به سطح اولیه، جمله‌های انتخابی، نظم مرور و استفاده از زبان بیرون از Anki بستگی دارد.

۵۰ جملهٔ اول که خوب یاد گرفته‌ای می‌تواند فرصتی برای سنجش باشد: عبارت‌ها را آسان‌تر به یاد می‌آوری، در متن تازه می‌شناسی و در گفت‌وگو به کار می‌بری؟ این عدد آستانهٔ تضمین‌شدهٔ «حس زبان» نیست. به توانایی‌های تازه‌ات نگاه کن، نه فقط شمارندهٔ کارت‌ها.

$ brew install anatoly-chichikov/tap/kamishibai