فراتر از چت‌بات‌ها، نزدیک‌تر به انسان

در دنیایی که هوش مصنوعی هر روز مرزهای تازه‌ای را فتح می‌کند، مدل جدید GPT-4o از شرکت OpenAI نقطه‌ی عطفی در مسیر تعامل طبیعی‌تر میان انسان و ماشین به شمار می‌آید. این مدل چندوجهی با توانایی پردازش همزمان متن، تصویر و صوت، تجربه‌ای بی‌سابقه از گفت‌وگوهای هوشمند و واکنش‌های لحظه‌ای را فراهم کرده است. نسخه جدید Realtime API نیز با بهره‌گیری از قدرت GPT-4o، امکان ساخت دستیارهای صوتی با واکنش سریع، صدای طبیعی و درک عمیق‌تر از زبان انسانی را فراهم می‌کند.

ویژگی‌های برجسته gpt-realtime:
- تبدیل گفتار به گفتار (Speech-to-Speech): برخلاف مدل‌های قبلی که گفتار را به متن و بعد دوباره به گفتار تبدیل می‌کردند، این مدل مستقیماً گفتار تولید می‌کند. این باعث کاهش تأخیر و طبیعی‌تر شدن مکالمه می‌شود.
- درک بهتر دستورها: مدل می‌تواند دستورهای پیچیده را دقیق‌تر دنبال کند، مثل گفتن جملات با لحن خاص یا تکرار دقیق اطلاعات مثل شماره‌ها و حروف.
- توانایی چندزبانه: می‌تواند وسط جمله زبان را عوض کند و حتی نشانه‌های غیرکلامی مثل خنده را تشخیص بدهد.
- صداهای جدید: دو صدای جدید به نام‌های Cedar و Marin معرفی شده‌اند که طبیعی‌ترین کیفیت گفتار را دارند.

قابلیت‌های جدید Realtime API:
- پشتیبانی از تصاویر: حالا می‌توانید عکس یا اسکرین‌شات را همراه با صوت یا متن ارسال کنید تا مدل بتواند درباره آن تصویر صحبت کند.
- تماس تلفنی با SIP: امکان تماس صوتی واقعی از طریق پروتکل SIP فراهم شده است.
- اتصال به سرورهای MCP: برای استفاده از ابزارهای خارجی بدون نیاز به تنظیمات پیچیده.
- قیمت‌گذاری جدید: هزینه‌ها ۲۰٪ کاهش پیدا کرده و کنترل بیشتری روی طول مکالمه‌ها برای کاهش هزینه فراهم شده است.

🔗 برای آشنایی بیشتر این مطلب را مطالعه کنید.

———
⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#نگار_قاسمی (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy
_______

ساخت شرط‌های پویا با OR در LINQ to SQL

در بسیاری از پروژه‌های نرم‌افزاری، نیاز داریم تا بر اساس ورودی‌های کاربر، فیلترهایی را به صورت پویا روی داده‌ها اعمال کنیم. یکی از چالش‌های رایج، ترکیب چند شرط با عملگر OR در کوئری‌های LINQ است، به‌ویژه زمانی که از LINQ to SQL استفاده می‌کنیم.

مشکل کجاست؟
در LINQ، وقتی چند .()Where پشت سر هم استفاده می‌کنیم، شرط‌ها به صورت AND ترکیب می‌شوند. اما اگر بخواهیم چند شرط را با OR ترکیب کنیم، نمی‌توانیم به راحتی از .()Or استفاده کنیم، چون <<Expression<Func<T, bool چنین متدی ندارد.

راه‌حل: استفاده از Expression.OrElse
برای ساخت شرط‌های OR، باید از Expression.OrElse استفاده کنیم و پارامترهای مشترک را با دقت جایگزین کنیم. در ادامه، روشی ارائه می‌شود که لیستی از شرط‌ها را دریافت کرده و آن‌ها را با OR ترکیب می‌کند:

public static Expression<Func<T, bool>> OrElse<T>(IEnumerable<Expression<Func<T, bool>>> expressions)
{
    var parameter = Expression.Parameter(typeof(T), "x");
    Expression? body = null;

    foreach (var expr in expressions)
    {
        var visitor = new ReplaceParameterVisitor(expr.Parameters[0], parameter);
        var visitedBody = visitor.Visit(expr.Body);
        body = body == null ? visitedBody : Expression.OrElse(body, visitedBody);
    }

    return body != null
        ? Expression.Lambda<Func<T, bool>>(body, parameter)
        : x => false;
}

class ReplaceParameterVisitor : ExpressionVisitor
{
    private readonly ParameterExpression _oldParam;
    private readonly ParameterExpression _newParam;

    public ReplaceParameterVisitor(ParameterExpression oldParam, ParameterExpression newParam)
    {
        _oldParam = oldParam;
        _newParam = newParam;
    }

    protected override Expression VisitParameter(ParameterExpression node)
    {
        return node == _oldParam ? _newParam : base.VisitParameter(node);
    }
}

مثال:
فرض کنید می‌خواهید لیستی از افراد را فیلتر کنید که یا سن‌شان بالای ۳۰ باشد، یا نام‌شان با "ن" شروع شود، یا فعال باشند:

var filters = new List<Expression<Func<Person, bool>>>
{
    p => p.Age > 30,
    p => p.Name.StartsWith("ن"),
    p => p.IsActive
};

