التوثيق

التثبيت

أسرع طريقة، على أي توزيعة:

curl -fsSL https://quickdesk.click/install.sh | bash

يختار ملف .deb أو .rpm أو AppImage المناسب لنظامك، ويتحقق من SHA-256 الخاص به ويثبّته (اقرأ السكربت). أو نزّل حزمة من صفحة التنزيل وثبّت الملف المنزَّل بالأمر:

• Ubuntu وDebian وMint وPop!_OS: sudo apt install ~/Downloads/QuickDesk_<version>_amd64.deb
• Fedora وopenSUSE: sudo dnf install ~/Downloads/QuickDesk-<version>-1.x86_64.rpm
• أي توزيعة أخرى: اجعل ملف AppImage قابلًا للتنفيذ وشغّله. يحتاج إلى FUSE 2 ‏(libfuse2، وعلى Ubuntu 24.04 ‏libfuse2t64).

يحتاج QuickDesk إلى نظام x86_64 من السنوات الأخيرة (glibc 2.34 أو أحدث). ويعمل على أفضل وجه في GNOME، على Wayland وX11 كليهما.

Windows 10 و11 (64 بت): في PowerShell شغّل irm https://quickdesk.click/install.ps1 | iex، أو نزّل المثبّت من صفحة التنزيل. يُثبَّت لمستخدمك فقط، دون صلاحيات المسؤول. المثبّت غير موقَّع بعد، لذلك قد يقول Windows إنه حمى جهازك: اختر More info → Run anyway. على Windows تكون الاختصارات Win Alt N / V / P، ويعيش QuickDesk في علبة النظام، ولا يحتاج اللصق التلقائي إلى أي إعداد. ويعمل تبويب Runtimes هناك عبر mise وrustup وuv (انظر إصدارات اللغات).

عند التشغيل الأول تعرض شاشة ترحيب الاختصارات وتقدّم خيارين: التشغيل عند تسجيل الدخول (ضروري ليعمل سجل الحافظة وحلقة الذكاء الاصطناعي طوال الوقت) واللصق الفوري (انظر اللصق التلقائي). بعد ذلك يعيش QuickDesk في الشريط العلوي.

macOS

ما زال قيد التطوير. يعمل إصدار Mac، لكنه جديد: لم تُجرَّب كل الميزات على كل أجهزة Mac بعد، وما زال اللصق التلقائي والاختصارات قيد التحسين. من فضلك أبلغنا بما لا يعمل.

يعمل QuickDesk على macOS 11 أو أحدث على Apple Silicon ‏(M1 وأحدث). في Terminal شغّل curl -fsSL https://quickdesk.click/install.sh | bash: يضع QuickDesk.app في Applications ويفتحه. أو نزّل ملف .dmg من صفحة التنزيل واسحب QuickDesk إلى Applications.

فتحه لأول مرة. لم يُوثَّق QuickDesk لدى Apple بعد، لذلك إذا نُزِّل ملف .dmg من المتصفح يوقف macOS التشغيل الأول برسالة “Apple cannot check it for malicious software”. لا مشكلة في التطبيق؛ نفّذ إحدى الطريقتين مرة واحدة (عند التثبيت بالأمر لا يظهر أي تحذير):

1. افتح QuickDesk من Applications وانقر Done عندما يحذّرك macOS. ثم افتح System Settings → Privacy & Security، ومرّر حتى Security، وانقر Open Anyway بجوار “QuickDesk was blocked to protect your Mac”، وأكّد بكلمة المرور أو Touch ID ثم انقر Open. على macOS 14 أو أقدم ينجح أيضًا النقر مع Control على QuickDesk ← Open ← Open.
2. أو شغّل xattr -dr com.apple.quarantine /Applications/QuickDesk.app في Terminal، ثم افتح QuickDesk كالمعتاد.

تعرض صفحة التنزيل الخطوات نفسها.

