refactor(tui): 重构 Overview、Sessions 与 Daily 视图

crates/tokscale-cli/src/tui/app.rs

@@ -370,8 +370,6 @@ pub struct App {
     usage_text_total_lines: usize,
     pub(crate) hourly_profile_viewport: TextViewport,
     hourly_profile_text_total_lines: usize,
-    pub(crate) issues_viewport: TextViewport,
-    issues_text_total_lines: usize,
     pub selected_daily_detail_date: Option<NaiveDate>,
     pub selected_period_detail: Option<PeriodDetailSelection>,
     detail_sort_contexts: HashMap<DetailSortContextKind, DetailSortContext>,
@@ -526,8 +524,6 @@ impl App {
             usage_text_total_lines: 0,
             hourly_profile_viewport: TextViewport::default(),
             hourly_profile_text_total_lines: 0,
-            issues_viewport: TextViewport::default(),
-            issues_text_total_lines: 0,
             selected_daily_detail_date: None,
             selected_period_detail: None,
             detail_sort_contexts: HashMap::new(),
@@ -1078,23 +1074,12 @@ impl App {
             .visible_range(self.hourly_profile_text_total_lines)
     }
 
-    pub(crate) fn set_issues_text_viewport(&mut self, visible: usize, total_lines: usize) {
-        self.issues_text_total_lines = total_lines;
-        self.issues_viewport.set_visible(visible, total_lines);
-    }
-
-    pub(crate) fn issues_text_visible_range(&self) -> std::ops::Range<usize> {
-        self.issues_viewport
-            .visible_range(self.issues_text_total_lines)
-    }
-
     fn active_text_viewport_mut(&mut self) -> Option<&mut TextViewport> {
         match self.current_tab {
             Tab::Usage => Some(&mut self.usage_viewport),
             Tab::Hourly if self.hourly_view_mode == HourlyViewMode::Profile => {
                 Some(&mut self.hourly_profile_viewport)
             }
-            Tab::Issues => Some(&mut self.issues_viewport),
             _ => None,
         }
     }
@@ -1105,7 +1090,6 @@ impl App {
             Tab::Hourly if self.hourly_view_mode == HourlyViewMode::Profile => {
                 Some(self.hourly_profile_text_total_lines)
             }
-            Tab::Issues => Some(self.issues_text_total_lines),
             _ => None,
         }
     }
@@ -3668,21 +3652,6 @@ mod tests {
         assert_eq!(app.scroll_offset, 1);
     }
 
-    #[test]
-    fn issues_tab_key_scrolls_text_viewport_without_table_selection() {
-        let mut app = make_app();
-        app.current_tab = Tab::Issues;
-        app.selected_index = 2;
-        app.scroll_offset = 1;
-        app.set_issues_text_viewport(4, 10);
-
-        app.handle_key_event(key(KeyCode::PageDown));
-
-        assert_eq!(app.issues_viewport.scroll, 2);
-        assert_eq!(app.selected_index, 2);
-        assert_eq!(app.scroll_offset, 1);
-    }
-
     #[test]
     fn usage_tab_mouse_wheel_scrolls_text_viewport_without_table_selection() {
         let mut app = make_app_with_usage();

crates/tokscale-cli/src/tui/data/mod.rs

@@ -20,9 +20,7 @@ pub use tokscale_core::usage_views::{
     HourlyModelInfo, HourlyUsage, PeriodKind, PeriodUsage, UsageData, UsageGraphData as GraphData,
     UsageModelEntry as ModelUsage, UsageTokenBreakdown as TokenBreakdown,
 };
-pub use tokscale_core::{
-    aggregate_by_period, aggregate_by_weekday, build_period_usage, find_peak_hour,
-};
+pub use tokscale_core::{aggregate_by_period, build_period_usage, find_peak_hour};
 
 /// Returns the scanner settings that `DataLoader` should use when building
 /// `LocalParseOptions`. Under `#[cfg(test)]` this intentionally ignores

crates/tokscale-cli/src/tui/mod.rs

@@ -6,9 +6,11 @@ pub mod data;
 mod event;
 mod export;
 mod interaction;
+mod session_data;
 pub mod settings;
 mod themes;
 mod ui;
+mod view_state;
 
 use app::KeyEventOutcome;
 pub use app::{App, Tab, TuiConfig, TuiExit};
@@ -52,9 +54,10 @@ use tokscale_core::{
 
 fn decide_initial_data(load_result: CacheResult) -> (Option<UsageData>, bool, Option<u64>) {
     match load_result {
-        CacheResult::Fresh(data, signature) => {
-            (Some(data), false, Some(signature.process_digest()))
-        }
+        // The cached TUI bundle does not persist the independent Sessions projection.
+        // Keep rendering it immediately, then run the inventory probe in the background
+        // so Sessions can be refreshed without forcing the main usage aggregation.
+        CacheResult::Fresh(data, signature) => (Some(data), true, Some(signature.process_digest())),
         CacheResult::Stale(data) => (Some(data), true, None),
         CacheResult::Miss => (None, true, None),
     }
@@ -88,6 +91,12 @@ enum BackgroundLoad {
     },
 }
 
+fn refresh_session_data(loader: &DataLoader, clients: &[ClientId]) {
+    if let Err(error) = session_data::refresh(loader, clients) {
+        tracing::warn!(error = %error, "failed to refresh TUI Sessions projection");
+    }
+}
+
 fn load_background_data(
     loader: &DataLoader,
     clients: &[ClientId],
@@ -100,17 +109,19 @@ fn load_background_data(
         .refresh_source_inventory_signature()?
         .process_digest();
     if !force && last_digest == Some(digest) {
+        refresh_session_data(loader, clients);
         return Ok(BackgroundLoad::Unchanged);
     }
-    loader
-        .execute_with_diagnostics(prepared, group_by)
-        .map(|result| BackgroundLoad::Loaded {
-            data: Box::new(result.data),
-            digest: result.source_digest,
-            source_inventory_signature: result.source_inventory_signature,
-            pricing_diagnostics: result.pricing_diagnostics,
-            cache_persistence_warning: None,
-        })
+
+    let result = loader.execute_with_diagnostics(prepared, group_by);
+    refresh_session_data(loader, clients);
+    result.map(|result| BackgroundLoad::Loaded {
+        data: Box::new(result.data),
+        digest: result.source_digest,
+        source_inventory_signature: result.source_inventory_signature,
+        pricing_diagnostics: result.pricing_diagnostics,
+        cache_persistence_warning: None,
+    })
 }
 
 fn persist_background_load(
@@ -313,6 +324,7 @@ pub fn run(
         }
     };
     app.last_source_digest = initial_source_digest;
+    let mut view_state = view_state::ViewState::default();
 
     let (bg_tx, bg_rx) = mpsc::channel::<Result<BackgroundLoad>>();
 
@@ -329,11 +341,13 @@ pub fn run(
         let bg_enabled_clients = enabled_clients.clone();
         let bg_group_by = app.group_by.borrow().clone();
         let bg_report_scope = background_cache_scope(&home_dir, &since, &until, &year)?;
+        let bg_last_digest = initial_source_digest;
+        let bg_force = bg_last_digest.is_none();
 
         thread::spawn(move || {
             let loader = background_data_loader(bg_home_dir, bg_since, bg_until, bg_year);
             let result = persist_background_load(
-                load_background_data(&loader, &bg_clients, &bg_group_by, true, None),
+                load_background_data(&loader, &bg_clients, &bg_group_by, bg_force, bg_last_digest),
                 &bg_enabled_clients,
                 &bg_group_by,
                 &bg_report_scope,
@@ -359,6 +373,7 @@ pub fn run(
     let result = run_loop_with_background(
         &mut terminal,
         &mut app,
+        &mut view_state,
         &mut events,
         bg_tx,
         bg_rx,
@@ -395,6 +410,7 @@ fn restore_terminal(terminal: &mut Terminal<CrosstermBackend<io::Stdout>>) {
 fn run_loop_with_background(
     terminal: &mut Terminal<CrosstermBackend<io::Stdout>>,
     app: &mut App,
+    view_state: &mut view_state::ViewState,
     events: &mut EventHandler,
     bg_tx: mpsc::Sender<Result<BackgroundLoad>>,
     bg_rx: mpsc::Receiver<Result<BackgroundLoad>>,
@@ -412,7 +428,7 @@ fn run_loop_with_background(
             let _ = terminal.clear();
         }
 
-        terminal.draw(|f| ui::render(f, app))?;
+        terminal.draw(|frame| ui::render_with_state(frame, app, view_state))?;
 
         match bg_rx.try_recv() {
             Ok(result) => {
@@ -466,6 +482,9 @@ fn run_loop_with_background(
                 app.on_tick();
             }
             Event::Key(key) => {
+                if view_state.handle_key(app, &key) {
+                    continue;
+                }
                 if let KeyEventOutcome::Exit(exit) = app.handle_key_event(key) {
                     return Ok(exit);
                 }
@@ -547,14 +566,14 @@ mod tests {
     }
 
     #[test]
-    fn launches_with_fresh_cache_skips_immediate_background_load() {
+    fn launches_with_fresh_cache_refreshes_session_projection_in_background() {
         let (cached_data, needs_background_load, digest) = decide_initial_data(CacheResult::Fresh(
             UsageData::default(),
             tokscale_core::SourceInventorySignature::from_bytes([1; 32]),
         ));
 
         assert!(cached_data.is_some());
-        assert!(!needs_background_load);
+        assert!(needs_background_load);
         assert!(digest.is_some());
     }
 
@@ -624,7 +643,7 @@ mod tests {
             .source_inventory_signature;
         let (_, needs_load, baseline) =
             decide_initial_data(CacheResult::Fresh(UsageData::default(), signature_a));
-        assert!(!needs_load);
+        assert!(needs_load);
 
         assert!(matches!(
             load_background_data(