AI Workspace
在本機裝置上使用 Codex、Claude Code 或 VS Code 在遠端裝置上執行命令並編輯專案檔。 FlashDesk 為您處理連線設定。
內容
概述
AI Workspace 是一個 FlashDesk 工作區,用於針對遠端裝置使用本機 AI 工具。 AI工具在操作員設備上運行,而遠端設備的命令在需要時透過SSH執行。
重要:必須在遠端設備上啟用 AI Workspace。 FlashDesk在AI Workspace啟動時會自動執行SSH金鑰交換,因此使用者無需手動建立或註冊SSH金鑰。
基本用法
1
在遠端設備上啟用 AI Workspace
在遠端設備上,在 FlashDesk 設定中啟用 AI Workspace 和 SSH 連線權限。
2
從操作員設備開啟 AI Workspace
選擇目標設備並開啟 AI Workspace。 FlashDesk 建立本機工作區資料夾,產生 SSH 幫助程式文件,並自動與遠端裝置交換臨時 SSH 金鑰。
3
選擇如何工作
選擇 SSH 指令工作來執行直接的一次性任務,或當您想要建立 Local Mirror 並在本機編輯檔案時選擇專案編輯。
4
開啟AI工具
從 AI Workspace 視窗開啟 Codex 或 Claude Code。 FlashDesk 將所選工具的指令檔寫入工作區。
5
運行命令或編輯文件
對於 SSH 命令工作,請要求 AI 工具透過產生的幫助程式執行遠端命令。對於專案編輯,編輯 Local Mirror 文件,然後返回 FlashDesk 以查看並套用差異。
你能做什麼
- 開啟 Codex、Claude Code、VS Code 或 FlashDesk 中的工作區資料夾。
- 透過SSH在遠端設備上執行命令。
- 建立所選遠端項目的 Local Mirror 並在本機進行編輯。
- 在將 Local Mirror 變更套用回遠端裝置之前,請檢查這些變更。
- 每個遠端設備保留 Custom instructions,自動合併到 AI 工具指令檔。
它是如何運作的
| 物品 | 描述 |
|---|---|
AI Workspace |
為 FlashDesk 連線建立的本機工作目錄。 |
.flashdesk-workspace/ssh_config |
SSH 設定和 FlashDesk 為所選遠端裝置產生的幫助程式腳本。 AI 工具應該使用幫助器命令,而不是直接編輯這些文件。 |
.flashdesk-workspace/identity |
FlashDesk為目前AI Workspace產生的臨時SSH身分。 FlashDesk 會自動將其註冊到遠端裝置上,並在 AI Workspace 關閉時將其刪除。 |
AGENTS.md / CLAUDE.md |
開啟對應AI工具時產生的指令檔。 FlashDesk 也會根據偵測到的 Host OS(Windows 與 POSIX)自訂其內容,並在 Custom instructions 更新時重新產生它們。 |
| Local Mirror | 所選遠端項目的本機副本。用戶可以在將更改應用回遠端設備之前查看更改。 |
工作區模式
SSH指令工作
使用此模式在遠端設備上進行直接、一次性的工作,例如檢查日誌、列出檔案、重新啟動服務或進行小的確認變更。
使用 Local Mirror 進行專案編輯
當您想要在本機編輯遠端項目時,請使用此模式。 FlashDesk 將選定的遠端檔案或資料夾複製到 Local Mirror 中。編輯後,查看 FlashDesk 中的差異,並僅將所選變更套用回遠端裝置。
Custom instructions
Custom instructions 讓您可以留下 AI 工具在此工作區中應遵循的常規註釋 - 編碼約定、要使用的套件管理器、避免接觸的分支、批准規則以及您通常在每個會話開始時重複的任何內容。
- 從 旁的 Custom instructions 按鈕打開,在 AI Workspace 視窗中開啟資料夾 。
- 每個遠端設備保存,因此每個項目都可以有自己的常規註釋。
- 合併到
Custom instructions(始終遵循)部分下的AGENTS.md/CLAUDE.md部分,因此CLAUDE.md部分,因此 Codex 和 ZXTERMXZ 部分,因此 Claude Code 和 ZXTERMXZ。每當您儲存時,現有的說明文件都會被重寫。
操作注意事項
- AI Workspace 預設為關閉狀態,並且必須在遠端裝置上允許。
- 遠端設備也必須允許 SSH 連線。
- 使用 SSH 在遠端設備上建立、覆蓋、移動或刪除檔案之前,請詢問遠端設備使用者。
- 使用 Local Mirror 時,僅在使用者確認 FlashDesk 中的差異後才將變更套用於遠端裝置。
- 大型檔案會使 Local Mirror 建立速度變慢。 FlashDesk 可能會詢問是否包含或跳過大型檔案。