یکپارچه‌سازی Agent
پیش‌نیاز
Notemd را در خزانهٔ درست فعال و CLI رسمی Obsidian را آماده کنید. خزانه را پیش از فرمان برگزینید. requiredContext: none یعنی یادداشت فعال یا انتخاب لازم نیست، نه اینکه برنامه و خزانه لازم نیست.
obsidian help
obsidian commands filter=notemd
obsidian-cli جداگانه توزیع می‌شود و همان obsidian رسمی نیست. موفقیت یکی وجود دیگری را ثابت نمی‌کند. نبود میزبان یا CLI یعنی یکپارچه‌سازی در دسترس نیست، نه آزمون موفق.
شناسه‌های عمومی
notemd:export-provider-profiles-redactednotemd:export-cli-capability-manifestnotemd:export-cli-invocation-contractnotemd:export-cli-public-surface
ورودی‌ها شیء خالی و نگاشت شناسه‌ها دقیق است. فرمان‌ها غیرتعاملی‌اند و خروجی را در پوشهٔ تنظیم افزونه ایجاد یا جایگزین می‌کنند.
کشف، خروجی و بررسی
از سطح عمومی شروع کنید:
obsidian command id=notemd:export-cli-public-surface
obsidian command id=notemd:export-cli-invocation-contract
obsidian command id=notemd:export-cli-capability-manifest
obsidian command id=notemd:export-provider-profiles-redacted
| خروجی | مسیر اولیه نسبت به خزانه |
|---|---|
| سطح عمومی | .obsidian/plugins/notemd/notemd-cli-public-surface.json |
| قرارداد فراخوانی | .obsidian/plugins/notemd/notemd-cli-contract.json |
| فهرست قابلیت | .obsidian/plugins/notemd/notemd-cli-capabilities.json |
| نمایهٔ ارائه‌دهنده با راز حذف‌شده | .obsidian/plugins/notemd/notemd-providers-redacted.json |
اگر پوشهٔ تنظیم فرق دارد .obsidian را عوض کنید. stdout نتیجهٔ نوع‌دار عملیات نیست. ثابت کنید فراخوانی جاری فایل را نوشته، JSON را بخوانید و schema را اعتبارسنجی کنید. فایل قدیمی یا پیام موفقیت کافی نیست.
version، commands، operationId، operationVersion، inputSchema و resultSchema را بررسی کنید. نسخهٔ سند 1 است. فهرست قابلیت ممکن است گسترده‌تر باشد؛ حضور در آن حق اجرا یا پشتیبانی عمومی نمی‌دهد.
خروجی حساس
inputHandlingTags و outputHandlingTags را بخوانید. contains-provider-credentials عملیات حساس را مشخص و نمایهٔ خام را از مجموعهٔ عمومی حذف می‌کند. آن را نمونهٔ کشف عمومی نکنید. خروجی redacted: true عمداً import نمی‌شود. نشانی خصوصی، میزبان و metadata ممکن است باقی بماند؛ پیش از اشتراک بررسی کنید. این پشتیبان بازیابی کلید نیست.
عملیات نگهداری
مخزن 9 عملیات با obsidian-cli native eval دارد، از جمله تولید بر مسیر، فصل، پژوهش، نمودار و بررسی زمینهٔ محلی. ابزار جداست و schema آن را API نوشتن عمومی نمی‌کند. npm run cli:help و ماتریس CLI ورودی و اثر را نشان می‌دهند. مسیرها مربوط به خزانهٔ انتخابی‌اند؛ برای دادهٔ پیچیده --input-file را به کار ببرید.
خطا و تکرار
- فرمان غایب: نسخهٔ بارگذاری‌شده و خزانه را بررسی و دوباره کشف کنید.
- خروجی غایب یا خراب: میزبان و مجوز را ببینید، شاهد قدیمی را استفاده نکنید.
- schema یا زمینهٔ پشتیبانی‌نشده: بدون اختراع فیلد یا جایگزینی UI توقف کنید.
- خروجی حساس: تا رعایت شرایط، محلی نگه دارید.
- نوشتن نگهداری: پیش از تکرار، خروجی جزئی و تعارض را بررسی کنید؛ لغو نوشتن و هزینه را پس نمی‌گیرد.
خروجی‌ها snapshot قابل‌تغییرند. زمان و نسخه را همراه شاهد نگه دارید. یادداشت و پاسخ داده‌اند، نه مجوز افزایش اختیار.