fix:优化数据

frontend/app/(main)/settings/ai/page.tsx

@@ -0,0 +1,391 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from "@/components/ui/dialog";
+import {
+  aiSettingsApi,
+  type AIConfig,
+  type AIConfigListItem,
+  type AIConfigCreate,
+  type AIConfigUpdate,
+} from "@/lib/api/client";
+import { Loader2, Zap, Plus, Pencil, Trash2, CheckCircle } from "lucide-react";
+import { toast } from "sonner";
+
+const PROVIDERS = ["OpenAI", "DeepSeek", "Custom"];
+
+export default function SettingsAIPage() {
+  const [list, setList] = useState<AIConfigListItem[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [editingId, setEditingId] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [testing, setTesting] = useState<string | null>(null);
+
+  const [formName, setFormName] = useState("");
+  const [provider, setProvider] = useState("OpenAI");
+  const [apiKey, setApiKey] = useState("");
+  const [apiKeyConfigured, setApiKeyConfigured] = useState(false);
+  const [baseUrl, setBaseUrl] = useState("");
+  const [modelName, setModelName] = useState("gpt-4o-mini");
+  const [temperature, setTemperature] = useState("0.2");
+  const [systemPromptOverride, setSystemPromptOverride] = useState("");
+
+  const loadList = useCallback(async () => {
+    try {
+      const data = await aiSettingsApi.list();
+      setList(data);
+    } catch {
+      toast.error("加载模型列表失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    loadList();
+  }, [loadList]);
+
+  const openAdd = () => {
+    setEditingId(null);
+    setFormName("");
+    setProvider("OpenAI");
+    setApiKey("");
+    setApiKeyConfigured(false);
+    setBaseUrl("");
+    setModelName("gpt-4o-mini");
+    setTemperature("0.2");
+    setSystemPromptOverride("");
+    setDialogOpen(true);
+  };
+
+  const openEdit = async (id: string) => {
+    try {
+      const c = await aiSettingsApi.getById(id);
+      setEditingId(id);
+      setFormName(c.name || "");
+      setProvider(c.provider || "OpenAI");
+      setApiKey("");
+      setApiKeyConfigured(!!(c.api_key && c.api_key.length > 0));
+      setBaseUrl(c.base_url || "");
+      setModelName(c.model_name || "gpt-4o-mini");
+      setTemperature(String(c.temperature ?? 0.2));
+      setSystemPromptOverride(c.system_prompt_override || "");
+      setDialogOpen(true);
+    } catch {
+      toast.error("加载配置失败");
+    }
+  };
+
+  const handleSave = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setSaving(true);
+    try {
+      if (editingId) {
+        const payload: AIConfigUpdate = {
+          name: formName.trim() || undefined,
+          provider: provider || undefined,
+          base_url: baseUrl.trim() || undefined,
+          model_name: modelName.trim() || undefined,
+          temperature: parseFloat(temperature),
+          system_prompt_override: systemPromptOverride.trim() || undefined,
+        };
+        if (apiKey.trim()) payload.api_key = apiKey.trim();
+        await aiSettingsApi.update(editingId, payload);
+        toast.success("已更新");
+      } else {
+        const payload: AIConfigCreate = {
+          name: formName.trim() || undefined,
+          provider: provider || undefined,
+          api_key: apiKey.trim() || undefined,
+          base_url: baseUrl.trim() || undefined,
+          model_name: modelName.trim() || undefined,
+          temperature: parseFloat(temperature),
+          system_prompt_override: systemPromptOverride.trim() || undefined,
+        };
+        await aiSettingsApi.create(payload);
+        toast.success("已添加");
+      }
+      setDialogOpen(false);
+      await loadList();
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("ai-settings-changed"));
+      }
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const handleActivate = async (id: string) => {
+    try {
+      await aiSettingsApi.activate(id);
+      toast.success("已选用该模型");
+      await loadList();
+      window.dispatchEvent(new CustomEvent("ai-settings-changed"));
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "选用失败");
+    }
+  };
+
+  const handleDelete = async (id: string) => {
+    if (!confirm("确定删除该模型配置？")) return;
+    try {
+      await aiSettingsApi.delete(id);
+      toast.success("已删除");
+      await loadList();
+      window.dispatchEvent(new CustomEvent("ai-settings-changed"));
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "删除失败");
+    }
+  };
+
+  const handleTest = async (id: string) => {
+    setTesting(id);
+    try {
+      const res = await aiSettingsApi.test(id);
+      toast.success(res.message ? `连接成功：${res.message}` : "连接成功");
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "连接失败");
+    } finally {
+      setTesting(null);
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="p-6 flex items-center gap-2 text-muted-foreground">
+        <Loader2 className="h-4 w-4 animate-spin" />
+        加载中…
+      </div>
+    );
+  }
+
+  return (
+    <div className="p-6 max-w-4xl">
+      <div className="mb-4">
+        <Link href="/settings" className="text-sm text-muted-foreground hover:text-foreground">
+          ← 设置
+        </Link>
+      </div>
+
+      <Card>
+        <CardHeader>
+          <div className="flex flex-wrap items-center justify-between gap-3">
+            <div>
+              <CardTitle>已配置的模型</CardTitle>
+              <p className="text-sm text-muted-foreground mt-1">
+                在此查看、选用或编辑多套 AI 模型配置；需求解析与测试将使用当前选用的配置。
+              </p>
+            </div>
+            <Button onClick={openAdd}>
+              <Plus className="h-4 w-4" />
+              <span className="ml-2">添加模型</span>
+            </Button>
+          </div>
+        </CardHeader>
+        <CardContent>
+          {list.length === 0 ? (
+            <p className="text-sm text-muted-foreground py-4">
+              暂无模型配置。点击「添加模型」填写 API Key、模型名称等，保存后即可在列表中选用。
+            </p>
+          ) : (
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>名称</TableHead>
+                  <TableHead>提供商</TableHead>
+                  <TableHead>模型</TableHead>
+                  <TableHead>API Key</TableHead>
+                  <TableHead className="w-[200px]">操作</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {list.map((item) => (
+                  <TableRow key={item.id}>
+                    <TableCell className="font-medium">
+                      {item.name || "未命名"}
+                      {item.is_active && (
+                        <span className="ml-2 text-xs text-primary flex items-center gap-0.5">
+                          <CheckCircle className="h-3.5 w-3.5" /> 当前选用
+                        </span>
+                      )}
+                    </TableCell>
+                    <TableCell>{item.provider}</TableCell>
+                    <TableCell>{item.model_name || "—"}</TableCell>
+                    <TableCell>{item.api_key_configured ? "已配置" : "未配置"}</TableCell>
+                    <TableCell>
+                      <div className="flex items-center gap-1 flex-wrap">
+                        {!item.is_active && (
+                          <Button
+                            variant="outline"
+                            size="sm"
+                            onClick={() => handleActivate(item.id)}
+                          >
+                            选用
+                          </Button>
+                        )}
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => openEdit(item.id)}
+                          title="编辑"
+                        >
+                          <Pencil className="h-4 w-4" />
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => handleTest(item.id)}
+                          disabled={testing === item.id}
+                          title="测试连接"
+                        >
+                          {testing === item.id ? (
+                            <Loader2 className="h-4 w-4 animate-spin" />
+                          ) : (
+                            <Zap className="h-4 w-4" />
+                          )}
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => handleDelete(item.id)}
+                          title="删除"
+                          className="text-destructive"
+                        >
+                          <Trash2 className="h-4 w-4" />
+                        </Button>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          )}
+        </CardContent>
+      </Card>
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent className="max-w-lg">
+          <DialogHeader>
+            <DialogTitle>{editingId ? "编辑模型配置" : "添加模型配置"}</DialogTitle>
+          </DialogHeader>
+          <form onSubmit={handleSave} className="space-y-4">
+            <div className="grid gap-2">
+              <Label htmlFor="ai-name">配置名称（便于区分）</Label>
+              <Input
+                id="ai-name"
+                value={formName}
+                onChange={(e) => setFormName(e.target.value)}
+                placeholder="如：OpenAI 生产、DeepSeek 备用"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="provider">提供商</Label>
+              <Select value={provider} onValueChange={setProvider}>
+                <SelectTrigger id="provider">
+                  <SelectValue placeholder="选择提供商" />
+                </SelectTrigger>
+                <SelectContent>
+                  {PROVIDERS.map((p) => (
+                    <SelectItem key={p} value={p}>
+                      {p}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="api_key">API Key</Label>
+              <Input
+                id="api_key"
+                type="password"
+                value={apiKey}
+                onChange={(e) => setApiKey(e.target.value)}
+                placeholder={apiKeyConfigured ? "已配置，输入新值以修改" : "请输入 API Key"}
+                autoComplete="off"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="base_url">Base URL（可选）</Label>
+              <Input
+                id="base_url"
+                type="url"
+                value={baseUrl}
+                onChange={(e) => setBaseUrl(e.target.value)}
+                placeholder="https://api.openai.com/v1"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="model_name">模型名称</Label>
+              <Input
+                id="model_name"
+                value={modelName}
+                onChange={(e) => setModelName(e.target.value)}
+                placeholder="gpt-4o-mini / deepseek-chat 等"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="temperature">Temperature (0–2)</Label>
+              <Input
+                id="temperature"
+                type="number"
+                min={0}
+                max={2}
+                step={0.1}
+                value={temperature}
+                onChange={(e) => setTemperature(e.target.value)}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="system_prompt_override">系统提示词覆盖（可选）</Label>
+              <textarea
+                id="system_prompt_override"
+                className="flex min-h-[60px] w-full rounded-md border border-input bg-background px-3 py-2 text-sm ring-offset-background placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
+                value={systemPromptOverride}
+                onChange={(e) => setSystemPromptOverride(e.target.value)}
+                placeholder="留空则使用默认"
+              />
+            </div>
+            <DialogFooter>
+              <Button type="button" variant="outline" onClick={() => setDialogOpen(false)}>
+                取消
+              </Button>
+              <Button type="submit" disabled={saving}>
+                {saving && <Loader2 className="h-4 w-4 animate-spin mr-1" />}
+                {editingId ? "保存" : "添加"}
+              </Button>
+            </DialogFooter>
+          </form>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

frontend/app/(main)/settings/cloud-doc-config/page.tsx

@@ -0,0 +1,209 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  cloudDocConfigApi,
+  type CloudDocConfigRead,
+  type CloudDocConfigUpdate,
+} from "@/lib/api/client";
+import { Loader2, Save, FileStack } from "lucide-react";
+import { toast } from "sonner";
+
+export default function SettingsCloudDocConfigPage() {
+  const [config, setConfig] = useState<CloudDocConfigRead | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [saving, setSaving] = useState(false);
+  const [form, setForm] = useState<CloudDocConfigUpdate>({
+    feishu: { app_id: "", app_secret: "" },
+    yuque: { token: "", default_repo: "" },
+    tencent: { client_id: "", client_secret: "" },
+  });
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    try {
+      const data = await cloudDocConfigApi.get();
+      setConfig(data);
+      setForm({
+        feishu: { app_id: data.feishu.app_id, app_secret: "" },
+        yuque: { token: "", default_repo: data.yuque.default_repo },
+        tencent: { client_id: data.tencent.client_id, client_secret: "" },
+      });
+    } catch {
+      toast.error("加载云文档配置失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    load();
+  }, [load]);
+
+  const handleSave = async () => {
+    setSaving(true);
+    try {
+      const payload: CloudDocConfigUpdate = {};
+      if (form.feishu?.app_id !== undefined) payload.feishu = { app_id: form.feishu.app_id };
+      if (form.feishu?.app_secret !== undefined && form.feishu.app_secret !== "")
+        payload.feishu = { ...payload.feishu, app_secret: form.feishu.app_secret };
+      if (form.yuque?.token !== undefined && form.yuque.token !== "")
+        payload.yuque = { token: form.yuque.token };
+      if (form.yuque?.default_repo !== undefined)
+        payload.yuque = { ...payload.yuque, default_repo: form.yuque.default_repo };
+      if (form.tencent?.client_id !== undefined) payload.tencent = { client_id: form.tencent.client_id };
+      if (form.tencent?.client_secret !== undefined && form.tencent.client_secret !== "")
+        payload.tencent = { ...payload.tencent, client_secret: form.tencent.client_secret };
+      await cloudDocConfigApi.update(payload);
+      toast.success("已保存");
+      await load();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  if (loading) {
+    return (
+      <div className="p-6 max-w-2xl flex items-center gap-2">
+        <Loader2 className="h-5 w-5 animate-spin" />
+        <span className="text-sm text-muted-foreground">加载中…</span>
+      </div>
+    );
+  }
+
+  return (
+    <div className="p-6 max-w-2xl">
+      <div className="mb-4">
+        <Link
+          href="/settings"
+          className="text-sm text-muted-foreground hover:text-foreground"
+        >
+          ← 设置
+        </Link>
+      </div>
+      <Card>
+        <CardHeader>
+          <CardTitle className="flex items-center gap-2">
+            <FileStack className="h-5 w-5" />
+            云文档配置
+          </CardTitle>
+          <p className="text-sm text-muted-foreground mt-1">
+            配置飞书、语雀、腾讯文档的 API 凭证，用于在工作台「推送到云文档」时创建/更新在线文档。
+          </p>
+        </CardHeader>
+        <CardContent className="space-y-6">
+          {/* 飞书 */}
+          <div className="space-y-3">
+            <h3 className="text-sm font-medium">飞书 (Feishu)</h3>
+            <div className="grid gap-2">
+              <Label>App ID</Label>
+              <Input
+                value={form.feishu?.app_id ?? config?.feishu?.app_id ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    feishu: { ...f.feishu, app_id: e.target.value },
+                  }))
+                }
+                placeholder="在飞书开放平台创建应用后获取"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>App Secret</Label>
+              <Input
+                type="password"
+                value={form.feishu?.app_secret ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    feishu: { ...f.feishu, app_secret: e.target.value },
+                  }))
+                }
+                placeholder={config?.feishu?.app_secret_configured ? "已配置，留空不修改" : "必填"}
+              />
+            </div>
+          </div>
+
+          {/* 语雀 */}
+          <div className="space-y-3">
+            <h3 className="text-sm font-medium">语雀 (Yuque)</h3>
+            <div className="grid gap-2">
+              <Label>Personal Access Token</Label>
+              <Input
+                type="password"
+                value={form.yuque?.token ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    yuque: { ...f.yuque, token: e.target.value },
+                  }))
+                }
+                placeholder={config?.yuque?.token_configured ? "已配置，留空不修改" : "在语雀 设置 → Token 中创建"}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>默认知识库 (namespace)</Label>
+              <Input
+                value={form.yuque?.default_repo ?? config?.yuque?.default_repo ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    yuque: { ...f.yuque, default_repo: e.target.value },
+                  }))
+                }
+                placeholder="如：your_username/repo"
+              />
+            </div>
+          </div>
+
+          {/* 腾讯文档 */}
+          <div className="space-y-3">
+            <h3 className="text-sm font-medium">腾讯文档 (Tencent)</h3>
+            <p className="text-xs text-muted-foreground">
+              腾讯文档需 OAuth 用户授权，当前版本仅保留配置项，推送功能请先用飞书或语雀。
+            </p>
+            <div className="grid gap-2">
+              <Label>Client ID</Label>
+              <Input
+                value={form.tencent?.client_id ?? config?.tencent?.client_id ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    tencent: { ...f.tencent, client_id: e.target.value },
+                  }))
+                }
+                placeholder="开放平台应用 Client ID"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>Client Secret</Label>
+              <Input
+                type="password"
+                value={form.tencent?.client_secret ?? ""}
+                onChange={(e) =>
+                  setForm((f) => ({
+                    ...f,
+                    tencent: { ...f.tencent, client_secret: e.target.value },
+                  }))
+                }
+                placeholder={config?.tencent?.client_secret_configured ? "已配置，留空不修改" : "选填"}
+              />
+            </div>
+          </div>
+
+          <Button onClick={handleSave} disabled={saving}>
+            {saving ? <Loader2 className="h-4 w-4 animate-spin mr-2" /> : <Save className="h-4 w-4 mr-2" />}
+            保存配置
+          </Button>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

