PrivateNote CLI
اطلاعات حساس بدون ردپا در اسکریپتها، پایپها و CI — رمزنگاری محلی قبل از ارسال به شبکه.
در این صفحه
این ابزار برای چه کسی است
زمانی از CLI استفاده کنید که اطلاعات حساس از قبل در یک فایل، مدیریت رمز عبور یا خروجی پایپline قرار دارد و شما به یک لینک قابل اشتراکگذاری نیاز دارید بدون اینکه آن را در چت یا ایمیل کپی کنید.
این ابزار از 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 را در مرورگر اجرا کنید: رمزگذاری محلی، بارگذاری متن رمزگذاریشده و چاپ URL با کلید در 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
کلید رمزگشایی در بخش هش URL میماند. مرورگرها بخش fragment را در درخواستهای HTTP نمیفرستند.
privatenote.ai/note/…#key
HTTPS برای مبدأهای از راه دور API الزامی است؛ --insecure را فقط برای توسعه محلی http:// (مثلاً wrangler dev روی :8787) ارسال کنید.
PRIVATENOTE_ALLOWED_HOSTS نامهای میزبان API را هنگام استفاده از یک API پایه URL سفارشی پین میکند.
اعتبارسنجی ساختار پاسخ و بررسی شناسههای رزرو شده یادداشت قبل از آپلود.
ترجیح داده میشود خروجی به جای چاپ URLها، به یک فایل با chmod 600 هدایت شود.
پرچمها (Flags) و متغیرهای محیطی
| نام | توضیح |
|---|---|
| --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 base URL |
| PRIVATENOTE_WEB_ORIGIN | منشأ لینک اشتراکگذاری (پیشفرض: منشأ API) |
| PRIVATENOTE_ALLOWED_HOSTS | لیست سفید نامهای میزبان (hostname) با جداکننده کاما |
یکپارچهسازیهای مرتبط
افزونه ویرایشگر
بدون تغییر بافتار، از طریق VS Code، Cursor یا Codex IDE یادداشت بسازید. از نوار کناری، دستور متن انتخابشده یا عملیات نوار عنوان استفاده کنید.
مشاهده مستنداتسرور MCP
فایل محلی را پیشنمایش و تأیید کنید تا پس از اجازهٔ شما رمزگذاری شود.
مشاهده مستنداتافزونه Codex
پلاگین باندل شده برای MCP به همراه مهارتها را نصب کنید، یا privatenote-mcp را به ~/.codex/config.toml اضافه کنید. برای اطلاعات حساس که عامل هرگز نبیند، از همان افزونه VS Code در Codex IDE استفاده کنید.
مشاهده مستنداتافزونه Chrome
رمزنگاری متن انتخاب شده از هر تب از طریق منوی راستکلیک، پاپآپ تولبار، یا میانبر کیبورد — بدون نیاز به باز کردن سایت ابتدا.
مشاهده مستنداتPrivateNote CLI
اطلاعات حساس بدون ردپا در اسکریپتها، پایپها و CI — رمزنگاری محلی قبل از ارسال به شبکه.
