نظرة عامة

يوثّق هذا المستند غرض منصة Lolly وبنيتها وقرارات هندستها المعمارية. وهو يعكس رؤية المنتج وحالة قاعدة الشيفرة الحالية في آن واحد.

الحالة: Lolly صدرت. صدر الإصدار 1.0 كمصدر مفتوح بترخيص MPL-2.0 في 30 أغسطس 2026، وما زالت الميزات والإعدادات الافتراضية وكتالوج الأدوات تتغير بين الإصدارات. المحرك حتمي، بمسار تصيير واحد خلف كل غلاف. لم يخضع أمنه بعد لتدقيق مستقل، وأدلة التبني عمرها بضعة أشهر. راجع التبني والحوكمة لمعرفة الحالة الراهنة وكيف يُقاس التبني.

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

هناك مرجعان يتعمقان أكثر من هذه الصفحة. engine/README.md في المستودع هو خريطة المحرك وحدة بوحدة، مع جدول مُولَّد لكل وحدة و ما تحلّله أو تكتبه. نموذج التهديد وحدود الثقة هو البنية المعمارية نفسها مقروءة كحدود ثقة، وهو الصفحة المناسبة لأي سؤال عن ما يعتبره المحرك غير موثوق.

سبب وجود هذا

العمل الإبداعي القابل للتكرار متوقّع إلى درجة لا تبرر الاستعانة بأيدٍ ماهرة في كل مرة، وحسّاس للجودة إلى درجة لا تسمح بتفويضه دون ضوابط. إن تُرك وحده، يسلك أحد ثلاثة مسارات: البطء، أو عدم الاتساق، أو الارتهان لقوالب مورّد.

هذه المنصة هي الإجابة المباشرة:

إبداع ومحتوى برمجي على نطاق واسع - أصول تُنشأ من مدخلات، بقواعد تُضبط مرة واحدة، لمن يحتاج إليها.

ليست Lolly المكان الذي يُبتكر فيه نظام تصميم - بل المكان الذي يُنتَج فيه. تخيلها كآلة بيع تصاميم: تختار، فتحصل على نتيجة. في كل مرة. يعمل المحرك على تحقيق أعلى جودة يمكن أن تنتجها كل صيغة على الجهاز أمامك، والمحرك نفسه يصنع الملف نفسه على كل سطح يُشحن إليه.

والنتيجة هي الوفرة: كل فعالية لها لافتاتها الصحيحة، وكل تنبيه CVE يطابق أسلوب الشركة، وكل ملصق يُطبع نظيفًا، وكل توقيع بريد إلكتروني محدَّث - كل ذلك من أدوات تحمل القواعد بالفعل. تتولى المنصة العمل الإبداعي المتكرر المُشغَّل تشغيليًا. وهي بقصد ليست أداة تصميم مخصص - إذ يظل المصممون مالكي الأعمال الرائدة.

ابتكر احتماليًا، وانشر حتميًا

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

ترسم Lolly الخط نفسه. استكشف احتماليًا: نموذج، أو مصمم، أو فكرة أولية، أو موجّه (prompt) يذهب إلى مكان لم يخطط له أحد. ثم انشر حتميًا - فالشيء الذي يتحول إلى مخرجات كثيرة هو أداة، والأداة تُنتج بالطريقة نفسها في كل مرة انطلاقًا من مدخلات يمكنك قراءتها. يبقى الاستكشاف حرًا لأن لا شيء لاحقًا يعتمد على وصوله إلى النتيجة نفسها مرتين. ويكتسب المُخرَج الثقة لأنه ليس تخمينًا. تحويل تجريب الذكاء الاصطناعي إلى نتائج يمكن التنبؤ بها وإعادة إنتاجها ليس تخصصًا جديدًا؛ إنه تقسيم العمل نفسه الذي جعل العمل المطبوع جديرًا بالثقة في المقام الأول.

ثِق بالعملية الإبداعية، وانشر بصرامة.

مقارنة بالبدائل

الفجوة واضحة: لا يوجد اليوم أي منتج مطروح يمنحنا مخرجات قائمة على القيود أولاً، وقادرة على العمل دون اتصال، وسهلة الاستخدام لغير المتخصصين، ومتاحة داخليًا. بل تتضمن Lolly لوحة مفتوحة - التصميم (Design) - حيث تلتزم الألوان والخطوط والأصول بالقيم العامة للعلامة التجارية، بحيث يبقى الترتيب الحر قائمًا على القيود أولاً. وما هي ليست عليه هو مجموعة تصميم بلا قيود: إذ يواصل المصممون استخدام Illustrator وFigma للأعمال الرائدة المخصصة. ويمكن تجميع التباديل باستخدام هذه الأداة.

signed by Lolly2026-10-21vector SVG367 paths~62k nodes773 groups3 images1,453 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG367 paths~62k nodes776 groups3 images1,454 KBتحقق بنفسكاحصل على الملف الموقَّع

استخدمها من أجل: التوليد السريع لأصول إبداعية مُشغَّلة تشغيليًا - بلاطات الفعاليات، وشارات الأسماء، والتوقيعات، وتنبيهات CVE، ورموز QR، والبطاقات الاجتماعية، وملصقات الشحنات، والتقارير المهيكلة.

لا تستخدمها من أجل: المحتوى الرئيسي المخصص.

دورة حياة حملة

أوضح طريقة لفهم ماهية Lolly ليست قائمة ميزات - بل تتبّع أصل واحد وهو ينتقل من يد إلى يد. راقب بطاقة حملة مُوطَّنة محليًا وهي تتحرك عبر المؤسسة:

1. يضع المبدع القواعد. يؤلف مصمم القالب الأساسي في أداة التصميم، ويُدمج فيه متغيرات الطباعة والألوان الخاصة بالعلامة التجارية بشكل ثابت. هو لا يصنع بطاقة واحدة - بل يقوم بالعمل التأسيسي مرة واحدة حتى لا يضطر أبدًا إلى توطينها يدويًا مجددًا.
2. ينشرها المطوّر على نطاق واسع. يُدمَج القالب نفسه في خط أنابيب ليلي عبر سطر الأوامر (CLI)، بحيث يُولَّد رسم بياني جديد أو نسخة لغوية جديدة تلقائيًا - دون أن يعيد أي مصمم فتح الملف.
3. يكتفي المُنتِج باستخدامها. يفتح مندوب مبيعات، دون اتصال في طائرة، الأداة نفسها ويُولّد عرضًا مطابقًا تمامًا للعلامة التجارية لاجتماع مع عميل. دون مهارة تصميم، ودون شبكة، ودون انتظار.

