بلیک‌ها — راهنمای کاربر

استفاده از بلیک‌ها

بلیک‌ها بلوک‌های سازنده OrbitingFox هستند. یک بلیک می‌تواند یک یادداشت، کار، رویداد، هزینه، یادآوری، یا هر قطعه دیگری از اطلاعاتی که می‌خواهید ثبت کنید باشد.

ایجاد یک بلیک

1. از منوی اپلیکیشن بلیک‌ها را باز کنید.
2. روی بلیک جدید کلیک کنید و یک نوع انتخاب کنید: یادداشت، کار، رویداد، هزینه، یادآوری و غیره.
3. عنوان، متن، تاریخ سررسید (برای کارها/رویدادها) و هر برچسبی را پر کنید.
4. ذخیره کنید. بلیک شما بلافاصله در تمام اپلیکیشن‌هایی که از پیوند بلیک‌ها پشتیبانی می‌کنند در دسترس است.

انواع بلیک

• یادداشت — ضبط متن آزاد. به یادداشت چسبیده دیجیتال فکر کنید.
• کار — مورد قابل انجام با تاریخ سررسید و پرچم تکمیل.
• رویداد — در تقویم شما ظاهر می‌شود.
• هزینه — ورودی مالی؛ به داشبورد مالی مرتبط می‌شود.
• یادآوری — در زمان مقرر یک اعلان را فعال می‌کند.

پیوند دادن بلیک‌ها

بلیک‌ها می‌توانند به اهداف، پروژه‌ها، کسب‌وکارها و فضاهای FoxCom پیوند داده شوند تا زمینه‌ای غنی‌تر فراهم کنند. آن‌ها همچنین زمانی که به بورد کانبان اضافه می‌شوند، در آنجا ظاهر می‌شوند.

OrbitPilot

تمام بلیک‌های شما در دسترس OrbitPilot هستند. سؤال‌هایی مانند "این هفته چه کارهایی سررسید دارد؟" یا "هزینه‌های من برای ماه مه را خلاصه کن." بپرسید.

تصاویر در توصیف یک بلیک (2026-08)

شما می‌توانید یک تصویر را مستقیماً در توصیف یک بلیک الصاق یا رها کنید — برای یادداشت‌هایی که در آن‌ها یک تصویر بین خطوط مناسب است. این تصاویر اکنون کاملاً قابل تغییر شکل بوده و پیدا کردن آن‌ها آسان است:

• تغییر اندازه و جابجایی: روی یک تصویر حرکت کنید تا آن را انتخاب کنید، سپس هر گوشه‌ای را بکشید تا اندازه آن را تغییر دهید، یا از نوار ابزار کوچک برای تنظیم اندازه (کوچک / متوسط / بزرگ / کامل) و تراز آن به چپ، وسط یا راست استفاده کنید. همچنین با لمس روی تلفن‌ها و تبلت‌ها کار می‌کند.
• در بخش تصاویر نمایش داده می‌شود: تصاویر موجود در توصیف همچنین در فهرست تصاویر بلیک ظاهر می‌شوند (و "تصاویر موجود" در صفحه ویرایش)، با برچسبی از نوع 📝 "در یادداشت" تا بتوانید آن‌ها را از تصاویر جداگانه متمایز کنید. در آنجا دکمه حذف ندارد به عمد — برای حذف یک تصویر، آن را در متن توصیف پاک کنید تا به‌طور تصادفی تصویر مرتبط با یادداشت خود را رها نکنید.
• باز کردن به صورت تمام‌سایز: روی هر تصویر (متصل یا در یادداشت) کلیک کنید تا آن را در یک تب جدید به‌صورت بزرگ باز کنید.

