K8فهرست انتظار
Pine Script
اسکریپتی که روی گذشته بی‌نقص است، شاید فقط از آینده خبر دارد؛ Pine را طوری بنویسید که بتوانید ثابت کنید ندارد.
در پایان دوره
در پایان (۱) می‌دانید Pine اسکریپت را برای هر شمع یک بار از چپ به راست اجرا می‌کند، close[1] و na یعنی چه و چرا شمع زنده با شمع تاریخی فرق دارد، و اجرای اسکریپت را روی ۱۰ شمع با دست ردیابی می‌کنید؛ (۲) نوع‌ها، متغیر ماندگار (var)، شرط، حلقه، تابع و ورودی را درست به کار می‌برید؛ (۳) SMA، EMA و RSI را خودتان می‌سازید و نشان می‌دهید خروجی‌تان با ta.sma، ta.ema و ta.rsi و با تعریف T4 برابر است؛ (۴) داده‌ی بازه‌ی بالاتر را با request.security بدون نگاه به آینده می‌آورید و repaint را آزمون می‌کنید؛ (۵) هشدار و برچسب و جدول را طوری می‌سازید که روی شمع بسته‌نشده چشمک نزنند؛ (۶) یک راهبرد تمرینی را با کارمزد، slippage و زمان اجرای صریح می‌نویسید و گزارش تست‌گر را با محدودیت‌هایش می‌خوانید؛ (۷) اسکریپت نوشته‌ی AI را با آزمون دوقلو و بررسی ایستا می‌سنجید و قواعد انتشار و مجوز اسکریپت را می‌شناسید.
مخاطب دوره
- مناسب: تحلیلگر تکنیکالی که T1 را گذرانده و اندیکاتورها را از T4 می‌شناسد و می‌خواهد اندیکاتور خودش را بنویسد یا اسکریپت دیگران را بخواند و بفهمد؛ کسی که از پایان K7 می‌آید و می‌خواهد قاعده‌ی سیستمش را در تست‌گر TradingView هم ببیند و بداند گزارش آن چه می‌گوید و چه نمی‌گوید؛ کسی که با AI اسکریپت Pine می‌سازد و نمی‌داند کجا به آن اعتماد کند؛ کسی که بی‌تجربه‌ی برنامه‌نویسی است ولی حاضر است دقیق و آهسته کار کند.
- نامناسب: کسی که دنبال اسکریپت آماده‌ی «سودده»، سیگنال یا اسکریپت فروشی است (دوره هیچ‌کدام را نمی‌دهد و کیس ۳ دقیقاً سنجش همین ادعاهاست)؛ کسی که می‌خواهد اسکریپت را به حساب صرافی وصل کند و خودکار معامله کند (اتصال اسکریپت یا هشدار به صرافی در این دوره نیست؛ ربات با Python و صرافی ساختگی: M8)؛ کسی که روش آزمون راهبرد، آمار نتیجه و بیش‌برازش را از پایه می‌خواهد (خانه‌اش K7 است)؛ کسی که هنوز نمودار، بازه‌ی زمانی و شمع بسته‌نشده را نمی‌شناسد (اول T1).
آنچه می‌سازید
| ماژول | محصول |
|---|---|
| ۱ | محیط کار سالم (python tools/check_env.py سبز) + «برگه‌ی ردیابی اجرا» برای ۱۰ شمع + نخستین اسکریپت (01-hello-bars.pine) و دوقلوی آن با آزمون سبز |
| ۲ | اسکریپت‌های پایه (شمارنده با var، رشته‌ی شمع‌های صعودی، تابع درصد تغییر، ورودی‌ها) و دوقلوهایشان با آزمون‌های سبز |
| ۳ | اندیکاتور سفارشی «میانگین‌ها و RSI بازساخته» با رسم، و اثبات برابری با ta.* و تعریف T4 در دوقلو و کتاب‌کار محاسبه‌ی دستی |
| ۴ | اندیکاتور «روند بازه‌ی بالاتر» در سه نسخه (معیوب، repaint، درست) با آزمون بریدن و آزمون هم‌ترازی + فهرست خطاهای PE-1 |
| ۵ | لایه‌ی هشدار و رسم: alertcondition و alert() فقط روی شمع بسته‌شده، برچسب نقطه‌ی چرخش و جدول وضعیت، با دوقلوی «دفتر رویداد هشدار» |
| ۶ | راهبرد تمرینی K8-R1 با کارمزد، slippage و زمان اجرای صریح + دوقلوی «شبیه‌ساز کارگزار» با فهرست معاملات مرجع + برگه‌ی خوانش انتقادی گزارش تست‌گر + فهرست خطاهای PE-2 |
| ۷ | برگه‌ی بازبینی اسکریپت برای PE-3 (اسکریپت AIگونه)، آزمون‌های تازه‌ی خودتان و چک‌لیست انتشار |
| ۸ | پروژه‌ی نهایی: اندیکاتور و راهبرد Pine با دوقلوی آزموده، گزارش repaint و نگاه به آینده، خوانش تست‌گر و دفاع ویدیویی |
پیش‌نیازها
پیش‌نیاز رسمی: T1 — نمودار و TradingView حرفه‌ای؛ یعنی داده‌ی OHLCV، بازه‌ی زمانی، منطقه‌ی زمانی، شمع بسته‌نشده، محیط پلتفرم، هشدار و بازپخش شمع (Bar Replay) را می‌شناسید. پیش‌نیاز عمومی: T4 — اندیکاتورها و اسیلاتورها به‌شدت توصیه می‌شود، چون ماژول ۳ SMA، EMA و RSI را با تعریف T4 بازمی‌سازد؛ K7 — ساختن و آزمودن سیستم معاملاتی برای ماژول ۴ (نگاه به آینده) و ماژول ۶ (هزینه‌ها و آمار آزمون) توصیه می‌شود و K8 هر جا لازم باشد «یادآوری» کوتاه می‌دهد. برنامه‌نویسی لازم نیست: Pine از صفر درس داده می‌شود. برای دوقلوهای Python کافی است ضمیمه‌ی پل §۷.۶ (کپی K7 §۷.۶) را پیش از هفته‌ی ۲ ببینید؛ در دوقلوها شما فقط تابع‌های کوتاه را کامل می‌کنید و اسکلت، داده و آزمون‌ها آماده‌اند. صفحه‌گسترده (فرمول، ستون، کپی فرمول) برای محاسبه‌ی دستی لازم است. آزمون تعیین سطح (§۲.۱) همین‌ها را می‌سنجد.
زمان و ریتم
۸ ماژول؛ ساعت درس: ۱۴ ساعت (+ ۱۰ ساعت تمرین و پروژه)؛ ۸ هفته، هفته‌ای ۳ ساعت. هفته‌ی ۱: ماژول ۱ و نصب؛ هفته‌ی ۲: ماژول ۲؛ هفته‌ی ۳: ماژول ۳؛ هفته‌ی ۴: ماژول ۴؛ هفته‌ی ۵: پروژه‌ی میانی و ماژول ۵؛ هفته‌ی ۶: ماژول ۶؛ هفته‌ی ۷: ماژول ۷؛ هفته‌ی ۸: پروژه‌ی نهایی و دفاع. سهم قالب محتوا در §۲.۴ آمده است (ویدیو ۲۵٪، متن ۳۰٪، دیاگرام ۱۵٪، تمرین عملی ۳۰٪)؛ تمرین عملی در این دوره یعنی نوشتن فایل Pine، کامل کردن دوقلوی Python و سبز کردن آزمون‌ها روی مخزن شروع.
ابزارها و نسخه‌ها
همه‌ی نام‌ها «نمونه، نه توصیه»اند؛ نسخه‌ها، طرح‌های اشتراک و محدودیت‌ها در §۷.۲.
- ویرایشگر Pine در TradingView (اختیاری، بی‌نمره): برای اجرای اسکریپت روی نمودار، دیدن خروجی و تست‌گر راهبرد. نوشتن فایل
.pineبه پلتفرم نیاز ندارد؛ هر ویرایشگر متن کافی است. جایگزین آفلاین: پوشه‌یoutputs/مخزن شروع (تصویرهای ضبط‌شده و تاریخ‌دار خروجی اسکریپت‌های حل‌شده) و نمودارهای ساخته‌شده از خروجی دوقلو باtools/render_chart.py. - Python ≥ ۳٫۱۱ با pandas، numpy و pytest (نسخه‌های قفل‌شده در
requirements.txt؛ matplotlib اختیاری برای نمودار). جایگزین بدون اینترنت: پوشه‌یwheels/و نصب باpip install --no-index --find-links wheels -r requirements.txt. - ویرایشگر کد (نمونه: VS Code؛ افزونه‌ی رنگ‌آمیزی Pine اختیاری) و ترمینال.
- صفحه‌گسترده (LibreOffice Calc یا Excel؛ آفلاین کافی است) برای ردیابی اجرا و محاسبه‌ی دستی اندیکاتور و قیمت اجرا.
- مخزن شروع
k8-pack(§۷.۳): فایل‌های شروع Pine با توضیح فارسی، دوقلوهای Python ناتمام، کتابخانه‌ی کمکیpinelikeکه معنای سری در Pine را تقلید می‌کند، ابزار بررسی ایستای Pine، داده‌ی ساختگی، آزمون‌ها و قالب‌ها؛ همه آفلاین.
ارزیابی و سیاست AI
- تمرین: استفاده از AI آزاد است؛ تست خودکار نتیجه را می‌سنجد.
- آزمون: بدون AI.
- پروژه: AI مجاز است، اما در ویدیوی دفاع باید هر خط را توضیح بدهید.
| بخش | وزن |
|---|---|
| آزمون‌های کوتاه ماژول‌ها (۱ تا ۷) | ۱۰٪ |
| تمرین‌های اجباری (آزمایشگاه‌های ۰۱ تا ۰۷، PE-1 تا PE-3) | ۲۵٪ |
| پروژه‌ی میانی | ۲۰٪ |
| پروژه‌ی نهایی (کد، آزمون‌ها، گزارش‌ها، دفاع ویدیویی) | ۳۵٪ |
| آزمون پایانی | ۱۰٪ |
گواهی
- گواهی پایان دوره: نمره‌ی کل دست‌کم ۷۰٪، پروژه‌ی نهایی دست‌کم ۶۰ از ۱۰۰ و آزمون پایانی دست‌کم ۱۲ از ۲۰.
- گواهی با امتیاز ممتاز: نمره‌ی کل دست‌کم ۹۰٪ و هارنس هم‌ارزی یا سه آزمون تازه‌ی معنادار در پروژه‌ی نهایی.
- متن گواهی: «توانایی نوشتن اندیکاتور و راهبرد Pine Script با مدل اجرای درست، داده‌ی بازه‌ی بالاتر بدون نگاه به آینده، هشدار قطعی، تنظیم صریح هزینه‌ها و راستی‌آزمایی با دوقلوی Python آزموده». گواهی هیچ توانایی سودآوری یا مجوز مشاوره‌ی سرمایه‌گذاری را تأیید نمی‌کند.
نمونه‌ی درس
درس نمونه‌ی رایگان این دوره به‌زودی منتشر می‌شود. برای خبر شدن، وارد فهرست انتظار شوید.
این محتوا آموزشی است؛ نه توصیه‌ی سرمایه‌گذاری است و نه مشاوره‌ی حقوقی.
- ماژول ۱Pine Script و مدل اجرای آن: اجرای شمعبهشمع، سری و تاریخچه، شمع زنده، نسخه‌ها؛ دوقلوی Python (۱٫۵ ساعت)
- ماژول ۲زبان پایه: نوع‌ها، متغیر ماندگار، شرط و حلقه، تابع، ورودی‌ها (۲ ساعت)
- ماژول ۳اندیکاتور سفارشی: تابع indicator، رسم، توابع ta و بازسازی SMA، EMA و RSI (۲ ساعت)
- ماژول ۴داده‌ی بازه‌ی دیگر با request.security: نگاه به آینده، repaint و الگوی درست (۲ ساعت)
- ماژول ۵هشدار و اشیای رسم: alertcondition و alert، برچسب، خط و جدول (۱٫۵ ساعت)
- ماژول ۶راهبرد و تست‌گر راهبرد: تابع strategy، سفارشها، کارمزد و slippage، زمان اجرا، خواندن گزارش (۲٫۵ ساعت)
- ماژول ۷کیفیت و راستی‌آزمایی: آزمون با دوقلوی Python، خطاهای رایج، کد نوشته‌ی AI، انتشار و حقوق اسکریپت (۱٫۵ ساعت)
- ماژول ۸پروژه‌ی نهایی (۱ ساعت + ۵ ساعت کار آزاد)
مدرس هر دوره متخصص همان حوزه است. معرفی مدرس این دوره همراه با باز شدن ثبت‌نام در صفحه‌ی مدرسان می‌آید.
- در پایان دوره اسکریپت یا راهبرد سودده دارم؟ خیر. دوره هیچ اسکریپت، قاعده یا اندیکاتوری را سودده معرفی نمی‌کند و نمره‌ی هیچ تمرینی به سود و زیان قاعده یا جهت بازار بستگی ندارد. یاد می‌گیرید اسکریپت درست بنویسید، ثابت کنید از آینده خبر ندارد و گزارش تست‌گر را صادقانه بخوانید؛ راهبردی با نتیجه‌ی منفی و گزارش صادق می‌تواند نمره‌ی کامل بگیرد.
- TradingView ندارم یا دسترسی‌ام ناپایدار است. می‌توانم دوره را بگذرانم؟ بله. فایل Pine را در هر ویرایشگر متن می‌نویسید، بررسی ایستای دوره آن را آفلاین می‌سنجد و نمره‌ی رفتار اسکریپت از آزمون‌های دوقلوی Python روی داده‌ی دوره می‌آید. خروجی ضبط‌شده‌ی اسکریپت‌های حل‌شده روی پلتفرم در
outputs/هست. دوره هیچ راه دور زدن محدودیت دسترسی را آموزش نمی‌دهد (§۲.۲). - چرا باید علاوه بر Pine، Python هم بنویسم؟ چون Pine فقط روی سرور پلتفرم و روی داده‌ی پلتفرم اجرا می‌شود و نمی‌توان آن را آفلاین و تکرارپذیر روی داده‌ی ثابت آزمود. دوقلو همان منطق را با کتابخانه‌ی
pinelike(که تاریخچه‌ی[n]،naو تابع‌هایta.*را به تعریف مستند Pine تقلید می‌کند) بیان می‌کند و آزمون‌ها روی آن اجرا می‌شوند. نوشتن دوقلو خودش بهترین راه فهمیدن مدل اجرای Pine است. حجم Python لازم کم است و ضمیمه‌ی پل §۷.۶ آن را پوشش می‌دهد. - فرق این دوره با K7 و M9 چیست؟ K7 خانه‌ی روش آزمون راهبرد است (آزمون دستی، آمار، هزینه، خطاهای آزمون، walk-forward). M9 خواندن و راستی‌آزمایی خروجی AI است، از جمله اسکریپت Pine، بی‌آن‌که نوشتن آن را درس دهد. K8 خانه‌ی نوشتن Pine است: زبان، مدل اجرا، داده‌ی بازه‌ی دیگر، هشدار و تست‌گر.
- می‌توانم اسکریپتم را منتشر کنم یا بفروشم؟ ماژول ۷ قواعد انتشار پلتفرم، انواع انتشار (متن‌باز، محافظت‌شده، فقط با دعوت) و مجوز کد را معرفی می‌کند تا بدانید چه چیزی را از منبع رسمی بخوانید؛ درباره‌ی تصمیم فروش توصیه‌ای نمی‌دهد و مشاوره‌ی حقوقی نیست. هیچ اسکریپتی در دوره با ادعای عملکرد منتشر یا تبلیغ نمی‌شود.
- اسکریپت را به هشدار و از هشدار به صرافی وصل کنم تا خودکار معامله کند؟ نه در این دوره. ماژول ۵ هشدار را فقط برای اطلاع درس می‌دهد. هیچ تمرینی حساب صرافی، کلید API یا وب‌هوک واقعی نمی‌خواهد و هیچ کلیدی در اسکریپت، پیام هشدار، مخزن یا گفت‌وگو با AI نمی‌آید. خطر اجرای خودکار و امنیت کلید ربات خانه‌ی M8 است.
- AI می‌تواند Pine را برایم بنویسد؟ می‌تواند پیش‌نویس بدهد و در دوره با افشا مجاز است، ولی کد نوشته‌ی AI فقط وقتی پذیرفته است که بررسی ایستا و آزمون‌های دوقلو را بگذراند و در دفاع خط‌به‌خط توضیحش دهید. ماژول ۷ خطاهای رایج آن را (نسخه‌ی قاطی، تابع ساختگی، هموارسازی اشتباه، نگاه به آینده) با مجموعه‌ی PE-3 تمرین می‌کند.
دوره‌ی بعدی
K8 دوره‌ی اختیاری پایانی مسیر «تحلیلگر تکنیکال» است. پس از آن M9 — هوش مصنوعی در تحلیل و آزمودن راهبرد (اختیاری) نشان می‌دهد وقتی AI اسکریپت و آزمون را می‌سازد کجا خطا می‌کند و چطور ادعای «سیگنال AI» را بسنجید (M9 ماژول ۳ تا ۵). کسی که می‌خواهد قاعده را در کد کامل، با موتور آزمون رویدادمحور، API صرافی و ربات روی صرافی ساختگی بسازد: M8 — معامله‌ی الگوریتمی (اختیاری). اگر K7 — ساختن و آزمودن سیستم معاملاتی را نگذرانده‌اید، خانه‌ی روش آزمون، آمار نتیجه، هزینه‌ها و خطاهای آزمون است و خوانش شما از گزارش تست‌گر را عمیق‌تر می‌کند. اگر امنیت حساب پلتفرم و صرافی را نگذرانده‌اید: G4 — کاربر امن کریپتو (G4 ماژول ۵).