//! 终端模块设置的数据模型与默认值。 //! //! 持久化位置:`{app_data_dir}/terminal/settings.json`(与 translate / music 同一范式)。 //! 容器级 `#[serde(default)]`:新增字段对旧配置文件是**向后兼容**的——缺字段取默认值 //! 而不是让整份设置反序列化失败,避免用户因为一次升级丢掉全部配置。 //! //! 安全姿态(与 `crate::secrets` 的约定一致):**本结构里不允许出现任何明文凭据**。 //! SSH 密码、私钥 passphrase 一律进系统凭据管理器,本结构只保存它们的引用 id 与 //! 派生展示字段(如 `hasPassphrase`,由命令层回填,不落盘)。 use serde::{Deserialize, Serialize}; use specta::Type; // ===== 本地 Shell ===== /// 本地 Shell 配置。 /// /// 探测到的 Shell 与用户自定义的 Shell 用同一结构表达:`detected` 为 true 表示 /// 由 [`super::shell::detect_shells`] 自动发现,前端只允许改启动参数而不可改路径 /// (路径已被验证存在,改错会让会话起不来)。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct ShellProfile { /// 唯一标识(同时是新建会话时的 shellKey) pub id: String, /// 展示名称,如 "PowerShell 7" / "Windows PowerShell"。 /// /// **设置页里的描述名,不是标签上显示的名字** —— 后者取 /// [`super::shell::session_label`](按可执行文件名归一的短名)。 /// 两者刻意分开:描述名可编辑、可很长,而标签要能一行放下多个会话。 pub name: String, /// 可执行文件绝对路径 pub path: String, /// 启动参数 pub args: Vec, /// 启动时的工作目录(空串表示用用户主目录) pub cwd: String, /// 环境变量覆盖(键值对;值为空串表示删除该变量) pub env: Vec, /// Shell 类型:"powershell" | "cmd" | "bash" | "wsl" /// /// 决定三件事:cwd 跟踪 hook 的注入方式、清屏命令、以及 OSC 7 的解析口径。 pub kind: String, /// 是否由自动探测得到(true 时前端不可编辑 path) pub detected: bool, /// 是否在新建会话菜单中显示 pub enabled: bool, } #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct EnvVar { pub key: String, pub value: String, } /// 手写 `Default` 而不是 derive:`detected` 与 `enabled` 的默认值必须是 /// `true` / `true`(derive 会给 `false`),而 `#[serde(default)]` 在容器级 /// 要求每个字段类型都实现 `Default`。两者不一致会导致「反序列化出来的 /// Shell 默认禁用」这种隐性 bug。 impl Default for ShellProfile { fn default() -> Self { Self { id: String::new(), name: String::new(), path: String::new(), args: Vec::new(), cwd: String::new(), env: Vec::new(), kind: "bash".to_string(), detected: true, enabled: true, } } } /// 容器级 `#[serde(default)]` 要求字段类型实现 `Default`。 /// `EnvVar` 的「空值」语义就是空键空值,用 derive 的默认即可。 impl Default for EnvVar { fn default() -> Self { Self { key: String::new(), value: String::new(), } } } impl ShellProfile { pub fn new(id: &str, name: &str, path: &str, kind: &str) -> Self { Self { id: id.to_string(), name: name.to_string(), path: path.to_string(), args: Vec::new(), cwd: String::new(), env: Vec::new(), kind: kind.to_string(), detected: true, enabled: true, } } } // ===== SSH 主机 ===== /// SSH 主机条目。 /// /// `id` 是凭据键名的一部分(`terminal-ssh-password-{id}`),**创建后不应修改**: /// 改了会让已存进凭据管理器的密码读不到。前端在编辑态需禁用该字段。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct SshHost { pub id: String, /// 展示别名(列表主标题) pub name: String, pub host: String, pub port: u16, pub username: String, /// 认证方式:"key"(公钥,默认)| "password" | "agent"(P1)| "keyboard"(P1) pub auth_method: String, /// 公钥认证使用的密钥 id(指向 [`super::keys`] 的密钥库) pub key_id: String, /// 分组名(侧栏按此分组) pub group: String, /// 备注 pub note: String, /// 标签色(前端用于状态点/分组标识) pub color: String, /// 是否收藏(置顶显示) pub favorited: bool, /// 连接超时(毫秒) pub connect_timeout_ms: u64, /// keep-alive 间隔(秒,0 表示关闭) pub keepalive_secs: u64, /// 启动目录(空串表示登录后进入默认目录) pub remote_cwd: String, /// 登录后自动执行的命令 pub startup_command: String, /// 是否走代理模块(mihomo)。默认关闭:内网主机不该被绕进代理。 pub use_proxy: bool, /// 跳板机链(ProxyJump):按连接顺序排列的主机 id。 /// /// 每一项引用**本主机列表里的另一台主机**(复用它的地址、账号与凭据), /// 连接方向为 `本机 → jump_ids[0] → jump_ids[1] → … → 本主机`。 /// 空 = 直连。约束(命令层校验):不能引用自己、不能有环、 /// 链长上限 5、每一跳的认证方式必须是 key/password。 /// /// 用 id 引用而不是内联一份地址+凭据的理由:跳板机自己的密码/密钥 /// 存在凭据管理器里,按 id 复用可以避免同一台跳板机在多处配置里 /// 留下多份凭据副本(改密码时漏改一处就是连接事故)。 pub jump_ids: Vec, /// 终端的字符编码("utf-8" 默认 | "gbk" 等)。老服务器常见 GBK,中文环境刚需。 pub encoding: String, /// 是否在远端注入 shell 集成 hook(命令历史 + cwd 跟踪)。 /// /// # 为什么默认必须是 true /// /// 本结构是容器级 `#[serde(default)]`:老配置里缺这个字段时,serde 不是填 /// 「零值」而是取 [`SshHost::default()`] 的值。因此**默认值决定老主机是否自动 /// 开启注入** —— 填 `false` 会让所有既有主机静默不注入(表现为历史永远为空, /// 而开关在界面上看着是关的,用户根本不会去动它)。填 `true` 则无需改 /// `heal()`、无需升 `version`。 /// /// 关掉它的场景:远端 shell 集成会与 `startup_command` 里 `exec` 换 shell 的 /// 配置冲突,或服务器对会话环境有洁癖要求(注入会改本次会话的 `PROMPT_COMMAND`/ /// `precmd`,但不落盘、不影响其它会话)。 pub inject_shell_integration: bool, } impl Default for SshHost { fn default() -> Self { Self { id: String::new(), name: String::new(), host: String::new(), port: 22, username: String::new(), auth_method: "key".to_string(), key_id: String::new(), group: String::new(), note: String::new(), color: String::new(), favorited: false, connect_timeout_ms: 15_000, keepalive_secs: 30, remote_cwd: String::new(), startup_command: String::new(), use_proxy: false, jump_ids: Vec::new(), encoding: "utf-8".to_string(), // 必须 true,理由见字段文档(容器级 serde(default) 会用这里的值兜老配置) inject_shell_integration: true, } } } // ===== 外观 ===== /// 终端外观设置。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct AppearanceSettings { /// 配色主题 id(内置若干,见前端 terminalThemes.ts) pub theme: String, /// 是否跟随应用亮暗主题(开启时 `theme` 只作为亮/暗的取色基准) pub follow_app_theme: bool, /// 字体族(逗号分隔的 CSS font-family) pub font_family: String, pub font_size: u32, /// 行高倍数 pub line_height: f64, /// 字母间距 pub letter_spacing: f64, /// 光标样式:"block" | "bar" | "underline" pub cursor_style: String, /// 光标是否闪烁 pub cursor_blink: bool, /// 滚动缓冲区行数。上限 200000:再高会显著吃内存且滚动查找变慢。 pub scrollback: u32, /// 背景不透明度百分比(100 = 不透明) pub opacity: u32, /// 是否启用 GPU 渲染(addon-webgl)。极少数显卡驱动下有花屏问题,故给开关。 pub gpu_rendering: bool, } impl Default for AppearanceSettings { fn default() -> Self { Self { // 「跟随主应用」:配合默认开启的 follow_app_theme,开箱即随应用深浅切换 theme: "system".to_string(), follow_app_theme: true, font_family: "Cascadia Mono, Consolas, Microsoft YaHei Mono, monospace".to_string(), font_size: 14, line_height: 1.2, letter_spacing: 0.0, cursor_style: "block".to_string(), cursor_blink: true, scrollback: 10_000, opacity: 100, gpu_rendering: true, } } } // ===== 快捷键 ===== /// 一条终端内快捷键绑定。 /// /// 只覆盖**终端内**(第二层)快捷键:全局快捷键(第一层)由 `crate::shortcut` 统一 /// 注册并做应用内冲突检测,不走这里;shell 原生快捷键(第三层)不做拦截。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct ShortcutBinding { /// 动作标识,见前端 `terminalActions.ts`(如 "copy" / "newTab") pub action: String, /// 键位字符串,格式与 `crate::shortcut::parse_shortcut` 一致(如 "Ctrl+Shift+C") pub keys: String, /// 是否启用(关掉后该动作无快捷键,但仍可从菜单触发) pub enabled: bool, } impl Default for ShortcutBinding { fn default() -> Self { Self { action: String::new(), keys: String::new(), enabled: true, } } } // ===== 终端内选中行为 ===== /// 终端内选中行为。 /// /// # 为什么叫 `TerminalSelectionSettings` 而不是 `SelectionSettings` /// /// 与 `translate::settings::SelectionSettings` 撞名。`tauri-specta` 的类型注册表 /// **全局按类型名索引**,重名会让 `export_bindings()` panic /// (`Detected multiple types with the same name`)。 /// specta 2.0.0-rc.25 的 derive 路径无法重命名导出类型 /// (详见 `history::TerminalHistoryPage` 的注释),只能改 Rust 标识符本身。 /// /// 注意:这是**第二个**独立引入的 `SelectionSettings`。新增跨模块共享名之前, /// 先确认没有同名 `Type` 已存在 —— 否则会在**运行时启动阶段**才炸, /// 而不是编译期(见 `TERMINAL_MODULE_PLAN.md` 坑 27)。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct TerminalSelectionSettings { /// 选中即复制(受 Linux/macOS 习惯影响的用户会开;默认关,避免误触) pub copy_on_select: bool, /// 中键粘贴(X11 习惯;Windows 下默认关) pub middle_click_paste: bool, /// 右键行为:"menu"(默认,弹菜单)| "paste"(直接粘贴)| "select-word" pub right_click: String, /// 复制时是否去掉尾部空行 pub trim_trailing_newline: bool, } impl Default for TerminalSelectionSettings { fn default() -> Self { Self { copy_on_select: false, middle_click_paste: false, right_click: "menu".to_string(), trim_trailing_newline: true, } } } // ===== 布局 ===== #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct LayoutSettings { /// 关闭标签页时若会话仍有活跃进程,是否二次确认 pub confirm_close_running: bool, /// 新建标签页时是否继承当前会话的工作目录 pub inherit_cwd: bool, /// 是否显示底部状态栏 pub show_status_bar: bool, /// 分屏上限(1 = 不分屏,2 = 2×1,4 = 2×2)。 /// 上限刻意封在 4:分屏 × 标签 × 会话的组合复杂度会爆炸。 pub max_panes: u32, } impl Default for LayoutSettings { fn default() -> Self { Self { confirm_close_running: true, inherit_cwd: true, show_status_bar: true, max_panes: 4, } } } // ===== 命令片段 ===== /// 一条命令片段。 /// /// # 为什么 `command` 里允许变量占位符 /// /// 常用命令的差异往往只在少数字段(路径、主机名、分支名)。若每条变体都要 /// 单独存一条,片段库会迅速退化成「一堆几乎一样的条目」,反而找不到东西。 /// 因此支持 `${name}` 形式占位符,执行前弹出表单逐个填写。 /// /// 占位符语法刻意用 `${name}` 而不是 `{name}`:shell 自身大量使用 `{}` /// (`${VAR}`、`awk '{print}'`、brace expansion),单花括号会与用户的正常 /// 命令冲突,导致片段存进去就「被替换掉了」。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct CommandSnippet { pub id: String, /// 展示名称(列表主标题) pub name: String, /// 命令内容(可含 `${name}` 占位符) pub command: String, /// 说明(列表副标题,讲清这条命令做什么、有什么前提) pub description: String, /// 分组名(空串归入「未分组」) pub group: String, /// 占位符的默认值:name → 默认值。未列出的占位符默认空串。 pub defaults: std::collections::BTreeMap, /// 适用的 shell kind(空数组表示所有 shell 都适用)。 /// 例:`Get-ChildItem` 只对 powershell 有意义,不该出现在 cmd 的列表里。 pub shell_kinds: Vec, /// 仅对 SSH 会话显示(如 `sudo systemctl restart` 类远端操作) pub ssh_only: bool, /// 是否需要二次确认(危险命令,如 `rm -rf`) pub confirm: bool, /// 是否在片段面板中置顶 pub pinned: bool, /// 创建时间(Unix 毫秒,用于列表排序) pub created_at: u64, } impl Default for CommandSnippet { fn default() -> Self { Self { id: String::new(), name: String::new(), command: String::new(), description: String::new(), group: String::new(), defaults: std::collections::BTreeMap::new(), shell_kinds: Vec::new(), ssh_only: false, confirm: false, pinned: false, created_at: 0, } } } /// 从命令文本中提取 `${name}` 占位符名(去重、保持出现顺序)。 /// /// 放在 Rust 侧而不是前端:占位符是**命令语义的一部分**,执行前的替换、 /// 校验与「哪些占位符还没填」的判断必须用同一套解析, /// 两边各写一遍迟早会在边界情况(`$${x}`、`${a}${b}` 相邻)上分叉。 pub fn snippet_placeholders(command: &str) -> Vec { let bytes = command.as_bytes(); let mut out: Vec = Vec::new(); let mut i = 0usize; while i < bytes.len() { // 找 `${` if bytes[i] == b'$' && i + 1 < bytes.len() && bytes[i + 1] == b'{' { // `$${x}` 是字面量 `${x}`(转义),跳过 let escaped = i > 0 && bytes[i - 1] == b'$'; if !escaped { if let Some(end) = command[i + 2..].find('}') { let name = &command[i + 2..i + 2 + end]; // 占位符名限定为标识符形态,避免把 `${VAR:-default}` 这类 // shell 参数展开语法误当成占位符 if !name.is_empty() && name .chars() .all(|c| c.is_ascii_alphanumeric() || c == '_' || c == '-') && !out.iter().any(|x| x == name) { out.push(name.to_string()); } i = i + 2 + end + 1; continue; } } } i += 1; } out } /// 用给定值替换命令里的占位符。 /// /// 未提供的占位符**保持原样**(不替换成空串):静默替换成空串会让 /// `rm -rf ${dir}` 变成 `rm -rf ` —— 一个参数缺失的命令可能比一个 /// 显式报错的命令危险得多。调用方应先校验所有占位符都有值。 pub fn snippet_render(command: &str, values: &std::collections::BTreeMap) -> String { let mut out = String::with_capacity(command.len()); let bytes = command.as_bytes(); let mut i = 0usize; while i < bytes.len() { if bytes[i] == b'$' && i + 1 < bytes.len() && bytes[i + 1] == b'{' { let escaped = i > 0 && bytes[i - 1] == b'$'; if !escaped { if let Some(end) = command[i + 2..].find('}') { let name = &command[i + 2..i + 2 + end]; if !name.is_empty() && name .chars() .all(|c| c.is_ascii_alphanumeric() || c == '_' || c == '-') { match values.get(name) { Some(v) => out.push_str(v), None => out.push_str(&command[i..i + 2 + end + 1]), } i = i + 2 + end + 1; continue; } } } } // 逐字符拷贝,注意 UTF-8 多字节边界:这里直接按字节推进会让 // 中文字符被切断。故用 chars().next() 取整字符的长度。 let ch = command[i..].chars().next().unwrap_or(' '); out.push(ch); i += ch.len_utf8(); } out } // ===== 密钥存储(仅元数据)===== /// 密钥库的单个条目(元数据,**不含私钥内容**)。 /// /// 私钥本体存放在 `{app_data_dir}/terminal/keys/` 的独立文件里(可能是几 KB, /// 塞进 Windows 凭据管理器不可靠——单条有大小上限),passphrase 才进凭据管理器。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct KeyMeta { pub id: String, /// 展示名称 pub name: String, /// 算法:"ed25519" | "rsa" | "ecdsa" pub algorithm: String, /// 位数 / 曲线(RSA 2048/3072/4096;ECDSA P-256/P-384/P-521;ed25519 固定空串) pub bits: u32, /// 公钥指纹(SHA256,OpenSSH 展示格式 `SHA256:xxxx`) pub fingerprint: String, /// 公钥内容(`ssh-ed25519 AAAA... comment`),用于一键复制 pub public_key: String, /// 注释 pub comment: String, /// 私钥文件名(`keys/` 目录下,相对名) pub file_name: String, /// 创建时间(RFC3339) pub created_at: String, /// 是否由 ssh-agent 托管(P1) pub in_agent: bool, } impl Default for KeyMeta { fn default() -> Self { Self { id: String::new(), name: String::new(), algorithm: "ed25519".to_string(), bits: 0, fingerprint: String::new(), public_key: String::new(), comment: String::new(), file_name: String::new(), created_at: String::new(), in_agent: false, } } } // ===== 安全 ===== #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct SecuritySettings { /// 主机密钥策略:"ask"(默认,首次连接必须显式确认指纹)。 /// /// **不提供 "auto-accept" 选项**:TOFU 静默接受是 MITM 的入口, /// 属于代码层不该给用户的开关。 /// /// 读取方(`ssh::SshHandler::check_server_key`)**显式读取本字段而不是写死**: /// 唯一支持的取值是 `"ask"`,其它取值(配置文件被手工改过)一律按 `"ask"` /// 处理 —— 安全开关的失败方向必须朝更严的一侧,绝不能因为出现了一个 /// 没见过的字符串就放宽。 pub host_key_policy: String, /// 指纹变更时是否阻断(**默认 true**)。关掉会让中间人攻击无声通过, /// 因此前端需以红色风险提示呈现该开关。 /// /// 关闭时的行为不是「照旧弹窗」而是「自动接受并记入变更历史」: /// 开关的语义是「不再拦截」,若关掉后仍弹阻断弹窗,用户会以为没生效。 pub block_on_fingerprint_change: bool, /// 是否把**安全事件**写入日志(默认开)。 /// /// 记录对象是主机密钥相关的事件:指纹已信任 / 首次见到被接受 / 指纹变更 /// 被接受或拒绝 / 自动接受(阻断关闭时)。与「会话日志」(输出字节流落盘, /// 由工具栏的 `terminal_toggle_logging` 按会话显式开启,见 `audit` 模块的 /// 取舍说明)**是两件事**:这里只写事件行,不含屏幕内容,因此没有隐私代价, /// 默认开启才能保证「发生过什么」事后可查。 pub audit_log: bool, } impl Default for SecuritySettings { fn default() -> Self { Self { host_key_policy: "ask".to_string(), block_on_fingerprint_change: true, audit_log: true, } } } // ===== 根结构 ===== #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct TerminalSettings { /// 结构版本号(用于后续迁移判断) pub version: u32, /// 本地 Shell 配置(探测结果 + 用户自定义,合并存放) pub shells: Vec, /// SSH 主机条目 pub hosts: Vec, /// 密钥元数据 pub keys: Vec, pub appearance: AppearanceSettings, pub layout: LayoutSettings, pub shortcuts: Vec, pub selection: TerminalSelectionSettings, pub security: SecuritySettings, /// 「关闭标签页时确认」等行为的白名单:某些会话可豁免确认 pub close_confirm_exempt: Vec, /// 上次使用的 Shell id(新建会话时的默认选中项) pub last_shell_id: String, /// 命令片段库 pub snippets: Vec, /// 会话模板(一键拉起一组会话 + 布局) pub templates: Vec, } impl Default for TerminalSettings { fn default() -> Self { Self { version: 2, shells: Vec::new(), hosts: Vec::new(), keys: Vec::new(), appearance: AppearanceSettings::default(), layout: LayoutSettings::default(), shortcuts: default_shortcuts(), selection: TerminalSelectionSettings::default(), security: SecuritySettings::default(), close_confirm_exempt: Vec::new(), last_shell_id: String::new(), snippets: Vec::new(), templates: Vec::new(), } } } /// 会话模板:一键拉起一组会话并排成布局。 /// /// 拉起语义:`entries[0]` 作为主面板,其余依次以分屏面板加入 /// (受 `layout.maxPanes` 上限约束,超过 4 个的条目被忽略—— /// WebGL 上下文上限决定了可见面板不可能超过 4,见 useSessionStream 说明)。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct SessionTemplate { pub id: String, pub name: String, /// 创建时间(Unix 毫秒;模板列表按此排序) pub created_at: u64, pub entries: Vec, } impl Default for SessionTemplate { fn default() -> Self { Self { id: String::new(), name: String::new(), created_at: 0, entries: Vec::new(), } } } /// 模板中的一个会话条目。 #[derive(Debug, Clone, Serialize, Deserialize, Type)] #[serde(rename_all = "camelCase", default)] pub struct TemplateEntry { /// `"local"`(shell)| `"ssh"`(主机) pub kind: String, /// 本地 = shell id;SSH = host id。拉起时实时解析—— /// 模板只存引用,不快照账号密码(那些在凭据管理器里按 id 存取)。 pub target_id: String, /// 保存时的展示名快照(仅用于模板列表显示;target 失效时前端据此标注) pub label: String, } impl Default for TemplateEntry { fn default() -> Self { Self { kind: "local".to_string(), target_id: String::new(), label: String::new(), } } } /// 默认终端内快捷键。 /// /// 键位选择依据(Windows Terminal 惯例 + 与项目既有全局快捷键避让): /// - 复制粘贴用 `Ctrl+Shift+C/V` 而**不是** `Ctrl+C/V`:`Ctrl+C` 在终端里必须是 /// SIGINT,任何对它做复制映射的设计都会破坏 `^C` 中断,这是不可接受的。 /// - 新建/关闭标签用 `Ctrl+Shift+T/W`,与浏览器习惯一致。 /// - 跳转标签用 `Alt+1..9`:`Ctrl+数字` 已被翻译模块的 `Ctrl+2`(翻译面板)占用, /// 而 `Alt+数字` 在终端里通常不产生控制字符,冲突面最小。 ///- `newDetachedWindow`(`Alt+T`)是这张表里唯一**全局**生效的一条:它由前端 /// `TerminalQuickLaunch` 注册成系统级热键(任意应用前台可触发),放在这里只为 /// 跟着终端设置一起存与改。`Alt+T` 与翻译面板的 `Alt+F`、dsh 的 `Alt+D` /// 同处 `Alt+字母` 段,互不冲突。 pub fn default_shortcuts() -> Vec { let pairs: &[(&str, &str)] = &[ ("copy", "Ctrl+Shift+C"), ("paste", "Ctrl+Shift+V"), ("newTab", "Ctrl+Shift+T"), ("closeTab", "Ctrl+Shift+W"), ("nextTab", "Ctrl+Tab"), ("prevTab", "Ctrl+Shift+Tab"), ("splitRight", "Ctrl+Shift+D"), ("splitDown", "Ctrl+Shift+E"), ("closePane", "Ctrl+Shift+Q"), ("search", "Ctrl+Shift+F"), ("clear", "Ctrl+Shift+K"), ("fontIncrease", "Ctrl+="), ("fontDecrease", "Ctrl+-"), ("fontReset", "Ctrl+0"), ("toggleSftp", "Ctrl+Shift+P"), ("snippets", "Ctrl+Shift+S"), // 历史用 H(History)。不与 `Ctrl+Shift+H`(替换)冲突 —— // 终端里没有「替换」这个动作。 ("history", "Ctrl+Shift+H"), ("renameTab", "F2"), ("sessionSwitcher", "Ctrl+Shift+O"), // 把当前会话放到独立窗口。**必须列在这里**:`heal()` 只保留默认表里出现过的 // action(未知 action 会被剔除),前端设置表里有而这里没有 = 用户改完下次启动就被清掉。 ("detachWindow", "Ctrl+Shift+N"), // 全局生效的一条(见上方说明):新建独立窗口 + 选择会话 ("newDetachedWindow", "Alt+T"), ]; pairs .iter() .map(|(action, keys)| ShortcutBinding { action: action.to_string(), keys: keys.to_string(), enabled: true, }) .collect() } impl TerminalSettings { /// 按 id 找主机。 pub fn host(&self, id: &str) -> Option<&SshHost> { self.hosts.iter().find(|h| h.id == id) } /// 按 id 找 Shell。 pub fn shell(&self, id: &str) -> Option<&ShellProfile> { self.shells.iter().find(|s| s.id == id) } /// 自愈:修复失效引用、补齐缺失的默认值、推进结构版本。 /// /// 沿用 translate 模块确立的 `heal()` 约定:老配置缺字段取默认值, /// 失效引用自动回落,返回是否发生变更(由调用方决定是否落盘)。 pub fn heal(&mut self) -> bool { let mut changed = false; // 配色主题:只认前端 `terminalThemes.ts` 里存在的 key。 // 早期默认值是 `thing-dark`(一套从未实现的主题),解析时会静默回落到 // vscode-dark,用户看到的是「选了主题不生效」。未知 key 一律收敛到 // 「system」(跟随主应用)—— 它至少是用户能预期的行为。 const THEMES: &[&str] = &[ "vscode-dark", "vscode-light", "solarized-dark", "solarized-light", "dracula", "one-dark", "system", ]; if !THEMES.contains(&self.appearance.theme.as_str()) { self.appearance.theme = "system".to_string(); changed = true; } // 快捷键表:补齐新增动作、剔除已废弃动作。用户改过的键位保留。 let defaults = default_shortcuts(); for d in &defaults { if !self.shortcuts.iter().any(|s| s.action == d.action) { self.shortcuts.push(d.clone()); changed = true; } } let before = self.shortcuts.len(); // 只保留默认表里存在的 action,避免版本升级后残留无人消费的绑定 self.shortcuts .retain(|s| defaults.iter().any(|d| d.action == s.action)); if self.shortcuts.len() != before { changed = true; } // 主机的 key_id 指向已删除的密钥 → 清空并退回密码认证的提示由前端给, // 这里只做数据层清理(不回退 auth_method,避免静默改变用户的认证选择) let key_ids: Vec = self.keys.iter().map(|k| k.id.clone()).collect(); for host in &mut self.hosts { if !host.key_id.is_empty() && !key_ids.contains(&host.key_id) { host.key_id.clear(); changed = true; } } // 主机字段兜底:端口非法、用户名缺失等由前端表单保证,这里只防越界 for host in &mut self.hosts { if host.port == 0 { host.port = 22; changed = true; } if host.connect_timeout_ms < 1000 { host.connect_timeout_ms = 15_000; changed = true; } if host.encoding.trim().is_empty() { host.encoding = "utf-8".to_string(); changed = true; } } // 外观:滚动缓冲与字体大小越界会直接导致渲染异常 if self.appearance.scrollback < 100 { self.appearance.scrollback = 10_000; changed = true; } if self.appearance.scrollback > 200_000 { self.appearance.scrollback = 200_000; changed = true; } if self.appearance.font_size < 8 || self.appearance.font_size > 40 { self.appearance.font_size = 14; changed = true; } // 布局:分屏上限封顶 4 if self.layout.max_panes == 0 || self.layout.max_panes > 4 { self.layout.max_panes = 4; changed = true; } // 安全:主机密钥策略只有一个合法取值(见 SecuritySettings 的字段说明)。 // 手工改过的配置在这里收敛回 "ask",与 `check_server_key` 里 // 「未知取值按 ask 处理」构成两道保险:这道修数据,那道防空。 if self.security.host_key_policy != "ask" { self.security.host_key_policy = "ask".to_string(); changed = true; } // last_shell_id 指向已删除的 Shell → 清空,由前端选第一个可用 if !self.last_shell_id.is_empty() && self.shell(&self.last_shell_id).is_none() { self.last_shell_id.clear(); changed = true; } if self.version < 1 { self.version = 1; changed = true; } // v2:引入命令片段库。给**空库**塞一批起步片段 —— // 一个空片段面板对着用户等于没有这个功能,而「自己写第一条」的门槛 // 比「改一条现成的」高得多。只在空库时注入,用户删光后不会被重塞。 if self.version < 2 { if self.snippets.is_empty() { self.snippets = default_snippets(); } self.version = 2; changed = true; } // v2 → v3:新建独立窗口的默认键位从 Ctrl+3 改为 Alt+T(Ctrl+数字 与 // 翻译面板、终端「Alt+数字 跳标签」两处分段冲突,统一收到 Alt+字母)。 // 仍等于旧默认值 = 用户没改过,直接迁移;改过的原样保留。 if self.version < 3 { if let Some(binding) = self .shortcuts .iter_mut() .find(|s| s.action == "newDetachedWindow") { if binding.keys.trim().eq_ignore_ascii_case("ctrl+3") { binding.keys = "Alt+T".to_string(); } } self.version = 3; changed = true; } changed } } /// 起步命令片段。 /// /// 选取标准:**跨平台通用、参数化后确有复用价值、且不容易打错**的东西。 /// 刻意不放 `ls`/`cd` 这类过短命令 —— 它们手打比在列表里找更快, /// 放进片段库只会稀释信噪比。 pub fn default_snippets() -> Vec { fn mk( id: &str, name: &str, command: &str, description: &str, group: &str, placeholders: &[(&str, &str)], ssh_only: bool, confirm: bool, ) -> CommandSnippet { CommandSnippet { id: id.to_string(), name: name.to_string(), command: command.to_string(), description: description.to_string(), group: group.to_string(), defaults: placeholders .iter() .map(|(k, v)| (k.to_string(), v.to_string())) .collect(), shell_kinds: Vec::new(), ssh_only, confirm, pinned: false, created_at: 0, } } vec![ mk( "snip-find-large", "查找大文件", "find ${dir} -type f -size +${size} -exec ls -lh {} \\;", "列出指定目录下大于指定体积的文件。size 用 100M / 1G 这类写法。", "文件", &[("dir", "/"), ("size", "100M")], false, false, ), mk( "snip-grep-recursive", "递归搜索内容", "grep -rn --include=${pattern} '${keyword}' ${dir}", "在指定目录下按文件名模式递归搜索关键字。", "文件", &[("pattern", "*.log"), ("keyword", ""), ("dir", ".")], false, false, ), mk( "snip-tar-extract", "解压 tar.gz", "tar -xzvf ${file} -C ${target}", "解压到指定目录。target 留空则解到当前目录。", "文件", &[("file", ""), ("target", ".")], false, false, ), mk( "snip-df", "磁盘占用概览", "df -h | sort -k5 -hr | head -20", "按使用率倒序列出挂载点。排查「磁盘满了」的第一步。", "诊断", &[], false, false, ), mk( "snip-port-owner", "查端口占用", "ss -tlnp | grep ${port}", "查看监听指定端口的进程。老系统若无 ss,改用 netstat -tlnp。", "诊断", &[("port", "8080")], false, false, ), mk( "snip-top-cpu", "CPU 占用前 10", "ps aux --sort=-%cpu | head -11", "按 CPU 占用倒序列出进程(含表头共 11 行)。", "诊断", &[], false, false, ), mk( "snip-tail-follow", "跟踪日志", "tail -f ${file}", "实时跟随文件新增内容。Ctrl+C 退出。", "运维", &[("file", "")], false, false, ), mk( "snip-systemd-status", "服务状态", "systemctl status ${service} --no-pager", "查看 systemd 服务状态。--no-pager 让输出直接落到终端而不是进 less。", "运维", &[("service", "")], true, false, ), mk( "snip-perm-fix", "递归修正属主", "chown -R ${owner}:${group} ${dir}", "递归修改目录属主与属组。", "运维", &[("owner", ""), ("group", ""), ("dir", "")], true, true, ), mk( "snip-ssh-tunnel", "建立 SSH 隧道", "ssh -N -L ${localPort}:${remoteHost}:${remotePort} ${user}@${jumpHost}", "本地端口转发。localPort 是你要在本机访问的端口。", "网络", &[ ("localPort", "8080"), ("remoteHost", "127.0.0.1"), ("remotePort", "80"), ("user", ""), ("jumpHost", ""), ], false, false, ), mk( "snip-ssh-keygen", "生成 SSH 密钥", "ssh-keygen -t ed25519 -C \"${comment}\" -f ~/.ssh/${name}", "生成 ed25519 密钥对。ed25519 比 RSA 短且更快,现代环境首选。", "网络", &[("comment", ""), ("name", "id_ed25519")], false, false, ), ] }