從安裝到排查，一頁寫完。在上方選擇你的平台。
雙擊 clipraft.exe 執行，無需安裝。系統匣出現圖示即表示已啟動。要開機自動執行，在系統匣選單勾選「開機自啟」。
首次執行新程式時，Windows 可能提示「Windows 已保護您的電腦」，「仍要執行」收在「其他資訊」裡。點「其他資訊」，再點「仍要執行」。僅需一次。
位於右下角時鐘旁。圖示可能被收合起來，點向上的箭頭展開。左鍵點一下圖示即「立即同步一次」。
系統匣選單包含：立即同步一次、尋找裝置、新增裝置、裝置清單、傳送檔案、開機自啟、退出。
配對只需一次。加入同一群組的裝置須連在同一個 Wi-Fi 下，或接在同一台路由器上。
配對碼 5 分鐘內有效。「新增裝置」視窗開啟期間，可用同一組配對碼連續新增多台裝置。
更換裝置前，先在「裝置清單」中移除不用的裝置。移除後會自動輪替主金鑰，被移除的裝置無法再接收內容。需要更多裝置請使用商業版，聯絡我們。
配對完成後無需任何操作。在一台裝置上複製，到另一台直接貼上。
在任意位置按 Ctrl+C，內容自動推送到群組內其他裝置。收到的內容直接進入剪貼簿，Ctrl+V 貼上。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制僅在讀取剪貼簿的一端生效。在 Windows 上複製 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上複製則無法傳送。
檔案為點對點傳輸，只傳送給指定的那台裝置，不像剪貼簿那樣廣播給整個群組。
可同時選取多個檔案，會排隊依序傳輸。
單一檔案最大 4 GB。
直接存入接收方的下載資料夾，不詢問也不跳出視窗。檔名重複時自動改名，report.pdf 變為 report (2).pdf，不覆寫原檔案。傳輸完成後會跳出通知，點一下就能開啟所在資料夾。
| 收到的文件在 | 下載資料夾（%USERPROFILE%\Downloads） |
同時傳輸多個大檔案會互相搶佔頻寬，因此選取多個檔案時會排隊依序傳輸。傳輸過程中選單會出現「取消傳輸」，取消後對方會立即刪除未完成的檔案。
| 配置 | %APPDATA%\clipraft\ |
| 日志 | %APPDATA%\clipraft\clipraft.log |
開啟 dmg，將 ClipRaft 拖入「應用程式」。圖示位於螢幕右上角的選單列，不在 Dock 裡。
首次開啟會提示「無法驗證開發者」。在「應用程式」中按住 Control 點 ClipRaft，選「打開」，在對話框中再點一次「打開」。僅需一次。
也可以在「系統設定 › 隱私權與安全性」中點「仍要打開」。
位於螢幕右上角時間旁。左鍵點一下圖示即「立即同步一次」。
選單包含：立即同步一次、尋找裝置、新增裝置、裝置清單、傳送檔案、開機自啟、退出。
配對只需一次。加入同一群組的裝置須連在同一個 Wi-Fi 下，或接在同一台路由器上。
配對碼 5 分鐘內有效。「新增裝置」視窗開啟期間，可用同一組配對碼連續新增多台裝置。
更換裝置前，先在「裝置清單」中移除不用的裝置。移除後會自動輪替主金鑰，被移除的裝置無法再接收內容。需要更多裝置請使用商業版，聯絡我們。
配對完成後無需任何操作。在一台裝置上複製，到另一台直接貼上。
在任意位置按 ⌘C，內容自動推送到群組內其他裝置。收到的內容直接進入剪貼簿，⌘V 貼上。
| 文字 | 150 KB |
| 图片 | 8 MB |
限制僅在讀取剪貼簿的一端生效。在 Windows 上複製 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上複製則無法傳送。
檔案為點對點傳輸，只傳送給指定的那台裝置，不像剪貼簿那樣廣播給整個群組。
可同時選取多個檔案，會排隊依序傳輸。
單一檔案最大 4 GB。
macOS 不允許 App 自行啟用這一項，因此剛安裝時「分享」中沒有 ClipRaft。開啟「系統設定 › 一般 › 登入項目與延伸功能 › 分享」，勾選 ClipRaft，僅需一次。也可在右鍵選單底部點「編輯延伸功能⋯」直接跳過去。
直接存入接收方的下載資料夾，不詢問也不跳出視窗。檔名重複時自動改名，report.pdf 變為 report (2).pdf，不覆寫原檔案。傳輸完成後會跳出通知，點一下就能開啟所在資料夾。
| 收到的文件在 | 下載資料夾（~/Downloads） |
同時傳輸多個大檔案會互相搶佔頻寬，因此選取多個檔案時會排隊依序傳輸。傳輸過程中選單會出現「取消傳輸」，取消後對方會立即刪除未完成的檔案。
macOS 的開機自啟透過 SMAppService 實作，要求 App 位於「應用程式」資料夾。安裝在其他位置會提示失敗。需 macOS 13 或更新版本。
| 配置 | ~/Library/Application Support/clipraft/ |
| 日志 | ~/Library/Application Support/clipraft/clipraft.log |
下載後先加執行權限：在檔案管理員中按右鍵 › 內容 › 勾選「允許檔案作為程式執行」，或在終端機執行 chmod +x。之後雙擊執行（個別檔案管理員要按右鍵選「作為程式執行」），無需安裝。系統匣出現圖示即表示已啟動。
GNOME 在螢幕右上角的頂列，KDE、Xfce 等在工作列右側。點一下圖示開啟選單，KDE 上用右鍵。
選單包含：立即同步一次、傳送檔案、新增裝置、裝置清單、開機自啟、幫助、退出。還沒加入同步群組時只有「設定」。
配對只需一次。加入同一群組的裝置須連在同一個 Wi-Fi 下，或接在同一台路由器上。
配對碼 5 分鐘內有效。「新增裝置」視窗開啟期間，可用同一組配對碼連續新增多台裝置。
更換裝置前，先在「裝置清單」中移除不用的裝置。移除後會自動輪替主金鑰，被移除的裝置無法再接收內容。需要更多裝置請使用商業版，聯絡我們。
配對完成後無需任何操作。在一台裝置上複製，到另一台直接貼上。
在任意位置按 Ctrl+C，內容自動推送到群組內其他裝置。收到的內容直接進入剪貼簿，Ctrl+V 貼上。
| 文字 | 8 MB |
| 图片 | 16 MB |
限制僅在讀取剪貼簿的一端生效。在 Windows 上複製 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上複製則無法傳送。
檔案為點對點傳輸，只傳送給指定的那台裝置，不像剪貼簿那樣廣播給整個群組。
單一檔案最大 4 GB，一次傳送一個。
直接存入接收方的下載資料夾，不詢問也不跳出視窗。檔名重複時自動改名，report.pdf 變為 report (2).pdf，不覆寫原檔案。傳輸完成後會跳出通知，點一下就能開啟所在資料夾。
| 收到的文件在 | 下載資料夾（系統設定的下載目錄，通常是 ~/Downloads 或 ~/下載） |
同時傳輸多個大檔案會互相搶佔頻寬，因此選取多個檔案時會排隊依序傳輸。傳輸過程中選單會出現「取消傳輸」，取消後對方會立即刪除未完成的檔案。
Ubuntu 內建「Ubuntu AppIndicators」擴充功能，一般已啟用。Fedora 等發行版需先安裝「AppIndicator and KStatusNotifierItem Support」擴充功能，在「擴充功能」應用程式中啟用，再登出並重新登入。KDE、Xfce、Cinnamon 原生支援系統匣，無需操作。鎖定螢幕期間 GNOME 會暫時停用這個擴充功能，解鎖後圖示會自動回來。
執行時加參數可直接開啟對應視窗：--setup 建立或加入群組，--devices 裝置清單，--add-device 新增裝置，--manual-add 按 IP 手動新增。例如 ./clipraft-*.AppImage --setup。
勾選後會在 ~/.config/autostart/ 寫入一個啟動項目，指向 AppImage 目前所在的位置；搬移檔案後在新位置執行一次即可更新。Sway、Hyprland 等視窗管理器不讀取這個目錄，需自行設定。
Wayland 工作階段下透過 XWayland 讀寫剪貼簿，GNOME、KDE 預設開啟，無需設定。圖片只讀取 PNG 格式，個別程式複製的圖片不帶 PNG，這類圖片不會同步；超過約 16 MB 的圖片目前讀不完整，會跳過。
Linux 版的裝置清單還沒有「尋找裝置」按鈕。找不到裝置時，管理員可在「新增裝置」視窗中點「手動新增裝置」填寫對方 IP；其他裝置執行時加 --manual-add。
Ubuntu、Fedora Workstation 等桌面版預設的防火牆不影響使用。Fedora Server 這類預設只開放 ssh 的系統，需開放 TCP 8677 和 UDP 8678。
| 配置 | ~/.config/clipraft/ |
| 日志 | ~/.config/clipraft/clipraft.log |
從瀏覽器安裝 APK 需在系統中允許一次「安裝不明應用程式」，安裝時系統會自動提示。
開啟 ClipRaft，點「加到快速設定」。Android 13 以上會直接跳出確認框；Android 12 以下需下拉面板，點編輯（鉛筆圖示），將 ClipRaft 拖入上方一排。
沒有加圖塊時，每次同步都要先開啟 App。
配對只需一次。加入同一群組的裝置須連在同一個 Wi-Fi 下，或接在同一台路由器上。
配對碼 5 分鐘內有效。「新增裝置」視窗開啟期間，可用同一組配對碼連續新增多台裝置。
更換裝置前，先在「裝置清單」中移除不用的裝置。移除後會自動輪替主金鑰，被移除的裝置無法再接收內容。需要更多裝置請使用商業版，聯絡我們。
電腦上複製，手機從頂端下拉開啟快速設定，點 ClipRaft，內容即進入手機剪貼簿，在輸入框中長按貼上。
支援「分享」的 App：選取文字或圖片，點「分享」，選 ClipRaft，電腦上直接貼上。只能「複製」的 App：複製後下拉點 ClipRaft 即可傳送。
這是設計選擇。Android 10 起系統也不允許 App 在背景讀取剪貼簿。電腦傳送的內容暫存於電腦端，下拉點一下即可取回。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制僅在讀取剪貼簿的一端生效。在 Windows 上複製 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上複製則無法傳送。
檔案為點對點傳輸，只傳送給指定的那台裝置，不像剪貼簿那樣廣播給整個群組。
單一檔案最大 50 MB，傳輸過程中請勿鎖定螢幕。
直接存入接收方的下載資料夾，不詢問也不跳出視窗。檔名重複時自動改名，report.pdf 變為 report (2).pdf，不覆寫原檔案。傳輸完成後會跳出通知，點一下就能開啟所在資料夾。
| 收到的文件在 | 「下載」資料夾，開啟「檔案」或者「下載」就能看到 |
同時傳輸多個大檔案會互相搶佔頻寬，因此選取多個檔案時會排隊依序傳輸。傳輸過程中選單會出現「取消傳輸」，取消後對方會立即刪除未完成的檔案。
從瀏覽器安裝 APK 時系統會提示不允許這個來源。點提示中的「設定」，開啟目前瀏覽器的「允許安裝不明應用程式」，返回後重新安裝。安裝完成後可關閉。
| 配置 | App 私有目錄（不需要你管） |
| 日志 | App 裡 |
App Store 審核中。以下為上架後的使用方式。
從 App Store 安裝。
從螢幕右上角往下滑開啟控制中心，進入編輯狀態，點底部「新增控制項」，搜尋 ClipRaft 並點一下加入。之後可按住拖動調整位置。
配對只需一次。加入同一群組的裝置須連在同一個 Wi-Fi 下，或接在同一台路由器上。
配對碼 5 分鐘內有效。「新增裝置」視窗開啟期間，可用同一組配對碼連續新增多台裝置。
更換裝置前，先在「裝置清單」中移除不用的裝置。移除後會自動輪替主金鑰，被移除的裝置無法再接收內容。需要更多裝置請使用商業版，聯絡我們。
電腦上複製，手機從右上角往下滑開啟控制中心，點 ClipRaft，內容即進入手機剪貼簿，在輸入框中長按貼上。
支援「分享」的 App：選取文字或圖片，點「分享」，選 ClipRaft，電腦上直接貼上。只能「複製」的 App：複製後從右上角往下滑點 ClipRaft 即可傳送。
系統不允許在背景讀取剪貼簿，也不允許 App 持續執行。所以電腦傳送的內容會暫存在電腦端，下拉點一下即可取回。這是系統限制。
iOS 16 起系統不再向 App 提供使用者設定的裝置名稱，因此需在 ClipRaft 中自行填寫。多台裝置都叫 iPhone 時，電腦上的裝置清單無法區分。
| 文字 | 8 MB |
| 图片 | 32 MB |
限制僅在讀取剪貼簿的一端生效。在 Windows 上複製 1 MB 文字，Mac 可以收到；同一段文字在 Mac 上複製則無法傳送。
檔案為點對點傳輸，只傳送給指定的那台裝置，不像剪貼簿那樣廣播給整個群組。
單一檔案最大 50 MB，傳輸過程中請勿鎖定螢幕。
直接存入接收方的下載資料夾，不詢問也不跳出視窗。檔名重複時自動改名，report.pdf 變為 report (2).pdf，不覆寫原檔案。傳輸完成後會跳出通知，點一下就能開啟所在資料夾。
| 收到的文件在 | 「檔案」app →「我的 iPhone」→ ClipRaft |
同時傳輸多個大檔案會互相搶佔頻寬，因此選取多個檔案時會排隊依序傳輸。傳輸過程中選單會出現「取消傳輸」，取消後對方會立即刪除未完成的檔案。
| 配置 | App 私有目錄（不需要你管） |
| 日志 | App 裡 |
按順序排查，多數情況第一步即可解決。
部分路由器預設開啟 AP 隔離（用戶端隔離），同一 Wi-Fi 下的裝置互相看不見，需進入路由器管理頁面關閉。飯店、機場等公共 Wi-Fi 通常開啟此項，無法使用。
企業無線網路常會過濾群播，大網段下自動發現會失效，手動填寫 IP 仍可使用。
最近一次請求成功。複製的內容會直接推送過去。
手機進入背景後會被系統暫停，此時無法接收推送。兩個方向仍然可用：手機可主動傳送；電腦傳送的內容暫存於傳送方，手機下拉點一下即可取回。這不是故障，手機系統本來就不允許 App 常駐。
尚未發現這台裝置的位址。點「尋找裝置」，或手動填寫。
內容僅在區域網路內直連傳輸，端對端加密，不經過任何伺服器。我們不收集電子郵件地址、手機號碼和姓名，也沒有帳號體系。記錄檔僅記錄事件和位元組數，不記錄剪貼簿內容。