Files
CC-Switch/src/components/settings/CodexAuthSettings.tsx
T
Jason eab6bfd20c feat(codex): add opt-in migration and ledger-based restore for unified session history
- Enable dialog gains a checkbox (default off) to migrate existing
  official sessions from the built-in "openai" bucket into the shared
  "custom" bucket, with per-generation backups; failed migrations retry
  at startup
- Disable dialog offers a precise restore driven by the backup ledger:
  only sessions recorded as "openai" in backups are flipped back, and
  sessions created while the toggle was on are never touched
- Completion marker and backup generations are bound to the canonical
  Codex config dir; migrate/restore serialize on an op lock and the
  marker is written conditionally inside the settings write lock
- save_settings rolls back the toggle and fails the save when the live
  rewrite fails; migration additionally requires the live config to
  actually route to the shared bucket (skips with live_not_unified so
  refused injection or proxy takeover can't split history)
- Restore refuses to run while the toggle is (re-)enabled and reports
  nothing_to_restore instead of a zero-count success; local migration
  markers are now backend-owned in merge_settings_for_save so stale
  frontend payloads can't resurrect them
- Settings autosave reverts optimistic form state on failure so a
  failed toggle change can't be replayed by an unrelated save
- ConfirmDialog supports an optional checkbox; all four locales updated
2026-06-12 23:35:01 +08:00

143 lines
5.3 KiB
TypeScript

import { useState } from "react";
import { useTranslation } from "react-i18next";
import { History, KeyRound } from "lucide-react";
import { toast } from "sonner";
import type { SettingsFormState } from "@/hooks/useSettings";
import { ToggleRow } from "@/components/ui/toggle-row";
import { ConfirmDialog } from "@/components/ConfirmDialog";
import { settingsApi } from "@/lib/api";
interface CodexAuthSettingsProps {
settings: SettingsFormState;
/** 返回 false(或 resolve 为 false)表示保存失败;其余返回值视为成功 */
onChange: (
updates: Partial<SettingsFormState>,
) => void | boolean | Promise<void | boolean>;
}
export function CodexAuthSettings({
settings,
onChange,
}: CodexAuthSettingsProps) {
const { t } = useTranslation();
const [showEnableConfirm, setShowEnableConfirm] = useState(false);
const [showDisableConfirm, setShowDisableConfirm] = useState(false);
const [hasUnifyBackup, setHasUnifyBackup] = useState(false);
const handleUnifyHistoryChange = (checked: boolean) => {
if (checked) {
setShowEnableConfirm(true);
return;
}
// 先探测有无迁移备份,决定关闭弹窗是否提供"恢复备份"勾选
void settingsApi
.hasCodexUnifyHistoryBackup()
.catch(() => false)
.then((hasBackup) => {
setHasUnifyBackup(hasBackup);
setShowDisableConfirm(true);
});
};
const handleEnableConfirm = (migrateExisting: boolean) => {
setShowEnableConfirm(false);
void onChange({
unifyCodexSessionHistory: true,
unifyCodexMigrateExisting: migrateExisting,
});
};
// 备份探测可能落后于正在后台进行的迁移(刚勾选迁入就立刻关闭时,
// 备份尚未产出)。只要本轮勾选过"迁入既有会话",就必须提供恢复入口;
// 真正有没有账本交给后端 restore 的 skippedReason 判定。
const showRestoreOption =
hasUnifyBackup || (settings.unifyCodexMigrateExisting ?? false);
const handleDisableConfirm = async (restoreBackup: boolean) => {
setShowDisableConfirm(false);
const saved = await onChange({
unifyCodexSessionHistory: false,
unifyCodexMigrateExisting: false,
});
// 关闭保存失败时绝不还原:否则开关仍开着(live 仍统一路由),
// 已迁移会话却被翻回 openai 桶,历史被拆成两半。
if (saved === false) return;
// 不再以探测结果短路:还原命令会在迁移锁上排队,等到迁移落盘后
// 拿到完整账本;确实无账本时由 skippedReason 提示。
if (!restoreBackup) return;
try {
const result = await settingsApi.restoreCodexUnifiedHistory();
if (result.skippedReason) {
// unify_toggle_on:还原排队期间开关被重新开启,后端拒绝还原
toast.info(
result.skippedReason === "unify_toggle_on"
? t("settings.unifyCodexHistoryRestoreSkippedToggleOn")
: t("settings.unifyCodexHistoryRestoreNothing"),
);
return;
}
toast.success(
t("settings.unifyCodexHistoryRestoreCompleted", {
files: result.restoredJsonlFiles,
rows: result.restoredStateRows,
}),
);
} catch (error) {
console.error("Failed to restore codex unified history:", error);
toast.error(t("settings.unifyCodexHistoryRestoreFailed"));
}
};
return (
<section className="space-y-4">
<div className="flex items-center gap-2 pb-2 border-b border-border/40">
<KeyRound className="h-4 w-4 text-primary" />
<h3 className="text-sm font-medium">{t("settings.codexAuth")}</h3>
</div>
<ToggleRow
icon={<KeyRound className="h-4 w-4 text-emerald-500" />}
title={t("settings.preserveCodexOfficialAuthOnSwitch")}
description={t("settings.preserveCodexOfficialAuthOnSwitchDescription")}
checked={settings.preserveCodexOfficialAuthOnSwitch ?? false}
onCheckedChange={(value) =>
onChange({ preserveCodexOfficialAuthOnSwitch: value })
}
/>
<ToggleRow
icon={<History className="h-4 w-4 text-sky-500" />}
title={t("settings.unifyCodexSessionHistory")}
description={t("settings.unifyCodexSessionHistoryDescription")}
checked={settings.unifyCodexSessionHistory ?? false}
onCheckedChange={handleUnifyHistoryChange}
/>
<ConfirmDialog
isOpen={showEnableConfirm}
title={t("confirm.unifyCodexHistory.title")}
message={t("confirm.unifyCodexHistory.message")}
checkboxLabel={t("confirm.unifyCodexHistory.migrateExisting")}
confirmText={t("confirm.unifyCodexHistory.confirm")}
onConfirm={handleEnableConfirm}
onCancel={() => setShowEnableConfirm(false)}
/>
<ConfirmDialog
isOpen={showDisableConfirm}
title={t("confirm.unifyCodexHistoryOff.title")}
message={t("confirm.unifyCodexHistoryOff.message")}
checkboxLabel={
showRestoreOption
? t("confirm.unifyCodexHistoryOff.restoreBackup")
: undefined
}
checkboxDefaultChecked
confirmText={t("confirm.unifyCodexHistoryOff.confirm")}
onConfirm={(restoreBackup) => void handleDisableConfirm(restoreBackup)}
onCancel={() => setShowDisableConfirm(false)}
/>
</section>
);
}