feat: 添加流量进度条样式选项，优化相关组件

README.md

@@ -63,8 +63,8 @@
 | 名称 | 配置项 | 类型 | 默认值 | 说明 |
 | :--- | :--- | :--- | :--- | :--- |
 | 背景图片链接 | `backgroundImage` | `string` | `/assets/Moonlit-Scenery.webp` | 目前仅支持单张背景图片（eg: https://test.com/1.png ） |
-| 启用视频背景 | `enableVedioBackground` | `switch` | `false` | 启用后将使用视频作为背景 |
-| 视频背景链接 | `vedioBackgroundUrl` | `string` | `/assets/LanternRivers_1080p15fps2Mbps3s.mp4` | 视频背景链接（eg: https://test.com/1.mp4 ），建议使用无声视频，且视频文件较大时可能会影响加载速度 |
+| 启用视频背景 | `enableVideoBackground` | `switch` | `false` | 启用后将使用视频作为背景 |
+| 视频背景链接 | `videoBackgroundUrl` | `string` | `/assets/LanternRivers_1080p15fps2Mbps3s.mp4` | 视频背景链接（eg: https://test.com/1.mp4 ），建议使用无声视频，且视频文件较大时可能会影响加载速度 |
 | 启用磨砂玻璃效果 | `enableBlur` | `switch` | `true` | 启用后将使主要容器拥有磨砂玻璃效果 |
 | 磨砂玻璃模糊值 | `blurValue` | `number` | `10` | 调整模糊值大小，数值越大模糊效果越明显，建议值为 5-20，为 0 则表示不启用模糊效果 |
 | 磨砂玻璃背景色 | `blurBackgroundColor` | `string` | `rgba(255, 255, 255, 0.5)\|rgba(0, 0, 0, 0.5)` | 调整模糊背景色，推荐 rgba 颜色值，使用“\|”分隔亮色模式和暗色模式的颜色值（eg: rgba(255, 255, 255, 0.5)\|rgba(0, 0, 0, 0.5)） |
@@ -93,6 +93,7 @@
 | 启用统计栏 | `enableStatsBar` | `switch` | `true` | 启用后默认显示统计栏 |
 | 启用分组栏 | `enableGroupedBar` | `switch` | `true` | 启用后默认显示分组栏 |
 | 启用 SWAP 显示 | `enableSwap` | `switch` | `true` | 启用后默认显示 SWAP 信息 |
+| 流量进度条样式 | `selectTrafficProgressStyle` | `select` | `circular` | 设置流量进度条样式为 circular（环形）或 linear（线形） |
 | 启用列表视图进度条 | `enableListItemProgressBar` | `switch` | `true` | 启用后列表视图中将会显示进度条来表示使用率 |
 
 #### Instance 设置

komari-theme.json

@@ -172,6 +172,14 @@
                 "default": true,
                 "help": "启用后默认显示 SWAP 信息"
             },