• يعيش QuickDesk في شريط القوائم، دون أيقونة في Dock. تُفتح نوافذه المنبثقة في مساحة العمل (Space) التي أنت فيها، حتى فوق تطبيق في وضع ملء الشاشة.
• الاختصارات هي ⌃ ⌥ N / V / P ‏(Control + Option): أما ⌘⌥V و⌘⌥N فتخص Finder.
• اللصق التلقائي يضغط ⌘V في التطبيق الذي كنت تستخدمه، ولا يسمح macOS بذلك إلا بعد أن تضيف QuickDesk في System Settings → Privacy & Security → Accessibility. يسألك macOS في أول مرة تختار فيها عنصرًا؛ وحتى ذلك الحين يُنسَخ العنصر وتضغط ⌘V بنفسك. يُظهر Settings → Auto-paste ما إذا كان مسموحًا.
• قد تسأل إصدارات macOS الأحدث عمّا إذا كان يحق لـ QuickDesk قراءة ما تنسخه التطبيقات الأخرى. اختر Allow، وإلا سيبقى سجل الحافظة فارغًا.
• استخدام Claude: على Mac يحفظ Claude Code تسجيل دخوله في Keychain. يعرض تبويب AI قراءته من هناك؛ ثم يسألك macOS مرة واحدة (اختر Always Allow). وكما في الأنظمة الأخرى، يُقرأ تسجيل الدخول فقط ولا يُرسَل إلا إلى api.anthropic.com.
• لأن التطبيق موقَّع توقيعًا مخصّصًا (ad hoc)، قد يطلب macOS أذونات Accessibility وKeychain مجددًا بعد التحديث. إن توقف اللصق التلقائي عن العمل، فأزِل QuickDesk من قائمة Accessibility ثم أضفه من جديد.
• يعمل تبويب Runtimes كما على Linux، مع صدفة تسجيل الدخول الخاصة بك (zsh: ~/.zshrc). تظهر النسخ المثبَّتة عبر Homebrew لكنها لا تُعدَّل.

إزالة التثبيت: أنهِ QuickDesk من شريط القوائم وانقله من Applications إلى سلة المهملات. تبقى بياناتك في ~/Library/Application Support/click.quickdesk حتى تحذف ذلك المجلد.

الاختصارات

الضغط على الاختصار مرة أخرى أثناء فتح نافذته يغلقها. غيّر أيًّا منها في Settings → Hotkeys؛ وينبّهك QuickDesk عندما تكون التركيبة مستخدمة بالفعل.

في GNOME تُضاف الاختصارات إلى Settings → Keyboard → Custom Shortcuts وتُزال عند إنهاء QuickDesk، لذلك تعمل على Wayland أيضًا. وفي بيئات سطح المكتب الأخرى، اربط quickdesk toggle notes أو quickdesk toggle clipboard أو quickdesk toggle ports أو quickdesk toggle quick-note بمفاتيح في إعدادات لوحة المفاتيح.

لماذا Super + Alt؟ تبتلع أساليب الإدخال الفيتنامية مثل Unikey وBamboo تركيبة Super + Shift + حرف أثناء الكتابة في حقل نصي؛ أما التركيبات التي فيها Alt فتظل تعمل.

الملاحظات

الملاحظات بصيغة Markdown مع محرر غني: عناوين، وخط عريض ومائل، وقوائم، وقوائم مهام، واقتباسات، وكتل شيفرة. Ctrl N ينشئ ملاحظة جديدة، وCtrl S يحفظ، وCtrl F يبحث. يتجاهل البحث علامات التشكيل، لذا يجد tieng viet عبارة “tiếng Việt”.

ثبّت ملاحظة بالنجمة لتبقيها في الأعلى. يسألك الحذف أولًا ويمكن التراجع عنه لبضع ثوانٍ.

مزامنة الملاحظات بين الحواسيب

تتزامن الملاحظات عبر QuickDesk Cloud. لا حساب ولا بريد إلكتروني: يحصل حاسوب على رمز مزامنة، وتنضم حواسيبك الأخرى به. تتزامن الملاحظات فقط؛ ويبقى سجل الحافظة والإعدادات على كل حاسوب.

الإعداد

1. على الحاسوب الأول: Settings → Sync → Turn on sync، واختر عبارة مرور (8 أحرف على الأقل).
2. يعرض QuickDesk رمز المزامنة (QD1-…) ومفتاح الاسترداد. احفظ مفتاح الاسترداد في مكان آمن؛ فهو يُعرض مرة واحدة فقط.
3. على كل حاسوب آخر: Settings → Sync → I have a sync code، ثم أدخل الرمز وعبارة المرور نفسها (أو مفتاح الاسترداد).

يمكن عرض رمز المزامنة مجددًا في أي وقت عبر Show sync code في Settings → Sync.

متى تتم المزامنة

• بعد ثانيتين تقريبًا من تعديل ملاحظة، وعند فتح نافذة من نوافذ QuickDesk.
• وفيما عدا ذلك، يتحقق QuickDesk من التغييرات كل دقيقة ما دامت نافذة مفتوحة، وكل 5 دقائق وهو في العلبة. التحقق طلب صغير واحد؛ ولا تنتقل الملاحظات إلا إذا تغيّر شيء.
• Sync now يتحقق فورًا. وتُرسَل التعديلات التي أُجريت دون اتصال عند عودتك إلى الشبكة.
• إذا تغيّرت ملاحظة على حاسوبين في الوقت نفسه، تُحفظ النسختان: تبقى الأحدث، وتصبح الأخرى نسخة بجوارها. التعديل يغلب الحذف.

