PRD v1.4

التوثيق

1. مقدمة ونظرة عامة

1.1 ما هو Linden؟

ليندن (Linden) هي منصة سحابية لتطوير الألعاب بالذكاء الاصطناعي تحول الأوامر النصية الطبيعية إلى كود حتمي وأصول رسومية متوافقة مباشرة مع محركات الألعاب مثل Godot و Unity.

Agent	Specialization
Game Architect	Scene hierarchy, node tree, lifecycle management
Programmer	GDScript 2.0, C# 12, Rust bindings, AST diffing
Technical Artist	GLSL/HLSL/WGSL shaders, sprite atlases, normal maps
QA Inspector	Headless simulation, collision testing, performance profiling
Level Synthesizer	Procedural level generation, difficulty pacing, biome design

1.2 الميزات الرئيسية

من الأمر إلى اللعب فوراً – نماذج أولية قابلة للعب في ثوانٍ
تحديث مباشر في أقل من 100 مللي ثانية دون إعادة تشغيل المحرك
تصدير متعدد المنصات – WebGPU, Windows, macOS, Linux

1.3 متطلبات التشغيل

Component	Minimum	Recommended
Browser	Chrome 113+, Safari 18+, Firefox 120+	Chrome 132+ (WebGPU)
RAM	4 GB	8 GB
GPU	WebGL 2.0 support	WebGPU / Vulkan 1.3
OS	Windows 10, macOS 12, Linux (Ubuntu 22.04)	Windows 11 / macOS 14+
Internet	10 Mbps	50 Mbps (for live agent streaming)

2. دليل البدء السريع

2.1 التسجيل والدخول

سجل دخولك عبر حساب Google أو GitHub للوصول مباشرة إلى مساحة عمل Linden Studio.

2.3 المشروع الأول

Create a 2D platformer with a blue character who can jump and
collect yellow coins. Add a red enemy that moves back and forth.

3. المفاهيم الأساسية

3.1 الوكلاء الخمسة

يعمل خمسة وكلاء متخصصين بالتوازي: مهندس المشهد (Architect)، المبرمج (Programmer)، الفنان التقني (Artist)، فاحص الجودة (QA)، ومصمم المستويات (Level Synthesizer).

3.3 استهلاك الرموز

Activity	Compute Tokens
1 prompt parsing	~100-500 tokens
Generate full platformer	~12,000 tokens
Shader generation	~2,400 tokens
Physics tweak	~800 tokens
Level generation	~3,500 tokens

4. الدليل المتوسط والأوامر المباشرة

4.4 سطر الأوامر CLI

npm install -g @linden/cli
linden generate -f prompt.txt -o ./output
linden test --ticks=1000 --headless

5. المنصات المدعومة

Target	Format	Primary Use Case
Web	HTML5 + WASM	Browser play, instant sharing
Windows	.exe (portable)	Steam, Itch.io distribution
macOS	.app (universal)	Mac App Store, standalone
Linux	AppImage	Steam Deck, Linux gamers
Android	.apk / .aab	Google Play Store
iOS	.ipa (preview)	Apple App Store
Consoles	Custom SDK	PlayStation, Xbox, Switch (NDA)

8. استكشاف الأخطاء وإصلاحها

Issue	Probable Cause	Recommended Solution
Error 400	Malformed prompt syntax or JSON	Inspect JSON headers, test with curl -v
Timeout	Project scope too complex	Batch prompt, enable async streaming, or upgrade tier
Tokens Exhausted	Quota exceeded	Upgrade tier or acquire pay-as-you-go token packs
Code Build Fail	AST Parse Error	Review QA Inspector logs, use more constrained prompt
Low Framerate	GPU / Shader load	Target WebGPU, enable caching, or use self-hosted runner

Code	Description	Recommended Action
400	Bad Request	Verify JSON schema & syntax
401	Unauthorized	Verify API Key or re-authenticate
403	Forbidden	Check tier permissions
404	Not Found	Invalid project ID specified
429	Rate Limit Exceeded	Throttle calls or upgrade token concurrency
500	Internal Engine Error	Contact Linden developer support

9. الأسئلة الشائعة (FAQ)

س: كم يستغرق إنشاء لعبة منصات؟

عادة بين 30 إلى 60 ثانية لتوليد لعبة ثنائية الأبعاد قابلة للتشغيل بالكامل.