تكاملات المطوّرين

شارك الأسرار من الأدوات التي يحدث فيها العمل فعلًا

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

أي أداة تُستخدم ومتى

اختر المسار الأقرب إلى حيث يوجد السر بالفعل. يستخدم كل تكامل عقد التشفير المحلي نفسه.

تطبيق الويب

مستقر

الصق سرًا، واختر انتهاء الصلاحية وحدود القراءة، ثم شارك الرابط المشفّر من أي متصفح.

تطبيق PrivateNote للويب مع محرّر الملاحظة المشفّرة وإعدادات انتهاء الصلاحية وزر مشاركة الملاحظة الخاصة
تطبيق الويب على privatenote.ai — اكتب ملاحظة، وخصّص انتهاء الصلاحية، وأرفق ملفات، وشارك من أي متصفح.
افتح privatenote.ai → الصق السر → شارك الرابط المشفّر
كيف يعمل التشفير

CLI

مستقر

أسرار دون أثر في سجل bash والأنابيب وCI/CD.

$ echo 'sk-live-...' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/a1b2c3d4#…
مرّر سرًا إلى CLI — يعمل التشفير محليًا، ويطبع stdout عنوان URL لمرة واحدة فقط.
عرض الوثائق

VS Code & Cursor

مستقر

عمل المطور اليومي — الشريط الجانبي والتحديد والحافظة دون مغادرة المحرر.

لوحة PrivateNote الجانبية في VS Code أو Cursor مع خيارات العنوان والمحتوى والانتهاء والحذف بعد القراءة
لوحة جانبية في VS Code أو Cursor — اكتب ملاحظة وحدد الانتهاء والحذف بعد القراءة ثم شارك دون مغادرة المحرر.
code --install-extension PrivateNote.privatenote-vscode
عرض الوثائق

إضافة Chrome

مستقر

تشفير النص المحدد في مكانه — قائمة السياق والنافذة المنبثقة وAlt+Shift+P.

نافذة إضافة PrivateNote في Chrome مع خيارات العنوان والمحتوى وكلمة المرور الاختيارية والانتهاء والحذف بعد القراءة
نافذة شريط أدوات Chrome — اكتب ملاحظة وحدد الانتهاء والحذف بعد القراءة ثم شارك دون فتح privatenote.ai.
# Right-click selected text → Create PrivateNote
# Shortcut: Alt+Shift+P
عرض الوثائق

خادم MCP

مستقر

امنح وكلاء الذكاء الاصطناعي أداة create_private_note محلية للتسليم الآمن.

// معاينة — المسار، لا السر
create_private_note({ "contentFilePath": "/absolute/path/secret.txt" })
// بعد موافقتك
confirm_private_note({ "confirmationId": "cnfg_…" })
يمرّر الوكلاء مسار ملف إلى create_private_note. توافق على معاينة، ثم يعيد confirm_private_note عنوان URL.
عرض الوثائق

إضافة Codex

مستقر

MCP ومهارات لـ OpenAI Codex CLI وIDE.

codex mcp add privatenote -- npx -y privatenote-mcp
عرض الوثائق

وصفات

سيناريوهات شائعة

ابدأ من المهمة — اختر التكامل الذي يطابق مكان وجود السر وكيف يجب أن ينتقل.

CLI

مشاركة مفتاح API من CI

مرّر سرًا من GitHub Actions إلى CLI والتقط رابطًا لمرة واحدة — أبقِ النص الصريح خارج سجلات سير العمل.

echo "$API_KEY" | privatenote --output-url-only
عرض الوثائق
Chrome

التسليم من المتصفح

حدّد نصًا في Slack أو البريد أو تذكرة وأنشئ رابطًا مشفرًا دون فتح privatenote.ai أولًا.

نقر بالزر الأيمن ← Create PrivateNote
عرض الوثائق
MCP

الوكيل يرسل رمز استرداد

اجعل عميل MCP يمرّر مسار ملف إلى create_private_note، وينتظر موافقتك، ثم يستدعي confirm_private_note.

create_private_note({ contentFilePath }) → confirm_private_note
عرض الوثائق
VS Code

مشاركة رمز وصول من المحرر

