Tinycast 设置面板完全指南21 个设置项、默认值与源码级实现解析【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycastTinycast 是一个完全原生的 macOS 启动器launcher、热键与剪贴板历史工具。本文以 website/content/docs/reference/settings.md 为骨架系统讲解它的设置窗口如何打开、如何用搜索直达任意设置项、四个分组共 21 个面板各自包含什么、每个配置的默认值并结合 Tinycast/Features/Settings 目录下的 Swift 源码说明这些开关背后如何落地。读完本文你能完整掌握 Tinycast 设置体系的全貌知道每个开关在哪、默认是什么、改了什么行为以及哪些设置在备份中会被刻意排除。打开设置窗口设置窗口是 Tinycast 中一个普通的、可调整大小的窗口打开方式有三种在任意界面按下⌘,在启动器、AI Chat、剪贴板等任意屏幕都有效参见 palette.md 中的快捷键表在启动器中输入并选择Settings命令点击菜单栏图标在菜单中选Settings…。打开后窗口左侧是分组与面板列表右侧是当前面板的配置表单。从源码 SettingsTab.swift 可以看到设置项被精确划分为四个分组SettingsSectionGeneralGeneral、Permissions、LauncherApplications、System Settings、System Actions、Commands、Quicklinks、Apple Shortcuts、Fallbacks、FeaturesAI、Quick Actions、File Search、Notes、Snippets、Navigation、Window Management、Clipboard、Emoji Symbols、Calendar、Extensions、AdvancedBackup、About合计21 个面板与文档完全一致。设置搜索按名称甚至按标题之外的词查找设置窗口顶部有一个搜索字段它不仅能按设置的标题匹配还能匹配标题之外的单词。例如输入ocr能找到Search text in images and PDFs标题里根本没有 OCR 字样输入caps lock能找到Hyper Key。选中一条结果会直接跳到那一行而不是只跳到所在面板。这一行为的实现位于 SettingsSearchCatalog.swift。它是一份手写的索引SettingsSearchEntry列表因为 SwiftUI 的Form无法反向询问自己包含哪些行所以每新增一行可搜索的设置都必须同步登记到这里。每个条目包含tab所属面板target跳转目标行或分组锚点title可见标题keywords用户可能输入但标题里没有的词。搜索采用模糊匹配FuzzyMatch查询被按空白拆成多个词每个词必须至少命中标题、关键词或面包屑breadcrumb之一标题命中得分高于关键词命中面板自身的得分又高于其内部行所以输入裸的 clipboard 会落在 Clipboard 面板而不是某一行上。结果按得分排序同分时按目录顺序稳定排列最多返回 50 条。整个索引按面板顺序 面板内分组顺序书写读起来就像一份设置目录。搜索索引里值得注意的关键词General 面板App Launcher带hotkey/shortcut/summon/paletteLearned ranking带reset/history/order/privacyHyper Key带modifier/remap/caps lockTheme带dark/light/mode/appearanceInterface size带text size/font size/scale/zoom。AI 面板Providers带sign in/connect/codex/claude/grok/opencode/cursor/api key/base url/openai/anthropic/ollamaWeb search带browse/internet。Clipboard 面板Search text in images and PDFs带OCR/recognize/scan/screenshot/background/idle。Backup 面板Raycast Export带migrate/rayconfig/passphrase。这说明设置搜索的定位是帮用户用自然语言找到设置而不仅是标题匹配。General 分组General 面板这是设置窗口的总控面板从源码 GeneralSettingsView.swift 可以看到它由五个分组Section构成全局快捷键、学习排序、Hyper Key、外观、通用项。App Launcher给启动器本身绑定一个全局快捷键默认NoneTinycast 出厂时不绑定任何快捷键参见 hotkeys.md。源码中对应ShortcutRecorder(action: .togglePalette)。Learned rankingTinycast 会私密地学习你对每个查询更常选哪个结果这一行提供Reset…按钮清空全部学习结果、恢复默认排序。源码中按钮在launcherRanking.isEmpty时禁用点击后弹出确认对话框Reset learned launcher ranking?确认后调用launcherRanking.resetAll()。学习数据的备份与恢复详见 backup.md 中 Launcher Learning 类别。Hyper Key把一颗物理键改造成⌃⌥⌘开启Include Shift后是⌃⌥⇧⌘。可选None · Caps Lock · Right Control · Right Shift · Right Option · Right Command默认None。选择后源码会立即把hyperKeyQuickPress重置为 none并调用Permissions.ensureAccessibility()Hyper Key 需要辅助功能权限且不会主动索取。凡包含全部 Hyper 修饰键的快捷键在界面上统一显示为 ✦如✦G。Quick Press单独按下 Hyper 键时的行为可选Does Nothing · 对应键的原始功能 · Trigger Escape默认Does Nothing切换 Hyper 键时该选择会被重置。只有当选中的键存在原始功能时该行才出现Caps Lock 没有原始功能。Include Shift (⇧)On/Off默认On。切换它会更新所有已保存的快捷键把⌃⌥⌘扩展为四键和弦如果更新后与其它快捷键冲突那条会被跳过并保留原键。Hyper Key 为 None 时该开关置灰。若未授予辅助功能权限分组内会出现一行橙色警告Tinycast needs Accessibility access to remap keys.附Grant Access…按钮直接打开系统设置。ThemeSystem · Light · Dark默认System。System 跟随 macOS 外观Light 是同一设计的反色版本布局、字体与动效完全一致。对应源码settings.appearance。Interface sizeDefault · Large · Larger默认Default。让启动器及其浮动窗口整体放大 10% 或 20%设置窗口本身保持原尺寸。源码 GeneralSettingsView.swift 中以三颗 Aa 字形按钮实现字形字号分别为 11/14/17。Background transparency一个从 Less 到 More 的滑块默认在中间带Reset按钮。源码实现为一个区间-100...100、步长 50、中位 0 的滑块Reset 把值归零恢复 Light/Dark 下的默认玻璃外观。Compact modeOn/Off默认Off。开启后启动器以一条纤细的搜索栏打开随输入展开成完整列表↓展开并选中第一行。Show favorites in compact modeOn/Off默认On。开启后收藏应用图标固定在紧凑搜索栏右侧⌘1–⌘5 启动未开启 Compact mode 时该开关禁用。Follow the cursor across displaysOn/Off默认On。开启时启动器在指针所在显示器打开关闭则始终使用带菜单栏的显示器。Drag to repositionOn/Off默认Off。开启后可以拖动面板抓住搜索栏上方细条、头部空白区域或空搜索栏本身。拖动时有虚线参考线显示默认位置接近时亮起可吸附松手在参考线处则吸附回默认位置否则 Tinycast 记住该位置重启后仍生效。记住的位置在没有任何屏幕能显示面板时如拔掉外接显示器才会被丢弃且不包含在备份中——窗口位置不该在 Mac 之间迁移。Launch at loginOn/Off默认Off。登录时自动启动 Tinycast。对应源码settings.launchAtLogin。Show in menu barOn/Off默认On。控制菜单栏图标的显示。注意源码 AppSettings.swift 中该开关与MenuBarExtra(isInserted:)绑定同一个AppStorage(showInMenuBar)因此切换会即时反映到菜单栏。隐藏图标后所有快捷键照常工作。Pop to Root SearchImmediately默认· After 5/15/30/60/90 秒。决定窗口关闭后多久回到启动器根搜索。源码 AppSettings.swift 中对应PopToRootTimeout枚举immediately 0、afterFive 5…afterNinety 90未设置时读取为 immediately。经常关闭面板又马上回到同一屏幕的用户可以调高它。Escape Key BehaviorNavigate back or close window默认·Close window and pop to root。决定搜索框已为空时esc的行为默认是先回退一屏只在根屏幕关闭另一个是直接关闭下次从根启动器开始。两种方式下第一次按esc都会先清空已输入的文本参见 palette.md。Auto-switch input source默认None或选择任意已安装的键盘输入源。开启后 Tinycast 在启动器打开时切换到该输入源关闭时切回如果你在启动器打开期间手动切换过你的选择会被保留。源码在面板出现时枚举输入源InputSourceSwitcher.options并监听输入源变化通知实时刷新只有输入源列表非空时该行才显示。Permissions 面板显示Accessibility辅助功能与Calendars日历两个权限是否已授予并提供按钮打开对应的系统设置面板。详见 permissions.md。搜索索引中该面板还有privacy/tcc/access/grant等关键词。Launcher 分组这七个面板管理启动器里能搜到什么。面板顶部的Enable …总开关会关掉该面板的每一行以及每一个快捷键而某一行自己的复选框只负责把该行从搜索结果中隐藏——隐藏一行并不会关闭它的快捷键详见 hotkeys.md 的 Hidden, switched off, and turned off 一节。面板内容ApplicationsSearch Scopes搜索范围、Enable Applications总开关以及每个应用一行System SettingsEnable System Settings总开关以及每个系统设置面板一行System ActionsEnable System Actions总开关以及每个系统动作一行共 31 个CommandsEnable Commands总开关、每个内置命令一行以及 Custom Commands自定义命令QuicklinksQuicklinks 总开关、其命令、行为设置如无选中文本时、删除前确认、导入与导出Fallbacks哪些 fallbacks兜底搜索显示在结果之下以及它们的顺序Apple ShortcutsEnable Apple Shortcuts总开关与别名/快捷键一行通常包含启动器复选框、快捷键录制器ShortcutRecorder和一个 alias 字段别名。长列表顶部有过滤字段。Features 分组这一分组中除了Clipboard与Emoji Symbols其余功能出厂时全部关闭Everything here ships off, except Clipboard and Emoji Symbols。每个功能面板都有一个主开关关掉它即关闭该功能所有命令与快捷键。面板主开关其它设置AIEnable AIProviders提供商、Default model默认模型、Reasoning effort推理强度、Web search网页搜索、Opens to、Start a new conversation after、Keep conversations、System prompt系统提示词、MCP servers、AI commandsQuick ActionsEnable Quick ActionsActionsReplace or Preview、快捷键、提示词、模型、Add Quick Action、Model、Translate toFile SearchEnable File SearchCommands、Search Scopes、Ignore Patterns忽略模式如node_modulesNotesEnable NotesNotes commandsSnippetsEnable snippetsShow in launcher、snippet commands、New Snippet、Snippets FolderNavigationEnable navigationCommands、Show Apple menu items默认Off、Disabled ApplicationsWindow ManagementEnable window managementShow in launcher、Cycling默认None、Gap between windows默认0、window commands、Window LayoutsClipboardEnable Clipboard History默认OnClipboard commands、Keep history for默认3 Months、Search text in images and PDFs默认Off、Default action默认Paste、Disabled Applications、Clear historyEmoji Symbols始终开启Emoji commands、Emoji Skin Tone默认DefaultCalendarJoin meetings from TinycastShow in launcher、Upcoming meetings in launcher默认3 next、Include Tomorrows Events默认On、Show the join card默认5 minutes、Auto Join Meetings默认Off、Camera Preview默认Off、menu bar settings、Calendar commands、CalendarsExtensionsEnable extensionsShow in launcher、Compatibility、installed extensions、Install、Registries、Package manager、Storage几点源码佐证Clipboard 是唯一默认开启的功能。其面板在 SettingsSearchCatalog.swift 的索引中有Enable Clipboard History带disable/turn off/monitor/record/privacy关键词与Keep history for带retention/delete/privacy/expire。关闭后Off means off不再记录、历史文件关闭、Clipboard History 命令与其快捷键消失已保存内容保留Clear history 在关闭状态下仍可用。Search text in images and PDFs默认关闭因为开启等于同意后台文字识别OCR这也是备份永远不会替用户开启它的原因之一见下节。Default action默认Paste可改为 Copy to Clipboard它交换return与⌘return的角色双击与数字快捷键遵循同一选择⌥return始终是粘贴。Calendar面板的 Upcoming meetings in launcher 在源码 AppSettings.swift 中对应CalendarLauncherLimit1/3/5 next 或 AllShow the join card 对应JoinWindow1/2/5/10/15 分钟菜单栏事件提前量对应MenuBarEventsToday 或 2/5/10/30 分钟前另有独立的CalendarMenuBarDisplayDisabled / Meeting Icon / Meeting Title与HideCurrentEvent。Advanced 分组Backup 面板Backup导出备份、导入备份或 从 Raycast 导入。一个备份是一个.tinycast文件。导出时勾选要放进文件的类别导入时再勾选要恢复的类别——两次选择相互独立所以一个包含一切的备份文件也可以只恢复你的 snippets。详见 backup.md。备份包含五类内容Settings Shortcuts快捷键、自定义命令、quicklinks、窗口布局、收藏、别名、偏好、Clipboard History文本与图片片段及图片文件、被复制文件的引用、SnippetsMarkdown 文件、NotesMarkdown 文件、Launcher Learning启动器学到的偏好外加 emoji 与计算器历史。备份永远无法授予能力以下开关被刻意排除在任何备份之外因为打开它们是用户自己的决定而不是偏好——Snippets同意关键词匹配、Extensions同意运行第三方代码、Calendar同意读取日历、Auto Join Meetings 与 Camera Preview同意打开链接和开启摄像头、Quick Actions同意向其它应用打字、AI 与 MCP servers同意把文本发给模型并运行服务器代码、Search text in images and PDFs同意后台文字识别、Fallback 顺序与复选框。所以别人发给你的备份永远不可能替你打开按键监听、运行第三方代码、读取日历或连接 AI 提供商。导入 snippets 也不会顺带开启 snippets 功能。同样被刻意排除的还有扩展的代码/数据/登录态第三方内容登录态在钥匙串、AI 聊天/API 密钥/所有 AI 与 MCP 设置、Quick Actions 的模型/提示词/语言/自定义动作、扩展注册表/包管理器/自定义搜索路径、启动器位置/自动切换输入源/日历勾选、以及货币汇率、更新检查等缓存。备份携带的路径只有一种被复制文件的路径那是该条目的内容本身。About 面板About版本号、许可证、Check for Updates检查更新、项目链接和Support支持。更新机制详见 updates.mdTinycast 每天一次向 GitHub 查询当前渠道是否有新版本检查失败则两小时后重试首次检查在启动 30 秒后进行有新版本时弹出窗口展示变更内容一键下载并校验签名后安装可立即重启。Check for Updates出现在启动器、菜单栏菜单和Settings → About三处。升级从不触碰你的设置、剪贴板历史、笔记、snippets 或任何你创造的内容。快捷方式与快捷键总览设置窗口本身也遵循 Tinycast 的通用快捷键约定⌘,打开设置、esc回退/关闭、⌘W关闭窗口。每个可绑定快捷键的项目应用、命令、quicklink、自定义命令、系统动作、窗口命令等都在其设置面板的行内录制快捷键录制器不是普通文本框——点击后按想用的键即可上方气泡会提示按住中的修饰键并在快捷键已被占用时点名提示冲突者。快捷键的完整清单见 shortcuts.md。从源码看设置体系的架构设置体系的代码集中在 Tinycast/Features/Settings面板定义SettingsTab.swift 用SettingsTab21 个面板与SettingsSection4 个分组两个枚举描述整个结构声明顺序即显示顺序面板标题与 SF Symbol 图标如 AI 用sparkles、Clipboard 用doc.on.clipboard、Backup 用arrow.up.arrow.down.circle也在此定义。搜索索引SettingsSearchCatalog.swift 手写维护所有可搜索条目与关键词。设置存储AppSettings.swift 以Observable的AppSettings为核心底层用UserDefaults.standard持久化如showInMenuBar通过AppStorage与菜单栏图标实时联动PopToRootTimeout、JoinWindow、CalendarLauncherLimit等带默认值的枚举也在同文件中定义未设置的键按文档默认值读取。通用面板GeneralSettingsView.swift 与 PermissionsSettingsView.swift 实现了 General 分组其它功能面板由各 Feature 模块提供。跳转机制每个可搜索的行都带一个SettingsAnchor锚点如.generalHyperKey、.clipboardHistory搜索命中后通过锚点直接滚动到目标行这就是选中结果直接跳到那一行的实现基础。小结Tinycast 的设置窗口用 4 组 21 个面板覆盖了从外观、快捷键到各功能开关的全部配置。把握三条主线即可快速上手General 管全局行为外观、Hyper Key、esc 行为、输入源、Launcher 管能搜到什么每行一个复选框快捷键录制器别名面板级开关会连带关闭快捷键、Features 管各功能开关除 Clipboard 与 Emoji Symbols 外默认全关主开关即功能总闸。再加上按标题之外的词也能搜到的设置搜索以及备份永远不能替你开启能力的安全设计这套设置体系在易用性与安全性上都值得参考。【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycast创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Tinycast 设置面板完全指南：21 个设置项、默认值与源码级实现解析
Tinycast 设置面板完全指南21 个设置项、默认值与源码级实现解析【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycastTinycast 是一个完全原生的 macOS 启动器launcher、热键与剪贴板历史工具。本文以 website/content/docs/reference/settings.md 为骨架系统讲解它的设置窗口如何打开、如何用搜索直达任意设置项、四个分组共 21 个面板各自包含什么、每个配置的默认值并结合 Tinycast/Features/Settings 目录下的 Swift 源码说明这些开关背后如何落地。读完本文你能完整掌握 Tinycast 设置体系的全貌知道每个开关在哪、默认是什么、改了什么行为以及哪些设置在备份中会被刻意排除。打开设置窗口设置窗口是 Tinycast 中一个普通的、可调整大小的窗口打开方式有三种在任意界面按下⌘,在启动器、AI Chat、剪贴板等任意屏幕都有效参见 palette.md 中的快捷键表在启动器中输入并选择Settings命令点击菜单栏图标在菜单中选Settings…。打开后窗口左侧是分组与面板列表右侧是当前面板的配置表单。从源码 SettingsTab.swift 可以看到设置项被精确划分为四个分组SettingsSectionGeneralGeneral、Permissions、LauncherApplications、System Settings、System Actions、Commands、Quicklinks、Apple Shortcuts、Fallbacks、FeaturesAI、Quick Actions、File Search、Notes、Snippets、Navigation、Window Management、Clipboard、Emoji Symbols、Calendar、Extensions、AdvancedBackup、About合计21 个面板与文档完全一致。设置搜索按名称甚至按标题之外的词查找设置窗口顶部有一个搜索字段它不仅能按设置的标题匹配还能匹配标题之外的单词。例如输入ocr能找到Search text in images and PDFs标题里根本没有 OCR 字样输入caps lock能找到Hyper Key。选中一条结果会直接跳到那一行而不是只跳到所在面板。这一行为的实现位于 SettingsSearchCatalog.swift。它是一份手写的索引SettingsSearchEntry列表因为 SwiftUI 的Form无法反向询问自己包含哪些行所以每新增一行可搜索的设置都必须同步登记到这里。每个条目包含tab所属面板target跳转目标行或分组锚点title可见标题keywords用户可能输入但标题里没有的词。搜索采用模糊匹配FuzzyMatch查询被按空白拆成多个词每个词必须至少命中标题、关键词或面包屑breadcrumb之一标题命中得分高于关键词命中面板自身的得分又高于其内部行所以输入裸的 clipboard 会落在 Clipboard 面板而不是某一行上。结果按得分排序同分时按目录顺序稳定排列最多返回 50 条。整个索引按面板顺序 面板内分组顺序书写读起来就像一份设置目录。搜索索引里值得注意的关键词General 面板App Launcher带hotkey/shortcut/summon/paletteLearned ranking带reset/history/order/privacyHyper Key带modifier/remap/caps lockTheme带dark/light/mode/appearanceInterface size带text size/font size/scale/zoom。AI 面板Providers带sign in/connect/codex/claude/grok/opencode/cursor/api key/base url/openai/anthropic/ollamaWeb search带browse/internet。Clipboard 面板Search text in images and PDFs带OCR/recognize/scan/screenshot/background/idle。Backup 面板Raycast Export带migrate/rayconfig/passphrase。这说明设置搜索的定位是帮用户用自然语言找到设置而不仅是标题匹配。General 分组General 面板这是设置窗口的总控面板从源码 GeneralSettingsView.swift 可以看到它由五个分组Section构成全局快捷键、学习排序、Hyper Key、外观、通用项。App Launcher给启动器本身绑定一个全局快捷键默认NoneTinycast 出厂时不绑定任何快捷键参见 hotkeys.md。源码中对应ShortcutRecorder(action: .togglePalette)。Learned rankingTinycast 会私密地学习你对每个查询更常选哪个结果这一行提供Reset…按钮清空全部学习结果、恢复默认排序。源码中按钮在launcherRanking.isEmpty时禁用点击后弹出确认对话框Reset learned launcher ranking?确认后调用launcherRanking.resetAll()。学习数据的备份与恢复详见 backup.md 中 Launcher Learning 类别。Hyper Key把一颗物理键改造成⌃⌥⌘开启Include Shift后是⌃⌥⇧⌘。可选None · Caps Lock · Right Control · Right Shift · Right Option · Right Command默认None。选择后源码会立即把hyperKeyQuickPress重置为 none并调用Permissions.ensureAccessibility()Hyper Key 需要辅助功能权限且不会主动索取。凡包含全部 Hyper 修饰键的快捷键在界面上统一显示为 ✦如✦G。Quick Press单独按下 Hyper 键时的行为可选Does Nothing · 对应键的原始功能 · Trigger Escape默认Does Nothing切换 Hyper 键时该选择会被重置。只有当选中的键存在原始功能时该行才出现Caps Lock 没有原始功能。Include Shift (⇧)On/Off默认On。切换它会更新所有已保存的快捷键把⌃⌥⌘扩展为四键和弦如果更新后与其它快捷键冲突那条会被跳过并保留原键。Hyper Key 为 None 时该开关置灰。若未授予辅助功能权限分组内会出现一行橙色警告Tinycast needs Accessibility access to remap keys.附Grant Access…按钮直接打开系统设置。ThemeSystem · Light · Dark默认System。System 跟随 macOS 外观Light 是同一设计的反色版本布局、字体与动效完全一致。对应源码settings.appearance。Interface sizeDefault · Large · Larger默认Default。让启动器及其浮动窗口整体放大 10% 或 20%设置窗口本身保持原尺寸。源码 GeneralSettingsView.swift 中以三颗 Aa 字形按钮实现字形字号分别为 11/14/17。Background transparency一个从 Less 到 More 的滑块默认在中间带Reset按钮。源码实现为一个区间-100...100、步长 50、中位 0 的滑块Reset 把值归零恢复 Light/Dark 下的默认玻璃外观。Compact modeOn/Off默认Off。开启后启动器以一条纤细的搜索栏打开随输入展开成完整列表↓展开并选中第一行。Show favorites in compact modeOn/Off默认On。开启后收藏应用图标固定在紧凑搜索栏右侧⌘1–⌘5 启动未开启 Compact mode 时该开关禁用。Follow the cursor across displaysOn/Off默认On。开启时启动器在指针所在显示器打开关闭则始终使用带菜单栏的显示器。Drag to repositionOn/Off默认Off。开启后可以拖动面板抓住搜索栏上方细条、头部空白区域或空搜索栏本身。拖动时有虚线参考线显示默认位置接近时亮起可吸附松手在参考线处则吸附回默认位置否则 Tinycast 记住该位置重启后仍生效。记住的位置在没有任何屏幕能显示面板时如拔掉外接显示器才会被丢弃且不包含在备份中——窗口位置不该在 Mac 之间迁移。Launch at loginOn/Off默认Off。登录时自动启动 Tinycast。对应源码settings.launchAtLogin。Show in menu barOn/Off默认On。控制菜单栏图标的显示。注意源码 AppSettings.swift 中该开关与MenuBarExtra(isInserted:)绑定同一个AppStorage(showInMenuBar)因此切换会即时反映到菜单栏。隐藏图标后所有快捷键照常工作。Pop to Root SearchImmediately默认· After 5/15/30/60/90 秒。决定窗口关闭后多久回到启动器根搜索。源码 AppSettings.swift 中对应PopToRootTimeout枚举immediately 0、afterFive 5…afterNinety 90未设置时读取为 immediately。经常关闭面板又马上回到同一屏幕的用户可以调高它。Escape Key BehaviorNavigate back or close window默认·Close window and pop to root。决定搜索框已为空时esc的行为默认是先回退一屏只在根屏幕关闭另一个是直接关闭下次从根启动器开始。两种方式下第一次按esc都会先清空已输入的文本参见 palette.md。Auto-switch input source默认None或选择任意已安装的键盘输入源。开启后 Tinycast 在启动器打开时切换到该输入源关闭时切回如果你在启动器打开期间手动切换过你的选择会被保留。源码在面板出现时枚举输入源InputSourceSwitcher.options并监听输入源变化通知实时刷新只有输入源列表非空时该行才显示。Permissions 面板显示Accessibility辅助功能与Calendars日历两个权限是否已授予并提供按钮打开对应的系统设置面板。详见 permissions.md。搜索索引中该面板还有privacy/tcc/access/grant等关键词。Launcher 分组这七个面板管理启动器里能搜到什么。面板顶部的Enable …总开关会关掉该面板的每一行以及每一个快捷键而某一行自己的复选框只负责把该行从搜索结果中隐藏——隐藏一行并不会关闭它的快捷键详见 hotkeys.md 的 Hidden, switched off, and turned off 一节。面板内容ApplicationsSearch Scopes搜索范围、Enable Applications总开关以及每个应用一行System SettingsEnable System Settings总开关以及每个系统设置面板一行System ActionsEnable System Actions总开关以及每个系统动作一行共 31 个CommandsEnable Commands总开关、每个内置命令一行以及 Custom Commands自定义命令QuicklinksQuicklinks 总开关、其命令、行为设置如无选中文本时、删除前确认、导入与导出Fallbacks哪些 fallbacks兜底搜索显示在结果之下以及它们的顺序Apple ShortcutsEnable Apple Shortcuts总开关与别名/快捷键一行通常包含启动器复选框、快捷键录制器ShortcutRecorder和一个 alias 字段别名。长列表顶部有过滤字段。Features 分组这一分组中除了Clipboard与Emoji Symbols其余功能出厂时全部关闭Everything here ships off, except Clipboard and Emoji Symbols。每个功能面板都有一个主开关关掉它即关闭该功能所有命令与快捷键。面板主开关其它设置AIEnable AIProviders提供商、Default model默认模型、Reasoning effort推理强度、Web search网页搜索、Opens to、Start a new conversation after、Keep conversations、System prompt系统提示词、MCP servers、AI commandsQuick ActionsEnable Quick ActionsActionsReplace or Preview、快捷键、提示词、模型、Add Quick Action、Model、Translate toFile SearchEnable File SearchCommands、Search Scopes、Ignore Patterns忽略模式如node_modulesNotesEnable NotesNotes commandsSnippetsEnable snippetsShow in launcher、snippet commands、New Snippet、Snippets FolderNavigationEnable navigationCommands、Show Apple menu items默认Off、Disabled ApplicationsWindow ManagementEnable window managementShow in launcher、Cycling默认None、Gap between windows默认0、window commands、Window LayoutsClipboardEnable Clipboard History默认OnClipboard commands、Keep history for默认3 Months、Search text in images and PDFs默认Off、Default action默认Paste、Disabled Applications、Clear historyEmoji Symbols始终开启Emoji commands、Emoji Skin Tone默认DefaultCalendarJoin meetings from TinycastShow in launcher、Upcoming meetings in launcher默认3 next、Include Tomorrows Events默认On、Show the join card默认5 minutes、Auto Join Meetings默认Off、Camera Preview默认Off、menu bar settings、Calendar commands、CalendarsExtensionsEnable extensionsShow in launcher、Compatibility、installed extensions、Install、Registries、Package manager、Storage几点源码佐证Clipboard 是唯一默认开启的功能。其面板在 SettingsSearchCatalog.swift 的索引中有Enable Clipboard History带disable/turn off/monitor/record/privacy关键词与Keep history for带retention/delete/privacy/expire。关闭后Off means off不再记录、历史文件关闭、Clipboard History 命令与其快捷键消失已保存内容保留Clear history 在关闭状态下仍可用。Search text in images and PDFs默认关闭因为开启等于同意后台文字识别OCR这也是备份永远不会替用户开启它的原因之一见下节。Default action默认Paste可改为 Copy to Clipboard它交换return与⌘return的角色双击与数字快捷键遵循同一选择⌥return始终是粘贴。Calendar面板的 Upcoming meetings in launcher 在源码 AppSettings.swift 中对应CalendarLauncherLimit1/3/5 next 或 AllShow the join card 对应JoinWindow1/2/5/10/15 分钟菜单栏事件提前量对应MenuBarEventsToday 或 2/5/10/30 分钟前另有独立的CalendarMenuBarDisplayDisabled / Meeting Icon / Meeting Title与HideCurrentEvent。Advanced 分组Backup 面板Backup导出备份、导入备份或 从 Raycast 导入。一个备份是一个.tinycast文件。导出时勾选要放进文件的类别导入时再勾选要恢复的类别——两次选择相互独立所以一个包含一切的备份文件也可以只恢复你的 snippets。详见 backup.md。备份包含五类内容Settings Shortcuts快捷键、自定义命令、quicklinks、窗口布局、收藏、别名、偏好、Clipboard History文本与图片片段及图片文件、被复制文件的引用、SnippetsMarkdown 文件、NotesMarkdown 文件、Launcher Learning启动器学到的偏好外加 emoji 与计算器历史。备份永远无法授予能力以下开关被刻意排除在任何备份之外因为打开它们是用户自己的决定而不是偏好——Snippets同意关键词匹配、Extensions同意运行第三方代码、Calendar同意读取日历、Auto Join Meetings 与 Camera Preview同意打开链接和开启摄像头、Quick Actions同意向其它应用打字、AI 与 MCP servers同意把文本发给模型并运行服务器代码、Search text in images and PDFs同意后台文字识别、Fallback 顺序与复选框。所以别人发给你的备份永远不可能替你打开按键监听、运行第三方代码、读取日历或连接 AI 提供商。导入 snippets 也不会顺带开启 snippets 功能。同样被刻意排除的还有扩展的代码/数据/登录态第三方内容登录态在钥匙串、AI 聊天/API 密钥/所有 AI 与 MCP 设置、Quick Actions 的模型/提示词/语言/自定义动作、扩展注册表/包管理器/自定义搜索路径、启动器位置/自动切换输入源/日历勾选、以及货币汇率、更新检查等缓存。备份携带的路径只有一种被复制文件的路径那是该条目的内容本身。About 面板About版本号、许可证、Check for Updates检查更新、项目链接和Support支持。更新机制详见 updates.mdTinycast 每天一次向 GitHub 查询当前渠道是否有新版本检查失败则两小时后重试首次检查在启动 30 秒后进行有新版本时弹出窗口展示变更内容一键下载并校验签名后安装可立即重启。Check for Updates出现在启动器、菜单栏菜单和Settings → About三处。升级从不触碰你的设置、剪贴板历史、笔记、snippets 或任何你创造的内容。快捷方式与快捷键总览设置窗口本身也遵循 Tinycast 的通用快捷键约定⌘,打开设置、esc回退/关闭、⌘W关闭窗口。每个可绑定快捷键的项目应用、命令、quicklink、自定义命令、系统动作、窗口命令等都在其设置面板的行内录制快捷键录制器不是普通文本框——点击后按想用的键即可上方气泡会提示按住中的修饰键并在快捷键已被占用时点名提示冲突者。快捷键的完整清单见 shortcuts.md。从源码看设置体系的架构设置体系的代码集中在 Tinycast/Features/Settings面板定义SettingsTab.swift 用SettingsTab21 个面板与SettingsSection4 个分组两个枚举描述整个结构声明顺序即显示顺序面板标题与 SF Symbol 图标如 AI 用sparkles、Clipboard 用doc.on.clipboard、Backup 用arrow.up.arrow.down.circle也在此定义。搜索索引SettingsSearchCatalog.swift 手写维护所有可搜索条目与关键词。设置存储AppSettings.swift 以Observable的AppSettings为核心底层用UserDefaults.standard持久化如showInMenuBar通过AppStorage与菜单栏图标实时联动PopToRootTimeout、JoinWindow、CalendarLauncherLimit等带默认值的枚举也在同文件中定义未设置的键按文档默认值读取。通用面板GeneralSettingsView.swift 与 PermissionsSettingsView.swift 实现了 General 分组其它功能面板由各 Feature 模块提供。跳转机制每个可搜索的行都带一个SettingsAnchor锚点如.generalHyperKey、.clipboardHistory搜索命中后通过锚点直接滚动到目标行这就是选中结果直接跳到那一行的实现基础。小结Tinycast 的设置窗口用 4 组 21 个面板覆盖了从外观、快捷键到各功能开关的全部配置。把握三条主线即可快速上手General 管全局行为外观、Hyper Key、esc 行为、输入源、Launcher 管能搜到什么每行一个复选框快捷键录制器别名面板级开关会连带关闭快捷键、Features 管各功能开关除 Clipboard 与 Emoji Symbols 外默认全关主开关即功能总闸。再加上按标题之外的词也能搜到的设置搜索以及备份永远不能替你开启能力的安全设计这套设置体系在易用性与安全性上都值得参考。【免费下载链接】tinycastTinycast — a tiny, fully native macOS launcher, hotkeys, and clipboard history.项目地址: https://gitcode.com/GitHub_Trending/ti/tinycast创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考