ForHosting KIT · أدوات المطورين

مقارنة النصوص سطرا بسطر وإظهار الاختلافات

تقارن أداة فروق الأسطر بين النص الأصلي والنص المنقح، ثم تعرض النتيجة وفق ترتيب القراءة.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

يوسم كل سطر بأنه مضاف أو محذوف أو ثابت، مع رقم السطر المناسب في كل نسخة. تفيدكم الأداة في مراجعة التحريرات، وفحص الملفات المنشأة، والتحقق من تغييرات الإعدادات، وفهم الفروق الدقيقة بين نسختين. المقارنة حتمية، ولا تستخدم اتصالا بالشبكة، كما توحد التعامل مع نهايات الأسطر في Windows وMac القديم وUnix.

جهزوا النسختين للحصول على مقارنة مفيدة

ضعوا النسخة الأقدم في حقل النص الأصلي، والنسخة الأحدث في حقل النص المنقح. تقارن الأداة الأسطر كاملة، ولذلك تؤثر علامات الترقيم وحالة الأحرف والمسافات وكل محرف آخر في النتيجة. إذا تغير محرف واحد في سطر، يظهر السطر أولا بوصفه محذوفا ثم بوصفه مضافا. يحافظ هذا السلوك على دقة المراجعة المبنية على الأسطر، بدلا من الإيحاء بأن سطرين مختلفين لم يتغيرا. توحد الأداة نهايات الأسطر قبل المقارنة، ولذلك يمكنكم مقارنة نص منسوخ من Windows أو Unix أو أجهزة Mac القديمة من دون فروق زائفة ناتجة فقط عن اختلاف ترميز الرجوع إلى أول السطر. تبقى الأسطر الفارغة داخل الوثيقة ذات معنى، وقد تظهر مضافة أو محذوفة أو ثابتة. وإذا انتهت الوثيقة بمحرف سطر جديد، فإن السطر الفارغ الأخير الناتج عنه يدخل في المقارنة أيضا. للحصول على مراجعة أوضح، تجنبوا تغيير التنسيق غير المرتبط بالمحتوى في الوقت نفسه الذي تجرون فيه تعديلات جوهرية، لأن إعادة التنسيق الواسعة تنتج بطبيعتها فروقا أكبر حتى لو ظلت الأفكار الأساسية متقاربة.

اقرؤوا الحالات وأرقام الأسطر والملخص

تسير النتيجة بالترتيب اللازم لإعادة بناء الانتقال من النسخة الأصلية إلى النسخة المنقحة. يتضمن السطر الثابت رقميه القديم والجديد، لأن السطر نفسه موجود في النصين. أما السطر المحذوف فيتضمن رقمه القديم فقط، ويعرض السطر المضاف رقمه الجديد فقط. غياب الحقل الآخر مقصود؛ فالسطر المضاف لا موضع له في الوثيقة القديمة، والسطر المحذوف لا موضع له في الوثيقة الجديدة. تمنحكم أعداد الملخص قياسا سريعا لحجم التحرير، بينما تقدم قائمة الأسطر المفصلة الدليل الذي تستند إليه تلك المجاميع. لا تكون علامة التطابق صحيحة إلا عند عدم وجود أي إضافة أو حذف. قد تسمح الأسطر المتكررة أحيانا بأكثر من محاذاة صحيحة رياضيا. ولضمان ثبات المخرجات، تطبق الأداة قاعدة ثابتة لفك التعادل وتفضل الحذف عندما تحافظ محاذاتان على العدد نفسه من الأسطر الثابتة. لذلك تعطي المدخلات نفسها التسلسل نفسه دائما، مما يجعل النتيجة ملائمة للاختبارات ومسارات المراجعة الآلية.

استخدموا الفروق بأمان في المراجعة والأتمتة

