DeepSeek Harness: الاستخدام الأول

┌──────────────────────────────────────────────────┐
│ [Standard ▼]  [deepseek-chat ▼]  ⚙️  📋  ❓  │
└──────────────────────────────────────────────────┘
   ↑اختيار الوضع   ↑اختيار النموذج   ↑الإعدادات ↑السجلات ↑المساعدة

┌─────────────────────────────────────────┐
│ 👤 Alice                                │
│ ساعدني في تحليل بنية المشروع            │
│ في الدليل الحالي                        │
├─────────────────────────────────────────┤
│ 🤖 Agent                                │
│ 🔍 استخدام أداة: search                 │
│   → البحث في /home/alice/project...     │
│ ✅ وُجد 15 ملفًا                        │
│                                         │
│ هذا المشروع تطبيق Express.js.           │
│ البنية الرئيسية:                        │
│ - src/routes/ — تعريفات المسارات        │
│ - src/models/ — نماذج البيانات          │
│ - src/middleware/ — الوسائط              │
└─────────────────────────────────────────┘

# مساحة العمل تحدد "مجال رؤية" Agent
/home/alice/project     ← Agent يمكنه رؤية الملفات في هذا الدليل فقط
├── src/
├── package.json
└── README.md

📂 اختر مساحة العمل
┌──────────────────────────────────────┐
│ ○ /home/alice/project               │
│ ○ /home/alice/another-repo          │
│ ● أدخل مسارًا مخصصًا...              │
└──────────────────────────────────────┘

# تعيين مساحة العمل مسبقًا عبر متغير بيئة
export DSH_WORKSPACE="/home/alice/my-project"

# أو في واجهة الويب: الإعدادات → مساحة العمل → تغيير

Placeholder for user input

🤖 Agent: سأساعدك في تحليل هذا المشروع.

🔍 استخدام أداة: search
  → نمط: *
  → المسار: /home/alice/project
  → أقصى عمق: 3

🔍 استخدام أداة: file_edit (قراءة)
  → الملف: package.json
  → الإجراء: قراءة

📊 نتائج التحليل:

1. حزمة التقنيات:
   - بيئة التشغيل: Node.js 20.x
   - الإطار: Express 4.18
   - قاعدة البيانات: PostgreSQL (pg 8.12)
   - الاختبار: Jest 29.x

2. بنية الدليل:
   src/
   ├── routes/    — 8 ملفات مسارات
   ├── models/    — 5 نماذج بيانات
   ├── middleware/ — 3 وسائط
   └── utils/     — دوال مساعدة

3. اقتراحات:
   - تعريفات أنواع TypeScript مفقودة
   - يُنصح بإضافة طبقة src/services/ لفصل منطق الأعمال

│                                      │
│ 🔍 search                            │
│ ├─ الحالة: ✅ مكتمل               │
│ ├─ المدة: 0.3ث                    │
│ └─ الملفات الموجودة: 23                   │
│                                      │
│ 📄 file_edit (قراءة)                  │
│ ├─ الحالة: ✅ مكتمل               │
│ ├─ المدة: 0.1ث                    │
│ └─ الملف: package.json (1.2KB)        │
│                                      │
│ 📊 إجمالي الأدوات: 2                    │
│ 📊 إجمالي الوقت: 0.4ث                  │
└──────────────────────────────────────┘

// كود زائف لمسار تنفيذ الأدوات
async function executeTool(tool, params) {
  // 1. pre-execute: التحقق + الموافقة
  await preExecute(tool, params);
  
  // 2. execute: التنفيذ الفعلي
  const result = await tool.execute(params);
  
  // 3. post-execute: تسجيل السجلات
  await postExecute(tool, params, result);
  
  return result;
}

┌─ ⚠️ الموافقة مطلوبة ───────────────────┐
│                                            │
│ Agent يريد:                            │
│ 📝 تعديل ملف: src/index.ts                 │
│                                            │
│ التغييرات:                                   │
│ - سطر 12: إضافة عبارة import            │
│ - سطر 45: تعديل معالج الأخطاء            │
│                                            │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐    │
│ │  ✅ سماح │ │ 🔁 دائمًا│ │  ❌ رفض │    │
│ └──────────┘ └──────────┘ └──────────┘    │
└────────────────────────────────────────────┘

# dsh.config.yaml
approval:
  # قراءة الملفات: السماح دائمًا
  file_read: always
  
  # تعديل الملفات: تتطلب موافقة
  file_edit: ask
  
  # أوامر Shell: بناءً على مستوى الخطورة
  shell:
    safe_commands: always     # ls, cat, grep, إلخ
    unsafe_commands: ask      # rm, chmod, sudo, إلخ
    dangerous_commands: deny  # rm -rf /, dd, إلخ
  
  # عمليات البحث: السماح دائمًا
  search: always

# تعيين وضع Sandbox
export DSH_SANDBOX=strict    # الأكثر أمانًا
export DSH_SANDBOX=permissive # الافتراضي
export DSH_SANDBOX=off        # غير موصى به

👤 Alice: أنشئ health.ts تحت src/routes/، أضف نقطة نهاية GET /health
        تُرجع { status: "ok", timestamp: Date.now() }

🤖 Agent: سأنشئ نقطة نهاية فحص الصحة لك.

📝 استخدام أداة: file_edit
  → الإجراء: إنشاء
  → المسار: src/routes/health.ts
  → المحتوى: 
    import { Router } from 'express';
    const router = Router();
    router.get('/health', (_req, res) => {
      res.json({ status: 'ok', timestamp: Date.now() });
    });
    export default router;

⚠️ الموافقة مطلوبة: إنشاء ملف src/routes/health.ts
  → [Alice نقر سماح]

✅ تم إنشاء الملف: src/routes/health.ts

الآن نحتاج لتسجيل هذا المسار في app.ts:

📝 استخدام أداة: file_edit
  → الإجراء: تعديل
  → المسار: src/app.ts
  → التغييرات: 
    + import healthRouter from './routes/health';
    + app.use('/health', healthRouter);

⚠️ الموافقة مطلوبة: تعديل ملف src/app.ts
  → [Alice نقر سماح]

✅ تم تعديل الملف: src/app.ts

تم! أُضيفت نقطة نهاية فحص الصحة. اختبرها على GET /health.

┌─ لوحة الأدوات ────────────────────────┐
│ 📝 file_edit (إنشاء)                │
│ ├─ المسار: src/routes/health.ts        │
│ ├─ الحالة: ✅ موافق عليه ومكتمل    │
│ └─ المدة: 0.2ث                    │
│                                      │
│ 📝 file_edit (تعديل)                  │
│ ├─ المسار: src/app.ts                  │
│ ├─ التغييرات: +2 سطر                 │
│ ├─ الحالة: ✅ موافق عليه ومكتمل    │
│ └─ المدة: 0.1ث                    │
└──────────────────────────────────────┘

قائمة الجلسات اليسرى → انقر زر + → جلسة جديدة

تُسمى الجلسات تلقائيًا (بناءً على محتوى أول محادثة)، أو يمكن إعادة تسميتها يدويًا.

// كل SessionEvent يُحفظ تلقائيًا
interface SessionEvent {
  type: 'user_message' | 'agent_message' | 'tool_call' | 'tool_result' | 'approval';
  timestamp: number;
  data: Record<string, unknown>;
}