dsh-config-manager 0.1.82 → 0.1.83

package/lib/index.d.ts

@@ -77,7 +77,7 @@ export declare const name = "config-manager";
 /** Services required before the engine can mount (present in every profile). */
 export declare const inject: string[];
 /** Plugin version, kept in sync with package.json ("version"). */
-export declare const PLUGIN_VERSION = "0.1.82";
+export declare const PLUGIN_VERSION = "0.1.83";
 /**
  * Star 引导弹窗指向的 GitHub 仓库（用户引导点 Star 的目标）。
  * 与 package.json 的 repository 字段保持一致；界面不可改（硬编码，参照

package/lib/index.js

@@ -136,7 +136,7 @@ export const name = 'config-manager';
 /** Services required before the engine can mount (present in every profile). */
 export const inject = ['settings', 'credentials'];
 /** Plugin version, kept in sync with package.json ("version"). */
-export const PLUGIN_VERSION = '0.1.82';
+export const PLUGIN_VERSION = '0.1.83';
 /** Plugin own package name — excluded from its own exported plugins list. */
 const PLUGIN_NAME = 'dsh-config-manager';
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-config-manager",
-  "version": "0.1.82",
+  "version": "0.1.83",
   "license": "MIT",
   "description": "Backup, restore, export, import, migrate and sync your DeepSeek Harness (DSH) configuration: settings, plugins, MCP servers, skills, agent presets and workspaces. One-click migration to another machine. DSH 配置一键备份、恢复、导出、导入、迁移与同步插件。",
   "icon": "./icon.svg",

package/src/client/ConfigManagerSection.tsx

@@ -34,6 +34,7 @@ import { CommandPalette } from './common/CommandPalette.tsx'
 import { TaskShell } from './task/TaskShell.tsx'
 import { LibraryPanel } from './library/LibraryPanel.tsx'
 import { LibraryActions } from './library/LibraryActions.tsx'
+import type { ArtifactPendingAction } from './library/ArtifactRow.tsx'
 import type { ArtifactCapability, ArtifactRow } from '../ui/artifact-view.ts'
 import { HomePanel } from './home/HomePanel.tsx'
 import { ExportView } from './export/ExportView.tsx'
@@ -156,6 +157,14 @@ const navLayoutResult = navWidths === null
   const [libraryAction, setLibraryAction] = useState<{ capability: ArtifactCapability; row: ArtifactRow } | null>(null)
   /** 产物列表刷新信号：恢复 / 删除 / 置顶完成后递增，让面板重拉四份清单 */
   const [libraryTick, setLibraryTick] = useState(0)
+  /**
+   * 产物库行内动作的进行中态（DESIGN §8.11「行内动作 pending」）。
+   * 动作实在 LibraryActions（面板的兄弟节点）里跑的，行的读点在 LibraryPanel ⇒
+   * 由动作上报到这里，再作为 prop 传回面板；行内按钮据此转圈/禁用。
+   * 放壳层（而不是面板或动作组件）还有一个好处：`pagePad` 带 key=panel，
+   * 切页会重挂面板，忙态若存面板里会随切页蒸发。
+   */
+  const [libraryPending, setLibraryPending] = useState<ArtifactPendingAction | null>(null)
 
   /**
    * 导入面板当前是否停在「从其它 agent 导入」这一页（t17）。
@@ -491,6 +500,7 @@ const navLayoutResult = navWidths === null
           onOpenExport={() => { openTask('export') }}
           onOpenPublish={() => { openTask('market', { subView: 'myconfigs' }) }}
           refreshTick={libraryTick}
+          pending={libraryPending}
         />
       )
       break
@@ -623,6 +633,7 @@ const navLayoutResult = navWidths === null
           target={libraryAction}
           onDone={() => { setLibraryAction(null) }}
           onChanged={() => { setLibraryTick((n) => n + 1) }}
+          onPendingChange={setLibraryPending}
           onOpenTask={(kind, marketId) => { openTask(kind, marketId === undefined ? undefined : { marketId }) }}
         />
         {activeTask !== null && (

package/src/client/common/MoreMenu.tsx

@@ -43,9 +43,15 @@ export interface MoreMenuProps {
   onSelect: (id: string) => void
   /** 按钮与菜单的无障碍名（如「更多页面」） */
   label: string
