إصلاح موقع Neotoma مع تعليقات إصدار المطورين

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

ما أخبرتني به التعليقات

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

لكن التعليقات الأكثر فائدة كانت حول المكان الذي علق فيه الأشخاص:

"لمن يستخدم هذا ولماذا أستخدمه؟"

سأل العديد من الأشخاص هذا مباشرة. الموقع القديم يقوده الهندسة المعمارية والتجريدية. أراد المختبرون ألمًا حادًا ومحددًا أولاً. وقارنه أحدهم ببيع فيتامين بدلاً من مسكن الألم. وسأل آخر بشكل مباشر: "هل أنا واحد من الأشخاص الذين هذا من أجلهم؟" يحتاج الموقع للإجابة على هذا السؤال في الثواني القليلة الأولى.

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

"هل يهدف هذا إلى استبدال ذاكرتي الحالية أو العيش بجانبها؟"

سأل أحد المختبرين الفنيين عما إذا كان ينبغي أن يكون Neotoma هو نظام الذاكرة الأساسي أم أنه يجب أن يجلس جنبًا إلى جنب مع أشياء مثل الذاكرة التلقائية لـ Claude Code. سأل آخر كيف يعمل الاستيعاب: هل هو التعبير العادي أم تقييم الذكاء الاصطناعي أم أن الوكيل يملأ معلمات الأداة؟ الموقع القديم لم يتناول أيًا من هذا. كانت الهندسة المعمارية والميكانيكا منتشرة عبر مستندات README وRepo.

تتناول صفحة نماذج الذاكرة الجديدة وإرشادات المطورين كلا السؤالين.

"كيف أقوم بإعداد هذا باستخدام أداتي؟"

كان أحد المختبرين يعمل مع Neotoma مع CLI ولكنه سأل "إذن فهو لا يعمل مع OpenClaw؟" لأن قائمة العملاء على الموقع لم تكن واضحة. حدث خطأ آخر بسبب عدم العثور على الوحدة أثناء محاولة بدء تشغيل واجهة برمجة التطبيقات. وأمضى ثالث ساعة في قراءة المستندات على جهاز افتراضي جديد ووضع علامة على رابط معطل في فهرس الوثائق بالإضافة إلى النوافذ المنبثقة غير المتوقعة لأذونات macOS. تم إخفاء تعليمات الإعداد وتنويعها حسب الأداة، وكان مقتطف التثبيت الخاص بالموقع يفتقر إلى رابط مباشر لما يحدث بعد الحرف الأول.

صفحة التثبيت الجديدة وأدلة التكامل لـ Cursor، Claude، Claude Code، ChatGPT، وCodex، وOpenClaw يعالجون هذا الأمر.

الإشارة الإيجابية تحت كل هذا: قام العديد من المختبرين بتشغيل Neotoma وتحققوا من أنه يخزن ويستعيد بشكل صحيح. أكد أحدهم أنه "يخزن الأشياء عندما أطلبها ويمكنني التحقق منها باستخدام CLI". يعمل جوهر. الموقع والتأهيل لم يفعلا ذلك.

الصفحة الرئيسية

تحتوي الصفحة الرئيسية الآن على تسعة أقسام مميزة بدلاً من تمريرة واحدة طويلة. الثلاثة الذين يستجيبون بشكل مباشر للتعليقات:

جدول ضمانات الذاكرة

إن جدول ضمانات الذاكرة هو الإجابة على السؤال "كيف يختلف هذا؟" مقارنة بين ذاكرة النظام الأساسي (Claude، ChatGPT)، وأنظمة الاسترجاع (Mem0، وZep، وLangChain Memory)، والأساليب القائمة على الملفات (Markdown، ومخازن JSON)، وNeotoma عبر 12 خاصية:

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

يرتبط كل صف بصفحة شرح مخصصة تحتوي على أمثلة قبل/بعد ورمز CLI. لاحظ أحد المختبرين أن "التخزين العام مع المخططات لم يتم حله" وأن المخططات الشائعة يمكن أن تكون الحل. جدول الضمانات هو إجابتي: هنا الخصائص المحددة، وهنا حيث يقدم كل نهج، وهنا حيث لا يفعل.

###قبل وبعد

تدور الرسوم المتحركة المقدمة حول نفس السؤال من خلال نتيجتين. بدون نيوتوما: "لم يتم العثور على عقد لكلاين." مع Neotoma: "Net-30، تم التوقيع عليه في 12 أكتوبر، ويتم تجديده تلقائيًا في الربع الأول." يدور أحد عشر سيناريو، كل منها يظهر حالة فشل حقيقية في لمحة.

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

