پایگاه دانش: التغييرات غير المتوافقة
قائمة التغييرات حسب الإصدار التي قد تتدرخواست إجراءً عند الترقية.
Notion: إزالة client_secret
اخیرلتزام: 6d876c3
أُزيل حقل client_secret از تكوين یکپارچهسازی Notion كإجراء تقوية أازية. يستخدم Notion الآن فقط رمز OAuth المخزّن در کلیدزنجیر نظام التشغيل.
الإجراء اخیرلزامی: إذا كان triggerfish.yaml يحتوي روی حقل notion.client_secret، أزله. سيُتجاهل لكنه قد يسبب ارتباكاً.
تدفق راهاندازی الجديد:
bash
triggerfish connect notionيخزّن این رمز الیکپارچهسازی در سلسلة المفاتيح. خیر حاجة لسر عميل.
أسماء ابزارها: از النقاط به الشرطات السفلية
اخیرلتزام: 505a443
غُيّرت تمام أسماء ابزارها از تدوين النقاط (foo.bar) به تدوين الشرطة السفلية (foo_bar). بعض ارائهدهندهي LLM خیر پشتیبانی میکندون النقاط در أسماء ابزارها، مما سبّب فشل فراخوانیات ابزارها.
الإجراء اخیرلزامی: إذا كانت لديك قوانین سیاست مخصصة یا تعريفات مهارات تشير به أسماء ابزارها بنقاط، حدّثها خیرستخدام الشرطات السفلية:
yaml
# قبل
- tool: notion.search
# بعد
- tool: notion_searchمُثبّت Windows: از Move-Item به Copy-Item
اخیرلتزام: 5e0370f
غُيّر مُثبّت PowerShell لـ Windows از Move-Item -Force به Copy-Item -Force خیرستبدال الملف التندرذي أثناء الترقيات. Move-Item خیر يُعيد الكتابة فوق الملفات بشهر موثوق روی Windows.
الإجراء اخیرلزامی: خیر شيء إذا كنت تُثبّت لیال مرة. إذا كنت روی إصدار أقدم وفشل triggerfish update روی Windows، یاقف الخدمة بهصورت دستی قبل التحديث:
powershell
Stop-Service Triggerfish
# ثم أعد تشغيل المُثبّت یا triggerfish updateختم الإصدار: از وقت التشغيل به وقت البناء
اخیرلتزامات: e8b0c8c، eae3930، 6ce0c25
نُقلت اطخیرعات الإصدار از اخیركتشاف در وقت التشغيل (فحص deno.json) به الختم در وقت البناء از وسوم git. لم يعد شعار CLI يعرض سلسلة إصدار مُثبّتة.
الإجراء اخیرلزامی: خیر شيء. triggerfish version يستمر در العمل. بناءات التطوير تعرض dev كالإصدار.
Signal: از JRE 21 به JRE 25
اخیرلتزام: e5b1047
حُدّث المُثبّت الخودکار لکانال Signal لتنزيل JRE 25 (از Adoptium) بدخیرً از JRE 21. ثُبّت همچنین إصدار signal-cli روی v0.14.0.
الإجراء اخیرلزامی: إذا كان لديك تثبيت signal-cli موجود بـ JRE أقدم، أعد تشغيل إعداد Signal:
bash
triggerfish config add-channel signalينزّل این JRE و signal-cli المُحدَّثين.
رمزها: از نص عادي به مشفر
تغيّر تنسيق ذخیرهسازی رمزها از JSON بنص عادي به JSON مشفر بـ AES-256-GCM.
الإجراء اخیرلزامی: خیر شيء. الترحيل خودکار. مراجعه کنید مهاجرت رمزها للتفاصيل.
بعد الترحيل، يُوصى بتدوير رمزهاك لأن نسخ النص العادي كانت مخزّنة سابقاً روی القرص.
Tidepool: از بروتوكول فراخوانی به بروتوكول Canvas
هاجرت واجهة Tidepool (A2UI) از واجهة TidepoolTools القائمة روی فراخوانیات به بروتوكول قائم روی canvas.
الملفات المتأثرة:
src/tools/tidepool/tools/tools_legacy.ts(الواجهة القديمة، مُحتفظ بها للتوافق)src/tools/tidepool/tools/tools_canvas.ts(الواجهة الجديدة)
الإجراء اخیرلزامی: إذا كانت لديك مهارات مخصصة تستخدم واجهة فراخوانی Tidepool القديمة، ستستمر در العمل از طریق الطبقة القديمة. مهارتها الجديدة باید أن تستخدم بروتوكول canvas.
پیکربندی: تنسيق primary القديم بالسلسلة
قبل حقل models.primary كان يقبل سلسلة عادية ("anthropic/claude-sonnet-4-20250514"). الآن يتدرخواست كائناً:
yaml
# قديم (خیر يزال مقبوخیرً للتوافق العكسي)
models:
primary: "anthropic/claude-sonnet-4-20250514"
# حالي (مُفضَّل)
models:
primary:
provider: anthropic
model: claude-sonnet-4-20250514الإجراء اخیرلزامی: حدّث به تنسيق الكائن. تنسيق السلسلة خیر يزال يُحلَّل لكنه قد يُزال در إصدار مستقبلي.
تسجيل Console: أُزيل
اخیرلتزام: 9ce1ce5
رُحّلت تمام فراخوانیات console.log وconsole.warn وconsole.error الخام به المسجّل الازظّم (createLogger()). بما أن Triggerfish کار میکند كخدمة خلدرة، مخرجات stdout/stderr غير مرئية للمستخدمين. تمام التسجيل الآن يمر از طریق كاتب الملفات.
الإجراء اخیرلزامی: خیر شيء. إذا كنت تعتمد روی مخرجات console للتصحیح (مثل توجيه stdout)، استخدم triggerfish logs بدخیرً از آن.
تقدير الأثر
عند الترقية از طریق عدة إصدارات، تحقق از هر إدخال أعخیره. باظم التغييرات متوافقة عكسياً با ترحيل خودکار. التغييرات الوحيدة التي تتدرخواست إجراءً بهصورت دستی هي:
- إزالة client_secret لـ Notion (أزل الحقل از پیکربندی)
- تغيير تنسيق أسماء ابزارها (حدّث قوانین سیاست المخصصة)
- تحديث JRE لـ Signal (أعد تشغيل إعداد Signal إذا كنت تستخدم Signal)
هر شيء آخر يُعالج بهصورت خودکار.