1

Author: hoochanlon

README.md

@@ -52,6 +52,10 @@ flutter clean && flutter pub get
 
 ### 2. 运行项目
 
+```bash
+flutter clean && flutter pub get
+```
+
 **桌面版 (Windows):**
 
 ```bash

assets/images/icons/country-flags/flagpedia.asia/hk.svg

@@ -5,7 +5,7 @@
 目前使用 **Unicode 国旗 Emoji** 方式，这是最简单且无需额外资源的方案：
 
 - 🇨🇳 简体中文 (zh)
-- 🇹🇼 繁体中文 (zh_TW)
+- 🇭🇰 繁体中文 (zh_HK)
 - 🇺🇸 英文 (en)
 - 🇯🇵 日文 (ja)
 - 🌐 跟随系统

docs/Icon-Preview.md docs/01-MaterialIcons图标预览指南.mddocs/Icon-Preview.md renamed to docs/01-MaterialIcons图标预览指南.md

@@ -194,7 +194,7 @@ graph TB
 graph TB
     subgraph "本地化文件"
         A[app_zh.arb<br/>简体中文] --> B[AppLocalizations<br/>本地化类]
-        C[app_zh_TW.arb<br/>繁体中文] --> B
+        C[app_zh_HK.arb<br/>繁体中文] --> B
         D[app_en.arb<br/>英文] --> B
         E[app_ja.arb<br/>日文] --> B
     end

docs/flag-icons-guide.md docs/02-国旗图标使用指南.mddocs/flag-icons-guide.md renamed to docs/02-国旗图标使用指南.md

@@ -0,0 +1,34 @@
+# 网络计算器 功能概览（无图版 / CN + EN + JP）
+> 提供中文、英文、日文三语概要；无截图，适合终端/纯文本环境。
+
+## 功能模块
+- IP 地址 / 子网计算：输出网络地址、广播地址、可用 IP 等信息。  
+- 子网掩码计算（桌面端示例）：按主机数或掩码计算可用网段。  
+- 超网拆分：输入超网（CIDR）与目标掩码，生成拆分后的子网列表。  
+- 路由汇总：支持多条 CIDR 聚合，提供不同算法以对比汇总结果。  
+- 进制转换：支持 IP/数值在十进制、二进制、十六进制之间互转。  
+- 历史记录：支持搜索、导出、导入；清除计算器状态会清空所有输入/结果缓存（Web 和桌面均生效）。  
+
+## 平台特性
+- Web 端：导出历史会触发浏览器下载 JSON；导入通过文件内容；清除状态在当前浏览器环境生效。  
+- 桌面端：导出历史保存到系统下载目录（若不可用则退回应用文档目录）；导入使用文件路径；窗口尺寸和存储目录可定制。  
+
+## 语言与主题
+- 多语言：简体中文、繁体中文（中国香港）、English (US)、日本語。  
+- 主题：浅色 / 深色 / 跟随系统；支持自定义颜色主题。  
+
+---
+
+## English Summary (No Images)
+- **Modules**: IP/Subnet calculation; subnet mask (desktop); supernet split; route aggregation (multiple algorithms); base conversion (dec/bin/hex); history (search/export/import, clear calculator states).  
+- **Platforms**: Web exports trigger browser download; imports via file content; clear states in current browser context. Desktop exports to system Downloads (fallback to app docs); imports via file path; window size & storage path configurable.  
+- **Languages & Themes**: Simplified Chinese, Traditional Chinese (Hong Kong), English (US), Japanese; light/dark/system themes; customizable color themes.  
+
+---
+
+## 日本語サマリー（画像なし）
+- **機能モジュール**：IP/サブネット計算、サブネットマスク計算（デスクトップ）、スーパーネット分割、ルート集約（複数アルゴリズム）、基数変換（10/2/16 進）、履歴（検索・エクスポート・インポート、計算機状態クリア）。  
+- **プラットフォーム**：Web はエクスポート時にブラウザで JSON ダウンロードをトリガー、インポートはファイル内容を使用、状態クリアは現在のブラウザ環境で有効。デスクトップはシステムのダウンロードフォルダ（無ければアプリドキュメント）へ保存、インポートはファイルパス指定、ウィンドウサイズと保存先を設定可能。  
+- **言語とテーマ**：簡体中文・繁體中文（香港）・English (US)・日本語。ライト/ダーク/システム連動テーマ、カスタム配色をサポート。  
+
+

docs/Architecture-Diagrams.md docs/03-架构与技术原理图.mddocs/Architecture-Diagrams.md renamed to docs/03-架构与技术原理图.md

@@ -0,0 +1,36 @@
+# 网络计算器 功能概览（配图版）
+
+> 功能要点来自无图版文字说明，配图位于 `docs/imgs/`。
+
+## 功能模块（对应示例配图）
+1) **IP 地址 / 子网计算**  
+   - 输出网络地址、广播地址、可用 IP 等。桌面端子网掩码计算可按主机数或掩码生成可用网段。  
+   - 配图：![](./imgs/PixPin_2026-01-06_15-48-22-tuya.png)
+
+2) **超网拆分**  
+   - 输入超网（CIDR）与目标掩码，生成拆分后的子网列表。  
+   - 配图：![](./imgs/PixPin_2026-01-06_15-52-00-tuya.png)
+
+3) **路由汇总（算法对比）**  
+   - 路由聚合示例，比较两种算法的汇总结果。  
+   - 算法 A：![](./imgs/PixPin_2026-01-06_15-55-46-tuya.png)  
+   - 算法 B：![](./imgs/PixPin_2026-01-06_16-01-52-tuya.png)
+
+4) **进制转换**  
+   - IP/数值在十进制、二进制、十六进制之间互转，结果即时显示。  
+   - 配图：![](./imgs/PixPin_2026-01-06_16-03-14-tuya.png)
+
+5) **历史记录（导入 / 导出）**  
+   - 支持搜索、导出、导入；“清除计算器状态” 会清空所有输入/结果缓存（Web 和桌面均生效）。  
+   - 配图：![](./imgs/PixPin_2026-01-06_16-07-19-tuya.png)
+
+## 平台特性
+- **Web 端**：导出历史会触发浏览器下载 JSON；导入通过文件内容；清除状态在当前浏览器环境生效。  
+- **桌面端**：导出历史保存到系统下载目录（若不可用则退回应用文档目录）；导入使用文件路径；窗口尺寸与存储目录可定制。
+
+## 语言与主题
+- 多语言：简体中文、繁体中文（中国香港）、English (US)、日本語。  
+- 主题：浅色 / 深色 / 跟随系统；支持自定义颜色主题。
+
+
+