var combined = OrElse(filters);
var result = db.People.Where(combined);

این کوئری به صورت زیر در SQL ترجمه می‌شود:

WHERE Age > 30 OR Name LIKE 'ن%' OR IsActive = 1

🔗 جهت آشنایی و مطالعه بیشتر اینجا و اینجا را می‌توانید ببینید.
___________

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#نگار_قاسمی (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

________

ساختارها در سی‌شارپ

#csharp_for_beginners

ساختار یا struct نوعی value type در زبان سی‌شارپ است که برای نگهداری داده‌ها و رفتار مرتبط با آن‌ها استفاده می‌شود.
وقتی متغیری از نوع struct ساخته می‌شود، داده‌ها مستقیماً درون آن متغیر ذخیره می‌شوند، نه در یک شیء جداگانه در heap.
در نتیجه، وقتی یک struct به متد ارسال یا از متد بازگردانده می‌شود، کل مقدار آن کپی می‌گردد.
به همین دلیل، struct برای انواع داده‌ای کوچک و مستقل مناسب است.
در مقابل، اگر نوعی داده رفتار پیچیده یا اندازه‌ی بزرگ دارد، معمولاً کلاس گزینه‌ی بهتری است.

مثال ساده از تعریف ساختار

public struct Coords
{
    public Coords(double x, double y)
    {
        X = x
        Y = y
    }

    public double X { get }
    public double Y { get }

    public override string ToString() => $"({X}, {Y})"
}

یک نوع دیگر به نام readonly struct & readonly

می‌توان یک ساختار را با کلیدواژه readonly تعریف کرد تا تغییرناپذیر باشد.
در یک readonly struct تمام فیلدها باید readonly باشند و تمام ویژگی‌ها (properties) باید فقط getter داشته باشند یا از نوع init باشند. در این حالت ساختار دیگر قابل تغییر نیست و اطمینان حاصل می‌شود که داده‌ها پس از ساخت ثابت باقی می‌مانند.

همچنین می‌توان متدهای خاصی را با کلیدواژه readonly مشخص کرد تا نشان دهد که این متدها وضعیت ساختار را تغییر نمی‌دهند. اگر چنین متدی درون ساختار فراخوانی شود، کامپایلر از تغییر وضعیت جلوگیری می‌کند و در صورت نیاز، یک کپی موقت از ساختار ایجاد می‌کند.

مثال از readonly struct

public readonly struct Coords
{
    public Coords(double x, double y)
    {
        X = x
        Y = y
    }

    public double X { get; init; }
    public double Y { get; init; }

    public readonly override string ToString() => $"({X}, {Y})"
}

آرایه‌های درون‌خطی (inline arrays)

از نسخه‌ی سی‌شارپ ۱۲ به بعد، امکان تعریف آرایه‌های درون‌خطی در قالب struct فراهم شده است. در این نوع ساختار، فقط یک فیلد داخلی وجود دارد که شامل یک بلوک پیوسته از عناصر داده است. این ویژگی برای موقعیت‌هایی که نیاز به سرعت بالا و دسترسی سریع به حافظه وجود دارد مفید است.

مقداردهی اولیه و مقدار پیش‌فرض struct

ساختارها مستقیماً داده‌ها را درون خود ذخیره می‌کنند. هنگامی که از دستور default برای ساختار استفاده شود، همه‌ی فیلدها با مقدار پیش‌فرض خود مقداردهی می‌شوند و هیچ سازنده‌ای فراخوانی نمی‌شود.

اگر برای ساختار سازنده‌ی بدون پارامتر تعریف شود، باز هم دستور default آن را فراخوانی نمی‌کند و مقدار پیش‌فرض برای هر فیلد اعمال می‌شود.
از سی‌شارپ ۱۱ به بعد اگر سازنده مقداری برای فیلدها تعیین نکند، کامپایلر به صورت خودکار آن‌ها را با مقدار پیش‌فرض مقداردهی می‌کند.

همچنین می‌توان بدون استفاده از new یک متغیر از نوع ساختار تعریف کرد، اما در این صورت تمام فیلدهای آن باید پیش از استفاده مقداردهی شوند.



🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

🎬 برنامه‌نویسی ویدیو با React!

اگر دنبال راهی خلاقانه برای ساخت ویدیو با کدنویسی هستید، ریپازیتوری Remotion یک انتخاب بی‌نظیر است. این فریم‌ورک قدرتمند به شما اجازه می‌دهد با استفاده از React و تکنولوژی‌های وب مثل CSS، SVG، Canvas و حتی WebGL، ویدیوهای کاستوم بسازید.


برای شروع فقط کافی است دستور زیر را اجرا کنید:

npx create-video@latest

و مابقی ماجرا را در گیت هاب می‌توانید ببینید.

📚 مستندات کامل و API Reference در remotion.dev در دسترس است.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

تجربه کار با Map و پکیج‌های مختلف در Blazor و Angular

تیم ما در سال‌های اخیر زمان زیادی را برای کار کردن با Map توی بیلیزور گذراند و تجربه‌های خوبی به دست آورده‌ایم. انواع مختلف نیازمندی‌های Map را توانستیم با MapBox GL و Wrapper سی‌شارپی‌ای که برایش نوشتیم پیاده سازی کنیم.

