افتح مجلد مشروعك
أنشئ مجلدًا، وانسخ إليه ملفاتك المصدَّرة، واختره مجلد عمل للمحادثة. احتفظ بالأصول في مكان آخر.
سير العمل
برنامج لتتبّع العملات الرقمية تبنيه خطوة بخطوة
03
حوّل ملفاتك المصدَّرة إلى جدول حيازات واحد
يعني برنامج تتبّع العملات الرقمية في هذا الدليل نصًا برمجيًا صغيرًا وجدولًا تملكه. يكفي جدول من صفوف مؤرخة لسجل شخصي للحيازات، لذلك تبدأ بملفات مصدَّرة من مصدرين وتنتهي بالحيازات والرسوم لكل أصل. احتفظ بالأصول.
اطلب خطة أولًا
انتقل إلى Plan only وصف الجدول الذي تريده. يسرد الوكيل الخطوات ولا يشغّل شيئًا.
راجع ثم شغّل
انتقل إلى Ask first، واقرأ كل diff، واقبله، ثم اترك Shell يشغّل نص المتتبّع ويبلغ عن رمز الخروج.
افحص النتيجة
افتح ملف CSV الناتج وقارن المجاميع بكشف حساب كل منصة قبل أن تعتمد على أي رقم.
سجل معاملات يقرؤه النص البرمجي
اقرأ transactions.csv واجمع الكمية والرسوم لكل أصل واحفظ النتيجة.
- read_file
transactions.csvتمت قراءة الترويسة - write_file
totals.pyتم الحفظ - Shell
your tracker scriptexit 0 - read_file
totals.csvأصلان
بانتظار موافقتك قبل الخطوة التاليةرفضقبول
transactions.csv
date,asset,amount,price_usd,fee_usd
2026-01-05,COINA,10.5,2.00,0.10
2026-01-19,COINA,5,2.40,0.05
2026-02-02,COINB,0.25,40.00,0.20
2026-02-16,COINA,8,1.90,0.08
2026-03-02,COINB,0.10,44.50,0.09
2026-03-16,COINA,12.25,2.10,0.12
2026-04-01,COINB,0.30,39.00,0.25
2026-04-15,COINA,6,2.30,0.06
2026-05-01,COINB,0.15,41.00,0.12كل صف يمثل عملية شراء واحدة: التاريخ والأصل والكمية والسعر والرسوم. جميع القيم مختلقة. يمكن لتطبيق بسيط لتتبّع المحفظة أن يبدأ من هذه الأعمدة الخمسة من النص العادي، وCOINA وCOINB ليستا عملتين حقيقيتين.
خطوات المبتدئين نحو متتبّع محفظة web3
احسب متوسط التكلفة لكل عملة
متوسط التكلفة هو إجمالي ما أنفقته على عملة، شاملًا الرسوم، مقسومًا على الوحدات التي اشتريتها، وهكذا تتتبّع متوسط تكلفة DCA للمشتريات المنتظمة بمبلغ ثابت. اطلب من الوكيل نصًا برمجيًا يجمّع الصفوف حسب الأصل، فيقرأ الملف بواسطة read_file ويحفظ النص بواسطة write_file ويستخدم الحساب العشري للمال. في وضع Ask first تقرأ الـ diff قبل حفظ الملف. بعد ذلك يشغّل Shell نص المتتبّع الخاص بك ويعرض رمز الخروج الفعلي. افتح النتيجة. افحص عملة واحدة يدويًا، لأن حسابًا منفصلًا يؤكد رقم النص البرمجي.
تقييم حيازاتك بأسعار عامة
الجدول نفسه يصلح لعملة BTC: ضع BTC في عمود الأصل فيصبح لديك متتبّع محفظة BTC مصغّر. يضيف الوكيل خطوة يجلب فيها http_get صفحة أسعار عامة واحدة، ولا تحتاج إلى أي مفتاح، ويكتب النص وقت الجلب بجانب كل قيمة. الأسعار لقطات لحظية. وهي تختلف بين المصادر. دوّن مصدر السعر الذي استخدمته، لأن مصدرًا آخر يعطي مجاميع مختلفة. شغّل النص، وافتح ملف CSV الناتج، وقارن المجموع بكشف حساب منصتك قبل أن تثق به.
