البدء السريع
ثلاثة أوامر. بلا تسجيل.
Open Design لديه نقطة دخول واحدة: pnpm tools-dev. الـ daemon ينشئ تلقائياً مجلداً مخفياً .od/ لقاعدة بيانات SQLite ولـ artifacts كل مشروع. لا توجد خطوة od init.
المتطلبات
- · Node ~24 —
nvm install 24 && nvm use 24أوfnm install 24 && fnm use 24 - · pnpm 10.33.x —
corepack enable && corepack pnpm --version - · CLI واحد على الأقل لـ coding-agent مدعوم في
PATH— Claude Code, Codex, Cursor, Gemini, OpenCode, Qwen, Copilot, Devin, Hermes, Kimi, Kiro, Vibe، أو Pi (أو لا شيء، إن كنت ستستخدم proxy BYOK)
ثلاثة أوامر
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev run webافتح URL الويب الذي يطبعه tools-dev. أفتح dialog الترحيب، ألصق مفتاح Anthropic (مطلوب فقط لمسار fallback BYOK)، اكتب prompt، اضغط Send.
حالة أول تشغيل
الـ daemon يملك مجلداً مخفياً واحداً.
.od/
├── app.sqlite ← projects · conversations · messages · open tabs
├── artifacts/ ← renders «Save to disk» لمرة واحدة (موسومة بـ timestamp)
└── projects/<id>/ ← مجلد عمل لكل مشروع، أيضاً cwd الـ agent| تريد… | افعل هذا |
|---|---|
| تفقّد ما هناك | ls -la .od && sqlite3 .od/app.sqlite '.tables' |
| إعادة لحالة نظيفة | pnpm tools-dev stop && rm -rf .od && pnpm tools-dev run web |
| نقله إلى مكان آخر | غير مدعوم بعد — المسار hard-coded نسبياً للـ repo |
أوامر دورة الحياة
الكل تحت pnpm tools-dev.
pnpm tools-dev start # إقلاع daemon + web (في الخلفية)
pnpm tools-dev run web # المكافئ في المقدمة
pnpm tools-dev stop # أوقف كل شيء
pnpm tools-dev status # ما الذي يعمل، أين
pnpm tools-dev logs # tail لـ logs daemon + web
pnpm tools-dev inspect # IPC إلى العمليات الجارية
pnpm tools-dev check # فحوصات صحيةلـ desktop / إقلاع في الخلفية، إعادات تشغيل على ports ثابتة، وتفاصيل dispatcher توليد الوسائط (OD_BIN و OD_DAEMON_URL)، راجع QUICKSTART.md على GitHub.
المنصات · v0.5.0
ثلاث منصات، ثلاث حالات.
0.5.0 صريح بشأن موقع كل منصة. اختر السطر الذي يطابق جهازك.
| المنصة | الحالة | ملاحظات |
|---|---|---|
| macOS | مستقر | Apple Silicon (arm64) فقط — لا build لـ Intel. macOS 11 Big Sur أو أحدث. |
| Windows | مستقر · بلا توقيع | x64، Windows 10 / 11. SmartScreen يحذّر عند أول إقلاع — اختر More info → Run anyway. |
| Linux | Headless فقط | دورة حياة CLI من الدرجة الأولى (install / start / stop) هبطت في 0.5.0. لا حزمة GUI بعد — تناسب servers و CI. راجع أدناه. |
Linux · بلا واجهة
شغّل Open Design على server بلا DISPLAY.
v0.5.0 يأتي بمسار دورة حياة لا-رسومي. شغّل daemon و web على صندوق Linux headless، ثم اضرب عليه من متصفح لابتوبك. نفس الـ backend، بلا shell Electron في الأمام.
pnpm install
pnpm tools-pack linux install --headless # إعداد لمرة واحدة
pnpm tools-pack linux start --headless # daemon + web، بلا Electron
pnpm tools-pack linux stop --headless
pnpm tools-pack linux logs # tail لـ log الـ headlessحزم apt وأذونات namespace وملاحظة FUSE موثّقة في tools/pack/README.md. تم التحقق على Ubuntu 24.04 و Arch Linux. هبط في 0.5.0 عبر PR #686.
استضافة ذاتية · v0.5.0
أو شغّله كـ container واحد.
v0.5.0 يأتي بمسار Docker Compose رسمي. image واحد من Alpine (docker.io/vanjayak/open-design). الـ daemon يُقدّم API و Next.js static export المبني — بلا nginx منفصل، بلا container frontend منفصل.
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose pull
OPEN_DESIGN_IMAGE=docker.io/vanjayak/open-design:latest docker compose up -d --no-build
# → http://127.0.0.1:7456الافتراضي: مربوط بـ 127.0.0.1:7456، حد ذاكرة 384 MB، runtime volume في /app/.od. لا تنشر daemon على واجهة عامة كما هو — الـ API غير موثّق للعملاء غير المتصفح. ضع أمامه reverse proxy موثّق أو tunnel SSH أو VPN. الوثائق الكاملة: deploy/README.md. الـ image لا يُرفق CLIs لـ Claude / Codex / Gemini عمداً — احتفظ بها خارج الـ container.
الآن ماذا؟
اختر شيئاً لرسمه.
بمجرد أن يعمل daemon، تحتاج skill (ماذا تصنع)، design system (كيف يبدو)، ومن المثالي مرجعاً لكيف يبدو الجيد.