البداية السريعة
هذا أقصر طريق من الصفر إلى تقرير حقيقي في واردك. بعد ما ينفتح حسابك، الخطوات تحت تاخذ حوالي خمس دقائق. كل خطوة تحت شي تسوّيه فعلاً اليوم. ما فيه شي هنا «قريباً».
الخطوة 0: احصل على حساب
Section titled “الخطوة 0: احصل على حساب”-
سجّل دخولك على app.umarker.com. تنزل على المساحات، وهي شبكة مساحاتك. فيه مساحة اسمها General أُنشئت لك؛ افتحها.
-
تحقّق من بريدك. فيه بانر بأعلى اللوحة يطلب منك كذا، وله سبب: نشر المشروع ودعوة زميل، الاثنان يحتاجان بريداً مُتحقَّقاً منه. افتح الرابط اللي أرسله لك uMarker، وارجع. البانر يختفي.
الخطوة 1: أنشئ مشروعاً وخلّه يجمع
Section titled “الخطوة 1: أنشئ مشروعاً وخلّه يجمع”المشروع = موقع واحد تجمع عليه الملاحظات. إنشاؤه يبي اسماً بس، والباقي شاشتان.
-
المشاريع ← مشروع جديد. اكتب له اسماً (تقدر تكتبه باللغتين) وأنشئه. وuMarker يسكّ المفتاح العام للمشروع (
md_…) على طول. -
افتح المشروع ← الودجت ← الإعداد. أضف موقعك تحت النطاقات المسموحة. ولو كنت تجرّب محلياً،
localhostمدخَل صالح. هذي القائمة حدّ أمان مو راحة: قائمة فاضية تعني إن الودجت ما يشتغل بأي مكان، وهذا مقصود، وuMarker يرفض ينشر المشروع بلا نطاق حيّ. -
انشر. استخدم زرّ نشر في ترويسة المشروع (أو على صفّ المشروع في القائمة). الشارة تنقلب من مسودّة إلى منشور، وهذا هو المفتاح اللي يخلّي الودجت مباشراً. ولو تخطّيت النطاق، النشر يُرفَض ويقول لك السبب.
الخطوة 2: التقط تقريراً
Section titled “الخطوة 2: التقط تقريراً”السنيبت هو المسار السريع: وسم <script> واحد، وزوّارك ما يركّبون ولا شي.
-
انسخ السنيبت. داخل المشروع، افتح الودجت ← السنيبت. uMarker يعرض السنيبت بالضبط، وفيه مفتاحك الحقيقي أصلاً. شكله كذا:
index.html <script>(function(w,d){var t=0;try{t=w.localStorage.getItem('md_mode_md_your_public_key')==='technical';}catch(e){}if(t&&!w.__mdCap){w.__mdCap=1;var L=w.__mdLogs=w.__mdLogs||[];var rec=function(lvl,msg){try{L.push({level:lvl,message:String(msg).slice(0,2000)});if(L.length>200)L.shift();}catch(e){}};['log','info','warn','error'].forEach(function(k){var o=console[k];if(o)console[k]=function(){try{rec(k,Array.prototype.map.call(arguments,String).join(' '));}catch(e){}return o.apply(console,arguments);};});w.addEventListener('error',function(e){rec('error',(e.message||'Script error')+' @ '+(e.filename||'')+':'+(e.lineno||''));},true);w.addEventListener('unhandledrejection',function(e){var m='Unhandled promise rejection';try{var r=e&&e.reason;m+=': '+((r&&(r.stack||r.message))||String(r));}catch(x){}rec('error',m);});}var s=d.createElement('script');s.async=1; s.src='https://api.umarker.com/widget/v1.js'; s.setAttribute('data-umarker-key','md_your_public_key');(d.head||d.documentElement).appendChild(s);})(window,document);</script>انسخ المولَّد، لا تكتبه بيدك.
-
ألصقه بأعلى
<head>ما تقدر، قبل سكربتاتك أنت. لمّا يكون المشروع على وضع الالتقاط التقني، الجزء الصغير المضمّن يبدأ يخزّن مخرجات الكونسول والأخطاء على طول، فالأعطال اللي تطلع قبل لا يخلص الودجت تنزيله تظل توصل في التقرير. وفي الوضع العادي ما يسجّل شي. والودجت نفسه يُحمَّل بشكل غير متزامن وما يبطّئ صفحتك. -
افتح صفحتك. زرّ uMarker يظهر أسفل اليمين (أو وين ما حرّكته)، وحسب قواعد الاستهداف اللي ضبطتها. واللوحة تكتشف أول تحميل لحالها وتقلب حالة التثبيت إلى مُثبَّت بلا ما تحدّث الصفحة.
-
التقط. انقر الزرّ، وأداة الالتقاط تفتح مباشرة على صفحتك، وما فيه نموذج تعبّيه أول.
- فحص عنصر هي الأداة الافتراضية. مرّر: أعمق عنصر تحت المؤشّر يُضيء بنموذج صندوقه. والأسهم تصعد وتنزل في شجرة الـDOM. انقر عشان تربط ملاحظة بذاك العنصر. وأشرطة الهوامش البرتقالية قابلة للنقر بعد، لو كانت المسافة هي الغلط.
- تعليق وتظليل ورسم موجودات لأي شي مو عنصراً.
- كل علامة تصير دبوساً مرقّماً له ملاحظته. اضغط حفظ (أو Enter) عشان ترتبط؛ والعلامة اللي تُقفل بلا ملاحظة تنحذف، فما فيه شي يُدبَّس على الصفحة بلا كلام.
- اضغط مراجعة تشوف كل الدبابيس على خريطة مصغّرة، ثم إرسال للمراجعة.
اللقطة تُؤخذ في تلك اللحظة، لصفحة نظيفة وأداتنا مخفيّة. ورابط الصفحة وبيانات الجهاز تُرفَق تلقائياً، وفي وضع الالتقاط التقني معها رسائل الكونسول والطلبات الفاشلة وباقي السجلّ التقني.
الإضافة للمختبِرين اللي تصرّح لهم: يلتقطون على أي صفحة يغطّيها حسابك، بلقطة متصفّح حقيقية بدل تصيير الـDOM.
-
أضف المختبِر. في اللوحة، افتح المشروع ← الودجت ← الإضافة وأضف بريد المختبِر. وuMarker يصدر رمز اتصال (
mdc_…) تعطيه إياه. الرمز يُعرَض مرّة وحدة، فانسخه قبل ما تغادر الشاشة — بس عامله ككلمة مرور، مو كرمز يُستهلَك بمرّة: يظل شغّالاً لين تضغط رمز جديد، اللي يستبدله ويسجّل خروج جلسة ذاك المختبِر الحالية. والمختبِر اللي مو مُسنَد لأي مشروع ما يجيه شي: الإضافة تفشل مُغلقة. -
اتصال. المختبِر ينقر أيقونة uMarker، يقرأ بيان وش اللي يُجمَع، يأشّر على مربّع الموافقة، ويلصق الرمز. الحالة تنقلب من غير متصل إلى متصل وتظل كذا — لين يفصل هو، أو تصدر أنت رمزاً جديداً، أو تقعد الجلسة بلا استخدام 90 يوماً فتُحذف. وإعادة الاتصال بعدها هي نفس لصق نفس الرمز.
-
افتح صفحة يغطّيها حسابك. الزرّ يظهر. وعلى موقع ما تغطّيه نطاقات مشروعك، ما يظهر ولا شي.
-
التقط. نفس أداة الالتقاط اللي في السنيبت (نفس الملفّ حرفياً)، بنفس الأدوات ونفس النهاية مراجعة ← إرسال للمراجعة. ولمّا يكون المشروع على وضع الالتقاط التقني، يحمل التقرير سجلّ الشبكة كامل والكونسول والأخطاء مع تتبّعها البرمجي، وعلى المتصفّحات المبنيّة على Chromium كمان رسائل CORS وCSP اللي ما تقدر الصفحة نفسها تشوفها.
الخطوة 3: شوفه في الوارد
Section titled “الخطوة 3: شوفه في الوارد”-
افتح مساحتك وروح الوارد. تقريرك في عمود جديد بحالة
new— وبالأعلى، لأنه البطاقة الوحيدة هناك. اللوحة ترتّب بالأولوية قبل الحداثة، فلمّا يصير عندك تراكم، التقرير الجديد اللي بلا أولوية ينزل تحت اللي لها أولوية؛ وعرض القائمة يرتّب الأحدث أولاً افتراضياً. -
افتحه. صفحة التقرير تعيد رسم علاماتك فوق اللقطة الحقيقية: إطارات العناصر، وأشرطة برتقالية فوق الهامش اللي أُشّر عليه، والدبابيس المرقّمة بنصوصها. وشارة تقول بأي وضع التقاط انرسل التقرير. وفي التقرير التقني، بجانبها السياق المُلتقَط: رسائل الكونسول والطلبات الفاشلة وبيانات المتصفّح، بخطّ أحادي المسافة ومُعامَلة كمعطى من الدرجة الأولى. والتقرير العادي يوضّح إنه يحمل اللقطة والملاحظات والصفحة والجهاز بس.
-
انقر دبوساً. له خيط نقاش مستقل وزرّ تمّ مستقل، منفصلان عن حالة التقرير.
الخطوة 4: افرزه
Section titled “الخطوة 4: افرزه”-
حطّ أولوية، وطبّق تسمية أو أكثر، واختر مُسنَداً إليه. شوف التسميات والأولوية والإسناد. مساحة General عندك تبدأ بأربع تسميات مبذورة — علة وفكرة وسؤال وتحسين — وكل وحدة تحمل الكتابتين، فكل قارئ يشوفها بلغته ويكون فيه شي تنقر عليه من أول يوم.
-
حرّك الحالة من
newإلىin_progress، وبعدين إلىresolved. وكل تغيير يُسجَّل باسمك في سجلّ التدقيق، والسجلّ يُحفَظ 30 يوماً. وهو مو شاشة في لوحتك: توصلك صفوفه في تصدير بيانات حسابك. شوف دورة حياة الحالة. -
ولو تبي، اكتب تعليقاً داخلياً بمنشن، أو ادفع التقرير إلى GitHub أو Linear أو Jira كتذكرة — GitHub من باقة البداية فما فوق، والثلاثة من الاحترافي. وإغلاق التذكرة يحرّك التقرير عنك بعد ما تشغّل المزامنة العكسية: انسخ رابط مزامنة الحالة العكسية للاتصال من التكاملات ← إدارة وحطّه في webhooks أحداث التذاكر عند متتبّعك. وقبل كذا، إغلاق التذكرة ما يغيّر شي هنا، والتقرير المؤرشف ما يتحرّك بأي حال.
هذي الحلقة كاملة: يُلتقَط بأقل من دقيقة، ويُفرَز بأقل من ثلاثين ثانية. وكل شي ثاني في uMarker مبني فوقها.