+  /**
+   * 禁用整个入口（产物库行内动作进行中时，其余动作一律不可点 —— DESIGN §8.11）。
+   * 禁用只拦行为、不换外观：行内的「在忙」提示由调用方另行渲染（那里换的是转圈 + 动作名），
+   * 这里只负责「点不开、键盘也打不开」。
+   */
+  disabled?: boolean
 }
 
-export function MoreMenu({ items, activeId, onSelect, label }: MoreMenuProps) {
+export function MoreMenu({ items, activeId, onSelect, label, disabled = false }: MoreMenuProps) {
   const [open, setOpen] = useState(false)
   const [active, setActive] = useState(-1)
   const [align, setAlign] = useState<'start' | 'end'>('start')
@@ -64,6 +70,7 @@ export function MoreMenu({ items, activeId, onSelect, label }: MoreMenuProps) {
   }
 
   const openMenu = (): void => {
+    if (disabled) return
     setActive(initialActiveIndex(options, activeId))
     setAlign(menuAlign(rootRef.current))
     setOpen(true)
@@ -76,6 +83,11 @@ export function MoreMenu({ items, activeId, onSelect, label }: MoreMenuProps) {
     close(true)
   }
 
+  // 打开期间变为禁用（如同行另一个动作开始跑）：菜单必须收起，否则它悬空在禁用按钮上方
+  useEffect(() => {
+    if (disabled && open) close(false)
+  }, [disabled, open])
+
   // 点击外部关闭：mousedown 比 click 早，且能覆盖右键与拖拽结束
   useEffect(() => {
     if (!open) return
@@ -101,6 +113,8 @@ export function MoreMenu({ items, activeId, onSelect, label }: MoreMenuProps) {
   }, [open, active])
 
   const onKeyDown = (event: ReactKeyboardEvent<HTMLButtonElement>): void => {
+    // 禁用态整块不响应键盘（按钮本身已 disabled，这是对「打开中突变为禁用」的兜底）
+    if (disabled) return
     switch (event.key) {
       case 'ArrowDown':
       case 'ArrowUp': {
@@ -164,7 +178,8 @@ export function MoreMenu({ items, activeId, onSelect, label }: MoreMenuProps) {
         aria-controls={open ? menuId : undefined}
         aria-label={label}
         title={label}
-        onClick={() => { if (open) close(false); else openMenu() }}
+        disabled={disabled}
+        onClick={() => { if (disabled) return; if (open) close(false); else openMenu() }}
         onKeyDown={onKeyDown}
       >
         {label}

package/src/client/config-manager.module.css

@@ -257,12 +257,19 @@ body {
   white-space: nowrap;
 }
 
-.navTab:hover,
-.navMore:hover {
+.navTab:hover:not(:disabled),
+.navMore:hover:not(:disabled) {
   color: var(--dsw-alias-label-primary);
   background: var(--dsw-alias-interactive-bg-hover);
 }
 
+/* 禁用态（产物库行内 ⋯：同一行有动作在跑时它不可点，DESIGN §8.11）——
+   与 .primaryButton:disabled 同一档视觉，避免出现第二套「灰掉」的样子 */
+.navMore:disabled {
+  opacity: 0.4;
+  cursor: default;
+}
+
 .navTab:focus-visible,
 .navMore:focus-visible {
   outline: var(--cm-focus-width) solid var(--cm-focus-color);

package/src/client/environment/EnvironmentPanel.tsx

@@ -35,7 +35,7 @@ import { runStore, toProfilesStoreSlice, type ProfilesStoreSlice } from '../run-
 import { RecoveryPanel } from '../recovery/RecoveryPanel.tsx'
 import type { RecoveryPort } from '../../ui/types.ts'
 import type { IncidentApi } from '../recovery/incident-api.ts'
-import { Badge, Banner, Button, Card, Checkbox, Empty, SectionTitle, Segmented, Spinner } from '../common/ui.tsx'
+import { Badge, Banner, Button, Card, Checkbox, Empty, SectionTitle, Segmented } from '../common/ui.tsx'
 import { InfoHint } from '../common/InfoHint.tsx'
 import { Skeleton, SkeletonList } from '../common/Skeleton.tsx'
 import { Select } from '../common/Select.tsx'
@@ -465,9 +465,10 @@ export function EnvironmentPanel({ api, t, recoveryApi, recoveryT, incidentApi }
               variant="ghost"
               disabled={state.stopping !== null || record.current}
               title={record.current ? t('profiles.stop.currentHint') : record.owned ? t('profiles.stop.hint') : t('profiles.stop.hintExternal')}
+              loading={state.stopping === record.name}
               onClick={() => { patch({ stopTargetName: record.name, error: null }) }}
             >
-              {state.stopping === record.name ? <Spinner label={t('profiles.stopping')} /> : t('profiles.stop')}
+              {t('profiles.stop')}
             </Button>
           </div>
         ))}
@@ -561,8 +562,8 @@ export function EnvironmentPanel({ api, t, recoveryApi, recoveryT, incidentApi }
               label: `${template.id} — ${template.bundles.join(' + ')}`,
             }))}
           />
-          <Button variant="primary" disabled={state.creating || state.createName.trim() === '' || createIssue !== null} onClick={doCreate}>
-            {state.creating ? <Spinner label={t('profiles.create.creating')} /> : t('profiles.create.action')}
+          <Button variant="primary" loading={state.creating} disabled={state.createName.trim() === '' || createIssue !== null} onClick={doCreate}>
+            {t('profiles.create.action')}
           </Button>
         </div>
         {createIssue !== null && <span className={css.formError}>{nameIssueText(t, state.createName.trim(), createIssue)}</span>}
@@ -661,10 +662,11 @@ export function EnvironmentPanel({ api, t, recoveryApi, recoveryT, incidentApi }
                         <Button
                           size="sm"
                           title={runningRecord.owned ? t('profiles.stop.hint') : t('profiles.stop.hintExternal')}
+                          loading={state.stopping === profile.name}
                           disabled={state.stopping !== null}
                           onClick={() => { patch({ stopTargetName: runningRecord.name, error: null }) }}
                         >
-                          {state.stopping === profile.name ? <Spinner label={t('profiles.stopping')} /> : t('profiles.stop')}
+                          {t('profiles.stop')}
                         </Button>
                       )}
                       {caps.launchOrStop && rowAction === 'launch' && (
@@ -672,10 +674,11 @@ export function EnvironmentPanel({ api, t, recoveryApi, recoveryT, incidentApi }
                           size="sm"
                           variant="primary"
                           title={canLaunchProfile(profile) ? t('profiles.launch.hint') : launchBlockReason(profile) === 'managed' ? t('profiles.launch.managed', { name: profile.name }) : t('profiles.launch.notWeb', { name: profile.name })}
+                          loading={state.launching === profile.name}
                           disabled={state.launching !== null || state.stopping !== null}
                           onClick={() => { doLaunch(profile) }}
                         >
-                          {state.launching === profile.name ? <Spinner label={t('profiles.launching')} /> : t('profiles.launch')}
+                          {t('profiles.launch')}
                         </Button>
                       )}
                       {caps.duplicate && (

package/src/client/export/ExportView.tsx

@@ -37,7 +37,7 @@ import type { TranslateNS } from '../client-types.ts'
 import { resolveFailedSections } from '../api.ts'
 import type { ConfigManagerApi, ExportPreviewResponse } from '../api.ts'
 import { runStore } from '../run-store.ts'
-import { Banner, Button, Card, Checkbox, Spinner } from '../common/ui.tsx'
+import { Banner, Button, Card, Checkbox } from '../common/ui.tsx'
 import { ContentPicker } from '../common/ContentPicker.tsx'
 import { SectionComposition } from '../common/SectionComposition.tsx'
 import { sectionLabel, sectionLabeler } from '../common/section-labels.ts'
@@ -376,13 +376,14 @@ export function ExportView({ api, t }: ExportViewProps) {
             且**「开始导出」在前、「选择要导出的内容」在后**（主操作在左，选择内容在它右边）。 */}
         <Button
           variant="primary"
-          disabled={running || passwordInvalid || fileNameInvalid || nothingSelected}
+          loading={running}
+          disabled={passwordInvalid || fileNameInvalid || nothingSelected}
           onClick={() => { void runExport() }}
         >
-          {running ? <Spinner /> : t('export.run')}
+          {t('export.run')}
         </Button>
-        <Button size="sm" disabled={running} title={t('picker.title')} onClick={openPicker}>
-          {invLoading ? <Spinner /> : <PreviewIcon size={13} />} {t('picker.title')}
+        <Button size="sm" loading={invLoading} disabled={running} title={t('picker.title')} onClick={openPicker}>
+          {invLoading ? null : <PreviewIcon size={13} />} {t('picker.title')}
         </Button>
         {/* 工具栏「模式提示」属「机制怎么工作 + 省事提示」（MOVE 类）：收进 ⓘ，
             不再常驻占首屏一行（默认导出推荐分区 + 去哪里调整勾选）。 */}

package/src/client/history/HistoryPanel.tsx

@@ -42,6 +42,12 @@ interface PanelState {
   filter: HistoryFilter
   /** 导出中的格式（瞬态；结果反馈走全局 Toast，不再占页内一行灰字） */
   exporting: 'json' | 'markdown' | null
+  /**
+   * 「刷新」专用进行中态：**列表已经在了**，此时不该把它打回骨架
+   * （DESIGN UI-25 ②：页面必须不掉 —— 内容闪一下骨架会被读成「我刚筛好的东西没了」）。
+   * 首次加载仍走 status='loading' 的骨架分支。
+   */
+  refreshing: boolean
 }
 
 export function HistoryPanel({ historyApi, t }: HistoryPanelProps) {
@@ -51,6 +57,7 @@ export function HistoryPanel({ historyApi, t }: HistoryPanelProps) {
     result: null,
     filter: { query: '' },
     exporting: null,
+    refreshing: false,
   })
   const mounted = useRef(true)
   useEffect(() => {
@@ -58,13 +65,27 @@ export function HistoryPanel({ historyApi, t }: HistoryPanelProps) {
     return () => { mounted.current = false }
   }, [])
 
-  const load = async (): Promise<void> => {
-    setState((s) => ({ ...s, status: 'loading', error: null }))
+  /**
+   * 读列表。`quiet` = 页面上已有列表时的「刷新」：
+   * 不复位 status（否则整页回骨架、已筛好的清单在眼前消失），只点亮按钮自己的 loading；
+   * 失败也不清列表，改为 toast —— 旧数据仍在屏上，比空白页有用。
+   */
+  const load = async (quiet = false): Promise<void> => {
+    if (quiet) setState((s) => ({ ...s, refreshing: true, error: null }))
+    else setState((s) => ({ ...s, status: 'loading', error: null }))
     try {
       const result = await historyApi.list()
-      if (mounted.current) setState((s) => ({ ...s, status: 'ready', result }))
+      if (mounted.current) setState((s) => ({ ...s, status: 'ready', refreshing: false, result }))
     } catch (error) {
-      if (mounted.current) setState((s) => ({ ...s, status: 'error', error: error instanceof Error ? error.message : String(error) }))
+      const message = error instanceof Error ? error.message : String(error)
+      if (mounted.current) {
+        if (quiet) {
+          setState((s) => ({ ...s, refreshing: false }))
+          toast.error(`${t('history.refreshError')}: ${redact(message)}`)
+        } else {
+          setState((s) => ({ ...s, status: 'error', refreshing: false, error: message }))
+        }
+      }
     }
   }
   useEffect(() => { void load() }, [historyApi]) // eslint-disable-line react-hooks/exhaustive-deps
@@ -182,7 +203,13 @@ export function HistoryPanel({ historyApi, t }: HistoryPanelProps) {
             value={state.filter.query}
             onChange={(e) => setFilter({ query: e.target.value })}
           />
-          <Button onClick={() => void load()}>{t('history.refresh')}</Button>
+          <Button
+            onClick={() => void load(true)}
+            loading={state.refreshing}
+            disabled={state.refreshing}
+          >
+            {t('history.refresh')}
+          </Button>
           <Button
             onClick={() => void handleExport('json')}
             disabled={state.exporting !== null || summary.total === 0}

package/src/client/history/history-locales.ts

@@ -42,6 +42,7 @@ type CommonKey =
   | 'history.table.summary'
   | 'history.updatedAt'
   | 'history.refresh'
+  | 'history.refreshError'
   /** ⓘ 说明按钮的可访问名（与主字典 / market / sync / recovery 同口径，见 info-hint-guard t6-4） */
   | 'common.infoHint';
 
@@ -83,6 +84,7 @@ export const zh = {
   'history.table.summary': '摘要',
   'history.updatedAt': '更新于',
   'history.refresh': '刷新',
+  'history.refreshError': '刷新失败',
   'history.kind.import': '导入',
   'history.kind.restore': '快照恢复',
   'history.kind.rollback': '回滚',
@@ -141,6 +143,7 @@ export const en = {
   'history.table.summary': 'Summary',
   'history.updatedAt': 'Updated',
   'history.refresh': 'Refresh',
+  'history.refreshError': 'Refresh failed',
   'history.kind.import': 'Import',
   'history.kind.restore': 'Snapshot restore',
   'history.kind.rollback': 'Rollback',

package/src/client/home/BackupScheduleCard.tsx

@@ -34,7 +34,7 @@ import { describeSkipReason } from '../sync/history-model.ts'
 import { runStore } from '../run-store.ts'
 import type { ConfigManagerApi } from '../api.ts'
 import type { TranslateNS } from '../client-types.ts'
-import { Badge, Banner, Button, Card, Checkbox, Spinner, StatusDot } from '../common/ui.tsx'
+import { Badge, Banner, Button, Card, Checkbox, StatusDot } from '../common/ui.tsx'
 import { Select } from '../common/Select.tsx'
 import { Skeleton } from '../common/Skeleton.tsx'
 import { InfoHint } from '../common/InfoHint.tsx'
@@ -221,14 +221,15 @@ export function BackupScheduleCard({ api, t, syncT, onBackupDone }: BackupSchedu
         <Button
           variant="primary"
           size="sm"
-          disabled={busy || !dirty}
+          loading={saving}
+          disabled={running || !dirty}
           onClick={save}
           title={dirty ? undefined : t('backupSchedule.saved')}
         >
-          {saving ? <Spinner /> : t('backupSchedule.save')}
+          {t('backupSchedule.save')}
         </Button>
-        <Button size="sm" disabled={busy || !(saved?.enabled ?? false)} onClick={runNow}>
-          {running ? <Spinner /> : t('backupSchedule.runNow')}
+        <Button size="sm" loading={running} disabled={saving || !(saved?.enabled ?? false)} onClick={runNow}>
+          {t('backupSchedule.runNow')}
         </Button>
       </div>
 

package/src/client/home/HomePanel.tsx

@@ -45,7 +45,7 @@ import {
   relTime,
   type OverviewMetricKey,
 } from '../../ui/overview-view.ts'
-import { Badge, Banner, Button, Card, Spinner, StatusDot, Stepper } from '../common/ui.tsx'
+import { Badge, Banner, Button, Card, StatusDot, Stepper } from '../common/ui.tsx'
 import { SkeletonRows } from '../common/Skeleton.tsx'
 import { BackupIcon, ExportIcon, ImportIcon, SyncIcon } from '../common/Icon.tsx'
 import { CopyButton } from '../common/CopyButton.tsx'
@@ -372,11 +372,11 @@ export function HomePanel({ api, syncApi, historyApi, t, syncT, openForeignImpor
       <div className={css.toolRow}>
         <Button
           variant="primary"
-          disabled={backupRunning}
+          loading={backupRunning}
           title={t('overview.quick.backupTitle')}
           onClick={() => { void runBackupNow() }}
         >
-          {backupRunning ? <Spinner /> : <BackupIcon size={14} />} {t('overview.quick.backup')}
+          {backupRunning ? null : <BackupIcon size={14} />} {t('overview.quick.backup')}
         </Button>
         <Button title={t('overview.quick.exportTitle')} onClick={openExportTask}>
           <ExportIcon size={14} /> {t('nav.export')} ZIP

package/src/client/import/ForeignImportView.tsx

@@ -29,7 +29,7 @@ import type { TranslateNS } from '../client-types.ts'
 import type { ConfigManagerApi, ForeignImportResponse } from '../api.ts'
 import type { UiT } from '../../ui/i18n.ts'
 import { foreignLossyRows, foreignPathsText, foreignSourcesViewModel, type ForeignSourceRow } from '../../ui/foreign-view.ts'
-import { Badge, Banner, Button, Card, SectionTitle, Spinner } from '../common/ui.tsx'
+import { Badge, Banner, Button, Card, SectionTitle } from '../common/ui.tsx'
 import { SkeletonList } from '../common/Skeleton.tsx'
 import { InfoHint } from '../common/InfoHint.tsx'
 import { ErrorBanner } from '../common/ErrorBanner.tsx'
@@ -310,8 +310,8 @@ export function ForeignImportView({ api, t, uiT, onReady }: ForeignImportViewPro
         <Button onClick={handleRefresh} disabled={importing}>
           {t('foreign.action.refresh')}
         </Button>
-        <Button variant="primary" onClick={() => { void runImport() }} disabled={importing || selected === null}>
-          {importing ? <Spinner label={t('foreign.importing')} /> : t('foreign.action.import')}
+        <Button variant="primary" loading={importing} onClick={() => { void runImport() }} disabled={selected === null}>
+          {t('foreign.action.import')}
         </Button>
       </div>
     </div>

package/src/client/import/import-wizard-steps.tsx

@@ -13,7 +13,7 @@ import type { ConsultReport } from '../../core/migration-consult.ts'
 import type { TranslateNS } from '../client-types.ts'
 import type { UiT } from '../../ui/i18n.ts'
 import {
-  Banner, Button, Card, Checkbox, Empty, SectionTitle, Spinner,
+  Banner, Button, Card, Checkbox, Empty, SectionTitle,
 } from '../common/ui.tsx'
 import { Skeleton } from '../common/Skeleton.tsx'
 import { InfoHint } from '../common/InfoHint.tsx'
@@ -133,10 +133,10 @@ export function SelectStep(props: {
         )}
         <Button
           variant="primary"
-          disabled={uploading}
+          loading={uploading}
           onClick={() => { fileInput.current?.click() }}
         >
-          {uploading ? <Spinner label={t('import.analyzing')} /> : t(browseLabelKey(selectModel.selectedName !== null))}
+          {t(browseLabelKey(selectModel.selectedName !== null))}
         </Button>
       </div>
       {error !== null && <ErrorBanner error={error} onRetry={onReset} t={apiT} />}
@@ -228,10 +228,11 @@ export function DecryptArchiveStep(props: {
         <Button variant="ghost" onClick={onReset}>{t('import.select.reselect')}</Button>
         <Button
           variant="primary"
-          disabled={password === '' || unlocking}
+          loading={unlocking}
+          disabled={password === ''}
           onClick={onUnlock}
         >
-          {unlocking ? <Spinner label={t('import.decryptArchive.unlocking')} /> : t('import.decryptArchive.unlock')}
+          {t('import.decryptArchive.unlock')}
         </Button>
       </div>
     </div>

package/src/client/library/ArtifactRow.tsx

@@ -18,7 +18,7 @@ import {
 } from '../../ui/artifact-view.ts'
 import type { UiT } from '../../ui/i18n.ts'
 import type { TranslateNS } from '../client-types.ts'
-import { Badge, Button } from '../common/ui.tsx'
+import { Badge, Button, Spinner } from '../common/ui.tsx'
 import { ExpandChevron } from '../common/Icon.tsx'
 import { MoreMenu } from '../common/MoreMenu.tsx'
 import { ArtifactDetail } from './ArtifactDetail.tsx'
@@ -32,6 +32,17 @@ const BADGE_KIND: Record<ArtifactBadge, 'info' | 'ok' | 'warn' | 'error'> = {
   'unreadable': 'error',
 }
 
+/**
+ * 行内动作的**进行中态**：哪一行的哪个动作正在跑。
+ * 生产者 = LibraryActions（动作实现处），持有者 = 壳层，消费者 = LibraryPanel → ArtifactRowView。
+ * 三处共用这一个类型，避免各写一份结构而漂移（此前正是「写了 busy 却没人读」）。
+ */
+export interface ArtifactPendingAction {
+  /** 行的稳定键（ArtifactRow.key） */
+  key: string
+  capability: ArtifactCapability
+}
+
 export interface ArtifactRowViewProps {
   row: ArtifactRow
   t: TranslateNS<'config-manager'>
@@ -41,8 +52,14 @@ export interface ArtifactRowViewProps {
   expanded: boolean
   onToggle: () => void
   onAction: (capability: ArtifactCapability, row: ArtifactRow) => void
-  /** 该行有动作在跑：禁用行内按钮（防重复提交） */
-  busy?: boolean
+  /**
+   * 该行**正在进行中的那个动作**（DESIGN.md §8.11「行内动作 pending」/ UI-25）。
+   * null = 空闲。有值时就地给可见反馈并禁用其余入口（防连点）。
+   *
+   * 为什么不是 boolean：走 ⋯ 菜单的动作在跑时，触发器已被换成「转圈 + 该动作文案」，
+   * 否则用户只看到「更多」位置上冒出个圈，根本不知道跑的是刚点的那条。
+   */
+  pending?: ArtifactCapability | null
   /**
    * cloud-sync 借鉴项 ⑥：该行远端快照的**推送方设备**文案（如「由 <设备名> 推送」）。
    * 只有快照 manifest 真的带 deviceName 时才由调用方给出 —— 缺省 undefined 表示**不渲染**
@@ -52,12 +69,20 @@ export interface ArtifactRowViewProps {
 }
 
 export function ArtifactRowView({
-  row, t, uiT, formatTime, expanded, onToggle, onAction, busy = false, deviceLabel,
+  row, t, uiT, formatTime, expanded, onToggle, onAction, pending = null, deviceLabel,
 }: ArtifactRowViewProps) {
   const detailId = useId()
   const primary = row.capabilities[0]
   const rest = row.capabilities.slice(1)
   const encrypted = row.badges.includes('encrypted')
+  /**
+   * 三态：空闲 / 主操作在跑 / 某个 ⋯ 动作在跑。
+   * 主操作在跑 → 按钮自己 loading（Button 原语给图标），⋯ 整块禁用；
+   * ⋯ 动作在跑 → ⋯ 触发器换成「转圈 + 该动作文案」，主操作禁用。
+   * 两条路的共同点：**同一时刻只允许一个动作**（此前这里完全没有反馈，可以连点）。
+   */
+  const pendingPrimary = primary !== undefined && pending === primary
+  const pendingRest = rest.find((capability) => capability === pending)
   const name = row.title.kind === 'text' ? row.title.value : formatTime(row.title.iso)
   /** 加密徽章的可访问说明（「导入前需解锁」= 安全类文案，必须可见可读，不能只靠颜色） */
   const encryptedHint = t('backupFiles.encryptedHint')
@@ -103,20 +128,27 @@ export function ArtifactRowView({
             <Button
               size="sm"
               variant={primary === 'delete' ? 'danger' : 'primary'}
-              disabled={busy}
+              // 进行中图标由 Button 原语按 loading 自动渲染（DESIGN §14.11：不要手写 Spinner）
+              loading={pendingPrimary}
+              disabled={pending !== null && !pendingPrimary}
               onClick={() => { onAction(primary, row) }}
             >
               {actionLabel(primary, encrypted, uiT)}
             </Button>
           )}
-          {rest.length > 0 && (
+          {rest.length > 0 && (pendingRest === undefined ? (
             <MoreMenu
               items={rest.map((capability) => ({ id: capability, label: actionLabel(capability, encrypted, uiT) }))}
               activeId=""
               onSelect={(id) => { onAction(id as ArtifactCapability, row) }}
               label={t('library.moreActions')}
+              disabled={pending !== null}
             />
-          )}
+          ) : (
+            /* 走 ⋯ 的动作在跑：菜单已收起，把触发器原地换成「转圈 + 该动作文案」——
+               只留一个圈的话，用户看不出跑的是「下载」还是「迁移前咨询」 */
+            <Spinner label={actionLabel(pendingRest, encrypted, uiT)} />
+          ))}
         </div>
       </div>
       {/* **始终挂载**：展开/收回由 data-expanded 驱动 CSS 过渡。