واجهة مستخدم سطح المكتب

بنية التطبيق

يجمع تطبيق سطح المكتب بين عرض ويب SolidJS وVite وThree.js وTauri v2 Rust shell. يمتلك عرض الويب الشاشات وحالة التفاعل. يمتلك Bun Sidecar معالجات واجهة برمجة التطبيقات (API)، والوصول إلى قاعدة البيانات، وجلسات الذكاء الاصطناعي، وخدمات المشروع. تمتلك عملية Rust النافذة والقوائم والدرج ومربعات حوار نظام التشغيل والوصول إلى سلسلة المفاتيح والتحديثات ودورة حياة السايدكار.

apps/desktop/src/main.tsx يتصاعد التطبيق. app/App.tsx ينشئ اتصال API ويوفر الحالة المشتركة؛ app/routes.tsx يعين عناوين URL لوحدات الصفحة البطيئة. شاشات مميزة تعيش في features/. لا يشير وجود المسار إلى توفر خدماته الخارجية: تحتاج الفوترة إلى تكوين Stripe ويحتاج الذكاء الاصطناعي إلى موفر مهيأ.

بدء التشغيل واستعادة الاتصال

1. يبدأ Shell السايدكار المجمعة باستخدام رمز الإطلاق المميز وبيانات التطبيق وأدلة الترحيل.
2. يربط السايدكار منفذًا سريع الزوال 127.0.0.1، ينتظر إجابة المسار الصحي الخاص به، ويكتب JSON ready الحدث الذي يحتوي على المنفذ.
3. يستدعي عرض الويب get_sidecar_endpoint ويقوم بإنشاء عميل واجهة برمجة التطبيقات (API) ووقت تشغيل التأثير المُدار.
4. يؤدي طلب السلامة الناجح إلى إنشاء حالة التطبيق وتثبيت جهاز التوجيه والقشرة.

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

طرق الشاشة

يستخدم app/routes.tsx لأسماء المعلمات الدقيقة و pages/ لتحديد موقع الشاشة المثبتة على عنوان URL. محولات التوجيه صغيرة عن قصد؛ قراءة الشاشة واستدعاءات API الخاصة بها عند تشخيص عرض فارغ أو إجراء فاشل.

منظمة المصدر

• app/: بدء التشغيل، جهاز التوجيه، عميل API العالمي، التكامل الأصلي، الصدفة، واختصارات لوحة المفاتيح.
• pages/: محولات الطريق استيراد أو إعادة تصدير الشاشات.
• features/: مناطق المنتج التي تحتوي على الشاشات والمكونات والخطافات والحالة والمساعدين الخاصين بالمجال.
• shared/: عناصر التحكم القابلة لإعادة الاستخدام، ومكونات الصدفة، وحالة التطبيق، والتخزين المؤقت للاستعلام، وسجل الأوامر.
• viewport/: رسم القماش، والالتقاط، وإيماءات الأداة، وعرض Three.js، والربط، والتشغيل.
• i18n/, styles/، و testing/: الترجمات، والأنماط العالمية، وتركيبات الاختبار.

سطح المكتب يعتمد على @cadcamfun/api لعقد HTTP وعلى @cadcamfun/core لعمليات الهندسة وCAM. يظل استمرار قاعدة البيانات خلف واجهة برمجة تطبيقات السايدكار. يختلف سجل المحرر المحلي عن إصدارات الرسم المستمر أو مسار الأدوات وعن التحكم في إصدار المشروع.

قذيفة أصلية

نافذة الإنتاج هي 1440 × 900 بشكل افتراضي، بحد أدنى 960 × 600. يقوم Tauri بمراحل الواجهة الأمامية من apps/desktop/dist، سايدكار خاصة بالهدف من src-tauri/binaries، وولدت الهجرات كموارد. فإنه يسجل .cadcam, .nc، و .gcode جمعيات الملفات. يؤدي فتح ملف مدعوم أو تشغيل مثيل ثانٍ إلى إعادة توجيه مسارات الملفات إلى النافذة الحالية.

