با تارتانک شروع کنید
از نصب تا انجام اولین کار روی پروژه، همه‌چیز اینجاست. برنامه مناسب خود را انتخاب کنید، وارد حساب شوید و درخواستتان را به زبان طبیعی بنویسید.
چهار قدم تا اولین کار
برای شروع به تنظیمات پیچیده‌ای نیاز ندارید.
افزونه VS Code، برنامه دسکتاپ یا CLI را انتخاب کنید.
کد یک‌بارمصرف دستگاه را در صفحه ورود تأیید کنید.
پوشه‌ای را انتخاب کنید که تارتانک باید روی آن کار کند.
هدف، فایل‌های مهم و نتیجه دلخواه را روشن توضیح دهید.
برنامه مناسب خود را انتخاب کنید
همه برنامه‌ها به همان حساب و گفتگوهای شما متصل می‌شوند.
برای بررسی، ویرایش و تست پروژه بدون خروج از ویرایشگر.
نصب از VS Code Marketplace ↗برای گفتگو، پروژه‌ها، فایل‌ها، پیام صوتی و کارهای تصویری.
برای کار مستقیم در ترمینال، سرورها و جریان‌های خط فرمان.
مشاهده روش نصبنصب Tartanak CLI
به Node.js نسخه ۲۰ یا جدیدتر نیاز دارید.
macOS و Linux
$ npm install --global https://cli.tartanak.com/downloads/tartanak-cli-0.14.5.tgz --prefix "$HOME/.local"
$ export PATH="$HOME/.local/bin:$PATH"
$ hash -r
$ tartanak --versionWindows PowerShell
> npm install --global https://cli.tartanak.com/downloads/tartanak-cli-0.14.5.tgz
> tartanak --versionاگر قبلاً CLI را نصب کرده‌اید، برای دریافت نسخه تازه فقط tartanak --update را اجرا کنید.
ورود امن به حساب
ورود هر برنامه فقط یک بار انجام می‌شود و نشست آن در همان دستگاه باقی می‌ماند.
$ tartanak login
1) Open this URL: https://cli.tartanak.com/device
2) Enter and approve this code: ABCD-EFGH
$ tartanak account- نشانی نمایش‌داده‌شده را در مرورگر باز کنید.
- کد را در همان صفحه وارد و تأیید کنید.
- به برنامه برگردید؛ اتصال به‌صورت خودکار کامل می‌شود.
آن را فقط در صفحه ورود تارتانک وارد کنید.
اولین درخواست خود را اجرا کنید
درخواست خوب، هدف و نتیجه مورد انتظار را کوتاه و روشن بیان می‌کند.
$ cd my-project
$ tartanak
tartanak> Inspect this project, fix the failing tests, and verify the result.«یک صفحه ورود واکنش‌گرا بساز و آن را تست کن.»
«علت خطای فعلی را پیدا کن، اصلاحش کن و تست‌ها را اجرا کن.»
«تغییرات فعلی را از نظر امنیت و خطاهای احتمالی بررسی کن.»
همه بخش‌های پروژه را متصل کنید
تارتانک پوشه‌های مجاز پروژه و تست‌های آن را با هم بررسی می‌کند تا همه بخش‌های تغییر هماهنگ بمانند.
پوشه اصلی پروژه را باز کنید. اگر بخش‌های پروژه در پوشه‌های جدا هستند، از File → Add Folder to Workspace همه پوشه‌های لازم را اضافه کنید؛ سپس مسیرهایی مانند ../backend بین همان پوشه‌های بازشده کار می‌کنند.
Select project را بزنید و یکی از پوشه‌های مخزن را انتخاب کنید. فرمان‌ها از همان پوشه شروع می‌شوند و مسیرهایی مانند ../backend در محدوده همان مخزن Git در دسترس هستند.
از --cd برای پوشه شروع استفاده کنید. مسیرهای ../ داخل ریشه Git کار می‌کنند؛ پوشه مستقل دیگری را با --add-dir مجاز کنید.
tartanak --cd ./frontend --add-dir ../shared-apiسطح دسترسی را انتخاب کنید
همیشه سطحی را انتخاب کنید که با نوع پروژه و میزان اعتماد شما هماهنگ باشد.
دستورهای کاربردی
در محیط تعاملی فقط / را بنویسید تا منوی دستورها باز شود.
/newیک گفتگوی تازه شروع می‌کند./historyگفتگوهای ذخیره‌شده را نشان می‌دهد./resumeیک گفتگوی قبلی را ادامه می‌دهد./modelsمدل‌های قابل استفاده برای حساب شما را نمایش می‌دهد./modelمدل همین گفتگو را تغییر می‌دهد./attachیک فایل را به درخواست بعدی پیوست می‌کند./reviewتغییرات پروژه را بررسی می‌کند./usageمانده طرح و میزان مصرف را نشان می‌دهد./limitبرای همین گفتگو یک سقف اختیاری می‌گذارد./capabilitiesقابلیت‌های در دسترس را نمایش می‌دهد./statusوضعیت اتصال و حساب را بررسی می‌کند./helpفهرست کامل راهنما را باز می‌کند./exitاز برنامه خارج می‌شود و سابقه گفتگو را نگه می‌دارد.گفتگوها و سابقه کار
بستن برنامه به معنی حذف گفتگو نیست؛ بعداً می‌توانید همان کار را ادامه دهید.
$ tartanak sessions
$ tartanak resume last
$ tartanak session rename SESSION_ID "Landing page"
$ tartanak session runs SESSION_IDدر پنل کاربری، بخش «نشست‌ها» همه دستگاه‌ها و گفتگوهای فعال را نشان می‌دهد. نشست‌های ناشناس یا بلااستفاده را از همان‌جا لغو کنید.
فایل، تصویر، PDF و پیام صوتی
زمینه لازم را همراه درخواست بفرستید تا پاسخ دقیق‌تر باشد.
- ＋افزودن فایل
در VS Code و Desktop از دکمه + استفاده کنید. در CLI فرمان /attach را بنویسید.
- ▧تصویر و PDF
از تارتانک بخواهید تصویر را تحلیل، ویرایش یا به‌عنوان مرجع پروژه استفاده کند.
- ◉پیام صوتی
در برنامه‌های دارای میکروفون، صحبت کنید؛ متن آماده‌شده را بررسی و سپس ارسال کنید.
قابلیت‌های دلخواه خود را فعال کنید
قابلیت‌های قابل استفاده حساب شما در همه برنامه‌ها هماهنگ می‌شوند.
در پنل کاربری وارد «قابلیت‌ها» شوید، دسته مورد نظر را باز کنید و گزینه‌های دلخواه را روشن یا خاموش کنید. موارد فعال پس از تازه‌سازی در VS Code، Desktop و CLI دیده می‌شوند.
tartanak capabilitiesپلن‌ها و میزان مصرف خود را ببینید
پلن فعلی، پلن‌های رزروشده، مانده دوره، تاریخ پایان و سابقه درخواست‌ها همیشه در پنل شما قابل مشاهده است.
- 1رزرو برای دوره بعد
می‌توانید پلن تازه را بدون قطع دوره فعلی به انتهای صف اضافه کنید. ترتیب و زمان تقریبی شروع همیشه در پنل دیده می‌شود.
- 2ارتقای فوری با محاسبه شفاف
برای رفتن به پلن بالاتر، پیش از تأیید مقدار قابل‌بازگشت نمایش داده می‌شود. بخش استفاده‌نشده پلن خریداری‌شده بر پایه کمترِ زمان و مصرف باقی‌مانده محاسبه و به کیف اعتبار شما افزوده می‌شود.
- 3خرید پلن با کیف اعتبار
اعتبار بازگشتی یا شارژشده در حساب باقی می‌ماند و می‌توانید بعداً با آن یک پلن را رزرو یا فوراً فعال کنید.
- 4فعال‌سازی خودکار و قابل ادامه
با پایان زمان، اعتبار یا سقف مصرف پلن فعلی ـ هرکدام زودتر رخ دهد ـ اولین پلن آماده فعال می‌شود. اگر کاری در حال انجام باشد، ابتدا همان کار تمام و ثبت می‌شود.
برای دیدن خلاصه در ترمینال از tartanak usage و برای مشخصات طرح از tartanak plan استفاده کنید.
برنامه‌ها را به‌روز نگه دارید
نسخه‌های تازه شامل بهبود پایداری، امنیت و تجربه کاربری هستند.
tartanak --updatetartanak update --check فقط نسخه تازه را بررسی می‌کند.از صفحه افزونه‌ها Tartanak Agent را باز و Update را انتخاب کنید. پس از نصب، Developer: Reload Window را اجرا کنید.
اگر نسخه تازه‌ای موجود باشد، اعلان به‌روزرسانی بالای برنامه نمایش داده می‌شود.
رفع اشکال‌های رایج
این چند بررسی معمولاً مشکل را سریع حل می‌کند.
بعد از به‌روزرسانی هنوز نسخه قدیمی اجرا می‌شود
$ type -a tartanak
$ hash -r
$ "$HOME/.local/bin/tartanak" --versionاگر چند مسیر نمایش داده شد، مسیر $HOME/.local/bin را پیش از مسیرهای قدیمی PATH قرار دهید.
هنگام نصب خطای EACCES می‌بینم
فرمان macOS/Linux همین صفحه را با --prefix "$HOME/.local" اجرا کنید و از sudo استفاده نکنید.
فقط بخشی از پروژه تغییر کرد
بررسی کنید همه پوشه‌های لازم در محدوده پروژه باشند. در VS Code از Add Folder to Workspace استفاده کنید؛ در Desktop یک پوشه داخل مخزن مشترک را انتخاب کنید؛ و در CLI پوشه مستقل را با --add-dir اضافه کنید. سپس یک گفتگوی تازه برای محدوده جدید شروع کنید.
درخواست طولانی است و ظاهراً متوقف شده
تا زمانی که وضعیت «در حال انجام» است درخواست را دوباره ارسال نکنید. برنامه اتصال را بازیابی می‌کند و نتیجه در همان گفتگو باقی می‌ماند. در صورت نیاز Stop را بزنید و سپس از /resume ادامه دهید.
مدل مورد نظر در فهرست نیست
فهرست مدل‌ها به طرح و دسترسی حساب شما وابسته است. صفحه را تازه کنید یا /models را اجرا کنید؛ اگر همچنان نمایش داده نشد با پشتیبانی تماس بگیرید.
اگر پیش از پایان پلن فعلی، پلن دیگری بخرم چه می‌شود؟
پیش از پرداخت می‌توانید «رزرو برای بعد» یا، برای پلن بالاتر، «ارتقای فوری» را انتخاب کنید. در ارتقای فوری ابتدا مبلغ قابل‌بازگشت به‌صورت شفاف نمایش داده می‌شود؛ پس از تأیید، پلن قبلی پایان می‌یابد، اعتبار واجدشرایط به کیف حساب برمی‌گردد و پلن تازه شروع می‌شود. رزرو عادی همچنان پلن فعلی را قطع نمی‌کند.
نشست ورود نمایش داده نمی‌شود
چند لحظه برای بررسی نشست صبر کنید. اگر صفحه ورود همچنان باقی ماند، برنامه را یک‌بار تازه‌سازی کنید و سپس tartanak account یا وضعیت حساب را بررسی کنید.
کنترل و حریم خصوصی
شما مشخص می‌کنید تارتانک به کدام پروژه و قابلیت‌ها دسترسی داشته باشد.
- فقط ریشه‌های پروژه که انتخاب یا صریحاً اضافه کرده‌اید برای کار محلی مجاز هستند.
- عبور با .. فقط زمانی مجاز است که مقصد نهایی داخل یکی از ریشه‌های مجاز باشد؛ مسیرهای خارج از محدوده و میان‌برهای نمادین ناامن مسدود می‌شوند.
- فایل‌های پیوست‌شده فقط برای همان درخواست در دسترس هستند.
- در حالت تأیید، پیش از اجرای ابزار یا تغییر فایل از شما اجازه گرفته می‌شود.
- از پنل نشست‌ها می‌توانید دسترسی هر دستگاه را لغو کنید.
- گذرواژه حساب خود را داخل گفتگو یا ترمینال وارد نکنید.
پشتیبانی تارتانک همراه شماست
نام برنامه، نسخه و متن دقیق خطا را برای ما بفرستید. اطلاعات ورود یا رمز عبور را ارسال نکنید.