v2.4.0 - 自定义标注字号，界面轻度美化

本次更新为 2.4.0，主要变化如下：

• 界面轻度美化：启动界面与主窗口按钮配色和样式统一，字体统一为 HarmonyOS Sans
• 支持自定义标注文字大小：在绘图窗口中新增路名字号和流量字号两个输入框，可根据需要调整标注文字大小，并支持一键重置字号

v2.3.0 - 在线更新功能

v2.3.0 (2025-11-25)

新增功能

• 在线更新功能：支持从 GitHub 或 Gitee 检查更新
• 更新检查界面：在"关于"对话框中可以手动检查更新
• 更新源选择：支持选择从 GitHub 或 Gitee 检查更新
• 版本信息显示：在"关于"对话框中显示当前程序版本号
• 更新下载和安装：发现新版本后可以直接下载并安装更新
• 应用图标：为所有窗口添加精美的 Sparrow 图标
• 转向流量输入顺序提示：添加了详细的转向流量输入顺序说明

性能优化

• 图标加载优化：实现缓存机制，避免重复加载大图标文件
• 图标自动缩放：大图标自动缩放到64x64，提升性能
• 语言切换优化：增强错误处理和UI更新可靠性
• 表头对齐修复：修复表头与数据框的对齐问题

使用说明

• 点击菜单栏"帮助" → "关于"，打开关于对话框
• 在关于对话框中点击"检查更新"按钮
• 选择更新源（GitHub 或 Gitee）
• 如果有新版本，可以点击"下载"按钮下载并安装
• 程序会自动检查版本并提示是否需要更新
• 在数据输入窗口中，注意查看转向流量输入顺序的提示说明

v2.2.0 - Stable Release

🎉 New Features / 新功能

Added / 新增

• Angle normalization: Supports arbitrary angle input (negative values, values > 360°)
  • 角度归一化：支持任意角度输入（负值、大于360度的值）
• Automatic angle normalization: All angles are automatically normalized to 0-360° range
  • 自动角度归一化：所有角度自动归一化到0-360度范围
• Automatic sorting: Data entries are automatically sorted by normalized angle (ascending)
  • 自动排序：数据条目按归一化后的角度自动排序（从小到大）
• Flexible data input: Supports entering data in any order
  • 灵活数据输入：支持以任意顺序输入数据
• Original data preservation: Saves original angle values and order to file (not normalized/sorted)
  • 原始数据保存：保存原始角度值和顺序到文件（未归一化/排序）
• Processed data display: UI displays normalized and sorted data
  • 处理后数据显示：界面显示归一化并排序后的数据

Technical Details / 技术细节

• Added normalize_angle() function to normalize angles to 0-360° range
  • 添加 normalize_angle() 函数，将角度归一化到0-360度范围
• Added sort_by_angle() method to Table class for automatic sorting
  • 添加 sort_by_angle() 方法到Table类，用于自动排序
• Dual data storage: raw_data for original values, data for processed values
  • 双重数据存储：raw_data 存储原始值，data 存储处理后的值
• File saving uses raw_data to preserve user's original input
  • 文件保存使用 raw_data 以保留用户的原始输入
• UI display and plotting use data (normalized and sorted)
  • UI显示和绘图使用 data（归一化和排序后的）

---

v2.1.0 - Stable Release

🎉 Stable Release / 稳定版本发布

This is a stable release with new features and improvements. Recommended for production use.
这是一个稳定版本，包含新功能和改进。推荐用于生产环境。

Added / 新增

• Left-hand traffic rule support: Supports both left-hand and right-hand traffic rules
  • 左行规则支持：支持左行规则和右行规则两种交通规则
• Traffic rule selection: Can select traffic rule above data table
  • 交通规则选择：可在数据表格上方选择交通规则
• Dynamic headers: 4-way intersection headers automatically adjust based on traffic rule
  • 动态表头：4路交叉口表头根据交通规则自动调整
• File format update: Data files include traffic rule information
  • 文件格式更新：数据文件包含交通规则信息
• Enhanced file parsing: Automatically infers intersection type from data if not declared
  • 增强的文件解析：如果未声明，自动从数据推断交叉口类型
• Default traffic rule: Defaults to right-hand traffic if not specified
  • 默认交通规则：如果未指定，默认为右行规则
• Multi-language support: Simplified Chinese and English interfaces
  • 多语言支持：简体中文和英文界面
• Language selection menu: Switch interface language from menu bar
  • 语言选择菜单：可在菜单栏中切换界面语言
