Semantic Kernel .NET 1.82.0 כותב מחדש גישת קבצים: השינוי השובר שמסתתר באיחוד
Microsoft שחררה Semantic Kernel .NET 1.82.0 ב-7 בנובמבר עם איחוד שובר של גישת קבצים על פני התוספים שלה. העלאות עוברות לזרמים בבעלות המתקשר, הורדות מושב הופכות לדחייה כברירת מחדל, ומסייע משותף אחד שומר עכשיו על כל נתיב קובץ מקומי. מה נשבר, למה, ומה לבדוק לפני שדרוג.
Microsoft שחררה את Semantic Kernel .NET 1.82.0 ב-7 בנובמבר 2026, וקבור ביומן השינויים יש שורה שתשנה לכל מי שהסוכנים שלו נוגעים במערכת הקבצים: ".Net: [BREAKING] Consolidate file access". אם קוד ה-.NET שלכם מעלה קבצים דרך מחבר כונן הענן Microsoft Graph של Semantic Kernel, או שומר הורדות מושב של code-interpreter לדיסק, לצפות לשגיאות קומפילציה או דחיות מוחלטות אחרי השדרוג. הגרסה הקצרה: העלאות מקבלות עכשיו זרמים בבעלות המתקשר במקום נתיבי קבצים מקומיים, הורדות מושב מקומיות נדחות אלא אם הגדרתם במפורש תיקיות מורשות, וכל טיפול הקבצים של כל תוסף עובר עכשיו דרך מסייע משותף אחד שמאמת נתיבים לפני שהוא פותח משהו. השינוי אינו תגובה לפגיעות שפורסמה. זה איחוד עם תשואת אבטחה, והוא ישבור קוד אמיתי.
מה באמת נשבר ב-1.82.0
המשטח השובר, לפי ה-pull request שמוזג (#14679, 24 קבצים שונו, +2527/-325):
- העלאות כונן ענן משנות חוזה. העלאות ICloudDriveConnector עברו מנתיבי קבצים מקומיים לזרמים בבעלות המתקשר. מחבר ה-OneDrive מעלה עכשיו את הזרם שמוסרים לו בלי לקחת בעלות, אז הקוד שלכם פותח את הקובץ המקומי, שומר ומשמיד את הזרם, ומעביר אותו פנימה. כל אתר קריאה שמעביר מחרוזת נתיב לא יתקמפל.
- הורדות מושב הופכות לדחייה כברירת מחדל. SessionsPythonSettings של מפרש הקוד מתעד עכשיו ששמירת הורדות מקומיות דורשת תיקיות מורשות. אם הסוכן שלכם שומר קבצים ממושב Python מתארח לדיסק ומעולם לא הגדרתם תיקיות מורשות, השמירות האלה יידחו אחרי השדרוג.
- גישת מסמכים מוחמרת. DocumentPlugin מעביר עכשיו תיקיות מורשות למחבר מערכת הקבצים שלו ומשתמש בסטטוס יצירה בעת הוספה. חוזה המחבר (IFileSystemConnector) מגדיר עכשיו קריאות מוגבלות ועדכוני פתח-או-צור אטומיים במקום פעולות רפויות מבוססות-נתיב.
- הליבה FileIOPlugin עברה לקריאות מאובטחות עם הגנת דריסה אטומית, ותוסף הורדת הרשת משתמש בנרמול נתיבים משותף עם פתיחת יעד מאובטחת.
למה Microsoft איחדה את זה
המוטיבציה המוצהרת פשוטה: תוספים שונים נשאו כל אחד בדיקות קבצים וקוד גישת קבצים משלו. ה-pull request מחליף את כל זה ברכיב משותף אחד, מסייע פנימי בשם SecureFileSystem שמאמת תיקיות מורשות ופותח קבצים באמצעות handles ייחודיים לפלטפורמה. קריאות, כתיבות, הורדות והעלאות על פני התוספים עוברות עכשיו דרך הנתיב היחיד הזה, ו-Microsoft הוסיפה בדיקות רגרסיה ועוד workflow ייעודי שמריץ את בדיקות מערכת הקבצים על Windows, Linux ו-macOS.
נתיב אחד מאוחד ונבדק קל יותר לביקורת מחמישה ידניים. אותה מהדורה גם מחזקת גבולות שינוי נתונים מובנים (#14718) וקושרת כתובות HTTP מאומתות לחיבורים (#14719), ומסירה את מחבר Milvus של .NET שהועבר (#14682). בקריאה משותפת, 1.82.0 היא מהדורת חיזוק שבמקרה שוברת APIs תוך כדי.
מה אני הייתי בודק
אלה ההצעות שלא נבדקו שלי, מבוססות על תיאור השינוי, לא על מיגרציה שהרצתי:
- לפני שדרוג, לנעוץ את חבילות התוספים של Semantic Kernel בגרסה שאתם מריצים כרגע ולשדרג בכוונה, לא כחלק מעדכון תלויות המוני.
- לגרפ את הפתרון שלכם אחרי ICloudDriveConnector ואתרי קריאת העלאה שמעבירים נתיבי קבצים. לכתוב אותם מחדש כך שיפתחו את הקובץ בעצמם ויעבירו זרם שבבעלותכם.
- אם סוכנים שומרים הורדות מושב מקומית, להחליט על התיקיות המורשות עכשיו ולהגדיר אותן במפורש. דחייה כברירת מחדל היא עמדה נכונה, אבל היא תכשל בדממה workflows שהניחו גישה פתוחה.
- לבחון מחדש כל דבר שמערב symlinks, מרוצי דריסה, ונרמול נתיבים; אלה בדיוק המקרים שהבדיקות החדשות מכוונות אליהם, מה שאומר לכם איפה ההתנהגות השתנתה.
- להריץ את סוויטת הבדיקות שלכם על יותר ממערכת הפעלה אחת. קוד ה-handles החדש הייחודי לפלטפורמה הוא בדיוק המקום שבו בדיקות על Windows בלבד ישקרו לכם.
מה לא הייתי מסיק
לא להתייחס לזה כתיקון חירום. לא מצאתי ייעוץ אבטחה או CVE מחובר ל-1.82.0, אז זה נקרא כחיזוק יזום, לא תיקון ניצול פעיל. גם לא הייתי מניח שהאיחוד נחת נקי: במהלך הסקירה, סקירה אוטומטית סימנה שתי בעיות, העלאות Linux שנכשלות מתחת לתיקיות אבות הניתנות לחיפוש אך לא לרישום, וחשיפת שגיאות פתרון מערכת קבצים לנתיבים מחוץ לרשימת ההעלאה המורשית במקום החזרת הדחייה הרגילה. לא הצלחתי לאמת אם שתיהן נפתרו לפני המיזוג, אז לעקוב אחרי עוקב הבעיות של המאגר אם אתם נתקלים בכשלי העלאה מוזרים ב-Linux. לבסוף, תג הגרסה מפרט גם הרבה commits של Python; אלה שייכים לגרסאות ה-Python SDK הנפרדות ולא משנים את חבילות ה-.NET.
שאלות נפוצות
האם Semantic Kernel .NET 1.82.0 שובר קוד תוספים קיים?
כן, אם אתם משתמשים במשטחים המושפעים. העלאות דרך מחבר כונן הענן עברו מנתיבי קבצים לזרמים בבעלות המתקשר, אז אתרי קריאה קיימים לא יתקמפלו. הורדות מושב בלי תיקיות מורשות מוגדרות יידחו בזמן ריצה. קוד שרק משוחח וקורא לכלים בלי לגעת בקבצים מקומיים לא מושפע.
האם זה תיקון לפגיעות ידועה?
לא שיכולתי לאמת. אין CVE או ייעוץ אבטחה קשור ל-1.82.0 במקורות שקראתי. הסיבה המוצהרת של Microsoft היא איחוד: לכל תוסף היו בדיקות קבצים משלו, ועכשיו הם מאוחדים מאחורי נתיב מאומת אחד.
אילו חבילות מושפעות?
חבילות התוספים של .NET בגל 1.82.0: Plugins.MsGraph להעלאות כונן ענן, Plugins.Core ל-FileIOPlugin ולתוספי מושב מפרש הקוד, Plugins.Document לגישת מסמכים, ו-Plugins.Web להורדות קבצים. ה-Python SDK מתגרס בנפרד ולא מושפע מהמהדורה הזו.
איך אני שומר על ההתנהגות הישנה בזמן שאני ממגר?
להישאר על גרסת Semantic Kernel שהרצתם לפני השדרוג ולתזמן את המיגרציה בכוונה. אין מתג תאימות מתועד במקורות שקראתי; שינוי החוזה הוא הנקודה.
האם קריאות קבצים מקומיות עדיין עובדות בלי תיקיות מורשות?
כיוון השינוי הוא שתיקיות מורשות הופכות לשער לגישת קבצים מקומית. הורדות מושב הן במפורש דחייה כברירת מחדל בלעדיהן, ותוסף המסמכים מעביר עכשיו תיקיות מורשות למחבר שלו. להניח שצריך להגדיר אותן בכל מקום שהסוכן שלכם נוגע בנתיבים מקומיים.
מה היו שתי הבעיות שסומנו בסקירה?
סקירה אוטומטית על ה-pull request סימנה העלאות Linux שנכשלות תחת תיקיות הניתנות לחיפוש אך לא לרישום, והודעות שגיאה שמדליפות פרטי פתרון מערכת קבצים לנתיבים מחוץ לרשימת ההעלאה המורשית במקום דחייה נקייה. שתיהן סומנו לפני מיזוג; לא הצלחתי לאשר את הסטטוס הסופי שלהן.
האם זה משפיע על Semantic Kernel ל-Python?
לא. ה-Python SDK שחרר 1.46.0 בנפרד ויש לו 1.47.0 בהכנה. איחוד גישת הקבצים השובר הוא ל-.NET בלבד.
מקורות
- Semantic Kernel releases: dotnet-1.82.0 - נקרא ב-8 בנובמבר 2026. תאריך הגרסה (7 בנובמבר 2026), קפיצת הגרסה, שורת השינוי השובר, רשומות החיזוק של נתונים מובנים ו-HTTP, והסרת מחבר Milvus.
- [Pull request 14679: .Net: [BREAKING] Consolidate file access](https://github.com/microsoft/semantic-kernel/pull/14679) - נקרא ב-8 בנובמבר 2026. המוטיבציה, מסייע SecureFileSystem המשותף, העלאות זרם בבעלות המתקשר, הורדות מושב דחייה כברירת מחדל, רשימת השינויים פר-קובץ, workflow הבדיקות חוצה-הפלטפורמות, ושתי הבעיות שסומנו בסקירה האוטומטית.
לא נקרא: ה-diff המלא של #14679 מעבר לסיכום ולטבלת הקבצים שלו, וה-pull requests הבודדים של #14718 ו-#14719. לא הרצתי את שדרוג 1.82.0 מול פרויקט אמיתי; הצעות המיגרציה למעלה נגזרות מתיאור השינוי, לא מבדיקה מעשית.
קריאה נוספת
- Semantic Kernel Python 1.46.0: תיעוד הרשאת כלים, אמון בתבניות, ו-DNS מוצמד ב-HttpPlugin
Semantic Kernel Python 1.46.0 מערב תיקוני אבטחה עם תיעוד שאומר בקול מה שה-function filters שלו לא עושים. קראתי את הערות הגרסה, ה-pull requests ואת ה-README בתג כדי לראות מה השתנה ומה עדיין נופל על האפליקציה שלכם.
- OpenAI Agents SDK 0.24.0-alpha.6: גלגל תצוגה מקדימה מבוסס-Codex, מדיניות כלים ו-NetworkPolicy, כפי שנקרא בתיעוד
ה-Agents SDK של OpenAI ל-Python שחרר גלגל תצוגה מקדימה ב-3 בנובמבר שמריץ את ה-runtime המובנה של Codex תחת API של Python, מחוץ ל-PyPI. קראתי את הערות הגרסה, התיעוד ב-commit המוצמד ואת ה-pyproject כדי לראות מה השתנה, מה הבקרות על כלים ורשת מכסות, ואיפה התיעוד והגרסה לא מסכימים.
- Parameter Poisoning: הזרקת הפרומפט ששומרת על הכלי הנכון ומחליפה את הארגומנט
מאמר arXiv חדש בוחן התקפות שמשאירות את קריאת הכלי במקום ומחליפות ארגומנט אחד, כמו נמען. הוא מדווח על 93.06% הצלחת התקפה ללא הגנה במודל אחד, והגנה ברמת הפרמטרים שמורידה את זה ל-9.03%. קראתי את המאמר ומפרט מה הוא מראה ומה לא.
יומן הבנייה
לעקוב אחרי העבודה.
מאמרים ואבטיפוסים חדשים, ישר לקורא ה-RSS שלכם. מנויי המייל בהשהיה זמנית, עד שאחבר שירות משלוח עובד. לא נאסף כאן אימייל.
עקבו ב-RSS