حدّد متغيرات البيئة أو مفاتيح API أو سلاسل الاتصال في VS Code أو Cursor وسلّمها دون تبديل التطبيقات — يصل الرابط إلى حافظتك.

نقر بالزر الأيمن ← Share as PrivateNote
عرض الوثائق
Codex

منح Codex أداة تسليم آمنة

سجّل خادم MCP مرة واحدة ليتمكن Codex من إنشاء روابط مشفرة أثناء عمل الوكلاء بدل لصق الأسرار في المحادثة.

codex mcp add privatenote -- npx -y privatenote-mcp
عرض الوثائق
المتصفح

إرسال لشخص خارج بيئتك التقنية

استخدم تطبيق الويب عندما يحتاج المستلم رابطًا فقط — اضبط الانتهاء والحذف بعد القراءة وكلمة مرور اختيارية في المتصفح.

إنشاء ملاحظة ← انتهاء + كلمة مرور ← نسخ الرابط
عرض الوثائق

معاينة الاستضافة الذاتية

ما يعمل اليوم: وجّه CLI وخادم MCP إلى API الخاص بك باستخدام PRIVATENOTE_API_BASE_URL، وإضافة VS Code باستخدام privatenote.apiBaseUrl. تُشغِّل معاينة Docker Compose (docker-compose.yml) مكدس ويب وAPI محليًا للتقييم.

npm run self-host:up

معاينة فقط — ليست بيئة تشغيل إنتاجية داخل المقر. إضافة Chrome مثبّتة برمجيًا على privatenote.ai ولا يمكنها استهداف API مستضاف ذاتيًا؛ استخدم CLI (--insecure للعنوان المحلي http://) أو MCP أو VS Code. عمليات النشر المؤسسية المُدارة ضمن خارطة الطريق — تواصل معنا إذا أردت المشاركة برأيك مبكرًا.

أين يناسب

أداة صغيرة للحظات العسيرة

ما زالت فرق المطوّرين تتبادل كلمات مرور قواعد البيانات ورموز الاسترداد ورموز API وتفاصيل تسليم الدعم والتشخيصات الخاصة بالعميل. غالبًا ما تنتهي تلك الأسرار في سجل الدردشة أو تعليقات التذاكر أو سلاسل طلبات السحب أو مطالبات الذكاء الاصطناعي لأن المسار الآمن بطيء جدًا.

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

نموذج الثقة

العقد نفسه في كل مسار

البنية

تشفير محلي → رفع النص المشفّر → المفتاح في #fragment

يتبع كل تكامل الحد نفسه. لا يغادر النص الواضح جهازك غير مشفّر؛ ولا يتلقى الخادم مفتاح فك التشفير أبدًا.

تشفير محلي

AES-256-GCM على جهازك — المتصفح أو المحرر أو الطرفية أو عملية MCP.

رفع النص المشفر

لا يصل إلى الخادم سوى البايتات المشفرة وبيانات الملاحظة الوصفية (الانتهاء والحذف بعد القراءة).

المفتاح في #fragment

يبقى مفتاح فك التشفير في الجزء بعد # من الرابط. لا ترسل المتصفحات أجزاء الرابط هذه في طلبات HTTP.

privatenote.ai/note/…#key

  • يُشفَّر النص الواضح محليًا قبل الرفع.

  • يخزّن الخادم النص المشفّر وبيانات الملاحظة الوصفية، لا مفتاح فك التشفير.

  • يبقى المفتاح في جزء URL، ولا يُرسَل في طلبات HTTP.

  • تُفرَض حدود القراءة وانتهاء الصلاحية بواسطة خدمة الملاحظة.

يجب أن تحافظ كل مسارات التكامل على العقد الأساسي نفسه: أنشئ النص المشفّر محليًا، وارفع فقط ما يحتاج الخادم إلى تخزينه وفرضه، ثم شارك رابطًا يحمل مفتاح فك التشفير خارج الطلب.

كيف يعمل التشفير

ابدأ بالتكامل الأقرب إلى السر

استخدم تطبيق الويب للمشاركة العرضية، وإضافة المحرّر لعمل المطوّر اليومي، وCLI للنصوص البرمجية وCI، وMCP عندما يحتاج الوكيل إلى أداة تسليم آمنة.

PrivateNote on LaunchNest