快捷短语
管理常用开票税号、收件地址、客服话术与常用模板，支持动态日期/时间/剪贴板宏变量，一键穿透上屏或复制
插件界面截图
核心功能特性
穿透上屏
隐藏 ZTools 窗口，将求值后的短语文本直接注入上一个活动输入框（如微信、钉钉、浏览器表单、IDE）。
复制到剪贴板
仅将动态解析后的结果写入系统剪贴板，并弹出轻量 Toast 提示。
新建短语
进入声明式 Form 二级表单页。
编辑短语
进入该短语的 Form 编辑页，支持修改标题、分组、缩写词与内容。
删除短语
弹出危险确认后移出本地库。
剪贴板为空或为非文本
当模板中引用了 {clipboard} 但当前剪贴板为空或仅有图片时，优雅回退为空字符串或提示「剪贴板无文本」，严禁抛出 null 崩溃。
插件详细介绍与使用指南
功能概述
快捷短语（插件标识：snippets）是 ZTools 极客桌面效率中枢面向 办公效率 场景打造的官方核心扩展。管理常用开票税号、收件地址、客服话术与常用模板，支持动态日期/时间/剪贴板宏变量，一键穿透上屏或复制。
- 底层核心痛点：日常办公中存在海量重复文字录入：
- 财务开票（公司全称、纳税人识别号、地址电话、开户行账号）；
- 电商与客服常用售后解释、物流查询通知；
- 程序员常用的代码片段、标准注释头与 SQL 模板；
- 商务常用邮件打招呼与落款。每次要用时都得去微信收藏夹、记事本或备忘录里翻找、复制、再粘贴，流程极为割裂。
- 既有示例缺陷：原
examples/snippets仅为只读静态死数据展示，缺乏动态变量宏引擎（无法插入当前年月日、当前时间、剪贴板动态拼接），且缺乏标准的二级Form创建与分类管理能力。 - 最简收敛路径：
- 一级使用标准布局一
List极速搜索，支持拼音模糊检索与缩写触发词（Keyword Trigger）； - 支持强大的动态宏变量：
{date}、{time}、{clipboard}、{cursor}（插入后自动将光标定位于该点）； - 回车直接穿透当前活动窗口上屏，按
Ctrl+Enter仅复制到剪贴板备用； - 二级使用声明式
Form组件实现高内聚的新建与编辑表单。
- 架构标准：
@ztools/declarative-ui声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：办公效率
---
核心功能特性
- 穿透上屏：隐藏 ZTools 窗口，将求值后的短语文本直接注入上一个活动输入框（如微信、钉钉、浏览器表单、IDE）。
- 复制到剪贴板：仅将动态解析后的结果写入系统剪贴板，并弹出轻量 Toast 提示。
- 新建短语：进入声明式
Form二级表单页。 - 编辑短语：进入该短语的
Form编辑页，支持修改标题、分组、缩写词与内容。 - 删除短语：弹出危险确认后移出本地库。
- 剪贴板为空或为非文本：当模板中引用了
{clipboard}但当前剪贴板为空或仅有图片时，优雅回退为空字符串或提示「剪贴板无文本」，严禁抛出null崩溃。
---
典型高频使用场景
- 场景 1：检索并管理所有快捷短语与常用模板 — 当你需要快速执行该任务时，按下
Alt+Space输入快捷短语/常用语/话术/代码片段/snippets，回车即可直接进入snippets-all视图完成处理并一键复制或导出结果。 - 场景 2：快速检索并填入公司开票抬头、纳税人识别号与开户行 — 当你需要快速执行该任务时，按下
Alt+Space输入开票信息/公司税号/开票抬头/税号/发票信息，回车即可直接进入snippets-invoice视图完成处理并一键复制或导出结果。 - 场景 3：快速检索收件人、收货地址与联系电话 — 当你需要快速执行该任务时，按下
Alt+Space输入常用地址/收件地址/寄件地址/收货信息，回车即可直接进入snippets-address视图完成处理并一键复制或导出结果。
---
唤醒指令与全键盘快捷操作指南
在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 快捷短语 的对应功能模块：
功能命令标识 (featureCode) |
功能说明 | 推荐触发词 / 唤醒指令 (cmds) |
|---|---|---|
snippets-all |
检索并管理所有快捷短语与常用模板 | 快捷短语 / 常用语 / 话术 / 代码片段 / snippets |
snippets-invoice |
快速检索并填入公司开票抬头、纳税人识别号与开户行 | 开票信息 / 公司税号 / 开票抬头 / 税号 / 发票信息 |
snippets-address |
快速检索收件人、收货地址与联系电话 | 常用地址 / 收件地址 / 寄件地址 / 收货信息 |
snippets-new |
快速新建一条快捷短语或常用模板 | 新建短语 / 添加常用语 / 新建模板 / add snippet |
全局高频键盘快捷键
| 快捷键 (Windows / macOS) | 交互行为说明 |
|---|---|
Alt + Space / Option + Space |
呼出 ZTools 主搜索框，输入 快捷短语 直达本插件 |
↑ / ↓ |
在列表项、分类树或操作结果之间平滑移动键盘焦点 |
Enter |
对当前选中项执行默认主动作（打开、复制、执行或查看详情） |
Ctrl + Enter / ⌘ + Enter |
执行次要高频动作（如在资源管理器/Finder 中定位、复制次要字段） |
Ctrl + K / ⌘ + K |
展开当前选中项的完整动作面板（Action Panel），支持模糊筛选全部操作 |
Ctrl + F / ⌘ + F |
快速将光标聚焦至顶部搜索/过滤输入框 |
Esc |
关闭当前弹窗/动作面板，或从二级子视图安全返回上一级 |
---
架构性能与安全隐私保障
- 声明式 UI 零闪烁渲染：界面严格采用
@ztools/declarative-ui的List/Detail/Form/ActionPanel语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。 - 最小权限与沙箱隔离：本插件在清单（
plugin.json）中显式声明最小化权限集["clipboard", "database", "system"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。 - Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。
---
延伸阅读与技术内链
关联技术与效率专栏文章
- 还在两个窗口来回切着复制粘贴？学会“顺序流水粘贴”，每天准点下班！
- 告别重复打字！输入3个字母自动展开长句和邮箱，打工人必备的快捷短语秘籍
- 双手不离键盘的极客交互哲学：双模态状态机与四级快捷键分发器设计
- 不用羡慕Mac分屏！这个免费小工具，按一下快捷键让Windows窗口瞬间整整齐齐
同分类热门效率插件推荐（办公效率）
常见问题解答 (FAQ)
Q1: 如何最快唤醒并使用「快捷短语」插件？
安装并启动 ZTools 客户端后，在任意界面按下 Alt + Space（macOS 为 Option + Space），在搜索框中输入 快捷短语 或 snippets，按 Enter 即可在 0.1 秒内直达工作台。您也可以在 ZTools 设置中心为「快捷短语」绑定独立的全局一键呼出快捷键。
Q2: 「快捷短语」插件会将我的数据上传到云端服务器吗？
不会。ZTools 严格遵循 Local-First（本地优先）与隐私设计（Privacy by Design） 准则，「快捷短语」的核心处理流程完全在您的本机离线执行，零广告干扰、零用户行为监控。
Q3: 在「快捷短语」中如何不使用鼠标完成全部操作？
本插件针对全键盘流进行了深度优化：进入插件后可直接打字检索过滤，使用 ↑ / ↓ 键切换目标行，按 Enter 执行主操作，或按 Ctrl + K（macOS 为 ⌘ + K）呼出动作面板选择更多高级操作，按 Esc 即可逐级返回。
Q4: 插件支持哪些操作系统版本？是否开源免费？
完整支持 Windows 10 / Windows 11 (x64) 与 macOS 12+ 双平台（部分涉及 Windows 底层注册表或专属硬件驱动的特性在 macOS 下会自动适配原生等价实现）。本插件对个人用户 100% 永久免费开放，源码托管于 GitHub 官方仓库接受社区透明审计。 ---