كان هذا هو الرد المباشر على تعليقات "الفيتامين مقابل مسكن الألم". الموقع القديم يقوده الهندسة المعمارية. يتناول هذا القسم ما ينفصل عن الحالة الحتمية وما يكلفك ذلك.

لمن هو؟

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

التوثيق

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

إرشادات المطور

الإرشادات التفصيلية للمطورين عبارة عن سيناريو متعدد الجلسات يمر عبر الحلقة الأساسية: قم بتخزين قرار معماري في الجلسة 1، واسترجاعه والتصرف بناءً عليه في الجلسة 2، والتعامل مع التحديث المتعارض في الجلسة 3، ثم قم بمراجعة مسار المراقبة الكامل. كل ذلك باستخدام مكالمات تخزين MCP (بروتوكول سياق النموذج) مع أمثلة طلب/استجابة حقيقية. يعالج هذا سؤال العرض مباشرةً: يستدعي الوكيل أداة MCP باستخدام المعلمات المنظمة، ويقوم Neotoma بتخزين الملاحظة. لا توجد مكالمات مخفية لنماذج الذكاء الاصطناعي، ولا يوجد استخراج regex.

نماذج الذاكرة

تقارن صفحة نماذج الذاكرة بين أربعة أساليب: ذاكرة النظام الأساسي، وذاكرة الاسترجاع، والذاكرة المستندة إلى الملف، والذاكرة الحتمية). الذاكرة. هذا هو المكان الذي يجب أن يحل فيه Neotoma محل ذاكرتي الحالية أو يكملها؟ يتم الرد على السؤال. يحتوي كل نموذج على صفحة فرعية مخصصة تشرح ماهيته وأين يعمل وأين ينكسر.

أسس

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

###الهندسة المعمارية

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

الصفحات المرجعية

جدول نقطة النهاية REST API الكامل وكتالوج إجراءات MCP ومرجع سطر الأوامر. تتضمن صفحة واجهة برمجة التطبيقات (API) أوصافًا ومعلمات لكل نقطة نهاية. تسرد صفحة MCP جميع الإجراءات الـ 24. تغطي صفحة CLI جميع الأوامر الـ 38.

أدلة التكامل

ست صفحات خاصة بالأدوات، كل منها تتنقل خلال عملية الإعداد من التثبيت إلى المتجر الأول:

هذه هي الإجابة المباشرة على "هل يعمل مع X؟" و"كيف أقوم بإعداد هذا باستخدام أداتي؟" يغطي كل دليل التكوين ومثال التشغيل لأول مرة وما يمكن توقعه. تعد صفحة ChatGPT هي الأكثر تفصيلاً لأن إعداد GPT المخصص يتضمن معظم الخطوات. توجد صفحة OpenClaw لأن أحد المختبرين سأل على وجه التحديد عما إذا كانت مدعومة وكان الموقع القديم غامضًا.

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

ثلاث صفحات مخصصة للجمهور تسلط الضوء الآن وتشرح هدف Neotoma، مما يوفر إرشادات الاستهداف التي كانت الصفحة الرئيسية القديمة تفتقر إليها:

مهندسو البنية التحتية للذكاء الاصطناعي. نقاط الضعف، مثل تشغيل العامل غير القابل للتكرار، وتغييرات الحالة غير المرئية، وعدم وجود أثر للمصدر. أوضاع الفشل الشائعة مع أيقونات محددة. أنواع البيانات التي تعمل معها هذه الفرق (حالة الجلسة، وخطوط الأنابيب، والتقييمات، ومسارات التدقيق) وأنواع الكيانات التي تظهر في أغلب الأحيان (agent_session، وaction، وflow، والتقييم).

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

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

التثبيت بقيادة الوكيل

هذا جديد منذ إعلان إصدار المطور. بدلاً من قراءة المستندات والتكوين يدويًا، يمكنك نسخ مطالبة واحدة من صفحة التثبيت، ولصقها في أداة الذكاء الاصطناعي الخاصة بك، وسيتولى الوكيل الباقي: تثبيت الحزمة، وتشغيل init، وتكوين اتصال MCP، وتخزين بياناتك الأولى.

تم تصميم المطالبة لـ Claude Code وCodex وCursor وOpenClaw. يخبر الوكيل بتثبيت Neotoma باستخدام npm install -g neotoma، وتهيئته، ثم ربط دليل التكامل المطابق لتلك الأداة. يقوم الوكيل بمسح سياقك المحلي وذاكرة النظام الأساسي لديك، ويعاين ما وجده، ويخزن فقط ما توافق عليه.

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