"الرسم البياني الجديد" في الخطوة الثانية هو عرض مثل هذا، يُنتَج من سلسلة بيانات وحفنة من المعاملات دون أن يفتح أحد ملف تصميم:

signed by Lolly2026-10-21vector SVG15 paths~1.3k nodes4 groups20 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG15 paths~1.3k nodes4 groups20 KBتحقق بنفسكاحصل على الملف الموقَّع

الفكرة ليست أن Lolly جيدة للمصممين و جيدة للمطورين و جيدة للمبيعات، كل على حدة في فراغ. إنها سباق تتابع (relay race): يُنشر عمل المبدع الأولي على نطاق واسع بواسطة المطوّر، الذي يمكّن بدوره المُنتِج. التجربة السلسة للمندوب غير التقني في الطائرة ممكنة فقط بفضل الصرامة التي وضعها المصمم ونشرها المطوّر.

هذا هو مضاعِف القوة. Lolly ليست درجًا من أدوات منفصلة لأدوار منفصلة - بل هي دورة حياة حتمية واحدة للأصل يمسّها كل دور، وكل يد تمر بها تضاعف قيمة اليد التي سبقتها.

أداة واحدة، مخرجات كثيرة

تعيش قواعد العلامة التجارية في الأداة، لا في كل ملف تصنعه (راجع كيف تقارَن Lolly). اضبط الأداة مرة واحدة، وكل مخرج يرث الخط واللون والمسافات نفسها، سواء كان ذلك بطاقة واحدة أو جدول بيانات من صفوف باثنتي عشرة لغة. كيف تتحقق من عملك، ومن يقوم بذلك، يبقى أمرك أنت؛ تجعل Lolly الشيء الذي يستحق التحقق منه أصغر والمخرج أسرع في الصنع.

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

• شخص، داخل التطبيق. شبكة الدُفعات /pro: الصق الصفوف أو استوردها، واحصل على أصل واحد جاهز لكل صف، وحمّل ملف zip. دون مهارة تصميم، ودون انتظار.
• مطوّر، من سطر الأوامر. يشغّل سطر الأوامر (CLI) المحرك نفسه ومسار العرض نفسه بلا واجهة، بحيث يمكن تشغيل الأداة تسلسليًا على كل صف في نص برمجي أو خط أنابيب ليلي. استدعاء lolly <tool> --field=… داخل حلقة تكرار هو التكامل بأكمله.
• نظام أو عميل ذكاء اصطناعي، عبر MCP. الأداة نفسها تُشغَّل برمجيًا، بالدقة نفسها، لأي عدد من الصفوف تتطلبه المهمة.

signed by Lolly2026-10-21vector SVG133 paths~15k nodes185 groups1 image195 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG133 paths~15k nodes185 groups1 image195 KBتحقق بنفسكاحصل على الملف الموقَّع

مجموعة واحدة من قيود العلامة التجارية، يثبّتها مصمم مرة واحدة؛ وثلاثة مسارات تؤدي إلى المخرج نفسه.

الصورة الكبيرة: كيف تتلاءم الطبقات

كل ما يلي من هنا هو بنية معمارية. المخطط هو النظام بأكمله في نظرة واحدة: الأدوات هي بيانات في الأعلى، والمحرك في الوسط لا يعرف شيئًا عن أي منصة، والأغلفة (shells) أسفله تنفّذ عقدًا واحدًا، والكتالوجات توفّر المحتوى.

                ┌─────────────────────────────────────────────┐
                │              Tools (data, not code)         │
                │   tool.json + template.html + hooks.js?     │
                └─────────────────────────────────────────────┘
                                    ▲
                                    │ talks to via Capability Bridge v1
                                    ▼
                ┌─────────────────────────────────────────────┐
                │                  Engine                     │
                │   loader · validator · runtime · template   │
                │   inputs · url-mode                         │
                │   PLATFORM AGNOSTIC. Knows nothing of DOM,  │
                │   filesystem, or You.                       │
                └─────────────────────────────────────────────┘
                                    ▲
                                    │ implements HostV1
                                    ▼
        ┌──────────────┬──────────────┬──────────────┬──────────────┐
        │  Web Shell   │ Tauri Desktop│ Tauri Mobile │  CLI Shell   │
        │   (PWA)      │              │              │              │
        └──────────────┴──────────────┴──────────────┴──────────────┘
                                    ▲
                                    │ fetches from
                                    ▼
                ┌─────────────────────────────────────────────┐
                │              Catalogs                       │
                │   catalog/tools/index.json + tool dirs      │
                │   catalog/assets/index.json + asset files   │
                └─────────────────────────────────────────────┘

تخطيط المستودع

Lolly مستودع واحد. engine/، وschemas/، وscripts/، وtests/، وapi/، وdocs/، وcommunity/، وbrands/lolly-start/، وكل shells/، وكلا services/ هي مجرد أدلة عادية فيه. الاستثناء الوحيد هو brands/suse، وهو وحدة فرعية خاصة في git تضم حزمة أدوات SUSE وفهرسها، اختيارية وغير موجودة في أي نسخة عامة. الحزم التي تقرأها نسخة بناء معينة يحددها ملف تعريف محتوى (profiles.json)، يُحسم لكل عملية على حدة بدلاً من التبديل عالمياً. راجع دليل البناء » الحصول على المصدر لمعرفة أمر الاستنساخ وكيفية تسجيل تغيير داخل الحزمة الخاصة.