اخیرا هم در پروژه دیگری که Angular است از Map استفاده کردیم و چون نیاز خیلی ساده‌ای داشتیم از Leaflet استفاده کردیم.

🔗 در این پست لینکدین بیشتر در مورد این تجربه صحبت کردم و توضیح دادم که دلیل استفاده از هر کدام چه بوده است. خوشحال می‌شوم اگه تجربه کار در این زمینه را دارید با ما به اشتراک بگذارید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

تعریف Enum

#csharp_for_beginners

یک Enum در واقع نوع داده‌ای سفارشی است که مجموعه‌ای از ثابت‌های عددی نام‌گذاری‌شده را در خود نگه می‌دارد. برای مثال:

enum Season
{
    Spring,
    Summer,
    Autumn,
    Winter
}

در اینجا، اعضا به ترتیب دارای مقادیر عددی 0، 1، 2 و 3 هستند. نوع پایه‌ی Enum به‌صورت پیش‌فرض int است، اما می‌توان آن را تغییر داد.

تعیین نوع پایه و مقادیر صریح

می‌توان نوع پایه و مقادیر اعضا را به‌صورت دستی مشخص کرد:

enum ErrorCode : ushort
{
    None = 0,
    Unknown = 1,
    ConnectionLost = 100,
    OutlierReading = 200
}

در این مثال، نوع پایه ushort است و هر عضو مقدار خاص خود را دارد.

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

تبدیل عددی به Enum مجاز است، اما اگر مقدار عددی به هیچ عضو مشخصی مربوط نباشد، نتیجه ممکن است نامعتبر باشد.

کاربردهای Enum

۱. انتخاب از میان چند مقدار مشخص
یک Enum زمانی مفید است که بخواهیم متغیری یکی از چند مقدار مشخص را بگیرد. مثلاً برای وضعیت سفارش یا فصل سال:

enum OrderStatus
{
    Pending,
    Processing,
    Shipped,
    Delivered
}

۲. استفاده به‌صورت ترکیبی (Flags)
گاهی لازم است چند مقدار با هم ترکیب شوند. در این حالت از ویژگی [Flags] استفاده می‌کنیم و مقادیر را به‌صورت توان‌های دو تعریف می‌کنیم:

[Flags]
public enum Days
{
    None      = 0,
    Monday    = 1,
    Tuesday   = 2,
    Wednesday = 4,
    Thursday  = 8,
    Friday    = 16,
    Saturday  = 32,
    Sunday    = 64,
    Weekend   = Saturday | Sunday
}

جمع‌بندی
ابزار Enum یکی از ابزارهای ساده اما قدرتمند در سی‌شارپ است که به شما کمک می‌کند مجموعه‌ای از مقادیر ثابت را با نام‌های قابل فهم تعریف کنید. این کار باعث افزایش خوانایی، کاهش خطا و بهبود نگهداری کد می‌شود. با رعایت چند قاعده‌ی ساده —مثل داشتن عضو صفر، اعتبارسنجی مقادیر و استفاده‌ی درست از [Flags]— می‌توان Enumهایی ساخت که در پروژه‌های واقعی بسیار کاربردی و ایمن باشند.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

پروپوزال WebMCP، باز هم همکاری مایکروسافت و گوگل!

پیشنهاد می‌کنم حتما این پروپوزال را دنبال کنید، چون تاثیر زیادی در آینده یکپارچگی مرورگرهایی مثل Edge و Chrome با ابزارهای هوش‌مصنوعی خواهد داشت.

هوش مصنوعی دارد نحوه تعامل ما با وب را متحول می‌کند. این بار WebMCP، پیشنهادی از تیم‌های Microsoft و Google، قرار است این تعامل را شفاف‌تر و قابل‌کنترل‌تر کند. با WebMCP، توسعه‌دهندگان می‌توانند مجموعه‌ای از اکشن‌ها (مثل play، pause، add-todo و ...) را به‌صورت MCP Tools مستقیم از طریق API مرورگر در اختیار ایجنت‌های هوش‌مصنوعی قرار دهند.

یعنی به‌جای اینکه AI با حدس و گمان از روی DOM یا اسکرین‌شات‌ها عمل کند، می‌تواند از خود کد اپلیکیشن استفاده کند و دقیقاً همان کاری را انجام دهد که توسعه‌دهنده مشخص کرده است. WebMCP نه ‌تنها دقت و امنیت تعاملات را بالا می‌برد، بلکه نقش توسعه‌دهنده را در عصر عامل‌های هوشمند زیاد می‌کند و عملا قسمتی از کار برنامه‌نویسی‌ وب به غیرساخت صفحات، فراهم کردن WebMCP های مناسب خواهد بود.

🔗 در این صفحه بیشتر بخوانید.

#mcp #llm #ai

#مهران_داودی (لینکدین - بلاگ)

@SoftwarePhilosophy
______

کلاس لیست (List)

#csharp_for_beginners

کلاس «لیست» یا List در فضای نام System.Collections.Generic قرار دارد و یکی از پرکاربردترین ساختارهای داده در چارچوب ‎.NET است. این کلاس نمایان‌گر مجموعه‌ای از عناصر هم‌نوع (دارای نوع مشخص) است که می‌توان به هر کدام از آن‌ها از طریق شماره‌ی ایندکس دسترسی داشت.
علاوه بر این، کلاس لیست امکاناتی برای افزودن، حذف، جستجو، مرتب‌سازی و مدیریت داده‌ها در اختیار برنامه‌نویس قرار می‌دهد.

