@lesliechan721/aw 0.1.0-beta.14 → 0.1.0-beta.16

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

@@ -13,6 +13,7 @@ import { projectCatalogSourceLocation } from '../utils/catalog-source-presentati
 import { ActionRow, Callout, ChoiceRow, diagnosticDetailRowCount, DiagnosticSummary, InputCard, PluginListRow, ProgressRow, ResultCard, ResultRow, ReviewCard, ReviewChangeRow, ScreenFrame, SectionCard, SectionRow, StaticRow, StatusCard, TaskRow, TechnicalDetails, ToggleRow, } from './components.js';
 import { safeDiagnosticCode, sanitizeDiagnosticText, } from './diagnostics.js';
 import { extractPortableError, TuiConfigInvalidStoreError, userIssueKey, } from './controller.js';
+import { pluginWriteTaskVersionEvidence } from './plugin-write-task.js';
 import { catalogSourceFreshnessLabel, catalogSourceListPresentation, } from './catalog-sources/screens.js';
 import { CatalogManagementIntro, CatalogPublicationSummary, CatalogStoreSummary, CatalogWorkspaceSummary, } from './catalog-management-screens.js';
 import { operationDiagnosticLineCount, operationHistoryMeta, operationHistoryState, operationReportLineCount, OperationDiagnosticScreen, OperationReportPreviewScreen, } from './operation-diagnostic-screens.js';
@@ -175,13 +176,16 @@ function pluginWriteTaskTargetKey(candidate) {
     const { pluginId, platform, scope } = candidate.target;
     return [pluginId, platform, scope].join('\0');
 }
