واجهة سطر الأوامر

يتيح لك CLI الخاص بـ Bobcorn إدارة مشاريع خطوط الأيقونات بالكامل من الطرفية. قم بتثبيته من لوحة الإعدادات في تطبيق Bobcorn — انقر على زر تثبيت في قسم "واجهة سطر الأوامر".

bobcorn --version

يكتشف CLI تلقائيًا ملفات المشروع .icp في الدليل الحالي. يمكنك أيضًا تحديد المسار صراحةً. أولوية الحل:

1. وسيطة المسار الصريحة — تُمرر مباشرة إلى الأمر
2. علامة --project — خيار عام لجميع الأوامر
3. الاكتشاف التلقائي — يفحص الدليل الحالي بحثًا عن ملف .icp

# 1. وسيطة المسار الصريحة
bobcorn project inspect my-icons.icp

# 2. علامة --project العامة
bobcorn --project my-icons.icp icon list

# 3. الاكتشاف التلقائي (تشغيل من الدليل الذي يحتوي على ملف .icp)
cd my-project/
bobcorn icon list

افتراضيًا يُخرج CLI نصًا قابلًا للقراءة. أضف --json للحصول على إخراج JSON منظم، مثالي للبرمجة والتكامل مع وكلاء الذكاء الاصطناعي.

هيكل مغلف JSON

كل استجابة JSON تتبع مغلفًا متسقًا:

{
  "ok": true,
  "data": { ... },
  "meta": {
    "command": "icon list",
    "projectPath": "/path/to/project.icp",
    "duration_ms": 42,
    "version": "1.0.0"
  }
}

ثلاث حالات استجابة

إنشاء وفحص وتكوين ملفات المشروع .icp.

# Create a new empty project
bobcorn project create my-icons.icp --name "App Icons"

# Inspect project metadata
bobcorn project inspect

# Set project name / font prefix
bobcorn project set-name "New Name"

# Set font prefix (alias)
bobcorn project set-prefix "MyIcons"

# Save a copy
bobcorn project save-as backup.icp

استيراد وعرض وإعادة تسمية ونقل ونسخ وحذف وتكوين الأيقونات. جميع المراجع تستخدم UUID — استخدم icon list --json لاكتشاف المعرفات.

bobcorn icon import *.svg --group Navigation
bobcorn icon list
bobcorn icon list --group Navigation --json
bobcorn icon rename <id> new-name
bobcorn icon move <id1> <id2> --to "Other Group"
bobcorn icon copy <id> --to "Backup"
bobcorn icon delete <id>
bobcorn icon set-code <id> E100
bobcorn icon replace <id> new-icon.svg
bobcorn icon export-svg <id> --out ./exports
bobcorn icon set-favorite <id>
bobcorn icon set-favorite <id> --off
bobcorn icon set-color <id> --from "#000" --to "#333"
bobcorn icon get-content <id>

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

bobcorn group list
bobcorn group add "New Category"
bobcorn group rename "Old Name" "New Name"
bobcorn group delete "Empty Group"
bobcorn group reorder Navigation Actions Settings
bobcorn group set-description Navigation "Main nav icons"
bobcorn group move-icons Navigation <id1> <id2>

إنشاء ملفات الخطوط وتصدير SVG. يدعم SVG وTTF وWOFF وWOFF2 وEOT مع ملفات CSS وJS اختيارية.

bobcorn export font --out ./dist --formats woff2,ttf
bobcorn export font --out ./dist --font-name "MyIcons" --css --js
bobcorn export svg --out ./svg-icons
bobcorn export svg --out ./svg-icons --group Navigation

ابحث عن الأيقونات بالاسم وأدر المفضلات المحفوظة.

bobcorn search "arrow"
bobcorn search "home" --group Navigation --limit 10
bobcorn favorite list

إدارة متغيرات الوزن والمقياس للأيقونات (نمط SF Symbols). يتطلب إنشاء المتغيرات واجهة Bobcorn الرسومية، لكن يمكنك عرض وحذف المتغيرات من CLI.

bobcorn variant list <id>
bobcorn variant delete <id>

صُمم CLI الخاص بـ Bobcorn للعمل بسلاسة مع وكلاء البرمجة بالذكاء الاصطناعي مثل Claude Code وCodex وCursor وغيرها. استخدم --json للحصول على إخراج منظم يمكن للوكلاء تحليله بشكل موثوق.

المبادئ الأساسية

• كل أمر يدعم --json للإخراج القابل للقراءة آليًا
• مغلف JSON متسق عبر جميع الأوامر — يمكن للوكلاء الاعتماد على بنية ok / error / data
• الاكتشاف التلقائي يعني أن الوكلاء يمكنهم ببساطة cd إلى دليل المشروع وتشغيل الأوامر بدون تحديد مسارات
• رموز الخطأ قابلة للتنبؤ: ICON_NOT_FOUND وGROUP_NOT_FOUND وFILE_IO_ERROR إلخ.

مثال سير عمل الوكيل

bobcorn project create app-icons.icp --name "MyApp" --json
bobcorn icon import ./design/*.svg --json
bobcorn group add "Navigation" --json
bobcorn group add "Actions" --json
NAV_IDS=$(bobcorn search "nav" --json | jq -r '.data[].id')
bobcorn icon move $NAV_IDS --to "Navigation" --json
bobcorn export font --out ./src/fonts --formats woff2 --json

إليك سكريبت bash كامل يوضح سير عمل نموذجي:

#!/bin/bash
set -e

bobcorn project create my-app-icons.icp --name "MyApp"
bobcorn icon import ./design/icons/*.svg
bobcorn group add "Navigation"
bobcorn group add "Actions"
bobcorn group add "Status"

NAV_ICONS=$(bobcorn search "nav" --json | jq -r '.data[].id')
for id in $NAV_ICONS; do
  bobcorn icon move "$id" --to "Navigation"
done

bobcorn group reorder Navigation Actions Status
bobcorn export font --out ./src/fonts --formats woff2 --css
bobcorn export svg --out ./docs/icons

echo "تم! ملفات الخطوط في ./src/fonts"