پرش به مطلب اصلی

تغییرات

این صفحه همه تغییرات مهم پلتفرم Blocklens و API آن را مستند می‌کند.

2026-05-17​

Snapshot API

  • اکنون خروجی SVG در کنار PNG یک شهروند درجه‌یک است. فیلد format در POST /v1/chart/snapshot مقادیر "png"، "svg" یا "json" را می‌پذیرد؛ هر دو روش GET و POST نیز Accept: image/svg+xml را رعایت می‌کنند.
  • مسیر جدید: GET /v1/chart/renders/{render_id}.svg — تصاویر SVG رندرشده برای ۱ ساعت نگه‌داری می‌شوند و از طریق URL قابل بازیابی هستند، که رفتار موجود .png را بازتاب می‌دهد.
  • پاسخ‌های SVG اکنون شامل X-Render-Id هستند تا بتوان URL پایدار را از یک فراخوانی رندر واحد بازسازی کرد.
  • نسخه‌های PNG و SVG از یک نمودار واحد به‌صورت مستقل کش می‌شوند.
  • لایه‌های روی‌هم عملکرد چرخه (x_axis: "day_offset") اکنون برچسب‌های تیک محور X را به‌صورت تاریخ‌های تقویمی از آخرین چرخه خانواده انتخاب‌شده رندر می‌کنند (مثلاً Oct '25، Jan '26، … برای لایه‌های روی‌هم ATH که در cycle_ath_5 → 2025-10-06 لنگر گرفته‌اند) به‌جای Day 0، Day 90، … . چرخه‌های پیشین در همان موقعیت‌های محور هم‌تراز باقی می‌مانند.

MCP Server

  • render_chart: مجموعه مقادیر پارامتر format اکنون "png" | "svg" | "json" است (پیش‌تر "png" | "json" بود). وقتی format: "svg" ارسال شود، ابزار یک بلوک محتوای image/svg+xml و یک URL از نوع /chart/renders/{id}.svg را در خلاصه بازمی‌گرداند.

2026-04-02​

Metrics & API

  • تعداد متریک‌ها از ۱۲۷ به بیش از ۲۱۰ متریک فعال گسترش یافت (صرافی‌ها، مشتقات، DAT و موارد دیگر).
  • نقطه پایانی جدید: GET /v1/cycle-boundaries — تاریخ‌های شروع/پایان و مدت‌زمان چرخه‌های هاوینگ بیت‌کوین.
  • Metrics API اکنون برای قالب‌بندی یکپارچه پاسخ‌ها از یک سازنده پرس‌وجوی مبتنی بر رجیستری استفاده می‌کند.

Snapshot API

  • رندر نقشه حرارتی (Heatmap): نمودارهای مبتنی بر توزیع (مثلاً توزیع مبنای هزینه) را با مقیاس‌های رنگی قابل‌پیکربندی (viridis، plasma و غیره) و مقیاس‌های محور Y رندر کنید. شامل راهنمای مقیاس رنگ است.
  • نمودارهای لایه روی‌هم عملکرد چرخه: x_axis: "day_offset" همه چرخه‌های هاوینگ را برای مقایسه با Day 0 هم‌تراز می‌کند.
  • پارامتر جدید برای هر متریک: show_in_legend — کنترل اینکه آیا متریک‌های منفرد در راهنمای نمودار ظاهر شوند یا نه.

MCP Server

  • ابزار جدید: get_cycle_boundaries — پرس‌وجوی مستقیم تاریخ‌های چرخه هاوینگ از سوی عامل‌های هوش مصنوعی.
  • render_chart اکنون از رندر نقشه حرارتی و لایه‌های روی‌هم عملکرد چرخه پشتیبانی می‌کند.
  • پایگاه کد یکپارچه TypeScript (tools.ts) برای همه ابزارهای MCP.
  • تعداد ابزارها: ۱۸ ← ۱۹.

2025-09-25​

  • راه‌اندازی اولیه سایت مستندات docs.blocklens.co.