feat(pages): configurable limits, multi-format packages, and dual versioning

Make Pages package size and history retention system-configurable, support
zip/tar.gz/tar.xz/tar.bz2/tar/7z uploads, prune history with clear keep-N
semantics, and rebind agent config to the live active Pages deployment so
main-config rollback never depends on pruned packages.

frontend/app/(main)/admin/settings/components/openflare-ops-utils.ts

@@ -20,6 +20,8 @@ export type OpenFlareOpsFields = {
   uptime_kuma_timeout: string;
   database_auto_cleanup_enabled: boolean;
   database_auto_cleanup_retention_days: string;
+  pages_max_package_size_mb: string;
+  pages_max_history_count: string;
 };
 
 export const defaultOpenFlareOpsFields: OpenFlareOpsFields = {
@@ -42,6 +44,8 @@ export const defaultOpenFlareOpsFields: OpenFlareOpsFields = {
   uptime_kuma_timeout: '48',
   database_auto_cleanup_enabled: false,
   database_auto_cleanup_retention_days: '30',
+  pages_max_package_size_mb: '100',
+  pages_max_history_count: '20',
 };
 
 export const INSTALLER_SCRIPT_URL =
@@ -90,6 +94,8 @@ export function mapOptionsToOpsFields(
     ),
     database_auto_cleanup_retention_days:
       optionMap.database_auto_cleanup_retention_days ?? '30',
+    pages_max_package_size_mb: optionMap.pages_max_package_size_mb ?? '100',
+    pages_max_history_count: optionMap.pages_max_history_count ?? '20',
   };
 }
 
@@ -226,3 +232,30 @@ export function databaseAutoCleanupEntries(
     },
   ];
 }
+
+export function validatePagesFields(fields: OpenFlareOpsFields) {
+  const packageSize = Number.parseInt(fields.pages_max_package_size_mb, 10);
+  const historyCount = Number.parseInt(fields.pages_max_history_count, 10);
+  if (Number.isNaN(packageSize) || packageSize < 1 || packageSize > 2048) {
+    throw new Error('Pages 部署包大小上限必须为 1～2048 MiB。');
+  }
+  if (Number.isNaN(historyCount) || historyCount < 0) {
+    throw new Error(
+      'Pages 历史保留数必须为大于等于 0 的整数（0 表示不限制）。',
+    );
+  }
+}
+
+export function pagesOptionEntries(fields: OpenFlareOpsFields): OptionItem[] {
+  validatePagesFields(fields);
+  return [
+    {
+      key: 'pages_max_package_size_mb',
+      value: String(Number.parseInt(fields.pages_max_package_size_mb, 10)),
+    },
+    {
+      key: 'pages_max_history_count',
+      value: String(Number.parseInt(fields.pages_max_history_count, 10)),
+    },
+  ];
+}

frontend/app/(main)/admin/settings/components/openflare-ops.tsx

@@ -64,6 +64,7 @@ import {
   mapOptionsToOpsFields,
   type OpenFlareOpsFields,
   optionsToMap,
+  pagesOptionEntries,
   uptimeKumaOptionEntries,
 } from './openflare-ops-utils';
 import { UptimeKumaSiteSelectModal } from './uptimekuma-site-modal';
@@ -258,6 +259,17 @@ export function OpenFlareOpsSettings() {
     }
   };
 
+  const savePagesSettings = () => {
+    try {
+      saveMutation.mutate({
+        section: 'pages',
+        entries: pagesOptionEntries(fields),
+      });
+    } catch (error) {
+      toast.error(error instanceof Error ? error.message : '参数校验失败');
+    }
+  };
+
   if (optionsQuery.isLoading) {
     return (
       <LoadingStateWithBorder
@@ -413,6 +425,55 @@ export function OpenFlareOpsSettings() {
         </Card>
       </div>
 
+      <Card className='border-dashed shadow-none'>
+        <CardHeader className='flex flex-row items-center justify-between gap-4'>
+          <div>
+            <CardTitle className='text-base'>Pages 静态托管</CardTitle>
+            <CardDescription>
+              配置部署包上传体积上限与每个项目的历史部署保留数量。
+            </CardDescription>
+          </div>
+          <Button
+            size='sm'
+            disabled={savingSection === 'pages'}
+            onClick={savePagesSettings}
+          >
+            {savingSection === 'pages' ? (
+              <Loader2 className='size-4 animate-spin mr-1' />
+            ) : (
+              <Save className='size-3.5 mr-1' />
+            )}
+            保存
+          </Button>
+        </CardHeader>
+        <CardContent className='space-y-4'>
+          <div className='grid gap-4 md:grid-cols-2'>
+            <FieldInput
+              label='部署包大小上限 (MiB)'
+              value={fields.pages_max_package_size_mb}
+              type='number'
+              onChange={(value) =>
+                updateField('pages_max_package_size_mb', value)
+              }
+              placeholder='100'
+            />
+            <FieldInput
+              label='历史部署保留数（0 不限制）'
+              value={fields.pages_max_history_count}
+              type='number'
+              onChange={(value) =>
+                updateField('pages_max_history_count', value)
+              }
+              placeholder='20'
+            />
+          </div>
+          <p className='text-xs text-muted-foreground'>
+            每个项目最多保留 N 条部署：激活部署始终保留，其余按从新到旧填充；超出的非激活部署会在上传成功后自动清理。支持
+            zip、tar.gz、tar.xz、tar.bz2、tar、7z 格式。
+          </p>
+        </CardContent>
+      </Card>
+
       <Card className='border-dashed shadow-none'>
         <CardHeader className='flex flex-row items-center justify-between gap-4'>
           <div>