dsh-config-manager 0.1.12 → 0.1.13

package/src/client/snapshots/SnapshotsPanel.tsx

@@ -0,0 +1,240 @@
+/**
+ * 快照恢复面板（M4）：列出快照 → 选择 → dry-run 计划预览 → 确认执行 → 诚实报告。
+ *
+ * 数据流：api.snapshots() 加载列表；选择快照后 api.restoreSnapshot(id, true) 拿
+ * 恢复计划（零写入预览）；确认后 api.restoreSnapshot(id, false) 执行并展示报告
+ * （restored / removedPlugins / manualHints（人工项高亮）/ failed / skipped）。
+ * 全部状态组件内自持：恢复是低频显式操作，不进入 sessionStorage（快照列表可随时重载）。
+ */
+import { useEffect, useState } from 'react'
+import type { ReactNode } from 'react'
+import type { RestorePlan, RestoreReport, SnapshotMeta } from '../../core/restore.ts'
+import type { ConfigManagerApi } from '../api.ts'
+import type { TranslateNS } from '../client-types.ts'
+import { Badge, Banner, Button, Card, Empty, SectionTitle, Spinner } from '../common/ui.tsx'
+import css from '../config-manager.module.css'
+
+export interface SnapshotsPanelProps {
+  api: ConfigManagerApi
+  t: TranslateNS<'config-manager'>
+}
+
+interface PanelState {
+  status: 'loading' | 'ready' | 'error'
+  error: string | null
+  metas: SnapshotMeta[]
+  selectedId: string | null
+  planning: boolean
+  plan: RestorePlan | null
+  running: boolean
+  report: RestoreReport | null
+  actionError: string | null
+}
+
+const initial: PanelState = {
+  status: 'loading',
+  error: null,
+  metas: [],
+  selectedId: null,
+  planning: false,
+  plan: null,
+  running: false,
+  report: null,
+  actionError: null,
+}
+
+function statusLabel(t: TranslateNS<'config-manager'>, status: SnapshotMeta['status']): string {
+  switch (status) {
+    case 'pending': return t('snapshots.status.pending')
+    case 'done': return t('snapshots.status.done')
+    case 'rolled-back': return t('snapshots.status.rolled-back')
+    default: return t('snapshots.status.unknown')
+  }
+}
+
+function statusBadgeKind(status: SnapshotMeta['status']): 'info' | 'ok' | 'warn' | 'error' {
+  switch (status) {
+    case 'pending': return 'info'
+    case 'done': return 'ok'
+    case 'rolled-back': return 'warn'
+    default: return 'error'
+  }
+}
+
+/** 计划动作的本地化描述前缀（kind 标签 + 引擎已生成的中文 description） */
+function actionKindLabel(kind: string): string {
+  switch (kind) {
+    case 'hostFileRestore': return '整文件还原'
+    case 'hostFileRemove': return '整文件删除'
+    case 'pluginRemove': return '卸载插件'
+    case 'fileRestore': return '还原文件'
+    case 'fileRemove': return '删除文件'
+    case 'credentialHint': return '人工提示'
+    case 'skip': return '跳过'
+    default: return kind
+  }
+}
+
+export function SnapshotsPanel({ api, t }: SnapshotsPanelProps) {
+  const [state, setState] = useState<PanelState>(initial)
+
+  const load = (): void => {
+    setState((s) => ({ ...s, status: 'loading', error: null }))
+    api.snapshots().then(
+      (metas) => { setState((s) => ({ ...s, status: 'ready', metas })) },
+      (err) => {
+        setState((s) => ({
+          ...s,
+          status: 'error',
+          error: err instanceof Error ? err.message : String(err),
+        }))
+      },
+    )
+  }
+
+  useEffect(load, [api])
+
+  const select = (id: string): void => {
+    setState((s) => ({ ...s, selectedId: id, plan: null, report: null, actionError: null, planning: true }))
+    api.restoreSnapshot(id, true).then(
+      (res) => { setState((s) => ({ ...s, planning: false, plan: res.plan ?? null })) },
+      (err) => {
+        setState((s) => ({
+          ...s,
+          planning: false,
+          actionError: err instanceof Error ? err.message : String(err),
+        }))
+      },
+    )
+  }
+
+  const execute = (): void => {
+    if (state.selectedId === null || state.running) return
+    setState((s) => ({ ...s, running: true, report: null, actionError: null }))
+    api.restoreSnapshot(state.selectedId, false).then(
+      (res) => { setState((s) => ({ ...s, running: false, report: res.report ?? null })) },
+      (err) => {
+        setState((s) => ({
+          ...s,
+          running: false,
+          actionError: err instanceof Error ? err.message : String(err),
+        }))
+      },
+    )
+  }
+
+  const summary = (): string => {
+    const s = state.plan?.summary
+    if (s === undefined) return ''
+    return `整文件还原 ${s.hostFileRestores} · 整文件删除 ${s.hostFileRemoves} · 插件卸载 ${s.pluginRemoves}`
+      + ` · 文件还原 ${s.fileRestores} · 文件删除 ${s.fileRemoves} · 凭据提示 ${s.credentialHints} · 跳过 ${s.skips}`
+  }
+
+  const reportLine = (title: string, items: string[], warn: boolean): ReactNode => {
+    if (items.length === 0) return null
+    return (
+      <Card className={css.card}>
+        <strong className={warn ? css.warnText : undefined}>{title}（{items.length}）</strong>
+        <ul className={css.reportList}>
+          {items.map((item, i) => <li key={`${title}-${i}`}>{item}</li>)}
+        </ul>
+      </Card>
+    )
+  }
+
+  return (
+    <div className={css.viewBody}>
+      <SectionTitle title={t('snapshots.title')} subtitle={t('snapshots.hint')} />
+
+      {state.status === 'loading' && <Spinner label={t('snapshots.loading')} />}
+
+      {state.status === 'error' && (
+        <Banner kind="error">
+          {state.error ?? t('common.unknownError')}
+          <Button variant="primary" onClick={load}>{t('common.retry')}</Button>
+        </Banner>
+      )}
+
+      {state.status === 'ready' && state.metas.length === 0 && (
+        <Empty>{t('snapshots.empty')}</Empty>
+      )}
+
+      {state.status === 'ready' && state.metas.length > 0 && (
+        <>
+          <div className={css.snapshotList} role="listbox" aria-label={t('snapshots.selectHint')}>
+            <div className={css.snapshotRowHeader}>
+              <span>{t('snapshots.createdAt')}</span>
+              <span>{t('snapshots.sourceZip')}</span>
+              <span>{t('snapshots.status')}</span>
+              <span>{t('snapshots.entries')}</span>
+              <span>{t('snapshots.plugins')}</span>
+            </div>
+            {state.metas.map((meta) => {
+              const selected = meta.id === state.selectedId
+              return (
+                <button
+                  key={meta.id}
+                  type="button"
+                  role="option"
+                  aria-selected={selected}
+                  data-active={selected ? '' : undefined}
+                  className={css.snapshotRow}
+                  onClick={() => { select(meta.id) }}
+                >
+                  <span title={meta.id}>{new Date(meta.createdAt).toLocaleString()}</span>
+                  <span title={meta.sourceZip}>{meta.sourceZip}</span>
+                  <span><Badge kind={statusBadgeKind(meta.status)}>{statusLabel(t, meta.status)}</Badge></span>
+                  <span>{meta.entryCount}</span>
+                  <span>{meta.beforePluginCount}</span>
+                </button>
+              )
+            })}
+          </div>
+
+          {state.selectedId !== null && (
+            <>
+              {state.planning && <Spinner label={t('common.loading')} />}
+              {state.plan !== null && (
+                <Card>
+                  <SectionTitle title={t('snapshots.planTitle')} subtitle={summary()} />
+                  {state.plan.actions.length === 0 && <Empty>{t('snapshots.noActions')}</Empty>}
+                  <ul className={css.reportList}>
+                    {state.plan.actions.map((action, i) => (
+                      <li key={`plan-${i}`}>
+                        <span className={css.kindTag}>{actionKindLabel(action.kind)}</span>
+                        {' '}{action.description}
+                        {action.detail !== undefined && <span className={css.hint}>（{action.detail}）</span>}
+                      </li>
+                    ))}
+                  </ul>
+                  <div className={css.rowActions}>
+                    <Button
+                      variant="danger"
+                      disabled={state.running || state.plan.actions.every((a) => a.kind === 'skip')}
+                      onClick={execute}
+                      title={t('snapshots.confirmRestore')}
+                    >
+                      {state.running ? t('snapshots.executing') : t('snapshots.execute')}
+                    </Button>
+                  </div>
+                  {state.actionError !== null && <Banner kind="error">{state.actionError}</Banner>}
+                </Card>
+              )}
+            </>
+          )}
+
+          {state.report !== null && (
+            <>
+              <SectionTitle title={t('snapshots.reportTitle')} />
+              {reportLine(t('snapshots.restored'), state.report.restored, false)}
+              {reportLine(t('snapshots.removedPlugins'), state.report.removedPlugins, false)}
+              {reportLine(t('snapshots.manualHints'), state.report.manualHints, true)}
+              {reportLine(t('snapshots.failed'), state.report.failed.map((f) => `${f.item}: ${f.reason}`), true)}
+              {reportLine(t('snapshots.skipped'), state.report.skipped, false)}
+            </>
+          )}
+        </>
+      )}
+    </div>
+  )
+}

