DeepSeek Harness: نشر الإضافات

# ترجمة TypeScript
pnpm build

# تأكيد المخرجات
ls dist/
# index.js  index.d.ts  ...

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

# النشر بعد تحديث الإصدار
npm version patch  # 1.0.0 → 1.0.1
npm publish

# .npmignore
src/
tests/
tsconfig.json
*.tsbuildinfo
.git/
.vscode/

# التثبيت في مشروع آخر
pnpm add @dsh-plugin/my-tool

# التحقق من الاستيراد
node -e "console.log(require('@dsh-plugin/my-tool'))"

{
  "name": "@dsh-plugin/my-tool",
  "version": "1.0.0",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
  "dsh": {
    "name": "my-tool",
    "description": "أداة مخصصة لـ DSH",
    "services": ["tools"],
    "inject": ["tools"],
    "capabilities": [],
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0"
    },
    "permissions": [
      "fs.read",
      "network.outbound"
    ],
    "config": {
      "apiKey": {
        "type": "string",
        "required": true,
        "description": "مفتاح API للخدمة"
      }
    }
  }
}

Repository Settings → Topics → Add topic: dsh-plugin

# بحث عبر GitHub CLI
gh search repos --topic dsh-plugin --sort stars

# بحث ويب GitHub
https://github.com/topics/dsh-plugin

dsh-plugin        ← مطلوب
deepseek-harness  ← اختياري، يزيد القابلية للاكتشاف
نوع الأداة        ← مثلاً: database, search, devops

متى ترفع PATCH:
  - إصلاح خلل في أداة
  - إصلاح مشكلة في التحقق من التكوين
  - تحديث التوثيق

متى ترفع MINOR:
  - إضافة أداة جديدة
  - إضافة خيار تكوين (مع قيمة افتراضية)
  - إضافة تنفيذ قدرة
  - إضافة تبعيات اختيارية

متى ترفع MAJOR:
  - إزالة أداة
  - تغيير صيغة معاملات الأداة
  - إزالة خيار تكوين
  - تغيير قائمة inject
  - تغيير واجهة Capability

# رفع PATCH
npm version patch -m "fix: resolve timeout issue"

# رفع MINOR
npm version minor -m "feat: add batch query tool"

# رفع MAJOR
npm version major -m "breaking: change tool parameter format"

# إصدار alpha
npm version prealpha --preid alpha
# 1.0.0 → 1.1.0-alpha.0

# إصدار beta
npm version prebeta --preid beta
# 1.0.0 → 1.1.0-beta.0

# إصدار RC
npm version prerelease --preid rc
# 1.1.0-beta.0 → 1.1.0-rc.0

{
  "dsh": {
    "compatibility": {
      "dsh": ">=0.5.0",
      "cordis": ">=1.0.0",
      "node": ">=18.0.0"
    }
  },
  "peerDependencies": {
    "@deepseek-ai/dsh": ">=0.5.0",
    "@deepseek-ai/cordis": ">=1.0.0"
  }
}

# فحص مدمج في DSH
dsh plugin check @dsh-plugin/my-tool

# المخرجات
✅ Compatible with dsh@0.5.0
✅ Compatible with cordis@1.0.0
⚠️ Requires Node.js >= 18.0.0 (current: 16.20.0)

# @dsh-plugin/my-tool

> إضافة DSH لـ [وصف الميزة]

## التثبيت

\```bash
dsh plugin add @dsh-plugin/my-tool
\```

## التكوين

\```yaml
plugins:
  '@dsh-plugin/my-tool':
    config:
      apiKey: sk-xxx
      maxRetries: 3
\```

## الأدوات الموفَّرة

| الأداة | الوصف |
|:------|:------|
| `my_tool` | تؤدي شيئًا مفيدًا |

## التبعيات

- DSH >= 0.5.0
- Cordis >= 1.0.0

## الصلاحيات

- fs.read
- network.outbound

### ▶ مثال

\```text
👤 Alice: Analyze project with my_tool

🤖 Agent:
🔧 Using tool: my_tool
  → Result: ...
\```

## الترخيص

MIT

# Changelog

## 1.1.0 (2026-08-20)

### Added
- أداة batch_query للاستعلام عن مسارات متعددة
- خيار التكوين `maxDepth` للتحليل التعاودي

### Fixed
- معالجة المهلة للأدلة الكبيرة

## 1.0.0 (2026-08-01)

### Breaking
- تغيير صيغة المعامل من `dir_path` إلى `path`

### Added
- الإصدار الأولي مع أداة file_info