الخصوصية والمفاتيح

• تُشفَّر الملاحظات على حاسوبك قبل رفعها (XChaCha20-Poly1305، بمفتاح من عبارة مرورك عبر Argon2id). لا يحتفظ QuickDesk Cloud إلا بنص مشفّر تحت معرّف حساب عشوائي، ولا يستطيع قراءة ملاحظاتك.
• يلزم كلاهما: رمز المزامنة (للوصول إلى البيانات) وعبارة المرور (لفك تشفيرها). تعامل مع رمز المزامنة ككلمة مرور: فبه وحده قد يحذف أحدهم ملاحظاتك المتزامنة.
• نسيت عبارة المرور؟ أدخل مفتاح الاسترداد بدلًا منها. ودون أيٍّ منهما لا يمكن فتح النسخة في QuickDesk Cloud، لكن الملاحظات على كل حاسوب تبقى كما هي.
• إذا طلب QuickDesk Unlock sync (مثلًا بعد إعادة ضبط سلسلة مفاتيح النظام)، فأدخل عبارة المرور مرة أخرى.

إيقافها

Turn off sync… يوقف المزامنة على حاسوب واحد ويحتفظ بملاحظاته. فعّل Also delete my notes from QuickDesk Cloud لحذف النسخة المتزامنة لكل الحواسيب.

الحدود لكل رمز مزامنة: 256 ميغابايت و20,000 كائن مخزَّن، وهذا أكثر بكثير مما تحتاجه الملاحظات.

سجل الحافظة

كل ما تنسخه يُحفَظ: النصوص والصور (لقطات الشاشة) والملفات المنسوخة في مدير الملفات. افتح النافذة المنبثقة بـ Super Alt V، واكتب للبحث، وصفِّ حسب النص أو الصور أو الملفات، واضغط Enter للصق في التطبيق الذي كنت تستخدمه. Ctrl Enter ينسخ فقط، وCtrl P يثبّت، وDel يحذف.

• يبقى السجل على هذا الحاسوب ولا يتزامن أبدًا.
• ما تضع عليه مديرات كلمات المرور علامة السرية يُتجاهَل. وقبل نسخ شيء حساس، أوقف الحفظ مؤقتًا لمدة 15 دقيقة أو ساعة أو حتى تعيد تشغيله (من تبويب Clipboard أو قائمة العلبة).
• يحتفظ QuickDesk بآخر 1,000 عنصر؛ والمثبَّتة للأبد. النص حتى 1 ميغابايت، والصور حتى 10 ميغابايت لكل منها و200 ميغابايت إجمالًا.
• Clear… في تبويب Clipboard يحذف كل شيء عدا العناصر المثبَّتة.

اللصق التلقائي

عندما تختار عنصرًا، يعود QuickDesk إلى التطبيق الذي كنت تستخدمه ويضغط Shift Insert، وهو يعمل في الطرفيات أيضًا. اختر الطريقة في Settings → Auto-paste:

• Desktop portal (الافتراضي): يطلب GNOME الإذن مرة واحدة ويعرض مؤشر تحكم عن بُعد أثناء اللصق.
• Instant (virtual keyboard): بلا أسئلة ولا مؤشر. يطلب تفعيله كلمة مرور المسؤول مرة واحدة ليسمح للبرامج التي تعمل باسمك بإنشاء لوحة مفاتيح افتراضية (الإذن نفسه الذي يستخدمه Steam لأذرع التحكم).

أوقف اللصق التلقائي من تبويب Clipboard لتكتفي بالنسخ، ثم اضغط Ctrl V بنفسك.

المنافذ

Super Alt P يعرض كل منفذ TCP يستمع (IPv4 وIPv6) مع العملية وسطر أوامرها الكامل والمستخدم، ويُحدَّث كل ثانيتين. صفِّ حسب المنفذ أو PID أو اسم العملية أو الحاوية.

• Open يفتح http://localhost:<port> في متصفحك؛ وCopy PID وCopy cmd ينسخانهما.
• Kill يسأل أولًا، ثم يوقف العملية بلطف، ولا يعرض الإنهاء القسري إلا إذا لم تتوقف.
• المنافذ التي ينشرها Docker تعرض الحاوية والصورة، وStop يوقف الحاوية بدلًا من قتل docker-proxy.
• عمليات المستخدمين الآخرين (خدمات النظام) تظهر مخفية؛ وفحصها يتطلب صلاحيات root.