تكتسب مقارنة الأسطر قيمة خاصة عندما تكون البنية مهمة، كما في ملفات الشفرة المصدرية والإعدادات وملاحظات الإصدارات والقوائم والسياسات والتعليمات والسجلات المصدرة. عند المراجعة البشرية، ابدؤوا بالملخص ثم افحصوا كل زوج من الأسطر المحذوفة والمضافة ضمن سياقه. وفي الأتمتة، افحصوا علامة التطابق لاتخاذ قرار سريع، واحتفظوا بالتفاصيل إذا احتجتم إلى سجل تدقيق أو تقرير تفسيري. لا تحكم الأداة على صحة التحرير، ولا تدمج التغييرات المتنافسة، ولا تحسب التشابه الدلالي. إنها تعرض العلاقات النصية الدقيقة حتى يتخذ الشخص أو قاعدة حتمية أخرى القرار المناسب. تخضع المدخلات لحدود تضمن تنفيذا متوقعا، وتتم المقارنة كلها في الذاكرة من دون الاتصال بخدمات خارجية. تبلغ كلفة استخدام API لكل طلب $0.002. عند معالجة ملفات كثيرة، قارنوا كل زوج على حدة واحتفظوا بأسماء الملفات أو معرفات النسخ ضمن مسار عملكم، لأن هذه الإمكانية تستقبل النص ولا تستقبل بيانات المستودع الوصفية. وللمواد الحساسة، التزموا بمتطلبات الحفظ والنقل الخاصة بالقناة التي ترسلون الطلب من خلالها.

حالات الاستخدام

مراجعة تعديلات الإعدادات

قارنوا الإعداد القديم بالمقترح لتحديد كل سطر تضيفه عملية التحديث أو تحذفه بدقة.

التحقق من المخرجات المنشأة

افحصوا ملف بيان أو تقريرا أو مقطعا برمجيا منشأ حديثا بمقارنته مع نسخة متوقعة ومعروفة ضمن مسار آلي.

توضيح مراجعات الوثائق

أنشئوا سجلا منظما لتغييرات السياسات أو ملاحظات الإصدارات أو التعليمات أو غيرها من الوثائق المبنية على الأسطر.

الأسئلة الشائعة

ماذا تعني كل حالة؟

تعني حالة الثبات أن السطر نفسه يظهر في المحاذاة المختارة للنسختين. ويعني الحذف أنه موجود في الأصل فقط، بينما تعني الإضافة أنه موجود في النسخة المنقحة فقط.

هل تقارن الأداة الكلمات داخل السطر المتغير؟

لا. فهذه مقارنة مقصودة على مستوى السطر. يظهر السطر المتغير كحذف وإضافة، مما يحفظ سجلا دقيقا لا لبس فيه.

هل تعد صيغ نهايات الأسطر المختلفة تغييرا؟

لا. توحد الأداة نهايات الأسطر في Windows وUnix وMac القديم قبل إجراء المقارنة.

كيف تحاذى الأسطر المتطابقة المتكررة؟

تحافظ الخوارزمية على أطول تسلسل مشترك من الأسطر، وتطبق قاعدة ثابتة تفضل الحذف عند وجود محاذات متكافئة.

هل يمكن استخدام النتيجة في الاختبارات الآلية؟

نعم. لا تستخدم الخوارزمية الشبكة أو العشوائية أو قيما مرتبطة بالوقت، ولذلك تنتج المدخلات المتطابقة مخرجات JSON متطابقة دائما.

ما كلفة طلب API؟

تبلغ كلفة كل طلب API مقدار $0.002. ويمكن لنسخة المتصفح تنفيذ المقارنة الحتمية نفسها محليا.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/str/diff-lines

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/str/diff-lines \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before_text":"Apples\nBananas\nCherries","after_text":"Apples\nBlueberries\nCherries"}'

const res = await fetch("https://api.kit.forhosting.com/str/diff-lines", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "before_text": "Apples\nBananas\nCherries",
    "after_text": "Apples\nBlueberries\nCherries"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/str/diff-lines",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "before_text": "Apples\nBananas\nCherries",
    "after_text": "Apples\nBlueberries\nCherries"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/diff-lines", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"before_text":"Apples\\nBananas\\nCherries","after_text":"Apples\\nBlueberries\\nCherries"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"before_text":"Apples\nBananas\nCherries","after_text":"Apples\nBlueberries\nCherries"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/diff-lines", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "before_text": "Apples\nBananas\nCherries",
  "after_text": "Apples\nBlueberries\nCherries"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "str.diff_lines",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الحدود

`max_chars_per_text`	200000
`max_lines_per_text`	1000

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←