/ الدليل / الملعب / obsidian-plugin-skill
← كل الخوادم ↗ GitHub
● مجتمع gapmiss ⚡ فوري

obsidian-plugin-skill

بواسطة gapmiss · gapmiss/obsidian-plugin-skill

مهارة Agent تعلّم Claude كيفية بناء مشغّلات Obsidian — Plugin API و manifest.json وتدفق الإصدار.

obsidian-plugin-skill تحمّل شكل Obsidian Plugin API إلى ذاكرة Claude العاملة: manifest.json و versions.json وهيكل main.ts الأساسي، علامات التبويب للإعدادات، الأوامر، أيقونات الشريط، امتدادات المحرر، وتدفق الإصدار عبر GitHub tag الذي يتوقعه متجر Community الرسمي. مفيد عندما تريد إنشاء نموذج أولي للمشغّل في بعد ظهر واحد.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

obsidian-plugin-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "obsidian-plugin-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "obsidian-plugin-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/gapmiss/obsidian-plugin-skill",
        "~/.claude/skills/obsidian-plugin-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "obsidian-plugin-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/gapmiss/obsidian-plugin-skill",
          "~/.claude/skills/obsidian-plugin-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add obsidian-plugin-skill -- git clone https://github.com/gapmiss/obsidian-plugin-skill ~/.claude/skills/obsidian-plugin-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: obsidian-plugin-skill

كيفية بناء وإصدار مشغّلك الأول على Obsidian

👤 مستخدمو Obsidian المتقدمون الذين يريدون حل مشكلة معينة ⏱ ~120 min intermediate

متى تستخدمه: لديك تحسين سير عمل محدد وتريد مشغّلاً في يوم واحد.

المتطلبات الأساسية
  • Node 18+ — nvm install 18
  • خزينة محلية للاختبار — أنشئ خزينة Obsidian جديدة فقط للتطوير
  • Skill المستنسخة — git clone https://github.com/gapmiss/obsidian-plugin-skill ~/.claude/skills/obsidian-plugin-skill
الخطوات
  1. إنشاء هيكل المشغّل
    أنشئ هيكل مشغّل Obsidian اسمه 'smart-outline' مع أمر وعلامة تبويب إعدادات.✓ تم النسخ
    → مجلد يحتوي على manifest و main.ts وإعدادات البناء
  2. إضافة الميزة
    نفّذ: عند تنفيذ الأمر، افتح نافذة تظهر الخطوط العريضة للملاحظة النشطة.✓ تم النسخ
    → نافذة تعمل تقرأ من MarkdownView النشط
  3. تثبيت واختبار جانبي
    ثبّت في مجلد المشغّلات بخزينة التطوير وأعد تحميل Obsidian.✓ تم النسخ
    → يظهر المشغّل والأمر يعمل
  4. تحضير إصدار
    أنشئ versions.json وضع وسم v0.1.0 للإصدار.✓ تم النسخ
    → إصدار GitHub يحتوي على main.js و manifest.json المرفقة

النتيجة: مشغّل يعمل ويمكن تثبيته يمكنك إرساله إلى متجر Community.

المزالق
  • نسيان versions.json — متجر Community يرفضه — تذكرك Skill؛ احفظها دائماً متوافقة مع manifest.json
  • الرجوع إلى آليات Obsidian الداخلية التي ليست جزءاً من API العام — التزم بـ API العام؛ تعامل مع الآليات الداخلية كغير مستقرة
اجمعها مع: filesystem · github

إضافة علامة تبويب إعدادات صحيحة إلى مشغّل موجود

👤 مؤلفو المشغّلات الموجودة الذين يحسّنون تجربة المستخدم ⏱ ~30 min intermediate

متى تستخدمه: نما مشغّلك وحان الوقت لخيارات قابلة للتكوين من قبل المستخدم.

الخطوات
  1. تصميم الإعدادات
    بناءً على ملف README الخاص بمشغّلي، ما الإعدادات التي يجب أن تكون قابلة للتكوين من قبل المستخدم؟✓ تم النسخ
    → قائمة قصيرة مع الأساس المنطقي
  2. تنفيذ PluginSettingTab
    أضف PluginSettingTab مع تلك الضوابط.✓ تم النسخ
    → واجهة الإعدادات في Obsidian

النتيجة: علامة تبويب إعدادات يمكن للمستخدمين استخدامها فعلياً.

المزالق
  • عدد كبير جداً من الإعدادات — اقطع بلا رحمة — الإعدادات غير المستخدمة هي فوضى

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

obsidian-plugin-skill + filesystem

اقرأ مشغّلاً موجوداً وعزّزه

اقرأ my-plugin/، أضف أمراً جديداً يُصدّر الملاحظة النشطة كـ PDF.✓ تم النسخ
obsidian-plugin-skill + github

أتمتة وضع الوسوم وإنشاء الإصدارات

ضع وسم v0.2.0 وأنشئ إصدار مع الأصول المبنية.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
plugin-scaffolding plugin intent مشغّل جديد 0
feature-authoring feature spec + API surface كل ميزة 0
settings-tab options تحسينات UX 0
release-flow version bump قبل النشر 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا يوجد
الرموز لكل استدعاء
5–20k لكل مشغّل
التكلفة المالية
free
نصيحة
اعمل ميزة تلو الأخرى بدلاً من إلقاء مواصفات مشغّل كاملة على Claude

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: GitHub token للإصدارات (عند الأتمتة)
نقل البيانات الخارجي: لا يوجد على مستوى المهارة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Obsidian doesn't load the plugin

تأكد من صحة manifest.json وأنه في مسار الخزينة الصحيح؛ أعد التحميل عبر Ctrl+R.

تحقق: cat .obsidian/plugins/my-plugin/manifest.json | jq .
Build produces no main.js

شغّل أمر esbuild؛ تحقق من هدف tsconfig.

تحقق: ls main.js

البدائل

obsidian-plugin-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Logseqأنت على Logseq بدلاً من ObsidianAPI مشغّل مختلف

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills