Vorssaint文本片段教程：输入一个词展开完整地址，支持日期变量

Vorssaint文本片段教程：输入一个词展开完整地址，支持日期变量

【免费下载链接】vorssaint-utilsFree and open-source macOS menu bar toolkit.项目地址: https://gitcode.com/GitHub_Trending/vo/vorssaint-utils

Vorssaint 是一款免费开源的 macOS 菜单栏工具集，其中的**文本片段（Text Snippets）**功能让你输入一个短触发词（如;email），就能自动展开为完整邮箱、地址、签名等长文本，并支持{{date}}、{{clipboard}}等变量，在展开瞬间自动填入当前日期、时间和剪贴板内容。全部数据只保存在本机，无需账号。

快速上手：3 步启用文本片段

第 1 步：开启功能。打开设置中的"文本片段"页面，打开"输入时展开片段"开关。

第 2 步：授权辅助功能。片段功能通过全局键盘监听实现触发词识别，需要在系统设置 → 隐私与安全性 → 辅助功能中为 Vorssaint 授权（设置界面会提供权限引导）。

第 3 步：添加第一个片段。点击"添加片段"，填写触发词与展开文本，保存即可。

如何创建第一个文本片段：地址、签名、邮箱

以"输入一个词展开完整地址"为例，在编辑框中填写：

触发词建议加一个前缀符号（如;、/），避免与日常输入冲突。重复的触发词会被提示，无法保存。

展开时机有两种可选：

• 立即：打完触发词最后一个字符立刻展开，适合;addr这类不会继续输入的片段；
• 空格、Tab 或回车后：更安全，打完整词后按空格才展开，适合怕误触发的场景。

还可以勾选"忽略大小写"，让;ADDR也能触发。

文本片段内置 4 个变量：日期、时间与剪贴板

这是本功能最强大的地方——展开文本中可以写入变量，每次展开时都会填入那一刻的最新值：

• {{date}}→ 当前日期（如 2026 年 8 月 29 日）
• {{time}}→ 当前时间（如 14:30）
• {{datetime}}→ 日期 + 时间
• {{clipboard}}→ 剪贴板中刚复制的文本

实用示例：

触发词;log，文本：{{datetime}} 已完成 {{clipboard}}

复制"部署上线"，输入;log后按空格 →2026 年 8 月 29 日 14:30 已完成 部署上线

拼写错误的{{标签}}会原样保留、不会静默消失，方便发现笔误。变量替换的实现见 TextSnippetSupport.swift。

日期变量高级用法：自定义格式与时区

在日期类变量后加:格式即可自定样式，编辑界面还提供可视化的插入日期/时间按钮，带实时预览：

• {{date:yyyy-MM-dd}}→ 2026-08-29
• 命名样式：简短、中等、较长、完整、ISO 8601
• 指定时区：{{date-tz(America/New_York):yyyy-MM-dd}}，单独为某个变量使用其他时区

月份、星期等名称会跟随 Mac 的地区语言显示。

片段快捷菜单：快捷键直达光标位置

当片段多了起来，逐个背触发词不现实。开启"从菜单打开片段"后，按快捷键会弹出一个可搜索的浮动菜单，输入几个字过滤，回车即把片段直接输入到当前光标处——目标应用全程保持焦点，不会被抢走。

配合"文件夹"字段（如"工作""生活"）和"在快捷菜单中显示"开关，可以把常用片段分组管理。多行文本片段会逐行完整输入。

提示：菜单栏中的 Command Bar 也能搜索并插入片段，输入片段触发词或打开快捷菜单两种方式可互相配合。

常见问题

• 输入触发词没反应？检查辅助功能权限是否已授予，且片段开关与单个片段的启用开关都处于打开状态。
• 触发词被提前展开？把展开时机改为"空格、Tab 或回车后"即可。
• 我的数据安全吗？片段全部以本地 JSON 存储在这台 Mac 上，功能关闭时不监听任何按键，无账号、无云同步、无遥测。

小结

Vorssaint 文本片段用"触发词 + 展开文本 + 变量"三件套，把重复输入变成一次按键：地址、邮箱、邮件签名用静态文本，日志、日期戳用{{date}}系列变量，跨应用搬运内容用{{clipboard}}。相关实现可参考 TextSnippetService.swift（触发词匹配与输入）、SnippetLibraryService.swift（快捷菜单）以及设置界面 TextSnippetsSettings.swift。

【免费下载链接】vorssaint-utilsFree and open-source macOS menu bar toolkit.项目地址: https://gitcode.com/GitHub_Trending/vo/vorssaint-utils