feat: implement close behavior settings and enhance tray functionality

- Added a new close behavior setting allowing users to choose between "ask", "minimize to tray", or "quit" when closing the application.
- Updated the GeneralSettings component to include a dropdown for selecting the close behavior.
- Introduced a system tray feature that retains the application icon and provides a context menu based on the current task.
- Enhanced the App component to integrate the TrayBridge for managing tray interactions.
- Updated localization files to include new strings related to close behavior and tray functionality.
- Refactored tests to validate the new close behavior settings and ensure proper integration with the tray functionality.

Author: knqiufan

docs/design/shell-and-workspace-ui-spec.md

@@ -4,7 +4,7 @@
 |------|------|
 | **用途** | 定义主窗口混合壳结构、任务侧栏、对话页顶栏、设置页与工作区布局语义。 |
 | **受众** | 负责 `AppShell`、`UnifiedTopBar`、`SessionPanel`、`SettingsSidebar`、`ChatPage`、`WorkspaceBar`、`SettingsPage` 及相关布局的前端开发者。 |
-| **最后审阅** | 2026-07-23（v22） |
+| **最后审阅** | 2026-07-23（v24） |
 
 ## 相关文档
 
@@ -66,6 +66,16 @@ Session / Settings 左栏 / Main 使用 `--sidebar`、`--border`、`--background
 
 ---
 
+### 1.4 系统托盘与窗口关闭
+
+- 系统托盘属于桌面壳层，不以 React Popover 替代原生菜单。启动后保留品牌图标；左键恢复并聚焦主窗口，右键使用系统原生菜单。
+- 托盘菜单的项目上下文以当前活动任务的 `working_directory` 为唯一来源，名称可使用 `project_name` 作为展示值。目录不存在或无活动任务时，项目说明项保持禁用，“打开当前项目”禁用；“新建任务”改为打开现有工作目录选择器。
+- 原生菜单顺序固定为：打开应用、禁用的当前项目说明、新建任务、打开当前项目文件夹、设置、退出；菜单文本随应用语言更新。项目级置顶和移除仍属于任务栏内项目右键菜单，不重复到托盘。
+- 主窗口关闭策略必须由持久化的 `close_behavior` 控制：`ask` 弹出应用内 Dialog，`minimize_to_tray` 仅隐藏窗口，`quit` 才结束进程和 Sidecar。询问 Dialog 复用标准 Dialog、Switch 与按钮焦点/动效规范，不添加缩放或弹跳动效。
+- 通用设置使用 `FieldRow` 右侧 Select 暴露三种关闭策略。用户在询问 Dialog 勾选“记住”后，所选最小化或退出策略应立即持久化，并在下次启动时生效。
+
+---
+
 ## 2. 任务列表（SessionPanel）
 
 ### 2.1 Quick actions
@@ -84,7 +94,8 @@ Sidecar 状态**不**放在底栏（见 §1 / 关于页）。
 ### 2.3 任务行（SessionItem）
 
 - 行高 `h-8`、`rounded-xl`、`px-3`、标题 `text-[13px]` 单行截断。
-- 右侧时间与 ⋯ 菜单共用固定宽约 `38px` 的尾部容器；hover、选中或菜单打开时仅显示菜单按钮，其他状态仅显示时间，二者不得重叠。
+- 右侧时间与 ⋯ 菜单共用固定宽 `52px` 的尾部容器（需容纳中文日期如「12月31日」与英文 `Dec 31`）；时间文案必须 `whitespace-nowrap` + `leading-none`，禁止换行。
+- hover、选中或菜单打开时仅显示菜单按钮，其他状态仅显示时间，二者不得重叠；菜单按钮仍右对齐于尾部容器。
 - 激活：`bg-sidebar-accent`；过渡 `duration-150`。
 
 ### 2.4 分区标题

src-tauri/src/commands/mod.rs

@@ -7,4 +7,5 @@ pub mod session;
 pub mod settings;
 pub mod sidecar;
 pub mod skills;
+pub mod tray;
 pub mod workspace;

src-tauri/src/commands/settings.rs

@@ -1,6 +1,6 @@
 use std::collections::HashMap;
 
-use tauri::State;
+use tauri::{AppHandle, State};
 
 use crate::config::AppConfig;
 use crate::db::repository::SettingsRepo;
@@ -14,6 +14,7 @@ pub fn get_settings(state: State<'_, AppState>) -> Result<String, String> {
 
 #[tauri::command]
 pub fn update_setting(
+    app: AppHandle,
     state: State<'_, AppState>,
     key: String,
     value: serde_json::Value,
@@ -35,6 +36,9 @@ pub fn update_setting(
     }
 
     crate::config::save_config(&config).map_err(|e| e.to_string())?;
+    let updated_config = config.clone();
+    drop(config);
+    crate::tray::refresh_labels(&app, &updated_config);
     Ok(())
 }
 
@@ -45,10 +49,17 @@ pub fn get_app_config(state: State<'_, AppState>) -> Result<AppConfig, String> {
 }
 
 #[tauri::command]
-pub fn update_app_config(state: State<'_, AppState>, config: AppConfig) -> Result<(), String> {
+pub fn update_app_config(
+    app: AppHandle,
+    state: State<'_, AppState>,
+    config: AppConfig,
+) -> Result<(), String> {
     let mut current = state.config.lock().map_err(|e| e.to_string())?;
     *current = config;
     crate::config::save_config(&current).map_err(|e| e.to_string())?;
+    let updated_config = current.clone();
+    drop(current);
+    crate::tray::refresh_labels(&app, &updated_config);
     Ok(())
 }
 

src-tauri/src/commands/tray.rs

@@ -0,0 +1,65 @@
+use serde::Deserialize;
+use tauri::{AppHandle, State};
+
+use crate::{config::CloseBehavior, tray, AppState};
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum CloseRequestAction {
+    MinimizeToTray,
+    Quit,
+}
+
+#[tauri::command]
+pub fn update_tray_context(
+    app: AppHandle,
+    state: State<'_, AppState>,
+    working_directory: Option<String>,
+    project_name: Option<String>,
+    workspace_kind: Option<String>,
+) -> Result<(), String> {
+    let language = state
+        .config
+        .lock()
+        .map_err(|error| error.to_string())?
+        .language
+        .clone();
+    tray::update_context(
+        &app,
+        working_directory,
+        project_name,
+        workspace_kind,
+        &language,
+    )
+}
+
+#[tauri::command]
+pub fn resolve_close_request(
+    app: AppHandle,
+    state: State<'_, AppState>,
+    action: CloseRequestAction,
+    remember: bool,
+) -> Result<(), String> {
+    let close_behavior = match action {
+        CloseRequestAction::MinimizeToTray => CloseBehavior::MinimizeToTray,
+        CloseRequestAction::Quit => CloseBehavior::Quit,
+    };
+
+    if remember {
+        let updated_config = {
+            let mut config = state.config.lock().map_err(|error| error.to_string())?;
+            config.close_behavior = close_behavior;
+            crate::config::save_config(&config).map_err(|error| error.to_string())?;
+            config.clone()
+        };
+        tray::refresh_labels(&app, &updated_config);
+    }
+
+    match action {
+        CloseRequestAction::MinimizeToTray => tray::hide_main_window(&app),
+        CloseRequestAction::Quit => {
+            app.exit(0);
+            Ok(())
+        }
+    }
+}

src-tauri/src/config.rs

@@ -6,6 +6,20 @@ pub fn default_ui_font_size() -> u8 {
     14
 }
 
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "snake_case")]
+pub enum CloseBehavior {
+    Ask,
+    MinimizeToTray,
+    Quit,
+}
+
+impl Default for CloseBehavior {
+    fn default() -> Self {
+        Self::Ask
+    }
+}
+
 /// Application configuration, persisted to ~/.misakax/config.yaml
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(default)]
@@ -36,6 +50,9 @@ pub struct AppConfig {
     /// Local MCP HTTP bridge port (Python Sidecar → Rust MCP)
     #[serde(default = "default_mcp_bridge_port")]
     pub mcp_bridge_port: u16,
+    /// Behavior for the primary window close button.
+    #[serde(default)]
+    pub close_behavior: CloseBehavior,
 }
 
 fn default_mcp_bridge_port() -> u16 {
@@ -60,6 +77,7 @@ impl Default for AppConfig {
             auto_start_sidecar: true,
             use_sidecar: true,
             mcp_bridge_port: 9528,
+            close_behavior: CloseBehavior::Ask,
         }
     }
 }

src-tauri/src/lib.rs

@@ -14,6 +14,7 @@ pub mod sidecar;
 mod sidecar_ownership;
 #[cfg(feature = "test-private")]
 pub mod sidecar_ownership;
+pub mod tray;
 
 use config::AppConfig;
 use db::repository::SessionRepo;
@@ -103,6 +104,7 @@ pub fn run() {
             stream_registry: StreamRegistry::new(),
             mcp_manager: Arc::clone(&mcp_manager),
         })
+        .manage(tray::TrayState::default())
         .invoke_handler(tauri::generate_handler![
             commands::settings::get_settings,
             commands::settings::update_setting,
@@ -112,6 +114,8 @@ pub fn run() {
             commands::settings::set_setting,
             commands::settings::get_all_settings,
             commands::settings::get_system_info,
+            commands::tray::update_tray_context,
+            commands::tray::resolve_close_request,
             commands::router_configs::list_router_configs,
             commands::router_configs::create_router_config,
             commands::router_configs::create_router_config_with_models,
@@ -184,9 +188,12 @@ pub fn run() {
             commands::skills::skills_set_enabled,
             commands::skills::skills_uninstall,
         ])
+        .on_window_event(tray::handle_window_event)
         .setup(move |app| {
             tracing::info!("MisakaX initialized successfully");
 
+            tray::setup(app.handle())?;
+
             // Backfill sessions that still lack a working directory.
             {
                 let state = app.state::<AppState>();