أدوات الأوامر النصية: دليل شامل لتطبيق سطح المكتب لإدارة أوامر الذكاء الاصطناعي

⏱️ وقت القراءة المتوقع: 15 دقيقة

مقدمة عن أدوات الأوامر النصية

في عصر سير العمل المدعوم بالذكاء الاصطناعي، أصبحت إدارة الأوامر النصية (البرومبت) بكفاءة أمرًا بالغ الأهمية للإنتاجية. أدوات الأوامر النصية هو تطبيق سطح مكتب مبتكر مصمم لتبسيط سير عمل إدارة الأوامر النصية. مبني باستخدام Tauri، يوفر هذا الأداة القوية تجربة سريعة وآمنة ومتعددة المنصات لتنظيم أوامر الذكاء الاصطناعي الخاصة بك.

ما يجعل أدوات الأوامر النصية مميزة؟

• نهج محلي أولاً: جميع بياناتك تبقى على جهاز الكمبيوتر الخاص بك، مما يضمن الخصوصية والأمان
• دعم متعدد المنصات: يدعم حاليًا نظام macOS مع قدوم دعم Windows و Linux قريبًا
• سرعة البرق: مبني باستخدام Rust وتقنيات الويب الحديثة للحصول على أداء مثالي
• مفتوح المصدر: مشروع مرخص بترخيص MIT يشجع مساهمات المجتمع

فهم مجموعة التقنيات

تستفيد أدوات الأوامر النصية من التقنيات المتطورة لتقديم أداء استثنائي:

تقنيات الواجهة الأمامية

• TypeScript: يوفر أمان النوع وتجربة أفضل للمطورين
• Vite: أداة بناء فائقة السرعة لتطوير الويب الحديث
• React: مكتبة واجهة مستخدم شائعة لبناء واجهات تفاعلية

الخلفية والتقنيات الأساسية

• Rust: لغة برمجة نظم آمنة الذاكرة تضمن الأمان والأداء
• Tauri: إطار عمل حديث لبناء تطبيقات سطح المكتب بتقنيات الويب
• SQLite: قاعدة بيانات خفيفة بدون خادم للتخزين المحلي للبيانات

إدارة الحزم

• pnpm: مدير حزم سريع وفعال في استخدام مساحة القرص

متطلبات النظام والمتطلبات المسبقة

قبل أن نبدأ، تأكد من أن نظامك يلبي المتطلبات التالية:

البرامج المطلوبة

• Node.js: الإصدار 18 أو أحدث
• pnpm: أحدث إصدار
• Rust & Cargo: أحدث إصدار مستقر
• تبعيات Tauri: متطلبات خاصة بكل منصة

متطلبات خاصة بنظام macOS

• macOS 10.15 أو أحدث
• أدوات سطر أوامر Xcode
• إطار عمل WebKit (عادة ما يكون مثبتًا مسبقًا)

دليل التثبيت والإعداد

الخطوة 1: استنساخ المستودع

# استنساخ مستودع أدوات الأوامر النصية
git clone https://github.com/jwangkun/Prompt-Tools.git
cd Prompt-Tools

الخطوة 2: تثبيت التبعيات

# تثبيت تبعيات Node.js باستخدام pnpm
pnpm install

هذا الأمر سيثبت جميع التبعيات الضرورية المحددة في ملف package.json.

الخطوة 3: إعداد بيئة Rust

إذا لم تكن قد ثبت Rust بعد، اتبع هذه الخطوات:

# تثبيت Rust باستخدام rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# إعادة تحميل الشل أو مصدر البيئة
source ~/.cargo/env

# تثبيت Tauri CLI
cargo install tauri-cli

الخطوة 4: تثبيت تبعيات Tauri

لنظام macOS، تأكد من وجود تبعيات النظام المطلوبة:

# تثبيت أدوات سطر أوامر Xcode إذا لم تكن مثبتة بالفعل
xcode-select --install

سير عمل التطوير

التشغيل في وضع التطوير

لبدء التطبيق في وضع التطوير مع إعادة التحميل السريع:

# بدء خادم التطوير
pnpm tauri:dev

