feat: --max & --smart-max mutual exclusion + Y-axis scaling docs

- Bump version: 0.1.8-beta.2  0.1.8-beta.3 (Rust + Python)
- Rust: add conflicts_with = smart_max on --max (clap)
- Python: group --max & --smart-max in mutually_exclusive_group()
- Reorder --smart-max adjacent to --max in Options table (5 READMEs)
- Add conflict annotations to --max & --smart-max descriptions
- Add Y-axis scaling mode blockquote (fixed max / smart max /
  history peak) with  conflict warning across all 5 READMEs
  (en, zh-cn, zh-tw, jp, ko)

build publish, pypi publish, crates publish

Author: VincentZyuwin11台式机

py/main.py

@@ -203,14 +203,24 @@ def parse_args() -> argparse.Namespace:
         default="bit",
         help=t("help_unit"),
     )
-    parser.add_argument(
+    max_group = parser.add_mutually_exclusive_group()
+    max_group.add_argument(
         "-m",
         "--max",
         type=str,
         default=None,
         metavar="VALUE",
         help=t("help_max"),
     )
+    max_group.add_argument(
+        "--smart-max",
+        type=float,
+        nargs="?",
+        const=10.0,
+        default=None,
+        metavar="SECS",
+        help=t("help_smart_max"),
+    )
     parser.add_argument(
         "-n",
         "--no-graph",
@@ -266,15 +276,6 @@ def parse_args() -> argparse.Namespace:
         default=False,
         help=t("help_no_color"),
     )
-    parser.add_argument(
-        "--smart-max",
-        type=float,
-        nargs="?",
-        const=10.0,
-        default=None,
-        metavar="SECS",
-        help=t("help_smart_max"),
-    )
     parser.add_argument(
         "--debug-info",
         action="store_true",

py/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "winload"
-version = "0.1.8-beta.2"
+version = "0.1.8-beta.3"
 description = "Network Load Monitor - nload-like TUI tool for Windows"
 readme = "readme.md"
 license = { text = "MIT" }

readme.jp.md

@@ -170,16 +170,26 @@ winload --npcap      # 127.0.0.1 ループバックトラフィックをキャ
 | `-b`, `--bar-style <STYLE>` | バースタイル: `fill`, `color`, `plain` | `fill` |
 | `--in-color <HEX>` | 受信グラフの色、16進数RGB (例: `0x00d7ff`) | シアン |
 | `--out-color <HEX>` | 送信グラフの色、16進数RGB (例: `0xffaf00`) | ゴールド |
-| `-m`, `--max <VALUE>` | Y軸の最大値を固定 (例: `10M`, `1G`, `500K`) | 自動 |
+| `-m`, `--max <VALUE>` | Y軸の最大値を固定 (例: `10M`, `1G`, `500K`) —— *`--smart-max` と併用不可* | 自動 |
+| `--smart-max [SECS]` | スマート適応型Y軸上限：トラフィックスパイク後に自動的に指数減衰し、波形がより動的に（半減期、秒、デフォルト10秒）—— *`--max` と併用不可* | オフ |
 | `-n`, `--no-graph` | グラフを非表示にし、統計のみを表示 | オフ |
 | `--hide-separator` | 区切り線（イコール記号の行）を非表示にする | オフ |
 | `--no-color` | すべてのTUIカラーを無効にする（モノクロモード） | オフ |
-| `--smart-max [SECS]` | スマート適応型Y軸上限：トラフィックスパイク後に自動的に指数減衰し、波形がより動的に（半減期、秒、デフォルト10秒） | オフ |
 | `--npcap` | **[Windows Rust版のみ]** Npcap経由でループバックをキャプチャ | オフ |
 | `--debug-info` | インターフェースのデバッグ情報を表示して終了 | — |
 | `-h`, `--help` | ヘルプを表示 (`--help --emoji` で絵文字版ヘルプ！) | — |
 | `-V`, `--version` | バージョンを表示 | — |
 
+> **Y軸スケーリングモード** —— 以下の3つのシナリオは排他的です：
+>
+> | モード | フラグ | 動作 |
+> |--------|--------|------|
+> | **固定最大値** | `--max <VALUE>` | Y軸を指定した値に固定します（例：`10M`、`1G`）。 |
+> | **スマート最大値** | `--smart-max [SECS]` | Y軸が自動適応：トラフィック急増時に即座に上昇し、その後スムーズに減衰します（指数減衰、デフォルト半減期 10 秒）。 |
+> | **履歴ピーク** | *（どちらも指定なし）* | Y軸は各指標の過去最大値に追従します —— デフォルトの動作です。 |
+>
+> ⚠️ `--max` と `--smart-max` は**併用不可**です —— どちらか一方のみ指定できます。
+
 ### キーボードショートカット
 
 | キー | アクション |

readme.ko.md

@@ -170,16 +170,26 @@ winload --npcap      # 127.0.0.1 루프백 트래픽 캡처 (Windows, Npcap 필
 | `-b`, `--bar-style <STYLE>` | 바 스타일: `fill`, `color`, 또는 `plain` | `fill` |
 | `--in-color <HEX>` | 수신 그래프 색상, 16진수 RGB (예: `0x00d7ff`) | Cyan |
 | `--out-color <HEX>` | 송신 그래프 색상, 16진수 RGB (예: `0xffaf00`) | Gold |
-| `-m`, `--max <VALUE>` | Y축 최대값 고정 (예: `10M`, `1G`, `500K`) | 자동 |
+| `-m`, `--max <VALUE>` | Y축 최대값 고정 (예: `10M`, `1G`, `500K`) —— *`--smart-max`와 충돌* | 자동 |
+| `--smart-max [SECS]` | 스마트 적응형 Y축 상한: 트래픽 스파이크 후 자동으로 지수 감쇠하여 파형이 더 생동감 있게 표시 (반감기, 초, 기본값 10초) —— *`--max`와 충돌* | 비활성 |
 | `-n`, `--no-graph` | 그래프를 숨기고 통계만 표시 | 비활성 |
 | `--hide-separator` | 구분선(등호 행) 숨기기 | 비활성 |
 | `--no-color` | 모든 TUI 색상 비활성화 (흑백 모드) | 비활성 |
-| `--smart-max [SECS]` | 스마트 적응형 Y축 상한: 트래픽 스파이크 후 자동으로 지수 감쇠하여 파형이 더 생동감 있게 표시 (반감기, 초, 기본값 10초) | 비활성 |
 | `--npcap` | **[Windows Rust 버전 전용]** Npcap을 통해 루프백 트래픽 캡처 | 비활성 |
 | `--debug-info` | 네트워크 인터페이스 디버그 정보 출력 후 종료 | — |
 | `-h`, `--help` | 도움말 출력 (`--help --emoji`로 이모지 버전 확인 가능!) | — |
 | `-V`, `--version` | 버전 정보 출력 | — |
 
+> **Y축 스케일링 모드** — 다음 세 가지 시나리오는 상호 배타적입니다:
+>
+> | 모드 | 플래그 | 동작 |
+> |------|--------|------|
+> | **고정 최댓값** | `--max <VALUE>` | Y축을 지정한 값으로 고정합니다 (예: `10M`, `1G`). |
+> | **스마트 최댓값** | `--smart-max [SECS]` | Y축이 자동 적응: 트래픽 급증 시 즉시 상승한 뒤, 부드럽게 감쇠합니다 (지수 감쇠, 기본 반감기 10초). |
+> | **히스토리 피크** | *(둘 다 미지정)* | Y축이 각 지표의 과거 최댓값을 따릅니다 — 기본 동작입니다. |
+>
+> ⚠️ `--max`와 `--smart-max`는 **서로 충돌**합니다 — 둘 중 하나만 사용할 수 있습니다.
+
 ### 키보드 단축키
 
 | 키 | 동작 |

readme.md

@@ -170,16 +170,26 @@ winload --npcap      # Capture 127.0.0.1 loopback traffic (Windows, requires Npc
 | `-b`, `--bar-style <STYLE>` | Bar style: `fill`, `color`, or `plain` | `fill` |
 | `--in-color <HEX>` | Incoming graph color, hex RGB (e.g. `0x00d7ff`) | cyan |
 | `--out-color <HEX>` | Outgoing graph color, hex RGB (e.g. `0xffaf00`) | gold |
-| `-m`, `--max <VALUE>` | Fixed Y-axis max (e.g. `10M`, `1G`, `500K`) | auto |
+| `-m`, `--max <VALUE>` | Fixed Y-axis max (e.g. `10M`, `1G`, `500K`) — *conflicts with `--smart-max`* | auto |
+| `--smart-max [SECS]` | Smart adaptive Y-axis: auto-decays after traffic spikes (default half-life: 10s) — *conflicts with `--max`* | off |
 | `-n`, `--no-graph` | Hide graph, show stats only | off |
 | `--hide-separator` | Hide the separator line (row of equals signs) | off |
 | `--no-color` | Disable all TUI colors (monochrome mode) | off |
-| `--smart-max [SECS]` | Smart adaptive Y-axis: auto-decays after traffic spikes (default half-life: 10s) | off |
 | `--npcap` | **[Windows Rust Only]** Capture loopback traffic via Npcap (recommended) | off |
 | `--debug-info` | Print network interface debug info and exit | — |
 | `-h`, `--help` | Print help (`--help --emoji` for emoji version!) | — |
 | `-V`, `--version` | Print version | — |
 
+> **Y-axis scaling modes** — there are three mutually exclusive scenarios:
+>
+> | Mode | Flag | Behavior |
+> |------|------|----------|
+> | **Fixed max** | `--max <VALUE>` | Y-axis is locked to the specified value (e.g. `10M`, `1G`). |
+> | **Smart max** | `--smart-max [SECS]` | Y-axis adapts automatically: jumps up on traffic spikes, then smoothly decays back down (exponential decay, default half-life 10 s). |
+> | **History peak** | *(neither flag)* | Y-axis follows the historical maximum of each metric — the default behavior. |
+>
+> ⚠️ `--max` and `--smart-max` **conflict with each other** — you can only use one at a time.
+
 ### Keyboard Shortcuts
 
 | Key | Action |

readme.zh-cn.md

@@ -170,16 +170,26 @@ winload --npcap      # 捕获 127.0.0.1 回环流量 (Windows，需安装 Npcap)
 | `-b`, `--bar-style <STYLE>` | 状态栏样式：`fill`、`color` 或 `plain` | `fill` |
 | `--in-color <HEX>` | 下行图形颜色，十六进制 RGB（如 `0x00d7ff`） | 青色 |
 | `--out-color <HEX>` | 上行图形颜色，十六进制 RGB（如 `0xffaf00`） | 金色 |
-| `-m`, `--max <VALUE>` | 固定 Y 轴最大值（如 `10M`、`1G`、`500K`） | 自动 |
+| `-m`, `--max <VALUE>` | 固定 Y 轴最大值（如 `10M`、`1G`、`500K`）—— *与 `--smart-max` 冲突* | 自动 |
+| `--smart-max [SECS]` | 智能自适应 Y 轴上限：流量尖峰后自动指数回落，波形更生动（半衰期，秒，默认 10s）—— *与 `--max` 冲突* | 关闭 |
 | `-n`, `--no-graph` | 隐藏图形，仅显示统计信息 | 关闭 |
 | `--hide-separator` | 隐藏分隔线（等于号一行） | 关闭 |
 | `--no-color` | 禁用所有 TUI 颜色（单色模式） | 关闭 |
-| `--smart-max [SECS]` | 智能自适应 Y 轴上限：流量尖峰后自动指数回落，波形更生动（半衰期，秒，默认 10s） | 关闭 |
 | `--npcap` | **[Windows Rust Only]** 通过 Npcap 捕获回环流量（推荐） | 关闭 |
 | `--debug-info` | 打印网络接口调试信息后退出 | — |
 | `-h`, `--help` | 打印帮助（`--help --emoji` 可查看 emoji 版！） | — |
 | `-V`, `--version` | 打印版本号 | — |
 
+> **Y 轴缩放模式** —— 以下三种场景互斥：
+>
+> | 模式 | 参数 | 行为 |
+> |------|------|------|
+> | **固定最大值** | `--max <VALUE>` | Y 轴锁定为指定值（如 `10M`、`1G`）。 |
+> | **智能最大值** | `--smart-max [SECS]` | Y 轴自适应：流量突增时立即跳升，随后平滑衰减（指数衰减，默认半衰期 10 秒）。 |
+> | **历史峰值** | *（都不加）* | Y 轴跟随各指标的历史最大值 —— 这是默认行为。 |
+>
+> ⚠️ `--max` 与 `--smart-max` **相互冲突** —— 只能二选一。
+
 ### 快捷键
 
 | 按键 | 功能 |

readme.zh-tw.md

@@ -170,16 +170,26 @@ winload --npcap      # 擷取 127.0.0.1 回環流量 (Windows，需安裝 Npcap)
 | `-b`, `--bar-style <STYLE>` | 狀態列樣式：`fill`、`color` 或 `plain` | `fill` |
 | `--in-color <HEX>` | 下行圖形顏色，十六進位 RGB（如 `0x00d7ff`） | 青色 |
 | `--out-color <HEX>` | 上行圖形顏色，十六進位 RGB（如 `0xffaf00`） | 金色 |
-| `-m`, `--max <VALUE>` | 固定 Y 軸最大值（如 `10M`、`1G`、`500K`） | 自動 |
+| `-m`, `--max <VALUE>` | 固定 Y 軸最大值（如 `10M`、`1G`、`500K`）—— *與 `--smart-max` 衝突* | 自動 |
+| `--smart-max [SECS]` | 智慧自適應 Y 軸上限：流量尖峰後自動指數回落，波形更生動（半衰期，秒，預設 10s）—— *與 `--max` 衝突* | 關閉 |
 | `-n`, `--no-graph` | 隱藏圖形，僅顯示統計資訊 | 關閉 |
 | `--hide-separator` | 隱藏分隔線（等號一行） | 關閉 |
 | `--no-color` | 停用所有 TUI 顏色（單色模式） | 關閉 |
-| `--smart-max [SECS]` | 智慧自適應 Y 軸上限：流量尖峰後自動指數回落，波形更生動（半衰期，秒，預設 10s） | 關閉 |
 | `--npcap` | **[Windows Rust Only]** 透過 Npcap 擷取回環流量（建議） | 關閉 |
 | `--debug-info` | 列印網路介面除錯資訊後退出 | — |
 | `-h`, `--help` | 列印說明（`--help --emoji` 可查看 emoji 版！） | — |
 | `-V`, `--version` | 列印版本號 | — |
 
+> **Y 軸縮放模式** —— 以下三種情境互斥：
+>
+> | 模式 | 參數 | 行為 |
+> |------|------|------|
+> | **固定最大值** | `--max <VALUE>` | Y 軸鎖定為指定值（如 `10M`、`1G`）。 |
+> | **智慧最大值** | `--smart-max [SECS]` | Y 軸自適應：流量突增時立即跳升，隨後平滑衰減（指數衰減，預設半衰期 10 秒）。 |
+> | **歷史峰值** | *（都不加）* | Y 軸跟隨各指標的歷史最大值 —— 這是預設行為。 |
+>
+> ⚠️ `--max` 與 `--smart-max` **相互衝突** —— 只能二擇一。
+
 ### 快捷鍵
 
 | 按鍵 | 功能 |

rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "winload"
-version = "0.1.8-beta.2"
+version = "0.1.8-beta.3"
 edition = "2021"
 description = "Network Load Monitor — nload-like TUI tool for Windows/Linux/macOS"
 license = "MIT"

rust/src/main.rs

@@ -127,7 +127,7 @@ struct Args {
     out_color: Option<ratatui::style::Color>,
 
     /// Fixed graph Y-axis max (e.g. 100M, 1G, 500K)
-    #[arg(short = 'm', long = "max", value_parser = parse_max_value)]
+    #[arg(short = 'm', long = "max", value_parser = parse_max_value, conflicts_with = "smart_max")]
     max: Option<f64>,
 
     /// Hide traffic graphs, show only statistics