پارامتر نوع
لیست از نوع عمومی (Generic) است و دارای پارامتری به نام T می‌باشد.
این پارامتر مشخص می‌کند که نوع داده‌ای که قرار است در لیست نگهداری شود چیست (مثلاً عدد صحیح، رشته، شیء و غیره).

سازنده‌ها (ایجادکننده‌های لیست)
کلاس لیست چند روش برای ساخت شیء جدید ارائه می‌دهد:
سازنده‌ی بدون ورودی: یک لیست خالی با ظرفیت اولیه‌ی پیش‌فرض می‌سازد.
سازنده‌ای که ورودی آن یک مجموعه است: از عناصر مجموعه‌ی داده شده، یک لیست جدید می‌سازد.
سازنده‌ای که عدد صحیح می‌گیرد: لیستی خالی با ظرفیت اولیه‌ی مشخص‌شده ایجاد می‌کند.

ویژگی‌های اصلی لیست
• ظرفیت (Capacity): تعداد کل عناصری که لیست می‌تواند بدون تغییر اندازه در خود جای دهد.
• تعداد (Count): تعداد واقعی عناصری که در حال حاضر در لیست وجود دارند.
• اندیس (Item): اجازه می‌دهد تا با استفاده از شماره‌ی اندیس، به یک عنصر دسترسی پیدا کرده یا مقدار آن را تغییر دهیم.

متدهای مهم در لیست
کلاس لیست دارای ده‌ها متد کاربردی است. در ادامه مهم‌ترین آن‌ها آورده شده است

افزودن (Add): یک عنصر جدید را به انتهای لیست اضافه می‌کند.
افزودن مجموعه‌ای از عناصر (AddRange): چندین عنصر را به انتهای لیست اضافه می‌کند.
فقط‌خواندنی (AsReadOnly): نمایی فقط برای خواندن از لیست ایجاد می‌کند که قابل تغییر نیست.
جستجوی دودویی (BinarySearch): با استفاده از الگوریتم جستجوی دودویی، عنصری را در لیست مرتب‌شده پیدا می‌کند.
پاک‌کردن (Clear): همه‌ی عناصر موجود در لیست را حذف می‌کند.
شامل بودن (Contains): بررسی می‌کند که آیا یک عنصر خاص در لیست وجود دارد یا نه.
کپی کردن (CopyTo): عناصر لیست را در آرایه‌ای دیگر کپی می‌کند.
افزایش ظرفیت (EnsureCapacity): اطمینان حاصل می‌کند که ظرفیت لیست به اندازه‌ی کافی برای اضافه شدن عناصر جدید وجود دارد.
وجود شرطی (Exists): بررسی می‌کند آیا عنصری مطابق یک شرط مشخص در لیست وجود دارد یا نه.
یافتن اولین مورد (Find): اولین عنصری که با شرط داده‌شده مطابقت دارد را برمی‌گرداند.
یافتن همه‌ی موارد (FindAll): تمام عناصری که شرط را برآورده می‌کنند بازمی‌گرداند.
یافتن اندیس (FindIndex / FindLastIndex): موقعیت اولین یا آخرین عنصر مطابق شرط را برمی‌گرداند.
برای هر عنصر (ForEach): عملی را روی تمام عناصر اجرا می‌کند.
دریافت بازه (GetRange): بخش مشخصی از لیست را به‌صورت یک لیست جدید برمی‌گرداند.
درج (Insert / InsertRange): عنصری یا مجموعه‌ای از عناصر را در موقعیت مشخصی از لیست قرار می‌دهد.
حذف (Remove): اولین وقوع یک عنصر مشخص را حذف می‌کند.
حذف شرطی (RemoveAll): همه‌ی عناصری که شرط خاصی را برآورده می‌کنند حذف می‌کند.
حذف بر اساس اندیس (RemoveAt / RemoveRange): عنصری در یک موقعیت یا بازه‌ای از عناصر را حذف می‌کند.
معکوس‌کردن (Reverse): ترتیب عناصر را برعکس می‌کند، می‌تواند کل لیست یا بخشی از آن باشد.
مرتب‌سازی (Sort): عناصر را به ترتیب صعودی یا بر اساس مقایسه‌کننده‌ی دلخواه مرتب می‌کند.
تبدیل به آرایه (ToArray): عناصر لیست را در قالب یک آرایه بازمی‌گرداند.
بهینه‌سازی حافظه (TrimExcess): ظرفیت لیست را به تعداد واقعی عناصر کاهش می‌دهد تا از مصرف بی‌مورد حافظه جلوگیری شود.
بررسی شرط برای همه (TrueForAll): بررسی می‌کند آیا همه‌ی عناصر شرط مشخصی را برآورده می‌کنند یا خیر.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

و اینک NET Conf Watch Party! 🎂🍰🥂

دات‌نت‌کانف امسال امروز (سه‌شنبه ۲۰ آبان) ساعت ۷:۳۰ شروع می‌شه. ما قراره تو آنلاین با هم رویداد رو تماشا کنیم. از ساعت ۷ لینک تیمز رو می‌فرستیم که هر کی دوست داشت بیاد.
نیم ساعت اول یکم گپ می‌زنیم و با هم آشنا می‌شیم تا رویداد شروع بشه.