هذا الأمر سيقوم بما يلي:

1. بناء تطبيق React الأمامي
2. بدء خادم تطوير Tauri
3. تشغيل تطبيق سطح المكتب
4. تمكين إعادة التحميل السريع لتغييرات الواجهة الأمامية والخلفية

فهم هيكل المشروع

Prompt-Tools/
├── src/                    # تطبيق React الأمامي
│   ├── components/         # مكونات React
│   ├── hooks/             # خطافات React المخصصة
│   ├── utils/             # دوال الأدوات
│   └── App.tsx            # مكون التطبيق الرئيسي
├── src-tauri/             # خلفية Tauri
│   ├── src/               # كود مصدر Rust
│   ├── Cargo.toml         # تبعيات Rust
│   └── tauri.conf.json    # إعدادات Tauri
├── package.json           # تبعيات Node.js
└── vite.config.ts         # إعدادات Vite

تحليل مفصل للميزات الأساسية

نظام إدارة الأوامر النصية

يوفر التطبيق قدرات شاملة لإدارة الأوامر النصية:

إنشاء الأوامر النصية

• محرر نص غني: إنشاء أوامر نصية مع دعم التنسيق
• نظام التصنيف: تنظيم الأوامر النصية في فئات مخصصة
• نظام العلامات: إضافة علامات متعددة لتحسين القابلية للبحث
• إدارة الإصدارات: تتبع التغييرات والحفاظ على تاريخ الأوامر النصية

البحث والتنظيم

• البحث في النص الكامل: العثور على الأوامر النصية بسرعة باستخدام الكلمات المفتاحية
• الترشيح المبني على العلامات: ترشيح الأوامر النصية حسب العلامات أو الفئات
• نظام المفضلة: وضع علامة على الأوامر النصية المستخدمة بكثرة كمفضلة
• التصدير/الاستيراد: مشاركة الأوامر النصية مع أعضاء الفريق أو نسخ احتياطي للبيانات

التخزين المحلي للبيانات

تستخدم أدوات الأوامر النصية SQLite للتخزين المحلي للبيانات، مما يضمن:

• الخصوصية: لا تغادر البيانات جهاز الكمبيوتر الخاص بك
• السرعة: أداء استعلام سريع لمجموعات الأوامر النصية الكبيرة
• الموثوقية: امتثال ACID وسلامة البيانات
• قابلية النقل: نسخ احتياطي وهجرة سهلة

بناء التطبيق

إنشاء بناءات الإنتاج

لبناء التطبيق للتوزيع:

# بناء نسخة الإنتاج
pnpm tauri:build

هذه العملية ستقوم بما يلي:

1. تحسين كود الواجهة الأمامية للإنتاج
2. تصريف خلفية Rust
3. إنشاء حزم خاصة بالمنصة
4. توليد حزم التثبيت

مخرجات البناء

بعد البناء، ستجد المخرجات في:

• الملف التنفيذي: src-tauri/target/release/
• حزم التثبيت: src-tauri/target/release/bundle/

بناءات خاصة بالمنصة

لنظام macOS، تنشئ عملية البناء:

• حزمة .app: حزمة تطبيق macOS قياسية
• صورة .dmg: صورة قرص للتوزيع السهل
• ثنائي عالمي: يدعم كل من معالجات Intel و Apple Silicon

الإعدادات المتقدمة

تخصيص إعدادات Tauri

حرر src-tauri/tauri.conf.json للتخصيص:

{
  "package": {
    "productName": "أدوات الأوامر النصية",
    "version": "1.0.0"
  },
  "tauri": {
    "allowlist": {
      "all": false,
      "fs": {
        "all": false,
        "writeFile": true,
        "readFile": true
      }
    },
    "windows": [
      {
        "title": "أدوات الأوامر النصية",
        "width": 1200,
        "height": 800,
        "minWidth": 800,
        "minHeight": 600
      }
    ]
  }
}

متغيرات البيئة

أنشئ ملف .env لإعدادات التطوير:

# متغيرات بيئة التطوير
VITE_APP_NAME=أدوات الأوامر النصية
VITE_APP_VERSION=1.0.0
TAURI_DEBUG=true

