الميزات

• يعمل دون اتصال بالإنترنت بالكامل.
• تشفير آمن باستخدام Argon2id لاشتقاق المفاتيح والتشفير الموثّق عبر libsodium.
• مولّد كلمات مرور آمن.
• واجهة TUI مخصّصة مبنية دون مكتبات خارجية.

---

التثبيت

AppImage

نزّل ملف AppImage من releases ثم شغّل:

chmod +x klip-x86_64.appimage 
./klip-x86_64.appimage

البناء من المصدر

الاعتماديات:

• libsodium

التثبيت:

git clone https://github.com/vid4l-07/Klip.git
cd klip
mkdir build
cd build
cmake ..
make
sudo make install

---

الاستخدام

عام

المفتاح	الإجراء
q	خروج

شريط التبويبات

المفتاح	الإجراء
l / Right	الانتقال يمينًا
h / Left	الانتقال يسارًا
Enter	فتح قاعدة البيانات المحددة
o	فتح/إنشاء قاعدة بيانات جديدة
x	إغلاق قاعدة البيانات المحددة

قاعدة البيانات

المفتاح	الإجراء
Esc	التركيز على شريط التبويبات
j / Down	الانتقال للأسفل
k / Up	الانتقال للأعلى
Enter	تحديد/نسخ
n	بيانات اعتماد جديدة
f	تصفية حسب الموقع
e	تعديل بيانات الاعتماد
d	حذف بيانات الاعتماد
g	توليد كلمة مرور آمنة

النسخ إلى الحافظة

عند تحديد بيانات اعتماد:

• Enter على User ينسخ اسم المستخدم.
• Enter على Pass ينسخ كلمة المرور.

فتح ملف

عند اختيار Open، تظهر نافذة نصية منبثقة. داخل النافذة، يمكنك الضغط على Tab للتنقل بين قواعد البيانات المفتوحة مؤخرًا.

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

تُخزَّن مسارات الملفات الأخيرة في $HOME/.config/klip/recents.

---

الأمان

توجد جميع منطق التشفير في src/Security.cpp

اشتقاق المفتاح

• عند إنشاء قاعدة بيانات، يُطلب إدخال كلمة مرور رئيسية.
• يُشتق مفتاح تشفيري من كلمة المرور وملح عشوائي فريد باستخدام crypto_pwhash من libsodium، استنادًا إلى Argon2id في وضع INTERACTIVE (معاملات تكلفة قابلة للتعديل ضد هجمات القوة الغاشمة).

التشفير

• تُشفَّر قاعدة البيانات باستخدام crypto_secretbox_easy بالمفتاح المشتق وnonce عشوائي.
• توفّر هذه الخوارزمية كشف التلاعب عبر MAC.

صيغة التخزين

• يُخزَّن الملف المشفَّر بصيغة ثنائية بالشكل التالي:

[salt][nonce][ciphertext]

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

• يُشتق المفتاح باستخدام كلمة المرور التي أدخلها المستخدم والملح المخزَّن.
• تُفكّ تشفير البيانات باستخدام crypto_secretbox_open_easy.
• إذا كانت كلمة المرور غير صحيحة أو تم تعديل الملف، يفشل التحقق من MAC وتُرفض العملية.

---

المساهمات

المساهمات مرحّب بها دائمًا. إذا وجدت خطأً أو أردت المساعدة في ميزات جديدة، يمكنك:

• فتح issue في المستودع.
• فتح pull request.