سوالات متداول
حالت توسعه‌دهنده / مجوزهای اسکریپت کاربری
سوال: ScriptCat پیام «حالت توسعه‌دهنده فعال نیست» را نشان می‌دهد و اسکریپت‌ها اجرا نمی‌شوند؟
از Chrome 120+ و نسخه‌های جدیدتر Edge، مرورگرها از کاربران می‌خواهند مجوزها را به صورت دستی فعال کنند تا اسکریپت‌ها اجرا شوند. لطفاً برای دستورالعمل‌های راه‌اندازی به فعال‌سازی پشتیبانی اسکریپت‌های کاربری مرورگر مراجعه کنید.
اگر قبلاً فعال شده اما هشدار همچنان باقی است، سعی کنید مرورگر را مجدداً راه‌اندازی کنید یا افزونه را بارگذاری مجدد کنید.
اسکریپت‌ها کار نمی‌کنند
سوال: اسکریپتی نصب کرده‌ام اما هیچ اثری ندارد؟
- «Allow User Scripts» فعال نیست — به فعال‌سازی پشتیبانی اسکریپت‌های کاربری مرورگر مراجعه کنید
- شروع سرد — اسکریپت‌ها ممکن است بلافاصله هنگام باز شدن مرورگر بارگذاری نشوند. سعی کنید صفحه را تازه‌سازی کنید
- تداخل افزونه‌ها — مسدودکننده‌های تبلیغات (مثلاً uBlock Origin) ممکن است خطاهای اسکریپت ایجاد کنند
سوال: اسکریپت در Tampermonkey کار می‌کند اما در ScriptCat نه؟
ScriptCat و Tampermonkey تفاوت‌هایی در پیاده‌سازی API دارند. لطفاً به آخرین نسخه به‌روزرسانی کنید. اگر مشکل همچنان ادامه داشت، یک Issue در گیت‌هاب ثبت کنید.
محدودیت‌های CSP / Trusted Types
Q: اگر CSP یک سایت مانع اجرای اسکریپت شود چه کار کنم؟
در ScriptCat، بخش Network Rules را باز کنید و Tools → Network rules → New rule → Remove CSP را انتخاب کنید. در قسمت Websites فقط سایت مشکل‌دار را وارد کنید؛ برای مثال example.com. قانون را ذخیره کنید و صفحه‌های باز را دوباره بارگذاری کنید.
الگوی Remove CSP سرآیندهای پاسخ CSP را از پاسخ سندِ فریم اصلی و فریم‌های فرعی حذف می‌کند. حذف X-Frame-Options نیز اختیاری است.
Q: پیام This document requires 'TrustedHTML' assignment. یعنی چه؟
معمولاً مرورگر به دلیل اعمال Trusted Types در سایت، یک عملیات DOM را رد کرده است. سایت می‌تواند Trusted Types را با دستور CSP یعنی require-trusted-types-for 'script' فعال کند؛ اگر userscript عملی انجام دهد که با این سیاست سازگار نباشد، این خطا ممکن است ظاهر شود. مرورگر سیاست امنیتی سایت را اعمال می‌کند و این پیام به‌تنهایی ثابت نمی‌کند که ScriptCat باعث مشکل شده است.
اگر محدودیت با سرآیند اجباری CSP در پاسخ سند فعال شده باشد، قانون Remove CSP برای همان سایت ممکن است کمک کند. اگر علت خطا یکی از سرآیندهای پاسخ CSP قابل حذف نباشد، این راه‌حل تضمین‌شده نیست.
Q: چرا ScriptCat به‌طور پیش‌فرض CSP همه سایت‌ها را حذف نمی‌کند؟
CSP و Trusted Types به کاهش خطرهایی مانند اسکریپت‌نویسی میان‌سایتی (XSS) کمک می‌کنند. حذف CSP محافظت امنیتی اصلی سایت‌های منطبق را تضعیف می‌کند. فقط برای سایت‌هایی قانون بسازید که واقعاً به آن نیاز دارند. دامنه All websites وجود دارد، اما ScriptCat پیش از ذخیره تأیید می‌خواهد.
مگر اینکه اثر امنیتی دامنه All websites را درک می‌کنید و می‌پذیرید، از آن استفاده نکنید.
ScriptCat #1239 شامل یک مشکل جداگانهٔ سازگاری GM_xmlhttpRequest هم بود که در ScriptCat #1242 برطرف شد. این اصلاح Trusted Types را غیرفعال یا دور نمی‌زند و CSP سایت را تغییر نمی‌دهد. اگر نسخهٔ قدیمی ScriptCat را دارید، آن را به نسخهٔ فعلی به‌روزرسانی کنید.
مشکلات همگام‌سازی ابری
برای کاربرد پایه همگام‌سازی، به همگام‌سازی و پشتیبان‌گیری مراجعه کنید.
سوال: با همگام‌سازی OneDrive / Google Drive / WebDAV مشکل دارید؟
- اسکریپت‌های حذف‌شده دوباره ظاهر می‌شوند — مطمئن شوید «همگام‌سازی حذف» در همه دستگاه‌ها فعال است
مشکلات نصب اسکریپت
برای نحوه نصب اسکریپت‌ها، به نصب اسکریپت‌ها مراجعه کنید.
مشکلات مجوز کوکی
سوال: GM_cookie نمی‌تواند کوکی‌ها را دریافت کند؟
- پاپ‌آپ مجوز ظاهر نمی‌شود — مطمئن شوید
GM_cookieبه درستی در@grantاسکریپت اعلام شده است و از@connectبرای اعلام دامنه‌هایی که باید به آن‌ها دسترسی داشته باشید استفاده کنید
از دست رفتن داده‌های اسکریپت
سوال: همه اسکریپت‌ها پس از باز کردن مرورگر ناپدید شده‌اند؟
- تأخیر اولیه‌سازی — ScriptCat ممکن است هنگام شروع مرورگر همچنان در حال بارگذاری داده‌ها باشد. چند ثانیه صبر کنید یا مرورگر را مجدداً راه‌اندازی کنید
- نرم‌افزارهای پاک‌سازی — ابزارهایی مانند 360 Security Guard یا CCleaner ممکن است داده‌های افزونه را پاک کنند. داده‌های افزونه مرورگر را در تنظیمات پاک‌سازی مستثنی کنید
- پشتیبان‌گیری منظم توصیه می‌شود — از قابلیت خروجی یا همگام‌سازی ابری برای پشتیبان‌گیری منظم از اسکریپت‌ها و تنظیمات استفاده کنید