AI Workspace
在本地设备上使用 Codex、Claude Code 或 VS Code 在远程设备上运行命令并编辑项目文件。 FlashDesk 为您处理连接设置。
内容
概述
AI Workspace 是一个 FlashDesk 工作区,用于针对远程设备使用本地 AI 工具。 AI工具在操作员设备上运行,而远程设备的命令在需要时通过SSH执行。
基本用法
在远程设备上启用 AI Workspace
在远程设备上,在 FlashDesk 设置中启用 AI Workspace 和 SSH 连接权限。
从操作员设备打开 AI Workspace
选择目标设备并打开 AI Workspace。 FlashDesk 创建本地工作区文件夹,生成 SSH 帮助程序文件,并自动与远程设备交换临时 SSH 密钥。
选择如何工作
选择 SSH 命令工作来执行直接的一次性任务,或者当您想要创建 Local Mirror 并在本地编辑文件时选择项目编辑。
打开AI工具
从 AI Workspace 窗口打开 Codex 或 Claude Code。 FlashDesk 将所选工具的指令文件写入工作区。
运行命令或编辑文件
对于 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部分,因此 Codex 和 Claude Code 自动选取它们。每当您保存时,现有的说明文件都会被重写。
操作注意事项
- AI Workspace 默认处于关闭状态,并且必须在远程设备上允许。
- 远程设备还必须允许 SSH 连接。
- 使用 SSH 在远程设备上创建、覆盖、移动或删除文件之前,请询问远程设备用户。
- 使用 Local Mirror 时,仅在用户确认 FlashDesk 中的差异后才将更改应用于远程设备。
- 大文件会使 Local Mirror 创建速度变慢。 FlashDesk 可能会询问是否包含或跳过大文件。