@lesliechan721/aw 0.1.0-beta.52 → 0.1.0-beta.53

package/dist/src/tui/console-app-v4.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { configReferenceKey, configReferenceValues, configReferenceScalars, configReferenceSelection, configReferenceMessage, configCrossLayerDependencies } from './config-references.js';
 import { arrayDraftChanged, arrayDraftValue, createConfigArrayDraft, editConfigArrayDraft } from './config-array-draft.js';
 import { PLUGIN_CONFIG_ARRAY_MAX_ITEMS } from '@lesliechan721/aw-plugin-core';
 import { presentConfigValue, safeConfigText } from './config-value-presentation.js';
@@ -1013,6 +1014,8 @@ export function ConsoleAppV4(props) {
     const [configLayerCounts, setConfigLayerCounts] = useState({});
     const [configLayerPages, setConfigLayerPages] = useState({});
     const [configDrafts, setConfigDrafts] = useState({});
+    const [referenceContexts, setReferenceContexts] = useState({});
+    const [referenceContextError, setReferenceContextError] = useState();
     const [configCandidate, setConfigCandidate] = useState();
     const [arrayDrafts, setArrayDrafts] = useState({});
     const [arrayToolsOpen, setArrayToolsOpen] = useState(false);
@@ -1092,7 +1095,8 @@ export function ConsoleAppV4(props) {
         const draft = configDrafts[draftScope];
         return count + Object.keys(draft?.updates ?? {}).length + (draft?.removes.length ?? 0);
     }, 0);
