التاريخ والوقت

يتخذ Mayros الإعداد الافتراضي الوقت المحلي للمضيف لطوابع زمنية النقل و منطقة زمنية المستخدم فقط في المطالبة النظامية. يتم الحفاظ على طوابع زمنية الموفر بحيث تحتفظ الأدوات بدلالاتها الأصلية (الوقت الحالي متاح عبر session_status).

مغلفات الرسائل (محلية افتراضيًا)

يتم تغليف الرسائل الواردة بطابع زمني (دقة الدقيقة):

[Provider ... 2026-01-05 16:26 PST] message text

هذا الطابع الزمني للمغلف محلي للمضيف افتراضيًا، بغض النظر عن منطقة زمنية الموفر.

يمكنك تجاوز هذا السلوك:

json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" يستخدم UTC.
  • envelopeTimezone: "local" يستخدم منطقة زمنية المضيف.
  • envelopeTimezone: "user" يستخدم agents.defaults.userTimezone (يعود إلى منطقة زمنية المضيف).
  • استخدم منطقة زمنية IANA صريحة (مثل، "America/Chicago") لمنطقة ثابتة.
  • envelopeTimestamp: "off" يزيل الطوابع الزمنية المطلقة من رؤوس المغلفات.
  • envelopeElapsed: "off" يزيل لواحق الوقت المنقضي (نمط +2m).

أمثلة

المحلي (افتراضي):

[WhatsApp +1555 2026-01-18 00:19 PST] hello

منطقة زمنية المستخدم:

[WhatsApp +1555 2026-01-18 00:19 CST] hello

الوقت المنقضي ممكّن:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

المطالبة النظامية: التاريخ والوقت الحالي

إذا كانت منطقة زمنية المستخدم معروفة، فإن المطالبة النظامية تتضمن قسمًا مخصصًا التاريخ والوقت الحالي مع المنطقة الزمنية فقط (بدون تنسيق الساعة/الوقت) للحفاظ على ثبات التخزين المؤقت للمطالبات:

Time zone: America/Chicago

عندما يحتاج الوكيل إلى الوقت الحالي، استخدم أداة session_status؛ بطاقة الحالة تتضمن سطر طابع زمني.

سطور أحداث النظام (محلية افتراضيًا)

أحداث النظام المُدرجة في قائمة الانتظار والمُدرجة في سياق الوكيل مسبوقة بطابع زمني باستخدام نفس اختيار المنطقة الزمنية كمغلفات الرسائل (افتراضي: محلي للمضيف).

System: [2026-01-12 12:19:17 PST] Model switched.

تكوين منطقة زمنية المستخدم + التنسيق

json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone يعين المنطقة الزمنية المحلية للمستخدم لسياق المطالبة.
  • timeFormat يتحكم في عرض 12 ساعة/24 ساعة في المطالبة. auto يتبع تفضيلات نظام التشغيل.

اكتشاف تنسيق الوقت (تلقائي)

عند timeFormat: "auto"، يفحص Mayros تفضيل نظام التشغيل (macOS/Windows) ويعود إلى تنسيق اللغة. القيمة المكتشفة محفوظة لكل عملية لتجنب استدعاءات النظام المتكررة.

حمولات الأدوات + الموصلات (وقت الموفر الخام + الحقول المعيارية)

تقوم أدوات القنوات بإرجاع طوابع زمنية أصلية للموفر وإضافة حقول معيارية للاتساق:

  • timestampMs: ميلي ثانية العصر (UTC)
  • timestampUtc: سلسلة UTC ISO 8601

يتم الحفاظ على حقول الموفر الخام حتى لا يضيع شيء.

  • Slack: سلاسل شبيهة بالعصر من API
  • Discord: طوابع زمنية ISO UTC
  • Telegram/WhatsApp: طوابع زمنية رقمية/ISO خاصة بالموفر

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

الوثائق ذات الصلة