إصدارات اللغات (Runtimes)

يدير تبويب Runtimes إصدارات لغات البرمجة على هذا الحاسوب (Node.js وPython وRust وGo وJava وRuby وDeno وBun وPHP). يعرض الإصدار الذي تشغّله طرفية جديدة ومن أين يأتي. يسأل QuickDesk صدفة تسجيل الدخول الخاصة بك، لذا فهذا ما تحصل عليه بعد ~/.bashrc أو ~/.zshrc، لا ما يراه سطح المكتب.

• اللغات المثبَّتة عبر nvm ‏(Node.js) أو rustup ‏(Rust) أو uv ‏(Python) أو mise ‏(Go وJava وRuby وDeno وBun وPHP وغيرها) يمكن تغييرها: Install version… يختار من الإصدارات التي تعرضها الأداة (يقبل rustup قناة أو إصدارًا تكتبه)، وMake default يحدد ما تستخدمه الطرفيات الجديدة، وUninstall يزيل إصدارًا ويحرّر مساحته. لا يمكن إزالة الإصدار الافتراضي؛ اختر افتراضيًا آخر أولًا.
• تعمل عمليات التثبيت في الخلفية مع شريط تقدّم ويمكن إلغاؤها. لا يعمل إلا تغيير واحد في كل مرة. تعرض قائمة الإصدارات افتراضيًا أحدث إصدار من كل سلسلة؛ بدّل إلى LTS أو الكل، أو اكتب للتصفية.
• عندما يصدر إصدار أحدث لسلسلة مثبَّتة (Node 22.24.1 بدل 22.23.3، أو Python 3.13.9 بدل 3.13.7)، يُظهر الإصدار ↑ 22.24.1: نقرة واحدة تثبّته، وإن كان القديم هو الافتراضي تجعله الافتراضي. يبقى الإصدار القديم حتى تزيل تثبيته. أما قنوات Rust فتُحدَّث في مكانها: يُظهر stable ‏↑ 1.93.0 عندما يكون لدى rustup إصدار stable أحدث، والنقرة تشغّل rustup update stable.
• Apply right away in open terminals (أعلى التبويب) يوصل التغييرات إلى الطرفيات المفتوحة بالفعل، بدءًا من موجّهها التالي: يضيف QuickDesk سطرًا إلى ملف صدفتك يحمّل خطّاف موجّه صغيرًا (~/.config/quickdesk/shell/hook.sh). يجعل الخطّاف الصدفة تبحث عن الأوامر من جديد بعد أن يغيّر QuickDesk إصدارًا، ويجعل Node يتبع أقرب .nvmrc عندما تدخل مشروعًا بـ cd، وإلا فالافتراضي الذي تختاره (يبقى nvm use اليدوي حتى تغيّر المجلد أو الافتراضي). ودونه تُطبَّق تغييرات Rust فورًا مع ذلك، وتصل تغييرات Python وmise إلى الطرفيات الجديدة (أو إلى طرفية مفتوحة بعد hash -r)، وتغييرات nvm إلى الطرفيات الجديدة فقط.
• Set for a project… يكتب ملف الأداة نفسها في مجلد تختاره: .nvmrc أو rust-toolchain.toml أو .python-version أو mise.toml (ويحتفظ mise بالأدوات الأخرى المدرجة فيه).
• اللغة التي لا مدير إصدارات لها (Go المثبَّت عبر apt مثلًا) تعرض Install mise…: ينزّل QuickDesk أحدث mise من github.com/jdx/mise، ويتحقق منه بمجاميع SHA-256 للإصدار، ويضعه في ~/.local/bin. وبعد أن تجعل إصدارًا افتراضيًا، يعرض Fix PATH… السطر الذي يفعّل mise في صدفتك.
• إذا كانت الطرفيات الجديدة ستشغّل نسخة غير الافتراضية (مثلًا يأتي python3 الخاص بالنظام أولًا في PATH)، تشرح البطاقة السبب، ويعرض Fix PATH… الأسطر التي سيضيفها بالضبط. ولا يضيفها QuickDesk إلا بعد موافقتك، ككتلة معلَّمة في نهاية ملف صدفتك مع نسخة احتياطية بجوارها؛ ويمكن إزالة الكتلة من المكان نفسه.
• تُكتب إصلاحات PATH وخطّاف الموجّه لـ bash ‏(~/.bashrc) وzsh ‏(~/.zshrc)؛ وfish غير مدعوم بعد.
• اللغات غير الموجودة على الحاسوب بعد مدرجة تحت Add a language: اختر واحدة لتثبيت mise إن لزم، ثم إصدارًا.
• Windows: يسأل QuickDesk ‏PowerShell عمّا تشغّله الطرفية الجديدة ويعمل عبر mise (المثبَّت في %LOCALAPPDATA%\mise\bin) وrustup وuv؛ ويُعرض nvm-windows وfnm دون تعديلهما، ويُتجاهَل الملف البديل python.exe الخاص بالمتجر. يضع Fix PATH… مجلدات الأداة (وبالنسبة إلى mise ‏shims الخاصة به) في مقدمة PATH الخاص بحسابك — ذاك الموجود في Settings → Environment Variables — دون صلاحيات المسؤول؛ وتُحفظ القيمة القديمة في ~\.config\quickdesk\path، واللوحة نفسها تزيل المجلدات مجددًا. تلتقطه الطرفيات الجديدة؛ وبعد ذلك تُطبَّق تغييرات الافتراضي فورًا. لا حاجة إلى “Apply right away” على Windows ولا يُعرض هناك.
• النسخ التي ثبّتها النظام (apt وdnf) لا تُغيَّر ولا تُزال أبدًا؛ ولا يشغّل QuickDesk ‏sudo أبدًا. أما اللغات التي تديرها أدوات لا يدعمها (fnm وvolta وpyenv وSDKMAN…) فتُعرض للقراءة فقط.

