Add config snapshot export and treat finished cycles as success.

Per-NE failures stay in fail_count for retry; completed cycles no longer fail the whole run. Configurations page can download txt/zip snapshots. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-09 00:50:46 +08:00 · 2026-07-31 11:02:07 +08:00 · 2026-07-31 11:02:07 +08:00 · 3fc80f55bc
commit 3fc80f55bc
parent abb5172a8f
7 changed files with 203 additions and 38 deletions
--- a/web/WEB.md
+++ b/web/WEB.md
@ -100,6 +100,7 @@ src/
 - 调度：`NETX_CONFIG_SYNC_SCHEDULER_ENABLED`（默认开），周期天数策略可配（默认 3 天）
 - 默认策略：`enabled=false`（首次无自动任务，需在页面手动开启周期调度或点「立即同步」）
 - 单飞：同一时刻只允许一个 `running|pending|paused` 周期；上轮未结束时不会开启新周期
+- 周期状态：全部任务跑完即为 `success`；单网元失败只计入 `fail_count`，不把整轮标为失败
 - 崩溃续跑：启动时把中断的 `running` 任务重新入队并继续，占用单飞槽位，避免与新周期重叠
 - 进程启动宽限：`NETX_CONFIG_SYNC_STARTUP_GRACE_SEC`（默认 3600）仅约束**新建**自动周期，不影响续跑
 - 前端：`/network/tasks/config-sync`（看板）+ `/network/configs`（查看）
