@lesliechan721/aw 0.1.0-beta.10 → 0.1.0-beta.12

package/dist/src/tui/operation-review-planner.js

@@ -1,5 +1,8 @@
 import { requestedIntentAction } from '../output/command-receipt.js';
 import { catalogSourceAutoCheckOnlyValue } from './catalog-sources/review.js';
+import { parseScriptTimeoutMs, SCRIPT_TIMEOUT_DEFAULT_MS, } from '../commands/options.js';
+import { MANAGED_CODEX_VERSION } from '../utils/codex-manager.js';
+import { platformLabel, scopeLabel } from './glossary.js';
 function plannerError(code, message) {
     return new Error(`${code}: ${message}`);
 }
@@ -7,10 +10,109 @@ function pluginNameFromId(pluginId) {
     const separator = pluginId.indexOf('/');
     return separator < 0 ? pluginId : pluginId.slice(separator + 1);
 }
+function scriptTimeoutChanges(intent) {
+    let configuredTimeoutMs;
+    if ((intent.kind === 'pluginWrite' || intent.kind === 'pluginWriteBatch')
+        && (intent.action === 'install' || intent.action === 'refreshAndSync'
+            || intent.action === 'reinstall' || intent.action === 'sync')) {
+        configuredTimeoutMs = intent.scriptTimeoutMs;
+    }
+    else if (intent.kind === 'configSave' && intent.apply) {
+        configuredTimeoutMs = intent.scriptTimeoutMs;
+    }
+    else {
+        return [];
+    }
+    const timeoutMs = parseScriptTimeoutMs(configuredTimeoutMs ?? SCRIPT_TIMEOUT_DEFAULT_MS);
+    return [{
+            kind: 'keep',
+            group: 'runtime',
+            title: 'preApply 脚本超时',
+            description: `${timeoutMs} ms`,
+        }];
+}
+function preApplyScopeChanges(targets) {
+    return [...new Map(targets.map((target) => [[
+                target.pluginId,
+                target.platform,
+                target.scope,
+            ].join('\0'), target])).values()].map((target) => ({
+        kind: 'change',
+        group: 'runtime',
+        pluginId: target.pluginId,
+        ...(target.relation ? { relation: target.relation } : {}),
+        title: `运行 ${target.pluginId} preApply`,
+        description: `${platformLabel(target.platform)} · ${scopeLabel(target.scope)}`,
+    }));
+}
+function operationPreApplyTargets(evidence) {
+    return (evidence?.operationPlan?.actions ?? []).flatMap((action) => action.kind === 'runPreApply'
+        ? [{
+                ...action,
+                ...(evidence?.dependencyPlan
+                    ? { relation: dependencyRelation(evidence.dependencyPlan, action.pluginId) }
+                    : {}),
+            }]
+        : []);
+}
+function sourceMutationReviewChanges(mutation) {
+    if (mutation.action === 'add') {
+        const source = mutation.source;
+        return [
+            { kind: 'add', title: '保存来源配置' },
+            { kind: 'add', title: source.type === 'git' ? 'Git URL' : '本地目录', description: '已设置' },
+            ...(source.type === 'git' ? [{
+                    kind: 'add',
+                    title: 'Git ref policy',
+                    description: source.refPolicy.type === 'cliChannel'
+                        ? '跟随 CLI channel'
+                        : `固定 ref · ${source.refPolicy.ref}`,
+                }, {
+                    kind: 'add',
+                    title: '插件目录子目录',
+                    description: source.subdir ?? '根目录',
+                }] : []),
+            {
+                kind: 'add',
+                title: '自动检查',
+                description: source.autoCheck === false ? '关闭' : '开启',
+            },
+        ];
+    }
+    const update = mutation.update;
+    const changes = [];
+    if ('url' in update && update.url !== undefined) {
+        changes.push({ kind: 'change', title: 'Git URL', description: '将更新' });
+    }
+    if ('path' in update && update.path !== undefined) {
+        changes.push({ kind: 'change', title: '本地目录', description: '将更新' });
+    }
+    if ('refPolicy' in update && update.refPolicy)
+        changes.push({
+            kind: 'change',
+            title: 'Git ref policy',
+            description: update.refPolicy.type === 'cliChannel'
+                ? '跟随 CLI channel'
+                : `固定 ref · ${update.refPolicy.ref}`,
+        });
+    if ('subdir' in update && update.subdir !== undefined)
+        changes.push({
+            kind: 'change',
+            title: '插件目录子目录',
+            description: update.subdir ?? '根目录',
+        });
+    if ('autoCheck' in update && update.autoCheck !== undefined)
+        changes.push({
+            kind: 'change',
+            title: '自动检查',
+            description: update.autoCheck ? '开启' : '关闭',
+        });
+    return changes.length > 0 ? changes : [{ kind: 'change', title: '更新来源配置' }];
+}
 function operationLabels(intent, evidence) {
     if (intent.kind === 'catalogSourcesRecovery') {
         return {
-            title: '恢复 Catalog 来源配置',
+            title: '恢复插件目录来源配置',
             description: '备份损坏配置，并恢复唯一的主来源 official。',
             primaryLabel: '备份并恢复官方默认来源',
             destructive: false,
@@ -24,12 +126,21 @@ function operationLabels(intent, evidence) {
             destructive: false,
         };
     }
-    if (intent.kind === 'pluginWrite' && intent.dependencyPlacementAdjustment) {
+    if (intent.kind === 'pluginWriteBatch') {
+        const labels = {
+            install: ['批量添加插件', '添加所选插件及其必需依赖。'],
+            sync: ['批量同步插件', '按已保存的设置同步所选插件。'],
+            reinstall: ['批量重新安装插件', '清理 AW 管理的内容后完整重建所选插件。'],
+            uninstall: ['批量移除插件', '移除所选插件的 AW 管理安装内容。配置保持不变。'],
+            cleanup: ['批量清理插件', '只移除可证明属于 AW 的现场内容。配置保持不变。'],
+        };
+        const [title, description] = labels[intent.action];
         return {
-            title: '调整依赖位置',
-            description: '按最终依赖位置更新 desired intent，并应用非破坏性变更。',
-            primaryLabel: '应用依赖位置',
-            destructive: false,
+            title,
+            description,
+            primaryLabel: title,
+            destructive: intent.action === 'reinstall' || intent.action === 'uninstall'
+                || intent.action === 'cleanup',
         };
     }
     if (intent.kind === 'pluginWrite') {
@@ -59,11 +170,11 @@ function operationLabels(intent, evidence) {
         }
         const labels = {
             install: ['添加插件', '添加所选平台和使用位置。', false],
-            refreshAndSync: ['刷新并同步', '刷新相关来源后，使用新的 Active 内容同步所选安装。', false],
+            refreshAndSync: ['刷新并同步', '刷新相关来源后，使用新的当前启用版本同步所选安装。', false],
             reinstall: ['重新安装插件', '清理 AW 管理的内容后完整重建。', true],
             uninstall: ['移除插件', '移除 AW 管理的安装内容。配置保持不变。', true],
             cleanup: ['清理插件', '只移除可证明属于 AW 的现场内容。配置保持不变。', true],
-            sync: ['同步插件', '按已保存的 desired intent 修复当前现场。', false],
+            sync: ['同步插件', '按已保存使用设置修复当前使用位置。', false],
         };
         const [title, description, destructive] = labels[intent.action];
         return { title, description, primaryLabel: title, destructive };
@@ -100,7 +211,7 @@ function operationLabels(intent, evidence) {
         if (autoCheck !== undefined) {
             return {
                 title: '保存自动检查设置',
-                description: '只保存自动检查设置；Active Catalog 和 Catalog store 保持不变。',
+                description: '只保存自动检查设置；当前启用版本和本地目录副本保持不变。',
                 primaryLabel: '保存设置',
                 destructive: false,
             };
@@ -117,18 +228,18 @@ function operationLabels(intent, evidence) {
     if (intent.kind === 'catalogGeneration') {
         if (intent.action === 'update' && evidence?.catalogGeneration?.exactRepair) {
             return {
-                title: '验证并精确修复 Catalog',
-                description: '候选与当前 Active store key 相同。精确替换损坏条目，并保留 Active 身份。',
+                title: '验证并精确修复插件目录',
+                description: '待检查版本与当前启用版本的技术标识相同。精确替换损坏内容，并保留当前启用版本。',
                 primaryLabel: '验证并精确修复',
                 destructive: false,
             };
         }
         const labels = {
-            activate: ['获取并启用 Catalog', '验证候选后启用。不会升级已安装 Plugin，也不会修改其他来源。', '获取并启用'],
-            update: ['验证并切换 Catalog', '验证候选后切换 Active。失败时保留旧 Active。', '验证并切换'],
-            repair: ['重新下载并修复 Catalog', '只修复这个来源的 Active 条目，不删除其他 digest。', '重新下载并修复'],
-            replaceDamaged: ['替换损坏的 Active Catalog', '使用当前候选替换无法精确修复的 Active。失败时保留旧 Active。', '确认并替换'],
-            recoverState: ['恢复 Catalog 状态并启用', '重建无效 generation state，并只激活已确认的目标来源。来源配置和 Catalog store 保持不变。', '恢复状态并启用'],
+            activate: ['获取并启用插件目录', '检查待检查版本后启用。不会升级已安装插件，也不会修改其他来源。', '获取并启用'],
+            update: ['检查并切换插件目录', '检查待检查版本后切换当前启用版本。失败时保留原当前启用版本。', '检查并切换'],
+            repair: ['重新下载并修复插件目录', '只修复这个来源的当前启用版本，不删除其他目录版本副本。', '重新下载并修复'],
+            replaceDamaged: ['替换损坏的当前启用版本', '使用待检查版本替换无法精确修复的当前启用版本。失败时保留原版本。', '确认并替换'],
+            recoverState: ['恢复插件目录状态并启用', '重建无效的目录版本状态，并只启用已确认的目标来源。来源配置和本地目录副本保持不变。', '恢复状态并启用'],
         };
         const [title, description, primaryLabel] = labels[intent.action];
         return { title, description, primaryLabel, destructive: false };
@@ -180,20 +291,24 @@ function reviewChanges(intent, evidence, dependencyOverview) {
     }
     if (intent.kind === 'pluginWrite') {
         const desiredIntentKind = requestedIntentAction(intent.action === 'refreshAndSync' ? 'sync' : intent.action);
-        const runtimeChanges = evidence?.codexManager
-            ? [{
-                    kind: evidence.codexManager.state === 'requires-install' ? 'add' : 'keep',
-                    group: 'runtime',
-                    title: evidence.codexManager.state === 'requires-install'
-                        ? '获取 Codex runtime'
-                        : 'Codex runtime',
-                    description: evidence.codexManager.state === 'requires-install'
-                        ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · AW-managed 缓存`
-                        : evidence.codexManager.state === 'cached'
-                            ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · 复用 AW-managed 缓存`
-                            : `使用兼容的 system Codex ${evidence.codexManager.version}`,
-                }]
-            : [];
+        const runtimeChanges = [
+            ...scriptTimeoutChanges(intent),
+            ...preApplyScopeChanges(operationPreApplyTargets(evidence)),
+            ...(evidence?.codexManager
+                ? [{
+                        kind: evidence.codexManager.state === 'requires-install' ? 'add' : 'keep',
+                        group: 'runtime',
+                        title: evidence.codexManager.state === 'requires-install'
+                            ? '获取 Codex 运行组件'
+                            : 'Codex 运行组件',
+                        description: evidence.codexManager.state === 'requires-install'
+                            ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · AW 管理缓存`
+                            : evidence.codexManager.state === 'cached'
+                                ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · 复用 AW 管理缓存`
+                                : `使用兼容的系统 Codex ${evidence.codexManager.version}`,
+                    }]
+                : []),
+        ];
         const codexChanges = (evidence?.codexReconcilePlans ?? []).flatMap((codexPlan) => [
             ...codexPlan.sharedNativeActions.map((action) => ({
                 kind: action.action === 'reuse' || action.action === 'none' ? 'keep'
@@ -202,22 +317,29 @@ function reviewChanges(intent, evidence, dependencyOverview) {
                 pluginId: action.pluginId,
                 title: action.codexPluginId,
                 description: action.action === 'reuse'
-                    ? '复用已存在的精确 shared native；不建立 ownership ledger'
-                    : `${action.action} · shared${action.affectsOtherScopes ? ' · 可能影响其他项目' : ''}`,
+                    ? '复用完全相同的平台共享内容'
+                    : `${{
+                        install: '添加',
+                        update: '更新',
+                        repair: '修复',
+                        replace: '替换',
+                        remove: '移除',
+                        none: '保持不变',
+                    }[action.action]}平台共享内容${action.affectsOtherScopes ? ' · 可能影响其他项目' : ''}`,
             })),
             ...codexPlan.activationActions.user.map((action) => ({
                 kind: action.action === 'none' ? 'keep' : action.desired ? 'change' : 'remove',
                 group: 'userActivation',
                 pluginId: action.pluginId,
                 title: action.codexPluginId,
-                description: `desired=${String(action.desired)} · ${action.action}`,
+                description: `${action.desired ? '启用' : '停用'}所有项目位置 · ${action.action === 'none' ? '保持不变' : '将更新'}`,
             })),
             ...codexPlan.activationActions.project.map((action) => ({
                 kind: action.action === 'none' ? 'keep' : action.desired ? 'change' : 'remove',
                 group: 'projectActivation',
                 pluginId: action.pluginId,
                 title: action.codexPluginId,
-                description: `desired=${String(action.desired)} · ${action.action}`,
+                description: `${action.desired ? '启用' : '停用'}当前项目位置 · ${action.action === 'none' ? '保持不变' : '将更新'}`,
             })),
             ...[...codexPlan.extensionWrites, ...codexPlan.extensionRemovals]
                 .map((action) => ({
@@ -225,7 +347,7 @@ function reviewChanges(intent, evidence, dependencyOverview) {
                 group: 'awExtensions',
                 pluginId: action.pluginId,
                 title: action.componentKey,
-                description: `${action.scope} · ${action.action}`,
+                description: `${scopeLabel(action.scope)} · ${action.action === 'write' ? '写入' : '移除'}`,
             })),
         ]);
         const plan = evidence?.dependencyPlan;
@@ -239,18 +361,14 @@ function reviewChanges(intent, evidence, dependencyOverview) {
                     pluginId: target.pluginId,
                     relation,
                     title: pluginNameFromId(target.pluginId),
-                    description: `${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.resolvedScope === 'user' ? '所有项目' : '当前项目'}${target.action === 'keep' ? ' · 已可用' : ''}${target.assignmentSource === 'existingWiderTarget' ? ' · 复用健康的所有项目安装' : target.assignmentSource === 'consumerPromotion' ? ' · 随上游依赖一并调整' : ''}`,
+                    description: `${platformLabel(target.platform)} · ${scopeLabel(target.resolvedScope)}${target.action === 'keep' ? ' · 已可用' : ''}${target.assignmentSource === 'existingWiderTarget' ? ' · 复用健康的所有项目安装' : target.assignmentSource === 'consumerPromotion' ? ' · 根据依赖自动扩大范围' : ''}`,
                 };
             });
             changes.push({
                 kind: 'keep',
                 group: 'preserved',
-                title: intent.dependencyPlacementAdjustment
-                    ? '根插件和插件设置保持不变'
-                    : '插件设置和已有依赖保持不变',
-                description: intent.dependencyPlacementAdjustment
-                    ? '这里只调整所列 dependency placement。'
-                    : '移除根插件时不会自动清理依赖。',
+                title: '插件设置和已有依赖保持不变',
+                description: '移除根插件时不会自动清理依赖。',
             });
             return [...changes, ...codexChanges, ...runtimeChanges];
         }
@@ -262,14 +380,14 @@ function reviewChanges(intent, evidence, dependencyOverview) {
             group: 'requested',
             pluginId: intent.pluginId,
             relation: 'requested',
-            title: `${platform === 'codex' ? 'Codex' : 'Claude Code'} · ${intent.scope === 'user' ? '所有项目' : '当前项目'}`,
+            title: `${platformLabel(platform)} · ${scopeLabel(intent.scope)}`,
             description: intent.action === 'uninstall' || intent.action === 'cleanup'
                 ? '插件设置不会删除。'
                 : '执行前会再次检查当前安装状态。',
         }));
         if (intent.action === 'cleanup' && evidence?.offlineCleanup) {
             const actionLabels = {
-                removeOwnedOutput: '移除 AW-owned 输出',
+                removeOwnedOutput: '移除 AW 管理输出',
                 removeNativeRegistration: '移除原生插件注册',
             };
             changes.push(...evidence.offlineCleanup.plan.actions.map((action) => ({
@@ -305,8 +423,8 @@ function reviewChanges(intent, evidence, dependencyOverview) {
             changes.push({
                 kind: 'warning',
                 group: 'preserved',
-                title: `后续：${intent.scope === 'user' ? '当前项目' : '所有项目'} sync`,
-                description: intent.recoveryDescription,
+                title: `后续：同步${intent.scope === 'user' ? '当前项目' : '所有项目'}位置`,
+                description: '完成此操作后，同步要保留的使用位置。',
             });
         }
         return [...changes, ...codexChanges, ...runtimeChanges];
@@ -315,6 +433,20 @@ function reviewChanges(intent, evidence, dependencyOverview) {
         const layerLabel = intent.scope === 'user'
             ? '个人默认'
             : '当前项目';
+        const impact = evidence?.config;
+        const impactChanges = impact?.impactState === 'unknown'
+            ? [{
+                    kind: 'warning', group: 'configImpact', title: '设置重置后的应用影响未知',
+                    description: '当前无法解析来源或设置；重置仍会删除所选设置层。',
+                }]
+            : impact?.noEffectiveChange
+                ? [{ kind: 'keep', group: 'configImpact', title: '有效设置输入不变；无需同步当前安装' }]
+                : (impact?.affectedTargets ?? []).length > 0
+                    ? impact.affectedTargets.map((target) => ({
+                        kind: 'warning', group: 'configImpact',
+                        title: `重置后需同步 ${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.scope === 'user' ? '所有项目' : '当前项目'}`,
+                    }))
+                    : [{ kind: 'keep', group: 'configImpact', title: '只删除设置层；当前安装保持不变' }];
         return [
             ...(intent.changes?.map((change) => ({
                 kind: 'remove', group: 'configChanges', title: `${layerLabel} · ${change.title}`,
@@ -322,7 +454,7 @@ function reviewChanges(intent, evidence, dependencyOverview) {
                     ? `${change.before} → ${change.after}；${change.children.length} 个子项变化；${change.children.map((child) => `${child.property}: ${child.private ? '已设置 → 将更新' : `${child.before} → ${child.after}`}`).join('；')}`
                     : `${change.before} → ${change.after}`,
             })) ?? [{ kind: 'remove', group: 'configChanges', title: `删除${layerLabel}中的已存值`, description: '删除整个设置层且不创建备份；有效值将恢复为继承值或默认值。' }]),
-            { kind: 'keep', group: 'configImpact', title: '只保存设置；当前安装保持不变' },
+            ...impactChanges,
             { kind: 'keep', group: 'preserved', title: intent.scope === 'user' ? '当前项目设置保持不变' : '个人默认保持不变' },
         ];
     }
@@ -365,75 +497,74 @@ function reviewChanges(intent, evidence, dependencyOverview) {
     if (intent.kind === 'catalogGeneration') {
         const generation = evidence?.catalogGeneration;
         if (!generation) {
-            throw plannerError('catalogGenerationUnavailable', '缺少 Catalog 候选证据。');
+            throw plannerError('catalogGenerationUnavailable', '缺少插件目录待检查版本证据。');
         }
         return [
             ...(generation.previousActive ? [{
                     kind: 'keep',
                     title: generation.previousActiveVersion
-                        ? `当前 Active Catalog ${generation.previousActiveVersion}` : '当前 Active',
+                        ? `当前启用版本 ${generation.previousActiveVersion}` : '当前启用版本',
                     description: `${generation.previousActive.resolvedCommit.slice(0, 8)} · ${generation.previousActive.snapshotDigest.slice(0, 15)}`,
                 }] : []),
             {
                 kind: intent.action === 'activate' ? 'add' : 'change',
                 title: generation.exactRepair
-                    ? `精确修复候选 Catalog ${generation.candidate.catalogVersion}`
-                    : `候选 Catalog ${generation.candidate.catalogVersion}`,
+                    ? `精确修复待检查版本 ${generation.candidate.catalogVersion}`
+                    : `待检查版本 ${generation.candidate.catalogVersion}`,
                 description: `${generation.candidate.resolvedCommit.slice(0, 8)} · ${generation.candidate.snapshotDigest.slice(0, 15)}`,
             },
             ...(generation.exactRepair ? [{
                     kind: 'change',
-                    title: '精确替换损坏的 Active 条目',
-                    description: 'logical identity、snapshot digest、manifest digest 和 commit 保持不变。',
+                    title: '精确替换损坏的当前启用版本',
+                    description: '版本和内容的技术标识保持不变。',
                 }] : []),
             ...(intent.action === 'replaceDamaged' ? [{
                     kind: 'warning',
-                    title: '使用当前候选替换损坏的 Active',
-                    description: '旧版本无法安全比较；确认后只切换到本次绑定的当前候选。',
-                }] : []),
-            ...(generation.sourceMutation ? [{
-                    kind: generation.sourceMutation.action === 'add' ? 'add' : 'change',
-                    title: generation.sourceMutation.action === 'add' ? '保存来源配置'
-                        : 'url' in generation.sourceMutation.update ? 'Git URL'
-                            : 'path' in generation.sourceMutation.update ? '本地目录'
-                                : 'refPolicy' in generation.sourceMutation.update
-                                    && generation.sourceMutation.update.refPolicy ? 'Git ref policy'
-                                    : 'subdir' in generation.sourceMutation.update
-                                        && generation.sourceMutation.update.subdir !== undefined ? 'Catalog 子目录'
-                                        : '更新来源配置',
-                    description: `${generation.configDigest.slice(0, 8)} → ${generation.proposedConfigDigest?.slice(0, 8) ?? '未知'}`,
+                    title: '使用待检查版本替换损坏的当前启用版本',
+                    description: '旧版本无法安全比较；确认后只切换到本次已检查的版本。',
                 }] : []),
+            ...(generation.sourceMutation ? sourceMutationReviewChanges(generation.sourceMutation) : []),
             ...(generation.explicitSourceChange && generation.candidateRelation === 'rollbackDetected' ? [{
                     kind: 'warning',
-                    title: '显式来源切换将降低 Catalog 版本',
+                    title: '来源切换将降低插件目录版本',
                     description: `${generation.previousActiveVersion ?? '当前版本'} → ${generation.candidate.catalogVersion}`,
                 }] : generation.explicitSourceChange && generation.candidateRelation === 'versionConflict' ? [{
                     kind: 'warning',
-                    title: '显式来源切换包含同版本不同内容',
+                    title: '来源切换包含同版本不同内容',
                     description: `${generation.candidate.catalogVersion} · ${generation.candidate.snapshotDigest.slice(0, 15)}`,
                 }] : generation.explicitSourceChange && generation.candidateRelation === 'incompatible' ? [{
                     kind: 'warning',
-                    title: '显式来源切换将改变 Catalog logical identity',
-                    description: '确认前请核对新来源身份和候选摘要。',
+                    title: '来源切换将改变插件目录身份',
+                    description: '确认前请核对新来源身份和待检查版本摘要。',
                 }] : []),
             ...((generation.impact?.affectedReferences ?? []).length > 0 ? [{
                     kind: 'warning',
-                    title: '现有引用受候选变化影响',
+                    title: '现有引用受待检查版本影响',
                     description: `${generation.impact.affectedReferences.length} 项；已安装插件不会自动修改。`,
                 }] : []),
             ...(generation.impact && !generation.impact.inventoryComplete ? [{
                     kind: 'warning',
-                    title: '候选影响未知',
-                    description: '部分状态或旧 Manifest 无法读取；不能把影响视为零。',
+                    title: '待检查版本的影响未知',
+                    description: '部分状态或旧插件定义无法读取；不能把影响视为零。',
                 }] : []),
-            { kind: 'keep', title: '不会升级已安装 Plugin' },
+            ...((generation.primaryImpact?.affectedReferences ?? []).length > 0 ? [{
+                    kind: 'warning',
+                    title: '切换主来源会影响现有引用',
+                    description: `${generation.primaryImpact.affectedReferences.length} 项；切换将在插件目录启用后执行。`,
+                }] : []),
+            ...(generation.primaryImpact && !generation.primaryImpact.inventoryComplete ? [{
+                    kind: 'warning',
+                    title: '主来源切换影响未知',
+                    description: '部分状态无法读取；不能把影响视为零。',
+                }] : []),
+            { kind: 'keep', title: '不会升级已安装插件' },
             { kind: 'keep', title: intent.action === 'recoverState'
-                    ? '不会修改其他来源配置或 store' : '不会修改其他来源' },
-            { kind: 'keep', title: '失败时保留旧 Active' },
+                    ? '不会修改其他来源配置或本地目录副本' : '不会修改其他来源' },
+            { kind: 'keep', title: '失败时保留原当前启用版本' },
             ...(intent.action === 'recoverState' ? [{
                     kind: 'warning',
-                    title: '无效 state 中的其他 Active 指针不会被信任或保留',
-                    description: '其他来源配置和 store 内容不会删除；可分别重新启用。',
+                    title: '无效状态中的其他当前启用版本记录不会保留',
+                    description: '其他来源配置和本地目录副本不会删除；可分别重新启用。',
                 }] : []),
         ];
     }
@@ -445,6 +576,8 @@ function reviewChanges(intent, evidence, dependencyOverview) {
     const layerLabel = intent.scope === 'user' ? '个人默认' : '当前项目';
     if (intent.retryApply) {
         return [
+            ...scriptTimeoutChanges(intent),
+            ...preApplyScopeChanges(evidence?.config?.preApplyAuthorization ?? []),
             ...(evidence?.config?.affectedTargets.map((target) => ({
                 kind: 'change',
                 group: 'configImpact',
@@ -455,32 +588,41 @@ function reviewChanges(intent, evidence, dependencyOverview) {
         ];
     }
     if (intent.changes) {
+        const noEffectiveChange = evidence?.config?.noEffectiveChange === true;
         const hasAffectedCodexTarget = evidence?.config?.affectedTargets.some((target) => target.platform === 'codex') ?? false;
         const sharedNativeTargets = hasAffectedCodexTarget
             ? evidence?.config?.sharedNativeRenderTargets ?? []
             : [];
-        const sharedNativeImpact = sharedNativeTargets.length === 0
+        const sharedNativeImpact = noEffectiveChange || sharedNativeTargets.length === 0
             ? []
             : intent.apply
                 ? [
                     {
                         kind: 'change', group: 'configImpact',
                         title: `重新生成 ${sharedNativeTargets.map((target) => target.skillKey).join('、')} 动态 Skill`,
-                        description: '配置来源为个人默认；更新共享 Codex native 插件会影响所有启用项目。',
+                        description: '配置来源为个人默认；更新 Codex 平台共享内容会影响所有启用项目。',
                     },
-                    { kind: 'keep', group: 'preserved', title: '保留当前 user/project activation' },
-                    { kind: 'keep', group: 'preserved', title: 'project Agent role 继续按当前项目配置' },
+                    { kind: 'keep', group: 'preserved', title: '保留所有项目和当前项目的启用位置' },
+                    { kind: 'keep', group: 'preserved', title: '当前项目 Agent role 继续使用当前项目配置' },
                 ]
                 : [
                     {
                         kind: 'warning', group: 'configImpact',
-                        title: '共享 Codex native render 待同步',
+                        title: 'Codex 平台共享内容待同步',
                         description: '个人默认已保存；动态 Skill 尚未重新生成。',
                     },
-                    { kind: 'keep', group: 'preserved', title: '当前 native 插件和 activation 保持不变' },
-                    { kind: 'keep', group: 'preserved', title: 'project Agent role 继续按当前项目配置' },
+                    { kind: 'keep', group: 'preserved', title: '当前平台共享内容和启用位置保持不变' },
+                    { kind: 'keep', group: 'preserved', title: '当前项目 Agent role 继续使用当前项目配置' },
                 ];
         return [
+            ...scriptTimeoutChanges(intent),
+            ...preApplyScopeChanges(evidence?.config?.preApplyAuthorization ?? []),
+            ...(evidence?.config?.shareability === 'unverified' ? [{
+                    kind: 'warning',
+                    group: 'configImpact',
+                    title: 'Git 无法验证 project config 可共享',
+                    description: '可以继续写入，但不要将该路径视为已验证可提交。',
+                }] : []),
             ...intent.changes.map((change) => ({
                 kind: removeKeys.has(change.key) ? 'remove' : 'change',
                 group: 'configChanges',
@@ -494,19 +636,33 @@ function reviewChanges(intent, evidence, dependencyOverview) {
                         : privateKeys.has(change.key) ? '已设置 → 将更新'
                             : `${change.before} → ${change.after}`,
             })),
+            ...(evidence?.config?.impactState === 'unknown' ? [{
+                    kind: 'warning', group: 'configImpact',
+                    title: '设置的应用影响未知',
+                    description: '当前无法比较保存前后的有效设置输入。',
+                }] : noEffectiveChange ? [{
+                    kind: 'keep', group: 'configImpact',
+                    title: '有效设置输入不变；无需重新应用',
+                }] : []),
             ...sharedNativeImpact,
-            ...(sharedNativeTargets.length > 0
+            ...(evidence?.config?.impactState === 'unknown' || noEffectiveChange || sharedNativeTargets.length > 0
                 ? []
                 : intent.apply && (evidence?.config?.affectedTargets.length ?? 0) > 0
                     ? evidence.config.affectedTargets.map((target) => ({
                         kind: 'change', group: 'configImpact', title: `重新应用 ${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.scope === 'user' ? '所有项目' : '当前项目'}`,
                     }))
-                    : [{ kind: 'keep', group: 'configImpact', title: '当前没有可见安装；只保存设置' }]),
+                    : !intent.apply && (evidence?.config?.affectedTargets.length ?? 0) > 0
+                        ? evidence.config.affectedTargets.map((target) => ({
+                            kind: 'warning', group: 'configImpact', title: `保存后需同步 ${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.scope === 'user' ? '所有项目' : '当前项目'}`,
+                        }))
+                        : [{ kind: 'keep', group: 'configImpact', title: '当前没有可见安装；只保存设置' }]),
             { kind: 'keep', group: 'preserved', title: '其他项目不会被自动扫描' },
         ];
     }
     const updateKeys = Object.keys(intent.updates ?? {});
     return [
+        ...scriptTimeoutChanges(intent),
+        ...preApplyScopeChanges(evidence?.config?.preApplyAuthorization ?? []),
         ...updateKeys.map((key) => ({
             kind: 'change',
             title: key,
@@ -519,6 +675,81 @@ function reviewChanges(intent, evidence, dependencyOverview) {
         })),
     ];
 }
+function batchGroupEvidence(evidence, group) {
+    const manager = group.preview.codexManagerPreview;
+    return {
+        catalog: evidence.catalog,
+        ...(group.preview.dependencyPlan ? { dependencyPlan: group.preview.dependencyPlan } : {}),
+        ...(group.preview.codexReconcilePlans ? { codexReconcilePlans: group.preview.codexReconcilePlans } : {}),
+        ...(group.preview.operationPlan ? { operationPlan: group.preview.operationPlan } : {}),
+        ...(manager && manager.state !== 'blocked' ? {
+            codexManager: {
+                state: manager.state,
+                packageName: '@openai/codex',
+                version: manager.state === 'requires-install'
+                    ? MANAGED_CODEX_VERSION
+                    : manager.manager.version,
+            },
+        } : {}),
+    };
+}
+function batchReviewChanges(intent, evidence) {
+    const changes = evidence.groups.flatMap((group) => {
+        const representative = group.requestedPluginIds[0];
+        const groupEvidence = batchGroupEvidence(evidence, group);
+        const projected = reviewChanges({
+            kind: 'pluginWrite',
+            action: intent.action,
+            pluginId: representative,
+            platform: group.platform,
+            scope: intent.scope,
+            ...(intent.scriptTimeoutMs === undefined ? {} : { scriptTimeoutMs: intent.scriptTimeoutMs }),
+        }, groupEvidence);
+        const targetChanges = group.preview.targetResults.map((target) => {
+            const pluginId = target.target.pluginId ?? `${group.sourceId}/${target.target.pluginName}`;
+            const requested = group.requestedPluginIds.includes(pluginId);
+            return {
+                kind: intent.action === 'uninstall' || intent.action === 'cleanup' ? 'remove'
+                    : intent.action === 'install' ? 'add' : 'change',
+                group: requested ? 'requested' : 'dependencies',
+                pluginId,
+                relation: requested ? 'requested'
+                    : (target.requiredBy ?? []).some((plugin) => group.requestedPluginIds.includes(plugin))
+                        ? 'direct' : 'transitive',
+                title: pluginNameFromId(pluginId),
+                description: `${group.sourceId} · ${target.target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.target.scope === 'user' ? '所有项目' : '当前项目'}${target.state === 'failed' || target.action === 'skipped' ? ` · 无法执行${target.errorCode ? ` (${target.errorCode})` : ''}` : ''}`,
+            };
+        });
+        const effective = group.preview.dependencyPlan
+            ? projected
+            : [
+                ...targetChanges,
+                ...projected.filter((change) => change.group !== 'requested'
+                    && change.group !== 'dependencies'),
+            ];
+        return [
+            ...effective.filter((change) => change.title !== 'preApply 脚本超时')
+                .map((change) => ({
+                ...change,
+                batchGroupId: group.groupId,
+                sourceId: group.sourceId,
+            })),
+            ...(!group.executable ? [{
+                    kind: 'warning',
+                    group: 'portableWarnings',
+                    batchGroupId: group.groupId,
+                    sourceId: group.sourceId,
+                    title: `${group.sourceId} 组无法执行`,
+                    description: '确认后保留本次预览失败；不会重新求值或开始写入。',
+                }] : []),
+        ];
+    });
+    return [
+        ...scriptTimeoutChanges(intent),
+        ...changes,
+        { kind: 'keep', group: 'preserved', title: '插件设置保持不变' },
+    ];
+}
 function technicalDetails(evidence) {
     const short = (value) => {
         const normalized = value.startsWith('sha256:') ? value.slice(7) : value;
@@ -528,6 +759,13 @@ function technicalDetails(evidence) {
         `Catalog 配置：${short(evidence.catalog.configDigest)}`,
         `Catalog 组合：${short(evidence.catalog.compositeDigest)}`,
     ];
+    if ('groups' in evidence && Array.isArray(evidence.groups)) {
+        const batch = evidence;
+        details.push(`批量根插件：${batch.requestedPluginIds.length} 个`);
+        for (const group of batch.groups) {
+            details.push(`批量分组：${group.sourceId} · ${group.platform} · ${group.requestedPluginIds.length} 个根插件 · ${group.executable ? `计划 ${short(group.preview.operationPlan.planFingerprint)}` : '预览失败'}`);
+        }
+    }
     if (evidence.catalog.generationSetDigest) {
         details.push(`Catalog generation：${short(evidence.catalog.generationSetDigest)}`);
     }
@@ -576,14 +814,32 @@ function technicalDetails(evidence) {
 }
 export function buildOperationReviewProjection(options) {
     const { intent, evidence } = options;
+    const batchEvidence = intent.kind === 'pluginWriteBatch'
+        ? evidence
+        : undefined;
     const labels = operationLabels(intent, evidence);
-    const requiresConfirmation = (evidence.codexReconcilePlans ?? []).some((plan) => plan.review.requiresConfirmation)
+    const hasPreApply = intent.kind === 'pluginWriteBatch'
+        ? Boolean(batchEvidence?.groups.some((group) => operationPreApplyTargets(batchGroupEvidence(batchEvidence, group)).length > 0))
+        : operationPreApplyTargets(evidence).length > 0
+            || (evidence.config?.preApplyAuthorization?.length ?? 0) > 0;
+    const sharedNativeConfigApply = intent.kind === 'configSave'
+        && intent.apply
+        && (evidence.config?.sharedNativeRenderTargets?.length ?? 0) > 0
+        && (evidence.config?.affectedTargets.some((target) => target.platform === 'codex') ?? false);
+    const requiresConfirmation = sharedNativeConfigApply
+        || Boolean(batchEvidence?.groups.some((group) => (group.preview.codexReconcilePlans ?? []).some((plan) => plan.review.requiresConfirmation)))
+        || (evidence.codexReconcilePlans ?? []).some((plan) => plan.review.requiresConfirmation)
         || Boolean(evidence.sourceWrite
             && (!evidence.sourceWrite.inventoryComplete || evidence.sourceWrite.referenceCount > 0))
         || Boolean(evidence.catalogGeneration?.impact
             && (!evidence.catalogGeneration.impact.inventoryComplete
-                || evidence.catalogGeneration.impact.affectedReferences.length > 0));
-    const warning = (evidence.codexReconcilePlans ?? []).find((plan) => plan.review.sharedImpact.warning)?.review.sharedImpact.warning;
+                || evidence.catalogGeneration.impact.affectedReferences.length > 0))
+        || Boolean(evidence.catalogGeneration?.primaryImpact
+            && (!evidence.catalogGeneration.primaryImpact.inventoryComplete
+                || evidence.catalogGeneration.primaryImpact.affectedReferences.length > 0));
+    const warning = (evidence.codexReconcilePlans ?? []).find((plan) => plan.review.sharedImpact.warning)?.review.sharedImpact.warning
+        ?? batchEvidence?.groups.flatMap((group) => group.preview.codexReconcilePlans ?? [])
+            .find((plan) => plan.review.sharedImpact.warning)?.review.sharedImpact.warning;
     const preparationWarnings = (evidence.preparationWarnings ?? []).map(() => ({
         kind: 'warning',
         group: 'portableWarnings',
@@ -595,27 +851,38 @@ export function buildOperationReviewProjection(options) {
         description: labels.description,
         changes: [
             ...preparationWarnings,
-            ...reviewChanges(intent, evidence, options.dependencyOverview),
+            ...(intent.kind === 'pluginWriteBatch'
+                ? batchReviewChanges(intent, batchEvidence)
+                : reviewChanges(intent, evidence, options.dependencyOverview)),
         ],
         technicalDetails: technicalDetails(evidence),
         ...(intent.kind === 'pluginWrite'
-            ? { equivalentCommand: `aw ${intent.action === 'refreshAndSync' ? 'sync' : intent.action} ${intent.pluginId} --platform ${intent.platform} --scope ${intent.scope}${intent.action === 'refreshAndSync' ? ' --refresh' : ''}${(intent.dependencyScopeOverrides ?? []).map((override) => ` --dependency-scope ${override.pluginId}#${override.platform}=${override.scope}`).join('')}${intent.action === 'cleanup' && intent.force === true ? ' --force' : ''}${evidence.codexManager?.state === 'requires-install' ? ' --allow-managed-codex-install' : ''}${requiresConfirmation ? ' --yes' : ''}` }
+            ? { equivalentCommand: `aw ${intent.action === 'refreshAndSync' ? 'sync' : intent.action} ${intent.pluginId} --platform ${intent.platform} --scope ${intent.scope}${intent.action === 'refreshAndSync' ? ' --refresh' : ''}${scriptTimeoutChanges(intent).length > 0 ? ` --script-timeout ${parseScriptTimeoutMs(intent.scriptTimeoutMs ?? SCRIPT_TIMEOUT_DEFAULT_MS)}` : ''}${(intent.dependencyScopeOverrides ?? []).map((override) => ` --dependency-scope ${override.pluginId}#${override.platform}=${override.scope}`).join('')}${intent.action === 'cleanup' && intent.force === true ? ' --force' : ''}${evidence.codexManager?.state === 'requires-install' ? ' --allow-managed-codex-install' : ''}${requiresConfirmation || hasPreApply ? ' --yes' : ''}` }
             : {}),
-        primaryLabel: intent.kind === 'pluginWrite' && evidence.dependencyPlan
-            ? `${labels.primaryLabel} ${evidence.dependencyPlan.resolvedPluginIds.length} 个插件`
-            : labels.primaryLabel,
+        primaryLabel: intent.kind === 'pluginWriteBatch'
+            ? `${labels.primaryLabel} ${batchEvidence.requestedPluginIds.length} 个插件`
+            : intent.kind === 'pluginWrite' && evidence.dependencyPlan
+                ? `${labels.primaryLabel} ${evidence.dependencyPlan.resolvedPluginIds.length} 个插件`
+                : labels.primaryLabel,
         ...(labels.destructive ? { destructive: true } : {}),
         requiresConfirmation,
         sharedImpact: {
             pluginIds: [...new Set([
                     ...(evidence.codexReconcilePlans ?? []).flatMap((plan) => plan.review.sharedImpact.pluginIds),
+                    ...(batchEvidence?.groups.flatMap((group) => (group.preview.codexReconcilePlans ?? []).flatMap((plan) => plan.review.sharedImpact.pluginIds)) ?? []),
                     ...(evidence.sourceWrite?.impact?.affectedReferences ?? []).flatMap((reference) => reference.pluginId ? [reference.pluginId] : []),
                     ...(evidence.catalogGeneration?.impact?.affectedReferences ?? []).flatMap((reference) => reference.pluginId ? [reference.pluginId] : []),
+                    ...(evidence.catalogGeneration?.primaryImpact?.affectedReferences ?? []).flatMap((reference) => reference.pluginId ? [reference.pluginId] : []),
+                    ...(sharedNativeConfigApply && 'pluginId' in intent ? [intent.pluginId] : []),
                 ])],
             ...(warning ? { warning }
-                : requiresConfirmation && (evidence.sourceWrite || evidence.catalogGeneration?.impact)
-                    ? { warning: '确认来源影响后才会继续。未知影响不会按零处理。' }
-                    : {}),
+                : sharedNativeConfigApply
+                    ? { warning: '更新共享 Codex native 动态 Skill 会影响所有启用项目。' }
+                    : requiresConfirmation && (evidence.sourceWrite
+                        || evidence.catalogGeneration?.impact
+                        || evidence.catalogGeneration?.primaryImpact)
+                        ? { warning: '确认来源影响后才会继续。未知影响不会按零处理。' }
+                        : {}),
         },
     };
 }