اعتبارات الأمان

حماية البيانات المحلية

• جميع الأوامر النصية مخزنة محليًا باستخدام SQLite
• لا توجد طلبات شبكة للوظائف الأساسية
• بيانات المستخدم تبقى تحت السيطرة الكاملة للمستخدم

الاتصال الآمن

• يوفر Tauri اتصالاً آمنًا بين الواجهة الأمامية والخلفية
• حماية مدمجة ضد هجمات XSS والحقن
• بيئة تنفيذ في صندوق رملي

تحسين الأداء

تحسينات الواجهة الأمامية

• تقسيم الكود: تحميل مكونات بطريقة كسولة لبدء تشغيل أسرع
• التذكير: تحسين إعادة العرض في React
• التمرير الافتراضي: معالجة فعالة لمجموعات الأوامر النصية الكبيرة

تحسينات الخلفية

• فهرسة قاعدة البيانات: تحسين أداء استعلامات البحث
• إدارة الذاكرة: نظام الملكية في Rust يمنع تسريب الذاكرة
• العمليات غير المتزامنة: I/O غير محجوب لاستجابة أفضل

الاختبار وضمان الجودة

تشغيل الاختبارات

# تشغيل اختبارات الواجهة الأمامية
pnpm test

# تشغيل اختبارات Rust
cd src-tauri
cargo test

سكريبت اختبار macOS

إليك سكريبت اختبار شامل لنظام macOS يتحقق من عملية الإعداد والبناء بالكامل:

#!/bin/bash
# الملف: test-prompt-tools-macos.sh
# سكريبت اختبار macOS شامل لأدوات الأوامر النصية

set -e  # الخروج عند حدوث أي خطأ

echo "🚀 بدء تشغيل سكريبت اختبار أدوات الأوامر النصية لنظام macOS"
echo "=============================================="

# فحص متطلبات النظام
echo "📋 فحص متطلبات النظام..."

# فحص إصدار macOS
if [[ $(sw_vers -productVersion | cut -d. -f1,2) < "10.15" ]]; then
    echo "❌ خطأ: يتطلب macOS 10.15 أو أحدث"
    exit 1
fi
echo "✅ إصدار macOS: $(sw_vers -productVersion)"

# فحص أدوات سطر أوامر Xcode
if ! command -v xcode-select &> /dev/null || ! xcode-select -p &> /dev/null; then
    echo "⚠️  تثبيت أدوات سطر أوامر Xcode..."
    xcode-select --install
    echo "يرجى إكمال تثبيت Xcode وتشغيل هذا السكريبت مرة أخرى"
    exit 1
fi
echo "✅ أدوات سطر أوامر Xcode مثبتة"

# فحص Node.js
if ! command -v node &> /dev/null; then
    echo "❌ Node.js غير موجود. يرجى تثبيت Node.js 18+"
    exit 1
fi

NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
if [ "$NODE_VERSION" -lt 18 ]; then
    echo "❌ تم العثور على Node.js إصدار $NODE_VERSION. مطلوب إصدار 18+"
    exit 1
fi
echo "✅ إصدار Node.js: $(node -v)"

# فحص pnpm
if ! command -v pnpm &> /dev/null; then
    echo "⚠️  تثبيت pnpm..."
    npm install -g pnpm
fi
echo "✅ إصدار pnpm: $(pnpm -v)"

# فحص Rust
if ! command -v rustc &> /dev/null; then
    echo "⚠️  تثبيت Rust..."
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
    source ~/.cargo/env
fi
echo "✅ إصدار Rust: $(rustc --version)"

# فحص Cargo
if ! command -v cargo &> /dev/null; then
    echo "❌ Cargo غير موجود. يرجى التأكد من تثبيت Rust بشكل صحيح"
    exit 1
fi
echo "✅ إصدار Cargo: $(cargo --version)"

# فحص Tauri CLI
if ! command -v cargo-tauri &> /dev/null; then
    echo "⚠️  تثبيت Tauri CLI..."
    cargo install tauri-cli
fi
echo "✅ Tauri CLI مثبت"

