fix: 桌面应用跨平台编译和单实例锁

- 使用 gofrs/flock 替代 syscall.Flock 以支持 Windows
- 引入 SingletonLock 结构体，支持锁路径参数化（测试与生产隔离）
- 对齐服务初始化流程与 cmd/server（RoutingCache、StatsBuffer）
- 添加 gofrs/flock 依赖
- 重写单例测试，覆盖加锁/解锁/重复加锁场景
- 更新 desktop-app 规范，补充跨平台锁细节
- 新增 cross-platform-singleton 规范

openspec/specs/cross-platform-singleton/spec.md

@@ -0,0 +1,53 @@
+# 跨平台单实例锁
+
+## Purpose
+
+TBD - 提供跨平台单实例文件锁机制，使用 `github.com/gofrs/flock` 封装，支持 Windows、macOS、Linux 三平台。
+
+## Requirements
+
+### Requirement: 跨平台单实例文件锁
+
+系统 SHALL 提供跨平台的单实例文件锁机制，使用 `github.com/gofrs/flock` 实现，在 Windows、macOS、Linux 上均可正常工作。
+
+#### Scenario: 首次加锁成功
+- **WHEN** 调用 `NewSingletonLock(lockPath)` 创建锁实例并调用 `Lock()`
+- **AND** 锁文件未被其他进程持有
+- **THEN** 加锁成功，返回 `nil`
+
+#### Scenario: 重复加锁失败
+- **WHEN** 另一个进程已持有同一锁文件的排他锁
+- **AND** 调用 `Lock()`
+- **THEN** 加锁失败，返回错误
+
+#### Scenario: 释放锁
+- **WHEN** 调用 `Unlock()`
+- **THEN** 排他锁被释放
+- **AND** 其他进程可以成功加锁
+
+#### Scenario: 进程崩溃后锁自动释放
+- **WHEN** 持有锁的进程异常退出（崩溃、kill）
+- **THEN** 操作系统自动释放文件锁
+- **AND** 新进程可以成功加锁
+
+> 注：此场景由操作系统和 `gofrs/flock` 库保证，无需显式单元测试。
+
+### Requirement: 锁路径参数化
+
+`SingletonLock` SHALL 通过构造函数参数接收锁文件路径，支持不同运行上下文使用不同锁文件。
+
+#### Scenario: 正式运行锁路径
+- **WHEN** 桌面应用正常启动
+- **THEN** 使用 `%TEMP%/nex-gateway.lock` 作为锁文件路径
+
+#### Scenario: 测试运行锁路径
+- **WHEN** 运行 `go test`
+- **THEN** 测试代码使用独立的锁文件路径（如 `%TEMP%/nex-gateway-test.lock`）
+- **AND** 与正式版锁文件互不影响
+
+#### Scenario: 锁路径隔离
+- **WHEN** 正式版桌面应用正在运行
+- **AND** 同时执行 `go test`
+- **THEN** 正式版持有 `nex-gateway.lock`
+- **AND** 测试持有 `nex-gateway-test.lock`
+- **AND** 两者互不阻塞

openspec/specs/desktop-app/spec.md

@@ -12,16 +12,23 @@ TBD - 提供跨平台桌面应用支持，将后端服务与前端静态资源
 
 #### Scenario: 双击启动
 - **WHEN** 用户双击桌面应用可执行文件
-- **THEN** 系统启动后端服务
+- **THEN** 系统使用 `gofrs/flock` 尝试获取排他文件锁
+- **AND** 锁文件路径为系统临时目录下的 `nex-gateway.lock`
+- **AND** 系统启动后端服务
 - **AND** 系统托盘图标出现
 - **AND** 浏览器自动打开 `http://localhost:9826` 显示管理界面
 
 #### Scenario: 单实例检查
 - **WHEN** 用户尝试启动第二个实例
-- **THEN** 系统检测到已有实例运行
+- **THEN** 系统检测到已有实例持有文件锁
 - **AND** 显示错误提示"已有 Nex 实例运行"
 - **AND** 新实例退出
 
+#### Scenario: 退出释放锁
+- **WHEN** 用户点击托盘菜单"退出"
+- **THEN** 系统释放文件锁
+- **AND** 应用进程退出
+
 ### Requirement: 系统托盘
 
 系统 SHALL 提供跨平台系统托盘功能，支持托盘图标和菜单。