• Global language switching: Language changes apply to all windows (startup dialog, main window, dialogs)
  • 全局语言切换：语言切换对所有窗口生效（启动对话框、主窗口、对话框）
• Separated help documents: Chinese and English help documents provided separately
  • 帮助文档分离：中英文帮助文档分别提供
• Dynamic UI updates: All interface text updates automatically when language changes
  • 动态界面更新：语言切换时所有界面文本自动更新
• Adaptive button widths: Button widths adjust based on language (wider for English)
  • 自适应按钮宽度：按钮宽度根据语言调整（英文更宽）
• Window size auto-adjustment: Windows resize automatically after language change
  • 窗口大小自动调整：语言切换后窗口自动调整大小
• Configuration persistence: Automatically saves language and traffic rule settings to config.txt
  • 配置保存功能：自动保存语言和通行规则设置到config.txt文件
• Config file format: User-friendly TXT format with bilingual instructions (Chinese and English)
  • 配置文件格式：用户友好的TXT格式，包含中英文双语说明
• Startup dialog enhancements: Added Help and About buttons at the bottom
  • 启动界面增强：在底部添加帮助和关于按钮

Changed / 变更

• Data file format: First line now includes traffic rule declaration
  • 数据文件格式：第一行现在包含交通规则声明
• File format: "本交叉口为X路交叉口，实行左/右行通行规则。"
  • 文件格式："本交叉口为X路交叉口，实行左/右行通行规则。"
• Table header order: Changes based on traffic rule for 4-way intersections
  • 表头顺序：4路交叉口的表头顺序根据交通规则变化
• All interface text now uses translation functions
  • 所有界面文本现在使用翻译函数
• File export dialog: File type descriptions and default filenames are now translated
  • 文件导出对话框：文件类型描述和默认文件名现在已翻译
• Help document loading: Automatically selects help document based on current language
  • 帮助文档加载：根据当前语言自动选择帮助文档
• Configuration file: Changed from JSON to TXT format for better user-friendliness
  • 配置文件：从JSON格式改为TXT格式，更便于用户编辑

v1.2.0 - Stable Release

🎉 Stable Release / 稳定版本发布

Release Date / 发布日期: 2025-11-22

This is a stable release of the Intersection Traffic Flow Visualize tool. This version includes comprehensive bug fixes, improvements, and new features that make it production-ready.

这是交叉口交通流量流向可视化工具的稳定版本。此版本包含全面的错误修复、改进和新功能，使其可用于生产环境。

主要更新 / Key Updates

• ✨ 项目重命名和版本信息增强
• 🐛 修复所有几何计算边界情况
• 🎨 UI改进和用户体验优化
• 📦 改进的打包配置

下载 / Download

• Windows 可执行文件: 从下方附件下载
• 源码: 使用标签 v1.2.0 下载

详细更新日志请查看 CHANGELOG.md

v1.3.0 - Stable Release

Release Notes / 发布说明 - v1.3.0

🎉 Stable Release / 稳定版本发布

Release Date / 发布日期: 2025-11-22

This is a stable release of the Intersection Traffic Flow Visualize tool. This version includes new visualization features and important bug fixes that enhance the user experience and visual clarity.

这是交叉口交通流量流向可视化工具的稳定版本。此版本包含新的可视化功能和重要的错误修复，提升了用户体验和视觉清晰度。

---

What's New / 新功能

✨ New Features / 新特性

• Exit Width Bar Arrows / 出口宽度条箭头

  • Added solid arrows at the end of exit width bars to clearly indicate traffic direction
  • 在出口宽度条末端添加实心箭头，清晰指示交通流向
  • Arrow length: 45 units
  • 箭头长度：45单位
  • Arrow width: 1.8 times the exit width bar width
  • 箭头宽度：出口宽度条宽度的1.8倍
  • Arrow color matches the exit width bar color
  • 箭头颜色与出口宽度条颜色一致

• Extended Entry Width Bars / 延长进口宽度条

  • Entry width bars now extend 45 units outward for better visibility
  • 进口宽度条现在向外延长45单位，提高可见性
  • Improves visual clarity of entry traffic flows
  • 提高了进口交通流的视觉清晰度

• Expanded Plot Window / 扩大绘图窗口

  • Plot window range expanded from (-330, 330) to (-375, 375)
  • 绘图窗口范围从(-330, 330)扩大到(-375, 375)
  • Accommodates extended entry bars and arrows
  • 适应延长的进口条和箭头

