片段扩展
片段即用缩写展开为完整内容的单元，支持纯文本、富文本（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、浏览器里高频展开，又不想在别处误触的场景。
怎么设置
- 打开片段编辑或分组设置。
- 找到 ExpandIn（或「仅在这些应用中展开」）。
- 选择或搜索要生效的应用（如 VS Code、Chrome、Cursor、飞书等），可多选。
- 保存后，该片段或分组只会在所选应用内响应「缩写 + 触发键」。
不选任何应用时，表示在所有应用内生效。
工作原理
- 应用识别：自动识别当前前台应用，无需手动配置技术参数。
- 分组级限制：在分组上设置 ExpandIn 后，该分组下所有片段都只在指定应用内生效。
- 片段级限制：在单个片段上设置可覆盖分组设置，实现更细粒度控制。
- 与全局搜索的关系：ExpandIn 只影响「缩写 + 触发键」的展开方式；全局搜索（快捷键唤起的搜索窗口）不受限制，始终可用。
典型使用场景
| 场景 | 设置建议 |
|---|---|
| IDE 专用代码片段 | 分组设为仅 VS Code / Cursor / JetBrains 生效；缩写如 log、try 不会在聊天软件误触 |
| 浏览器内 AI 提示词 | 片段设为仅 Chrome / Safari / Edge 生效；在 AI 对话网站输入缩写展开提示词 |
| 办公软件模板 | 分组设为仅飞书 / Lark / Notion 生效；周报、会议纪要模板只在文档工具里触发 |
| 多环境同名缩写 | 同一缩写在不同应用展开不同内容：如 deploy 在 Terminal 展开 Shell 命令，在文档里展开部署文档模板 |
注意事项
- 未识别的应用：如果应用无法被识别（如某些 Electron 应用），ExpandIn 可能不生效；此时可关闭该片段的 ExpandIn 限制。
- 性能影响：ExpandIn 在每次触发前检测前台应用，开销极小，可忽略。
- 与 Word Boundary 配合：建议同时开启「词边界检查」，避免在应用内单词中间误触发。
适合谁：在 IDE、浏览器里高频用片段，又不想在微信、Slack 里误触的人。
片段编辑器
编辑器类型
根据片段运行环境自动切换：
- 代码编辑器：语法高亮、行号、撤销/重做。适合代码与脚本。
- 富文本编辑器：标题、列表、表格、图片、链接。适合邮件与文档。
编辑器工具栏
| 快捷键 | 功能 |
|---|---|
Cmd/Ctrl+Shift+L | 切换只读/编辑模式 |
Cmd/Ctrl+Shift+P | 运行/预览片段 |
Cmd/Ctrl+Shift+Backspace | 删除当前文件 |
只读提示：片段处于锁定（只读）状态时，将鼠标悬停在编辑区域，锁定图标会闪烁提示——点击图标或按 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}}，展开时自动替换。
片段类型与执行 ᴾᴿᴼ
内置类型
| 类型 | 说明 |
|---|---|
plain | 纯文本（默认） |
rich | 富文本（HTML） |
shell | Shell 脚本 |
applescript | AppleScript（macOS） |
js | JavaScript |
powershell | PowerShell（Windows） |
python | Python |
自定义运行环境
在设置中配置自定义运行环境，支持任意可执行文件。可将片段内容、剪贴板和选中文本传入执行上下文，并支持自定义包装模板进行前置/后置处理。
执行方式
- 预览执行：编辑器中点击运行按钮或
Cmd/Ctrl+Shift+P，在底部面板显示结果 - 运行并复制：片段列表右键 → 「运行并复制」，执行后结果复制到剪贴板
版本历史
每个文件自动保存版本历史：
- 自动保存：编辑过程中自动保存历史版本，无需手动操作
- 版本来源：初始创建、自动保存、手动保存、应用操作
- 版本对比：并排可视化对比，支持行级差异和格式化后差异
- 恢复版本：一键回滚到任意历史版本
典型恢复场景：
- 误删内容 → 从历史版本秒级找回
- 对比改动 → 清楚看到每次编辑改了什么
- 实验性修改 → 安全尝试新写法，不满意随时回滚
分组与前缀
主窗口最左栏是分组树。片段挂在分组下；缩写在 文件 上，前缀在 分组 上。
- 左栏空白处右键 新建分组，或在某个分组下建子组。
- 打开分组设置：名称、前缀（如
ai-）。前缀ai-、文件缩写gen→ 输入ai-gen再按触发键。 - 免费档最多约 5 个分组；Pro 不限。子组可以再写自己的前缀。改完请保存。
分组还可设 ExpandIn / 何时展开 / 本机触发键（不同步），以及是否参与同步。侧栏下方 组织 里的带锁组不能在桌面改，见 组织与共享组。更细的 ExpandIn 说明见 快速展开。
创建与编辑
客服要把「退货说明」收成缩写 ret：选一个自己的分组，新建，写下正文，保存。下一次在邮件里打 ret 再按 Tab 就出来。
- 主窗口点一个 个人 分组（带锁的组织组不能在这里改）。
Cmd/Ctrl+N，或点新建。免费大约到 50 条会提示升级。- 写名称，在文件上填 缩写 和正文。选纯文本、富文本，或脚本（Pro）。
- 保存。改缩写或分组前缀后，新打法立刻生效。
也可以：用热键从剪贴板创建、把文件拖进来、接受 建议片段、打开 分享包。同一条可以挂中英文签名或不同语言的代码，各自缩写。
建议片段
签名每天手打三遍之后，主窗口可能弹出：要不要做成缩写？ 预览没问题再确认。不点，库里什么都不会多。确认后写进当前分组；免费大约 50 条上限仍然算数。统计只在这台电脑上。不想用就关掉提示。
分享包
把若干分组/片段打成包发给同事。对方打开链接或在应用内确认后，写入 自己的本机库，不是共享组实时同步。
- 收到
codeexpander://import?d=...（过长会被拒绝）。 - 已安装的应用唤起主窗，解码后弹出确认。确认后才写入。免费档超限会失败。
- 组织共享片段的分享包会按共享识别；复制到我的库 才变成可编辑的个人副本。
导出入口在片段/分组菜单与数据转移里。不要把分享包当成 CE Cloud 组织权限。见 深链。
分享与同步
- 个人 CE Cloud / 组织共享组 / Gist 与 WebDAV。
- 导入/导出：设置 → 数据；JSON，以及 TextExpander 导出迁入。