echo ""
echo "🔄 إعداد أدوات الأوامر النصية..."

# إنشاء دليل الاختبار
TEST_DIR="$HOME/prompt-tools-test"
rm -rf "$TEST_DIR"
mkdir -p "$TEST_DIR"
cd "$TEST_DIR"

# استنساخ المستودع
echo "📥 استنساخ مستودع أدوات الأوامر النصية..."
git clone https://github.com/jwangkun/Prompt-Tools.git
cd Prompt-Tools

# تثبيت التبعيات
echo "📦 تثبيت التبعيات..."
pnpm install

# تشغيل الفحص
echo "🔍 تشغيل فحوصات جودة الكود..."
if pnpm run lint --if-present; then
    echo "✅ الفحص نجح"
else
    echo "⚠️  تم العثور على مشاكل في الفحص"
fi

# تشغيل فحص الأنواع
if pnpm run type-check --if-present; then
    echo "✅ فحص الأنواع نجح"
else
    echo "⚠️  تم العثور على مشاكل في فحص الأنواع"
fi

# تشغيل الاختبارات
echo "🧪 تشغيل الاختبارات..."
if pnpm test --if-present; then
    echo "✅ اختبارات الواجهة الأمامية نجحت"
else
    echo "⚠️  فشلت بعض اختبارات الواجهة الأمامية"
fi

# اختبار مكونات Rust
echo "🦀 اختبار مكونات Rust..."
cd src-tauri
if cargo test; then
    echo "✅ اختبارات Rust نجحت"
else
    echo "⚠️  فشلت بعض اختبارات Rust"
fi
cd ..

# اختبار بناء التطوير
echo "🔨 اختبار بناء التطوير..."
timeout 60s pnpm tauri:dev &
DEV_PID=$!
sleep 10

if ps -p $DEV_PID > /dev/null; then
    echo "✅ خادم التطوير بدأ بنجاح"
    kill $DEV_PID 2>/dev/null || true
else
    echo "❌ فشل في بدء خادم التطوير"
fi

# اختبار بناء الإنتاج
echo "🏗️  اختبار بناء الإنتاج..."
if pnpm tauri:build; then
    echo "✅ بناء الإنتاج نجح"
    
    # فحص مخرجات البناء
    if [ -d "src-tauri/target/release/bundle" ]; then
        echo "✅ تم إنشاء مخرجات البناء:"
        find src-tauri/target/release/bundle -name "*.app" -o -name "*.dmg" | head -5
    fi
else
    echo "❌ فشل بناء الإنتاج"
fi

# التنظيف
echo "🧹 تنظيف دليل الاختبار..."
cd "$HOME"
rm -rf "$TEST_DIR"

echo ""
echo "🎉 اكتمل اختبار أدوات الأوامر النصية لنظام macOS!"
echo "======================================"
echo "تم اختبار جميع المكونات الرئيسية."
echo "يمكنك الآن المتابعة مع التطوير أو النشر."

تشغيل سكريبت الاختبار

لتشغيل سكريبت الاختبار الشامل:

# تحميل وتشغيل سكريبت الاختبار
curl -sSL https://raw.githubusercontent.com/jwangkun/Prompt-Tools/main/test-prompt-tools-macos.sh | bash

# أو إنشاء السكريبت محلياً وتشغيله
chmod +x test-prompt-tools-macos.sh
./test-prompt-tools-macos.sh

أدوات جودة الكود

يتضمن المشروع عدة أدوات لضمان الجودة:

# فحص كود TypeScript
pnpm lint

# تنسيق الكود
pnpm format

# فحص الأنواع
pnpm type-check

استكشاف المشاكل الشائعة وإصلاحها

فشل البناء

المشكلة: فشل بناء Tauri بسبب تبعيات مفقودة الحل: تأكد من تثبيت جميع تبعيات النظام:

# macOS: تثبيت أدوات سطر أوامر Xcode
xcode-select --install

# التحقق من تثبيت Rust
rustc --version
cargo --version

المشكلة: مشاكل توافق إصدار Node.js الحل: استخدم Node Version Manager (nvm):

