## MODIFIED Requirements ### Requirement: 系统托盘 系统 SHALL 提供跨平台系统托盘功能,支持托盘图标和菜单。图标格式 SHALL 根据平台自动选择。 #### Scenario: 托盘图标显示 - **WHEN** 桌面应用启动成功 - **THEN** 系统根据平台加载正确的图标格式 - **AND** 在 Windows 上加载 ICO 格式图标(`assets/icon.ico`) - **AND** 在 macOS 和 Linux 上加载 PNG 格式图标(`assets/icon.png`) - **AND** 托盘图标 tooltip 显示"AI Gateway" #### Scenario: 托盘菜单显示 - **WHEN** 用户点击托盘图标(左键或右键) - **THEN** 显示托盘菜单 - **AND** 菜单包含"打开管理界面"选项 - **AND** 菜单包含"状态: 运行中"选项(禁用状态) - **AND** 菜单包含"端口: 9826"选项(禁用状态) - **AND** 菜单包含"关于"选项 - **AND** 菜单包含"退出"选项 #### Scenario: 打开管理界面 - **WHEN** 用户点击托盘菜单"打开管理界面" - **THEN** 系统在浏览器中打开 `http://localhost:9826` #### Scenario: 浏览器打开失败 - **WHEN** 系统无法打开浏览器(浏览器未安装等) - **THEN** 托盘菜单仍可正常使用 - **AND** 用户可手动访问 `http://localhost:9826` #### Scenario: 退出应用 - **WHEN** 用户点击托盘菜单"退出" - **THEN** 系统优雅关闭后端服务 - **AND** 托盘图标消失 - **AND** 应用进程退出 ### Requirement: 跨平台构建 系统 SHALL 支持跨平台构建和打包。构建 target SHALL 按平台分离,产物文件名 SHALL 使用 `nex-{os}-{arch}[.exe]` 格式。 #### Scenario: macOS 构建 - **WHEN** 执行 `desktop-mac` 构建命令 - **THEN** 生成 `nex-mac-arm64` 和 `nex-mac-amd64` 可执行文件 - **AND** 可打包为 `.app` bundle #### Scenario: Windows 构建 - **WHEN** 执行 `desktop-win` 构建命令 - **THEN** 生成 `nex-win-amd64.exe` 可执行文件 - **AND** 使用 `-H=windowsgui` linker flag 隐藏控制台窗口 #### Scenario: Linux 构建 - **WHEN** 执行 `desktop-linux` 构建命令 - **THEN** 生成 `nex-linux-amd64` 可执行文件 ### Requirement: 关于对话框 系统 SHALL 提供关于对话框显示应用信息。在 Windows 上 SHALL 使用 `user32.dll` 的 `MessageBoxW` API 实现。 #### Scenario: 显示关于 - **WHEN** 用户点击托盘菜单"关于" - **THEN** 显示对话框包含应用名称、项目链接 - **AND** 在 Windows 上使用 `MessageBoxW` 原生对话框实现 ## ADDED Requirements ### Requirement: Windows 原生对话框 系统 SHALL 在 Windows 上使用 `user32.dll` 的 `MessageBoxW` API 显示错误和关于对话框,替代 `msg *` 命令。 #### Scenario: 错误提示对话框 - **WHEN** 应用在 Windows 上遇到启动错误(端口占用、配置加载失败等) - **THEN** 使用 `MessageBoxW` 显示模态对话框 - **AND** 对话框标题栏显示应用名称 - **AND** 对话框包含错误描述文本 - **AND** 对话框显示错误图标(MB_ICONERROR) #### Scenario: 关于对话框 - **WHEN** 用户在 Windows 上点击托盘菜单"关于" - **THEN** 使用 `MessageBoxW` 显示模态对话框 - **AND** 对话框标题栏显示"关于 Nex Gateway" - **AND** 对话框包含应用信息文本 - **AND** 对话框显示信息图标(MB_ICONINFORMATION) #### Scenario: 非 Windows 平台不受影响 - **WHEN** 应用运行在 macOS 或 Linux 上 - **THEN** 错误和关于对话框仍使用平台原有实现(osascript / zenity)