鼠鬚管 (Squirrel) GUI 定制版功能说明书

本项目是基于 macOS 平台开源输入法引擎「鼠鬚管」(Squirrel / Rime for macOS) 开发的深度定制版本。旨在为 macOS 用户提供现代、直观且符合 Apple 原生人机交互规范的可视化定制体验。

项目主页： https://github.com/F-Mac-Prog/squirrel | 最新版本：v1.1.2

一、 核心架构与设计原则

1. 原生 SwiftUI 界面
   • 采用现代 SwiftUI 与 AppKit 深度融合构建，界面流畅轻快，完美遵循 macOS 人机界面设计指南（ HIG ），支持深浅外观自动跟随与切换。
2. 非侵入式配置存储 (Non-destructive Patching)
   • 图形界面所做的所有修改，均严格遵循 Rime 官方规范，生成标准 patch: 语句并写入用户目录下的 ~/Library/Rime/squirrel.custom.yaml。 *保证配置的纯净度与向下兼容性。
3. 安全生命周期管理
   • 修改配置后支持一键自动化触发后台重新部署（ Deploy ）。

二、 功能模块详细说明

1. 实时候选窗预览（ Live Preview ）与版式调整

• 实时仿真模拟器：
  • 在设置面板中内置高保真候选窗渲染器，用户可在测试框中直接键入拼音测试效果；
  • 点击仿真候选字可模拟直接上屏，直观感受文字排版与色彩层次。
• 真实屏幕环境测试：
• 排版与几何细节调控：
  • 排列布局：支持横向单行排列 (linear) 与纵向堆叠排列 (stacked)；
  • 文字方向：支持现代水平横写 (horizontal) 与传统竖直直写 (vertical)；
  • 内嵌特性：支持在应用光标处行内显示编码（ Inline Preedit ）以及首选字即时预览；
  • 交互细节：支持候选窗吸附防抖动（固定尺寸防位置跳移）、翻页提示箭头显示/隐藏；
  • 字体与间距：支持自由选择候选字字体名称、字号大小（ Font Size ）、行间距（ Line Spacing ）以及并击连打容差时间（ Chord Typing Delay ）。

2. 主题定制工坊（ Theme Studio ）与调色板

• 全新派生定制：
  • 支持从任一内置模板一键载入工坊，自由修改主题名称与英文识别码（ ID ），快速派生出属于自己的专属皮肤。
• 像素级色彩与材质微调：
  • 背景与材质：支持窗口背景色、高亮选中项背景色（反白胶囊）、外框线条颜色自定义，并支持原生半透明毛玻璃特效（ Translucency ）；
  • 文字配色：支持普通候选字颜色、高亮候选字颜色、拼音编码颜色、高亮编码颜色自定义；
  • 辅助标注：支持数字序号标签颜色、高亮序号颜色、词典注解提示词颜色及高亮注解颜色自由调控。
• 几何圆角精细控制：
  • 视窗外框圆角（ Window Corner Radius ）；
  • 高亮反白胶囊独立圆角（ Highlight Capsule Radius ）；
  • 边框线条粗细（ Border Width ）。
• 一键应用与分配：
  • 自由指定该主题应用于 macOS 的「浅色模式」还是「深色模式」，支持系统深浅色切换时自动更换配套主题。

3. 精选内置现代化预设主题

除了官方保留的传统配色外，额外收集了 10 套现代高质量预设主题：

• iOS 26 浅色灵动 (iOS 26 Light Glass)：现代浅色半透明磨砂卡片，Apple 经典交互蓝高亮。
• iOS 26 深色晶透 (iOS 26 Dark Glass)：高透明度深色晶莹卡片，纯白文字与现代蓝胶囊。
• Catppuccin 摩卡 (Catppuccin Mocha)：高人气深色护眼主题，深紫黑底色配淡紫薰衣草高亮。
• Catppuccin 拿铁 (Catppuccin Latte)：暖调纸质咖啡浅色主题，适合长时间办公与阅读。
• 东京之夜 (Tokyo Night)：夜空深蓝背景搭配霓虹紫/天蓝字，经典极客和风。
• 极光雪境 (Nord)：北极冰雪冷色调，优雅深灰蓝与极光青。
• 赛博霓虹 (Cyberpunk)：纯黑暗夜底色搭配荧光黄文字与青蓝高亮，高对比度张扬风格。
• 莫兰迪雅韵 (Morandi)：典雅温润的莫兰迪低饱和度大地灰调。
• 纸墨素笺 (Paper & Ink)：仿电子墨水屏 (E-Ink) 质感，纯净质朴。
• 暮云微霞 (Rosé Pine)：微醺复古玫瑰暗色调，淡雅小众。

