كيف أجعل Cursor يفرّغ الصوت والفيديو؟

أضف خادم MCP من KolWrite إلى ~/.cursor/mcp.json (أو افتح رابط التثبيت أدناه). بعدها يستطيع وكيل Cursor تفريغ التسجيلات الموجودة في مشروعك إلى نص أو ترجمات نصية أو ترجمة إلى لغة أخرى، وتُحتسب التكلفة بالثانية من رصيدك في KolWrite.

احصل على مفتاح API بدء سريع اللغات المدعومة

آخر تحديث: · Markdown

ما تفعله مرة واحدة

أنشئ الحساب والمفتاح بنفسك من console.kolwrite.com: سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.

احفظ المفتاح في ملف إعدادات الـ shell (~/.zshrc أو ~/.bashrc) لتتمكن كل جلسة وكيل تبدأها من قراءته، ثم افتح نافذة طرفية جديدة:

export KOLWRITE_API_KEY=...   # paste the key from API Keys

تقرأ الأدوات المفتاح من هذا المتغير فقط. لا تلصقه في محادثة ولا تضعه في مستودع.

إضافة خادم MCP

في ~/.cursor/mcp.json (لكل المشاريع) أو .cursor/mcp.json (لمشروع واحد). تقرأ الصيغة ${env:KOLWRITE_API_KEY} المفتاح من البيئة التي شُغّل فيها Cursor:

{
  "mcpServers": {
    "kolwrite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz"
      ],
      "env": {
        "KOLWRITE_API_KEY": "${env:KOLWRITE_API_KEY}"
      }
    }
  }
}

أو افتح هذا الرابط في متصفح على الجهاز الذي ثُبّت عليه Cursor. يسألك Cursor قبل أن يضيف الخادم: Add KolWrite to Cursor

يمنح الخادم الوكيل ستّ أدوات: transcribe_file، transcribe_url، upload_file، get_job، list_models، list_languages. يعمل على جهازك بإصدار Node.js 18 أو أحدث، وتُنزَّل حزمته من https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca).

إذا لم تظهر الأدوات، شغّل Cursor من طرفية يكون فيها KOLWRITE_API_KEY مضبوطًا، أو افتح Cursor Settings ثم MCP وتحقق من حالة الخادم.

إضافة قاعدة للمشروع

لكي يعرف الوكيل الـ API عندما يكتب كودًا أيضًا، أضف قاعدة في .cursor/rules/kolwrite.mdc:

---
description: Speech-to-text with the KolWrite API
alwaysApply: false
---
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md first. The key is in KOLWRITE_API_KEY; never print it.

ماذا تطلب

ثلاثة طلبات يمكنك تجربتها مع Cursor:

فرّغ الملف ~/Downloads/interview.m4a بواسطة KolWrite واحفظ النص في interview.txt بجانبه.

أنشئ ترجمات SRT بالإنجليزية للملف talk.mp4 بواسطة KolWrite، بحيث تكون كل جملة في مقطع ترجمة مستقل.

من قال ماذا في team-call.mp3؟ فرّغه مع تمييز المتحدثين بالنموذج oracle، ثم اذكر المهام المطلوبة من كل متحدث.

التكلفة

المهمةالنموذجالتكلفة
مقابلة مدتها 30 دقيقة، نص عاديbase0.24 دولار
اجتماع مدته ساعة مع تمييز المتحدثينoracle1.56 دولار
محاضرة بالعبرية مدتها ساعة مع ترجمات نصية بالإنجليزيةoracle1.44 دولار
ساعة من صوت مشوَّش وكلام متداخلoracle_max3.60 دولار

تُحتسب التكلفة بالثانية من مدة الصوت وتُخصم من رصيدك، دون حدّ أدنى. يضيف تمييز المتحدثين 0.10 رصيد لكل ساعة صوت. يستخدم خادم MCP وملف kolwrite.py النموذج base ما لم تحدد أنت أو الوكيل نموذجًا آخر، والنموذج oracle_mini عند الترجمة. الأسعار كاملةً: /ar/models.

ما يجب ألا يفعله الوكيل

  • أن يطلب منك المفتاح في المحادثة، أو يطبعه، أو يكتبه في ملف أو أمر أو commit.
  • أن يعيد بدء التفريغ نفسه بعد انتهاء المهلة أو حدوث خطأ في الشبكة. كل بدء يُنشئ مهمة جديدة تُحتسب تكلفتها، لذا عليه أن يتحقق من حالة المهمة القائمة أو يسألك.
  • أن يكتب الطوابع الزمنية بنفسه. لقصّ مقطع أو اقتباسه بحسب الوقت، يأخذ أرقام المقاطع من التفريغ ويحسب الأوقات في الكود من أوقات الكلمات.
  • أن يرسل رابط YouTube أو أي صفحة ويب أخرى على أنه الملف. المطلوب هو ملف الوسائط نفسه.
  • أن يفرّغ تسجيلات طويلة (أكثر من ساعة) دون أن يخبرك بالتكلفة المتوقعة أولًا.

أسئلة وأجوبة

هل يعمل في وضع Ask؟

تعمل أدوات MCP داخل الوكيل. استخدم الوكيل للتفريغ، ويمكنك بعد ذلك قراءة التفريغ في وضع Ask.