-    const draftUpdates = {
+    const editingScope = 'layer' in route && route.layer && route.layer.scope !== 'effective' ? route.layer.scope : undefined;
+    const draftUpdates = editingScope ? configDrafts[editingScope]?.updates ?? {} : {
         ...(configDrafts.user?.updates ?? {}),
         ...(configDrafts.project?.updates ?? {}),
     };
@@ -1380,7 +1384,7 @@ export function ConsoleAppV4(props) {
         if (currentFlowId && sourceDraft)
             externalDraftFlowIds.current.set(sourceDraft.owner, currentFlowId);
         const drafts = [];
-        if ((dirty || configCandidate || nestedPropertyRevision || objectVariantPreview || Object.values(arrayDrafts).some((draft) => draft.initial === undefined ? draft.rows.length > 0 : arrayDraftChanged(draft)) || changedObjectDraftKeys.length > 0) && draftOwner) {
+        if ((dirty || configCandidate && !configCandidate.selectingScope || nestedPropertyRevision || objectVariantPreview || Object.values(arrayDrafts).some((draft) => draft.initial === undefined ? draft.rows.length > 0 : arrayDraftChanged(draft)) || changedObjectDraftKeys.length > 0) && draftOwner) {
             const flowId = externalDraftFlowIds.current.get(draftOwner);
             drafts.push({
                 kind: 'configDraft', owner: draftOwner, revision: externalDraftRevision.current.config,
@@ -1406,7 +1410,30 @@ export function ConsoleAppV4(props) {
         configDrafts, configCandidate, arrayDrafts, objectDrafts, nestedPropertyRevision, objectVariantPreview, route.name, snapshot.router.currentFlowId, sourceDraft,
     ]);
     useEffect(() => () => props.controller.setExternalDraftState(), [props.controller]);
-    const currentConfigPage = configPageMatches(configPage, configRoute) ? configPage : undefined;
+    const currentConfigPage = configPageMatches(configPage, configRoute) ? configPage
+        : configRoute && configRoute.layer.scope !== 'effective' ? configLayerPages[configRoute.layer.scope] : undefined;
+    const hasReferenceFields = (configPage ?? configLayerPages.user ?? configLayerPages.project)?.groups
+        .some((group) => group.fields.some((field) => configReferenceScalars(field.definition).length > 0)) ?? false;
+    useEffect(() => {
+        if (!configFlowPluginId || !hasReferenceFields)
+            return;
+        const abort = new AbortController();
+        setReferenceContexts({});
+        setReferenceContextError(undefined);
+        void Promise.allSettled(['user', 'project'].map(async (scope) => ({ scope,
+            context: await props.controller.getConfigReferenceContext(configFlowPluginId, scope, configDrafts[scope] ?? { updates: {}, removes: [] }, abort.signal),
+        }))).then((results) => {
+            if (abort.signal.aborted)
+                return;
+            setReferenceContexts(Object.fromEntries(results.flatMap((result) => result.status === 'fulfilled'
+                ? [[result.value.scope, result.value.context]] : [])));
+            if (results.some((result) => result.status === 'rejected'))
+                setReferenceContextError('引用来源读取失败。请返回修复来源配置后重新打开设置。');
+        });
+        return () => abort.abort();
+    }, [props.controller, configFlowPluginId, configDrafts, editingScope, hasReferenceFields]);
+    const crossLayerDependencies = configCrossLayerDependencies(Object.fromEntries((configPage?.groups ?? []).flatMap((group) => group.fields.map((field) => [field.key, field.definition]))), configDrafts, referenceContexts);
+    const referenceContext = editingScope ? referenceContexts[editingScope] : undefined;
     const configDraftIssues = (() => {
         const issues = [];
         for (const draftScope of ['project', 'user']) {
@@ -1744,9 +1771,11 @@ export function ConsoleAppV4(props) {
     useEffect(() => {
         if (!activeArrayKey || activeArrayDraft || !activeTopField || route.name !== 'configFieldEditor')
             return;
+        if (route.layer.scope === 'effective' && configReferenceScalars(activeTopField.definition).length)
+            return;
         const value = draftUpdates[activeTopField.key] ?? activeTopField.draftValue ?? activeTopField.value;
         setArrayDrafts((current) => ({ ...current, [activeArrayKey]: { ...createConfigArrayDraft(Array.isArray(value) ? value : undefined), evidence: currentConfigPage?.editEvidence } }));
-    }, [activeArrayKey, activeArrayDraft, activeTopField, route.name]);
+    }, [activeArrayKey, activeArrayDraft, activeTopField, route.name, editingScope]);
     useEffect(() => {
         if (route.name !== 'configFieldEditor' || route.editor !== 'array' || !activeArrayKey || !activeArrayDraft)
             return;
@@ -1811,6 +1840,15 @@ export function ConsoleAppV4(props) {
         || activePropertyDefinition?.sensitive === true;
     const activeFieldIsConst = activeField && 'const' in activeField.definition && activeField.definition.const !== undefined;
     const activePropertyIsConst = activePropertyDefinition && 'const' in activePropertyDefinition && activePropertyDefinition.const !== undefined;
+    const referenceNotice = (scalar, value) => {
+        const selection = referenceContext?.selections[configReferenceKey(scalar)];
+        const message = referenceContextError && !selection ? referenceContextError : configReferenceMessage(scalar, selection, value);
+        const source = 'valueRef' in scalar ? scalar.valueRef.field : '';
+        const pendingSource = editingScope === 'project' && selection?.source !== 'project'
+            && (Object.hasOwn(configDrafts.user?.updates ?? {}, source) || configDrafts.user?.removes.includes(source));
+        return [message, pendingSource ? `来源 ${source} 在个人默认有未保存修改。请先保存来源配置，再编辑或保存引用配置。` : undefined]
+            .filter(Boolean).join(' ') || undefined;
+    };
     useEffect(() => {
         if (route.name !== 'configFieldEditor' || !activeField)
             return;
@@ -2973,8 +3011,8 @@ export function ConsoleAppV4(props) {
     const fieldEditor = (field) => {
         return field.type;
     };
-    const fieldEditorMode = (field) => (field.choices?.length ?? 0) > 0 ? { mode: 'choices' } : {};
-    const openConfigTarget = (candidate) => {
+    const fieldEditorMode = (field) => (field.choices?.length ?? 0) > 0 || 'valueRef' in field.definition && field.definition.valueRef ? { mode: 'choices' } : {};
+    const openConfigTarget = (candidate, replace = false) => {
         const currentFlowId = snapshot.router.currentFlowId;
         const storedAnchor = configOverviewAnchors.current.get(candidate.pluginId);
         const storedOverviewFrameId = storedAnchor && storedAnchor.flowId === currentFlowId
@@ -2986,18 +3024,32 @@ export function ConsoleAppV4(props) {
             ...(currentFlowId ? { flowId: currentFlowId } : {}),
             ...(overviewFrameId ? { overviewFrameId } : {}),
         });
-        go({
+        const targetRoute = {
             name: 'configLayer',
             pluginId: candidate.pluginId,
             ...(candidate.fieldKey ? { fieldKey: candidate.fieldKey } : {}),
             ...(candidate.groupId ? { groupId: candidate.groupId } : {}),
             ...(candidate.presetId ? { presetId: candidate.presetId } : {}),
-        });
+        };
+        if (replace)
+            props.controller.replace(targetRoute);
+        else
+            go(targetRoute);
     };
     const updateDraft = (key, value) => {
         if (!configRoute || !currentConfigPage)
             return;
         setConfigActionError(undefined);
+        if (activeField && editingScope) {
+            for (const { scalar, value: referencedValue } of configReferenceValues(activeField.definition, value)) {
+                const selected = referenceContext?.selections[configReferenceKey(scalar)];
+                if (!selected || selected.issues.length || !selected.choices.some((choice) => choice.value === referencedValue)) {
+                    setObjectError(referenceNotice(scalar, referencedValue));
+                    setInputError(referenceNotice(scalar, referencedValue));
+                    return;
+                }
+            }
+        }
         if (arrayItem && activeArrayKey && activeArrayDraft && activeField) {
             const issues = validatePluginConfigValue(activeField.definition, value, key);
             if (issues.length) {
@@ -3021,13 +3073,18 @@ export function ConsoleAppV4(props) {
             back();
             return;
         }
-        openConfigTarget({
+        const candidate = {
             pluginId: configRoute.pluginId,
             fieldKey: key,
             groupId: snapshot.router.current.context.configGroupId,
             mutations: { [key]: { kind: 'set', value } },
             ...(activeArrayDraft?.evidence ? { editEvidence: activeArrayDraft.evidence } : {}),
-        });
+        };
+        if (editingScope && activeTopField && configReferenceScalars(activeTopField.definition).length) {
+            openConfigLayerTarget({ scope: editingScope }, candidate);
+        }
+        else
+            openConfigTarget(candidate);
     };
     const editArray = (edit) => {
         if (!activeArrayKey || !activeArrayDraft)
@@ -3046,7 +3103,7 @@ export function ConsoleAppV4(props) {
         go({
             name: 'configFieldEditor', pluginId: configRoute.pluginId, layer: configRoute.layer,
             fieldKey: activeField.key, editor: activeField.definition.items.type,
-            ...(activeField.definition.items.choices ? { mode: 'choices' } : {}),
+            ...(activeField.definition.items.choices || 'valueRef' in activeField.definition.items && activeField.definition.items.valueRef ? { mode: 'choices' } : {}),
             arrayItem: { rowId },
         });
     };
@@ -3070,12 +3127,16 @@ export function ConsoleAppV4(props) {
         if (!configRoute)
             return;
         setConfigActionError(undefined);
-        openConfigTarget({
+        const candidate = {
             pluginId: configRoute.pluginId,
             fieldKey: key,
             groupId: snapshot.router.current.context.configGroupId,
             mutations: { [key]: { kind: 'unset' } },
-        });
+        };
+        if (editingScope && activeTopField && configReferenceScalars(activeTopField.definition).length)
+            openConfigLayerTarget({ scope: editingScope }, candidate);
+        else
+            openConfigTarget(candidate);
     };
     const updateObjectDraft = (value) => {
         if (!activeObjectKey)
@@ -3110,7 +3171,7 @@ export function ConsoleAppV4(props) {
             setChangedObjectDraftKeys((current) => current.filter((key) => key !== activeObjectKey));
         }
     };
-    const objectPropertyStage = (definition) => definition.type === 'boolean' || definition.choices ? 'choices' : 'custom';
+    const objectPropertyStage = (definition) => definition.type === 'boolean' || definition.choices || 'valueRef' in definition && definition.valueRef ? 'choices' : 'custom';
     const openObjectProperty = (propertyKey, dynamic) => {
         if (!activeField || activeField.definition.type !== 'object')
             return;
@@ -3118,13 +3179,13 @@ export function ConsoleAppV4(props) {
             ?? (activeField.definition.additionalProperties === false
                 ? undefined
                 : activeField.definition.additionalProperties);
-        if (!definition || 'const' in definition && definition.const !== undefined)
+        if (!definition || 'const' in definition && definition.const !== undefined && !('valueRef' in definition && definition.valueRef))
             return;
         const exists = activeObjectDraft && Object.hasOwn(activeObjectDraft, propertyKey);
         go({
             name: 'configObjectPropertyEditor',
             pluginId: configRoute.pluginId,
-            layer: { scope: 'effective' },
+            layer: configRoute.layer,
             fieldKey: activeField.key,
             propertyKey,
             dynamic,
@@ -3207,17 +3268,45 @@ export function ConsoleAppV4(props) {
             mutations,
         });
     };
-    const openConfigLayerTarget = (layer) => {
-        if (route.name !== 'configLayer')
+    const openConfigLayerTarget = (layer, explicitCandidate) => {
+        const candidate = explicitCandidate ?? configCandidate;
+        if (!candidate)
             return;
-        if (!configCandidate || configCandidate.pluginId !== route.pluginId)
+        const selectedCandidate = { ...candidate,
+            flowId: candidate.flowId ?? snapshot.router.currentFlowId,
+            overviewFrameId: candidate.overviewFrameId ?? configOverviewAnchors.current.get(candidate.pluginId)?.overviewFrameId,
+        };
+        if (selectedCandidate.selectingScope) {
+            const field = configLayerPages[layer.scope]?.groups.flatMap((group) => group.fields).find((field) => field.key === selectedCandidate.fieldKey);
+            if (!field || !configFieldCanSet(field))
+                return;
+            if (field.definition.type === 'array') {
+                const owner = `${candidate.pluginId}\0${field.key}`;
+                const working = arrayDrafts[owner];
+                if (working) {
+                    const stored = configDrafts[layer.scope]?.updates[field.key] ?? field.draftValue ?? field.value;
+                    setArrayDrafts((current) => ({ ...current, [owner]: { ...working,
+                            initial: Array.isArray(stored) ? structuredClone(stored) : undefined,
+                            evidence: configLayerPages[layer.scope]?.editEvidence,
+                        } }));
+                }
+            }
+            const available = ['user', 'project'].filter((scope) => configLayerPages[scope]?.groups
+                .flatMap((group) => group.fields).some((entry) => entry.key === field.key && configFieldCanSet(entry)));
+            const next = { name: 'configFieldEditor', pluginId: candidate.pluginId, layer, fieldKey: field.key,
+                editor: fieldEditor(field), ...fieldEditorMode(field) };
+            if (available.length === 1)
+                props.controller.replace(next);
+            else
+                go(next);
             return;
+        }
         const page = configLayerPages[layer.scope];
         if (!page)
             return;
         const fields = new Map(page.groups.flatMap((group) => group.fields)
             .map((field) => [field.key, field]));
-        const valid = Object.entries(configCandidate.mutations).every(([key, mutation]) => {
+        const valid = Object.entries(selectedCandidate.mutations).every(([key, mutation]) => {
             const field = fields.get(key);
             return Boolean(field && (mutation.kind === 'set' ? configFieldCanSet(field) : configFieldCanUnset(field)));
         });
@@ -3229,10 +3318,10 @@ export function ConsoleAppV4(props) {
         const updates = { ...previous.updates };
         const removes = new Set(previous.removes);
         const editEvidence = { ...previous.editEvidence };
-        for (const [key, mutation] of Object.entries(configCandidate.mutations)) {
+        for (const [key, mutation] of Object.entries(selectedCandidate.mutations)) {
             const field = fields.get(key);
-            if (configCandidate.editEvidence)
-                editEvidence[key] = configCandidate.editEvidence;
+            if (selectedCandidate.editEvidence)
+                editEvidence[key] = selectedCandidate.editEvidence;
             else
                 delete editEvidence[key];
             if (mutation.kind === 'set') {
@@ -3255,20 +3344,23 @@ export function ConsoleAppV4(props) {
         const next = { ...configDrafts, [layer.scope]: { updates, removes: [...removes], editEvidence } };
         if (Object.keys(updates).length === 0 && removes.size === 0)
             delete next[layer.scope];
-        const target = configCandidate.fieldKey
-            ? configFieldTarget(configPage ?? page, configCandidate.fieldKey)
-            : configCandidate.groupId ? { groupId: configCandidate.groupId, focusIndex: 0 } : undefined;
-        const returned = props.controller.returnToConfigOverview(configCandidate.flowId, configCandidate.overviewFrameId, route.pluginId, target ? { configGroupId: target.groupId, focusIndex: target.focusIndex, scrollOffset: 0 } : undefined);
+        const target = selectedCandidate.fieldKey
+            ? configFieldTarget(configPage ?? page, selectedCandidate.fieldKey)
+            : selectedCandidate.groupId ? { groupId: selectedCandidate.groupId, focusIndex: 0 } : undefined;
+        const returned = props.controller.returnToConfigOverview(selectedCandidate.flowId, selectedCandidate.overviewFrameId, selectedCandidate.pluginId, target ? { configGroupId: target.groupId, focusIndex: target.focusIndex, scrollOffset: 0 } : undefined);
         if (!returned) {
             setConfigActionError('设置总览已变化。请返回插件详情后重新打开设置。');
             return;
         }
-        if (!configCandidate.flowId) {
-            props.controller.replace({ name: 'configFields', pluginId: route.pluginId, layer: { scope: 'effective' } }, target ? { configGroupId: target.groupId, focusIndex: target.focusIndex, scrollOffset: 0 } : undefined);
+        if (!selectedCandidate.flowId) {
+            props.controller.replace({ name: 'configFields', pluginId: selectedCandidate.pluginId, layer: { scope: 'effective' } }, target ? { configGroupId: target.groupId, focusIndex: target.focusIndex, scrollOffset: 0 } : undefined);
         }
-        if (configCandidate.fieldKey) {
-            const owner = `${configCandidate.pluginId}\0${configCandidate.fieldKey}`;
+        if (selectedCandidate.fieldKey) {
+            const owner = `${selectedCandidate.pluginId}\0${selectedCandidate.fieldKey}`;
+            const belongsToField = (key) => key === owner || key.startsWith(`${owner}\0`);
             setArrayDrafts((current) => Object.fromEntries(Object.entries(current).filter(([key]) => key !== owner)));
+            setObjectDrafts((current) => Object.fromEntries(Object.entries(current).filter(([key]) => !belongsToField(key))));
+            setChangedObjectDraftKeys((current) => current.filter((key) => !belongsToField(key)));
         }
         setConfigDrafts(next);
         setDirty(Object.keys(next).length > 0);
@@ -3284,6 +3376,8 @@ export function ConsoleAppV4(props) {
             if (!page)
                 return false;
             const fields = page.groups.flatMap((group) => group.fields);
+            if (configCandidate.selectingScope)
+                return fields.some((field) => field.key === configCandidate.fieldKey && configFieldCanSet(field));
             return Object.entries(configCandidate.mutations).every(([key, mutation]) => {
                 const field = fields.find((entry) => entry.key === key);
                 return field && (mutation.kind === 'set' ? configFieldCanSet(field) : configFieldCanUnset(field));
@@ -3291,9 +3385,16 @@ export function ConsoleAppV4(props) {
         });
         if (scopes.length === 1) {
             openConfigLayerTarget({ scope: scopes[0] });
-            setConfigActionError(`仅可保存到${configLayerLabel({ scope: scopes[0] })}；已加入待保存修改。`);
+            if (!configCandidate.selectingScope)
+                setConfigActionError(`仅可保存到${configLayerLabel({ scope: scopes[0] })}；已加入待保存修改。`);
         }
     }, [route.name, configCandidate, configLayerPages]);
+    useEffect(() => {
+        if (route.name !== 'configFieldEditor' || route.layer.scope !== 'effective' || arrayItem || !activeTopField
+            || !configReferenceScalars(activeTopField.definition).length)
+            return;
+        openConfigTarget({ pluginId: route.pluginId, fieldKey: activeTopField.key, selectingScope: true, mutations: {} }, true);
+    }, [route.name, route.name === 'configFieldEditor' ? route.layer.scope : '', activeTopField?.key]);
     const configChanges = (page, draft) => {
         const fields = page.groups.flatMap((group) => group.fields);
         return [...Object.keys(draft.updates), ...draft.removes.filter((key) => !Object.hasOwn(draft.updates, key))]
@@ -3427,6 +3528,16 @@ export function ConsoleAppV4(props) {
         };
     };
     const beginConfigSave = async (apply) => {
+        if (crossLayerDependencies.length) {
+            setConfigActionError(`请先保存来源配置，再编辑或保存引用配置：${[...new Set(crossLayerDependencies.map((entry) => entry.source))].join('、')}（个人默认）。请取消相关引用草稿后保存来源。`);
+            return;
+        }
+        if (['user', 'project'].some((scope) => !referenceContexts[scope]
+            && Object.keys(configDrafts[scope]?.updates ?? {}).some((key) => configPage?.groups.flatMap((group) => group.fields)
+                .some((field) => field.key === key && configReferenceScalars(field.definition).length)))) {
+            setConfigActionError(referenceContextError ?? '正在读取引用来源，请稍后保存。');
+            return;
+        }
         if (configDraftIssues.length > 0) {
             setConfigActionError('字段已变化。请先放弃失效草稿，或返回继续检查来源。');
             return;
@@ -4494,7 +4605,7 @@ export function ConsoleAppV4(props) {
             { label: '自动选择可用 Agent', description: '按当前环境确定可用 Agent，不承诺全部 Agent 可用', meta: '默认', selected: snapshot.portableDraft.agentMode === 'automatic', run: () => { props.controller.setPortableAgentMode('automatic'); go({ name: 'portableScope', pluginId: plugin.pluginId }); } },
             { label: '指定 Agent', description: '输入一个或多个 Agent ID', selected: snapshot.portableDraft.agentMode === 'explicit', run: () => go({ name: 'portableAgentInput', pluginId: plugin.pluginId }) },
         ];
-        content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+        content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
     }
     else if (route.name === 'portableAgentInput' && plugin) {
         breadcrumb = `${plugin.displayName} / 通用 Skills / Agent`;
@@ -5748,7 +5859,7 @@ export function ConsoleAppV4(props) {
             : candidateSummaryLines[0];
         title = selectedField ? `“${selectedField.title}”保存到哪里？`
             : selectedPreset ? `“${selectedPreset.title}”保存到哪里？` : '这个值保存到哪里？';
-        description = selectedField
+        description = configCandidate?.selectingScope ? '先选择保存位置，再按该层配置选择引用值。' : selectedField
             ? `${selectedField.sensitive ? '敏感值只能保存到个人设置。' : '选择后回到分组总览；磁盘尚未改变。'}`
             : selectedPreset ? '选择后回到分组总览；磁盘尚未改变。' : '请返回重新选择值。';
         if (configActionError)
@@ -5759,6 +5870,8 @@ export function ConsoleAppV4(props) {
             if (!page || !configCandidate)
                 return false;
             const fields = page.groups.flatMap((group) => group.fields);
+            if (configCandidate.selectingScope)
+                return fields.some((field) => field.key === configCandidate.fieldKey && configFieldCanSet(field));
             return Object.entries(configCandidate.mutations).every(([key, mutation]) => {
                 const field = fields.find((candidate) => candidate.key === key);
                 return Boolean(field && (mutation.kind === 'set' ? configFieldCanSet(field) : configFieldCanUnset(field)));
@@ -5834,12 +5947,31 @@ export function ConsoleAppV4(props) {
                         };
                     })(),
                     configKey: field.key,
-                    run: () => go({
-                        name: 'configFieldEditor', pluginId: plugin.pluginId, layer: mutableLayer,
-                        fieldKey: field.key, editor: fieldEditor(field), ...fieldEditorMode(field),
-                    }),
+                    run: () => configReferenceScalars(field.definition).length
+                        ? openConfigTarget({ pluginId: plugin.pluginId, fieldKey: field.key, selectingScope: true, mutations: {} })
+                        : go({ name: 'configFieldEditor', pluginId: plugin.pluginId, layer: mutableLayer,
+                            fieldKey: field.key, editor: fieldEditor(field), ...fieldEditorMode(field) }),
                 }));
             const operationActions = [
+                ...(crossLayerDependencies.length ? [{
+                        label: '取消跨层引用草稿，保留来源修改',
+                        description: '先保存个人默认来源，再重新编辑当前项目引用。',
+                        run: () => {
+                            const keys = new Set(crossLayerDependencies.map((entry) => entry.key));
+                            const next = { ...configDrafts };
+                            const project = next.project;
+                            const updates = Object.fromEntries(Object.entries(project.updates).filter(([key]) => !keys.has(key)));
+                            if (Object.keys(updates).length || project.removes.length)
+                                next.project = { ...project, updates };
+                            else
+                                delete next.project;
+                            setConfigDrafts(next);
+                            setObjectDrafts({});
+                            setArrayDrafts({});
+                            setChangedObjectDraftKeys([]);
+                            setConfigActionError('已取消相关引用草稿。请先保存来源，再重新编辑引用。');
+                        },
+                    }] : []),
                 ...(configDraftIssues.length > 0 ? [{
                         label: '放弃无法保存的修改',
                         description: `${configDraftIssues.length} 项未保存修改已不再适用于当前插件设置；放弃后不会修改已保存设置。`,
@@ -5882,7 +6014,7 @@ export function ConsoleAppV4(props) {
                     beginConfigSave(true);
                 },
             };
-            bottomActions = [configSaveAction, {
+            bottomActions = [configSaveAction, ...(crossLayerDependencies.length ? operationActions.slice(0, 1) : []), {
                     label: '设置选项', run: () => go({ ...route, view: 'options' }),
                 }];
             actions = [...tabActions, ...bottomActions];
@@ -5993,7 +6125,8 @@ export function ConsoleAppV4(props) {
     }
     else if (route.name === 'configFieldEditor' && plugin && activeField) {
         breadcrumb = `${plugin.displayName} / 设置 / ${activeField.title}`;
-        const showChoices = (activeField.choices?.length ?? 0) > 0 && route.mode !== 'custom';
+        const scalarReference = 'valueRef' in activeField.definition && activeField.definition.valueRef ? activeField.definition : undefined;
+        const showChoices = Boolean(scalarReference) || (activeField.choices?.length ?? 0) > 0 && route.mode !== 'custom';
         const targetFields = ['project', 'user'].flatMap((scope) => configLayerPages[scope]?.groups.flatMap((group) => group.fields).filter((field) => field.key === activeField.key) ?? []);
         const canSet = targetFields.some(configFieldCanSet);
         const canUnset = !arrayItem && targetFields.some(configFieldCanUnset);
@@ -6003,6 +6136,16 @@ export function ConsoleAppV4(props) {
             actions = canUnset ? [{ label: '删除此覆盖并恢复继承', run: () => removeDraft(activeField.key) }] : [];
             content = _jsxs(Box, { flexDirection: "column", children: [_jsx(StatusCard, { status: "warning", title: "\u4EC5\u53EF\u5220\u9664\u65E7\u503C", description: description }), _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true })] });
         }
+        else if (scalarReference) {
+            const selection = configReferenceSelection(referenceContext, scalarReference);
+            const current = arrayItem ? itemValue : draftUpdates[activeField.key] ?? activeField.draftValue ?? activeField.value;
+            title = `选择${activeField.title}`;
+            description = referenceNotice(scalarReference, current) ?? `选项来自 ${scalarReference.valueRef.field}；保存到${editingScope === 'user' ? '个人默认' : '当前项目'}。`;
+            help = '↑↓ 移动 · Enter 使用 · Esc 返回修复来源';
+            actions = selection.choices.map((choice) => ({ label: safeConfigText(choice.title), selected: choice.value === current,
+                run: () => updateDraft(activeField.key, choice.value) }));
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+        }
         else if ('const' in activeField.definition && activeField.definition.const !== undefined) {
             title = activeField.title;
             description = '这个值由插件固定，不能编辑。';
@@ -6047,7 +6190,7 @@ export function ConsoleAppV4(props) {
                         },
                     }] : []),
             ];
-            content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
         }
         else if (route.editor === 'array' && activeField.definition.type === 'array') {
             title = activeField.title;
@@ -6079,7 +6222,7 @@ export function ConsoleAppV4(props) {
                 ? activeCandidateMutation.value
                 : (arrayItem ? itemValue : draftUpdates[activeField.key]) ?? activeField.value;
             actions = [{ label: '开启', selected: !activeField.sensitive && current === true, run: () => updateDraft(activeField.key, true) }, { label: '关闭', selected: !activeField.sensitive && current === false, run: () => updateDraft(activeField.key, false) }];
-            content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
         }
         else if (route.editor === 'object' && activeField.definition.type === 'object' && activeObjectDraft) {
             const objectDefinition = activeField.definition;
@@ -6112,10 +6255,10 @@ export function ConsoleAppV4(props) {
                     label: definition.title ?? property,
                     description: definition.description,
                     meta: propertySummary(property, definition),
-                    disabled: 'const' in definition && definition.const !== undefined
+                    disabled: 'const' in definition && definition.const !== undefined && !('valueRef' in definition && definition.valueRef)
                         && !(definition.required && !Object.hasOwn(activeObjectDraft, property)) ? '插件固定值，不能编辑' : undefined,
                     run: () => {
-                        if ('const' in definition && definition.const !== undefined) {
+                        if ('const' in definition && definition.const !== undefined && !('valueRef' in definition && definition.valueRef)) {
                             updateObjectDraft({ ...activeObjectDraft, [property]: definition.const });
                         }
                         else
@@ -6182,6 +6325,10 @@ export function ConsoleAppV4(props) {
                 : activeField.sensitive ? '当前值不会回显；留空不会自动删除旧值。' : activeField.description ?? '';
             content = _jsx(InputCard, { focused: true, title: _jsx(InputDisplay, { value: inputValue, sensitive: activeField.sensitive, placeholder: activeField.placeholder, columns: Math.max(8, size.columns - 8) }), description: inputError ?? (activeField.sensitive ? '输入已隐藏。' : activeField.placeholder ?? '按 Enter 使用输入值。'), status: inputError ? 'error' : undefined });
         }
+        if (editingScope === 'user' && activeTopField && configReferenceScalars(activeTopField.definition).length
+            && configLayerPages.project?.groups.flatMap((group) => group.fields).some((field) => field.key === activeTopField.key && field.configured)) {
+            description = `${description ?? ''} 个人默认在当前项目被覆盖。`;
+        }
         if (canUnset) {
             const unset = { label: '恢复继承', description: '选择要删除覆盖值的位置', run: () => removeDraft(activeField.key) };
             const inputEditor = canSet && !showChoices && (route.editor === 'number' || route.editor === 'string');
@@ -6218,6 +6365,18 @@ export function ConsoleAppV4(props) {
                     } }, { label: '取消切换', run: () => { setObjectVariantPreview(undefined); back(); } }];
             content = _jsxs(Box, { flexDirection: "column", children: [readingPage(readingText, size.columns - 2, Math.max(1, pageActionBudget(4))), _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true })] });
         }
+        else if (property !== undefined && definition && 'valueRef' in definition && definition.valueRef
+            && route.stage !== 'action' && route.stage !== 'key') {
+            const selection = configReferenceSelection(referenceContext, definition);
+            const current = activeObjectDraft[property];
+            title = `选择${propertyTitle}`;
+            description = referenceNotice(definition, current) ?? `选项来自 ${definition.valueRef.field}。`;
+            help = '↑↓ 移动 · Enter 使用 · Esc 返回修复来源';
+            actions = selection.choices.map((choice) => ({ label: safeConfigText(choice.title), selected: choice.value === current,
+                run: () => { if (updateObjectProperty(property, choice.value))
+                    back(); } }));
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+        }
         else if (property !== undefined && definition && 'const' in definition && definition.const !== undefined) {
             title = propertyTitle;
             description = '这个值由插件固定，不能编辑。';
@@ -6312,13 +6471,13 @@ export function ConsoleAppV4(props) {
                             },
                         }] : []),
                 ];
-            content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
         }
         else if (property !== undefined && definition && (definition.type === 'array' || definition.type === 'object')) {
             title = `编辑${propertyTitle}`;
             description = '确认后更新当前对象草稿；Esc 取消此属性的全部修改。';
             help = '↑↓ 移动 · Enter 编辑 · a 操作 · c 使用 · Esc 取消';
-            content = _jsx(ConfigLeafEditor, { definition: definition, value: activeObjectDraft[property], propertyKey: property, columns: size.columns, rowBudget: pageActionBudget(1), active: !overlay && !tooSmall && !busy, error: inputError, onDraftChange: setNestedPropertyRevision, onCancel: back, onConfirm: (value) => { if (!updateObjectProperty(property, value))
+            content = _jsx(ConfigLeafEditor, { definition: definition, value: activeObjectDraft[property], propertyKey: property, referenceContext: referenceContext, referenceNotice: referenceNotice, columns: size.columns, rowBudget: pageActionBudget(1), active: !overlay && !tooSmall && !busy, error: inputError, onDraftChange: setNestedPropertyRevision, onCancel: back, onConfirm: (value) => { if (!updateObjectProperty(property, value))
                     return false; back(); return true; } }, `${snapshot.router.currentFrameId}:${property}`);
         }
         else if (property !== undefined && definition) {
@@ -6886,7 +7045,7 @@ export function ConsoleAppV4(props) {
                 { label: 'Git 仓库', description: '使用现有自动检查默认值；可在修改汇总前单独更改', run: () => selectType('git') },
                 { label: '本地目录', description: '使用现有自动检查默认值；可在修改汇总前单独更改', run: () => selectType('path') },
             ];
-            content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "choice", compact: policy.mode === 'compact' });
+            content = _jsx(SemanticRows, { actions: [...actions], focus: focus, kind: "choice", compact: policy.mode === 'compact' });
         }
         else if (route.step === 'refPolicy') {
             title = '选择版本来源';
@@ -9976,6 +10135,7 @@ export function ConsoleAppV4(props) {
         }
         if (route.name === 'configFieldEditor'
             && !activeFieldIsConst
+            && !(activeField && 'valueRef' in activeField.definition && activeField.definition.valueRef)
             && (route.editor === 'string' || route.editor === 'number')
             && ((activeField?.choices?.length ?? 0) === 0 || route.mode === 'custom')
             && ['project', 'user'].some((scope) => configLayerPages[scope]?.groups.flatMap((group) => group.fields)
@@ -10024,6 +10184,7 @@ export function ConsoleAppV4(props) {
             && (route.stage === 'key' || route.stage === 'custom')
             && !activeVariantPreview
             && !activePropertyIsConst
+            && !(activePropertyDefinition && 'valueRef' in activePropertyDefinition && activePropertyDefinition.valueRef && route.stage !== 'key')
             && activeField?.definition.type === 'object'
             && activeObjectDraft) {
             if (key.escape) {
@@ -10302,6 +10463,13 @@ export function ConsoleAppV4(props) {
             back();
         }
         else if (globalAction === 'back' && route.name === 'configLayer') {
+            if (configCandidate?.selectingScope) {
+                setConfigCandidate(undefined);
+                const owner = `${route.pluginId}\0${route.fieldKey}`;
+                setObjectDrafts((current) => Object.fromEntries(Object.entries(current).filter(([key]) => !key.startsWith(owner))));
+                setArrayDrafts((current) => Object.fromEntries(Object.entries(current).filter(([key]) => key !== owner)));
+                setChangedObjectDraftKeys((current) => current.filter((key) => !key.startsWith(owner)));
+            }
             back();
         }
         else if (globalAction === 'back'
@@ -10310,12 +10478,17 @@ export function ConsoleAppV4(props) {
         }
         else if (globalAction === 'back'
             && (route.name === 'configFieldEditor' || route.name === 'configFieldAction')) {
-            setConfigCandidate(undefined);
-            if (activeArrayKey && !arrayItem) {
+            const returnToReferenceScope = !arrayItem && editingScope && activeTopField
+                && configReferenceScalars(activeTopField.definition).length > 0
+                && ['user', 'project'].filter((scope) => configLayerPages[scope]?.groups.flatMap((group) => group.fields)
+                    .some((field) => field.key === activeTopField.key && configFieldCanSet(field))).length > 1;
+            if (!returnToReferenceScope)
+                setConfigCandidate(undefined);
+            if (activeArrayKey && !arrayItem && !returnToReferenceScope) {
                 setArrayDrafts((current) => Object.fromEntries(Object.entries(current).filter(([key]) => key !== activeArrayKey)));
                 setObjectError(undefined);
             }
-            if (activeObjectKey) {
+            if (activeObjectKey && !returnToReferenceScope) {
                 setObjectDrafts((current) => Object.fromEntries(Object.entries(current)
                     .filter(([key]) => key !== activeObjectKey)));
                 setChangedObjectDraftKeys((current) => current.filter((key) => key !== activeObjectKey));