package/src/client/sync/SyncSettingsView.tsx

@@ -0,0 +1,261 @@
+/**
+ * 远程同步设置区块（settings.section: config-manager-sync）。
+ *
+ * 独立 settings 页（不触碰并行会话的 ConfigManagerSection.tsx 三 tab 容器）：
+ * - 仓库配置表单：repoUrl（必填）+ 认证 token（可选，写入 DSH credentials 的提示）
+ *   + gitBin（可选）；
+ * - 私有仓库强制提示横幅（常驻）；
+ * - 推送按钮 → SyncPushReport（快照 id / 分区 / 告警）；
+ * - 拉取按钮 → SyncPullReport.changes 差异摘要（description/kind/severity）+
+ *   「预览不执行导入」提示；needsReview 高亮（v1 不做完整导入接线）；
+ * - 状态行：凭据配置 + 上次同步时间 + 通道（来自 GET /sync/status，组件挂载时加载）。
+ *
+ * 全部渲染模型来自 ./sync-view.ts 纯函数（node 单测覆盖），组件只做装配；
+ * 状态组件内自持（低频显式操作，同 SnapshotsPanel 策略，不进 sessionStorage）；
+ * token 仅内存（state），成功后清空（已写入 DSH credentials），绝不持久化。
+ */
+import { useEffect, useState } from 'react'
+import type { ChangeEvent } from 'react'
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import type { TranslateNS } from '../client-types.ts'
+import type { SyncPullReport, SyncPushReport } from '../../sync/sync-engine.ts'
+import { Badge, Banner, Button, Card, SectionTitle, Spinner } from '../common/ui.tsx'
+import { ErrorBanner } from '../common/ErrorBanner.tsx'
+import { SYNC_CREDENTIAL_REF } from './sync-api.ts'
+import type { SyncApi, SyncStatusResponse } from './sync-api.ts'
+import {
+  PRIVATE_REPO_HINT, computeSyncButtons, computeSyncStatus, kindLabel,
+  pullReportView, pushReportView, severityLabel,
+} from './sync-view.ts'
+import css from '../config-manager.module.css'
+
+export interface SyncSettingsSectionInjected {
+  api: SyncApi
+}
+
+export type SyncSettingsViewProps =
+  & PropsRuntime<'settings.section'>
+  & SyncSettingsSectionInjected
+  & { t: TranslateNS<'config-manager-sync'> }
+
+interface SyncUiState {
+  loading: boolean
+  loadError: string | null
+  statusInfo: SyncStatusResponse | null
+  repoUrl: string
+  gitBin: string
+  /** 仅内存：成功后清空（已写入 DSH credentials），绝不持久化 */
+  token: string
+  busy: 'push' | 'pull' | null
+  pushReport: SyncPushReport | null
+  pullReport: SyncPullReport | null
+  error: string | null
+}
+
+const initial: SyncUiState = {
+  loading: true,
+  loadError: null,
+  statusInfo: null,
+  repoUrl: '',
+  gitBin: '',
+  token: '',
+  busy: null,
+  pushReport: null,
+  pullReport: null,
+  error: null,
+}
+
+export function SyncSettingsView({ close, api, t }: SyncSettingsViewProps) {
+  const [state, setState] = useState<SyncUiState>(initial)
+  const patch = (p: Partial<SyncUiState>): void => setState((s) => ({ ...s, ...p }))
+
+  /** 挂载时读取同步状态（配置回填 + 上次同步时间 + 凭据状态） */
+  const loadStatus = async (): Promise<void> => {
+    patch({ loading: true, loadError: null })
+    try {
+      const info = await api.status()
+      patch({ loading: false, statusInfo: info, repoUrl: info.repoUrl ?? '', gitBin: info.gitBin ?? '' })
+    } catch (err) {
+      patch({ loading: false, loadError: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  useEffect(() => {
+    void loadStatus()
+    // api 为注入单例（注册时创建），生命周期内稳定；仅挂载时加载一次
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [])
+
+  /** 表单快照 → 请求体（token 为空串不携带；gitBin 空串不携带） */
+  const payload = (): { repoUrl: string; gitBin?: string; token?: string } => ({
+    repoUrl: state.repoUrl.trim(),
+    gitBin: state.gitBin.trim() !== '' ? state.gitBin.trim() : undefined,
+    token: state.token.trim() !== '' ? state.token : undefined,
+  })
+
+  const runPush = async (): Promise<void> => {
+    patch({ busy: 'push', error: null, pushReport: null, pullReport: null })
+    try {
+      const report = await api.push(payload())
+      // 成功即清空 token（已安全写入 DSH credentials）；失败保留以便重试
+      patch({ busy: null, pushReport: report, token: report.ok ? '' : state.token })
+    } catch (err) {
+      patch({ busy: null, error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  const runPull = async (): Promise<void> => {
+    patch({ busy: 'pull', error: null, pullReport: null, pushReport: null })
+    try {
+      const report = await api.pull(payload())
+      patch({ busy: null, pullReport: report, token: '' })
+    } catch (err) {
+      patch({ busy: null, error: err instanceof Error ? err.message : String(err) })
+    }
+  }
+
+  const status = computeSyncStatus(state.statusInfo, state.loading, state.loadError)
+  const buttons = computeSyncButtons(state.busy, state.repoUrl)
+  const pushView = pushReportView(state.pushReport)
+  const pullView = pullReportView(state.pullReport)
+
+  return (
+    <div className={css.section}>
+      <div className={css.sectionHeader}>
+        <div className={css.viewTabs}>
+          <span role="tab" aria-selected="true" data-active className={css.viewTab}>{t('section.label')}</span>
+        </div>
+        <button type="button" className={css.iconButton} title={t('common.close')} aria-label={t('common.close')} onClick={close}>×</button>
+      </div>
+      <div className={css.sectionBody}>
+        <div className={css.viewBody}>
+          <SectionTitle title={t('section.label')} subtitle={t('section.description')} />
+
+          {/* 私有仓库强制提示 */}
+          <Banner kind="warn">{PRIVATE_REPO_HINT}</Banner>
+
+          {/* 仓库配置 */}
+          <Card>
+            <span className={css.groupLabel}>{t('config.title')}</span>
+            <label className={css.field}>
+              <span className={css.fieldLabel}>{t('config.repoUrl')}</span>
+              <input
+                type="text"
+                className={css.input}
+                value={state.repoUrl}
+                placeholder="https://github.com/user/private-repo.git"
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLInputElement>) => { patch({ repoUrl: e.target.value }) }}
+              />
+              <span className={css.hint}>{t('config.repoUrlHint')}</span>
+            </label>
+            <label className={css.field}>
+              <span className={css.fieldLabel}>
+                {t('config.token')}
+                {' '}
+                {state.statusInfo?.credentialConfigured === true && <Badge kind="ok">{t('config.tokenSaved')}</Badge>}
+              </span>
+              <input
+                type="password"
+                className={css.input}
+                value={state.token}
+                autoComplete="off"
+                placeholder="ghp_…（可选）"
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLInputElement>) => { patch({ token: e.target.value }) }}
+              />
+              <span className={css.hint}>{t('config.tokenHint', { ref: SYNC_CREDENTIAL_REF })}</span>
+            </label>
+            <label className={css.field}>
+              <span className={css.fieldLabel}>{t('config.gitBin')}</span>
+              <input
+                type="text"
+                className={css.input}
+                value={state.gitBin}
+                placeholder="git"
+                disabled={state.busy !== null}
+                onChange={(e: ChangeEvent<HTMLInputElement>) => { patch({ gitBin: e.target.value }) }}
+              />
+              <span className={css.hint}>{t('config.gitBinHint')}</span>
+            </label>
+          </Card>
+
+          {/* 同步状态 */}
+          <Card>
+            <span className={css.groupLabel}>{t('status.title')}</span>
+            <div className={css.statRow}>
+              <Badge kind={status.kind === 'ready' ? 'ok' : status.kind === 'error' ? 'error' : 'warn'}>{status.text}</Badge>
+            </div>
+          </Card>
+
+          {/* 操作 */}
+          <div className={css.actionRow}>
+            <Button variant="primary" disabled={!buttons.canPush} onClick={() => { void runPush() }}>
+              {state.busy === 'push' ? <Spinner label={buttons.pushLabel} /> : buttons.pushLabel}
+            </Button>
+            <Button disabled={!buttons.canPull} onClick={() => { void runPull() }}>
+              {state.busy === 'pull' ? <Spinner label={buttons.pullLabel} /> : buttons.pullLabel}
+            </Button>
+          </div>
+
+          {state.error !== null && <ErrorBanner error={state.error} />}
+
+          {/* 推送结果 */}
+          {pushView !== null && (
+            <Card>
+              <span className={css.groupLabel}>{t('push.title')}</span>
+              <Banner kind={pushView.kind === 'ok' ? 'ok' : 'error'}>{pushView.headline}</Banner>
+              {pushView.sections.length > 0 && (
+                <div>
+                  <span className={css.fieldLabel}>{t('sections.title')}</span>
+                  <div className={css.statRow}>
+                    {pushView.sections.map((s) => <Badge key={s} kind="info">{s}</Badge>)}
+                  </div>
+                </div>
+              )}
+              {pushView.warnings.length > 0 && (
+                <div>
+                  <span className={css.fieldLabel}>{t('warnings.title')}</span>
+                  <ul className={css.warnList}>
+                    {pushView.warnings.map((w, i) => <li key={i}>{w}</li>)}
+                  </ul>
+                </div>
+              )}
+            </Card>
+          )}
+
+          {/* 拉取差异预览 */}
+          {pullView !== null && (
+            <Card>
+              <span className={css.groupLabel}>{t('pull.title')}</span>
+              <Banner kind={pullView.kind === 'ok' ? 'info' : pullView.kind === 'empty' ? 'ok' : 'error'}>{pullView.headline}</Banner>
+              {pullView.summary !== null && (
+                <>
+                  <div className={css.statRow}>
+                    <Badge kind="info">{t('change.total', { total: pullView.summary.total })}</Badge>
+                    {pullView.summary.error > 0 && <Badge kind="error">{severityLabel('error')} × {pullView.summary.error}</Badge>}
+                    {pullView.summary.warning > 0 && <Badge kind="warn">{severityLabel('warning')} × {pullView.summary.warning}</Badge>}
+                    {pullView.summary.info > 0 && <Badge kind="info">{severityLabel('info')} × {pullView.summary.info}</Badge>}
+                  </div>
+                  {pullView.summary.needsReview && <Banner kind="warn">{t('pull.needsReview')}</Banner>}
+                  <div className={css.reportList}>
+                    {pullView.summary.items.map((c) => (
+                      <div key={c.id} className={css.statRow}>
+                        <span className={css.kindTag}>{kindLabel(c.kind)}</span>
+                        <Badge kind={c.severity === 'error' ? 'error' : c.severity === 'warning' ? 'warn' : 'info'}>
+                          {severityLabel(c.severity)}
+                        </Badge>
+                        <span>{c.description}</span>
+                      </div>
+                    ))}
+                  </div>
+                </>
+              )}
+              {pullView.previewHint !== '' && <Banner kind="info">{pullView.previewHint}</Banner>}
+            </Card>
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/client/sync/sync-api.test.ts

@@ -0,0 +1,117 @@
+/**
+ * m-sync-ui：SyncApi（/api/dsh-config-manager/sync/*）请求契约测试。
+ * 用全局 fetch mock 验证 status/push/pull 的路径/方法/请求体与响应解析（含 4xx 错误映射）。
+ */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import { ConfigManagerApiError } from '../api.ts';
+import { SYNC_API, SyncApi } from './sync-api.ts';
+
+interface FetchCall {
+  url: string;
+  init?: RequestInit;
+}
+
+function installFetchMock(handler: (call: FetchCall) => Response): void {
+  const original = globalThis.fetch;
+  globalThis.fetch = (async (input: RequestInfo | URL, init?: RequestInit): Promise<Response> => {
+    return handler({ url: String(input), init });
+  }) as typeof fetch;
+  test.after(() => {
+    globalThis.fetch = original;
+  });
+}
+
+function jsonResponse(status: number, body: unknown): Response {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'content-type': 'application/json' },
+  });
+}
+
+test('S-01 api.status()：GET 到 /sync/status，解析配置/凭据/上次同步', async () => {
+  const body = {
+    ok: true, configured: true, repoUrl: 'https://github.com/u/r.git',
+    credentialConfigured: true, credentialWritable: true,
+    lastSyncAt: '2026-08-16T10:30:00.000Z', sectionCount: 3,
+    transport: { type: 'git', ref: 'main' },
+  };
+  let called: FetchCall | null = null;
+  installFetchMock((call) => {
+    called = call;
+    return jsonResponse(200, body);
+  });
+  // 经读取函数解除闭包赋值导致的 CFA 窄化（called 在回调内赋值，外部保持 null 窄化）
+  const lastCall = (): FetchCall | null => called;
+
+  const api = new SyncApi();
+  const result = await api.status();
+  assert.equal(result.configured, true);
+  assert.equal(result.repoUrl, 'https://github.com/u/r.git');
+  assert.equal(result.credentialConfigured, true);
+  assert.equal(lastCall()?.url, SYNC_API.status);
+  assert.equal(lastCall()?.init?.method, undefined, 'GET 不设 method');
+});
+
+test('S-02 api.push()：POST /sync/push，请求体携带 repoUrl/token/gitBin', async () => {
+  const calls: FetchCall[] = [];
+  installFetchMock((call) => {
+    calls.push(call);
+    return jsonResponse(200, { ok: true, snapshotId: 'sync-1', sections: ['settings'], warnings: [] });
+  });
+
+  const api = new SyncApi();
+  const result = await api.push({ repoUrl: 'https://github.com/u/r.git', token: 'ghp_secret', gitBin: 'git' });
+  assert.equal(result.ok, true);
+  assert.equal(result.snapshotId, 'sync-1');
+  assert.equal(calls.length, 1);
+  assert.equal(calls[0]?.url, SYNC_API.push);
+  assert.equal(calls[0]?.init?.method, 'POST');
+  const sent = JSON.parse(String(calls[0]?.init?.body ?? '{}')) as Record<string, unknown>;
+  assert.equal(sent['repoUrl'], 'https://github.com/u/r.git');
+  assert.equal(sent['token'], 'ghp_secret');
+  assert.equal(sent['gitBin'], 'git');
+});
+
+test('S-03 api.pull()：POST /sync/pull，strategy 缺省透传 merge，响应含差异摘要', async () => {
+  const calls: FetchCall[] = [];
+  installFetchMock((call) => {
+    calls.push(call);
+    return jsonResponse(200, {
+      ok: true, snapshotId: 'sync-9',
+      changes: [{ id: 'a', adapter: 'settings', kind: 'Conflict', description: '冲突', severity: 'warning' }],
+      needsReview: true,
+    });
+  });
+
+  const api = new SyncApi();
+  const result = await api.pull({ repoUrl: 'https://github.com/u/r.git', strategy: 'merge' });
+  assert.equal(result.changes.length, 1);
+  assert.equal(result.changes[0]?.kind, 'Conflict');
+  assert.equal(result.needsReview, true);
+  assert.equal(calls[0]?.url, SYNC_API.pull);
+  const sent = JSON.parse(String(calls[0]?.init?.body ?? '{}')) as Record<string, unknown>;
+  assert.equal(sent['strategy'], 'merge');
+});
+
+test('S-04 错误映射：4xx 携带 error → ConfigManagerApiError', async () => {
+  installFetchMock(() => jsonResponse(400, { error: 'repoUrl is required' }));
+  const api = new SyncApi();
+  await assert.rejects(api.push({ repoUrl: '' }), (err: unknown) => {
+    assert.ok(err instanceof ConfigManagerApiError);
+    assert.match(err.message, /repoUrl is required/);
+    return true;
+  });
+});
+
+test('S-05 服务未挂载：404（非 JSON 体）→ ConfigManagerApiError 提示插件未加载', async () => {
+  // 路由不存在时宿主返回 404 但无 JSON error → readJson 兜底为「插件未挂载」提示
+  installFetchMock(() => new Response('Not Found', { status: 404 }));
+  const api = new SyncApi();
+  await assert.rejects(api.status(), (err: unknown) => {
+    assert.ok(err instanceof ConfigManagerApiError);
+    assert.match(err.message, /未挂载/);
+    return true;
+  });
+});