دعم اللغة

يتم الآن ترجمة الموقع وكل محتوى المنشورات تلقائيًا إلى 12 لغة: العربية، والبنغالية، والكتالونية، والفرنسية، والألمانية، والهندية، والإندونيسية، والصينية الماندرين، والبرتغالية، والروسية، والإسبانية، والأردية. تتضمن كل صفحة محوّل لغة، وتخطيطات RTL تعمل للغتين العربية والأردية.

وهذا مهم لأن إصدار المطور قد وصل إلى المختبرين خارج الأسواق الناطقة باللغة الإنجليزية. بدلاً من بوابة الوثائق وراء لغة واحدة، كل صفحة - الصفحة الرئيسية، وضمانات الذاكرة، وأدلة التكامل، وصفحات حالة الاستخدام، والمنشورات - متاحة في جميع اللغات الـ 12. يتم إنشاء الترجمات تلقائيًا وقد لا تكون مثالية، ولكنها تقلل من الحاجز أمام أي شخص يقوم بتقييم Neotoma بلغته الأساسية.

ما هي الخطوة التالية

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

التأهيل المستند إلى الوكيل. يساعدك تدفق التثبيت الحالي على الإعداد، ولكنه سلبي. تقوم بالتثبيت، ثم تبدأ، وتبدأ في التخزين. سيكون الإصدار التالي عبارة عن تجربة اكتشاف موجهة حيث يقوم وكيلك بفحص ملفاتك المحلية، ويقترح المرشحين ذوي القيمة الأعلى، ويعيد بناء جدول زمني من بياناتك الخاصة خلال الدقائق القليلة الأولى. الهدف هو لحظة ملموسة حيث ترى ملفات مشروعك المتناثرة تتحول إلى جدول زمني منظم مع تتبع كل حدث إلى مصدر محدد. هذه هي اللحظة التي يصبح فيها الفرق بين Neotoma وذاكرة الدردشة واضحًا.
تصدير سجل Markdown. يتوقع العديد من المطورين، وخاصة أولئك القادمين من Claude Code، أن يتم تمثيل الذاكرة كملفات تخفيض السعر التي يمكنهم تصفحها وتحريرها مباشرة. يستخدم Neotoma SQLite كمخزن أساسي له، مما يمنحك استعلامات حتمية وقيود المخطط ولكنه يعني أنه لا يمكنك فتح ملف في المحرر الخاص بك. أقوم بإضافة أمر لتصدير سجلاتك كملفات تخفيض السعر على القرص، منظمة حسب نوع الكيان، مع بيانات التعريف الأمامية والمصدر. يظل SQLite أساسيًا. تعد ملفات تخفيض السعر بمثابة مرآة سهلة القراءة للشفافية وقابلية الفحص.
وصول أكثر سلاسة عن بعد لـ ChatGPT وClaude. توجد أدلة التكامل الآن، ولكن مسارات الإعداد عن بعد لـ ChatGPT (GPT المخصصة مع نقطة نهاية API) وClaude (سطح المكتب مع MCP البعيد) تحتاج إلى المزيد من التدريب العملي وتصحيح الأخطاء قبل أن تصبح سلسة مثل المسارات المحلية لـ Cursor وClaude Code. أرغب في العمل بشكل موثوق من البداية إلى النهاية وتحديث الأدلة بتعليمات أكثر وضوحًا واستكشاف الأخطاء وإصلاحها.

ما أريد تعليقات عليه

إصدار المطور لا يزال نشطًا. إذا حاولت تثبيت Neotoma والعمل من خلال الموقع، أريد أن أعرف:

هل الموقف واضح؟ عندما تصل إلى الصفحة الرئيسية، هل تفهم ما يفعله Neotoma وكيف يختلف عما تستخدمه بالفعل؟
هل يساعدك جدول ضمانات الذاكرة في تحديد ما إذا كان Neotoma ذا صلة بسير عملك؟
هل مسار التثبيت والتأهيل واضح؟ هل يمكنك الانتقال من الموقع إلى بيئة العمل دون الاصطدام بالحائط؟
هل أدلة التكامل دقيقة لأداتك؟

تفضل بزيارة neotoma.io، واطلب من وكيلك تثبيت مع تعليمات النسخ واللصق، وشارك تعليقاتك. افتح مشكلة على GitHub أو تواصل معنا مباشرةً.

الوجبات السريعة الرئيسية