هماهنگی و لینک تیمز تو این گروه انجام می‌شه: @SoftwarePhilosophyGroup

#مهران_داودی (http://ow.ly/GwIl309lFEm)

کانال تلگرام:
@SoftwarePhilosophy

___

🎯 سرویس پرداخت یکپارچه Stripe

اگر قصد دارید در پروژه‌های خارجی یا بین‌المللی پرداخت آنلاین را پیاده‌سازی کنید، یکی از بهترین گزینه‌ها استفاده از سرویس قدرتمند Stripe است. این سرویس در بسیاری از کشورها و پلتفرم‌های جهانی کاربرد دارد و مستندات جامعی برای توسعه‌دهندگان ارائه کرده است.

در این راهنما که از مستندات رسمی Stripe تهیه شده، مراحل راه‌اندازی محیط توسعه برای زبان سی‌شارپ توضیح داده شده است. این مراحل شامل موارد زیر است:

🔧 نصب Stripe CLI
ابزاری خط فرمان برای تعامل مستقیم با APIهای Stripe بدون نیاز به نوشتن کدهای اضافی.

🧰 نصب Stripe SDK برای سی‌شارپ
کتابخانه‌ای برای ارسال درخواست‌های API از داخل پروژه‌های دات‌نت، بدون نیاز به نوشتن کدهای تکراری.

🚀 استفاده از API
ساخت یک محصول و تعیین قیمت آن با استفاده از SDK، به‌صورت مرحله‌به‌مرحله و قابل اجرا در محیط تست.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

تاپل‌ها در سی‌شارپ

#csharp_for_beginners

