DeepSeek Harness: إضافات المجتمع

اسم حزمة npm: @dsh-plugin/plugin-name
اسم مستودع GitHub: dsh-plugin-name
اسم مرجع الإعداد: plugin-name

npm: @dsh-plugin/database    → GitHub: dsh-plugin-database
npm: @dsh-plugin/git-enhanced → GitHub: dsh-plugin-git-enhanced
npm: @dsh-plugin/docker      → GitHub: dsh-plugin-docker

# البحث عن مستودعات بموضوع dsh-plugin
gh repo list --topic dsh-plugin --limit 20

# الترتيب حسب النجوم
gh search repos "dsh-plugin" --sort stars --limit 20

# البحث عن حزم إضافات dsh
npm search @dsh-plugin

# عرض تفاصيل إضافة محددة
npm info @dsh-plugin/database

# التثبيت من npm
dsh plugin add @dsh-plugin/database

# مخرجات التثبيت
📦 Installing @dsh-plugin/database@1.2.0...
✅ Plugin installed successfully!

Available tools:
  - database.query: Execute SQL queries
  - database.migrate: Run database migrations
  - database.schema: Inspect database schema

# التثبيت من مستودع GitHub
dsh plugin add github:alice/dsh-plugin-redis

# تثبيت فرع محدد
dsh plugin add github:alice/dsh-plugin-redis#feature/cluster-support

# تثبيت وسُم إصدار محدد
dsh plugin add github:alice/dsh-plugin-redis#v2.1.0

# عرض الإضافات المثبتة
dsh plugin list

# المخرجات
📦 Installed Plugins:
  @dsh-plugin/database   v1.2.0  ✅ enabled
  @dsh-plugin/redis      v2.1.0  ✅ enabled
  @dsh-plugin/git-enhanced v0.8.0 ⚠️ disabled

# تعطيل إضافة (بدون إلغاء التثبيت)
dsh plugin disable @dsh-plugin/redis

# تفعيل إضافة
dsh plugin enable @dsh-plugin/redis

# إلغاء تثبيت إضافة
dsh plugin remove @dsh-plugin/database

# تحديث إضافة
dsh plugin update @dsh-plugin/database

# dsh.config.yaml
plugins:
  # إضافة npm
  - name: "@dsh-plugin/database"
    version: "^1.2.0"
    enabled: true
    config:
      default_connection: "postgresql://localhost/mydb"
  
  # إضافة GitHub
  - name: "@dsh-plugin/redis"
    source: "github:alice/dsh-plugin-redis"
    version: "v2.1.0"
    enabled: true
    config:
      host: "localhost"
      port: 6379
  
  # إضافة محلية
  - name: "my-custom-tool"
    source: "./plugins/my-custom-tool"
    enabled: true

# dsh.config.yaml
plugins:
  - name: "@dsh-plugin/database"
    config:
      connections:
        main: "postgresql://localhost/myapp"
        analytics: "postgresql://localhost/analytics"

👤 Alice: استعلم عن 10 مستخدمين مسجلين مؤخرًا من جدول users

🤖 Agent:
🔧 استخدام أداة: database.query
  → الاتصال: main
  → الاستعلام: SELECT * FROM users ORDER BY created_at DESC LIMIT 10
  → النتائج: 10 صفوف

👤 Bob: تحقق من جودة الكود في دليل src/

🤖 Agent:
🔧 استخدام أداة: linter.check
  → الدليل: src/
  → الإعداد: .eslintrc.json
  → النتائج: 12 تحذيرًا، 3 أخطاء
  
  الأخطاء:
  - src/utils/format.ts:45 — نوع any غير متوقع
  - src/routes/api.ts:128 — نوع إرجاع مفقود
  - src/models/user.ts:23 — استيراد غير مستخدم

# استنساخ مستودع الإضافة للمراجعة
git clone https://github.com/user/dsh-plugin-example.git
cd dsh-plugin-example

# فحص ملف الإدخال الرئيسي
cat src/index.ts

# فحص التبعيات
cat package.json | grep -A 20 "dependencies"

# البحث عن طلبات شبكة مشبوهة
grep -r "fetch\|http\|axios\|request" src/

# البحث عن عمليات نظام الملفات
grep -r "fs\.\|readFile\|writeFile\|exec\|spawn" src/

# البحث عن وصول متغيرات البيئة
grep -r "process\.env" src/

// تعريف صلاحيات الإضافة
export default definePlugin({
  name: 'dsh-plugin-example',
  permissions: [
    'fs.read',        // قراءة الملفات
    'fs.write',       // كتابة الملفات
    'network.outbound', // طلبات شبكة صادرة
    'shell.execute',  // تنفيذ أوامر Shell
    'env.read'        // قراءة متغيرات البيئة
  ],
  // ...
});

📦 Installing @dsh-plugin/example@1.0.0

⚠️ هذه الإضافة تطلب الصلاحيات التالية:
  ✅ fs.read        — قراءة الملفات في مساحة العمل
  ⚠️ network.outbound — إجراء طلبات HTTP صادرة
  🔴 shell.execute  — تنفيذ أوامر shell

هل تتابع التثبيت؟ (y/n)

# استخدام القالب الرسمي
npx @deepseek-ai/create-dsh-plugin my-plugin

# المخرجات
📁 Creating plugin: my-plugin
  ├── src/
  │   └── index.ts
  ├── package.json
  ├── tsconfig.json
  └── README.md

✅ Plugin scaffolded! Run:
  cd my-plugin
  npm install
  npm run dev

dsh-plugin-my-plugin/
├── src/
│   ├── index.ts          # ملف إدخال الإضافة الرئيسي
│   ├── tools/            # تعريفات الأدوات
│   │   └── my-tool.ts
│   └── services/         # تعريفات الخدمات
│       └── my-service.ts
├── package.json
├── tsconfig.json
├── dsh-plugin.yaml       # بيانات الإضافة الوصفية
└── README.md

# البناء
npm run build

# النشر
npm publish --access public

# إضافة موضوع GitHub
# في إعدادات مستودع GitHub، أضف موضوع: dsh-plugin

name: dsh-plugin-my-plugin
version: 1.0.0
description: تعمّق في نظام إضافات مجتمع DSH — اكتشف وثبّت وأعد وقيّم الإضافات الخارجية، تعلّم أفضل ممارسات إدارة إصدارات الإضافات وتحديث التبعيات
author: "Alice"
license: "MIT"
repository: "https://github.com/alice/dsh-plugin-my-plugin"
keywords:
  - dsh-plugin
  - database
  - tools
permissions:
  - fs.read
  - network.outbound
compatibility:
  dsh: ">=0.5.0"