سجل تغييرات التطبيق
أداة سجل التغييرات تُحوّل قائمة تعديلات تقنية — إصلاحات، ميزات جديدة، تحسينات أداء — إلى نص واضح يفهمه المستخدم غير التقني، مرتب حسب نوع التغيير لا حسب ترتيب العمل الداخلي. تناسب فريق منتج يُصدر تحديثًا دوريًا لتطبيق أو موقع ويحتاج إعلانه بصياغة مفهومة لجمهوره.
شغّلها أونلاين
شغّل هذه المهمة على خوادمنا باستخدام حسابك. الأدوات المجانية تعمل داخل متصفحك، أما هذه فتُخصم من رصيدك في KIT حسب السعر الموضّح أعلاه.
من ملاحظات تقنية إلى نص مقروء
تُدخَل قائمة التعديلات كما دُوِّنت داخليًا — غالبًا مختصرة وتقنية — فتُعيد الأداة صياغتها بجمل واضحة تشرح أثر كل تغيير على المستخدم لا آلية تنفيذه داخل الكود. إصلاح خطأ في معالجة الدفع مثلًا يُصاغ كأثر ملموس: «أُصلحت مشكلة كانت تمنع إتمام الدفع في بعض الحالات»، لا وصف تقني للسطر المعدَّل.
التصنيف حسب نوع التغيير
تُقسَّم النتيجة إلى فئات ثابتة — ميزات جديدة، تحسينات، إصلاحات — بدل قائمة واحدة غير مرتبة يصعب على القارئ مسحها بسرعة لمعرفة ما تغيّر فعليًا. هذا الترتيب يناسب مستخدمًا يقرأ السجل بسرعة بحثًا عن إصلاح مشكلة واجهته تحديدًا.
السعر والتنفيذ
سعر ثابت $0.003 لكل طلب زائد $0.0135 لكل إصدار، أي نحو $0.0165 لسجل الإصدار الواحد. تعمل الأداة من صفحتها على الويب، ومتاحة عبر الـAPI لربطها بخط إصدار تلقائي يُنتج سجل تغييرات مع كل نشر جديد.
نبرة السجل حسب جمهوره
يمكن اختيار نبرة السجل — مباشرة ومختصرة لتطبيق استهلاكي، أو أكثر تفصيلًا تقنيًا لعملاء مطورين يستخدمون واجهة برمجية — فتضبط الأداة مستوى التفصيل واللغة وفق الجمهور المستهدف بدل نص واحد موحّد يناسب كل القراء دون تمييز.
حالات الاستخدام
فريق تطبيق مصرفي يُصدر تحديثًا شهريًا
يُصدر فريق تطبيق مصرفي في الرياض تحديثًا شهريًا يتضمن إصلاحات أمنية وميزات جديدة، ويستخدم الأداة لصياغة سجل تغييرات مفهوم لعملائه غير التقنيين قبل نشر التحديث.
شركة برمجيات تخدم عملاء عبر واجهة برمجية
تُصدر شركة الخليج الرقمية إصدارًا جديدًا من واجهتها البرمجية، وتستخدم الأداة لكتابة سجل تغييرات تقني موجَّه لعملائها من المطورين يوضّح كل تعديل في الواجهة.
تطبيق توصيل يُعلن تحسينات للمستخدمين
يُطلق تطبيق توصيل تحسينات على واجهته وسرعة الطلب، ويستخدم الأداة لصياغة إعلان مبسّط في متجر التطبيقات يوضّح للمستخدم ما تغيّر دون تفاصيل تقنية زائدة.
الأسئلة الشائعة
هل تفهم الأداة ملاحظات تقنية مختصرة جدًا؟
نعم، تكفي ملاحظات مختصرة كما تُكتب عادة في أدوات تتبع المهام الداخلية، وتُعيد الأداة صياغتها بجمل كاملة مفهومة للقارئ غير التقني.
هل يمكن فصل السجل الموجَّه للمستخدم عن سجل تقني للمطورين؟
نعم، يُطلب كل سجل بنبرة مختلفة ضمن طلب منفصل: نسخة مبسطة لمستخدم التطبيق، ونسخة تقنية أدق لعميل يتعامل مع واجهة برمجية مباشرة.
هل تُحفظ قائمة التعديلات المُدخلة؟
لا، تُستخدم القائمة لإنتاج نص السجل فقط ولا تُحفظ بعد تسليم النتيجة، ولا حاجة لحساب لاستخدام الأداة.
كم تكلفة سجل تغييرات لإصدار واحد؟
$0.003 لكل طلب زائد $0.0135 للإصدار الواحد، بصرف النظر عن عدد التعديلات المُدرجة ضمنه.
هل ترتب الأداة التعديلات حسب أهميتها؟
تُرتَّب حسب الفئة — ميزات، تحسينات، إصلاحات — لا حسب الأهمية المطلقة؛ ترتيب التعديلات داخل كل فئة حسب أولويتها يبقى قرار من يراجع السجل قبل نشره.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/text/changelog \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/changelog", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/changelog",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/changelog", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/changelog", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"input": "…"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.changelog",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الحدود
max_tokens | 20000 |
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
422 | task_failed | لم تنجح معالجة المهمة، ولن تُحتسب عليك؛ أعد المحاولة أو راسلنا مباشرة. |