Dvina MCP

استخدام الأمر dvina

تعرّف على ما يفعله الأمر dvina عندما يشغّل Dvina تعليمات برمجية نيابةً عنك، والأوامر المتاحة فيه، وأيّها يتطلب موافقتك.

عرض بصيغة Markdown

عندما يشغّل Dvina تعليمات برمجية أو أوامر نيابةً عنك، يكون لديه أمر خاص به: dvina. يتيح هذا الأمر لبرنامج نصي أو بضع خطوات متتابعة البحث في Dvina الخاص بك، وقراءة المستندات والذاكرة والمهام وإضافتها، والتحقق ممن يمكنه الوصول إلى عنصر، وكل ذلك بهويتك.

لا تحتاج إلى تثبيت أي شيء أو تسجيل الدخول. يستخدم Dvina الأمر عندما يتطلب طلبك ذلك، ويمكنك أن تطلب منه استخدامه، مثل: "استخدم dvina لسرد مهامي وكتابة ملخص في ملاحظة."

كيف يعمل

  • يعمل dvina على Dvina الخاص بك، بهويتك، وفق الصلاحيات التي يتيحها دورك وضمن حدودك المعتادة.
  • يستمر وصوله فقط أثناء عمل Dvina على طلبك. وبمجرد انتهاء الرد، لا يعود بإمكان الأمر الوصول إلى Dvina الخاص بك.
  • لا يقرأ ملفًا أو مجلدًا إلا إذا حدّده أحد الأوامر، مثل تحديد ملف لرفعه.

الأوامر

الأوامر مرتّبة في مجموعات: dvina <group> <command>، تليها وسيطات الأمر وخياراته.

المجموعة الأوامر
search dvina search <query>: البحث في محادثاتك ومستنداتك وذاكرتك وعالمك دفعة واحدة.
memory ls, show, add, edit: سرد ملفات ذاكرتك أو قراءتها أو إضافتها أو تعديلها.
world topics, topic, recall, feed: موضوعاتك، وما يعرفه Dvina عن شيء ما، وموجزك.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: مستندات مكتبتك ومجلداتها.
canvas ls, show, create, write-page: سرد صفحات اللوحة أو قراءتها أو إنشاؤها أو إعادة كتابتها.
tasks ls, show, start, continue, stop: مهامك التي تعمل في الخلفية.
goals show, start: المهام التي تعمل لتحقيق هدف.
schedule ls, add, cancel: الرسائل والتذكيرات المجدولة، لمرة واحدة أو بشكل متكرر.
agents ls, show, create, update: وكلاؤك.
skills ls, show, add, edit: مهاراتك.
projects ls, show: مشاريعك.
settings get, set: تفضيلاتك، مثل تشغيل الذاكرة أو إيقافها.
share state, with-me, add, rm: من يمكنه الوصول إلى عنصر، وما شاركه الآخرون معك، ومنح الوصول أو إلغاؤه.

لا يستطيع dvina حذف أي شيء نهائيًا، أو فتح روابط عامة، أو ربط التطبيقات أو فصلها، أو تغيير إعدادات الإدارة أو الفوترة.

المساعدة والمخرجات

  • يسرد dvina --help المجموعات، ويسرد dvina <group> --help أوامر المجموعة، ويسرد dvina <group> <command> --help وسيطات الأمر وخياراته.
  • تكون المخرجات نصًا قصيرًا. أضف --json للحصول عليها بتنسيق JSON، أو --fields مع قائمة مفصولة بفواصل، مثل --fields id,title، للاحتفاظ ببعض الحقول فقط.
  • تنتهي القائمة الطويلة بـ next: --cursor <c>. شغّل الأمر مرة أخرى مع --cursor هذا للحصول على الصفحة التالية.
  • لقراءة قيمة من ملف، أضف -file إلى خيارها، مثل --content-file notes.md. يرفع dvina docs upload <file> ملفًا، ويضيف dvina skills add <folder> مجلد مهارة مع ملف SKILL.md الخاص به.

رموز الخروج

الرمز المعنى
0 تم التنفيذ.
1 حدث خطأ آخر.
2 الأمر غير صحيح. راجع --help الخاص به.
3 لم يُعثر على المطلوب.
4 مرفوض: لا تسمح به صلاحيات وصولك أو قواعد شركتك أو قواعد حماية البيانات.
5 يتطلب موافقتك.
6 بلغت حد الاستخدام.

الموافقة على التغييرات

  • تُنفَّذ أوامر القراءة دون طلب موافقتك.
  • تُنفَّذ الأوامر التي تضيف شيئًا جديدًا، مثل docs create أو memory add أو tasks start، دون طلب موافقتك. وهي لا تغيّر أي شيء موجود بالفعل.
  • تطلب الأوامر التي تغيّر شيئًا أو تزيله موافقتك أولًا: النقل، وإعادة التسمية، والنقل إلى سلة المهملات، واستبدال ملاحظة أو ملف ذاكرة، وإعادة كتابة صفحة لوحة، وتغيير وكيل أو مهارة، وإيقاف مهمة، وإلغاء رسالة مجدولة، والمشاركة. يعرض Dvina بطاقة موافقة في المحادثة تتضمن ملخصًا يكتبه للتغيير، ويطلب موافقتك في كل مرة. إذا رفضت، فلن يتغير شيء.

يخضع ما يضيفه dvina أو يغيّره لقواعد حماية البيانات في شركتك، ويُسجَّل في سجل التدقيق الخاص بك، تمامًا مثل إجراءات Dvina الأخرى.