feat(profiles): explain extension override order

This commit is contained in:
wonfen
2026-09-22 17:59:37 +08:00
parent fd06fbb3b7
commit 659ee1a181
20 changed files with 162 additions and 0 deletions
+1
View File
@@ -26,6 +26,7 @@
<details>
<summary><strong> 🚀 优化改进 </strong></summary>
- 优化扩展覆写配置和脚本编辑窗口,分别提示作用范围、执行顺序及应用设置优先级
- 优化 DNS 覆写开关:按订阅独立记忆,自动关闭仅影响当前订阅,并提示作用范围
- 优化系统服务兼容性检查:升级后服务版本或协议不兼容时,提示重新安装
- 优化预构建资源,补充 ASN 数据库文件
+3
View File
@@ -33,6 +33,7 @@ type EditorLanguage = 'yaml' | 'javascript' | 'css'
export interface EditorViewerProps {
open: boolean
title?: string | ReactNode
description?: ReactNode
value: string
language: EditorLanguage
path: string
@@ -50,6 +51,7 @@ export interface EditorViewerProps {
export const EditorViewer = ({
open,
title,
description,
value,
language,
path,
@@ -207,6 +209,7 @@ export const EditorViewer = ({
overflow: 'hidden',
}}
>
{description}
<div style={{ position: 'relative', flex: '1 1 auto', minHeight: 0 }}>
<BaseLoadingOverlay isLoading={loading} />
{!loading && (
+29
View File
@@ -0,0 +1,29 @@
import { Alert, Typography } from '@mui/material'
import { useTranslation } from 'react-i18next'
const stageHints = {
globalMerge: 'profiles.modals.editor.enhance.globalMerge',
globalScript: 'profiles.modals.editor.enhance.globalScript',
profileMerge: 'profiles.modals.editor.enhance.profileMerge',
profileScript: 'profiles.modals.editor.enhance.profileScript',
} as const
interface Props {
stage: keyof typeof stageHints
}
export const EnhanceHint = ({ stage }: Props) => {
const { t } = useTranslation()
return (
<Alert severity="info" sx={{ mb: 1.5, flexShrink: 0 }}>
<Typography variant="body2">{t(stageHints[stage])}</Typography>
<Typography variant="body2" sx={{ mt: 0.5 }}>
{t('profiles.modals.editor.enhance.order')}
</Typography>
<Typography variant="body2" sx={{ mt: 0.5 }}>
{t('profiles.modals.editor.enhance.settingsPriority')}
</Typography>
</Alert>
)
}
+5
View File
@@ -47,6 +47,7 @@ import { isValidUrl } from '@/utils/network'
import { openExternalUrl } from '@/utils/open-external-url'
import parseTraffic from '@/utils/parse-traffic'
import { EnhanceHint } from './enhance-hint'
import { ProfileBox } from './profile-box'
import { ProxiesEditorViewer } from './proxies-editor-viewer'
import { QrViewer } from './qr-viewer'
@@ -910,6 +911,8 @@ const ProfileItemBase = (props: ProfileItemProps) => {
{mergeOpen && (
<EditorViewer
open={true}
title={t('profiles.components.menu.extendConfig')}
description={<EnhanceHint stage="profileMerge" />}
value={mergeDocument.value}
language="yaml"
path={`merge:${option?.merge ?? ''}.yaml`}
@@ -923,6 +926,8 @@ const ProfileItemBase = (props: ProfileItemProps) => {
{scriptOpen && (
<EditorViewer
open={true}
title={t('profiles.components.menu.extendScript')}
description={<EnhanceHint stage="profileScript" />}
value={scriptDocument.value}
language="javascript"
path={`script:${option?.script ?? ''}.js`}
+6
View File
@@ -17,6 +17,7 @@ import { useEditorDocument } from '@/hooks/use-editor-document'
import { viewProfile, readProfileFile, saveProfileFile } from '@/services/cmds'
import { showNotice } from '@/services/notice-service'
import { EnhanceHint } from './enhance-hint'
import { LogViewer } from './log-viewer'
import { ProfileBox } from './profile-box'
@@ -213,6 +214,11 @@ export const ProfileMore = (props: Props) => {
<EditorViewer
open={true}
title={t(globalTitles[id])}
description={
<EnhanceHint
stage={id === 'Merge' ? 'globalMerge' : 'globalScript'}
/>
}
value={document.value}
language={id === 'Merge' ? 'yaml' : 'javascript'}
path={`profile-more:${id}.${id === 'Merge' ? 'yaml' : 'js'}`}
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "لا يمكن التعديل في محرر القراءة فقط"
},
"enhance": {
"globalMerge": "يُطبّق على جميع الملفات بعد إعدادات التطبيق. يمكن للسكربت العام وإعدادات الملف وسكربت الملف تعديل النتيجة لاحقًا.",
"globalScript": "يُطبّق على جميع الملفات باستخدام نتيجة دمج الإعدادات العامة. يمكن لإعدادات الملف وسكربت الملف تعديل النتيجة لاحقًا.",
"profileMerge": "يُطبّق على هذا الملف فقط بعد الإعدادات العامة والسكربت العام. يمكن لسكربت الملف تعديل النتيجة لاحقًا.",
"profileScript": "يُطبّق على هذا الملف فقط باستخدام نتيجة دمج إعداداته. هذه آخر خطوة للإضافات قبل إعادة تطبيق إعدادات التطبيق.",
"order": "الترتيب: الملف الأصلي ← إعدادات التطبيق ← إعدادات الإضافة العامة ← سكربت الإضافة العام ← إعدادات إضافة الملف ← سكربت إضافة الملف ← إعادة تطبيق إعدادات التطبيق",
"settingsPriority": "ملاحظة: الحقول التي تديرها إعدادات التطبيق تستخدم دائمًا قيم تلك الإعدادات في التكوين النهائي. تعديل هذه الحقول في الإضافات لا يؤثر على النتيجة النهائية."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Bearbeitung im schreibgeschützten Modus nicht möglich"
},
"enhance": {
"globalMerge": "Gilt für alle Profile, nach den App-Einstellungen. Das globale Skript, die Profilkonfiguration und das Profilskript können das Ergebnis noch ändern.",
"globalScript": "Gilt für alle Profile und verwendet das Ergebnis der globalen Konfiguration. Die Profilkonfiguration und das Profilskript können das Ergebnis noch ändern.",
"profileMerge": "Gilt nur für dieses Profil, nach der globalen Konfiguration und dem globalen Skript. Das Profilskript kann das Ergebnis noch ändern.",
"profileScript": "Gilt nur für dieses Profil und verwendet das Ergebnis der Profilkonfiguration. Dies ist der letzte Erweiterungsschritt vor dem erneuten Anwenden der App-Einstellungen.",
"order": "Reihenfolge: Originalprofil → App-Einstellungen → Globale Erweiterungskonfiguration → Globales Erweiterungsskript → Profilerweiterungskonfiguration → Profilerweiterungsskript → App-Einstellungen erneut anwenden",
"settingsPriority": "Hinweis: Von den App-Einstellungen verwaltete Felder übernehmen in der endgültigen Konfiguration immer deren Werte. Änderungen dieser Felder in Erweiterungen haben keine Wirkung."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Cannot edit in read-only editor"
},
"enhance": {
"globalMerge": "Applies to all profiles, after app settings. The global script, profile config and profile script can still change the result.",
"globalScript": "Applies to all profiles, using the result of the global config merge. The profile config and profile script can still change the result.",
"profileMerge": "Applies only to this profile, after the global config and global script. The profile script can still change the result.",
"profileScript": "Applies only to this profile, using the result of the profile config merge. This is the last extension step before app settings are reapplied.",
"order": "Order: Original profile → App settings → Global extend config → Global extend script → Profile extend config → Profile extend script → App settings reapplied",
"settingsPriority": "Note: Fields managed by app settings always use those settings in the final config. Changing these fields in extensions has no effect."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "No se puede editar en modo de solo lectura"
},
"enhance": {
"globalMerge": "Se aplica a todos los perfiles, después de los ajustes de la aplicación. El script global, la configuración del perfil y el script del perfil aún pueden modificar el resultado.",
"globalScript": "Se aplica a todos los perfiles sobre el resultado de combinar la configuración global. La configuración y el script del perfil aún pueden modificar el resultado.",
"profileMerge": "Se aplica solo a este perfil, después de la configuración y el script globales. El script del perfil aún puede modificar el resultado.",
"profileScript": "Se aplica solo a este perfil sobre el resultado de combinar su configuración. Es el último paso de extensión antes de volver a aplicar los ajustes de la aplicación.",
"order": "Orden: Perfil original → Ajustes de la aplicación → Configuración de extensión global → Script de extensión global → Configuración de extensión del perfil → Script de extensión del perfil → Reaplicar ajustes de la aplicación",
"settingsPriority": "Nota: Los campos gestionados por los ajustes de la aplicación siempre conservan esos valores en la configuración final. Modificarlos en las extensiones no tiene efecto."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "نمی‌توان در ویرایشگر فقط خواندنی ویرایش کرد"
},
"enhance": {
"globalMerge": "پس از تنظیمات برنامه روی همهٔ پروفایل‌ها اعمال می‌شود. اسکریپت سراسری، پیکربندی پروفایل و اسکریپت پروفایل همچنان می‌توانند نتیجه را تغییر دهند.",
"globalScript": "با استفاده از نتیجهٔ ادغام پیکربندی سراسری روی همهٔ پروفایل‌ها اعمال می‌شود. پیکربندی و اسکریپت پروفایل همچنان می‌توانند نتیجه را تغییر دهند.",
"profileMerge": "پس از پیکربندی و اسکریپت سراسری فقط روی این پروفایل اعمال می‌شود. اسکریپت پروفایل همچنان می‌تواند نتیجه را تغییر دهد.",
"profileScript": "با استفاده از نتیجهٔ ادغام پیکربندی پروفایل فقط روی این پروفایل اعمال می‌شود. این آخرین مرحلهٔ افزونه پیش از اعمال مجدد تنظیمات برنامه است.",
"order": "ترتیب: پروفایل اصلی ← تنظیمات برنامه ← پیکربندی افزونهٔ سراسری ← اسکریپت افزونهٔ سراسری ← پیکربندی افزونهٔ پروفایل ← اسکریپت افزونهٔ پروفایل ← اعمال مجدد تنظیمات برنامه",
"settingsPriority": "توجه: فیلدهایی که تنظیمات برنامه مدیریت می‌کند، در پیکربندی نهایی همیشه از مقادیر همان تنظیمات استفاده می‌کنند. تغییر این فیلدها در افزونه‌ها اثری بر پیکربندی نهایی ندارد."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Tidak dapat mengedit di editor hanya baca"
},
"enhance": {
"globalMerge": "Berlaku untuk semua profil, setelah pengaturan aplikasi. Skrip global, konfigurasi profil, dan skrip profil masih dapat mengubah hasilnya.",
"globalScript": "Berlaku untuk semua profil, menggunakan hasil penggabungan konfigurasi global. Konfigurasi profil dan skrip profil masih dapat mengubah hasilnya.",
"profileMerge": "Berlaku hanya untuk profil ini, setelah konfigurasi global dan skrip global. Skrip profil masih dapat mengubah hasilnya.",
"profileScript": "Berlaku hanya untuk profil ini, menggunakan hasil penggabungan konfigurasi profil. Ini adalah langkah ekstensi terakhir sebelum pengaturan aplikasi diterapkan kembali.",
"order": "Urutan: Profil asli → Pengaturan aplikasi → Konfigurasi ekstensi global → Skrip ekstensi global → Konfigurasi ekstensi profil → Skrip ekstensi profil → Penerapan ulang pengaturan aplikasi",
"settingsPriority": "Catatan: Bidang yang dikelola oleh pengaturan aplikasi selalu menggunakan nilai pengaturan tersebut dalam konfigurasi akhir. Mengubah bidang ini melalui ekstensi tidak berpengaruh."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "読み取り専用モードでは編集できません。"
},
"enhance": {
"globalMerge": "すべてのプロファイルに適用され、アプリ設定の後にマージされます。後続のグローバルスクリプト、プロファイル拡張設定・スクリプトで結果を変更できます。",
"globalScript": "すべてのプロファイルに適用され、グローバル拡張設定のマージ結果を受け取ります。後続のプロファイル拡張設定・スクリプトで結果を変更できます。",
"profileMerge": "このプロファイルのみに適用され、グローバル拡張設定・スクリプトの後にマージされます。後続のプロファイルスクリプトで結果を変更できます。",
"profileScript": "このプロファイルのみに適用され、プロファイル拡張設定のマージ結果を受け取ります。アプリ設定が再適用される前の最後の拡張ステップです。",
"order": "実行順序:元のプロファイル → アプリ設定 → グローバル拡張設定 → グローバル拡張スクリプト → プロファイル拡張設定 → プロファイル拡張スクリプト → アプリ設定の再適用",
"settingsPriority": "注意:アプリ設定が管理するフィールドは、最終的にアプリ設定の値が優先されます。拡張設定やスクリプトでこれらのフィールドを変更しても反映されません。"
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "읽기 전용 편집기에서는 편집할 수 없습니다"
},
"enhance": {
"globalMerge": "모든 프로필에 적용되며 앱 설정 이후에 병합됩니다. 이후의 전역 스크립트, 프로필 확장 설정 및 스크립트가 결과를 변경할 수 있습니다.",
"globalScript": "모든 프로필에 적용되며 전역 확장 설정이 병합된 결과를 받습니다. 이후의 프로필 확장 설정 및 스크립트가 결과를 변경할 수 있습니다.",
"profileMerge": "이 프로필에만 적용되며 전역 확장 설정 및 스크립트 이후에 병합됩니다. 이후의 프로필 스크립트가 결과를 변경할 수 있습니다.",
"profileScript": "이 프로필에만 적용되며 프로필 확장 설정이 병합된 결과를 받습니다. 앱 설정이 다시 적용되기 전의 마지막 확장 단계입니다.",
"order": "실행 순서: 원본 프로필 → 앱 설정 → 전역 확장 설정 → 전역 확장 스크립트 → 프로필 확장 설정 → 프로필 확장 스크립트 → 앱 설정 재적용",
"settingsPriority": "참고: 앱 설정이 관리하는 필드는 최종 구성에서 항상 앱 설정의 값을 사용합니다. 확장 설정이나 스크립트에서 이 필드를 변경해도 반영되지 않습니다."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Редактирование недоступно в режиме только для чтения"
},
"enhance": {
"globalMerge": "Применяется ко всем профилям после настроек приложения. Глобальный скрипт, конфигурация и скрипт профиля ещё могут изменить результат.",
"globalScript": "Применяется ко всем профилям после объединения с глобальной конфигурацией. Конфигурация и скрипт профиля ещё могут изменить результат.",
"profileMerge": "Применяется только к этому профилю после глобальной конфигурации и глобального скрипта. Скрипт профиля ещё может изменить результат.",
"profileScript": "Применяется только к этому профилю после объединения с его конфигурацией. Это последний шаг расширения перед повторным применением настроек приложения.",
"order": "Порядок: Исходный профиль → Настройки приложения → Глобальная конфигурация расширения → Глобальный скрипт расширения → Конфигурация расширения профиля → Скрипт расширения профиля → Повторное применение настроек приложения",
"settingsPriority": "Примечание: Поля, управляемые настройками приложения, в итоговой конфигурации всегда используют значения этих настроек. Изменения таких полей в расширениях не действуют."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Salt okunur düzenleyicide düzenlenemez"
},
"enhance": {
"globalMerge": "Uygulama ayarlarından sonra tüm profillere uygulanır. Genel betik, profil yapılandırması ve profil betiği sonucu hâlâ değiştirebilir.",
"globalScript": "Genel yapılandırmanın birleştirilmiş sonucunu kullanarak tüm profillere uygulanır. Profil yapılandırması ve profil betiği sonucu hâlâ değiştirebilir.",
"profileMerge": "Genel yapılandırma ve genel betikten sonra yalnızca bu profile uygulanır. Profil betiği sonucu hâlâ değiştirebilir.",
"profileScript": "Profil yapılandırmasının birleştirilmiş sonucunu kullanarak yalnızca bu profile uygulanır. Uygulama ayarları yeniden uygulanmadan önceki son genişletme adımıdır.",
"order": "Sıra: Özgün profil → Uygulama ayarları → Genel genişletme yapılandırması → Genel genişletme betiği → Profil genişletme yapılandırması → Profil genişletme betiği → Uygulama ayarlarının yeniden uygulanması",
"settingsPriority": "Not: Uygulama ayarları tarafından yönetilen alanlar, son yapılandırmada her zaman bu ayarların değerlerini kullanır. Bu alanları genişletmelerde değiştirmenin etkisi yoktur."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "Уку режимында үзгәртү мөмкин түгел"
},
"enhance": {
"globalMerge": "Кушымта көйләүләреннән соң барлык профильләргә кулланыла. Глобаль скрипт, профиль конфигурациясе һәм профиль скрипты нәтиҗәне әле үзгәртә ала.",
"globalScript": "Глобаль конфигурацияне берләштерү нәтиҗәсен кулланып, барлык профильләргә кулланыла. Профиль конфигурациясе һәм профиль скрипты нәтиҗәне әле үзгәртә ала.",
"profileMerge": "Глобаль конфигурация һәм глобаль скрипттан соң шушы профильгә генә кулланыла. Профиль скрипты нәтиҗәне әле үзгәртә ала.",
"profileScript": "Профиль конфигурациясен берләштерү нәтиҗәсен кулланып, шушы профильгә генә кулланыла. Бу — кушымта көйләүләрен яңадан куллану алдыннан соңгы киңәйтү адымы.",
"order": "Тәртип: Башлангыч профиль → Кушымта көйләүләре → Глобаль киңәйтү конфигурациясе → Глобаль киңәйтү скрипты → Профиль киңәйтү конфигурациясе → Профиль киңәйтү скрипты → Кушымта көйләүләрен яңадан куллану",
"settingsPriority": "Искәрмә: Кушымта көйләүләре идарә иткән кырлар соңгы конфигурациядә һәрвакыт шул көйләүләрнең кыйммәтләрен куллана. Бу кырларны киңәйтүләрдә үзгәртү тәэсир итми."
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "无法在只读模式下编辑"
},
"enhance": {
"globalMerge": "对所有订阅生效,在应用设置之后合并;后续的全局脚本、订阅扩展配置和订阅脚本仍可修改结果。",
"globalScript": "对所有订阅生效,接收全局扩展配置合并后的结果;后续的订阅扩展配置和订阅脚本仍可修改结果。",
"profileMerge": "仅对当前订阅生效,在全局扩展配置和全局脚本之后合并;后续的订阅脚本仍可修改结果。",
"profileScript": "仅对当前订阅生效,接收订阅扩展配置合并后的结果,是应用设置回写前的最后一个扩展步骤。",
"order": "执行顺序:订阅原文 → 应用设置 → 全局扩展配置 → 全局扩展脚本 → 订阅扩展配置 → 订阅扩展脚本 → 应用设置回写",
"settingsPriority": "注意:由应用设置接管的字段最终以应用设置为准,在扩展配置或脚本中修改这些字段不会生效。"
}
},
"confirmDelete": {
+8
View File
@@ -197,6 +197,14 @@
},
"messages": {
"readOnly": "無法在唯讀模式下編輯"
},
"enhance": {
"globalMerge": "對所有訂閱生效,在應用程式設定之後合併;後續的全域腳本、訂閱擴充設定和訂閱腳本仍可修改結果。",
"globalScript": "對所有訂閱生效,接收全域擴充設定合併後的結果;後續的訂閱擴充設定和訂閱腳本仍可修改結果。",
"profileMerge": "僅對目前訂閱生效,在全域擴充設定和全域腳本之後合併;後續的訂閱腳本仍可修改結果。",
"profileScript": "僅對目前訂閱生效,接收訂閱擴充設定合併後的結果,是應用程式設定回寫前的最後一個擴充步驟。",
"order": "執行順序:訂閱原文 → 應用程式設定 → 全域擴充設定 → 全域擴充腳本 → 訂閱擴充設定 → 訂閱擴充腳本 → 應用程式設定回寫",
"settingsPriority": "注意:由應用程式設定接管的欄位最終以應用程式設定為準,在擴充設定或腳本中修改這些欄位不會生效。"
}
},
"confirmDelete": {
+6
View File
@@ -270,6 +270,12 @@ export const translationKeys = [
'profiles.modals.groupsEditor.actions.append',
'profiles.modals.editor.actions.format',
'profiles.modals.editor.messages.readOnly',
'profiles.modals.editor.enhance.globalMerge',
'profiles.modals.editor.enhance.globalScript',
'profiles.modals.editor.enhance.profileMerge',
'profiles.modals.editor.enhance.profileScript',
'profiles.modals.editor.enhance.order',
'profiles.modals.editor.enhance.settingsPriority',
'profiles.modals.confirmDelete.title',
'profiles.modals.confirmDelete.message',
'profiles.modals.logViewer.title',
+8
View File
@@ -320,6 +320,14 @@ export interface TranslationResources {
actions: {
format: string
}
enhance: {
globalMerge: string
globalScript: string
order: string
profileMerge: string
profileScript: string
settingsPriority: string
}
messages: {
readOnly: string
}