تثبيت Trs SDK

‏Trs SDK سكربت صغير تضيفه إلى موقعك. رابط دعم العملاء لوحده يسجّل شاشة العميل — لكن مع الـ SDK، يجي التسجيل ومعه سجلات الـ console وطلبات الشبكة وتفاصيل البيئة، تمامًا مثل الجلسة الملتقطة بالإضافة. ويبقى الـ SDK خاملًا حتى يبدأ التقاط فعلي، وتُحجب القيم الحساسة من السجلات تلقائيًا.

التثبيت عبر وسم script

أسرع طريقة: أضف وسمَي التحميل في أعلى head — قبل حزمك أنت — في كل صفحة تريد تغطيتها.

1<script
2  src="https://cdn.try-trs.com/v1/capture.js"
3  data-tirs-key="YOUR_SDK_KEY"
4></script>
5<script
6  src="https://cdn.try-trs.com/v1/recorder.js"
7  defer
8></script>
Copy

تلقى مفتاح مساحة العمل في التطبيق تحت Settings ← SDK. حجم السكربت كيلوبايتات قليلة، ويُحمَّل مؤجلًا، ولا يفعل شيئًا إلا عند وجود التقاط نشط من تِرس في الصفحة.

التثبيت من npm

إذا كنت تحزم واجهتك الأمامية، ثبّت الحزمة بدلًا من ذلك:

1npm install @tirs/core @tirs/care @tirs/recorder
2# أو
3pnpm add @tirs/core @tirs/care @tirs/recorder
Copy

ثم هيّئها مرة واحدة، في أبكر نقطة ممكنة من دورة حياة تطبيقك:

1import { init } from '@tirs/core'
2import { care } from '@tirs/care'
3import { mountRecorder } from '@tirs/recorder'
4
5const tirs = init({ key: 'YOUR_SDK_KEY', plugins: [care()] })
6mountRecorder(tirs)
Copy

التحكم فيما يُلتقط

الالتقاط محافظ افتراضيًا — حجب البيانات الحساسة (redact) مفعّل من البداية، وتقدر عبر denyUrls تمنع التقاط أجسام الطلبات والاستجابات لنقاط نهاية معيّنة، أو تفعّل preroll عشان يحتفظ بالثواني اللي قبل ما يضغط العميل زر التسجيل.

1import { init } from '@tirs/core'
2import { care } from '@tirs/care'
3
4init({
5  key: 'YOUR-KEY',
6  plugins: [care()],
7  redact: true, // PII redaction of captured logs — on by default
8  preroll: 5000, // keep the last 5s of console + network from before recording started
9  denyUrls: [/\/auth\//], // never capture request/response bodies for matching URLs
10})
Copy

تأكد من التثبيت

1. أنشئ رابط دعم عملاء لنطاقك الموثّق وافتحه — الرابط يفتح موقعك نفسه ومعه لوحة التسجيل.
2. ابدأ تسجيلًا ونفّذ أي إجراء.
3. افتح الجلسة في app.try-trs.com — المفروض تلقى تبويبَي Console وNetwork معبّأين بالسجلات.

الخطوة التالية

بعد تفعيل الـ SDK، روابط دعم العملاء بتوصلك بالقصة التقنية كاملة — راجع «روابط دعم العملاء».