اطّلع على ما يحتاج إلى مراجعة
اطّلع على أشجار عمل وكلائك وتغييراتهم غير المُودَعة في مكان واحد. راجع التغييرات عالية الخطورة، وافحص أي شيء يحتاج إلى إصلاح، وأودِع كودك من صفحة التغييرات.
يستخدم هذا الدليل مثال Twitter من Panolayer، twitter-starter. إذا كنت قد اتبعت إصلاح أول خطأ لك باستخدام Panolayer، فاستخدم هذه الخطوات لمراجعة إصلاح الحذف.
تُظهر لقطات الشاشة والمقاطع القصيرة عدة تغييرات في تطبيق Twitter نفسه، منها تغييرات التنسيق والبحث والتصدير والمنشورات المحفوظة. تعتمد قائمة ملفاتك ودرجات الخطورة ومعرّفات الإيداع على العمل الذي تراجعه. انقر على أي لقطة شاشة لعرضها بالحجم الكامل.
افتح التغييرات في الشريط الجانبي. على الجانب الأيمن، يمكنك رؤية أشجار العمل المختلفة والكود غير المُودَع من وكلائك. اختر شجرة عمل لترى ما غيّره ذلك الوكيل، مع ترتيب الملفات من الأعلى إلى الأدنى خطورة.
تنقّل بين أشجار عمل وكلائك، وراجع تغييراتهم، وأودِع الكود من هذه الصفحة. تتيح لك درجات الخطورة أن ترى سريعًا الملفات التي تحتاج إلى انتباهك والتي قد تحتاج إلى إصلاح.
يمكنك أيضًا اختيار إيداع موجود في السجل لمراجعة ما تم تسجيله. إذا كنت قد دمجت إصلاح الحذف بالفعل، فستجده هناك؛ فقد سجّل دمجه التغيير محليًا بالفعل.
راجع التغييرات من الأعلى إلى الأدنى خطورة
تقيّم ميزة التغييرات الملفات من عالية المخاطر إلى غير عالية المخاطر وتوضح ما الذي تغيّر. ابدأ بالملفات الأعلى خطرًا لفهم ما يحتاج إلى مراجعة وربما إصلاح قبل الالتزام.
بدّل بين طيف المخاطر وأشرطة المخاطر والتداخل لاستكشاف التغييرات نفسها في ثلاثة عروض مرئية.
طيف المخاطر
اطّلع على الملفات المتغيّرة مرتبة على طيف أفقي، من عالية المخاطر على اليسار إلى منخفضة المخاطر على اليمين.
أشرطة المخاطر
قارن الملفات كأشرطة مرتبة حسب المخاطر. يمتد العرض من شديد المخاطر إلى غير عالي المخاطر، ما يسهّل رؤية أين تحتاج التغييرات إلى انتباه.
التداخل
اطّلع على أماكن تداخل تغييرات واجهة المستخدم وتغييرات المنطق والتغييرات عالية المخاطر. تعرض الملفات المجمّعة كيفية ارتباط هذه الأجزاء من التغيير ببعضها.
افحص تغييرًا يستدعي الانتباه
تعرض نظرة عامة على المخاطر أين تركّز مراجعتك. افتح ملفًا عندما تريد فهم تغيير معيّن بمزيد من التفصيل.
- اختر ملفًا في الرسم البياني أو قائمة الملفات المتغيّرة.
- اقرأ مساره وملخص التغيير وشرح المخاطر.
- اختر تقسيم لمقارنة جنبًا إلى جنب، أو مضمّن لقراءة التغييرات في عرض واحد.
- تتبّع التغيير عبر الدالة ذات الصلة والمستدعين لها. تحقق أيضًا من الاختبارات وملفات التكوين والاعتماديات ذات الصلة.
لإصلاح الحذف، افتح components/Post.tsx وافحص handleDelete(). تحقق من كيفية معالجة التغيير لشرط canDelete المُبلّغ عنه، وما إذا كان تأكيد المستخدم وطلب الحذف ومعالجة الاستجابة الناجحة لا تزال منطقية معًا.
اقرأ التحليل واسأل عن المخاوف
يتوفر التحليل المتعمق من Panolayer Agent دائمًا في التغييرات. افتح لوحة Panolayer Agent – Deep Analysis لقراءة تقييمها والمخاوف ومراجع المصادر. تتبّع أي مخاوف إلى الملف ذي الصلة لفهم ما يستدعي الانتباه.
شاهد: فحص تحليل تغيير تصدير Twitter
يعرض مقطع التحليل الحالي تغييرًا في التصدير داخل تطبيق Twitter، مع مخاوف مرتبطة بالملفات المتأثرة.
استخدم الدردشة لمواصلة المراجعة مع Panolayer Agent. اطرح سؤالًا مرتبطًا بالسلوك الذي تتحقق منه، مثل:
«كيف يعالج هذا التغيير مشكلة الحذف، وأي الاختبارات تغطي السلوك المتوقع؟»
استخدم الإجابة للتنقل في التغيير والتحقيق في أي شيء غير واضح.
اقرأ التحقق إلى جانب المراجعة
يمكن أن تعرض التغييرات نتائج التحقق على الدوال المتأثرة. اقرأ القواعد الفاشلة وأي فحوصات لا تزال معلّقة أو غير متاحة، ثم تتبّع تفسيراتها داخل الشيفرة.
تساعدك نظرة عامة على المخاطر في اختيار أين تنظر. يمنحك التحليل العميق مواضع قلق تستقصيها. تُبلّغ نتائج التحقق عن فحوصات مقابل توقعات حول سلوك الشيفرة. اقرأها مع الفرق (diff) والاختبارات ذات الصلة.
في مثال الحذف، تأكد من إصلاح الفشل المحدد وراجع أي إخفاقات جديدة بشكل منفصل عن المشكلات الموجودة مسبقًا. راجع فهم نتيجة تحقق للاطلاع على حقول الملخص والحالات.
شغّل التطبيق عندما يحتاج التغيير إلى فحص وقت التشغيل. في هذا الإصلاح، جرّب حذف منشور وتحقق من أن التأكيد أو الإلغاء يتصرف كما هو متوقع.
Merge the agent’s work when you’re satisfied
When the agent requests a merge, review the verification summary and confirm the target branch. Choose Not now to keep reviewing, or Merge into main to bring the work into the sample’s main branch.
The Merged into main confirmation shows the commit ID. This workflow records the agent’s change in local Git history; you do not need to commit that same change again.
Commit any uncommitted edits
Use this step for your own edits or other uncommitted work in the current workspace. If the agent’s merge already saved the change and you have no further edits, continue to History.
- Check the full changed-file list.
- Review the suggested commit message. Use Edit message if it needs to describe the change more clearly.
- Choose Commit to save the changes to the local branch. Choose Commit & Push if you also want to send the commit to a configured remote.
A Panolayer commit includes every changed file in the workspace. Use Git directly if you need to stage only part of the change. Read any reported check failures before deciding to commit; a commit can still be created when checks fail.
Confirm the result in History
Open History and find the new commit using its message, author, and commit ID. Select it to inspect the recorded change, then return to Working tree to check for remaining uncommitted edits.
Watch: Confirm a Twitter saved-post change in merge confirmation and History
This existing clip follows a saved-post change in the Twitter app. Use the commit ID from your own merge confirmation to find your change.
For the deletion fix, you should be able to find its recorded change and inspect the files that landed. Check that no unexpected uncommitted edits remain.
Push when you’re ready to share the commit
A merge or commit saves work locally. To send an existing local commit to your Git remote, open Git and choose Push.
Pushing requires a configured remote and permission to write to it. If the sample has no remote, the local commit completes this walkthrough. If a push reports an error, read it and resolve the remote or sign-in problem before trying again.
Use your Git host for pull requests and team review.