PrivateNote CLI
أسرار بدون أثر في البرامج النصية، والأنابيب (pipes)، وCI — يتم تشفيرها محلياً قبل وصول أي شيء إلى الشبكة.
في هذه الصفحة
لمن هذه الأداة
استخدم CLI عندما يكون السر موجوداً بالفعل في ملف، أو مدير كلمات مرور، أو مخرجات خط أنابيب (pipeline) وتحتاج إلى رابط قابل للمشاركة دون اللصق في الدردشة أو البريد الإلكتروني.
تقرأ الأداة من stdin أو مسار ملف، وتُشفر باستخدام AES-256-GCM على جهازك، وترفع النص المشفر فقط، وتطبع URL مع مفتاح فك التشفير في الجزء المرجعي (fragment).
الملاحظات التي يتم إنشاؤها بهذه الطريقة يتم تتبعها كـ creationSource: cli في التحليلات.
التثبيت
يتطلب Node.js 18+. يعمل على macOS و Linux و Windows.
# Run once without installing npx privatenote-cli --expire 1h --output-url-only # Or install globally (adds the `privatenote` command) npm install -g privatenote-cli # Pipe a secret in scripts cat secret.txt | privatenote --expire 1h --output-url-only # Local self-host / wrangler dev (HTTP API — dev only) echo "secret" | privatenote --insecure --api-base-url http://localhost:8787 --output-url-only
جرّبه مباشرة
نفّذ نفس خطوات CLI في متصفحك: شفّر محليًا، وارفع النص المشفر، ثم اطبع رابطًا بمفتاح في الجزء fragment.
عرض مباشر — ينشئ ملاحظة حقيقية على privatenote.ai. استخدم سرًا مؤقتًا، لا بيانات اعتماد الإنتاج.
echo 'sk-live-demo-replace-me' | npx privatenote-cli --expire 1h --output-url-onlyhttps://privatenote.ai/note/…#…
بنية الأمان
النص الصريح لا يغادر جهازك أبداً دون تشفير. يحمل رابط المشاركة URL مفتاح فك التشفير في #fragment الخاص به، والذي لا ترسل المتصفحات وعملاء HTTP إلى الخوادم.
عندما لا يكون stdout عبارة عن TTY (ممرر أو ملتقط)، ترفض CLI طباعة رابط ما لم تمرر --output-url-only أو --force-stdout — وهذا يمنع التسريبات العرضية في سجلات CI.
تشفير محلي
AES-256-GCM على جهازك — المتصفح أو المحرر أو الطرفية أو عملية MCP.
رفع النص المشفر
لا يصل إلى الخادم سوى البايتات المشفرة وبيانات الملاحظة الوصفية (الانتهاء والحذف بعد القراءة).
المفتاح في #fragment
يبقى مفتاح فك التشفير في الجزء بعد # من الرابط. لا ترسل المتصفحات أجزاء الرابط هذه في طلبات HTTP.
privatenote.ai/note/…#key
مطلوب HTTPS لأصول API البعيدة؛ مرر --insecure فقط لبيئة التطوير المحلية http:// (مثل wrangler dev على :8787).
تقوم PRIVATENOTE_ALLOWED_HOSTS بتثبيت أسماء مضيفات API عند استخدام API base URL مخصص.
التحقق من شكل الاستجابة وفحوصات معرف الملاحظة المحجوز قبل الرفع.
يفضل إعادة توجيه المخرجات إلى ملف chmod 600 بدلاً من عرض الروابط.
الأعلام ومتغيرات البيئة
| الاسم | الوصف |
|---|---|
| --expire 15m|1h|24h|7d | عمر الملاحظة (الافتراضي: 24h) |
| --burn / --no-burn | التدمير بعد أول عرض (الافتراضي: burn) |
| --title <text> | عنوان اختياري يضاف قبل المحتوى |
| --json | طباعة { secureUrl, expiresAt, burnAfterReading } |
| --output-url-only | مخرجات URL فقط؛ آمنة لـ stdout الممرر في البرامج النصية |
| --force-stdout | السماح بالمخرجات عندما لا يكون stdout طرفية (استخدم مع --json في CI) |
| --api-base-url <url> | تجاوز أصل API (HTTPS؛ استخدم مع --insecure لـ http:// المحلي) |
| --insecure | السماح بأصول http:// API — للتطوير المحلي فقط، لا تستخدمه أبداً في الإنتاج |
| PRIVATENOTE_API_BASE_URL | أساس API الافتراضي URL |
| PRIVATENOTE_WEB_ORIGIN | أصل رابط المشاركة (الافتراضي هو أصل API) |
| PRIVATENOTE_ALLOWED_HOSTS | قائمة السماح بأسماء المضيفين مفصولة بفاصلة |
تكاملات ذات صلة
إضافة المحرر (Editor extension)
أنشئ ملاحظات من VS Code، أو Cursor، أو Codex IDE دون تغيير السياق. استخدم الشريط الجانبي، أو أمر النص المحدد، أو إجراء شريط العنوان.
عرض الوثائقخادم MCP
عاين الملف المحلي ووافق عليه قبل تشفيره ومشاركته.
عرض الوثائقإضافة Codex
قم بتثبيت الملحق المدمج لـ MCP بالإضافة إلى المهارات، أو أضف privatenote-mcp إلى ~/.codex/config.toml. استخدم إضافة VS Code نفسها في Codex IDE للأسرار التي لا يراها الوكيل أبداً.
عرض الوثائقإضافة Chrome
تشفير النص المحدد من أي علامة تبويب عبر قائمة السياق، أو النافذة المنبثقة لشريط الأدوات، أو اختصار لوحة المفاتيح — دون فتح الموقع أولاً.
عرض الوثائقPrivateNote CLI
أسرار بدون أثر في البرامج النصية، والأنابيب (pipes)، وCI — يتم تشفيرها محلياً قبل وصول أي شيء إلى الشبكة.
