DeepSeek Harness: أوضاع التشغيل الأربعة

🤖 Agent: 
🔍 استخدام أداة: search
  → البحث عن src/utils/format.ts

🔍 استخدام أداة: file_edit (قراءة)
  → قراءة src/utils/format.ts

📝 استخدام أداة: file_edit (إنشاء)
  → إنشاء src/utils/date-format.ts

📝 استخدام أداة: file_edit (تعديل)
  → تحديث src/utils/format.ts (إزالة دوال التاريخ)

📝 استخدام أداة: file_edit (تعديل)
  → تحديث الاستيرادات في src/index.ts

✅ تم! دالة تنسيق التاريخ مستخرجة إلى src/utils/date-format.ts

👤 Bob: أضف نظام مصادقة مستخدمين للمشروع، يدعم JWT

🤖 Agent (مرحلة التخطيط):
📋 خطة التنفيذ:
  1. تثبيت التبعيات: jsonwebtoken، bcryptjs
  2. إنشاء src/auth/jwt.ts — توقيع والتحقق من JWT
  3. إنشاء src/auth/middleware.ts — وسيط المصادقة
  4. إنشاء src/routes/auth.ts — مسارات تسجيل الدخول/التسجيل
  5. تعديل src/app.ts — تسجيل المسارات والوسيط
  6. إضافة متغير بيئة JWT_SECRET

التقدير: 5 ملفات معدلة، 3 ملفات منشأة.
هل تنفذ هذه الخطة؟

👤 Bob: نفّذ، لكن تخطَّ الخطوة 1 — التبعيات مثبتة بالفعل

🤖 Agent (مرحلة التنفيذ):
📝 الخطوة 2: إنشاء src/auth/jwt.ts...
📝 الخطوة 3: إنشاء src/auth/middleware.ts...
📝 الخطوة 4: إنشاء src/routes/auth.ts...
📝 الخطوة 5: تعديل src/app.ts...
📝 الخطوة 6: إضافة JWT_SECRET إلى .env.example...

✅ تمت إضافة نظام المصادقة!

interface PTCPlan {
  steps: PlanStep[];
  estimatedFiles: { created: number; modified: number; deleted: number };
  riskLevel: 'low' | 'medium' | 'high';
  reversible: boolean;
}

interface PlanStep {
  id: number;
  description: string;
  tool: string;           // الأداة المستخدمة
  files: string[];        // الملفات المعنية
  dependsOn: number[];    // الخطوات المسبقة
}

🤖 Agent: 
Promise هو تمثيل كائن للعمليات غير المتزامنة؛ async/await هو سكر نحوي لـ Promises:

1. Promise يستخدم تسلسل .then():
   fetchData().then(data => process(data)).catch(err => handle(err));

2. async/await يستخدم بنية تبدو متزامنة:
   const data = await fetchData();
   process(data);

الاختلافات الرئيسية:
- Promise هو كائن؛ async/await هو بنية
- await يمكن استخدامه فقط داخل دوال async
- دوال async تُرجع دائمًا Promises
- معالجة الأخطاء: .catch() مقابل try/catch

👤 Alice: صمم لي صفحة 404 فريدة

🤖 Agent: 
🎨 سأصمم صفحة 404 تفاعلية — باستخدام Canvas لرسم حقل كويكبات حيث يمكن للمستخدمين تحريك الفأرة لتجنب النيازك!

📝 استخدام أداة: file_edit (إنشاء)
  → إنشاء src/pages/404.html

🎨 الميزات:
- خلفية نجوم ديناميكية معروضة بـ Canvas
- تحريك سفينة فضائية بالفأرة
- توليد نيازك عشوائي واكتشاف التصادم
- صعوبة متزايدة مع الوقت
- بعد التصادم، يعرض "You found 404!" ويعيد التوجيه للرئيسية

🔧 أفكار إضافية:
- إضافة مؤثرات صوتية باستخدام Web Audio API
- دعم اللمس للأجهزة المحمولة
- لوحة صدارة (localStorage)

شريط التحكم العلوي → قائمة الوضع المنسدلة → اختر الوضع المستهدف

# التحديد عند التشغيل
npx @deepseek-ai/dsh cli --mode ptc

# التبديل خلال الجلسة
/mode creative

# dsh.config.yaml
default_mode: ptc

مرحلة تخطيط المشروع → وضع PTC (خطط أولاً)
  ↓
مرحلة التنفيذ → وضع Standard (تنفيذ مستقل)
  ↓
استكشاف الأخطاء → وضع Minimal (أسئلة وأجوبة سريعة)
  ↓
تصميم UI → وضع Creative (استكشاف أفكار)

interface ModeConfig {
  name: string;
  allowTools: boolean;
  requirePlan: boolean;
  temperature: number;
  maxToolCalls: number | null;
  systemPromptExtra: string;
}

const MODES: Record<string, ModeConfig> = {
  standard: {
    name: 'standard',
    allowTools: true,
    requirePlan: false,
    temperature: 0.7,
    maxToolCalls: null,
    systemPromptExtra: 'You have full autonomy to use tools as needed.'
  },
  ptc: {
    name: 'ptc',
    allowTools: true,
    requirePlan: true,
    temperature: 0.3,
    maxToolCalls: null,
    systemPromptExtra: 'Always create a plan first. Do not execute until the user confirms.'
  },
  minimal: {
    name: 'minimal',
    allowTools: true,
    requirePlan: false,
    temperature: 0.2,
    maxToolCalls: 1,
    systemPromptExtra: 'Minimize tool usage. Prefer answering from knowledge.'
  },
  creative: {
    name: 'creative',
    allowTools: true,
    requirePlan: false,
    temperature: 1.0,
    maxToolCalls: null,
    systemPromptExtra: 'Be creative, explore unusual approaches, think beyond the obvious.'
  }
};

وضع Standard يُلحق:
"Use tools freely when they help accomplish the task."

وضع PTC يُلحق:
"Before any action, output a numbered plan. Wait for user confirmation before executing."

وضع Minimal يُلحق:
"Answer from your knowledge first. Only use tools when absolutely necessary."

وضع Creative يُلحق:
"Think creatively and explore novel approaches. Offer additional ideas beyond the request."