استخدام الذكاء الاصطناعي

حلقة في الشريط العلوي تُظهر كم استهلكت من حدود الذكاء الاصطناعي، بالأخضر أو الكهرماني أو الأحمر. تعرض قائمتها الأداة التي تتتبعها، مع شريط لكل حد وموعد إعادة ضبطه؛ ويعرض تبويب AI كل الأدوات.

• Claude Code: يقرأ QuickDesk تسجيل الدخول الذي حفظه Claude Code على هذا الحاسوب ويسأل Anthropic عن استخدامك، مرة كل 5 دقائق على الأكثر. يُقرأ الرمز فقط: لا يُخزَّن ولا يُجدَّد ولا يُرسَل إلى أي مكان سوى Anthropic.
• Codex: يُقرأ من سجلات الجلسات التي يحفظها Codex في ~/.codex.
• Gemini ‏(Antigravity): لا يعطي نسبة مئوية، لذلك يعرض QuickDesk من سجلاته آخر مرة نفدت فيها حصتك.

اختر الأداة والحد اللذين تريد متابعتهما من Track، أو أخفِ الحلقة من تبويب AI.

التحديثات

يتحقق QuickDesk من وجود إصدار جديد بعد 30 ثانية من تشغيله ثم كل 6 ساعات. وعندما يصدر إصدار، يخبرك به شريط في النافذة الرئيسية وعنصر في أعلى قائمة العلبة، مع What’s New. لا يُثبَّت شيء حتى تنقر Update Now.

يُتحقَّق من كل تحديث بمفتاح توقيع QuickDesk قبل تثبيته. يطلب ملف .deb أو .rpm كلمة مرور المسؤول؛ ويستبدل AppImage نفسه. ثم يعيد QuickDesk تشغيل نفسه ويعرض ما تغيّر. أوقف التحقق التلقائي، أو تحقّق يدويًا، من Settings → Updates.

إزالة التثبيت

1. أوقف Start QuickDesk when I log in في Settings، وأنهِه من العلبة.
2. أزِل الحزمة: sudo apt remove quick-desk ‏(Debian/Ubuntu) أو sudo dnf remove QuickDesk ‏(Fedora)، أو احذف ملف AppImage.
3. تبقى بياناتك في ~/.local/share/click.quickdesk حتى تحذف ذلك المجلد.

Windows: Settings → Apps → Installed apps → QuickDesk → Uninstall. تبقى بياناتك في %APPDATA%\click.quickdesk حتى تحذف ذلك المجلد.

إزالة الحزمة تزيل أيضًا إذن اللصق الفوري إن كنت قد فعّلته.

حل المشكلات

• اختصار لا يفعل شيئًا: تحقّق من وجود تعارض في Settings → Keyboard → Custom Shortcuts، أو اختر تركيبة أخرى في Settings → Hotkeys.
• اللصق التلقائي لا يكتب شيئًا: تأكّد أن التطبيق الذي كنت فيه ما زال في المقدّمة؛ وغيّر الطريقة في Settings → Auto-paste. العنصر يُنسَخ دائمًا، لذا يعمل Ctrl V.
• السجلات: ~/.local/share/click.quickdesk/logs/. أرفقها عندما تبلّغ عن مشكلة.