برای توسعه‌دهندگان: ماژول مینی تغییر اندازه/تراز در templates/blink/_blink_form.html وجود دارد (پوشش متصل به محتوای ویرایشگر، خارج از محتوای قابل ویرایش Quill، بنابراین Quill آن را حذف نمی‌کند؛ عرض به عنوان ویژگی width تصویر ذخیره می‌شود و تراز به عنوان text-align در بلاک — هر دو از فیلتر render_description عبور می‌کنند). فیلتر blink_extras.description_images تصاویر درون یادداشت را در بر می‌گیرد (سیاست تأمین: data:image/* به جز svg، http(s)، سایت-نسبی). تصاویر Data-URI از طریق یک URL blob (templates/blink/_note_image_open_js.html) باز می‌شوند زیرا مرورگرها دسترسی به URLهای data: را مسدود می‌کنند.

فرمت‌بندی یادداشت‌ها و صفحه ویرایش مرتب‌تر (2026-08)

روی
Formatting در بالای توصیف یک بلیک کلیک کنید تا نوار ابزار سبک را نمایش دهد. اکنون شامل رنگ متن و هایلایت به همراه حالت‌های پررنگ، مایل، سرعنوان‌ها، لیست‌ها، نقل‌قول‌ها، کد و تراز است.

• چگونه فرمت دهی کنیم: کلمات مورد نظر خود را انتخاب کرده و روی یک سبک کلیک کنید. اگر فقط مکان‌نمای خود را درون یک کلمه قرار دهید و روی یک سبک کلیک کنید، به آن کلمه اعمال می‌شود — نیازی به انتخاب نیست. یک راهنما در زیر نوار ابزار به شما یادآوری می‌کند.
• رنگ‌ها و هایلایت با یادداشت ذخیره می‌شوند و در صفحه بلیک نمایش داده می‌شوند.

صفحه ویرایش اکنون به کارت‌های با برچسب واضح سازماندهی شده است — جزئیات بلیک، تصاویر، فایل‌ها و یادداشت‌های صوتی — بنابراین هر بخش به راحتی قابل شناسایی است. دکمه‌های به‌روزرسانی · پیش‌نمایش · لغو زیر فرم در کنار هم قرار دارند و در پایین صفحه تکرار شده‌اند، بنابراین می‌توانید بدون اسکرول به بالا، ذخیره کنید.

برای توسعه‌دهندگان: استفاده از رنگ/هایلایت در Quill با ایجاد استایل خطی انجام می‌شود (attributors/style/color + /background)؛ توصیف سانیتایزر (blink_extras.render_description) اعلان‌های استایل را به‌صورت جداگانه تأیید می‌کند — تراز متن + رنگ/پس‌زمینه با مقادیر hex/rgb()/rgba()/نام‌گذاری شده حفظ می‌شود، هر چیز دیگر (موقعیت، url()، ...) حذف می‌شود. سبک کردن بر روی کلمه در مکان‌نما یک کمک‌کار است که در _blink_form.html انجام می‌شود. نوار عمل پایین فرم را از طریق form="blink-edit-form" ارسال می‌کند.

نگه‌داری یک بلیک خصوصی از OrbitPilot (2026-08-23)

برخی از مواردی که شما ثبت می‌کنید به هیچ کس دیگری مربوط نیست — حتی به دستیار شما. هر بلیک اکنون دارای یک سوئیچ جمع و جور است (روی "i" کوچک کنار آن ضربه بزنید تا بخوانید چه کاری انجام می‌دهد)، "این بلیک را از OrbitPilot خصوصی نگه‌دار"، در پایین زبانه اصلی در فرم بلیک. این به‌طور پیش‌فرض خاموش است، به این معنی که OrbitPilot می‌تواند آن را بخواند — نیازی به روشن کردن هیچ چیزی نیست.

آن را روشن کنید و آن بلیک به خصوصی برای شما تبدیل می‌شود: OrbitPilot دیگر نمی‌تواند آن را بخواند و همچنین دسترسی به یادداشت‌های صوتی، تصاویر و فایل‌های آن بلیک را از دست می‌دهد. هر چیزی که قبلاً از آن بلیک حفظ کرده است به‌طور مستقیم حذف می‌شود — نیازی به ساخت دوباره هیچ چیزی نیست یا منتظر ماندن. در کتابخانه شما بلیک با یک برچسب کوچک خصوصی خود را نشان می‌دهد تا شما بتوانید در یک نگاه ببینید کدام‌ها را هوش مصنوعی نمی‌تواند ببیند.

شما می‌توانید هر زمانی آن را خاموش کنید؛ بلیک در دفعه بعد که حافظه شما بازسازی می‌شود به دانش هوش مصنوعی باز می‌گردد. این در کنار دو کنترل کلی‌تری است که شما قبلاً دارید: انتخاب کدام قسمت‌های فضای کار شما OrbitPilot می‌تواند بخواند و پوشه فایل‌های OrbitPilot برای اسناد.

اصطلاحات: بلیک واژه اصلی است (2026-08-23)

مالک تصمیم گرفت که بلیک واژه‌ای است که به‌صورت اصلی برای کاربر نمایان است. وینک به عمد به‌عنوان نام مستعار سابق زنده است: در داستان نامگذاری در فلسفه ما، سوالات متداول و اصطلاحات نامگذاری شده است و بازیاب OrbitPilot هنوز با آن سازگار است تا عبارت‌ها و لینک‌های قدیمی‌تر همچنان کار کنند. زمانی که شما متن جدیدی می‌نویسید، بلیک بنویسید.

تبدیل به تدریج انجام می‌شود — به docs/brand/BLINK-RENAME-PLAN.md و docs/BACKLOG.md مراجعه کنید — و تحت نظارت manage.py terminology_audit و adminapp/test_terminology.py است، یک چرخ دنده که ممکن است شمارش آن کاهش یابد اما هرگز افزایش پیدا نکند.

⚠ شناسه‌های کدی که blink را می‌خوانند منجمد هستند، نه در حال انتظار کار. max_winks یک Feature.key زنده در پس محدودیت‌های طرح است — تغییر نام آن باعث می‌شود که دروازه باز شود. همین امر در مورد نام فایل‌های الگو، نام‌های URL، کلیدهای جلسه، کلاس‌های CSS و {wink_title} سبک‌های خاص درون متون نجات‌یافته از مدیریت نیز صدق می‌کند. فهرست کامل انجماد در طرح و در terminology.ALLOWED_IDENTIFIERS وجود دارد.

"یک بلیک دیگر بگیرید" پس از ذخیره یک بلیک (2026-08-28)

بنر بلیک ذخیره شد! بعد کجا؟ در داشبورد بلیک چهار گزینه ارائه می‌دهد. سه مورد از آن‌ها شما را به جایی دیگر می‌برد. چهارمی، یک بلیک دیگر بگیرید، قبلاً به داشبورد اشاره داشت — صفحه‌ای که شما پیشتر روی آن بودید — بنابراین هر بار که دوباره بارگذاری می‌شد، همه چیز را برای نمایش یک فرم بلیک که از قبل باز بود و خالی بود، دوباره بارگذاری می‌کرد، چند صد پیکسل پایین‌تر روی همان صفحه.

حالا شما را به آن فرم می‌برد: به پنل "یک بلیک بگیرید" می‌پرد، اگر جمع شده باشد آن را باز می‌کند و مکان‌نما را در عنوان قرار می‌دهد تا خاطر بعدی را فوراً تایپ کنید. بدون بارگذاری صفحه، هیچ چیز از دست رفته.

یادداشت توسعه‌دهنده: کنترل در #blinkCatchAnother در templates/dashboard.html وجود دارد، یک لنگر به #blink-create-panel با رفتار باز و تمرکز در بلوک اسکریپت آن الگوی خودش. خود بنر بر روی پرچم زمینه blink_just_saved محدود شده است (blink/views.py، از ?blink_saved=1 تنظیم شده است). این موضوع توسط blink/test_post_save_where_next.py پین شده است، از جمله اینکه سه دکمه دیگر هنوز صفحه را ترک می‌کنند.

توضیحات طولانی دیگر به بالای صفحه نمی‌پرند (2026-08-28)

اگر جزئیات یک بلیک طولانی بود، کلیک کردن روی آن و دوباره ورودی دادن صفحه را به بالای صفحه می‌برد، بسیار بالاتر از جایی که شما تایپ می‌کردید. در گوشی، یک توصیف حدود شصت پاراگراف حدود دو هزار پیکسل بین مکان‌نما شما و جایی که فرود آمدید گذاشته بود.

جعبه جزئیات اکنون دارای ارتفاع حداکثر است و درون خود پیمایش می‌کند، مشابه آنچه ویرایشگرها معمولاً انجام می‌دهند. مکان شما حفظ می‌شود، صفحه به طول منطقی باقی می‌ماند و هیچ چیز پنهان نمی‌شود — متن طولانی به سادگی درون جعبه پیمایش می‌شود به جای اینکه صفحه را کش دهد.

هیچ‌چیز در مورد نوشتن یا ذخیره تغییر نکرده است؛ فقط شکل جعبه تغییر کرد.

یادداشت‌های توسعه‌دهنده — دلیل اینکه این اتفاق افتاد (BL-66)

علت این موضوع یک باگ در کد ما نبود. ویرایشگر توصیف یک منطقه ویرایشی نامحدود بود: با یک توصیف بلند، ابعاد آن 4933px ارتفاع بود در عرض 375px. تمرکز بر روی یک عنصر باعث می‌شود مرورگر آن عنصر را به حالت دید بیاورد، و آن عنصر شروع به اندازه‌گیری هزاران پیکسل بالاتر از مکان‌نما کرد — بنابراین مرورگر به‌طور صحیح رفتار می‌کرد و ویرایشگر به سادگی شکل اشتباهی داشت.

قبل و بعد اندازه‌گیری شده: با یک توصیف 60 پاراگرافی:

• قبل — 375px: scrollY 2379 → 134 در بازتوجه؛ 1280px: 1032 → 0; صفحه 6729px طول داشت
• بعد — 375px: 213 → 213 → 213; 1280px: 311 → 308; صفحه 2056px طول داشت

تغییر در templates/blink/_blink_form.html است: #desc-editor max-height + overflow-y: auto (420px، 260px زیر نقطه شکست مرجع 575.98px) را می‌گیرد، و اندازه‌گیری آن از یک style= درون‌خط حذف شده و به stylesheet الگو منتقل شده است — یک سبک درون‌خط نمی‌تواند توسط درخواست‌ور بهینه‌سازی صفحه نمایش گوشی لغو شود، به همین دلیل است که این دو باید با هم منتقل شوند. پر کردن سفید به --of-surface-strong توکن در یک کلاس جدید .of-desc-editor-wrap تبدیل شده است، به‌گونه‌ای که هیچ چیز دیگر آن را به ارث نمی‌برد.

آزمایشات. blink/test_description_editor_scroll.py محدودیت را مشخص می‌کند، محدودیت خاص گوشی، نقطه شکست مرجع و عدم وجود سبک‌های درون‌خط. blink/test_description_editor_visual.py کروم واقعی را راه‌اندازی کرده و موقعیت پیمایش را در 375 و 1280 اندازه‌گیری می‌کند؛ در آنجا جایی که Playwright غایب است رد می‌زند، بنابراین CI بدون مشکل باقی می‌ماند و هیچ وابستگی اضافه نمی‌شود.

یک تله که رکوردهای فایل‌ها برای تست سرور زنده بعدی ایجاد می‌کند: یک LiveServerTestCase یک TransactionTestCase است و پس از هر تست جداول را کوتاه می‌کند و ردیف‌های برنامه‌ریزی شده را با آن‌ها می‌برد. بدون یک طرح، اپلیکیشن به /billing/plans/ ارجاع می‌دهد، بنابراین تست اول موفق است و هر تست بعدی یک صفحه 500 بارگذاری می‌کند. راه‌حل این است که آنچه که صفحه نیاز دارد دوباره تولید شود در setUp (از طریق apps.get_model، هرگز یک واردات میان‌برنامه‌ای — دنده‌ی متصل همچنین آن‌ها را در تست‌ها حساب می‌کند).