使用指南
剪貼簿歷史
ClipboxAI 從你的選單列運作。每當你複製某樣東西時，它就會被加入你的歷史紀錄中。
- 點擊選單列圖示以開啟歷史面板。
- 將游標停留在某個項目上並按下動作快捷鍵，或點擊將它複製回剪貼板。
- 使用搜尋欄位，依文字尋找某個項目。
AI 工具視窗
AI 工具視窗是動作執行的地方。它採用左右分割的版面：
- 左側 — 工具清單，分為以下群組：
- 內建 AI — 摘要、翻譯與其他 AI 動作。
- 內建本地 — 離線工具（擷取連結、統計計數、摺疊空白行）。
- 已安裝 — 你從 Marketplace 加入的動作。你可以拖曳來重新排序它們。
- 右側 — 兩個窗格：一側是原始剪貼內容，另一側是結果。
AI 工具會顯示「雲端」標記；本地工具則顯示「裝置」標記，因此你隨時都能知道某個動作是否使用了網路。
執行動作
- 從左側清單選取一個工具（或接受智慧建議）。
- 目前的剪貼內容會出現在原始窗格中。
- 結果會在結果窗格中產生。
自動執行
在視窗底部開啟 Auto-run on output（輸出時自動執行）。啟用後，當你複製內容的瞬間，所選工具就會自動執行——不需要手動點擊。本地工具永遠不會覆寫你的剪貼板，因此自動執行是安全的。
內建本地工具
這些工具完全在你的 Mac 上離線執行：
- 擷取連結（Extract Links） — 回傳文字中找到的所有 URL。
- 統計計數（Count Stats） — 字數／字元數／行數／句數統計。
- 摺疊空白行（Collapse Blank Lines） — 移除貼上文字中的空白行。
雲端 AI 設定
若要使用 AI 動作，請在 Settings → AI（設定 → AI） 中連接一個供應商：
- 選擇一個供應商 — DeepSeek、MiniMax、Zhipu GLM、Kimi (Moonshot)、Mistral、Ollama（本地），或其他 OpenAI 相容的服務。
- 貼上你的 API key。它會儲存在 Keychain 中，絕不會以純文字寫入磁碟。
- 挑選一個模型。
- 雲端 AI 預設為關閉。啟用後，你的剪貼內容只會傳送給你所設定的供應商。
若未設定 key，設定橫幅會在 AI 工具視窗內提醒你。
Marketplace
- 從 AI 工具視窗開啟 Marketplace（或網站的 Marketplace 頁面）。
- 點擊某個動作上的 Install（安裝）。這會透過深層連結
clipboxai://install?action=<id>開啟應用程式，並將該動作加入你的已安裝清單。
鍵盤快捷鍵
| 快捷鍵 | 動作 |
|---|---|
Cmd+Shift+V | 開啟剪貼簿歷史 |
Cmd+, | 開啟設定 |
Cmd+W | 關閉視窗 |
Cmd+Q | 退出應用程式 |
確切的快捷鍵可能因建置版本而異；請在應用程式的 Settings → Shortcuts（設定 → 快捷鍵） 中查看。
設定
開啟 ClipboxAI → Settings（設定）（或 Cmd+,）：
- General（一般）：語言、登入時啟動、外觀主題。
- AI：雲端供應商、模型與 API key（Keychain）。
- Actions（動作）：自動執行開關、排除的應用程式，以及工具順序。
- Privacy（隱私）：雲端 AI 加入選項、排除的應用程式，以及歷史紀錄控制。
- Marketplace：瀏覽並管理已安裝的動作。