lolly/
├── engine/           # Platform-agnostic core. Open source (MPL-2.0).
│   └── src/
│       ├── index.ts          # public surface - loader, runtime, template, inputs, url-mode
│       ├── loader.ts         # fetches and validates tool files
│       ├── runtime.ts        # orchestrates the 5-step lifecycle
│       ├── template.ts       # Handlebars hydration + annotateTemplate
│       ├── inputs.ts         # manifest → runtime input model
│       ├── url-mode.ts       # URL ↔ input state round-trip
│       ├── validate.ts       # JSON Schema validation of manifests
│       ├── compose.ts        # resolve nested tool renders (composes)
│       ├── embed.ts          # parse portable lolly.tools embed URLs
│       └── bridge/
│           └── host-v1.ts    # type re-export of the @lolly-tools/core contract
│
├── shells/
│   ├── web/          # PWA - hosted online; primary distribution
│   │   └── src/
│   │       ├── main.ts           # boot, routing
│   │       ├── theme.ts          # theme apply/persist (FOUC prevention)
│   │       ├── bridge/           # web implementations of HostV1 APIs
│   │       │   ├── index.ts      # compose all bridge pieces
│   │       │   ├── db.ts         # IndexedDB setup
│   │       │   ├── state.ts      # host.state - saved edits
│   │       │   ├── profile.ts    # host.profile - user details
│   │       │   ├── assets.ts     # host.assets - catalog + user uploads
│   │       │   ├── clipboard.ts  # host.clipboard
│   │       │   ├── export.ts     # host.export - rasterise/serialize
│   │       │   ├── net.ts        # host.net - allowlisted fetch
│   │       │   └── media.ts      # host.media - live camera frames (onFrame)
│   │       ├── catalog/
│   │       │   └── sync.ts       # boot-time catalog sync + offline cache
│   │       ├── styles/           # app-wide CSS (app.css, picker.css, tokens.css)
│   │       └── views/
│   │           ├── gallery.ts    # tool library listing + saved-state cards
│   │           ├── tool.ts       # mounts one tool (inputs + canvas + actions)
│   │           ├── picker.ts     # asset picker UI (invoked by host.assets)
│   │           ├── profile.ts    # user details editor
│   │           ├── projects.ts   # /p - folders of saved sessions (nested; folder/selection export)
│   │           └── free-canvas.ts # free-canvas editor overlay for render.layout:"editor" tools
│   │
│   ├── cli/          # Node.js CLI - same engine, headless jsdom
│   │   ├── bin/lolly.ts
│   │   └── src/
│   │       ├── run.ts    # loadTool → createRuntime → export → write file
│   │       └── bridge.ts # CLI implementation of HostV1
│   │
│   ├── tui/          # Interactive terminal shell (Ink) - reuses the CLI bridge
│   │   └── src/
│   │       ├── main.tsx  # full-screen app: Gallery / Projects / Profile / ToolView
│   │       └── bridge.ts # CLI bridge + on-disk state under ~/.lolly
│   │
│   ├── tauri-desktop/ # downloadable desktop app
│   └── tauri-mobile/  # iOS/Android app
│
├── community/        # the brand-agnostic tool pack - data, not code. Public (MPL-2.0).
│                     #   A SELECTION follows; a profile mounts these plus whatever
│                     #   tools the active brand pack carries of its own.
│   ├── qr-code/
│   ├── snippet/
│   ├── countdown-timer/
│   ├── color-palette/
│   ├── street-map/        # offline vector city-block maps
│   ├── url-shot/          # "URL Screenshot" (capture capability)
│   ├── strip-data/        # on-device metadata strip - JPEG/PNG/SVG/PDF (file in → clean file out)
│   ├── compress-pdf/      # on-device PDF compressor - recompresses images (file in → smaller file out)
│   ├── chart/             # SVG charts from structured data
│   ├── filter/            # photo effects in one tool - halftone/scanline/posterize/voronoi (vector), duotone/pixel-stretch/imperfections (raster)
│   ├── meeting-planner/   # global timezone meeting scheduler
│   ├── calendar-ics/      # event → .ics calendar file plus a card
│   ├── wayfinding-signage/ # event signage; directions blocks auto-fit label text
│   ├── text-helper/       # on-device text workbench (format/decode/hash/de-identify)
│   ├── design/     # "Design" - freeform WYSIWYG editor canvas (render.layout: editor)
│   ├── multi-page-pdf/    # multi-page PDF document - cover, flowing content blocks, back page
│   ├── diagram-builder/   # org / layercake / process / cycle / pyramid diagrams
│   ├── logo-wall/         # many logos → auto-packed grid
│   ├── icon/              # favicon .ico / png / svg from text + colours
│   └── lottie-digi-ad/    # animated Lottie ad banners
│
├── brands/            # brand packs - a catalog each, and optionally tools of their own
│   ├── lolly-start/   # the blank starter brand, owned here
│   │   └── catalog/
│   │       ├── tools/index.json    # tool registry, generated per brand
│   │       └── assets/
│   │           ├── index.json      # asset registry
│   │           └── lolly/...       # logo, palette, tokens
│   └── suse/          # PRIVATE submodule - the SUSE tools and the SUSE catalog
│
├── schemas/          # JSON Schema for tool.json, asset entries, AssetRef
├── scripts/          # build-catalog-index.ts, checksum-assets.ts, validate-catalog.ts
├── tests/            # engine tests
└── docs/             # this file + authoring guides + positioning

نموذج تسليم المنصة

تعمل المنصة عبر عدة أسطح - تطبيق ويب تقدمي (PWA)، وTauri لسطح المكتب/الجوال، وسطر الأوامر (CLI) القابل للبرمجة النصية، وواجهة TUI التفاعلية. وتستخدم جميعها المحرك نفسه وملفات الأدوات نفسها.

الويب (PWA) - التوزيع الأساسي

مُستضاف على رابط تتحكم فيه SUSE. يعمل دون اتصال بمجرد أن يخزّن عامل الخدمة (service worker) الأدوات والأصول مؤقتًا. هنا سيستخدم معظم الموظفين والموردين والشركاء المنصة. لا حاجة إلى حساب - تُخزَّن الحالة في IndexedDB لكل جهاز.

غلاف الويب متجاوب من تخطيط واحد. على سطح المكتب، الأداة عبارة عن شريط جانبي لعناصر التحكم قابل لتغيير الحجم بجانب مسرح معاينة مع تنقّل أصلي في اللوحة عبر لوحة اللمس (عجلة Cmd/Ctrl أو القرص للتكبير حول المؤشر، والسحب بالمسافة أو بالزر الأوسط للتحريك، ومفاتيح 0/1/+/− ومؤشر Fit/% على الشاشة). على الجوال (≤640 بكسل)، تتحول عناصر التحكم إلى ورقة مثبَّتة أعلى الشاشة بمقبض سحب ينطبق على وضع اللمحة/النصف/الكامل (النقر يبدّل بينها) فوق معاينة ثابتة بملء الشاشة، ويفتح زر Render عائم عناصر تحكم Export في نافذة منبثقة أسفل الشاشة. يحصل اللمس على تكبير بالقرص وتحريك بالسحب على المعاينة. مسار العرض وعناصر تحكم التصدير متطابقان في الحالتين - يتغيّر شكل الواجهة فقط.

signed by Lolly2026-10-21vector SVG131 paths~6.1k nodes158 groups1 image142 KBتحقق بنفسكاحصل على الملف الموقَّع

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

signed by Lolly2026-10-21vector SVG97 paths~3.3k nodes113 groups99 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG97 paths~3.3k nodes113 groups100 KBتحقق بنفسكاحصل على الملف الموقَّع