# تثبيت واستخدام Node.js 18
nvm install 18
nvm use 18

مشاكل وقت التشغيل

المشكلة: التطبيق لا يبدأ الحل: فحص تبعيات التطوير:

# إعادة تثبيت التبعيات
rm -rf node_modules
pnpm install

# مسح ذاكرة التخزين المؤقت لـ Tauri
rm -rf src-tauri/target

المساهمة في المشروع

إعداد التطوير للمساهمين

1. تفريع المستودع: إنشاء تفريعك الخاص على GitHub
2. إنشاء فرع الميزة: git checkout -b feature/amazing-feature
3. اتباع معايير الكود: استخدام أدوات الفحص والتنسيق المقدمة
4. كتابة الاختبارات: تضمين اختبارات للوظائف الجديدة
5. تقديم طلب السحب: وصف التغييرات بوضوح

إرشادات أسلوب الكود

// استخدام TypeScript لأمان الأنواع
interface PromptData {
  id: string;
  title: string;
  content: string;
  tags: string[];
  category: string;
  createdAt: Date;
  updatedAt: Date;
}

// اتباع مبادئ البرمجة الوظيفية
const filterPromptsByTag = (prompts: PromptData[], tag: string): PromptData[] => {
  return prompts.filter(prompt => prompt.tags.includes(tag));
};

خارطة الطريق المستقبلية

الميزات القادمة

• دعم Windows و Linux: توسيع توافق المنصات
• المزامنة السحابية: مزامنة سحابية اختيارية للتعاون الجماعي
• نظام المكونات الإضافية: هندسة قابلة للتوسيع للوظائف المخصصة
• تكامل الذكاء الاصطناعي: تكامل مباشر مع خدمات الذكاء الاصطناعي الشائعة

تحسينات الأداء

• تحسين قاعدة البيانات: فهرسة محسنة وأداء استعلام
• استخدام الذاكرة: تحسين إضافي لاستهلاك الذاكرة
• وقت البدء: تقليل وقت تشغيل التطبيق

أفضل الممارسات لإدارة الأوامر النصية

تنظيم أوامرك النصية

1. استخدام عناوين وصفية: جعل الأوامر النصية سهلة التعرف عليها
2. وضع علامات متسقة: تطوير نظام علامات والالتزام به
3. التنظيف المنتظم: إزالة الأوامر النصية القديمة أو غير المستخدمة
4. إدارة الإصدارات: تتبع تطور الأوامر النصية

نصائح سير العمل الفعال

• اختصارات لوحة المفاتيح: تعلم واستخدام اختصارات لوحة المفاتيح للتنقل الأسرع
• تحسين البحث: استخدام كلمات مفتاحية محددة في عناوين وعلامات الأوامر النصية
• استراتيجية النسخ الاحتياطي: تصدير مجموعة الأوامر النصية بانتظام
• إنشاء القوالب: تطوير قوالب أوامر نصية قابلة لإعادة الاستخدام

الخلاصة

تمثل أدوات الأوامر النصية تقدمًا كبيرًا في إدارة أوامر الذكاء الاصطناعي، وتوفر حلاً قويًا وآمنًا وفعالًا لتنظيم أصولك الإبداعية. سواء كنت مطورًا أو منشئ محتوى أو متحمسًا للذكاء الاصطناعي، فإن تطبيق سطح المكتب هذا يوفر الأدوات المطلوبة لتعظيم إنتاجيتك.

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

الخطوات التالية

1. التحميل والتثبيت: ابدأ مع أدوات الأوامر النصية اليوم
2. انضم إلى المجتمع: ساهم في المشروع على GitHub
3. شارك تجربتك: ساعد الآخرين في اكتشاف هذه الأداة القوية
4. ابق محدثًا: تابع المشروع للحصول على ميزات وتحسينات جديدة

انتهى عصر الأوامر النصية المبعثرة وغير المنظمة. مرحبًا بك في مستقبل إدارة الأوامر النصية الذكية مع أدوات الأوامر النصية!

---

المصادر:

• مستودع GitHub
• وثائق Tauri
• وثائق React
• لغة برمجة Rust