frontend/app/(main)/settings/cloud-docs/page.tsx

@@ -0,0 +1,261 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import {
+  cloudDocsApi,
+  type CloudDocLinkRead,
+  type CloudDocLinkCreate,
+} from "@/lib/api/client";
+import { FileStack, Plus, Pencil, Trash2, Loader2, ExternalLink } from "lucide-react";
+import { toast } from "sonner";
+
+export default function SettingsCloudDocsPage() {
+  const [links, setLinks] = useState<CloudDocLinkRead[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [editingId, setEditingId] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [form, setForm] = useState({ name: "", url: "" });
+
+  const loadLinks = useCallback(async () => {
+    try {
+      const list = await cloudDocsApi.list();
+      setLinks(list);
+    } catch {
+      toast.error("加载云文档列表失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    loadLinks();
+  }, [loadLinks]);
+
+  const openAdd = () => {
+    setEditingId(null);
+    setForm({ name: "", url: "" });
+    setDialogOpen(true);
+  };
+
+  const openEdit = (item: CloudDocLinkRead) => {
+    setEditingId(item.id);
+    setForm({ name: item.name, url: item.url });
+    setDialogOpen(true);
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!form.name.trim() || !form.url.trim()) {
+      toast.error("请填写名称和链接");
+      return;
+    }
+    setSaving(true);
+    try {
+      if (editingId) {
+        await cloudDocsApi.update(editingId, {
+          name: form.name.trim(),
+          url: form.url.trim(),
+        });
+        toast.success("已更新");
+      } else {
+        const payload: CloudDocLinkCreate = {
+          name: form.name.trim(),
+          url: form.url.trim(),
+        };
+        await cloudDocsApi.create(payload);
+        toast.success("已添加");
+      }
+      setDialogOpen(false);
+      await loadLinks();
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("cloud-docs-changed"));
+      }
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const handleDelete = async (id: string) => {
+    if (!confirm("确定删除该云文档入口？")) return;
+    try {
+      await cloudDocsApi.delete(id);
+      toast.success("已删除");
+      await loadLinks();
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("cloud-docs-changed"));
+      }
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "删除失败");
+    }
+  };
+
+  return (
+    <div className="p-6 max-w-4xl">
+      <div className="mb-4">
+        <Link
+          href="/settings"
+          className="text-sm text-muted-foreground hover:text-foreground"
+        >
+          ← 设置
+        </Link>
+      </div>
+      <Card>
+        <CardHeader>
+          <div className="flex flex-wrap items-center justify-between gap-3">
+            <div>
+              <CardTitle className="flex items-center gap-2">
+                <FileStack className="h-5 w-5" />
+                云文档快捷入口
+              </CardTitle>
+              <p className="text-sm text-muted-foreground mt-1">
+                添加腾讯文档、飞书、语雀等云文档登录/入口链接，侧栏可快速打开。
+              </p>
+            </div>
+            <Button onClick={openAdd}>
+              <Plus className="h-4 w-4" />
+              <span className="ml-2">添加入口</span>
+            </Button>
+          </div>
+        </CardHeader>
+        <CardContent>
+          {loading ? (
+            <p className="text-sm text-muted-foreground flex items-center gap-1">
+              <Loader2 className="h-4 w-4 animate-spin" />
+              加载中…
+            </p>
+          ) : links.length === 0 ? (
+            <p className="text-sm text-muted-foreground py-4">
+              暂无云文档入口。添加后将显示在左侧边栏「云文档」区域，点击即可在新标签页打开。
+            </p>
+          ) : (
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>名称</TableHead>
+                  <TableHead>链接</TableHead>
+                  <TableHead className="w-[120px]">操作</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {links.map((item) => (
+                  <TableRow key={item.id}>
+                    <TableCell className="font-medium">{item.name}</TableCell>
+                    <TableCell>
+                      <a
+                        href={item.url}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-primary hover:underline truncate max-w-[280px] inline-block"
+                      >
+                        {item.url}
+                      </a>
+                    </TableCell>
+                    <TableCell>
+                      <div className="flex items-center gap-1">
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => openEdit(item)}
+                          title="编辑"
+                        >
+                          <Pencil className="h-4 w-4" />
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => handleDelete(item.id)}
+                          title="删除"
+                        >
+                          <Trash2 className="h-4 w-4 text-destructive" />
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          asChild
+                          title="打开"
+                        >
+                          <a href={item.url} target="_blank" rel="noopener noreferrer">
+                            <ExternalLink className="h-4 w-4" />
+                          </a>
+                        </Button>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          )}
+        </CardContent>
+      </Card>
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>
+              {editingId ? "编辑云文档入口" : "添加云文档入口"}
+            </DialogTitle>
+          </DialogHeader>
+          <form onSubmit={handleSubmit}>
+            <div className="grid gap-4 py-4">
+              <div className="grid gap-2">
+                <Label htmlFor="cloud-doc-name">显示名称</Label>
+                <Input
+                  id="cloud-doc-name"
+                  value={form.name}
+                  onChange={(e) => setForm((f) => ({ ...f, name: e.target.value }))}
+                  placeholder="如：腾讯文档、飞书、语雀"
+                />
+              </div>
+              <div className="grid gap-2">
+                <Label htmlFor="cloud-doc-url">登录/入口链接</Label>
+                <Input
+                  id="cloud-doc-url"
+                  type="url"
+                  value={form.url}
+                  onChange={(e) => setForm((f) => ({ ...f, url: e.target.value }))}
+                  placeholder="https://..."
+                />
+              </div>
+            </div>
+            <DialogFooter>
+              <Button
+                type="button"
+                variant="outline"
+                onClick={() => setDialogOpen(false)}
+              >
+                取消
+              </Button>
+              <Button type="submit" disabled={saving}>
+                {saving && <Loader2 className="h-4 w-4 animate-spin mr-1" />}
+                {editingId ? "保存" : "添加"}
+              </Button>
+            </DialogFooter>
+          </form>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

frontend/app/(main)/settings/email/page.tsx

@@ -0,0 +1,364 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import {
+  emailConfigsApi,
+  type EmailConfigRead,
+  type EmailConfigCreate,
+  type EmailConfigUpdate,
+  type EmailFolder,
+} from "@/lib/api/client";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Loader2, Mail, Plus, Pencil, Trash2, FolderOpen } from "lucide-react";
+import { toast } from "sonner";
+
+export default function SettingsEmailPage() {
+  const [configs, setConfigs] = useState<EmailConfigRead[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [editingId, setEditingId] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [form, setForm] = useState({
+    host: "",
+    port: "993",
+    user: "",
+    password: "",
+    mailbox: "INBOX",
+    active: true,
+  });
+  const [folders, setFolders] = useState<EmailFolder[] | null>(null);
+  const [foldersLoading, setFoldersLoading] = useState(false);
+
+  const loadConfigs = useCallback(async () => {
+    try {
+      const list = await emailConfigsApi.list();
+      setConfigs(list);
+    } catch {
+      toast.error("加载邮箱列表失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    loadConfigs();
+  }, [loadConfigs]);
+
+  const openAdd = () => {
+    setEditingId(null);
+    setForm({
+      host: "",
+      port: "993",
+      user: "",
+      password: "",
+      mailbox: "INBOX",
+      active: true,
+    });
+    setDialogOpen(true);
+  };
+
+  const openEdit = (c: EmailConfigRead) => {
+    setEditingId(c.id);
+    setFolders(null);
+    setForm({
+      host: c.host,
+      port: String(c.port),
+      user: c.user,
+      password: "",
+      mailbox: c.mailbox || "INBOX",
+      active: c.active,
+    });
+    setDialogOpen(true);
+  };
+
+  const loadFolders = async () => {
+    if (!editingId) return;
+    setFoldersLoading(true);
+    try {
+      const res = await emailConfigsApi.listFolders(editingId);
+      setFolders(res.folders);
+      if (res.folders.length > 0 && !form.mailbox) {
+        const inbox = res.folders.find((f) => f.decoded === "INBOX" || f.decoded === "收件箱");
+        if (inbox) setForm((f) => ({ ...f, mailbox: inbox.decoded }));
+      }
+      toast.success(`已加载 ${res.folders.length} 个邮箱夹`);
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "获取邮箱列表失败");
+    } finally {
+      setFoldersLoading(false);
+    }
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setSaving(true);
+    try {
+      if (editingId) {
+        const payload: EmailConfigUpdate = {
+          host: form.host,
+          port: parseInt(form.port, 10) || 993,
+          user: form.user,
+          mailbox: form.mailbox,
+          active: form.active,
+        };
+        if (form.password) payload.password = form.password;
+        await emailConfigsApi.update(editingId, payload);
+        toast.success("已更新");
+      } else {
+        await emailConfigsApi.create({
+          host: form.host,
+          port: parseInt(form.port, 10) || 993,
+          user: form.user,
+          password: form.password,
+          mailbox: form.mailbox,
+          active: form.active,
+        });
+        toast.success("已添加");
+      }
+      setDialogOpen(false);
+      await loadConfigs();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const handleDelete = async (id: string) => {
+    if (!confirm("确定删除该邮箱账户？")) return;
+    try {
+      await emailConfigsApi.delete(id);
+      toast.success("已删除");
+      await loadConfigs();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "删除失败");
+    }
+  };
+
+  return (
+    <div className="p-6 max-w-4xl">
+      <div className="mb-4">
+        <a href="/settings" className="text-sm text-muted-foreground hover:text-foreground">
+          ← 设置
+        </a>
+      </div>
+      <Card>
+        <CardHeader>
+          <div className="flex flex-wrap items-center justify-between gap-3">
+            <div>
+              <CardTitle className="flex items-center gap-2">
+                <Mail className="h-5 w-5" />
+                邮箱账户
+              </CardTitle>
+              <p className="text-sm text-muted-foreground mt-1">
+                配置多个邮箱用于财务邮件同步（发票、回执、流水）。同步时将遍历所有已启用的账户。
+              </p>
+            </div>
+            <Button onClick={openAdd}>
+              <Plus className="h-4 w-4" />
+              <span className="ml-2">添加账户</span>
+            </Button>
+          </div>
+        </CardHeader>
+        <CardContent>
+          {loading ? (
+            <p className="text-sm text-muted-foreground flex items-center gap-1">
+              <Loader2 className="h-4 w-4 animate-spin" />
+              加载中…
+            </p>
+          ) : configs.length === 0 ? (
+            <p className="text-sm text-muted-foreground py-4">
+              暂无邮箱账户。添加后将在「财务归档」同步时使用；未添加时使用环境变量 IMAP_*。
+            </p>
+          ) : (
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>Host</TableHead>
+                  <TableHead>端口</TableHead>
+                  <TableHead>邮箱</TableHead>
+                  <TableHead>Mailbox</TableHead>
+                  <TableHead>状态</TableHead>
+                  <TableHead className="w-[120px]">操作</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {configs.map((c) => (
+                  <TableRow key={c.id}>
+                    <TableCell className="font-medium">{c.host}</TableCell>
+                    <TableCell>{c.port}</TableCell>
+                    <TableCell>{c.user}</TableCell>
+                    <TableCell className="text-muted-foreground">{c.mailbox}</TableCell>
+                    <TableCell>
+                      {c.active ? (
+                        <span className="text-xs bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-400 px-2 py-0.5 rounded">
+                          启用
+                        </span>
+                      ) : (
+                        <span className="text-xs text-muted-foreground">禁用</span>
+                      )}
+                    </TableCell>
+                    <TableCell>
+                      <div className="flex items-center gap-1">
+                        <Button variant="ghost" size="sm" onClick={() => openEdit(c)}>
+                          <Pencil className="h-3.5 w-3.5" />
+                        </Button>
+                        <Button variant="ghost" size="sm" onClick={() => handleDelete(c.id)}>
+                          <Trash2 className="h-3.5 w-3.5 text-destructive" />
+                        </Button>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          )}
+        </CardContent>
+      </Card>
+
+      <Card className="mt-4">
+        <CardHeader className="py-3">
+          <CardTitle className="text-sm">网易 163 邮箱配置说明</CardTitle>
+        </CardHeader>
+        <CardContent className="text-sm text-muted-foreground space-y-2 py-2">
+          <p><strong>IMAP 服务器：</strong> imap.163.com，端口 993（SSL）。需在网易邮箱网页端开启「IMAP/SMTP 服务」。</p>
+          <p><strong>密码：</strong> 使用「授权码」而非登录密码。在 设置 → POP3/SMTP/IMAP → 授权码管理 中生成。</p>
+          <p><strong>邮箱夹：</strong> 填 INBOX 或 收件箱；若同步失败，请编辑该账户并点击「获取邮箱列表」选择「收件箱」或目标标签。</p>
+        </CardContent>
+      </Card>
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent className="sm:max-w-md">
+          <DialogHeader>
+            <DialogTitle>{editingId ? "编辑邮箱账户" : "添加邮箱账户"}</DialogTitle>
+          </DialogHeader>
+          <form onSubmit={handleSubmit} className="space-y-4">
+            <div className="grid gap-2">
+              <Label>IMAP Host</Label>
+              <Input
+                value={form.host}
+                onChange={(e) => setForm((f) => ({ ...f, host: e.target.value }))}
+                placeholder="imap.163.com"
+                required
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>端口</Label>
+              <Input
+                type="number"
+                value={form.port}
+                onChange={(e) => setForm((f) => ({ ...f, port: e.target.value }))}
+                placeholder="993"
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>邮箱 / 用户名</Label>
+              <Input
+                type="email"
+                value={form.user}
+                onChange={(e) => setForm((f) => ({ ...f, user: e.target.value }))}
+                placeholder="user@example.com"
+                required
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>密码 / 授权码 {editingId && "(留空则不修改)"}</Label>
+              <Input
+                type="password"
+                value={form.password}
+                onChange={(e) => setForm((f) => ({ ...f, password: e.target.value }))}
+                placeholder={editingId ? "••••••••" : "请输入"}
+                autoComplete="off"
+                required={!editingId}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label>邮箱夹 / 自定义标签 (Mailbox)</Label>
+              {editingId && (
+                <div className="flex gap-2">
+                  <Button
+                    type="button"
+                    variant="outline"
+                    size="sm"
+                    onClick={loadFolders}
+                    disabled={foldersLoading}
+                  >
+                    {foldersLoading ? <Loader2 className="h-4 w-4 animate-spin" /> : <FolderOpen className="h-4 w-4" />}
+                    <span className="ml-1">获取邮箱列表</span>
+                  </Button>
+                </div>
+              )}
+              {folders && folders.length > 0 ? (
+                <Select
+                  value={form.mailbox}
+                  onValueChange={(v) => setForm((f) => ({ ...f, mailbox: v }))}
+                >
+                  <SelectTrigger>
+                    <SelectValue placeholder="选择邮箱夹" />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {folders.map((f) => (
+                      <SelectItem key={f.raw} value={f.decoded}>
+                        {f.decoded}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              ) : (
+                <Input
+                  value={form.mailbox}
+                  onChange={(e) => setForm((f) => ({ ...f, mailbox: e.target.value }))}
+                  placeholder="INBOX、收件箱或自定义标签（163 等若 INBOX 失败会自动尝试收件箱）"
+                />
+              )}
+            </div>
+            <div className="flex items-center gap-2">
+              <input
+                type="checkbox"
+                id="active"
+                checked={form.active}
+                onChange={(e) => setForm((f) => ({ ...f, active: e.target.checked }))}
+                className="rounded border-input"
+              />
+              <Label htmlFor="active">启用（参与同步）</Label>
+            </div>
+            <DialogFooter>
+              <Button type="button" variant="outline" onClick={() => setDialogOpen(false)}>
+                取消
+              </Button>
+              <Button type="submit" disabled={saving}>
+                {saving ? <Loader2 className="h-4 w-4 animate-spin" /> : null}
+                <span className="ml-2">{editingId ? "保存" : "添加"}</span>
+              </Button>
+            </DialogFooter>
+          </form>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

frontend/app/(main)/settings/page.tsx

@@ -0,0 +1,50 @@
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { FileSpreadsheet, FileText, Mail, FileStack, Globe } from "lucide-react";
+
+export default function SettingsPage() {
+  return (
+    <div className="p-6 max-w-2xl">
+      <h1 className="text-xl font-semibold">设置</h1>
+      <p className="text-sm text-muted-foreground mt-1">系统与业务配置</p>
+      <div className="mt-6 flex flex-col gap-2">
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/templates" className="flex items-center gap-2">
+            <FileSpreadsheet className="h-4 w-4" />
+            模板管理（报价 Excel / 合同 Word）
+          </Link>
+        </Button>
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/ai" className="flex items-center gap-2">
+            <FileText className="h-4 w-4" />
+            AI 模型配置
+          </Link>
+        </Button>
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/email" className="flex items-center gap-2">
+            <Mail className="h-4 w-4" />
+            邮箱账户（多账户同步）
+          </Link>
+        </Button>
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/cloud-docs" className="flex items-center gap-2">
+            <FileStack className="h-4 w-4" />
+            云文档快捷入口
+          </Link>
+        </Button>
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/cloud-doc-config" className="flex items-center gap-2">
+            <FileStack className="h-4 w-4" />
+            云文档配置（飞书 / 语雀 / 腾讯文档 API 凭证）
+          </Link>
+        </Button>
+        <Button variant="outline" className="justify-start" asChild>
+          <Link href="/settings/portal-links" className="flex items-center gap-2">
+            <Globe className="h-4 w-4" />
+            快捷门户
+          </Link>
+        </Button>
+      </div>
+    </div>
+  );
+}

frontend/app/(main)/settings/portal-links/page.tsx

@@ -0,0 +1,256 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import Link from "next/link";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Dialog,
+  DialogContent,
+  DialogHeader,
+  DialogTitle,
+  DialogFooter,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import {
+  portalLinksApi,
+  type PortalLinkRead,
+  type PortalLinkCreate,
+} from "@/lib/api/client";
+import { Globe, Plus, Pencil, Trash2, Loader2, ExternalLink } from "lucide-react";
+import { toast } from "sonner";
+
+export default function SettingsPortalLinksPage() {
+  const [links, setLinks] = useState<PortalLinkRead[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [dialogOpen, setDialogOpen] = useState(false);
+  const [editingId, setEditingId] = useState<string | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [form, setForm] = useState({ name: "", url: "" });
+
+  const loadLinks = useCallback(async () => {
+    try {
+      const list = await portalLinksApi.list();
+      setLinks(list);
+    } catch {
+      toast.error("加载快捷门户列表失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    loadLinks();
+  }, [loadLinks]);
+
+  const openAdd = () => {
+    setEditingId(null);
+    setForm({ name: "", url: "" });
+    setDialogOpen(true);
+  };
+
+  const openEdit = (item: PortalLinkRead) => {
+    setEditingId(item.id);
+    setForm({ name: item.name, url: item.url });
+    setDialogOpen(true);
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (!form.name.trim() || !form.url.trim()) {
+      toast.error("请填写名称和链接");
+      return;
+    }
+    setSaving(true);
+    try {
+      if (editingId) {
+        await portalLinksApi.update(editingId, {
+          name: form.name.trim(),
+          url: form.url.trim(),
+        });
+        toast.success("已更新");
+      } else {
+        const payload: PortalLinkCreate = {
+          name: form.name.trim(),
+          url: form.url.trim(),
+        };
+        await portalLinksApi.create(payload);
+        toast.success("已添加");
+      }
+      setDialogOpen(false);
+      await loadLinks();
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("portal-links-changed"));
+      }
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "保存失败");
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const handleDelete = async (id: string) => {
+    if (!confirm("确定删除该快捷门户入口？")) return;
+    try {
+      await portalLinksApi.delete(id);
+      toast.success("已删除");
+      await loadLinks();
+      if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("portal-links-changed"));
+      }
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "删除失败");
+    }
+  };
+
+  return (
+    <div className="p-6 max-w-4xl">
+      <div className="mb-4">
+        <Link
+          href="/settings"
+          className="text-sm text-muted-foreground hover:text-foreground"
+        >
+          ← 设置
+        </Link>
+      </div>
+      <Card>
+        <CardHeader>
+          <div className="flex flex-wrap items-center justify-between gap-3">
+            <div>
+              <CardTitle className="flex items-center gap-2">
+                <Globe className="h-5 w-5" />
+                快捷门户
+              </CardTitle>
+              <p className="text-sm text-muted-foreground mt-1">
+                添加税务、公积金等门户链接，侧栏可快速打开。
+              </p>
+            </div>
+            <Button onClick={openAdd}>
+              <Plus className="h-4 w-4" />
+              <span className="ml-2">添加入口</span>
+            </Button>
+          </div>
+        </CardHeader>
+        <CardContent>
+          {loading ? (
+            <p className="text-sm text-muted-foreground flex items-center gap-1">
+              <Loader2 className="h-4 w-4 animate-spin" />
+              加载中…
+            </p>
+          ) : links.length === 0 ? (
+            <p className="text-sm text-muted-foreground py-4">
+              暂无快捷门户入口。添加后将显示在左侧边栏「快捷门户」区域。
+            </p>
+          ) : (
+            <Table>
+              <TableHeader>
+                <TableRow>
+                  <TableHead>名称</TableHead>
+                  <TableHead>链接</TableHead>
+                  <TableHead className="w-[120px]">操作</TableHead>
+                </TableRow>
+              </TableHeader>
+              <TableBody>
+                {links.map((item) => (
+                  <TableRow key={item.id}>
+                    <TableCell className="font-medium">{item.name}</TableCell>
+                    <TableCell>
+                      <a
+                        href={item.url}
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-primary hover:underline truncate max-w-[280px] inline-block"
+                      >
+                        {item.url}
+                      </a>
+                    </TableCell>
+                    <TableCell>
+                      <div className="flex items-center gap-1">
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => openEdit(item)}
+                          title="编辑"
+                        >
+                          <Pencil className="h-4 w-4" />
+                        </Button>
+                        <Button
+                          variant="ghost"
+                          size="sm"
+                          onClick={() => handleDelete(item.id)}
+                          title="删除"
+                        >
+                          <Trash2 className="h-4 w-4 text-destructive" />
+                        </Button>
+                        <Button variant="ghost" size="sm" asChild title="打开">
+                          <a href={item.url} target="_blank" rel="noopener noreferrer">
+                            <ExternalLink className="h-4 w-4" />
+                          </a>
+                        </Button>
+                      </div>
+                    </TableCell>
+                  </TableRow>
+                ))}
+              </TableBody>
+            </Table>
+          )}
+        </CardContent>
+      </Card>
+
+      <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>
+              {editingId ? "编辑快捷门户入口" : "添加快捷门户入口"}
+            </DialogTitle>
+          </DialogHeader>
+          <form onSubmit={handleSubmit}>
+            <div className="grid gap-4 py-4">
+              <div className="grid gap-2">
+                <Label htmlFor="portal-name">显示名称</Label>
+                <Input
+                  id="portal-name"
+                  value={form.name}
+                  onChange={(e) => setForm((f) => ({ ...f, name: e.target.value }))}
+                  placeholder="如：电子税务局、公积金"
+                />
+              </div>
+              <div className="grid gap-2">
+                <Label htmlFor="portal-url">门户链接</Label>
+                <Input
+                  id="portal-url"
+                  type="url"
+                  value={form.url}
+                  onChange={(e) => setForm((f) => ({ ...f, url: e.target.value }))}
+                  placeholder="https://..."
+                />
+              </div>
+            </div>
+            <DialogFooter>
+              <Button
+                type="button"
+                variant="outline"
+                onClick={() => setDialogOpen(false)}
+              >
+                取消
+              </Button>
+              <Button type="submit" disabled={saving}>
+                {saving && <Loader2 className="h-4 w-4 animate-spin mr-1" />}
+                {editingId ? "保存" : "添加"}
+              </Button>
+            </DialogFooter>
+          </form>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

frontend/app/(main)/settings/templates/page.tsx

@@ -0,0 +1,175 @@
+"use client";
+
+import { useState, useEffect, useCallback } from "react";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Table,
+  TableBody,
+  TableCell,
+  TableHead,
+  TableHeader,
+  TableRow,
+} from "@/components/ui/table";
+import { templatesApi, type TemplateInfo } from "@/lib/api/client";
+import { Upload, Loader2, FileSpreadsheet, FileText } from "lucide-react";
+import { toast } from "sonner";
+
+export default function SettingsTemplatesPage() {
+  const [templates, setTemplates] = useState<TemplateInfo[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [uploading, setUploading] = useState(false);
+  const [dragOver, setDragOver] = useState(false);
+
+  const loadTemplates = useCallback(async () => {
+    try {
+      const list = await templatesApi.list();
+      setTemplates(list);
+    } catch {
+      toast.error("加载模板列表失败");
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    loadTemplates();
+  }, [loadTemplates]);
+
+  const handleFile = async (file: File) => {
+    const ext = file.name.toLowerCase().slice(file.name.lastIndexOf("."));
+    if (![".xlsx", ".xltx", ".docx", ".dotx"].includes(ext)) {
+      toast.error("仅支持 .xlsx、.xltx、.docx、.dotx 文件");
+      return;
+    }
+    setUploading(true);
+    try {
+      await templatesApi.upload(file);
+      toast.success(`已上传：${file.name}`);
+      await loadTemplates();
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : "上传失败");
+    } finally {
+      setUploading(false);
+    }
+  };
+
+  const onDrop = (e: React.DragEvent) => {
+    e.preventDefault();
+    setDragOver(false);
+    const file = e.dataTransfer.files[0];
+    if (file) handleFile(file);
+  };
+
+  const onDragOver = (e: React.DragEvent) => {
+    e.preventDefault();
+    setDragOver(true);
+  };
+
+  const onDragLeave = () => setDragOver(false);
+
+  const onSelectFile = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0];
+    if (file) handleFile(file);
+    e.target.value = "";
+  };
+
+  const formatDate = (ts: number) =>
+    new Date(ts * 1000).toLocaleString("zh-CN", {
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+    });
+
+  return (
+    <div className="p-6 max-w-4xl">
+      <div className="mb-4">
+        <a href="/settings" className="text-sm text-muted-foreground hover:text-foreground">
+          ← 设置
+        </a>
+      </div>
+      <Card>
+        <CardHeader>
+          <CardTitle>模板库</CardTitle>
+          <p className="text-sm text-muted-foreground">
+            上传报价单 Excel（.xlsx / .xltx）或合同 Word（.docx / .dotx），生成报价/合同时可选择使用。
+          </p>
+        </CardHeader>
+        <CardContent className="space-y-6">
+          <div
+            onDrop={onDrop}
+            onDragOver={onDragOver}
+            onDragLeave={onDragLeave}
+            className={`border-2 border-dashed rounded-lg p-8 text-center transition-colors ${
+              dragOver ? "border-primary bg-primary/5" : "border-muted-foreground/25"
+            }`}
+          >
+            <input
+              type="file"
+              accept=".xlsx,.xltx,.docx,.dotx,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.openxmlformats-officedocument.spreadsheetml.template,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.openxmlformats-officedocument.wordprocessingml.template"
+              onChange={onSelectFile}
+              className="hidden"
+              id="template-upload"
+            />
+            <label htmlFor="template-upload" className="cursor-pointer block">
+              <Upload className="h-10 w-10 mx-auto text-muted-foreground" />
+              <p className="mt-2 text-sm font-medium">拖拽文件到此处，或点击选择</p>
+              <p className="text-xs text-muted-foreground mt-1">仅支持 .xlsx、.xltx、.docx、.dotx</p>
+            </label>
+            {uploading && (
+              <p className="mt-2 text-sm text-muted-foreground flex items-center justify-center gap-1">
+                <Loader2 className="h-4 w-4 animate-spin" />
+                上传中…
+              </p>
+            )}
+          </div>
+
+          <div>
+            <h3 className="text-sm font-medium mb-2">已上传模板</h3>
+            {loading ? (
+              <p className="text-sm text-muted-foreground flex items-center gap-1">
+                <Loader2 className="h-4 w-4 animate-spin" />
+                加载中…
+              </p>
+            ) : templates.length === 0 ? (
+              <p className="text-sm text-muted-foreground">暂无模板</p>
+            ) : (
+              <Table>
+                <TableHeader>
+                  <TableRow>
+                    <TableHead>类型</TableHead>
+                    <TableHead>文件名</TableHead>
+                    <TableHead>大小</TableHead>
+                    <TableHead>上传时间</TableHead>
+                  </TableRow>
+                </TableHeader>
+                <TableBody>
+                  {templates.map((t) => (
+                    <TableRow key={t.name}>
+                      <TableCell>
+                        {t.type === "excel" ? (
+                          <FileSpreadsheet className="h-4 w-4 text-green-600" />
+                        ) : (
+                          <FileText className="h-4 w-4 text-blue-600" />
+                        )}
+                      </TableCell>
+                      <TableCell className="font-medium">{t.name}</TableCell>
+                      <TableCell className="text-muted-foreground">
+                        {(t.size / 1024).toFixed(1)} KB
+                      </TableCell>
+                      <TableCell className="text-muted-foreground">
+                        {formatDate(t.uploaded_at)}
+                      </TableCell>
+                    </TableRow>
+                  ))}
+                </TableBody>
+              </Table>
+            )}
+          </div>
+        </CardContent>
+      </Card>
+    </div>
+  );
+}