chore: 统一开发服务器端口为 13098

- 更新 .env.example、env.ts、vite.config.ts 默认端口
- 同步更新 sidecar.rs Rust 端口常量
- 更新 README、AGENTS.md 等文档中的端口引用
This commit is contained in:
2026-01-27 11:10:21 +08:00
parent d22a0f8d69
commit f2db4bff9d
7 changed files with 24 additions and 23 deletions

View File

@@ -8,7 +8,7 @@
- **后端**: Rust (Edition 2021)
- **架构**: Sidecar 模式 - Sidecar App 承载主要业务逻辑
- **设计理念**: Tauri 仅提供原生桌面能力文件对话框、系统通知等Web 逻辑全部由 Sidecar App 处理
- **开发模式**: 使用 localhost:3000(需手动启动开发服务器)
- **开发模式**: 使用 localhost:13098(需手动启动开发服务器)
- **生产模式**: 自动启动 Sidecar 二进制
- **异步运行时**: Tokio
- **Rust 版本**: 1.92.0+
@@ -30,7 +30,7 @@ bun run dev:tauri
```
**开发模式说明**
- 开发模式下Tauri 直接连接到 `localhost:3000`(不启动 sidecar 二进制)
- 开发模式下Tauri 直接连接到 `localhost:13098`(不启动 sidecar 二进制)
- 需要手动运行 `bun run dev` 来启动开发服务器
- 支持热重载HMR无需重启 Tauri 应用
@@ -141,12 +141,12 @@ use tauri::*;
```rust
// ✅ 推荐
struct SidecarProcess(Mutex<Option<CommandChild>>);
const DEFAULT_PORT: u16 = 3000;
const DEFAULT_PORT: u16 = 13098;
async fn find_available_port(start: u16) -> u16 { }
// ❌ 避免
struct sidecar_process { }
const defaultPort: u16 = 3000;
const defaultPort: u16 = 13098;
```
### 类型注解
@@ -205,7 +205,7 @@ let data = read_file().unwrap(); // 无上下文信息
```rust
// ✅ 推荐
tauri::async_runtime::spawn(async move {
let port = find_available_port(3000).await;
let port = find_available_port(13098).await;
// ...
});
```
@@ -339,7 +339,7 @@ tokio = { version = "1", features = ["net"] }
- 生产构建自动打包 sidecar 二进制,无需额外配置
2. **进程生命周期**: 始终在应用退出时清理子进程和资源
3. **端口管理**:
- 开发模式固定使用 3000 端口(与开发服务器匹配)
- 开发模式固定使用 13098 端口(与开发服务器匹配)
- 生产模式使用端口扫描避免硬编码端口冲突
4. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
5. **日志**: 使用表情符号 (✓/✗/🔧/🚀) 和中文消息提供清晰的状态反馈

View File

@@ -11,9 +11,9 @@ use tauri_plugin_shell::ShellExt;
const SIDECAR_NAME: &str = "openbridgeTokenUsageViewerServer";
/// 默认服务器端口
const DEFAULT_PORT: u16 = 3000;
const DEFAULT_PORT: u16 = 13098;
/// 从环境变量获取端口 (PROJECT_SERVER_PORT),默认 3000
/// 从环境变量获取端口 (PROJECT_SERVER_PORT),默认 13098
fn get_project_port() -> u16 {
std::env::var("PROJECT_SERVER_PORT")
.ok()