+            {
+                "key": "selectTrafficProgressStyle",
+                "name": "流量进度条样式",
+                "type": "select",
+                "options": "circular,linear",
+                "default": "circular",
+                "help": "设置流量进度条样式为 circular（环形）或 linear（线形）"
+            },
             {
                 "key": "enableListItemProgressBar",
                 "name": "启用列表视图进度条",

src/components/sections/NodeCard.tsx

@@ -16,10 +16,15 @@ import { CircleProgress } from "../ui/progress-circle";
 
 interface NodeCardProps {
   node: NodeWithStatus;
-  enableSwap: boolean | undefined;
+  enableSwap: boolean;
+  selectTrafficProgressStyle: "circular" | "linear";
 }
 
-export const NodeCard = ({ node, enableSwap }: NodeCardProps) => {
+export const NodeCard = ({
+  node,
+  enableSwap,
+  selectTrafficProgressStyle,
+}: NodeCardProps) => {
   const {
     stats,
     isOnline,
@@ -113,6 +118,36 @@ export const NodeCard = ({ node, enableSwap }: NodeCardProps) => {
             <span className="w-12 text-right">{diskUsage.toFixed(0)}%</span>
           </div>
         </div>
+        {selectTrafficProgressStyle === "linear" && isOnline && stats && (
+          <div>
+            <div className="flex items-center justify-between">
+              <span className="text-secondary-foreground">流量</span>
+              <div className="w-3/4 flex items-center gap-2">
+                <ProgressBar value={trafficPercentage} />
+                <span className="w-12 text-right">
+                  {node.traffic_limit !== 0
+                    ? `${trafficPercentage.toFixed(0)}%`
+                    : "OFF"}
+                </span>
+              </div>
+            </div>
+            <div className="flex text-xs items-center justify-between text-secondary-foreground">
+              <span>
+                {formatTrafficLimit(
+                  node.traffic_limit,
+                  node.traffic_limit_type
+                )}
+              </span>
+              <span>
+                {stats
+                  ? `↑ ${formatBytes(stats.network.totalUp)} ↓ ${formatBytes(
+                      stats.network.totalDown
+                    )}`
+                  : "N/A"}
+              </span>
+            </div>
+          </div>
+        )}
         <div className="border-t border-(--accent-4)/50 my-2"></div>
         <div className="flex justify-between text-xs">
           <span className="text-secondary-foreground">网络：</span>
@@ -123,40 +158,42 @@ export const NodeCard = ({ node, enableSwap }: NodeCardProps) => {
             </span>
           </div>
         </div>
-        <div className="flex items-center justify-between text-xs">
-          <span className="text-secondary-foreground w-1/5">流量</span>
-          <div className="flex items-center justify-between w-4/5">
-            <div className="flex items-center w-1/4">
-              {node.traffic_limit !== 0 && isOnline && stats && (
-                <CircleProgress
-                  value={trafficPercentage}
-                  maxValue={100}
-                  size={32}
-                  strokeWidth={4}
-                  showPercentage={true}
-                />
-              )}
-            </div>
-            <div className="w-3/4 text-right">
-              <div>
-                <span>
-                  ↑ {stats ? formatBytes(stats.network.totalUp) : "N/A"}
-                </span>
-                <span className="ml-2">
-                  ↓ {stats ? formatBytes(stats.network.totalDown) : "N/A"}
-                </span>
+        {selectTrafficProgressStyle === "circular" && isOnline && stats && (
+          <div className="flex items-center justify-between text-xs">
+            <span className="text-secondary-foreground w-1/5">流量</span>
+            <div className="flex items-center justify-between w-4/5">
+              <div className="flex items-center w-1/4">
+                {node.traffic_limit !== 0 && (
+                  <CircleProgress
+                    value={trafficPercentage}
+                    maxValue={100}
+                    size={32}
+                    strokeWidth={4}
+                    showPercentage={true}
+                  />
+                )}
               </div>
-              {node.traffic_limit !== 0 && isOnline && stats && (
-                <div className="text-right">
-                  {formatTrafficLimit(
-                    node.traffic_limit,
-                    node.traffic_limit_type
-                  )}
+              <div className="w-3/4 text-right">
+                <div>
+                  <span>
+                    ↑ {stats ? formatBytes(stats.network.totalUp) : "N/A"}
+                  </span>
+                  <span className="ml-2">
+                    ↓ {stats ? formatBytes(stats.network.totalDown) : "N/A"}
+                  </span>
                 </div>
-              )}
+                {node.traffic_limit !== 0 && isOnline && stats && (
+                  <div className="text-right">
+                    {formatTrafficLimit(
+                      node.traffic_limit,
+                      node.traffic_limit_type
+                    )}
+                  </div>
+                )}
+              </div>
             </div>
           </div>
-        </div>
+        )}
         <div className="flex justify-between text-xs">
           <span className="text-secondary-foreground">负载</span>
           <span>{load}</span>

src/components/sections/NodeListHeader.tsx

@@ -1,5 +1,5 @@
 interface NodeListHeaderProps {
-  enableSwap: boolean | undefined;
+  enableSwap: boolean;
 }
 
 export const NodeListHeader = ({ enableSwap }: NodeListHeaderProps) => {

src/components/sections/NodeListItem.tsx

@@ -10,14 +10,16 @@ import { ProgressBar } from "../ui/progress-bar";
 
 interface NodeListItemProps {
   node: NodeWithStatus;
-  enableSwap: boolean | undefined;
-  enableListItemProgressBar: boolean | undefined;
+  enableSwap: boolean;
+  enableListItemProgressBar: boolean;
+  selectTrafficProgressStyle: "circular" | "linear";
 }
 
 export const NodeListItem = ({
   node,
   enableSwap,
   enableListItemProgressBar,
+  selectTrafficProgressStyle,
 }: NodeListItemProps) => {
   const {
     stats,
@@ -137,36 +139,72 @@ export const NodeListItem = ({
         <div>↓ {stats ? formatBytes(stats.network.down, true) : "N/A"}</div>
       </div>
       <div className="col-span-2">
-        <div className="flex items-center justify-around">
-          {node.traffic_limit !== 0 && isOnline && stats && (
-            <div className="flex items-center justify-center w-1/3">
-              <CircleProgress
-                value={trafficPercentage}
-                maxValue={100}
-                size={32}
-                strokeWidth={4}
-                showPercentage={true}
-              />
-            </div>
-          )}
-          <div
-            className={node.traffic_limit !== 0 ? "w-2/3 text-left" : "w-full"}>
-            <div>
-              <div>↑ {stats ? formatBytes(stats.network.totalUp) : "N/A"}</div>
-              <div>
-                ↓ {stats ? formatBytes(stats.network.totalDown) : "N/A"}
-              </div>
+        {selectTrafficProgressStyle === "linear" && isOnline && stats ? (
+          <div className="flex flex-col items-center">
+            <div className="w-full flex justify-center items-center">
+              <span>
+                {stats
+                  ? `↑ ${formatBytes(stats.network.totalUp)} ↓ ${formatBytes(
+                      stats.network.totalDown
+                    )}`
+                  : "N/A"}
+              </span>
             </div>
             {node.traffic_limit !== 0 && isOnline && stats && (
-              <div>
-                {formatTrafficLimit(
-                  node.traffic_limit,
-                  node.traffic_limit_type
-                )}
-              </div>
+              <>
+                <div className="w-[80%] flex items-center gap-1 mt-1">
+                  <ProgressBar value={trafficPercentage} h="h-2" />
+                  <span className="text-right text-xs">
+                    {node.traffic_limit !== 0
+                      ? `${trafficPercentage.toFixed(0)}%`
+                      : "OFF"}
+                  </span>
+                </div>
+                <div className="text-xs text-secondary-foreground mt-1">
+                  {formatTrafficLimit(
+                    node.traffic_limit,
+                    node.traffic_limit_type
+                  )}
+                </div>
+              </>
             )}
           </div>
-        </div>
+        ) : (
+          <div className="flex items-center justify-around">
+            {node.traffic_limit !== 0 && isOnline && stats && (
+              <div className="flex items-center justify-center w-1/3">
+                <CircleProgress
+                  value={trafficPercentage}
+                  maxValue={100}
+                  size={32}
+                  strokeWidth={4}
+                  showPercentage={true}
+                />
+              </div>
+            )}
+            <div
+              className={
+                node.traffic_limit !== 0 ? "w-2/3 text-left" : "w-full"
+              }>
+              <div>
+                <div>
+                  ↑ {stats ? formatBytes(stats.network.totalUp) : "N/A"}
+                </div>
+                <div>
+                  ↓ {stats ? formatBytes(stats.network.totalDown) : "N/A"}
+                </div>
+              </div>
+              {node.traffic_limit !== 0 && isOnline && stats && (
+                <div>
+                  {formatTrafficLimit(
+                    node.traffic_limit,
+                    node.traffic_limit_type
+                  )}
+                </div>
+              )}
+            </div>
+          </div>
+        )}
       </div>
       <div className="col-span-1">
         {load.split("|").map((item, index) => (

src/config/default.ts

@@ -24,6 +24,7 @@ export interface ConfigOptions {
   enableConnectBreaks?: boolean; // 是否启用连接断点
   pingChartMaxPoints?: number; // 延迟图表最大点数
   enableSwap?: boolean; // 是否启用SWAP显示
+  selectTrafficProgressStyle?: "circular" | "linear"; // 流量进度条样式
   enableListItemProgressBar?: boolean; // 是否启用列表视图进度条
 }
 
@@ -54,5 +55,6 @@ export const DEFAULT_CONFIG: ConfigOptions = {
   enableConnectBreaks: false,
   pingChartMaxPoints: 0,
   enableSwap: true,
+  selectTrafficProgressStyle: "linear",
   enableListItemProgressBar: true,
 };

src/config/hooks.ts

@@ -5,10 +5,11 @@ import { DEFAULT_CONFIG } from "./default";
 
 /**
  * 使用全局配置 Hook，用于获取当前应用配置
- * @returns 配置对象
+ * @returns 配置对象（合并了默认配置，确保所有属性都有值）
  */
-export function useAppConfig(): ConfigOptions {
-  return useContext(ConfigContext);
+export function useAppConfig(): Required<ConfigOptions> {
+  const config = useContext(ConfigContext);
+  return { ...DEFAULT_CONFIG, ...config } as Required<ConfigOptions>;
 }
 
 /**
@@ -26,3 +27,8 @@ export function useConfigItem<K extends keyof ConfigOptions>(
 
 // 导出配置类型
 export type { ConfigOptions } from "./default";
+
+/**
+ * 应用配置类型
+ */
+export type AppConfig = Required<ConfigOptions>;

src/pages/Home.tsx

@@ -43,6 +43,7 @@ const HomePage: React.FC<HomePageProps> = ({
     enableStatsBar,
     enableSwap,
     enableListItemProgressBar,
+    selectTrafficProgressStyle,
   } = useAppConfig();
   const [displayOptions, setDisplayOptions] = useState({
     time: true,
@@ -184,6 +185,7 @@ const HomePage: React.FC<HomePageProps> = ({
                       key={node.uuid}
                       node={node}
                       enableSwap={enableSwap}
+                      selectTrafficProgressStyle={selectTrafficProgressStyle}
                     />
                   ) : (
                     <NodeListItem
@@ -191,6 +193,7 @@ const HomePage: React.FC<HomePageProps> = ({
                       node={node}
                       enableSwap={enableSwap}
                       enableListItemProgressBar={enableListItemProgressBar}
+                      selectTrafficProgressStyle={selectTrafficProgressStyle}
                     />
                   )
                 )}

src/pages/instance/index.tsx

@@ -10,7 +10,7 @@ const LoadCharts = lazy(() => import("./LoadCharts"));
 const PingChart = lazy(() => import("./PingChart"));
 import Loading from "@/components/loading";
 import Flag from "@/components/sections/Flag";
-import { useConfigItem } from "@/config";
+import { useAppConfig } from "@/config";
 import { useIsMobile } from "@/hooks/useMobile";
 
 const InstancePage = () => {
@@ -27,8 +27,7 @@ const InstancePage = () => {
   const [chartType, setChartType] = useState<"load" | "ping">("load");
   const [loadHours, setLoadHours] = useState<number>(0);
   const [pingHours, setPingHours] = useState<number>(1); // 默认1小时
-  const enableInstanceDetail = useConfigItem("enableInstanceDetail");
-  const enablePingChart = useConfigItem("enablePingChart");
+  const { enableInstanceDetail, enablePingChart } = useAppConfig();
   const isMobile = useIsMobile();
 
   const maxRecordPreserveTime = publicSettings?.record_preserve_time || 0; // 默认0表示关闭