--- a/web/src/i18n/en.ts
+++ b/web/src/i18n/en.ts
@ -122,6 +122,9 @@ const en = {
    allSource: "All sources",
    empty: "No synced configs yet. Run Config sync first.",
    view: "View",
+    export: "Export",
+    exportBoth: "Export all",
+    exportOk: "Config exported",
    close: "Close",
    tabSet: "Set format",
    tabHier: "Hierarchical",
--- a/web/src/i18n/zh.ts
+++ b/web/src/i18n/zh.ts
@ -122,6 +122,9 @@ const zh = {
    allSource: "全部来源",
    empty: "暂无已同步配置。请先在「配置同步」执行采集。",
    view: "查看",
+    export: "导出",
+    exportBoth: "导出全部",
+    exportOk: "配置已导出",
    close: "关闭",
    tabSet: "Set 格式",
    tabHier: "层级格式",
--- a/web/src/pages/network/NetworkConfigsPage.tsx
+++ b/web/src/pages/network/NetworkConfigsPage.tsx
@ -1,9 +1,14 @@
 import { useState } from "react";
 import { Link } from "react-router-dom";
 import { useQuery } from "@tanstack/react-query";
-import { fetchNeConfigSnapshotDetail, fetchNeConfigSnapshots } from "../../services/api";
+import {
+  downloadNeConfigSnapshot,
+  fetchNeConfigSnapshotDetail,
+  fetchNeConfigSnapshots,
+} from "../../services/api";
 import { queryKeys } from "../../constants/queryKeys";
 import { useI18n } from "../../i18n";
+import { useToast } from "../../hooks/useToast";
 import { pageCount } from "../../utils/display";
 import { formatSystemTime } from "../../utils/time";

@ -16,12 +21,14 @@ function fmtBytes(n: number): string {

 export function NetworkConfigsPage() {
  const { t } = useI18n();
+  const { showOk, showError } = useToast();
  const [page, setPage] = useState(1);
  const [keyword, setKeyword] = useState("");
  const [source, setSource] = useState("");
  const [vendor, setVendor] = useState("");
  const [selected, setSelected] = useState<{ source: string; id: string } | null>(null);
  const [tab, setTab] = useState<"primary" | "alt">("primary");
+  const [exporting, setExporting] = useState("");

  const listQuery = useQuery({
    queryKey: queryKeys.networkConfigs(page, keyword, source, vendor),
@ -43,6 +50,23 @@ export function NetworkConfigsPage() {
  const detail = detailQuery.data;
  const showAlt = Boolean(detail?.has_alt);

+  const exportConfig = async (
+    src: string,
+    id: string,
+    field: "primary" | "alt" | "both",
+  ) => {
+    const key = `${src}:${id}:${field}`;
+    setExporting(key);
+    try {
+      await downloadNeConfigSnapshot(src, id, field);
+      showOk(t("networkConfigs.exportOk"));
+    } catch (err) {
+      showError(String(err));
+    } finally {
+      setExporting("");
+    }
+  };
+
  return (
    <section className="panel">
      <div className="panel__toolbar">
@ -106,33 +130,46 @@ export function NetworkConfigsPage() {
          </tr>
        </thead>
        <tbody>
-          {items.map((row) => (
-            <tr key={`${row.source}:${row.target_id}`}>
-              <td>{row.ne_name || row.target_id}</td>
-              <td>{row.ne_ip}</td>
-              <td>{row.vendor || "-"}</td>
-              <td>{row.source}</td>
-              <td>{fmtBytes(row.plain_size)}</td>
-              <td>{row.collected_at ? formatSystemTime(row.collected_at) : "-"}</td>
-              <td>
-                <button
-                  type="button"
-                  onClick={() => {
-                    setSelected({ source: row.source, id: row.target_id });
-                    setTab("primary");
-                  }}
-                >
-                  {t("networkConfigs.view")}
-                </button>
-                <Link
-                  to={`/webcrt?${row.source === "ume" ? "ume_ne_id" : "ne_id"}=${encodeURIComponent(row.target_id)}`}
-                  style={{ marginLeft: 8 }}
-                >
-                  WebCRT
-                </Link>
-              </td>
-            </tr>
-          ))}
+          {items.map((row) => {
+            const exportKey = `${row.source}:${row.target_id}:list`;
+            return (
+              <tr key={`${row.source}:${row.target_id}`}>
+                <td>{row.ne_name || row.target_id}</td>
+                <td>{row.ne_ip}</td>
+                <td>{row.vendor || "-"}</td>
+                <td>{row.source}</td>
+                <td>{fmtBytes(row.plain_size)}</td>
+                <td>{row.collected_at ? formatSystemTime(row.collected_at) : "-"}</td>
+                <td className="table-actions">
+                  <button
+                    type="button"
+                    className="link-btn"
+                    onClick={() => {
+                      setSelected({ source: row.source, id: row.target_id });
+                      setTab("primary");
+                    }}
+                  >
+                    {t("networkConfigs.view")}
+                  </button>
+                  <button
+                    type="button"
+                    className="link-btn"
+                    disabled={exporting === exportKey || exporting.startsWith(`${row.source}:${row.target_id}:`)}
+                    onClick={() =>
+                      void exportConfig(row.source, row.target_id, row.has_alt ? "both" : "primary")
+                    }
+                  >
+                    {t("networkConfigs.export")}
+                  </button>
+                  <Link
+                    to={`/webcrt?${row.source === "ume" ? "ume_ne_id" : "ne_id"}=${encodeURIComponent(row.target_id)}`}
+                  >
+                    WebCRT
+                  </Link>
+                </td>
+              </tr>
+            );
+          })}
          {!items.length && !listQuery.isLoading ? (
            <tr>
              <td colSpan={7} className="muted">
@ -164,9 +201,33 @@ export function NetworkConfigsPage() {
                ({selected.source} / {detail?.ne_ip || "-"})
              </span>
            </h3>
-            <button type="button" onClick={() => setSelected(null)}>
-              {t("networkConfigs.close")}
-            </button>
+            <div className="btn-row">
+              <button
+                type="button"
+                disabled={Boolean(exporting)}
+                onClick={() =>
+                  void exportConfig(
+                    selected.source,
+                    selected.id,
+                    showAlt ? (tab === "alt" ? "alt" : "primary") : "primary",
+                  )
+                }
+              >
+                {t("networkConfigs.export")}
+              </button>
+              {showAlt ? (
+                <button
+                  type="button"
+                  disabled={Boolean(exporting)}
+                  onClick={() => void exportConfig(selected.source, selected.id, "both")}
+                >
+                  {t("networkConfigs.exportBoth")}
+                </button>
+              ) : null}
+              <button type="button" onClick={() => setSelected(null)}>
+                {t("networkConfigs.close")}
+              </button>
+            </div>
          </div>
          {detailQuery.isLoading ? <p className="muted">{t("common.refreshing")}</p> : null}
          {showAlt ? (
--- a/web/src/services/api.ts
+++ b/web/src/services/api.ts
@ -745,3 +745,37 @@ export const fetchNeConfigSnapshotDetail = (
  apiGet<NeConfigSnapshotDetail>(
    `/v1/config-sync/snapshots/${encodeURIComponent(source)}/${encodeURIComponent(targetId)}?field=${field}`,
  );
+
+export const downloadNeConfigSnapshot = async (
+  source: string,
+  targetId: string,
+  field: "primary" | "alt" | "both" = "primary",
+): Promise<void> => {
+  const path =
+    `/v1/config-sync/snapshots/${encodeURIComponent(source)}/${encodeURIComponent(targetId)}` +
+    `/download?field=${encodeURIComponent(field)}`;
+  const res = await fetch(path, { headers: authHeaders() });
+  if (res.status === 401) {
+    handleUnauthorized(path);
+    throw new Error("unauthorized");
+  }
+  if (!res.ok) throw new Error(`${res.status} download`);
+  const blob = await res.blob();
+  const cd = res.headers.get("content-disposition") || "";
+  const star = /filename\*=UTF-8''([^;]+)/i.exec(cd);
+  const plain = /filename="?([^";]+)"?/i.exec(cd);
+  const filename = star
+    ? decodeURIComponent(star[1])
+    : plain
+      ? plain[1]
+      : `ne-config-${source}-${targetId}.txt`;
+  const url = URL.createObjectURL(blob);
+  try {
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = filename;
+    a.click();
+  } finally {
+    URL.revokeObjectURL(url);
+  }
+};