التصميم بمساعدة الحاسوب بوكيل ذكاء اصطناعي (CAD) مع text-to-cad: المستودع earthtojake/text-to-cad إضافة تمنح وكيل برمجة مسارات عمل محلية لإنتاج نماذج ثلاثية الأبعاد (STEP وGLB وSTL أو 3MF)، وفحص قابليتها للتصنيع، وتوليد مخططات مؤشرة الأبعاد، وتجهيز الإرسال إلى خدمات الطباعة ثلاثية الأبعاد وتشكيل الصفائح والتشغيل الآلي. كان يعرض نحو 22400 نجمة و2200 فرع في منتصف أكتوبر 2026، بترخيص MIT.
يطرح الأمر سؤالين على المهندسين: ماذا نتلقى فعلًا (ملف CAD قابل للاستخدام أم عرضًا توضيحيًا؟) وماذا تفعل هذه الإضافة على الجهاز، بما في ذلك على جانب الشبكة؟ يتبع هذا المقال README: التثبيت والمهارات المرفقة والقياس عن بُعد (telemetry) والحدود. ويقترح أيضًا بعض الأفكار لمراقبة استخدام أداة كهذه داخل فريق.
المعلومات مأخوذة من README وهيكل ملفات المستودع. لم تثبّت span.observer أداة text-to-cad: الصورة الأولى هي صورة التقديم المنشورة في المستودع، والأخريان مقتطفان حقيقيان من README صُيّرا للقراءة.
التصميم بمساعدة الحاسوب بوكيل ذكاء اصطناعي مع text-to-cad: ما الذي يقوله المستودع
- الناشر والترخيص: مستودع مستخدم GitHub المسمى
earthtojake؛ والملف LICENSE بترخيص MIT وحقوق نشر 2026 لـ «Thompson Labs LLC». - الإصدار: يشير ملف
VERSIONفي المستودع إلى 0.7.26، ويحيل README إلى حزمة Python المسماةcadgenعلى PyPI. ولم تعرض صفحة GitHub أي إصدار (release) وقت المراجعة. - التقنية (شارات README): Python 3.11 أو أحدث، وNode.js 20 أو أحدث، وbuild123d 0.11 وOpen CASCADE 7.9. وتعمل نواة CAD محليًا عبر uv.
- الأدوات المدعومة: يذكر README كلًا من Claude Code وClaude Desktop وCodex وCursor وGrok Build وGemini، وأي وكيل متوافق مع صيغة المهارات (
npx skills add).

تُظهر الصورة، المنشورة في المستودع (apps/docs/public/social-preview.png)، عارض CAD الخاص بالمشروع مع تجميعة ترس كوكبي. ويشرح README أنه في الأدوات القادرة على عرض واجهات التطبيقات تظهر النماذج كبطاقات قابلة للتدوير داخل المحادثة؛ وإلا فيعيد الوكيل رابطًا يفتح النموذج في «CAD Viewer» بالمتصفح.
تثبيت text-to-cad بحسب README
المتطلبات المسبقة
تمر CAD عبر uv: تحقق من uv --version، وثبّته إن لم يكن موجودًا، ثم أعد تشغيل تطبيق الوكيل. وبحسب README، ينزّل التشغيل الأول وقت تشغيل CAD ولذلك يتطلب اتصالًا بالشبكة.
الخطوة 1: Claude Code
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake
تشغّل الإضافة أيضًا خادم CAD (cadgen mcp). يحتوي الفرع latest على الإضافة وحدها، وتُنشر بعد نشر الإصدار على PyPI؛ أما main فقد يحتوي تغييرات غير منشورة.
الخطوة 2: الأدوات الأخرى
بالنسبة إلى Codex وCursor وGrok Build أو Gemini، يعطي README أمرًا لكل أداة (مثلًا gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update). ولوكيل بلا إضافات، ثبّت المهارات فقط:
npx skills add earthtojake/text-to-cad#latest
يشدد README: ثبّت الإضافة أو المهارات في تطبيق ما، لا كليهما، وإلا ظهرت كل مهارة مرتين.
الخطوة 3: عطّل القياس عن بُعد قبل البدء
uvx cadgen telemetry off

المهارات المرفقة
يسرد جدول «Skills» في README اثنتي عشرة مهارة. بإيجاز: cad (النماذج، وSTEP مخرجًا رئيسيًا مع تصدير STL و3MF وGLB)، وstep-parts (القطع التجارية)، وengineering-drawing (مخططات مؤشرة الأبعاد بصيغة PDF)، وdxf (رسومات ثنائية الأبعاد)، وurdf وsrdf وsdf (الروبوتات والمحاكاة)، وفحوص قبل الإرسال إلى SendCutSend، وdfam-check وdfm (قابلية التصنيع)، وgcode (التقطيع الطبقي بـ OrcaSlicer) وbambu-labs (الإرسال إلى طابعات Bambu Lab).