وضع الدفعات (/pro). يشحن غلاف الويب أيضًا شبكة دفعات بأسلوب جدول البيانات (shells/web/src/pro/) تُصيّر صفوفًا كثيرة دفعة واحدة عبر أداة واحدة أو عدة أدوات. تقوم بتبادل CSV/TSV ذهابًا وإيابًا بالإضافة إلى اللصق من جدول بيانات، وقالب/صيغة/حجم/وحدة/دقة لكل صف، ولوحة جانبية لمحرر الكتل مع معاينة حية، وأعمدة تصدير قابلة للطي، وشريط وسوم "الصلة" لكل صف، وإعادة ترتيب الصفوف بمقبض سحب على اليسار، وتأكيد حذف من خطوتين، وجلسات دفعات محفوظة، وتنزيل بصيغة .zip. هذه هي واجهة "واحد إلى كثير" وراء موضع "إنشاء المحتوى الجماعي".

تطبيق Tauri لسطح المكتب / الجوال

تطبيق أصلي معبأ (بصمة صغيرة عبر Tauri). يوفر إتاحة كاملة دون اتصال، ووصولًا إلى نظام الملفات للأدوات المعتمدة على CLI (PDF Smasher وFont Outliner)، ووصولًا إلى الكاميرا. مُجدوَل لتحسين الأدوات في منتصف 2026.

CLI

lolly <tool-id> [--input=value ...] --output=file.png

يمكن لمستخدمي سطح المكتب استدعاء أدوات كثيرة من الطرفية. يحمّل غلاف CLI المحرك نفسه، وينشئ DOM بواسطة jsdom، ويشغّل مسار التصيير نفسه، ويكتب الملف. وضع URL هو وسيلة النقل - CLI ليس تطبيقًا منفصلًا. هذا يضمن تطابق مخرجات CLI وواجهة المستخدم الرسومية.

lolly qr-code --url=https://suse.com --output=qr.svg
lolly quotes --quote="Ship it." --output=quote.png
lolly                        # lists available tools
lolly qr-code                # lists inputs for that tool

TUI

pnpm run tui

النظير التفاعلي لـ CLI: تطبيق طرفية بملء الشاشة يعتمد أولًا على لوحة المفاتيح (مبني على Ink) لتصفح الأدوات، وملء المدخلات، وحفظ المشاريع، والتصدير - كل ذلك دون واجهة مستخدم رسومية. تُعيد جسرة المضيف الخاصة به استخدام تطبيق CLI لصيغ خالية من DOM (SVG/EMF/EPS/HTML + نص/بيانات)، وتضيف حالة على القرص ضمن ~/.lolly بالإضافة إلى معاينة مضمّنة اختيارية. وإلى جانب ذلك لديها طبقة تصيير بالمتصفح: كروميوم بلا واجهة رسومية ومحدود النطاق (نفسه الذي يثبّته خادم MCP) ينتج صورًا نقطية/PDF/فيديو والتقاطًا حيًا لعناوين URL عند الطلب - يشغّل نسخة مبنية من غلاف الويب بحيث تتطابق المخرجات، ولا يُطلق إلا عند أول تصدير لصيغة كهذه. لذا فإن url-shot (مع القص وإعادة التلوين وPDF/SVG المتجهي) وكل أداة raster/pdf تعمل في الطرفية أيضًا. راجع دليل TUI.

أيًا كانت الواجهة التي تستخدمها، فإن تبويب "القدرات" (Capabilities) في لوحة التحكم هو الخريطة الكاملة لما تُعلن المنصة أنها قادرة على فعله، مُجمّعة ومقروءة دون فتح أي أداة.

فئات الأدوات

تُوسم الأدوات بحقل category في بيانها للتجميع في المعرض.

تُدرج الصفوف بترتيب أقسام المعرض. يُعرض قسم utility دائمًا أخيرًا في المعرض (بعد كل فئة أخرى، بما في ذلك الفئات المستقبلية) - إنه درج "الأدوات المساعدة دون اتصال" العامل على الجهاز.

