片段擴充
片段即用縮寫展開爲完整內容的單元，支持純文字、富文字（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 導出遷入。