وللمقارنة بمقاربة مفتوحة المصدر أخرى لـ CAD، راجع CADCraft، CAD مفتوح المصدر بلغة Rust. لا يشترك المشروعان في الطموح نفسه: text-to-cad مجموعة مهارات يقودها وكيل، وليس تطبيق سطح مكتب.
مراقبة وكيل ينفّذ أعمال CAD
لا تنشر إضافة CAD المحلية تتبعات OpenTelemetry: ولا يوثّق README أيًّا منها. أما ما يوثّقه المستودع فهو القياس عن بُعد الخاص بالمنتج وعدة متغيرات تحكم. وفي ما عدا ذلك، تتم المراقبة على مستوى الوكيل: راجع مراقبة وكلاء MCP، لأن الخادم cadgen mcp خادم MCP محلي.
ما الذي يرسله القياس عن بُعد، بحسب README
- افتراضيًا: إحصاءات استخدام وتقارير أعطال، موسومة بمعرّف تثبيت عشوائي (الإصدارات والنظام وتطبيق الوكيل وعدد استدعاءات الأدوات والمدد وصيغ الملفات المعروضة). ويؤكد README أنها لا تشمل أبدًا أسماء ملفات أو مسارات أو محتويات أو موجّهات.
- تُخزَّن لدى PostHog، مع البلد المستنتج من عنوان IP، الذي لا يحتفظ به الخادم.
- التعطيل:
uvx cadgen telemetry off(الذي يحذف أيضًا ما أُرسل، بحسب README)، أو القائمة «Share usage stats» في العارض، أو المتغيرينDO_NOT_TRACK=1وCADGEN_TELEMETRY=0لعملية واحدة. ولا يُرسل شيء افتراضيًا في التكامل المستمر. - يستدعي فحص التحديث
api.texttocad.dev/v1/versionsمرة واحدة في اليوم على الأكثر؛ ويعطّلهCADGEN_UPDATE_CHECK=0.
بالنسبة إلى مؤسسة، تُراجَع هذه النقاط مع ضوابط الحماية نفسها المطبقة على الوكلاء الآخرين: قائمة سماح للشبكة، وتعطيل القياس عن بُعد افتراضيًا، وإصدارات مثبَّتة.
كيف تتحقق من أن كل شيء يعمل
- يذكر README الأمر
cadgen doctor، الذي يشخّص خصوصًا حجب المكتبة الأصلية على Windows 11. - اطلب من الوكيل نموذجًا بسيطًا (لوحة بأربعة ثقوب) وافتحه في CAD Viewer: يجب أن تطابق الأبعاد طلبك، مقيسةً في برنامج CAD آخر.
- تحقق من جدار الحماية أو الوكيل (proxy) لديك: ما النطاقات التي تتصل بها الإضافة بعد
telemetry off.
الحدود والنقاط المفتوحة
- Windows 11 وSmart App Control. يشرح README أن الوحدة الأصلية لـ OpenCascade (OCP) غير موقَّعة: إن كان Smart App Control مفعّلًا فإن كل أمر
cadgenيفشل بالرسالة «DLL load failed while importing OCP». حلول README: تعطيله (لا رجعة فيه دون إعادة تثبيت Windows) أو استخدام WSL. - القطعة المولَّدة ليست قطعة معتمدة. تقيس مهارتا DfM وDfAM معايير على شبكة مثلثات (mesh)؛ وهما لا تعادلان مراجعة هندسية ولا حساب مقاومة. اطلب مراجعة القطع المخصصة للتصنيع أو لحمل حمولة.
- إجراءات على عتاد حقيقي. ترسل بعض المهارات ملفات إلى خدمات تصنيع أو إلى طابعة. أبقِ موافقة بشرية قبل أي إرسال أو بدء طباعة.
- الاعتماد على الإصدار. يثبّت إعداد Claude Desktop إصدارًا من
cadgen؛ والتحديثات يدوية في هذه الحال. - مشروع فتي. إصدار 0.x واهتمام كبير: قد تتغير الواجهات.
أفضل الممارسات
- عطّل القياس عن بُعد منذ التثبيت إن اقتضت سياستك ذلك، وأعد قراءة قسم «Telemetry» في README.
- ثبّت الفرع
latestلاmain، وثبّت الإصدار. - اعمل في مجلد مشروع مخصص؛ وحدّ من صلاحيات الوكيل كما في دليل خادم MCP الخاص بـ GitHub.
- اشترط مراجعة بشرية للأبعاد والتفاوتات قبل التصنيع.
الأسئلة الشائعة
هل يعمل text-to-cad دون اتصال؟
بحسب README، دون اتصال لا يُرسل شيء ويعمل كل شيء، لكن التشغيل الأول ينزّل وقت تشغيل CAD ويتطلب اتصالًا.
ما صيغ الملفات التي ينتجها؟
STEP مخرجًا رئيسيًا، مع تصدير STL و3MF وGLB، إضافة إلى رسومات DXF ومخططات PDF بحسب المهارات.
هل هو مجاني؟
الشيفرة بترخيص MIT ويقدّم المشروع نفسه على أنه مجاني. أما استدعاءات نموذج وكيلك فيحاسبك عليها مزوّدك.
الخلاصة
يمدّ text-to-cad مبدأ مهارات الوكلاء إلى CAD والتصنيع. الفكرة متينة نظريًا، لكن المشروع فتي (الإصدار 0.7.x) ويمسّ أجسامًا مادية: مراجعة بشرية وقياس عن بُعد مضبوط وإصدارات مثبَّتة هي العادات الثلاث التي ينبغي الاحتفاظ بها.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في الوثائق الرسمية (texttocad.dev).