• Adjusted Entry Name Labels / 调整进口名称标签

  • Entry name labels moved 45 units outward along azimuth angle direction
  • 进口名称标签沿方位角方向向外移动45单位
  • Better positioning relative to extended entry bars
  • 相对于延长的进口条位置更合理

🐛 Bug Fixes / 错误修复

• Startup Dialog Close Handling / 启动界面关闭处理
  • Fixed error when closing the startup dialog (intersection type selection)
  • 修复了关闭启动界面（交叉口类型选择）时的错误
  • Now properly terminates all processes without errors
  • 现在能正确终止所有进程，不会报错
  • Improved error handling with try-except blocks
  • 使用try-except块改进了错误处理

---

Visual Improvements / 视觉改进

This release focuses on enhancing the visual clarity of traffic flow diagrams:

此版本专注于提高交通流量图的视觉清晰度：

• Clearer Direction Indication / 更清晰的方向指示

  • Arrows on exit bars make traffic direction immediately obvious
  • 出口条上的箭头使交通方向一目了然

• Better Layout / 更好的布局

  • Extended entry bars and adjusted labels improve overall diagram readability
  • 延长的进口条和调整后的标签提高了整体图表的可读性

• Larger Drawing Area / 更大的绘图区域

  • Expanded window allows all elements to be displayed without crowding
  • 扩大的窗口允许所有元素显示而不拥挤

---

Installation / 安装

From Source / 从源码安装

git clone https://github.com/chrisKLP-sys/intersection-traffic-flow.git
cd intersection-traffic-flow
git checkout v1.3.0  # 切换到稳定版本标签
python setup_venv.py
pip install -r requirements.txt
python 交叉口交通流量流向可视化工具1.3.py

Pre-built Executable / 预编译可执行文件

Download the Windows executable from the Releases page.

从 Releases 页面下载Windows可执行文件。

---

Upgrade Notes / 升级说明

If you're upgrading from v1.2.0 or earlier:

如果您从v1.2.0或更早版本升级：

1. Backup your data files - Save any custom data files before upgrading

   • 备份数据文件 - 在升级前保存任何自定义数据文件

2. File compatibility - Data files from previous versions are fully compatible

   • 文件兼容性 - 以前版本的数据文件完全兼容

3. Visual changes - The new arrows and extended bars will appear in all new diagrams

   • 视觉变化 - 新的箭头和延长的条将在所有新图表中显示

4. No data migration needed - Existing data files work without modification

   • 无需数据迁移 - 现有数据文件无需修改即可使用

---

Technical Details / 技术细节

Arrow Implementation / 箭头实现

• Uses matplotlib.patches.Polygon for solid arrow rendering
• 使用 matplotlib.patches.Polygon 进行实心箭头渲染
• Arrow shape: Isosceles triangle with vertex at the end point
• 箭头形状：顶点在终点的等腰三角形
• Direction calculated from exit inner to exit outer points
• 方向从出口内点到出口外点计算

Window Expansion / 窗口扩大

• Plot limits updated: PLOT_XLIM and PLOT_YLIM from (-330, 330) to (-375, 375)
• 绘图限制更新：PLOT_XLIM 和 PLOT_YLIM 从(-330, 330)到(-375, 375)
• Symmetric expansion to accommodate all new elements
• 对称扩大以容纳所有新元素

Process Termination / 进程终止

• Uses os._exit(0) to ensure complete process termination
• 使用 os._exit(0) 确保完全终止进程
• Prevents hanging processes when closing startup dialog
• 防止关闭启动对话框时进程挂起

---

Known Issues / 已知问题

None at this time. If you encounter any issues, please report them on the Issues page.

目前没有已知问题。如果您遇到任何问题，请在 Issues 页面上报告。

---

Credits / 致谢

• Developer / 开发者: chrisKLP-sys
• License / 许可证: MIT
• Repository / 仓库: https://github.com/chrisKLP-sys/intersection-traffic-flow

---

Support / 支持

For questions, bug reports, or feature requests, please visit:
如有问题、错误报告或功能请求，请访问：

• GitHub Issues: https://github.com/chrisKLP-sys/intersection-traffic-flow/issues
• Documentation / 文档: See 帮助文档.html or README.md

---

Changelog / 更新日志

For a complete list of changes, see CHANGELOG.md.

完整的更改列表，请参阅 CHANGELOG.md。

---

Thank you for using Intersection Traffic Flow Visualize! / 感谢使用交叉口交通流量流向可视化工具！ 🚦