هذه الخلايا أمثلة، لا قوائم جرد. الأدوات الموجودة فعليًا خاصية للملف الشخصي (profile) الذي ركّبته، لا لهذه الصفحة: تضيف حزمة العلامة التجارية أدواتها الخاصة، ويمكنها استبعاد أداة مجتمعية تفضّل عدم شحنها. catalog/tools/index.json - المُولَّد من البيانات، والسجل الذي يقرؤه المعرض فعليًا - هو القائمة الموثوقة؛ لعدّ ما يُركّبه ملف شخصي ما، عُدّ البيانات (ls community//tool.json brands//tools/*/tool.json) بدلًا من الثقة برقم مكتوب هنا. (معرّف أداة موجود في حزمتين يُركَّب مرة واحدة، من الحزمة الفائزة.)

تُصنَّف الأدوات أيضًا بحالة: official (معتمدة من العلامة التجارية، دون علامة مائية)، وcommunity (مساهمة خارجية)، وexperimental (صادرات بعلامة مائية). معظم المكتبة official؛ وتميل الاستوديوهات الأحدث وأدوات الالتقاط إلى الوقوع ضمن community أو experimental ريثما تستقر. تُظهر كل واجهة الشارة، بحيث يعرف القارئ ما الذي يحصل عليه قبل أن يفتحه - ومثل خلايا الفئات أعلاه، تتغير عضوية كل حالة بسرعة تفوق إمكانية سردها هنا. اطّلع عليها من المعرض أو الفهرس المُولَّد.

Design هي أول أداة مبنية على وضع اللوحة الحرة render.layout: "editor" - سطح تلاعب مباشر بلا إطار واجهة، تسحب فيه وتُغيّر حجم وتُدوّر وتُلصق مربعات من نص وأشكال وصور، ثم تُصدّر عبر مسار التصيير نفسه المستخدم في كل أداة أخرى.

Strip Hidden Data هي أول أداة تعمل على الجهاز (privacy: "on-device"): أداة تحويل محتوى تأخذ ملفاً توفره أنت، وتعالجه بالكامل داخل المتصفح، وتعيد نسخة نظيفة منه - لا تُرفع أبداً، ولا تُوسم بعلامة مائية، ولا يُطبع عليها أي إثبات منشأ. Text هي الثانية - مساحة عمل تعمل على الجهاز للمهام اليومية التي تُلصق في موقع ويب (تنسيق JSON، وفك ترميز JWT، وBase64، وترميز/فك ترميز عناوين URL، وتجزئة SHA). Compress PDF هي الثالثة - تُصغّر ملف PDF عبر إعادة ضغط صوره، وهي أيضاً تعمل بالكامل على الجهاز. أصبحت العلامة ونص شارتها "يعمل على جهازك - لا شيء يُرفع" تغطي الآن مجموعة التحويل بأكملها: Strip Hidden Data، وText، وCompress PDF، وConvert Image (HEIC/TIFF/AVIF → WebP/JPG/PNG)، وConvert Font، وRedact (لإتلاف مناطق من صورة أو SVG أو PDF)، وPrompt Card وRebrand (لإعادة تنسيق ملف .pptx في مكانه) حيثما ثبّتها ملف التعريف. هذه فئة أدوات خصوصية تحل محل تسليم ملفات سرية إلى مواقع ويب أحادية الغرض.

signed by Lolly2026-10-21vector SVG124 paths~29k nodes324 groups395 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG124 paths~29k nodes324 groups396 KBتحقق بنفسكاحصل على الملف الموقَّع

ملاحظة: يتم إلغاء تسوية category وstatus داخل catalog/tools/index.json (السجل الذي تقرأه المعرض) من كل tool.json. البيان (manifest) هو مصدر الحقيقة - الفهرس يُولَّد بواسطة pnpm run build:catalog، ويفشل pnpm run validate:catalog في CI إذا انحرف الفهرس المُثبَّت عن البيانات.

الالتزامات المعمارية

هذه القرارات مستقرة. تغيير أي منها مهمة كبرى - فهي تُشكّل كل قرار آخر في قاعدة الشيفرة.

1. أدوات تعريفية (declarative)، مع مخرج طوارئ إجرائي (imperative)

الأداة هي بيان (tool.json) + قالب (template.html) + hooks.js اختياري.

البيان هو ما يُعرّف المدخلات. وليس القالب. لا تُستنتج المدخلات من رموز Handlebars. البيان هو العقد؛ ويستهلك القالب المتغيرات المسماة عبر {{id}}.

signed by Lolly2026-10-21vector SVG39 paths~2.6k nodes54 groups2 images43 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG39 paths~2.6k nodes54 groups2 images43 KBتحقق بنفسكاحصل على الملف الموقَّع

الخطاطيف (hooks) اختيارية. معظم الأدوات تعريفية بحتة - يكفيها بيان + قالب. الأدوات التي تحتاج قيمًا محسوبة (ترميز QR، تشكيل بيانات المخططات) توفّر hooks.js تُظهر دوال دورة حياة مسمّاة (onInit، onInput، onFrame - خطاف الكاميرا الحية لكل إطار للأدوات التفاعلية مع الحركة - وonLevel، وbeforeExport، وafterExport، وexportFile - مسار التحويل ملف-إلى-ملف الذي تستخدمه الأدوات المساعدة العاملة على الجهاز مثل Strip Hidden Data - وexportStill، للأداة التي تمتلك تصييرها النقطي العميق الخاص). يحمّل المضيف الخطاطيف عبر new Function('host', …) مع حقن جسرة القدرات كنطاق إغلاق (closure). هذا عقد قابلية نقل، لا صندوق حماية أمني: لا تزال الخطاطيف تعمل في نطاق الصفحة ويمكنها الوصول إلى window/fetch/document في غلاف متصفح - host. هو السطح المدعوم والقابل للنقل، لا حدًا مفروضًا. نتائج الخطاطيف غير المتزامنة محددة بمهلة زمنية (onInit 5 ثوانٍ، onInput ثانيتان، beforeExport/afterExport 5 ثوانٍ، exportFile/exportStill 10 ثوانٍ) وتُهمَل النتائج المتأخرة؛ ولا يمكن استباق خطاف متزامن* منفلت. لذا فإن تشغيل شيفرة خطافات من طرف ثالث غير موثوق ليس آمنًا إلى أن يصدر عزل Worker.

يهم هذا لأن: الأدوات التعريفية يمكن أن يُؤلّفها غير المطورين. لو كانت كل أداة تطبيق ويب، لأصبحت ملاحظة الخطر "مهارات محدودة لإنشاء/صيانة القوالب الأساسية" عنق زجاجة دائمًا.

2. الأدوات والأصول بيانات، لا شيفرة مُجمَّعة

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

بايتات الأصول محسوبة بمجموع اختباري SHA-256 لمنع تسميم CDN. id الأصل + version هما ما يُشغّل إبطال ذاكرة التخزين المؤقت.

3. جسرة القدرات هي الواجهة البرمجية الوحيدة التي تراها الأدوات

لا تلمس الأدوات أبدًا DOM خارج منطقة قالبها، ولا تستدعي fetch مباشرة أبدًا، ولا تقرأ نظام الملفات أبدًا. إنها تستدعي دوال host.* ذات إصدار. التعريف المرجعي للعقد هو packages/core/src/host-v1.ts - حزمة تطوير مؤلفي الأدوات @lolly-tools/core، بحيث يمكن لطرف ثالث البناء عليه دون الاعتماد على المحرك؛ وengine/src/bridge/host-v1.ts هو إعادة تصدير نوعي (type re-export) له، وتستمر شيفرة المحرك/الأغلفة في الاستيراد من ذلك المسار دون تغيير:

تظهر الأسطح الاختيارية والإضافية فقط عندما يوفّرها الغلاف. بعضها مُقيَّد بالقدرة - يُكشف فقط عندما تُعلن الأداة العلم المطابق: host.compose (تضمين تصيير أداة أخرى - compose)، وhost.capture (التقاط صفحة لأداة URL Screenshot - capture)، وhost.recorder (التقاط الميكروفون/الكاميرا/الشاشة لأدوات التسجيل - microphone / camera / screen). البقية يُكتشف توفرها ميزة بميزة (feature-detected) - تكون حاضرة كلما استطاع الغلاف توفيرها، مع احتفاظ الأداة ببديل احتياطي للأغلفة التي لا تستطيع.

حفنة من الأسطح الرئيسية، لبيان ما تغطيه - يوثّق Host API كل واحدة منها، وpackages/core/src/host-v1.ts هو العقد نفسه:

البقية تتبع القواعد نفسها وموثّقة إلى جانبها: pdf (1.8) وpptx (1.58) لجراحة المستندات على الجهاز، وaudio (1.71) وspeech (1.96) لتحليل المقاطع والتحويل النصي/الكلامي على الجهاز، وviz (1.72) لعقد MilkDrop البديل المؤقت، وcodec (1.100) وlayers (1.102) لمخرجات البت العميق والصور النقطية الطبقية، وupscale (1.101) وmatte (1.103) للنماذج العاملة على الجهاز، وraster (1.105) للخطاطيف التي تُنفّذ عملها الخاص على مستوى البكسل، وconnectors (1.106) للأسهم الآمنة للتصدير، وc2pa (1.85) لتوقيع البايتات النهائية. العدد يزداد؛ القواعد لا تتغير.

القدرات القابلة للإعلان هي: network، وfilesystem، وclipboard، وcamera، وmicrophone، وscreen، وffmpeg، وwasm، وcapture، وcompose. (screen، المُضافة في 1.54، هي التقاط الشاشة عبر host.recorder - يختار المستخدم شاشة/نافذة/تبويب في واجهة أصلية للمتصفح؛ وتختلف عن capture، التي تُصيّر عنوان URL تُسميه الأداة نفسها.)

تعمل الأداة نفسها في المتصفح وTauri وCLI بلا واجهة رسومية لأن كل غلاف يُنفّذ هذه الواجهة - ولا تعرف الأداة أبدًا في أي منها هي.

الجسرة ذات إصدار. إضافة دوال هي إصدار ثانوي. حذف أو تغيير التوقيعات هو ترقية إصدار رئيسي. عندما يُشحن v2، يجب أن يستمر v1 في العمل.

4. معرّفات الأصول دائمة

suse/logo/primary عقد. بمجرد النشر:

• المعرّف لا يتغير أبدًا، ولا يُعاد استخدامه أبدًا.
• تغييرات البايتات → ترفع version في البيان.
• الاستبدال بأصل جديد → عيّن deprecated: true واختياريًا replacedBy.
• المراجع الحالية تُحل دائمًا.

هذا يجعل حالات الأدوات المحفوظة والروابط المشتركة عبر URL معمّرة عبر السنين.

5. وضع URL درجة أولى

يجب أن يكون كل مدخل قابلًا للتعبير عنه كمعامل URL:

lolly.tools/#/tool/qr-code?url=https://suse.com&ecl=H

signed by Lolly2026-10-23vector SVG55 paths~2.6k nodes38 groups60 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-23vector SVG55 paths~2.6k nodes38 groups61 KBتحقق بنفسكاحصل على الملف الموقَّع

وضع CLI هو وضع URL تحت وسيلة نقل مختلفة - يبني غلاف CLI كائن حالة-URL من argv ويُشغّل خط أنابيب المحرك نفسه. هناك مسار تصيير واحد. لا يمكن أن ينحرف CLI عن واجهة المستخدم الرسومية لأنه ليس تطبيقًا منفصلًا.

يتولى url-mode.ts الرحلة ذهابًا وإيابًا (التحليل والتسلسل). مجموعة من المعاملات المحجوزة لا تُمرَّر أبدًا إلى الأداة كمدخلات: عناصر تحكم المخرجات (format، export، copy، filename، width/w، height/h، unit، dpi)، ومقابض الطباعة والمصدر (bleed، marks، profile، password، c2pa، imprint، durable، meta، hdr، depth، cuts)، وحاملات الحالة (template، وz - رمز "أقصر رابط" المُعبّأ - وzx، الرمز نفسه مُشفّرًا بكلمة مرور). مجموعة RESERVED في engine/src/url-mode.ts هي المرجع، ومُثبّتة باختبار؛ يوثّق وضع URL كل واحد منها، بما في ذلك الحفنة غير المدرجة هنا. تُسلسَل مدخلات الأصول في وضع URL بواسطة id الخاص بها؛ ويحلّها وقت التشغيل عبر host.assets.get() قبل الترطيب (hydration). width/height قيم بوحدة unit (الافتراضي px، وأيضًا mm/cm/in/pt/pc)؛ ومع وحدة فيزيائية يضبط dpi دقة التصيير النقطي. تضبط هذه القيم حجم مستند اللوحة وتملأ مسبقًا لوحة أبعاد التصدير.

لأن كل مدخل يسافر داخل الرابط، فإن تغيير معامل واحد يعني أصلًا نهائيًا مختلفًا. هذه اللوحة بأكملها هي لون بذرة واحد، وتوافق، وعدد خطوات:

signed by Lolly2026-10-21vector SVG10 groups25 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG10 groups25 KBتحقق بنفسكاحصل على الملف الموقَّع

6. التخزين يمر عبر الجسر، لا بشكل مباشر

غلاف الويب: IndexedDB. Tauri: نظام الملفات. CLI: في الذاكرة. الأدوات ترى فقط host.state.save(slot, data) وhost.state.load(slot). لا تُستخدم localStorage - فهي صغيرة جدا ولا يمكنها حمل البيانات الثنائية الكبيرة.

يمكن للمستخدمين حفظ عدة فتحات تحرير مسماة لكل أداة والعودة إلى كل جلسة لاحقا. لا حاجة لإنشاء حساب؛ الحالة خاصة بكل جهاز. ولأن الجسر هو المنفذ الوحيد، فإن هذه الحالة الخاصة بالجهاز قابلة للنقل أيضا: يقرأ shells/web/src/data-transfer.ts كل شيء عبر host.profile/host.state/host.assets إلى ملف zip واحد باسم lolly-backup يُستورد في أي تثبيت آخر - الحل غير المتصل لسؤال "الانتقال إلى جهاز جديد" الذي لا يحتاج إلى خادم (المواصفات الكاملة: docs/data-transfer.md). والمزامنة عبر عدة أجهزة تعمل بالفعل فوق هذا الأساس، فترسل الحزمة نفسها إلى المخزن الذي يختاره الشخص (docs/sync.md).

7. علامات النضج تقول ما هي الأداة

تعلن كل أداة عن status: official | community | experimental في بيانها. تُرتب المعرض حسب الحالة. الأدوات التجريبية تضع علامة مائية على صادراتها تلقائيا - تُطبَّق العلامة المائية بواسطة host.export.render، وليس بواسطة الأداة، لذا لا يمكن لمؤلف أداة غير رسمي تعطيلها.

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

8. مدخلات الأداة مكتوبة عبر البيان، بما في ذلك الأصول

تعلن المدخلات عن type: text، longtext، number، boolean، color، select، asset، date، time، datetime-local، url، blocks، vector، table وfile. يعرض المضيف عنصر تحكم عاما لكل نوع من البيان - الأدوات لا تكتب أي كود تحكم. (التعبئة المسبقة من ملف المستخدم الشخصي ليست نوعا - يمكن لأي مدخل أن يحمل bindToProfile.) ثلاثة منها لها وزن أكبر من البقية:

• asset (مع filter وallowUpload) هو الجسر إلى نظام الأصول العام؛ allowUpload: false هو رافعة فرض العلامة التجارية لأشياء مثل شعارات بلاطات الرعاية حيث يُسمح فقط بأصول المكتبة. تحميلات المستخدم تستخدم نفس شكل AssetRef كأصول المكتبة، فتتعامل الأدوات معها بنفس الطريقة.
• blocks هي مجموعة حقول متكررة - جدول مصغر داخل مدخل واحد، يُحرَّر في لوحة جانبية، مع قائمة إضافة مكتوبة/تمييزية وحقول أصول لكل كتلة. النقر على كتلة معروضة على اللوحة يركز على صف تلك الكتلة. تستخدمها meeting-planner وchart-creator وevent-name-badge وwayfinding-signage وcolor-block وdigi-ad.
• vector تجمع مجموعة ثابتة من الأرقام (مثل تحويل) في عنصر تحكم مركب واحد؛ file تحمل ملف المستخدم الخاص كبايتات في الذاكرة لأدوات التحويل على الجهاز (مثل strip-data وcompress-pdf).

9. القوالب بلا منطق (Handlebars، وليس EJS)

اختير Handlebars بدلا من EJS عن قصد:

• بلا منطق. يمكن لغير المطورين تأليف القوالب.
• آمن افتراضيا. {{x}} تفلت شفرة HTML؛ {{{x}}} خام اختياري.
• عدم وجود JS عشوائي في القوالب يعني عدم وجود سطح لتدقيق XSS لكل قالب.

يعيش المنطق في hooks.js حيث يكون صريحا وقابلا للمراجعة. مساعدات Handlebars المتاحة: {{default}}، {{upper}}، {{lower}}، {{eq}}، {{markdown}}، {{asset ref}}، {{asset ref "property"}} (بالإضافة إلى مساعدات تنسيق البيانات icsStamp/rfcText/csvCell التي تستخدمها قوالب .ics/.vcf/.csv الشقيقة).

10. الأدوات تركّب أدوات

يمكن لأداة أن تضمّن عرض أداة أخرى دون أي استيراد بين الأدوات - يُحل التركيب بواسطة المحرك، وليس بواسطة كود الأداة أبدا. هناك سطحان:

• بيان تصريحي - composes: [{ id, tool, inputs, format?, width?, height? }]. يعرض المحرك العنصر الفرعي المسمى ويضع النتيجة في القالب بلا المنطق كـ {{asset <id>}}. تركّب event-name-badge أداة qr-code كـ SVG اليوم.
• رابط تضمين قابل للنقل - <img src="https://lolly.tools/tool/<id>.<ext>?<inputs>">. يعرض الغلاف ذلك العنصر الفرعي محليا (يظهر بكسل نائب حتى يُحل العرض المحلي)؛ لا يُجلب شيء أبدا من lolly.tools.

ركّب عرض أي أداة: يبقى العنصر الفرعي SVG متجها حقيقيا عندما يُصدَّر الوالد إلى SVG أو PDF، ويُرسَّم بوضوح لـ PNG؛ عناصر PNG/JPG/WEBP الفرعية تُضمَّن كصور. يتطلب قدرة compose. العناصر الفرعية المركبة وسيطة - لا توضع عليها علامة مائية أو ختم منشأ أبدا - ويتدهور التركيب بسلاسة: الغلاف الذي لا يستطيع عرض عنصر فرعي يحذف الفتحة فقط ويظل الوالد يُعرض.

ما اخترنا صراحة عدم فعله

• لا EJS ولا JS تعسفي في القوالب. سطح هجوم XSS معدوم. المنطق موجود في hooks.js.
• لا نظام إدارة محتوى أصول إلزامي (CMS). يستورد الأفراد ملفاتهم الإبداعية الخاصة مباشرة إلى الأصول داخل التطبيق (عرض الأصول واستوديو العلامة التجارية) - بلا خادم، بلا لوحة تحكم إدارية. يُسلَّم العمل كـجلسة: يحمل رابط المشاركة مدخلاتها وإعداداتها (تنتقل الملفات المرفوعة في ملف .lolly)، وتنتقل الجلسة نفسها في نسخة احتياطية أو عبر جلسة تعاون. يستطيع من يتحكم بالنشر بعدها تثبيت جلسة مشتركة كـقالب - يفتح الرابط، يسجّل قيمه كإدخال قالب في دليل تلك الأداة ضمن حزمة العلامة التجارية ثم يُثبّته (commit) - وبعدها يظهر في منتقي "New from template" الخاص بالأداة ويصبح قابلا للربط المباشر كـ ?template=<id>. Git هو خطوة التثبيت الخاصة بمالك النشر، لا بالمُنشئ أبدا. لفهرس مشترك ومُحوكَم، يمكن لمؤسسة إدارة دليل الأصول بالطريقة نفسها وضبط التحديثات عبر مراجعة طلبات السحب (PR) - نموذج حوكمة متاح، لا شرطا في التطبيق.
• لا تحكم وصول قائم على الأدوار (RBAC) مفروض. التطبيق المفتوح متاح للعامة افتراضيا؛ تُدار مخاطر العلامة التجارية عبر وسوم النضج والعلامات المائية. المؤسسة التي تريد تحكما أشد تضيف طبقة من مصادقتها الخاصة والفهرس المُراجَع عبر git أعلاه.
• لا قاعدة بيانات مركزية. كل حالة المستخدم محلية لكل جهاز؛ وتنسخها المزامنة الاختيارية إلى المخزن الذي يختاره الشخص، لا إلى قاعدة بيانات لدى Lolly أبدا.
• لا مسار كود أدوات/محرك مشترك. المحرك مفتوح المصدر وكذلك الأدوات المحايدة تجاه العلامة التجارية في community/؛ تحمل حزمة علامة تجارية مثل brands/suse/ الخاصة أدواتها وفهرسها بشروطها الخاصة. في الحالتين يُفرض الفصل (لا استيرادات متقاطعة من engine/ إلى محتوى الأدوات) بحيث يبقى الانقسام نظيفا.

دورة حياة عرض واحد

يفتح المستخدم lolly.tools/#/tool/qr-code?url=https://suse.com&ecl=H:

1. الإقلاع (Boot). يفتح غلاف الويب IndexedDB، وينشئ جسر القدرات (capability bridge)، ويزامن فهارس الأدوات والأصول (أو يحمّلها من ذاكرة التخزين المؤقت عند عدم الاتصال).
2. التوجيه (Route). جزء التجزئة (hash) في عنوان URL → عرض tool، مع استخراج qr-code ومعاملات URL.
3. التحميل (Load). يجلب loadTool('qr-code', fetchFile) ملف tool.json، ويتحقق منه مقابل JSON Schema، ويجلب مصدر template.html وstyles.css وhooks.js.
4. تحليل حالة URL. تُترجم parseUrlState معاملات URL إلى قيم إدخال أولية. تُحلَّل مراجع الأصول (?logo=suse/logo/primary) ككائنات خفيفة من الشكل { id, _unresolved: true }.
5. وقت التشغيل (Runtime). تبني createRuntime(tool, host, initialValues) نموذج الإدخال (بدمج بيانات الملف الشخصي، والقيم الافتراضية، والقيم الأولية)، وتحل مراجع الأصول عبر host.assets.get()، وتحمّل الخطافات (hooks) (بنطاق إغلاق host، وليس بيئة معزولة)، وتستدعي hooks.onInit.
6. العرض (Render). يشترك الغلاف في وقت التشغيل؛ وعند كل تغيير في الحالة يتلقى { model, hydrated }. يعرض عناصر تحكم الإدخال من النموذج ويكتب HTML القالب المُرطَّب (hydrated) داخل #tool-canvas.
7. التفاعل (Interact). يكتب المستخدم في حقل إدخال → runtime.setInput(id, value) → تُطبَّق القيود → يُستدعى hooks.onInput → إعادة ترطيب → إعادة عرض. تتحدث اللوحة (canvas) مباشرة.
8. التصدير (Export). ينقر المستخدم على تنزيل (PNG) → runtime.export(canvasNode, 'png') → host.export.render (يُرستر عبر dom-to-image-more؛ أما SVG/PDF فتمر عبر أدوات تحويل متجهي مخصصة تمشي عبر DOM) → blob → host.export.download. نطاق الصيغ التي يمكن لأداة ما أن تختارها واسع، وتعداد render.formats في schemas/tool.schema.json هو المرجع الحاكم له - صور نقطية وصور نقطية عائمة، ومتجهات وملفات قص، وطباعة/CMYK، وحركة، ومستندات قابلة للتحرير (pptx، docx، odt)، ونواتج لوحة ألوان وبيانات/نص، وملفات صوت وخطوط. تُسمّي وضع URL كل معرّف وما ينتجه. الصوت جزء من ذلك التعداد كأي شيء آخر (wav، mp3، m4a، opus، تُعلَن من قبل أداة Audiogram وأدوات التسجيل)؛ وبشكل منفصل، يشغّل وضع render.capture في أداة تسجيل ما host.recorder، الذي تصل لقطته ككائن Blob مكتمل في أي حاوية سجّلها المتصفح. (الأدوات التي تضبط render.export: false - مثل Color Palette، وCountdown Timer، وStrip Hidden Data، وText، وCompress PDF - تُخفي عناصر التحكم في التنزيل/الصيغة/الأبعاد.) تُحوَّل الوحدات الفيزيائية هنا حسب كل صيغة (PDF → نقاط الصفحة الحقيقية، والصور النقطية → بكسلات بدقة DPI مع جزء pHYs). تُضمَّن البيانات الوصفية للتأليف/إثبات المنشأ (المؤلف، والأداة، والمصدر - التي يبنيها engine/src/metadata.ts) حسب كل صيغة: PNG iTXt، وJPEG EXIF، وقاموس معلومات PDF، وSVG <metadata>، وتعليق GIF. تحصل الأدوات التجريبية على علامة مائية يُدرجها المضيف (host)، لا الأداة.

signed by Lolly2026-10-21vector SVG77 paths~6.0k nodes87 groups3 images88 KBتحقق بنفسكاحصل على الملف الموقَّع signed by Lolly2026-10-21vector SVG77 paths~6.0k nodes87 groups3 images88 KBتحقق بنفسكاحصل على الملف الموقَّع

نفس دورة الحياة في Tauri. نفس دورة الحياة في CLI - يوفر jsdom الـ DOM بلا واجهة؛ المخرجات تذهب إلى ملف أو stdout.

حالة المصدر المفتوح

الكود مرخّص بموجب MPL-2.0. engine/، وshells/، وservices/، وschemas/، وdocs/*.ts مفتوحة المصدر بموجب MPL-2.0 - منصة سقالات (scaffolding) محايدة تجاه المزودين لأدوات العلامة التجارية، كلها في مستودع عام واحد، lolly-tools/lolly.

يُشحَن محتوى الأدوات كحزم علامة تجارية (brand packs)، لكل منها شروطها الخاصة (راجع ملف NOTICE.md الخاص بالحزمة). community/ دليل ضمن هذا المستودع، وأدواته المحايدة تجاه العلامة التجارية مرخّصة بموجب MPL-2.0 أيضاً. brands/suse/ هي حزمة suse-lolly الخاصة، الوحدة الفرعية الوحيدة: أدوات SUSE وفهرس SUSE، مملوكة حصرياً لـ SUSE، بما في ذلك موسيقى PremiumBeat المرخّصة لها. brands/lolly-start/ هي العلامة التجارية الفارغة للبدء التي يملكها هذا المستودع. تُشحَن الخطوط داخل حزمة بموجب رخصة SIL Open Font License 1.1 - وتحمل حزمة SUSE خطي SUSE وSUSE Mono.

لا يوجد دليل tools/ أو catalog/ في جذر المستودع. تجيب packages/node-shell/src/content-roots.ts عن سؤالي "أين تقيم الأداة <id>" و"أين يقع الفهرس" من profiles.json وقت القراءة، بحيث يكون ملف التعريف (profile) إجابة لكل عملية على حدة دون الحاجة لتجميع شجرة مسبقاً. لا يُكتب زوج tools/ + catalog/ حقيقي إلا داخل ناتج بناء - dist/، أو حمولة RPM، أو صورة حاوية - لأن المتصفح يجلب هذين المسارين عبر HTTP.

الانقسام مفروض - لا استيرادات متقاطعة من engine/ إلى محتوى الأدوات - بحيث تبقى الحدود بين المنصة والمحتوى نظيفة.

أين ينتهي المحرك ويبدأ المضيف

إن استطعت وصفه ببيانات خالصة + Handlebars ← المحرك. إن كان يلمس DOM، نظام الملفات، الشبكة أو أي واجهة برمجة تطبيقات متصفح/نظام تشغيل ← المضيف.

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

لمزيد من التفاصيل، يعدد engine/README.md كل وحدة في المحرك ومسؤوليتها، ويسجل نموذج التهديد وحدود الثقة أين يتضاعف نفس الخط كحد ثقة.