در زبان برنامه‌نویسی سی‌شارپ، از نسخه‌های جدید‌تر مفهومی با نام تاپل‌ها معرفی شده است؛ این امکان فراهم می‌کند که چند مقدار مرتبط را به‌صورت کم‌حجم و منسجم در کنار هم نگه‌دارید. به‌طور خاص، این مقاله به نوع داده‌ای به نام «تاپل مقدار» (value-tuple) می‌پردازد که در سند رسمی مایکروسافت تحت عنوان «Tuple types (C# reference)» معرفی شده است.

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

(double, int) t1 = (4.5, 3);
Console.WriteLine($"Tuple with elements {t1.Item1} and {t1.Item2}.");

برابری (Tuple equality)ها چگونه مقایسه می‌شوند
تاپل‌ها از عملگرهای == و != پشتیبانی می‌کنند؛ این مقایسه اعضای متناظر (به ترتیب) را با اپراتور مقایسه انجام می‌دهد. نام فیلدها در مقایسه دخیل نیستند؛ به همین دلیل دو تاپل با نام‌های متفاوت اما همان ترتیب و مقادیر، برابر در نظر گرفته می‌شوند.

مثال صفحه

(int a, byte b) left = (5, 10);
(long a, int b) right = (5, 10);
Console.WriteLine(left == right);  // True

نام‌گذاری فیلدهای تاپل (Tuple field names)، جزئیات مهم

نحوهٔ تعیین نام فیلدها
نام فیلدها را می‌توان صریحاً هنگام مقداردهی یا در تعریف نوع تاپل مشخص کرد:

var t = (Sum: 4.5, Count: 3);
Console.WriteLine($"Sum of {t.Count} elements is {t.Sum}.");

یا:

(double Sum, int Count) d = (4.5, 3);

تاپل‌های زبان بر پایهٔ System.ValueTuple هستند؛ یعنی نوع مقدار (value type) و اعضای آن به‌صورت فیلدهای عمومی پیاده‌سازی شده‌اند. نتیجهٔ مستقیم این پیاده‌سازی این است که تاپل‌ها mutable value types هستند، یعنی می‌توان مقادیر فیلدهای‌شان را تغییر داد.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

اجرای ویندوز داخل داکر!

اگر با داکر (Docker) کار می‌کنید، پروژه Dockur/Windows یک ابزار فوق‌العاده برایتان خواهد بود. این پروژه متن‌باز به شما اجازه می‌دهد نسخه‌های مختلف ویندوز را داخل یک کانتینر داکر اجرا کنید، بدون اینکه نیاز به ماشین مجازی یا نصب‌های پیچیده داشته باشید.

ویژگی‌های برجسته:
- نصب خودکار ویندوز با انتخاب نسخه دلخواه (از XP تا Windows 11 و حتی Windows Server 2025)
- پشتیبانی از زبان‌های مختلف از جمله فارسی
- امکان اتصال از طریق مرورگر یا Remote Desktop
- قابلیت تنظیم مقدار RAM، CPU، اندازه دیسک و حتی عبور USB و دیسک‌های فیزیکی
- مناسب برای توسعه‌دهندگان، تست‌کنندگان نرم‌افزار و علاقه‌مندان به مجازی‌سازی

🌍 این پروژه در GitHub بیش از ۴۵ هزار ستاره گرفته و توسط هزاران نفر استفاده می‌شود. برای استفاده فقط کافی است Docker و KVM روی سیستم شما فعال باشد.

📦 نحوه استفاده:
با یک فایل Docker Compose ساده یا دستور CLI می‌توانید کانتینر را اجرا کرده و از طریق مرورگر به دسکتاپ ویندوز دسترسی پیدا کنید. همه چیز به صورت خودکار نصب می‌شود!

🔗 لینک پروژه در گیت‌هاب:
dockur/windows در GitHub1

اگر دنبال راهی سریع، سبک و قابل تنظیم برای اجرای ویندوز هستید، این پروژه را از دست ندهید. مناسب برای تست نرم‌افزار، آموزش، یا حتی استفاده روزمره در محیط‌های توسعه!

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

آشنایی با دو قابلیت جدید در ویژوال استودیو

اگر با Razor در توسعه وب کار می‌کنید، خبر خوب اینکه دو قابلیت جدید در Visual Studio و VS Code اضافه شده که حسابی کار شما را راحت‌تر می‌کند:

🔹‌ «استخراج کامپوننت» (Extract to Component):
با این قابلیت می‌توانید فقط با چند کلیک، بخش‌هایی از کد HTML را به یک کامپوننت جداگانه تبدیل کنید. دیگر نیازی به کپی‌پیست و ساخت دستی فایل نیست!

🔹‌ «توکنایزر جدید سی‌شارپ» با پشتیبانی از Roslyn:
این به‌روزرسانی باعث می‌شود Razor بهتر بتواند کدهای سی‌شارپ را پردازش کند؛ از جمله raw string literals، رشته‌های verbatim و حتی دستورهای پیش‌پردازنده.

📌 این قابلیت‌ها فعلاً در نسخه‌های جدید Visual Studio و NET 9. فعال هستند و قرار است در NET 10. به‌صورت پیش‌فرض فعال باشند.

🔗 بیشتر بخوانید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

شیء (Object) در سی‌شارپ

#csharp_for_beginners

در زبان سی‌شارپ، یک شیء نماینده‌ی یک نمونه (instance) از یک نوع است، که این نوع می‌تواند یک کلاس (class) یا یک ساختار (struct) باشد. یک کلاس یا ساختار مانند نقشه‌ای (blueprint) است که مشخص می‌کند نوع، چه داده‌ها و رفتارهایی دارد، و شیء بخشی از حافظه است که مطابق این نقشه ایجاد و پیکربندی می‌شود. برنامه ممکن است چندین شیء از یک کلاس ایجاد کند.

شیء‌ها همچنین می‌توانند در متغیرها، آرایه‌ها یا مجموعه‌ها ذخیره شوند. کد مشتری (client code) از این متغیرها برای فراخوانی متدها و دسترسی به خصوصیات عمومی شیء استفاده می‌کند.

نمونه‌های ساختار (Struct) و کلاس (Class)

کلاس‌ها
- کلاس‌ها نوع ارجاعی (reference type) هستند.
- متغیر یک شیء کلاس آدرس حافظه آن شیء در heap مدیریت‌شده را نگه می‌دارد.
- اگر یک متغیر کلاس به متغیر دیگر نسبت داده شود، هر دو متغیر به همان شیء اشاره می‌کنند.
- نمونه‌های کلاس معمولاً با عملگر new ایجاد می‌شوند.

مثال:

Person person1 = new Person("Leopold", 6);
Person person2 = person1;
person2.Name = "Molly";
// حالا person1.Name هم "Molly" است، زیرا هر دو به یک شیء اشاره دارند

استراکت‌ها
- استراکت‌ها نوع مقداری (value type) هستند.
- متغیر یک struct، یک کپی کامل از شیء را نگه می‌دارد.
- نمونه‌های struct می‌توانند با new ایجاد شوند، اما الزامی نیست.

مثال:

Person p1 = new Person("Alex", 9);
Person p2 = p1;
p2.Name = "Spencer";
// p1 تغییر نکرده است، زیرا p2 کپی مستقل است

نکات مهم حافظه
- حافظه‌ی کلاس‌ها در managed heap ذخیره می‌شود و توسط garbage collector بازیابی می‌شود.
- حافظه‌ی structها معمولاً در stack ذخیره می‌شود و هنگام خروج از محدوده از بین می‌رود.
- این تفاوت دلیل رفتار متفاوت در کپی و مقایسه بین کلاس و struct است.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

ساخت اپلیکیشن‌های هوش مصنوعی با Chroma در NET.

اگر دنبال ارتقای پروژه‌های NET. با قابلیت‌های جستجوی هوشمند هستید، حالا می‌توانید از Chroma استفاده کنید، یک پایگاه داده متن‌باز مخصوص اپ‌های AI!

📌‌ اما Chroma چیست؟
پایگاه داده‌ای برای ذخیره‌سازی embeddingها، جستجوی vector، فیلتر متادیتا، full-text search و بازیابی multi-modal (چند رسانه‌ای). مناسب برای پیاده‌سازی قابلیت‌هایی مثل جستجوی semantic و RAG.

🛠‌ چگونه از Chroma استفاده کنیم؟
با پکیج ChromaDB.Client در سی‌شارپ می‌توانید به راحتی به دیتابیس وصل شوید، مجموعه‌ای بسازید، داده‌ها را اضافه کنید و با vector search، اطلاعات مرتبط را پیدا کنید.

۱. نصب
۲. ساخت یک ChromaClient

using ChromaDB.Client;

var configOptions = new ChromaConfigurationOptions(uri: "http://localhost:8000/api/v1/");
using var httpClient = new HttpClient();
var client = new ChromaClient(configOptions, httpClient);

۳. ساخت کالکشن

var collection = await client.GetOrCreateCollection("movies");

var collectionClient = new ChromaCollectionClient(collection, configOptions, httpClient);

۴. ادامه نمونه کدها به همراه توضیحات رو می‌توانید از این لینک مشاهده کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

باکسینگ (Boxing) و آنباکسینگ (Unboxing)

#csharp_for_beginners

باکسینگ (Boxing)
باکسینگ Boxing زمانی اتفاق می‌افتد که یک مقدار از نوع‌های مقداری مثل int یا double به یک نوع مرجع مانند object تبدیل شود. در این فرایند یک شیء جدید در حافظهٔ heap ایجاد می‌شود و مقدار داخل آن قرار می‌گیرد. بعد از انجام باکسینگ Boxing، مقدار اولیه و مقدار قرار داده‌شده داخل شیء دو داده‌ی جداگانه خواهند بود و این عملیات به دلیل ایجاد شیء جدید از نظر عملکردی هزینه‌بر است.

نمونه کد:

int i = 123;
object o = i; // جعبه‌سازی
i = 456;
Console.WriteLine(i);
Console.WriteLine(o);

آنباکسینگ (Unboxing)
اما Unboxing تبدیل برعکس Boxing است و زمانی رخ می‌دهد که بخواهیم مقدار موجود در یک شیء از نوع object را دوباره به نوع مقداری اصلی خود تبدیل کنیم. این کار باید به صورت صریح انجام شود، یعنی لازم است نوع مقصد را حتماً با cast مشخص کنیم. در زمان اجرای برنامه بررسی می‌شود که آیا شیء واقعاً حاصل یک عملیات Boxing از همان نوع مقداری مورد انتظار هست یا خیر. اگر بررسی موفق باشد، مقدار ذخیره ‌شده در heap به یک متغیر مقداری کپی می‌شود. اما اگر شیء تهی (null) باشد یا نوع واقعی آن با نوعی که انتظار داریم مطابقت نداشته باشد، برنامه خطاهایی مانند NullReferenceException یا InvalidCastException تولید می‌کند.

نمونه کد:

int i = 123;
object o = i; // جعبه‌سازی

try
{
    int j = (int)o; // ازجعبه‌سازی درست
}
catch(Exception ex)
{
    Console.WriteLine(ex.Message);
}

نمونهٔ خطا:

int i = 123;
object o = i;

try
{
    short x = (short)o; // خطای InvalidCastException
}
catch (InvalidCastException e)
{
    Console.WriteLine("Incorrect unboxing");
}

باکسینگ Boxing و آنباکسینگ Unboxing به دلیل تخصیص حافظه و بررسی نوع در زمان اجرا از نظر عملکردی هزینه‌بر هستند. در بخش‌هایی از برنامه که این عملیات زیاد انجام می‌شود ممکن است باعث کاهش کارایی شوند. برای جلوگیری از این مشکل، استفاده از Genericها می‌تواند بسیار مؤثر باشد زیرا تبدیل‌های غیرضروری را حذف می‌کند.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

تغییر مهم در NET 9. برای توسعه‌دهندگان HTTP

در نسخه جدید NET 9.، رفتار پیش‌فرض HttpClientFactory تغییر کرده است و به‌جای استفاده از HttpClientHandler از SocketsHttpHandler به‌عنوان هندلر اصلی استفاده می‌شود (البته در پلتفرم‌هایی که قابلیت پشتیبانی داشته باشند).

🔧 این تغییر باعث می‌شود تا کدهایی که قبلاً هندلر را به HttpClientHandler تبدیل می‌کردند، با خطای InvalidCastException مواجه شوند.

مثلا کد زیر خطایی که گفته شد را خواهد داد:

services.AddHttpClient("test")
    .ConfigurePrimaryHttpMessageHandler((h, _) =>
    {
        ((HttpClientHandler)h).UseCookies = false;
    });

✅ دلیل این تغییر؟ بهبود مدیریت اتصال‌ها و حل مشکلات مربوط به تغییرات DNS در کلاینت‌های Singleton. اکنون SocketsHttpHandler با ویژگی PooledConnectionLifetime به‌طور پیش‌فرض تنظیم می‌شود تا اتصال‌ها به‌صورت دوره‌ای بازسازی شوند.

🔗 توضیحات تکمیلی را اینجا بخوانید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#حامد_حاجیلو (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

______

داینامیک (dynamic)

#csharp_for_beginners

نوع dynamic یک نوع static است اما وقتی متغیری از نوع dynamic باشد کنترل نوع کامپایلر نادیده گرفته می‌شود. یعنی معمولاً مانند نوع object رفتار می‌کند اما کامپایلر فرض می‌کند که هر عملی روی آن امکان‌پذیر است بدون اینکه نوع دقیق آن را بداند.
نتیجه این کار این است که وقتی با dynamic کار می‌کنید لازم نیست بدانید مقدار آن دقیقاً از کجا آمده مثلا از COM API یا یک زبان دینامیک یا از DOM HTML یا بازتاب (reflection).
اگر کد شما نادرست باشد خطا در زمان اجرا ظاهر می‌شود نه زمان کامپایل

مثال:

class ExampleClass
{
    public void exampleMethod1(int i) { }
    public void exampleMethod2(string str) { }
}

static void Main(string[] args)
{
    ExampleClass ec = new ExampleClass()
    dynamic dynamic_ec = new ExampleClass()
    dynamic_ec.exampleMethod1(10, 4)
    dynamic_ec.someMethod("some argument", 7, null)
    dynamic_ec.nonexistentMethod()
}

نتیجه عمل روی متغیر dynamic
بیشتر عملیات روی dynamic باز هم نتیجه‌ای از نوع dynamic می‌دهند مثلا

dynamic d = 1
var testSum = d + 3

در اینجا testSum خودش dynamic خواهد بود، اما بعضی از عملیات‌ها نتیجه‌ای غیر dynamic دارند مثل تبدیل به نوع خاص یا ساخت شی با آرگومان‌های dynamic.

var testInstance = new ExampleClass(d)

در اینجا نوع testInstance برابر ExampleClass خواهد بود نه dynamic

کاربردها
داینامیک زمانی مفید است که بخواهید دیر-بایندینگ (late binding) داشته باشید یعنی تصمیم‌گیری نوع و فراخوانی متدها یا پراپرتی‌ها در زمان اجرا انجام شود نه کامپایل.
برای Interop یا COM زمانی که با APIهای COM کار می‌کنید dynamic دیگر لازم نیست هر بار casting انجام دهید.
برای زبان‌های دینامیک یا DOM یا reflection وقتی ساختار داده یا API تان در زمان اجرا معلوم می‌شود dynamic انعطاف بیشتری می‌دهد.

🔗 مطلب کامل را در این لینک می‌توانید مطالعه کنید.

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

کانال تلگرام:
@SoftwarePhilosophy

______

تولید اطلاعات نادرست با اعتماد به نفس بالا!

توهم (Hallucination) در مدل‌های زبانی به حالتی گفته می‌شود که مدل، اطلاعات نادرست یا ساختگی تولید می‌کند، در حالی که با اطمینان و لحن قانع‌کننده آن را ارائه می‌دهد. این پدیده می‌تواند شامل اشتباهات تاریخی، علمی، یا حتی ساختن منابع و نقل‌قول‌های جعلی باشد.

تصور کنید از یک مدل زبانی می‌پرسید: «چه کسی اولین بار نظریه نسبیت را مطرح کرد؟» و پاسخ می‌دهد: «ایزاک نیوتن در سال ۱۸۷۹». این پاسخ نه‌تنها اشتباه است (چون نظریه نسبیت متعلق به آلبرت اینشتین است)، بلکه با لحنی قاطع ارائه می‌شود که می‌تواند مخاطب را گمراه کند.

چرا مدل‌ها دچار توهم می‌شوند؟
🔘 هدف آموزشی مدل‌ها: پیش‌بینی واژه‌ی بعدی
- مدل‌های زبانی بر اساس احتمال واژه‌ی بعدی آموزش می‌بینند، نه بر اساس صحت اطلاعات.
- این یعنی مدل‌ها بیشتر «حدس» می‌زنند تا «اطلاع» داشته باشند.
🔘نبود داده‌های منفی یا بازخورد اصلاحی
- در فرآیند آموزش، مدل‌ها معمولاً فقط با داده‌های مثبت تغذیه می‌شوند.
- اشتباهاتشان اصلاح نمی‌شود مگر در مراحل خاصی مثل fine-tuning یا RLHF.

🔘تشویق به تولید پاسخ‌های روان و کامل
- مدل‌ها برای تولید پاسخ‌هایی جذاب و کامل پاداش می‌گیرند، حتی اگر دقیق نباشند.
- ابراز «ندانستن» اغلب امتیاز کمتری دارد.

🔘فشار ارزیابی‌های سطحی
- بسیاری از ارزیابی‌ها فقط دقت زبانی یا شباهت به پاسخ‌های انسانی را می‌سنجند.
- صداقت، فروتنی شناختی، یا توانایی تشخیص عدم قطعیت نادیده گرفته می‌شود.

برای ساخت مدل‌هایی قابل اعتمادتر، باید هم در آموزش و هم در ارزیابی تغییراتی ایجاد شود. برخی راهکارهای کلیدی عبارت‌اند از:
🟣 تشویق به ابراز عدم قطعیت
- مدل‌ها باید یاد بگیرند که گاهی «نمی‌دانم» گفتن بهتر از حدس زدن است.
- این رفتار باید در ارزیابی‌ها پاداش داده شود.

🟣 استفاده از داده‌های منفی در آموزش
- آموزش مدل‌ها با نمونه‌هایی از پاسخ‌های اشتباه و اصلاح‌شده، به آن‌ها کمک می‌کند تا بهتر تشخیص دهند چه چیزی نادرست است.

🟣 ارزیابی چندلایه
- علاوه بر دقت زبانی، باید معیارهایی مثل «درستی اطلاعات»، «منبع‌پذیری» و «فروتنی شناختی» نیز سنجیده شوند.

🟣 افزایش شفافیت مدل‌ها
- مدل‌ها باید بتوانند توضیح دهند که چرا یک پاسخ را داده‌اند یا از کجا آن را گرفته‌اند.

🔗 در اینجا می‌توانید بیشتر بخوانید.
___________

⁉️ برای بحث و تبادل نظر فنی در مورد این پست، نظرات خود را با ما در قسمت کامنت‌ها به اشتراک بگذارید.

#نگار_قاسمی (لینکدین)

کانال تلگرام:
@SoftwarePhilosophy

________