feat: add clipboard copy/paste (Ctrl+C/Ctrl+V) and switch exit to Ctrl+Q

- Add clipboard module with arboard crate for system clipboard access
- Copy: Ctrl+C in navigation mode copies selection to clipboard (TSV)
- Paste: Ctrl+V pastes clipboard content at cursor, auto-expanding worksheet
- Paste respects MAX_ROWS/MAX_COLUMNS limits with boundary checks
- Render dashed border for copied region, solid border for selection
- Change exit shortcut from Ctrl+C to Ctrl+Q to avoid conflict
- Rename ExitHandler::press_ctrl_c to press_ctrl_q

Author: uednd

Cargo.lock

@@ -10,6 +10,7 @@ edition = "2024"
 color-eyre = "0.6.3"
 crossterm = "0.29.0"
 ratatui = "0.30.1"
+arboard = "3"
 replace-homedir = "0.1"
 serde = { version = "1", features = ["derive"] }
 serde_json = "1"

Cargo.toml

@@ -101,8 +101,8 @@ impl App {
     }
 
     fn dispatch_key(&mut self, key: crossterm::event::KeyEvent) {
-        if key.code == KeyCode::Char('c') && key.modifiers.contains(KeyModifiers::CONTROL) {
-            self.exit_handler.press_ctrl_c();
+        if key.code == KeyCode::Char('q') && key.modifiers.contains(KeyModifiers::CONTROL) {
+            self.exit_handler.press_ctrl_q();
             return;
         }
         match self.active_screen.handle_key(key) {

src/app.rs

@@ -0,0 +1,55 @@
+//! 剪贴板操作与 TSV 编解码。
+//!
+//! 复制时：单元格数据 → [`to_tsv`] → [`copy_to_clipboard`]
+//! 粘贴时：[`read_from_clipboard`] → [`from_tsv`] → 单元格数据
+
+/// 复制文本到系统剪贴板。
+pub fn copy_to_clipboard(text: &str) -> Result<(), String> {
+    let mut last_err = String::new();
+    for _ in 0..3 {
+        match arboard::Clipboard::new().and_then(|mut c| c.set_text(text)) {
+            Ok(()) => return Ok(()),
+            Err(e) => last_err = e.to_string(),
+        }
+    }
+    Err(last_err)
+}
+
+/// 从系统剪贴板读取文本。
+pub fn read_from_clipboard() -> Result<String, String> {
+    let mut last_err = String::new();
+    for _ in 0..3 {
+        match arboard::Clipboard::new().and_then(|mut c| c.get_text()) {
+            Ok(text) => return Ok(text),
+            Err(e) => last_err = e.to_string(),
+        }
+    }
+    Err(last_err)
+}
+
+/// 将二维单元格网格编码为 TSV 文本。
+///
+/// 行内用 `\t` 分隔列，行间用 `\n` 分隔。
+/// 空字符串代表空单元格。
+pub fn to_tsv(rows: &[Vec<String>]) -> String {
+    rows.iter()
+        .map(|row| row.join("\t"))
+        .collect::<Vec<_>>()
+        .join("\n")
+}
+
+/// 将 TSV 文本解析为二维字符串网格。
+///
+/// - 按 `\n` 分行（同时处理 `\r\n`）
+/// - 去除末尾空行
+/// - 每行按 `\t` 分列
+pub fn from_tsv(text: &str) -> Vec<Vec<String>> {
+    let trimmed = text.trim_end_matches('\n').trim_end_matches('\r');
+    if trimmed.is_empty() {
+        return vec![];
+    }
+    trimmed
+        .lines()
+        .map(|line| line.split('\t').map(|s| s.to_string()).collect())
+        .collect()
+}

src/clipboard.rs

@@ -23,7 +23,7 @@ impl ExitHandler {
         }
     }
 
-    pub fn press_ctrl_c(&mut self) {
+    pub fn press_ctrl_q(&mut self) {
         let now = Instant::now();
         self.state = match self.state {
             State::Idle => State::ConfirmOnce(now),
@@ -67,7 +67,7 @@ impl ExitHandler {
 
     pub fn hint_text(&self) -> Option<&'static str> {
         if matches!(self.state, State::ConfirmOnce(_)) {
-            Some("再次按下 Ctrl+C 以退出")
+            Some("再次按下 Ctrl+Q 以退出")
         } else {
             None
         }

src/exit.rs

@@ -1,8 +1,9 @@
 //! mini-excel —— 基于 Ratatui 的 TUI 迷你 Excel 应用。
 //!
-//! 按两次 Ctrl+C 退出。
+//! 按两次 Ctrl+Q 退出。
 
 mod app;
+mod clipboard;
 mod exit;
 mod model;
 mod screen;

src/main.rs

@@ -5,6 +5,7 @@ use std::io;
 use std::path::Path;
 
 use super::cell::{Cell, CellAddress, CellValue};
+use super::limits;
 
 /// 清空单元格内容的范围。
 ///
@@ -94,6 +95,14 @@ impl Workbook {
         self.cells.remove(&addr);
     }
 
+    /// 确保表格行列数不小于指定值。
+    ///
+    /// 粘贴时自动扩展表格。不会超过最大行列限制。
+    pub fn ensure_size(&mut self, rows: usize, cols: usize) {
+        self.rows = self.rows.max(rows).min(limits::MAX_ROWS);
+        self.columns = self.columns.max(cols).min(limits::MAX_COLUMNS);
+    }
+
     /// 删除指定行，该行上方的行不动，下方行上移，总行数减一。
     ///
     /// 至少保留一行。该方法只维护工作簿尺寸和单元格位置；

src/model/workbook.rs

@@ -1,4 +1,8 @@
-use crate::{model::workbook::Workbook, screen::ScreenCommand, theme::Theme};
+use crate::{
+    model::{cell::CellAddress, workbook::Workbook},
+    screen::ScreenCommand,
+    theme::Theme,
+};
 
 use super::{mode::Selection, viewport::Viewport};
 
@@ -12,6 +16,7 @@ pub struct TableContext {
     path: String,
     wb: Workbook,
     selection: Option<Selection>,
+    copied_region: Option<Selection>,
     /// 模式需要切换屏幕时写入，随后由 `ModeHost` 取走。
     pending_command: Option<ScreenCommand>,
 }
@@ -25,6 +30,7 @@ impl TableContext {
             wb,
             viewport: Viewport::new(),
             selection: None,
+            copied_region: None,
             pending_command: None,
         }
     }
@@ -64,6 +70,13 @@ impl TableContext {
         self.selection = None;
     }
 
+    /// 已复制的区域（用于渲染虚线边框）。
+    ///
+    /// `None` 表示没有待粘贴的复制内容。
+    pub fn copied_region(&self) -> Option<&Selection> {
+        self.copied_region.as_ref()
+    }
+
     /// 光标所在单元格的原始文本。
     pub fn current_cell_raw(&self) -> String {
         self.wb
@@ -99,6 +112,89 @@ impl TableContext {
         self.wb.clear_cell(self.viewport.cursor());
     }
 
+    /// 复制当前选区的单元格内容到系统剪贴板。
+    ///
+    /// - 无选区 → 复制光标所在单元格
+    /// - Range   → 复制矩形区域内所有单元格
+    /// - Row     → 复制整行（所有列）
+    /// - Column  → 复制整列（所有行）
+    ///
+    /// 不改变选区或光标状态。
+    pub fn copy_selection(&mut self) -> Result<(), String> {
+        let cells = self.collect_selection();
+        let tsv = crate::clipboard::to_tsv(&cells);
+        crate::clipboard::copy_to_clipboard(&tsv)?;
+        self.copied_region = match &self.selection {
+            Some(sel) => Some(*sel),
+            None => {
+                let cur = self.viewport.cursor();
+                Some(Selection::Range {
+                    anchor: cur,
+                    cursor: cur,
+                })
+            }
+        };
+        Ok(())
+    }
+
+    /// 从系统剪贴板粘贴到光标位置。
+    ///
+    /// 自动扩展表格行列（不超过最大限制）。
+    /// 粘贴后创建 Range 选区覆盖整个粘贴区域。
+    /// 光标位置不变。
+    pub fn paste_from_clipboard(&mut self) -> Result<(), String> {
+        let text = crate::clipboard::read_from_clipboard()?;
+        let rows = crate::clipboard::from_tsv(&text);
+        if rows.is_empty() {
+            return Ok(());
+        }
+
+        let paste_cols = rows[0].len();
+        let paste_rows = rows.len();
+        let start = self.viewport.cursor();
+
+        self.wb
+            .ensure_size(start.row + paste_rows, start.col + paste_cols);
+
+        for (r, row_cells) in rows.iter().enumerate() {
+            let target_row = start.row + r;
+            if target_row >= self.wb.rows {
+                break;
+            }
+            for (c, cell_text) in row_cells.iter().enumerate() {
+                let target_col = start.col + c;
+                if target_col >= self.wb.columns {
+                    break;
+                }
+                let addr = CellAddress {
+                    row: target_row,
+                    col: target_col,
+                };
+                if cell_text.is_empty() {
+                    self.wb.clear_cell(addr);
+                } else {
+                    self.wb.set_text(addr, cell_text.clone());
+                }
+            }
+        }
+
+        let end_row = (start.row + paste_rows).min(self.wb.rows).saturating_sub(1);
+        let end_col = (start.col + paste_cols)
+            .min(self.wb.columns)
+            .saturating_sub(1);
+
+        self.copied_region = None;
+        self.set_selection(Selection::Range {
+            anchor: start,
+            cursor: CellAddress {
+                row: end_row,
+                col: end_col,
+            },
+        });
+
+        Ok(())
+    }
+
     /// 清空当前选区，并退出选区状态。
     pub fn clear_selection_cells(&mut self) {
         if let Some(spec) = self.selection_clear_spec() {
@@ -135,4 +231,42 @@ impl TableContext {
             },
         })
     }
+
+    fn collect_selection(&self) -> Vec<Vec<String>> {
+        match &self.selection {
+            None => {
+                vec![vec![self.current_cell_raw()]]
+            }
+            Some(Selection::Range { anchor, cursor }) => {
+                let r1 = anchor.row.min(cursor.row);
+                let r2 = anchor.row.max(cursor.row);
+                let c1 = anchor.col.min(cursor.col);
+                let c2 = anchor.col.max(cursor.col);
+                (r1..=r2)
+                    .map(|r| (c1..=c2).map(|c| self.cell_raw_at(r, c)).collect())
+                    .collect()
+            }
+            Some(Selection::Row(r)) => {
+                let r = *r;
+                vec![
+                    (0..self.wb.columns)
+                        .map(|c| self.cell_raw_at(r, c))
+                        .collect(),
+                ]
+            }
+            Some(Selection::Column(c)) => {
+                let c = *c;
+                (0..self.wb.rows)
+                    .map(|r| vec![self.cell_raw_at(r, c)])
+                    .collect()
+            }
+        }
+    }
+
+    fn cell_raw_at(&self, row: usize, col: usize) -> String {
+        self.wb
+            .get_cell(CellAddress { row, col })
+            .map(|cell| cell.raw.clone())
+            .unwrap_or_default()
+    }
 }

src/screen/editor/context.rs

@@ -94,6 +94,14 @@ impl ModeHost {
             self.mode = Box::new(DeleteMode::new());
             return Some(EventResult::Handled);
         }
+        if Self::is_ctrl_c(key) && self.mode.kind() == ModeKind::Navigation {
+            let _ = ctx.copy_selection();
+            return Some(EventResult::Handled);
+        }
+        if Self::is_ctrl_v(key) && self.mode.kind() == ModeKind::Navigation {
+            let _ = ctx.paste_from_clipboard();
+            return Some(EventResult::Handled);
+        }
         None
     }
 
@@ -108,4 +116,12 @@ impl ModeHost {
     fn is_ctrl_d(key: KeyEvent) -> bool {
         key.code == KeyCode::Char('d') && key.modifiers.contains(KeyModifiers::CONTROL)
     }
+
+    fn is_ctrl_c(key: KeyEvent) -> bool {
+        key.code == KeyCode::Char('c') && key.modifiers.contains(KeyModifiers::CONTROL)
+    }
+
+    fn is_ctrl_v(key: KeyEvent) -> bool {
+        key.code == KeyCode::Char('v') && key.modifiers.contains(KeyModifiers::CONTROL)
+    }
 }

src/screen/editor/host.rs

@@ -70,6 +70,7 @@ impl Screen for TableScreen {
 
         let edit_buffer = self.host.edit_buffer();
         let selection = self.ctx.selection();
+        let copied_region = self.ctx.copied_region();
         TableGrid::render(
             frame,
             inner,
@@ -79,6 +80,7 @@ impl Screen for TableScreen {
                 theme: self.ctx.theme,
                 edit_buffer,
                 selection,
+                copied_region,
             },
         );
     }