4. 输入方案管理与智能发现 (Schema Discovery)

• 动态扫描：启动时自动扫描用户 ~/Library/Rime/ 目录中安装的所有方案配置文件（如朙月拼音、五笔、仓颉、注音、双拼等）；
• 方案总览：直观展示已安装方案的名称、方案标识符及启用顺序，免去打开配置文件翻查之苦。

5. 习惯配置与核心输入体验

• 每页候选字数：自由设置 1 至 10 个候选字。
• 状态栏图示：
  • 支持开启或关闭系统菜单栏的状态指示图标（显示「中」或「 A 」）；
  • 关闭后仅保留 macOS 系统的原生输入法标识，避免状态栏出现重复图标。
• 动态词频控制：
  • 提供图形化开关，支持根据输入历史动态调整常用词排序（智能调频自学习）；
  • 亦可随时关闭该功能，严格按照码表初始词频排序（固定词序，适合形码盲打）。
• 提示横幅：支持设置中英文或输入方案切换时，系统通知横幅的弹出策略（总是、适时、从不）。
• 底层键盘映射：支持自定义 ASCII 英文模式下的底层物理键盘映射（如美式 ABC 、USExtended 等）。

6. 快捷按键定制 (Key Bindings)

• 中英文切换键：
  • 支持针对左 Shift 、右 Shift 、左 Control 、右 Control 及 Caps Lock 键独立配置响应行为；
  • 行为选项包括：清除编码并切英文 (commit_code)、送出首选字并切英文 (commit_text)、进入行内英文模式 (inline_ascii)、清除全部编码 (clear) 或无操作 (noop)。
• 内置快捷键指南：
  • 方案切换快捷键：Control + ` (反引号) 或 F6 ；
  • 候选翻页键：- / =、, / .、[ / ]、PageUp / PageDown ；
  • 错词删除/词频重置：候选词高亮时按下 Control + Backspace （ Mac 笔记本键盘为 Fn + Delete + Control ）。

7. 应用程序专属模式 (App-specific Modes)

• 独立模式绑定：
  • 支持针对特定的应用程序（如 Terminal 、iTerm2 、Alacritty 、Xcode 、Obsidian 等）设置规则；
  • 切换到该应用程序时，输入法会自动保持或切换为 ASCII 英文状态，避免在终端或代码编辑器中误触发中文输入。
• 可视化管理：提供直接选取已安装 App 或手动输入 Bundle Identifier 的添加方式，支持快速启用/停用与移除。

8. 系统维护与运行诊断

• 一键重新部署 (Deploy)：直接向输入法后台守护服务发送部署指令，重新加载全部词库与 YAML 规则。
• 一键数据同步 (Sync)：快速触发用户词典与打字习惯备份至同步目录。
• 日志检视 (Logs)：在 Finder 中直接定位并打开 rime.squirrel 临时诊断运行日志。
• 目录导航：一键直达用户配置目录 ~/Library/Rime/。
• 安全退出进程 (Quit Squirrel)：平稳终止当前正在运行的输入法守护进程，便于版本更新或异常复位，再次键入文字时系统会自动重新唤起最新版本。

9. 多语言支持 (Localization)

• 完整提供简体中文、繁体中文与英文的无缝动态切换，词汇贴合各语言环境下原生 macOS 系统的标准用语。

下载与体验

• 项目源码（ GitHub ）： https://github.com/F-Mac-Prog/squirrel
• 安装包下载（ Releases ）： https://github.com/F-Mac-Prog/squirrel/releases
• 最新版本直下： https://github.com/F-Mac-Prog/squirrel/releases/download/v1.1.2-gui/Squirrel.pkg 安装方式：下载 Squirrel.pkg 双击按提示安装即可，已内置全部依赖。欢迎 Star 支持或提交反馈！