-function pluginWriteTaskVersionEvidence(plugin, candidates) {
-    return Object.fromEntries(candidates.flatMap((candidate) => {
-        const update = plugin.update.targets.find((target) => target.platform === candidate.target.platform && target.scope === candidate.target.scope);
-        const version = candidate.target.expectedUpdate?.activeVersion
-            ?? update?.candidateVersion ?? update?.availableVersion;
-        return version ? [[pluginWriteTaskTargetKey(candidate), version]] : [];
-    }));
+function dependencyGraphContextKey(pluginId, direction) {
+    return `${pluginId}\0${direction}`;
+}
+function dependencyGraphActionIds(projection) {
+    return [
+        ...projection.rows.map((row) => `row:${row.id}`),
+        ...projection.scopeSummary.unknownConsumerPluginIds.map((pluginId) => `unverified:${pluginId}`),
+        'direction',
+        'technical',
+    ];
 }
 function statusText(plugin) {
     if (plugin.configOnly)
@@ -927,6 +931,7 @@ export function ConsoleAppV4(props) {
     const [pendingLayerFieldKey, setPendingLayerFieldKey] = useState();
     const [confirmedSharedReviewToken, setConfirmedSharedReviewToken] = useState();
     const dynamicMenuFocus = useRef(undefined);
+    const dependencyGraphContexts = useRef(new Map());
     const externalDraftRevision = useRef({ config: 0, source: 0, batch: 0, catalog: 0 });
     const previousExternalDraftValues = useRef({
         draftUpdates, draftRemoves, objectDrafts, changedObjectDraftKeys, sourceDraft, batchDraft,
@@ -1039,9 +1044,9 @@ export function ConsoleAppV4(props) {
             || snapshot.result.operationKind !== 'pluginWriteTask'
             || !('returnRoute' in snapshot.result)
             || snapshot.result.returnRoute?.name !== 'pluginWriteTask'
+            || snapshot.result.returnRoute.goal !== snapshot.result.summary.task?.goal
             || snapshot.result.returnRoute.batchOrigin?.owner !== 'batch-write'
-            || snapshot.result.returnRoute.batchOrigin.flowId
-                !== batchDraft?.flowId)
+            || snapshot.result.returnRoute.batchOrigin.flowId !== batchDraft?.flowId)
             return;
         setBatchDraft(undefined);
         setDirty(false);
@@ -1439,6 +1444,7 @@ export function ConsoleAppV4(props) {
             const menuCount = itemCount > 0 && !query ? 1
                 + Number(route.mode === 'installed' && props.controller.listPluginWriteTaskCandidates('update')
                     .some((candidate) => candidate.eligible && listed.has(candidate.target.pluginId)))
+                + Number(route.mode === 'installed' && props.controller.listCurrentProjectIntentRoots().length > 0)
                 + Number(route.mode === 'installed' && props.controller.listPluginWriteTaskCandidates('restore')
                     .some((candidate) => candidate.target.scope === 'project')) : 0;
             count = itemCount + menuCount || 1;
@@ -1465,13 +1471,48 @@ export function ConsoleAppV4(props) {
     useEffect(() => {
         if (route.name !== 'pluginDependencies')
             return;
-        setExpandedDependencyPluginIds(undefined);
-        setFocus(0);
-        setScrollOffset(0);
+        const direction = route.direction ?? 'dependencies';
+        const key = dependencyGraphContextKey(route.pluginId, direction);
+        const stored = dependencyGraphContexts.current.get(key);
+        const overviews = props.controller.listPluginDependencyOverviews();
+        const knownPluginIds = new Set(overviews.flatMap((overview) => [
+            overview.pluginId,
+            ...overview.dependencies.map((item) => item.pluginId),
+            ...overview.dependents.map((item) => item.pluginId),
+        ]));
+        const expandedPluginIds = stored
+            ? new Set([...stored.expandedPluginIds].filter((pluginId) => knownPluginIds.has(pluginId)))
+            : undefined;
+        const projection = buildDependencyGraphProjection({
+            overviews,
+            rootPluginId: route.pluginId,
+            direction,
+            ...(expandedPluginIds ? { expandedPluginIds } : {}),
+        });
+        const actionIds = dependencyGraphActionIds(projection);
+        const normalizedExpanded = expandedPluginIds ?? new Set(projection.defaultExpandedPluginIds);
+        const focusedIndex = stored?.focusedActionId
+            ? actionIds.indexOf(stored.focusedActionId)
+            : 0;
+        const nextFocus = focusedIndex >= 0 ? focusedIndex : 0;
+        const anchorIndex = stored?.scrollAnchorActionId
+            ? actionIds.indexOf(stored.scrollAnchorActionId)
+            : 0;
+        const nextScroll = Math.max(0, anchorIndex >= 0 ? Math.min(anchorIndex, nextFocus) : 0);
+        setExpandedDependencyPluginIds(normalizedExpanded);
+        setFocus(nextFocus);
+        setScrollOffset(nextScroll);
+        dependencyGraphContexts.current.set(key, {
+            expandedPluginIds: normalizedExpanded,
+            ...(actionIds[nextFocus] ? { focusedActionId: actionIds[nextFocus] } : {}),
+            ...(actionIds[nextScroll] ? { scrollAnchorActionId: actionIds[nextScroll] } : {}),
+        });
     }, [
+        props.controller,
         route.name,
         route.name === 'pluginDependencies' ? route.pluginId : '',
         route.name === 'pluginDependencies' ? route.direction ?? 'dependencies' : '',
+        snapshot.viewModel,
     ]);
     useEffect(() => {
         if (route.name !== 'pluginList' || snapshot.phase !== 'ready'
@@ -1489,6 +1530,7 @@ export function ConsoleAppV4(props) {
         const menuCount = query ? 0 : 1
             + Number(route.mode === 'installed' && props.controller.listPluginWriteTaskCandidates('update')
                 .some((candidate) => candidate.eligible && listed.has(candidate.target.pluginId)))
+            + Number(route.mode === 'installed' && props.controller.listCurrentProjectIntentRoots().length > 0)
             + Number(route.mode === 'installed' && props.controller.listPluginWriteTaskCandidates('restore')
                 .some((candidate) => candidate.target.scope === 'project'));
         setFocus(menuCount);
@@ -1678,6 +1720,7 @@ export function ConsoleAppV4(props) {
         return 1
             + Number(mode === 'installed' && props.controller.listPluginWriteTaskCandidates('update')
                 .some((candidate) => candidate.eligible && listed.has(candidate.target.pluginId)))
+            + Number(mode === 'installed' && props.controller.listCurrentProjectIntentRoots().length > 0)
             + Number(mode === 'installed' && props.controller.listPluginWriteTaskCandidates('restore')
                 .some((candidate) => candidate.target.scope === 'project'));
     };
@@ -1820,6 +1863,38 @@ export function ConsoleAppV4(props) {
         setFocus(0);
         setScrollOffset(0);
     };
+    useEffect(() => {
+        if (route.name !== 'pluginWriteTask' || route.goal !== 'restore')
+            return;
+        if (snapshot.router.current.context.autoPreparedRestore)
+            return;
+        const retainedTargetKeys = route.targetKeys ? new Set(route.targetKeys) : undefined;
+        const allCandidates = props.controller.listPluginWriteTaskCandidates('restore');
+        const currentTargetKeys = new Set(allCandidates.map(pluginWriteTaskTargetKey));
+        if (route.targetKeys?.some((targetKey) => !currentTargetKeys.has(targetKey)))
+            return;
+        const candidates = allCandidates
+            .filter((candidate) => retainedTargetKeys
+            ? retainedTargetKeys.has(pluginWriteTaskTargetKey(candidate))
+            : candidate.target.pluginId === route.pluginId);
+        if (candidates.length === 0 || candidates.some((candidate) => !candidate.eligible))
+            return;
+        props.controller.updatePageContext({ autoPreparedRestore: true });
+        beginReview({
+            kind: 'pluginWriteTask',
+            goal: 'restore',
+            targets: candidates.map((candidate) => candidate.target),
+            executionPolicy: 'all',
+        }, props.controller.pluginWriteTaskReturnRoute(route));
+    }, [
+        props.controller,
+        route.name,
+        route.name === 'pluginWriteTask' ? route.goal : '',
+        route.name === 'pluginWriteTask' ? route.pluginId : '',
+        route.name === 'pluginWriteTask' ? route.targetKeys?.join('\0') ?? '' : '',
+        snapshot.router.current.context.autoPreparedRestore,
+        snapshot.viewModel,
+    ]);
     const openBatchSelection = (action) => {
         props.controller.updatePageContext({
             focusIndex: focus,
@@ -1848,7 +1923,7 @@ export function ConsoleAppV4(props) {
             showSelected: false,
         });
         setDirty(true);
-        setFocus(0);
+        setFocus(1);
         setScrollOffset(0);
         setSearchFocus(false);
     };
@@ -1856,21 +1931,43 @@ export function ConsoleAppV4(props) {
         const mode = draft.mode;
         const all = props.controller.listPlugins({ mode });
         if (draft.showSelected) {
-            const selected = new Set(draft.selectedPluginIds);
-            return all.filter((candidate) => selected.has(candidate.pluginId));
+            const byId = new Map(all.map((candidate) => [candidate.pluginId, candidate]));
+            return draft.selectedPluginIds.map((pluginId) => ({
+                pluginId,
+                ...(byId.get(pluginId) ? { plugin: byId.get(pluginId) } : {}),
+            }));
         }
         return props.controller.listPlugins({
             mode,
             ...(draft.sourceId ? { sourceId: draft.sourceId } : {}),
             ...(draft.query ? { query: draft.query } : {}),
             installFilter: draft.installFilter,
+        }).map((plugin) => ({ pluginId: plugin.pluginId, plugin }));
+    };
+    const batchCandidateBlockReason = (draft, candidate) => !candidate.plugin
+        ? '插件已不在当前状态中，可取消选择'
+        : candidate.plugin.configOnly
+            ? '来源中没有可信插件定义'
+            : draft.mode === 'browse' && hasInstalledPlacement(candidate.plugin)
+                ? '这个插件已经添加'
+                : undefined;
+    const invalidBatchSelection = (draft) => {
+        const byId = new Map(props.controller.listPlugins({ mode: draft.mode })
+            .map((plugin) => [plugin.pluginId, plugin]));
+        return draft.selectedPluginIds.filter((pluginId) => batchCandidateBlockReason(draft, {
+            pluginId,
+            ...(byId.get(pluginId) ? { plugin: byId.get(pluginId) } : {}),
+        }) !== undefined);
+    };
+    const persistDependencyGraphContext = (graphRoute, projection, expandedPluginIds, focusIndex, offset) => {
+        const direction = graphRoute.direction ?? 'dependencies';
+        const actionIds = dependencyGraphActionIds(projection);
+        dependencyGraphContexts.current.set(dependencyGraphContextKey(graphRoute.pluginId, direction), {
+            expandedPluginIds: new Set(expandedPluginIds),
+            ...(actionIds[focusIndex] ? { focusedActionId: actionIds[focusIndex] } : {}),
+            ...(actionIds[offset] ? { scrollAnchorActionId: actionIds[offset] } : {}),
         });
     };
-    const batchCandidateBlockReason = (draft, candidate) => candidate.configOnly
-        ? '来源中没有可信插件定义'
-        : draft.mode === 'browse' && hasInstalledPlacement(candidate)
-            ? '这个插件已经添加'
-            : undefined;
     const toggleBatchPlugin = (pluginId) => {
         setBatchDraft((current) => current ? {
             ...current,
@@ -1879,15 +1976,24 @@ export function ConsoleAppV4(props) {
                 : [...current.selectedPluginIds, pluginId],
         } : current);
     };
-    const existingBatchTargets = (pluginIds) => pluginIds.flatMap((pluginId) => props.controller.getPluginOverview(pluginId)
-        ?.installedPlacements.flatMap((placement) => placement.state === 'installed'
-        ? [{ pluginId, platform: placement.platform, scope: placement.scope }]
-        : placement.state === 'scopeConflict'
-            ? placement.placements.map(({ scope: targetScope }) => ({
-                pluginId, platform: placement.platform, scope: targetScope,
-            }))
-            : []) ?? []);
+    const prepareCurrentProjectPlugins = () => {
+        if (props.controller.listCurrentProjectIntentRoots().length === 0) {
+            setActionError('当前项目没有已保存的插件清单。');
+            return;
+        }
+        beginReview({
+            kind: 'pluginWriteBatch',
+            action: 'sync',
+            selection: { kind: 'currentProjectIntentRoots' },
+            platform: 'both',
+            scope: 'project',
+        });
+    };
     const openSelectedPluginTask = (goal, pluginIds, scopeConstraint) => {
+        if (batchDraft && invalidBatchSelection(batchDraft).length > 0) {
+            setActionError('已选插件状态已变化。请返回选择页检查并取消失效项。');
+            return;
+        }
         const selected = new Set(pluginIds);
         const candidates = props.controller.listPluginWriteTaskCandidates(goal)
             .filter((candidate) => selected.has(candidate.target.pluginId)
@@ -1908,9 +2014,10 @@ export function ConsoleAppV4(props) {
                 batchOrigin: { flowId: batchDraft.flowId, owner: 'batch-write' },
             } : {}),
             ...(goal === 'update'
-                ? { versionEvidence: Object.fromEntries(candidates.flatMap((candidate) => candidate.target.expectedUpdate
-                        ? [[pluginWriteTaskTargetKey(candidate), candidate.target.expectedUpdate.activeVersion]]
-                        : [])) }
+                ? { versionEvidence: Object.assign({}, ...[...selected].map((pluginId) => {
+                        const candidatePlugin = props.controller.getPluginOverview(pluginId);
+                        return candidatePlugin ? pluginWriteTaskVersionEvidence(candidatePlugin, candidates.filter((candidate) => candidate.target.pluginId === pluginId)) : {};
+                    })) }
                 : {}),
         });
     };
@@ -2401,18 +2508,19 @@ export function ConsoleAppV4(props) {
     const openConfigLayerTarget = (layer) => {
         if (route.name !== 'configLayer')
             return;
-        const field = route.fieldKey && configPage
-            ? configPage.groups.flatMap((group) => group.fields).find((candidate) => candidate.key === route.fieldKey)
+        const definitionPage = configPage ?? configLayerPages.user ?? configLayerPages.project;
+        const field = route.fieldKey && definitionPage
+            ? definitionPage.groups.flatMap((group) => group.fields).find((candidate) => candidate.key === route.fieldKey)
             : undefined;
-        const fieldTarget = configPage ? configFieldTarget(configPage, route.fieldKey) : undefined;
-        const preset = route.presetId && configPage
-            ? configPage.presets.find((candidate) => candidate.id === route.presetId)
+        const fieldTarget = definitionPage ? configFieldTarget(definitionPage, route.fieldKey) : undefined;
+        const preset = route.presetId && definitionPage
+            ? definitionPage.presets.find((candidate) => candidate.id === route.presetId)
             : undefined;
         const presetTarget = preset
-            ? configFieldTarget(configPage, Object.keys(preset.values)[0])
+            ? configFieldTarget(definitionPage, Object.keys(preset.values)[0])
             : undefined;
         const target = fieldTarget ?? (route.groupId ? { groupId: route.groupId, focusIndex: 0 } : undefined) ?? presetTarget
-            ?? (configPage?.groups[0] ? { groupId: configPage.groups[0].id, focusIndex: 0 } : undefined);
+            ?? (definitionPage?.groups[0] ? { groupId: definitionPage.groups[0].id, focusIndex: 0 } : undefined);
         const context = target
             ? { configGroupId: target.groupId, focusIndex: target.focusIndex, scrollOffset: 0 }
             : {};
@@ -2703,7 +2811,7 @@ export function ConsoleAppV4(props) {
             ? '选择一个插件，或从列表前部选择多个。'
             : '先处理推荐任务，或查看一个插件。';
         context = `${items.length} 个插件`;
-        help = `↑↓ 移动 · Enter 查看 · m 批量${route.mode === 'installed' ? ' · a 项目全同步 · f 可更新' : ''} · ←→ 来源 · / 搜索${route.mode === 'browse' ? ' · f 未安装' : ''} · Esc 返回`;
+        help = `↑↓ 移动 · Enter 查看 · m 批量${route.mode === 'installed' ? ' · a 按项目清单准备 · f 可更新' : ''} · ←→ 来源 · / 搜索${route.mode === 'browse' ? ' · f 未安装' : ''} · Esc 返回`;
         const sourceError = sourceId !== 'all'
             && props.controller.getSourceOverview(sourceId).health?.state === 'unavailable';
         actions = sourceError
@@ -2716,6 +2824,7 @@ export function ConsoleAppV4(props) {
                 .map((candidate) => candidate.target.pluginId))];
         const projectRestoreCandidates = props.controller.listPluginWriteTaskCandidates('restore')
             .filter((candidate) => candidate.target.scope === 'project');
+        const projectIntentRoots = props.controller.listCurrentProjectIntentRoots();
         const menuRows = sourceError || items.length === 0 || query ? [] : [
             ...(route.mode === 'installed' && recommendedUpdatePluginIds.length > 0 ? [{
                     pluginId: '@menu:update',
@@ -2727,11 +2836,21 @@ export function ConsoleAppV4(props) {
                     status: 'warning',
                     menuAction: () => openSelectedPluginTask('update', recommendedUpdatePluginIds),
                 }] : []),
-            ...(route.mode === 'installed' && projectRestoreCandidates.length > 0 ? [{
+            ...(route.mode === 'installed' && projectIntentRoots.length > 0 ? [{
                     pluginId: '@menu:restore-project',
-                    name: '恢复本项目…',
+                    name: '按项目清单准备…',
+                    sourceLabel: '',
+                    description: `${projectIntentRoots.length} 个已保存根插件；允许补齐当前项目缺少的安装`,
+                    placementSummary: '',
+                    statusLabel: '项目',
+                    status: 'info',
+                    menuAction: prepareCurrentProjectPlugins,
+                }] : []),
+            ...(route.mode === 'installed' && projectRestoreCandidates.length > 0 ? [{
+                    pluginId: '@menu:repair-project',
+                    name: '修复本项目异常…',
                     sourceLabel: '',
-                    description: '只处理当前项目已保存且需要恢复的插件位置',
+                    description: '严格按已确认的现有版本修复异常，不改变插件版本',
                     placementSummary: '',
                     statusLabel: '推荐',
                     status: 'warning',
@@ -2839,18 +2958,19 @@ export function ConsoleAppV4(props) {
             const hiddenSelected = batchDraft.selectedPluginIds.filter((pluginId) => !currentIds.has(pluginId)).length;
             const candidateActions = candidates.map((candidate) => {
                 const blockReason = batchCandidateBlockReason(batchDraft, candidate);
+                const isSelected = selected.has(candidate.pluginId);
                 return {
-                    label: candidate.displayName,
+                    label: candidate.plugin?.displayName ?? `${candidate.pluginId}（已不可用，可取消选择）`,
                     description: blockReason
-                        ? `${candidate.sourceLabel} · 不可选择：${blockReason}`
-                        : `${candidate.sourceLabel} · ${pluginPlacementSummary(candidate)}`,
-                    selected: selected.has(candidate.pluginId),
+                        ? `${candidate.plugin?.sourceLabel ?? '状态已失效'} · ${isSelected ? '可取消选择' : '不可选择'}：${blockReason}`
+                        : `${candidate.plugin.sourceLabel} · ${pluginPlacementSummary(candidate.plugin)}`,
+                    selected: isSelected,
                     pluginId: candidate.pluginId,
-                    selectable: blockReason === undefined,
+                    canSelectNew: blockReason === undefined,
                     status: blockReason ? 'muted' : undefined,
-                    run: () => go(batchDraft.mode === 'browse'
+                    run: candidate.plugin ? () => go(batchDraft.mode === 'browse'
                         ? { name: 'pluginPreview', pluginId: candidate.pluginId }
-                        : { name: 'pluginDetail', pluginId: candidate.pluginId }),
+                        : { name: 'pluginDetail', pluginId: candidate.pluginId }) : undefined,
                 };
             });
             const selectableIds = candidates
@@ -2861,6 +2981,11 @@ export function ConsoleAppV4(props) {
                     setActionError('请至少选择一个插件。');
                     return;
                 }
+                const invalid = invalidBatchSelection(batchDraft);
+                if (invalid.length > 0) {
+                    setActionError(`${invalid.length} 个已选插件已不可用。请先在“查看全部已选”中取消选择。`);
+                    return;
+                }
                 if (batchDraft.mode === 'browse') {
                     setBatchDraft((current) => current ? { ...current, action: 'install' } : current);
                     props.controller.push({ name: 'batchPlacement' });
@@ -2871,16 +2996,20 @@ export function ConsoleAppV4(props) {
                 setFocus(0);
                 setScrollOffset(0);
             };
+            const continueAction = {
+                label: `查看确认（${batchDraft.selectedPluginIds.length}）`,
+                description: batchDraft.selectedPluginIds.length > 0 ? '继续选择任务和确认范围' : '先选择至少一个插件',
+                run: continueSelection,
+            };
             const utilityActions = [
-                {
-                    label: `查看确认（${batchDraft.selectedPluginIds.length}）`,
-                    description: batchDraft.selectedPluginIds.length > 0 ? '继续选择任务和确认范围' : '先选择至少一个插件',
-                    run: continueSelection,
-                },
                 {
                     label: batchDraft.showSelected ? '返回当前结果' : `查看全部已选（${batchDraft.selectedPluginIds.length}）`,
                     description: hiddenSelected > 0 ? `${hiddenSelected} 个选择在其他筛选中` : '完整 canonical 选择集合',
-                    run: () => setBatchDraft((current) => current ? { ...current, showSelected: !current.showSelected } : current),
+                    run: () => {
+                        setBatchDraft((current) => current ? { ...current, showSelected: !current.showSelected } : current);
+                        setFocus(0);
+                        setScrollOffset(0);
+                    },
                 },
                 {
                     label: '全选当前结果',
@@ -2903,13 +3032,19 @@ export function ConsoleAppV4(props) {
                     run: () => setBatchDraft((current) => current ? { ...current, selectedPluginIds: [] } : current),
                 },
             ];
-            actions = [...candidateActions, ...utilityActions];
+            actions = [continueAction, ...candidateActions, ...utilityActions];
+            const batchFocus = Math.min(focus, actions.length - 1);
             context = `已选 ${batchDraft.selectedPluginIds.length} 个 · 显示 ${candidates.length} 个${hiddenSelected > 0 ? ` · 隐藏 ${hiddenSelected} 个` : ''}`;
             help = '↑↓ 移动 · Space 选择 · Enter 查看/操作 · c 查看确认 · ←→ 来源 · / 搜索 · Esc 放弃';
-            const viewport = actionViewport(actions, policy.mode === 'compact', focus, scrollOffset, pageActionBudget(3));
+            const scrollActions = [...candidateActions, ...utilityActions];
+            const viewport = actionViewport(scrollActions, policy.mode === 'compact', Math.max(0, batchFocus - 1), Math.max(0, scrollOffset - 1), Math.max(1, pageActionBudget(5)));
+            const focusedCandidate = batchFocus > 0 && batchFocus <= candidateActions.length
+                ? candidates[batchFocus - 1]?.plugin : undefined;
             content = _jsxs(Box, { flexDirection: "column", children: [_jsx(SourceTabs, { controller: props.controller, current: batchDraft.showSelected ? 'all' : batchDraft.sourceId ?? 'all', compact: policy.mode === 'compact', columns: size.columns - 2, mode: batchDraft.mode, query: batchDraft.showSelected ? undefined : batchDraft.query || undefined, installFilter: batchDraft.showSelected ? 'all' : batchDraft.installFilter }), _jsxs(Text, { color: searchFocus ? tuiTheme.colors.accent : tuiTheme.colors.muted, children: ["\u641C\u7D22  / ", searchFocus
                                 ? _jsx(InputDisplay, { value: batchDraft.query, placeholder: "\u8F93\u5165\u641C\u7D22\u5185\u5BB9", columns: Math.max(8, size.columns - 14) })
-                                : _jsxs(_Fragment, { children: [batchDraft.query || '搜索名称、用途或来源…', batchDraft.query ? '    / 编辑' : ''] })] }), _jsx(SemanticRows, { actions: actions, focus: focus, kind: "toggle", compact: policy.mode === 'compact', offset: viewport.offset, limit: viewport.limit })] });
+                                : _jsxs(_Fragment, { children: [batchDraft.query || '搜索名称、用途或来源…', batchDraft.query ? '    / 编辑' : ''] })] }), _jsx(SemanticRows, { actions: [continueAction], focus: batchFocus, kind: "action", compact: true }), focusedCandidate
+                        ? _jsx(StaticRow, { title: `用途 · ${focusedCandidate.description}`, status: "info", compact: true })
+                        : null, _jsx(SemanticRows, { actions: scrollActions, focus: batchFocus - 1, kind: "toggle", compact: policy.mode === 'compact', offset: viewport.offset, limit: viewport.limit })] });
         }
         else {
             const selectedIds = batchDraft.selectedPluginIds;
@@ -2918,8 +3053,12 @@ export function ConsoleAppV4(props) {
                 return props.controller.listPluginWriteTaskCandidates(goal)
                     .filter((candidate) => selected.has(candidate.target.pluginId));
             };
-            const exactTargets = existingBatchTargets(selectedIds);
             const startExistingBatch = (action) => {
+                if (invalidBatchSelection(batchDraft).length > 0) {
+                    setActionError('已选插件状态已变化。请返回选择页检查并取消失效项。');
+                    return;
+                }
+                const exactTargets = props.controller.listPluginWriteBatchTargets(action, selectedIds);
                 if (exactTargets.length === 0) {
                     setActionError('所选插件没有可用的已有安装位置。');
                     return;
@@ -2931,11 +3070,13 @@ export function ConsoleAppV4(props) {
                     scope: exactTargets[0].scope,
                 });
             };
+            const syncTargets = props.controller.listPluginWriteBatchTargets('sync', selectedIds);
+            const uninstallTargets = props.controller.listPluginWriteBatchTargets('uninstall', selectedIds);
             if (batchDraft.stage === 'maintenance') {
                 actions = [
-                    { label: '同步已保存使用设置…', description: '重新应用所选已有位置', run: () => startExistingBatch('sync') },
-                    { label: '重新安装…', description: '重新生成所选已有位置的安装内容', run: () => startExistingBatch('reinstall') },
-                    { label: '清理遗留内容…', description: '普通清理；保留 foreign 和 shared 内容', run: () => startExistingBatch('cleanup') },
+                    { label: '同步已保存使用设置…', description: `重新应用 ${syncTargets.length} 个已保存或现场目标`, run: () => startExistingBatch('sync') },
+                    { label: '重新安装…', description: `重新生成 ${props.controller.listPluginWriteBatchTargets('reinstall', selectedIds).length} 个已保存或现场目标`, run: () => startExistingBatch('reinstall') },
+                    { label: '清理遗留内容…', description: `${props.controller.listPluginWriteBatchTargets('cleanup', selectedIds).length} 个有受管证据的位置；保留 foreign 和 shared 内容`, run: () => startExistingBatch('cleanup') },
                     {
                         label: '返回任务选择',
                         run: () => {
@@ -2964,7 +3105,7 @@ export function ConsoleAppV4(props) {
                             status: 'warning',
                             run: () => openSelectedPluginTask('restore', selectedIds),
                         }] : []),
-                    { label: '移除所选插件…', description: `${exactTargets.length} 个已有位置；保留设置`, status: 'error', run: () => startExistingBatch('uninstall') },
+                    { label: '移除所选插件…', description: `${uninstallTargets.length} 个现场目标；执行前检查所有权；保留设置`, status: 'error', run: () => startExistingBatch('uninstall') },
                     {
                         label: '其他维护方式…',
                         description: '同步、重新安装和普通清理',
@@ -2977,7 +3118,7 @@ export function ConsoleAppV4(props) {
                     { label: '返回调整选择', run: () => setBatchDraft((current) => current ? { ...current, stage: 'select' } : current) },
                 ];
             }
-            context = `${selectedIds.length} 个插件 · ${exactTargets.length} 个已有位置`;
+            context = `${selectedIds.length} 个插件 · ${syncTargets.length} 个已保存或现场目标`;
             help = '↑↓ 移动 · Enter 选择 · Esc 返回修改';
             const viewport = actionViewport(actions, policy.mode === 'compact', focus, scrollOffset, pageActionBudget(1));
             content = _jsx(SemanticRows, { actions: actions, focus: focus, kind: "task", compact: policy.mode === 'compact', offset: viewport.offset, limit: viewport.limit });
@@ -3015,6 +3156,10 @@ export function ConsoleAppV4(props) {
                     disabled: batchDraft.selection === 'selected' && batchDraft.selectedPluginIds.length === 0
                         ? '请至少选择一个插件' : undefined,
                     run: () => {
+                        if (invalidBatchSelection(batchDraft).length > 0) {
+                            setActionError('已选插件状态已变化。请返回选择页检查并取消失效项。');
+                            return;
+                        }
                         const intent = {
                             kind: 'pluginWriteBatch',
                             action: batchDraft.action,
@@ -3386,24 +3531,51 @@ export function ConsoleAppV4(props) {
                         : row.depth === 0 ? '当前插件' : undefined,
                     meta: state.value,
                     status: state.status,
-                    run: () => go({
-                        name: 'pluginDependencyNode',
-                        pluginId: plugin.pluginId,
-                        nodePluginId: row.pluginId,
-                        direction,
-                    }),
+                    run: () => {
+                        persistDependencyGraphContext(route, projection, expandedDependencyPluginIds ?? new Set(projection.defaultExpandedPluginIds), focus, scrollOffset);
+                        go({
+                            name: 'pluginDependencyNode',
+                            pluginId: plugin.pluginId,
+                            nodePluginId: row.pluginId,
+                            direction,
+                        });
+                    },
                 };
             });
+            const unverifiedConsumerActions = direction === 'dependents'
+                ? projection.scopeSummary.unknownConsumerPluginIds.map((pluginId) => {
+                    const declared = overview?.dependents.find((entry) => entry.pluginId === pluginId);
+                    return {
+                        label: `未验证声明者 · ${declared?.displayName ?? pluginId}`,
+                        description: '目录声明它依赖当前插件，但当前没有实际引用证据',
+                        meta: declared?.aggregateStatus === 'notInstalled' ? '未安装' : '未验证',
+                        status: 'muted',
+                        run: () => {
+                            persistDependencyGraphContext(route, projection, expandedDependencyPluginIds ?? new Set(projection.defaultExpandedPluginIds), focus, scrollOffset);
+                            go({
+                                name: 'pluginDependencyNode',
+                                pluginId: plugin.pluginId,
+                                nodePluginId: pluginId,
+                                direction,
+                            });
+                        },
+                    };
+                })
+                : [];
             actions = [
                 ...rowActions,
+                ...unverifiedConsumerActions,
                 {
                     label: direction === 'dependencies' ? '切换到“谁在使用它”' : '切换到“它需要的”',
                     description: '切换关系方向',
-                    run: () => props.controller.replace({
-                        name: 'pluginDependencies',
-                        pluginId: plugin.pluginId,
-                        direction: direction === 'dependencies' ? 'dependents' : 'dependencies',
-                    }),
+                    run: () => {
+                        persistDependencyGraphContext(route, projection, expandedDependencyPluginIds ?? new Set(projection.defaultExpandedPluginIds), focus, scrollOffset);
+                        props.controller.replace({
+                            name: 'pluginDependencies',
+                            pluginId: plugin.pluginId,
+                            direction: direction === 'dependencies' ? 'dependents' : 'dependencies',
+                        });
+                    },
                 },
                 { label: showTechnical ? '隐藏检查详情' : '查看检查详情', run: () => toggleTechnical() },
             ];
@@ -3413,7 +3585,9 @@ export function ConsoleAppV4(props) {
             const relationViewport = actionViewport(actions, policy.mode === 'compact', focus, scrollOffset, showTechnical ? responsiveBudget(3, 6) : responsiveBudget(7, 11));
             help = '↑↓ 选择 · → 展开 · ← 收起 · Enter 节点详情 · Esc 返回';
             content = _jsxs(Box, { flexDirection: "column", children: [_jsx(StaticRow, { title: `当前检查范围 · ${scopeText}`, status: "muted", compact: true }), projection.status.state === 'invalid'
-                        ? _jsx(Callout, { status: "error", title: "\u4F9D\u8D56\u5173\u7CFB\u65E0\u6548", description: projection.status.message }) : null, _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true, offset: relationViewport.offset, limit: relationViewport.limit }), showTechnical ? _jsxs(TechnicalDetails, { children: [_jsx(StaticRow, { title: `${dependencyCount} 个依赖 · ${dependentCount} 个实际使用者`, meta: plugin.pluginId, compact: true }), _jsx(StaticRow, { title: `未知引用 · ${projection.scopeSummary.unknownConsumerPluginIds.length} 个`, compact: true })] }) : null] });
+                        ? _jsx(Callout, { status: "error", title: "\u4F9D\u8D56\u5173\u7CFB\u65E0\u6548", description: projection.status.message }) : null, unverifiedConsumerActions.length > 0
+                        ? _jsx(StaticRow, { title: `未验证声明者 · ${unverifiedConsumerActions.length} 个`, description: "\u4EE5\u4E0B\u58F0\u660E\u8005\u4E0D\u8BA1\u5165\u5B9E\u9645\u4F7F\u7528\u8005", status: "muted", compact: true })
+                        : null, _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true, offset: relationViewport.offset, limit: relationViewport.limit }), showTechnical ? _jsxs(TechnicalDetails, { children: [_jsx(StaticRow, { title: `${dependencyCount} 个依赖 · ${projection.scopeSummary.actualConsumerPluginIds.length} 个实际使用者`, meta: plugin.pluginId, compact: true }), _jsx(StaticRow, { title: `未验证声明者 · ${projection.scopeSummary.unknownConsumerPluginIds.length} 个`, compact: true })] }) : null] });
         }
     }
     else if (route.name === 'pluginDependencyNode' && plugin) {
@@ -3423,6 +3597,8 @@ export function ConsoleAppV4(props) {
             : route.direction === 'dependencies'
                 ? overview?.dependencies.find((entry) => entry.pluginId === route.nodePluginId)
                 : overview?.dependents.find((entry) => entry.pluginId === route.nodePluginId);
+        const verifiedDependent = route.direction !== 'dependents'
+            || (item?.placementReferences?.length ?? 0) > 0;
         const state = item ? dependencyStatus(item) : undefined;
         breadcrumb = `${plugin.displayName} / 依赖关系 / ${node?.displayName ?? route.nodePluginId}`;
         context = route.direction === 'dependencies' ? '它需要的' : '谁在使用它';
@@ -3431,7 +3607,9 @@ export function ConsoleAppV4(props) {
             ? '这是当前关系图的根插件。'
             : route.direction === 'dependencies'
                 ? `${item?.requiredBy.map((entry) => entry.displayName).join('、') || plugin.displayName} 需要这个插件。`
-                : `${node?.displayName ?? route.nodePluginId} 的已安装位置实际引用当前插件。`;
+                : verifiedDependent
+                    ? `${node?.displayName ?? route.nodePluginId} 的已安装位置实际引用当前插件。`
+                    : `${item?.displayName ?? route.nodePluginId} 声明依赖当前插件，但当前没有实际引用证据。`;
         actions = [
             ...(route.nodePluginId !== plugin.pluginId ? [{
                     label: '以此节点查看关系',
@@ -3631,7 +3809,10 @@ export function ConsoleAppV4(props) {
     }
     else if (route.name === 'pluginWriteTask' && plugin) {
         const retainedTargetKeys = route.targetKeys ? new Set(route.targetKeys) : undefined;
-        const candidates = props.controller.listPluginWriteTaskCandidates(route.goal)
+        const allTaskCandidates = props.controller.listPluginWriteTaskCandidates(route.goal);
+        const currentTargetKeys = new Set(allTaskCandidates.map(pluginWriteTaskTargetKey));
+        const missingTargetKeys = route.targetKeys?.filter((targetKey) => !currentTargetKeys.has(targetKey)) ?? [];
+        const candidates = allTaskCandidates
             .filter((candidate) => retainedTargetKeys
             ? retainedTargetKeys.has(pluginWriteTaskTargetKey(candidate))
             : candidate.target.pluginId === route.pluginId);
@@ -3648,14 +3829,134 @@ export function ConsoleAppV4(props) {
         const activationSources = [...new Set(blockedCandidates
                 .filter((candidate) => candidate.blockReason === 'catalogActivationRequired')
                 .map((candidate) => candidate.sourceId))];
+        const taskIssues = new Map(props.controller.listUserIssues().map((issue) => [issue.issueId, issue]));
+        const recoveryActions = [...new Map(blockedCandidates.flatMap((candidate) => {
+                if (candidate.blockReason === 'catalogActivationRequired')
+                    return [];
+                const target = candidate.target;
+                const targetLabel = `${candidate.displayName} · ${platformLabel(target.platform)} · ${scopeLabel(target.scope)}`;
+                const linkedIssue = candidate.issueIds.map((issueId) => taskIssues.get(issueId)).find(Boolean);
+                const sourceIssue = linkedIssue && (linkedIssue.group === 'sourceRemoved'
+                    || linkedIssue.group === 'sourceUnavailable')
+                    ? linkedIssue
+                    : [...taskIssues.values()].find((entry) => (entry.category === 'sourceUnavailable' || entry.category === 'sourceMissing'
+                        || entry.category === 'sourceIdentityChanged')
+                        && (entry.sourceId === candidate.sourceId || entry.pluginId === target.pluginId));
+                const issue = linkedIssue ?? sourceIssue;
+                const candidatePlugin = props.controller.getPluginOverview(target.pluginId);
+                const configField = issue?.requiredFields?.[0];
+                if (issue?.group === 'config' || configField) {
+                    const fieldKey = configField?.key;
+                    return [[`config:${target.pluginId}:${fieldKey ?? ''}`, {
+                                label: fieldKey ? `完成设置：${configField?.title ?? fieldKey}` : `检查 ${candidate.displayName} 的设置`,
+                                description: `${targetLabel}；保存后返回任务重新读取当前证据`,
+                                status: 'warning',
+                                run: () => {
+                                    beginConfigFlow(target.pluginId);
+                                    props.controller.replace({
+                                        name: 'configLayer',
+                                        pluginId: target.pluginId,
+                                        ...(fieldKey ? { fieldKey } : {}),
+                                    });
+                                },
+                            }]];
+                }
+                if (candidate.blockReason === 'restoreVersionChanged') {
+                    const updateCandidates = props.controller.listPluginWriteTaskCandidates('update')
+                        .filter((entry) => pluginWriteTaskTargetKey(entry) === pluginWriteTaskTargetKey(candidate));
+                    const updatePlugin = props.controller.getPluginOverview(target.pluginId);
+                    if (updateCandidates.length > 0 && updatePlugin) {
+                        return [[`update:${pluginWriteTaskTargetKey(candidate)}`, {
+                                    label: `更新并恢复 ${targetLabel}…`,
+                                    description: '改用当前候选版本建立新任务；进入 Review 前仍会重新检查证据',
+                                    status: 'warning',
+                                    run: () => props.controller.beginNestedPluginWriteTask({
+                                        name: 'pluginWriteTask',
+                                        pluginId: target.pluginId,
+                                        goal: 'update',
+                                        targetKeys: updateCandidates.map(pluginWriteTaskTargetKey),
+                                        ...(route.batchOrigin ? { batchOrigin: route.batchOrigin } : {}),
+                                        versionEvidence: pluginWriteTaskVersionEvidence(updatePlugin, updateCandidates),
+                                    }),
+                                }]];
+                    }
+                }
+                if (sourceIssue || candidatePlugin?.sourceUnavailable) {
+                    const sourceId = sourceIssue?.sourceId ?? candidate.sourceId;
+                    const sourceNeedsIssue = sourceIssue?.category === 'sourceMissing'
+                        || sourceIssue?.category === 'sourceIdentityChanged'
+                        || sourceIssue?.group === 'sourceRemoved';
+                    if (sourceNeedsIssue && sourceIssue) {
+                        return [[`source-issue:${sourceIssue.issueId}`, {
+                                    label: sourceIssue.category === 'sourceMissing'
+                                        ? `重新添加来源 ${sourceId}` : `核对来源身份 ${sourceId}`,
+                                    description: `${targetLabel}；先查看来源问题的安全恢复选择`,
+                                    status: 'warning',
+                                    run: () => go({ name: 'issueDetail', issueId: sourceIssue.issueId }),
+                                }]];
+                    }
+                    return [[`source:${sourceId}`, {
+                                label: `核对来源 ${sourceId}`,
+                                description: `${targetLabel}；修复或重新检查后返回任务`,
+                                status: 'warning',
+                                run: () => go({ name: 'sourceDetail', sourceId }),
+                            }]];
+                }
+                if (candidate.blockReason === 'restoreVersionUnverified'
+                    || candidate.blockReason === 'updateEvidenceIncomplete') {
+                    return [
+                        [`reload:${pluginWriteTaskTargetKey(candidate)}`, {
+                                label: `重新检查 ${targetLabel}`,
+                                description: '重新读取安装、版本、来源和受管内容证据',
+                                run: async () => {
+                                    await props.controller.load();
+                                    setFocus(0);
+                                    setScrollOffset(0);
+                                },
+                            }],
+                        [`diagnostic:${pluginWriteTaskTargetKey(candidate)}`, {
+                                label: `查看 ${targetLabel} 的诊断`,
+                                description: '版本仍无法确认时查看组件状态和安全恢复方向',
+                                run: () => go({ name: 'pluginTechnical', pluginId: target.pluginId }),
+                            }],
+                    ];
+                }
+                if (issue) {
+                    return [[`issue:${issue.issueId}`, {
+                                label: `处理问题：${issue.title}`,
+                                description: `${targetLabel}；只提供该问题允许的恢复动作`,
+                                status: 'warning',
+                                run: () => go({ name: 'issueDetail', issueId: issue.issueId }),
+                            }]];
+                }
+                if (candidate.blockReason === 'targetUnavailable'
+                    || candidate.blockReason === 'manualRecoveryRequired'
+                    || candidate.blockReason === 'taskActionConflict') {
+                    return [[`maintenance:${pluginWriteTaskTargetKey(candidate)}`, {
+                                label: `维护 ${targetLabel}`,
+                                description: '检查这个精确平台位置可用的安全维护动作',
+                                status: 'warning',
+                                run: () => go({ name: 'platform', pluginId: target.pluginId, platform: target.platform }),
+                            }]];
+                }
+                return [[`diagnostic:${target.pluginId}`, {
+                            label: `查看 ${candidate.displayName} 的诊断`,
+                            description: `${pluginWriteTaskBlockLabel(candidate.blockReason)}；当前没有可安全自动执行的动作`,
+                            run: () => go({ name: 'pluginTechnical', pluginId: target.pluginId }),
+                        }]];
+            })).values()];
         const taskLabel = pluginWriteTaskLabel(route.goal);
         const startTaskReview = (executionPolicy) => {
+            if (missingTargetKeys.length > 0) {
+                setActionError(`${missingTargetKeys.length} 个冻结位置已失效或无需处理。请返回调整后重新开始。`);
+                return;
+            }
             props.controller.startPluginWriteTaskReview({
                 kind: 'pluginWriteTask',
                 goal: route.goal,
                 targets: candidates.map((candidate) => candidate.target),
                 executionPolicy,
-            }, route);
+            }, props.controller.pluginWriteTaskReturnRoute(route));
             setFocus(0);
             setScrollOffset(0);
         };
@@ -3673,13 +3974,15 @@ export function ConsoleAppV4(props) {
             ? 'PgUp/PgDn 查看全部位置 · ↑↓ 移动 · Enter 选择 · Esc 返回'
             : '↑↓ 移动 · Enter 选择 · Esc 返回';
         actions = [
-            ...(!versionEvidenceChanged && blockedCandidates.length === 0 && executable.length > 0 ? [{
+            ...(missingTargetKeys.length === 0 && !versionEvidenceChanged
+                && blockedCandidates.length === 0 && executable.length > 0 ? [{
                     label: `确认${taskLabel} ${executable.length} 个位置…`,
                     description: '进入统一影响确认；执行前再次检查当前证据',
                     status: 'success',
                     run: () => startTaskReview('all'),
                 }] : []),
-            ...(!versionEvidenceChanged && blockedCandidates.length > 0 && executable.length > 0 ? [{
+            ...(missingTargetKeys.length === 0 && !versionEvidenceChanged
+                && blockedCandidates.length > 0 && executable.length > 0 ? [{
                     label: `先处理可执行的 ${executable.length} 个位置…`,
                     description: `${blockedCandidates.length} 个受阻位置保留，不会无声跳过`,
                     status: 'warning',
@@ -3691,6 +3994,7 @@ export function ConsoleAppV4(props) {
                 status: 'warning',
                 run: () => beginReview({ kind: 'catalogGeneration', action: 'update', sourceId }),
             })),
+            ...recoveryActions,
             ...(versionEvidenceChanged ? [{
                     label: '使用当前版本重新准备…',
                     description: '来源启用后的插件版本与先前候选不同；先明确采用当前版本',
@@ -3719,7 +4023,9 @@ export function ConsoleAppV4(props) {
         const taskViewport = actionViewport(actions, policy.mode === 'compact', focus, scrollOffset, pageActionBudget(Math.min(candidates.length, policy.mode === 'compact' ? 3 : 6) + 2));
         content = _jsxs(Box, { flexDirection: "column", children: [_jsxs(SectionCard, { title: "\u5904\u7406\u8303\u56F4", meta: `${executable.length} 个可执行 · ${blockedCandidates.length} 个需决定`, compact: policy.mode === 'compact', children: [taskTargetOffset > 0 ? _jsx(StaticRow, { title: `↑ 前面还有 ${taskTargetOffset} 个位置`, status: "muted", compact: true }) : null, targetRows.length > 0 ? targetRows
                             : _jsx(StaticRow, { title: "\u5F53\u524D\u6CA1\u6709\u53EF\u6267\u884C\u76EE\u6807", status: "muted", compact: true }), candidates.length > taskTargetOffset + targetRows.length
-                            ? _jsx(StaticRow, { title: `↓ 后面还有 ${candidates.length - taskTargetOffset - targetRows.length} 个位置`, status: "muted", compact: true }) : null] }), blockedCandidates.length > 0 ? _jsx(Callout, { status: "warning", title: `${blockedCandidates.length} 个位置需要先处理或决定`, description: "\u53EA\u6709\u9009\u62E9\u201C\u5148\u5904\u7406\u53EF\u6267\u884C\u9879\u201D\u624D\u4F1A\u5EFA\u7ACB\u5B50\u96C6 Review\u3002", compact: policy.mode === 'compact' }) : null, versionEvidenceChanged ? _jsx(Callout, { status: "warning", title: "\u63D2\u4EF6\u76EE\u6807\u7248\u672C\u5DF2\u53D8\u5316", description: "\u4E0D\u4F1A\u6CBF\u7528\u6765\u6E90\u542F\u7528\u524D\u7684\u7248\u672C\u8BC1\u636E\uFF0C\u4E5F\u4E0D\u4F1A\u81EA\u52A8\u6267\u884C\u65B0\u7248\u672C\u3002", compact: policy.mode === 'compact' }) : null, _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true, offset: taskViewport.offset, limit: taskViewport.limit })] });
+                            ? _jsx(StaticRow, { title: `↓ 后面还有 ${candidates.length - taskTargetOffset - targetRows.length} 个位置`, status: "muted", compact: true }) : null] }), blockedCandidates.length > 0 ? _jsx(Callout, { status: "warning", title: `${blockedCandidates.length} 个位置需要先处理或决定`, description: executable.length > 0
+                        ? '可以先处理可执行项，或进入下方对应入口处理受阻位置。'
+                        : '请进入下方对应入口处理；返回后会重新读取当前证据。', compact: policy.mode === 'compact' }) : null, missingTargetKeys.length > 0 ? _jsx(Callout, { status: "warning", title: `${missingTargetKeys.length} 个冻结位置已失效或无需处理`, description: "\u4E0D\u4F1A\u628A\u8FD9\u4E9B\u4F4D\u7F6E\u5F53\u4F5C\u5DF2\u5B8C\u6210\uFF0C\u4E5F\u4E0D\u4F1A\u81EA\u52A8\u7F29\u5C0F\u672C\u6B21\u8303\u56F4\u3002\u8BF7\u8FD4\u56DE\u8C03\u6574\u9009\u62E9\u540E\u91CD\u65B0\u5F00\u59CB\u3002", compact: policy.mode === 'compact' }) : null, versionEvidenceChanged ? _jsx(Callout, { status: "warning", title: "\u63D2\u4EF6\u76EE\u6807\u7248\u672C\u5DF2\u53D8\u5316", description: "\u4E0D\u4F1A\u6CBF\u7528\u6765\u6E90\u542F\u7528\u524D\u7684\u7248\u672C\u8BC1\u636E\uFF0C\u4E5F\u4E0D\u4F1A\u81EA\u52A8\u6267\u884C\u65B0\u7248\u672C\u3002", compact: policy.mode === 'compact' }) : null, _jsx(SemanticRows, { actions: actions, focus: focus, kind: "action", compact: true, offset: taskViewport.offset, limit: taskViewport.limit })] });
     }
     else if (route.name === 'pluginDetail' && plugin) {
         breadcrumb = `我的插件 / ${plugin.displayName}`;
@@ -4158,11 +4464,12 @@ export function ConsoleAppV4(props) {
     }
     else if (route.name === 'configLayer' && plugin) {
         breadcrumb = `${plugin.displayName} / 设置`;
-        const selectedField = route.fieldKey && configPage
-            ? configPage.groups.flatMap((group) => group.fields).find((field) => field.key === route.fieldKey)
+        const configLayerDefinitionPage = configPage ?? configLayerPages.user ?? configLayerPages.project;
+        const selectedField = route.fieldKey && configLayerDefinitionPage
+            ? configLayerDefinitionPage.groups.flatMap((group) => group.fields).find((field) => field.key === route.fieldKey)
             : undefined;
-        const selectedPreset = route.presetId && configPage
-            ? configPage.presets.find((preset) => preset.id === route.presetId)
+        const selectedPreset = route.presetId && configLayerDefinitionPage
+            ? configLayerDefinitionPage.presets.find((preset) => preset.id === route.presetId)
             : undefined;
         title = selectedField ? `修改“${selectedField.title}”`
             : selectedPreset ? `应用“${selectedPreset.title}”` : `修改 ${plugin.displayName} 设置`;
@@ -4177,8 +4484,8 @@ export function ConsoleAppV4(props) {
                     return true;
                 if (selectedField)
                     return !selectedField.sensitive && !selectedField.sharedNativeRender;
-                if (selectedPreset && configPage) {
-                    const effectiveFields = configPage.groups.flatMap((group) => group.fields);
+                if (selectedPreset && configLayerDefinitionPage) {
+                    const effectiveFields = configLayerDefinitionPage.groups.flatMap((group) => group.fields);
                     return Object.keys(selectedPreset.values).some((key) => {
                         const field = effectiveFields.find((candidate) => candidate.key === key);
                         return Boolean(field && !field.sensitive && !field.sharedNativeRender);
@@ -6083,21 +6390,36 @@ export function ConsoleAppV4(props) {
         const taskOperation = operationKind === 'pluginWriteTask';
         const taskSummary = resultSummary?.task;
         const taskBlockedCount = taskSummary?.blockedTargets.length ?? 0;
-        const taskBatchOrigin = 'returnRoute' in result
+        const frozenTaskReturnRoute = 'returnRoute' in result
             && result.returnRoute?.name === 'pluginWriteTask'
-            ? result.returnRoute.batchOrigin : undefined;
-        const taskReturnRoute = taskSummary?.requestedTargets[0] ? {
-            name: 'pluginWriteTask',
-            pluginId: taskSummary.requestedTargets[0].pluginId,
-            goal: taskSummary.goal,
-            targetKeys: taskSummary.requestedTargets.map((target) => [target.pluginId, target.platform, target.scope].join('\0')),
-            ...(taskBatchOrigin ? { batchOrigin: taskBatchOrigin } : {}),
-            ...(taskSummary.goal === 'update' ? {
-                versionEvidence: Object.fromEntries(taskSummary.requestedTargets.flatMap((target) => target.expectedUpdate
-                    ? [[[target.pluginId, target.platform, target.scope].join('\0'), target.expectedUpdate.activeVersion]]
-                    : [])),
-            } : {}),
-        } : undefined;
+            ? result.returnRoute : undefined;
+        const nestedTaskReturn = frozenTaskReturnRoute !== undefined
+            && taskSummary !== undefined
+            && frozenTaskReturnRoute.goal !== taskSummary.goal;
+        const taskBatchOrigin = frozenTaskReturnRoute?.batchOrigin;
+        const remainingTaskTargets = taskSummary?.blockedTargets.map((entry) => entry.target) ?? [];
+        const taskReturnRoute = nestedTaskReturn
+            ? frozenTaskReturnRoute
+            : taskSummary && remainingTaskTargets[0] ? {
+                name: 'pluginWriteTask',
+                pluginId: remainingTaskTargets[0].pluginId,
+                goal: taskSummary.goal,
+                targetKeys: remainingTaskTargets.map((target) => [target.pluginId, target.platform, target.scope].join('\0')),
+                ...(taskBatchOrigin ? { batchOrigin: taskBatchOrigin } : {}),
+                ...(taskSummary.goal === 'update' ? {
+                    versionEvidence: 'returnRoute' in result
+                        && result.returnRoute?.name === 'pluginWriteTask'
+                        && result.returnRoute.versionEvidence
+                        ? result.returnRoute.versionEvidence
+                        : Object.fromEntries(remainingTaskTargets.flatMap((target) => target.expectedUpdate
+                            ? [[[target.pluginId, target.platform, target.scope].join('\0'), JSON.stringify({
+                                        version: target.expectedUpdate.activeVersion,
+                                        sourceIdentity: target.expectedUpdate.sourceIdentity,
+                                        binding: target.expectedUpdate.generationKey,
+                                    })]]
+                            : [])),
+                } : {}),
+            } : undefined;
         const batchOperation = operationKind === 'pluginWriteBatch';
         const portableOperation = operationKind === 'portableInstall';
         const portableReceipt = result.state === 'succeeded' || result.state === 'partial'
@@ -6319,6 +6641,12 @@ export function ConsoleAppV4(props) {
             ]
             : taskOperation
                 ? [
+                    ...(nestedTaskReturn && taskReturnRoute ? [{
+                            label: '返回剩余恢复任务',
+                            description: '保留父任务的冻结目标；返回后重新读取当前证据',
+                            status: 'success',
+                            run: () => leaveResult(taskReturnRoute),
+                        }] : []),
                     ...((partial || blocked) && (taskSummary?.retryTargets?.length ?? 0) > 0 ? [{
                             label: `继续处理剩余 ${taskSummary.retryTargets.length} 项…`,
                             description: '重新检查失败的精确目标和必要依赖，并进入新的确认页',
@@ -6334,14 +6662,14 @@ export function ConsoleAppV4(props) {
                             status: 'warning',
                             run: () => leaveResult(taskReturnRoute),
                         }] : []),
-                    { label: '完成，返回我的插件', run: () => {
-                            if (taskBatchOrigin?.owner === 'batch-write'
-                                && taskBatchOrigin.flowId === batchDraft?.flowId) {
-                                setBatchDraft(undefined);
-                                setDirty(false);
-                            }
-                            leaveResult({ name: 'pluginList', mode: 'installed' });
-                        } },
+                    ...(!nestedTaskReturn ? [{ label: '完成，返回我的插件', run: () => {
+                                if (taskBatchOrigin?.owner === 'batch-write'
+                                    && taskBatchOrigin.flowId === batchDraft?.flowId) {
+                                    setBatchDraft(undefined);
+                                    setDirty(false);
+                                }
+                                leaveResult({ name: 'pluginList', mode: 'installed' });
+                            } }] : []),
                     { label: '查看本次记录', run: () => result.operationRecordId
                             && go({ name: 'operationDiagnostic', recordId: result.operationRecordId }) },
                 ]
@@ -6450,7 +6778,8 @@ export function ConsoleAppV4(props) {
                                             { label: '返回首页', run: () => requestSessionNavigation('home') },
                                         ]
                                         : [{ label: partial || blockedDependencyFailure ? '查看失败项' : successfulConfigOperation && configOrigin
-                                                    ? configOrigin?.name === 'pluginPreview' ? '返回插件预览' : '返回插件详情'
+                                                    ? configOrigin.name === 'pluginPreview' ? '返回插件预览'
+                                                        : configOrigin.name === 'pluginWriteTask' ? '返回恢复任务' : '返回插件详情'
                                                     : configOperation ? '查看插件'
                                                         : action === 'uninstall' || action === 'cleanup' ? '返回插件详情' : '查看插件', run: () => {
                                                     if (successfulConfigOperation && configOrigin) {
@@ -6745,6 +7074,22 @@ export function ConsoleAppV4(props) {
     const targetActionSignature = route.name === 'installTargets' && route.view !== 'blocked'
         ? actions.map((action) => String(Boolean(action.disabled))).join(',')
         : '';
+    const batchSelectionActionSignature = route.name === 'batchSelection'
+        && batchDraft?.stage === 'select'
+        ? actions.map((action) => action.pluginId ?? action.label).join('\0')
+        : '';
+    useEffect(() => {
+        if (!batchSelectionActionSignature)
+            return;
+        const lastActionIndex = Math.max(0, actions.length - 1);
+        if (focus > lastActionIndex) {
+            setFocus(lastActionIndex);
+            setScrollOffset(lastActionIndex);
+            return;
+        }
+        if (scrollOffset > lastActionIndex)
+            setScrollOffset(focus);
+    }, [batchSelectionActionSignature, focus, scrollOffset]);
     useEffect(() => {
         if (!targetActionSignature || !actions[focus]?.disabled)
             return;
@@ -6851,6 +7196,9 @@ export function ConsoleAppV4(props) {
         setOverlayFocus(0);
         setOverlay('sessionNavigation');
     }, [props.pendingSessionNavigation, props.pendingSessionNavigationDrafts]);
+    const normalizedEffectiveFocus = route.name === 'batchSelection' && batchDraft?.stage === 'select'
+        ? Math.min(effectiveFocus, Math.max(0, actions.length - 1))
+        : effectiveFocus;
     useInput((input, key) => {
         if (!overlay && route.name === 'reviewPreparing' && snapshot.reviewPreparation?.state === 'failed'
             && (key.escape || input.toLowerCase() === 'b')) {
@@ -7598,7 +7946,7 @@ export function ConsoleAppV4(props) {
                     showSelected: false,
                 } : draft);
             }
-            setFocus(0);
+            setFocus(route.name === 'batchSelection' ? 1 : 0);
             setScrollOffset(0);
             return;
         }
@@ -7624,8 +7972,18 @@ export function ConsoleAppV4(props) {
                 next.add(row.pluginId);
             if (key.leftArrow && row.canExpand)
                 next.delete(row.pluginId);
+            const nextProjection = buildDependencyGraphProjection({
+                overviews: props.controller.listPluginDependencyOverviews(),
+                rootPluginId: route.pluginId,
+                direction: route.direction ?? 'dependencies',
+                expandedPluginIds: next,
+            });
+            const nextFocus = Math.max(0, nextProjection.rows.findIndex((candidate) => candidate.id === row.id));
+            const nextScroll = Math.min(scrollOffset, nextFocus);
             setExpandedDependencyPluginIds(next);
-            setScrollOffset(0);
+            setFocus(nextFocus);
+            setScrollOffset(nextScroll);
+            persistDependencyGraphContext(route, nextProjection, next, nextFocus, nextScroll);
             return;
         }
         const sessionNavigation = resolveTuiSessionNavigationKey({ input, key }, { characterInput: isCharacterInputMode(route, searchFocus) });
@@ -7706,10 +8064,7 @@ export function ConsoleAppV4(props) {
             openBatchSelection(route.mode === 'browse' ? 'install' : undefined);
         }
         else if (route.name === 'pluginList' && route.mode === 'installed' && input.toLowerCase() === 'a') {
-            const projectRoots = [...new Set(props.controller.listPluginWriteTaskCandidates('restore')
-                    .filter((candidate) => candidate.target.scope === 'project')
-                    .map((candidate) => candidate.target.pluginId))];
-            openSelectedPluginTask('restore', projectRoots, 'project');
+            prepareCurrentProjectPlugins();
         }
         else if (route.name === 'batchSelection' && batchDraft?.stage === 'select' && input.toLowerCase() === 'a') {
             const candidates = batchCandidates(batchDraft)
@@ -7724,6 +8079,11 @@ export function ConsoleAppV4(props) {
         }
         else if (route.name === 'batchSelection' && batchDraft?.stage === 'select' && input.toLowerCase() === 'c') {
             if (batchDraft.selectedPluginIds.length > 0) {
+                const invalid = invalidBatchSelection(batchDraft);
+                if (invalid.length > 0) {
+                    setActionError(`${invalid.length} 个已选插件已不可用。请先在“查看全部已选”中取消选择。`);
+                    return;
+                }
                 if (batchDraft.mode === 'browse') {
                     setBatchDraft((current) => current ? { ...current, action: 'install' } : current);
                     props.controller.push({ name: 'batchPlacement' });
@@ -7737,9 +8097,11 @@ export function ConsoleAppV4(props) {
                 setActionError('请至少选择一个插件。');
         }
         else if (route.name === 'batchSelection' && batchDraft?.stage === 'select' && input === ' ') {
-            const action = actions[effectiveFocus];
-            if (action?.pluginId && action.selectable)
+            const action = actions[normalizedEffectiveFocus];
+            if (action?.pluginId
+                && (batchDraft.selectedPluginIds.includes(action.pluginId) || action.canSelectNew)) {
                 toggleBatchPlugin(action.pluginId);
+            }
         }
         else if (route.name === 'batchSelection' && batchDraft?.stage === 'select' && input === '/') {
             setSearchFocus(true);
@@ -7755,7 +8117,7 @@ export function ConsoleAppV4(props) {
                 ...(next === 'all' ? { sourceId: undefined } : { sourceId: next }),
                 showSelected: false,
             } : draft);
-            setFocus(0);
+            setFocus(1);
             setScrollOffset(0);
         }
         else if (route.name === 'configFields' && route.layer.scope !== 'effective' && input.toLowerCase() === 's') {
@@ -7812,7 +8174,8 @@ export function ConsoleAppV4(props) {
         }
         else if (key.upArrow || input.toLowerCase() === 'k') {
             setFocus((value) => {
-                const current = dynamicActionIds ? effectiveFocus : value;
+                const current = route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? normalizedEffectiveFocus : dynamicActionIds ? effectiveFocus : value;
                 const next = pluginRows.length > 0 ? moveIndex(pluginRows.length, current, -1) : moveFocus(actions, current, -1);
                 if (dynamicActionIds && dynamicActionSignature !== undefined) {
                     dynamicMenuFocus.current = {
@@ -7821,17 +8184,31 @@ export function ConsoleAppV4(props) {
                         focusedActionId: dynamicActionIds[next],
                     };
                 }
-                const viewport = route.name === 'portableSkillSelect' && snapshot.portableDraft
-                    ? portableSkillCandidateViewport(actions.slice(0, snapshot.portableDraft.candidates.length), snapshot.portableDraft.candidates, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actions.length - snapshot.portableDraft.candidates.length
-                        + (portableVariantCandidates.length > 0 ? 3 : 0)))
-                    : actionViewport(actions, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actionViewportStaticRows));
-                setScrollOffset(viewport.offset);
+                const viewport = route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? actionViewport(actions.slice(1), policy.mode === 'compact', Math.max(0, next - 1), Math.max(0, scrollOffset - 1), Math.max(1, pageActionBudget(5)))
+                    : route.name === 'portableSkillSelect' && snapshot.portableDraft
+                        ? portableSkillCandidateViewport(actions.slice(0, snapshot.portableDraft.candidates.length), snapshot.portableDraft.candidates, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actions.length - snapshot.portableDraft.candidates.length
+                            + (portableVariantCandidates.length > 0 ? 3 : 0)))
+                        : actionViewport(actions, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actionViewportStaticRows));
+                if (route.name === 'pluginDependencies' && route.view !== 'removeBlocked') {
+                    const projection = buildDependencyGraphProjection({
+                        overviews: props.controller.listPluginDependencyOverviews(),
+                        rootPluginId: route.pluginId,
+                        direction: route.direction ?? 'dependencies',
+                        ...(expandedDependencyPluginIds ? { expandedPluginIds: expandedDependencyPluginIds } : {}),
+                    });
+                    persistDependencyGraphContext(route, projection, expandedDependencyPluginIds ?? new Set(projection.defaultExpandedPluginIds), next, viewport.offset);
+                }
+                setScrollOffset(route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? next === 0 ? 0 : viewport.offset + 1
+                    : viewport.offset);
                 return next;
             });
         }
         else if (key.downArrow || input.toLowerCase() === 'j') {
             setFocus((value) => {
-                const current = dynamicActionIds ? effectiveFocus : value;
+                const current = route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? normalizedEffectiveFocus : dynamicActionIds ? effectiveFocus : value;
                 const next = pluginRows.length > 0 ? moveIndex(pluginRows.length, current, 1) : moveFocus(actions, current, 1);
                 if (dynamicActionIds && dynamicActionSignature !== undefined) {
                     dynamicMenuFocus.current = {
@@ -7840,11 +8217,24 @@ export function ConsoleAppV4(props) {
                         focusedActionId: dynamicActionIds[next],
                     };
                 }
-                const viewport = route.name === 'portableSkillSelect' && snapshot.portableDraft
-                    ? portableSkillCandidateViewport(actions.slice(0, snapshot.portableDraft.candidates.length), snapshot.portableDraft.candidates, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actions.length - snapshot.portableDraft.candidates.length
-                        + (portableVariantCandidates.length > 0 ? 3 : 0)))
-                    : actionViewport(actions, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actionViewportStaticRows));
-                setScrollOffset(viewport.offset);
+                const viewport = route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? actionViewport(actions.slice(1), policy.mode === 'compact', Math.max(0, next - 1), Math.max(0, scrollOffset - 1), Math.max(1, pageActionBudget(5)))
+                    : route.name === 'portableSkillSelect' && snapshot.portableDraft
+                        ? portableSkillCandidateViewport(actions.slice(0, snapshot.portableDraft.candidates.length), snapshot.portableDraft.candidates, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actions.length - snapshot.portableDraft.candidates.length
+                            + (portableVariantCandidates.length > 0 ? 3 : 0)))
+                        : actionViewport(actions, policy.mode === 'compact', next, scrollOffset, pageActionBudget(actionViewportStaticRows));
+                if (route.name === 'pluginDependencies' && route.view !== 'removeBlocked') {
+                    const projection = buildDependencyGraphProjection({
+                        overviews: props.controller.listPluginDependencyOverviews(),
+                        rootPluginId: route.pluginId,
+                        direction: route.direction ?? 'dependencies',
+                        ...(expandedDependencyPluginIds ? { expandedPluginIds: expandedDependencyPluginIds } : {}),
+                    });
+                    persistDependencyGraphContext(route, projection, expandedDependencyPluginIds ?? new Set(projection.defaultExpandedPluginIds), next, viewport.offset);
+                }
+                setScrollOffset(route.name === 'batchSelection' && batchDraft?.stage === 'select'
+                    ? next === 0 ? 0 : viewport.offset + 1
+                    : viewport.offset);
                 return next;
             });
         }
@@ -7858,7 +8248,7 @@ export function ConsoleAppV4(props) {
                     : { name: 'pluginDetail', pluginId: row.pluginId });
         }
         else if (key.return) {
-            runAction(actions[effectiveFocus]);
+            runAction(actions[normalizedEffectiveFocus]);
         }
     });
     if (tooSmall) {