片段扩展

片段即用缩写展开为完整内容的单元，支持纯文本、富文本（HTML）或可执行脚本（Pro）。输入几个字母 + 触发键即可得到整段内容。模板变量如 {{date}}、{{clipboard}}（Pro）在展开时自动替换。详见 FillIn 与变量。

如何触发展开

• 缩写与触发 — 输入缩写 + 触发键（默认 Tab，可改为空格/回车等）即展开；支持在任意可输入文字的地方使用。
• 触发键：Tab、空格、Enter、Alt、.、,、;、-、/、=、` 等可配置；「必须按触发键才展开」可开关，建议开启以减少误触。
• 匹配模式：
  • 从左到右：缩写必须与输入完全匹配（如 sig → sig+Tab）
  • 从右到左：缩写只需作为输入的后缀匹配（如 mysig → sig+Tab 展开）
  • 词边界检查：在「从右到左」模式下，可要求缩写前必须是词边界字符（空格、标点等），避免在单词中间误触发
  • 大小写自适应：输入 SIG 可展开为大写版本，Sig 展开为首字母大写版本
• 内联搜索：输入 //（可配置前缀）直接唤起片段搜索浮窗，方向键选择后回车插入
• 快捷键（Pro）：全局打开主窗口/搜索、从剪贴板创建片段、新建片段、编辑上次展开的片段、再次展开上次内容；每个片段还可绑独立全局快捷键。见 设置 → 快捷键。

分组与多文件

• 树形分组 + 分组前缀：例如 ai- 下所有子片段用 ai-xxx 即可展开，按场景管理大量片段。见 产品介绍 · 片段。
• 多文件片段：一个片段下可挂多个「文件」（多语言/多环境），各自独立缩写与内容，一次管理、多处展开。
  • 支持添加、复制、删除、拖拽排序文件
  • 每个文件独立拥有：文件名、运行环境、缩写、内容、展开范围、全局热键
  • 多文件片段在列表中显示文件数量徽章

指定应用内生效 ᴾᴿᴼ

ExpandIn（Pro）指仅在所选应用内触发展开：在其它应用（如聊天、网页输入框）输入相同缩写不会触发。适合在 VS Code、Cursor、浏览器里高频展开，又不想在别处误触的场景。

怎么设置

1. 打开片段编辑或分组设置。
2. 找到 ExpandIn（或「仅在这些应用中展开」）。
3. 选择或搜索要生效的应用（如 VS Code、Chrome、Cursor、飞书等），可多选。
4. 保存后，该片段或分组只会在所选应用内响应「缩写 + 触发键」。

不选任何应用时，表示在所有应用内生效。

工作原理

• 应用识别：自动识别当前前台应用，无需手动配置技术参数。
• 分组级限制：在分组上设置 ExpandIn 后，该分组下所有片段都只在指定应用内生效。
• 片段级限制：在单个片段上设置可覆盖分组设置，实现更细粒度控制。
• 与全局搜索的关系：ExpandIn 只影响「缩写 + 触发键」的展开方式；全局搜索（快捷键唤起的搜索窗口）不受限制，始终可用。

典型使用场景

注意事项

• 未识别的应用：如果应用无法被识别（如某些 Electron 应用），ExpandIn 可能不生效；此时可关闭该片段的 ExpandIn 限制。
• 性能影响：ExpandIn 在每次触发前检测前台应用，开销极小，可忽略。
• 与 Word Boundary 配合：建议同时开启「词边界检查」，避免在应用内单词中间误触发。

适合谁：在 IDE、浏览器里高频用片段，又不想在微信、Slack 里误触的人。

片段编辑器

编辑器类型

根据片段运行环境自动切换：

• 代码编辑器：支持主流编程语言语法高亮、行号、撤销/重做、主题切换。适合代码包装、脚本片段。
• 富文本编辑器：支持粗体/斜体、标题、列表、表格、图片、链接、对齐等排版。适合邮件模板、文档撰写。

编辑器工具栏

只读提示：片段处于锁定（只读）状态时，将鼠标悬停在编辑区域，锁定图标会闪烁提示——点击图标或按 Cmd/Ctrl+Shift+L 即可解锁编辑。

典型场景

• 开发者：用语法高亮写代码包装（try/catch、日志），直接运行脚本并复制输出。
• 技术写作者：富文本模式撰写图文文档，同一应用内截图标注。
• 跨国团队：代码片段在任何 IDE 通用，模板通过 FillIn 适配本地语言。

代码转图片

• Carbon 分享：将代码渲染为精美图片（Carbon.now.sh）
• 本地渲染：代码转图片（本地渲染）

FillIn 与模板变量

• FillIn 变量 — 触发时弹窗：单行/多行、下拉、复选框、%date%、光标位 %c%（支持多光标 Tabstop）、剪贴板 %cv%、嵌套片段 %s:缩写%，适合提示词与带参数的模板。
  • 支持变量大小写格式化：camel/pascal/snake/kebab/upper/lower
• 片段模板变量（Pro） — 在片段内容里写 {{date}}、{{time}}、{{clipboard}}、{{cursor}}、{{input}}，展开时自动替换。

片段类型与执行 ᴾᴿᴼ

内置类型

自定义运行环境

在设置中配置自定义运行环境，支持任意可执行文件。可将片段内容、剪贴板和选中文本传入执行上下文，并支持自定义包装模板进行前置/后置处理。

执行方式

• 预览执行：编辑器中点击运行按钮或 Cmd/Ctrl+Shift+P，在底部面板显示结果
• 运行并复制：片段列表右键 → 「运行并复制」，执行后结果复制到剪贴板

版本历史

每个文件自动保存版本历史：

• 自动保存：编辑过程中自动保存历史版本，无需手动操作
• 版本来源：初始创建、自动保存、手动保存、应用操作
• 版本对比：并排可视化对比，支持行级差异和格式化后差异
• 恢复版本：一键回滚到任意历史版本

典型恢复场景：

• 误删内容 → 从历史版本秒级找回
• 对比改动 → 清楚看到每次编辑改了什么
• 实验性修改 → 安全尝试新写法，不满意随时回滚

分享与同步

• 分享链接：片段可生成分享链接（rawurl），右键菜单可复制或打开
• 云同步：支持 Push/Pull 单个片段到 GitHub/Gitee Gist
• 导入/导出：支持 JSON、CSV 格式导入导出