● مجتمع
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 API (Plugin/Notice/MarkdownView)
- التعامل مع manifest.json و versions.json و minAppVersion
- علامة تبويب الإعدادات + امتدادات المحرر + الأوامر
- تدفق الإصدار عبر GitHub tags لمتجر Community
- هيكل TypeScript و esbuild
عرض مباشر
كيف يبدو في الممارسة
obsidian-plugin-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: obsidian-plugin-skill
متى تستخدمه: لديك تحسين سير عمل محدد وتريد مشغّلاً في يوم واحد.
الخطوات
-
إنشاء هيكل المشغّل
أنشئ هيكل مشغّل Obsidian اسمه 'smart-outline' مع أمر وعلامة تبويب إعدادات.✓ تم النسخ
→ مجلد يحتوي على manifest و main.ts وإعدادات البناء
-
إضافة الميزة
نفّذ: عند تنفيذ الأمر، افتح نافذة تظهر الخطوط العريضة للملاحظة النشطة.✓ تم النسخ
→ نافذة تعمل تقرأ من MarkdownView النشط
-
تثبيت واختبار جانبي
ثبّت في مجلد المشغّلات بخزينة التطوير وأعد تحميل Obsidian.✓ تم النسخ
→ يظهر المشغّل والأمر يعمل
-
تحضير إصدار
أنشئ versions.json وضع وسم v0.1.0 للإصدار.✓ تم النسخ
→ إصدار GitHub يحتوي على main.js و manifest.json المرفقة
النتيجة: مشغّل يعمل ويمكن تثبيته يمكنك إرساله إلى متجر Community.
المزالق
- نسيان versions.json — متجر Community يرفضه — تذكرك Skill؛ احفظها دائماً متوافقة مع manifest.json
- الرجوع إلى آليات Obsidian الداخلية التي ليست جزءاً من API العام — التزم بـ API العام؛ تعامل مع الآليات الداخلية كغير مستقرة
متى تستخدمه: نما مشغّلك وحان الوقت لخيارات قابلة للتكوين من قبل المستخدم.
الخطوات
-
تصميم الإعدادات
بناءً على ملف README الخاص بمشغّلي، ما الإعدادات التي يجب أن تكون قابلة للتكوين من قبل المستخدم؟✓ تم النسخ
→ قائمة قصيرة مع الأساس المنطقي
-
تنفيذ PluginSettingTab
أضف PluginSettingTab مع تلك الضوابط.✓ تم النسخ
→ واجهة الإعدادات في Obsidian
النتيجة: علامة تبويب إعدادات يمكن للمستخدمين استخدامها فعلياً.
المزالق
- عدد كبير جداً من الإعدادات — اقطع بلا رحمة — الإعدادات غير المستخدمة هي فوضى
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
اقرأ مشغّلاً موجوداً وعزّزه
اقرأ my-plugin/، أضف أمراً جديداً يُصدّر الملاحظة النشطة كـ PDF.✓ تم النسخ
obsidian-plugin-skill +
github
أتمتة وضع الوسوم وإنشاء الإصدارات
ضع وسم v0.2.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 بدلاً من Obsidian | API مشغّل مختلف |