src-tauri/src/sidecar.rs يشرف على عملية الطفل. إغلاق التطبيق يكتب أ {"event":"shutdown"} خط إلى stdin الطفل وينتظر لفترة وجيزة قبل جني ذلك؛ يلاحظ الطفل أيضًا إغلاق stdin. رمز الإطلاق المميز هو 32 بايت عشوائي، مشفر سداسي عشري كأحرف 64، ويتم تنقيح سطور سجل السايدكار التي قد تحتوي على بيانات اعتماد. السجلات منفصلة عن stdout، الذي يحمل تأكيد الاتصال للجاهزية/الخطأ. يتم الوصول إلى الأسرار الأصلية من خلال src-tauri/src/secrets.rs باستخدام سلسلة مفاتيح نظام التشغيل.

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

حدود الأمن والثبات

تسمح سياسة محتوى الإنتاج بالأصول المحلية واتصالات API الاسترجاعية وصور البيانات/الكائنات الثنائية الكبيرة وتقييم WebAssembly. لا يمنح تنفيذ البرنامج النصي عن بعد التعسفي. يتم تحديد نطاق الأذونات الأصلية في src-tauri/capabilities; تسمح سياسة التطوير أيضًا بـ Vite ومقبس الويب الخاص به.

open_path تحديد المسارات بشكل متعارف عليه، وتقييدها بأدلة المستخدم/التطبيق المسموح بها، ورفض الامتدادات القابلة للتنفيذ مثل .exe, .app, .sh, .bat, .msi، و .jar. .. لا يمكن للمقاطع والارتباطات الرمزية الهروب من المجلدات المسموح بها لأن كلا الجانبين متعارف عليهما. انتقاء الملفات وحفظها يستخدم مربعات الحوار الأصلية والتحقق من صحتها. يمنح رمز الإطلاق إمكانية الوصول إلى واجهة برمجة تطبيقات التطبيق المحلي؛ تعامل معه بشكل منفصل عن الرمز المميز المصاحب أو رمز جسر الذكاء الاصطناعي على نطاق المشروع.

إعدادات واجهة المستخدم وحالة استعلام واجهة برمجة التطبيقات وأوامر المحرر وإصدارات المشروع المخزنة والأسرار الأصلية لها مالكون مختلفون. قم بتشخيص كل منها من خلال خدمتها الفعلية بدلاً من افتراض أن حالة التطبيق بأكملها مخزنة في SQLite.

تكامل الميزة

تقوم وحدات ميزات CAD وCAM بتكوين مكونات إطار عرض قابلة لإعادة الاستخدام مع لوحاتها الخاصة ومخازنها وتدفقات الحفظ. تتلقى اللوحة المساعدة سياق المشروع والمحرر وأحداث أداة التدفق من خلال حالة ميزة الذكاء الاصطناعي. تستخدم شاشات الموارد عميل API بدلاً من الوصول مباشرة إلى قاعدة البيانات.

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

تحميل الطريق والأخطاء

يستخدم كل مسار حدود الاستيراد البطيئة الخاصة بـ Solid. يتضمن الجدول صفحة شاملة، /500, /offline، والطرق القانونية. يجب تقديم التنقل المباشر للمتصفح من خلال خادم تطوير Vite أو عرض الويب المعبأ حتى يتمكن جهاز توجيه العميل من حل عنوان URL.

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

واجهة الأوامر الأصلية

الأحداث الأصلية

تنبعث القشرة sidecar-status لتغييرات دورة الحياة، open-file مع المسارات المدعومة، menu لاختيار القائمة، و update://status لتقدم المحدث. يتم تمثيل تحديدات المشروع الأخير في الدرج بواسطة tray.recent.<projectId> معرفات القائمة. تحدد وحدات القائمة والدرج الخاصة بالصدفة مجموعات المعرفات الكاملة الخاصة بها.

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

التطوير والتحقق

bun run --filter @cadcamfun/desktop dev
bun run desktop:dev
bun run --filter @cadcamfun/desktop typecheck
bun test apps/desktop/src
bun run build:desktop

يقوم الأمر الأول بتشغيل معاينة المتصفح. desktop:dev يقوم بتجميع السايدكار الحقيقية ومراحل الهجرات قبل بدء Tauri. حزمة سطح المكتب tauri:dev يقوم البرنامج النصي بدلاً من ذلك بإنشاء كعب روتين ثنائي فقط في حالة عدم وجود ثنائي؛ استخدمه في عمل الصدفة المعزول وتحقق من الثنائي الموجود قبل تفسير استجابات واجهة برمجة التطبيقات (API) الخاصة به.

سطح المكتب build يعمل البرنامج النصي vite build فقط؛ فهو لا يجمع السايدكار أو يحزم حزمة Tauri. يستخدم bun scripts/build.ts للحصول على خط أنابيب الإصدار الكامل (انظر يطلق).

التفضيلات والإعدادات

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

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

حفظ وإعادة فتح برنامج CAM

1. قم بإنشاء أو تحميل رمز NC في CAM وافتح مربع حوار الحفظ/التصدير من نقطة الإدخال الحالية.
2. لتصدير ملف، اختر G-code أو تنسيق مسار الأدوات المحمول. يقوم G-code بتنزيل نص NC الحالي؛ يقوم اختيار مسار الأدوات بكتابة ملف منظم .cam.json لقطة.
3. لاستمرارية التطبيق، اختر مشروعًا موجودًا أو مشروعًا جديدًا أو قم بتحديث البرنامج المحفوظ بالفعل. قم بتوفير اسم البرنامج وحقول الوجهة المطلوبة.
4. عند التحديث، يسجل تدفق الحفظ البرنامج الكامل السابق كإصدار مسار الأدوات قبل استبدال البيانات الحالية.
5. افتح العنصر المحفوظ في مسار تفاصيل مسار الأدوات الخاص به لفحص الإصدارات أو استعادتها.

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

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

لوحة المفاتيح وتشخيص الأعطال

Cmd/Ctrl+K يفتح لوحة الأوامر و Cmd/Ctrl+J تبديل لوحة المساعد. يتم تجاهل اختصارات Shell عندما يكون التركيز على عنصر إدخال أو منطقة نص أو تحديد أو عنصر قابل للتحرير. تتمتع لوحات المحرر بمعالجة لوحة المفاتيح الخاصة بها. العديد من عمليات الاسترجاعات لأوامر shell، بما في ذلك الحفظ/التصدير في جدول الاختصارات العام، هي عناصر نائبة؛ استخدم عناصر التحكم في الحفظ/التصدير الفعلية للميزة بدلاً من افتراض أن كل مُسرّع مدرج يقوم بإجراء عملية مستند.

مراسي التنفيذ: shared/state/settings.ts, app/shortcuts.ts, features/settings/screens/settings.tsx، و features/cam/components/SaveCamModal.tsx.

حمولات الأحداث الأصلية

import { invoke } from "@tauri-apps/api/core"
import { listen } from "@tauri-apps/api/event"

const { baseUrl, token } = await invoke<{ baseUrl: string; token: string }>("get_sidecar_endpoint")

const path = await invoke<string | null>("pick_file", {
  filters: [{ name: "G-code", extensions: ["nc", "gcode"] }],
})                                    // null when the user cancels

await invoke("save_file", { defaultName: "part.nc", contents: gcodeText })

const unlisten = await listen<{ state: string; port?: number }>("sidecar-status", (e) => {
  if (e.payload.state === "ready") reconnect()
})
// later: unlisten()

try {
  await invoke("install_update", { unsavedWork: editorIsDirty })
} catch (error) {
  // { kind, message }: the update variant carries the refusal (unsavedWork | noneAvailable | failed)
}

get_sidecar_endpoint يعود { baseUrl, token } (متسلسل في حالة الجمل من SidecarEndpoint). تصل الأخطاء من كل أمر كقيمة مرفوضة لـ invoke، على شكل { kind, message }.

اختصارات لوحة المفاتيح

كل طريق الشاشة

جهاز التوجيه في apps/desktop/src/app/routes.tsx يعلن عن 68 مسارات، تم تحميل كل منها بتكاسل منها apps/desktop/src/pages/ (القطاعات الديناميكية هي _id_.tsx الملفات). مجمعة حسب الجزء الأول:

في 3د