AI Code OS Devbox 连接器
这个扩展让你能够从多种代码编辑器无缝连接到 AI Code OS 开发环境。
特性
- 🚀 一键连接: 直接从编辑器连接到开发环境
- 🔒 安全SSH集成: 自动SSH配置和密钥管理
- 🛠️ 智能环境检测: 自动检测和配置开发环境
- 📦 远程开发就绪: 完全支持远程开发功能
- 🎯 多IDE支持: 支持 VSCode、Cursor、Windsurf、Trae 等多种编辑器
支持的编辑器
| 编辑器 |
协议 |
状态 |
| Visual Studio Code |
vscode:// |
✅ 完全支持 |
| VSCode Insiders |
vscode-insiders:// |
✅ 完全支持 |
| Cursor |
cursor:// |
✅ 完全支持 |
| Windsurf |
windsurf:// |
✅ 完全支持 |
| Trae |
trae:// |
✅ 完全支持 |
| Trae CN |
trae-cn:// |
✅ 完全支持 |
工作原理
- 在 AI Code OS 项目页面点击"打开 IDE"
- 选择你喜欢的代码编辑器
- 扩展自动配置SSH连接
- 在你的编辑器中打开远程开发环境
安装
在各编辑器中安装
Visual Studio Code / VSCode Insiders
- 打开 VSCode
- 进入扩展 (Ctrl+Shift+X)
- 搜索 "AI Code OS Devbox"
- 点击安装
Cursor
- 打开 Cursor
- 进入扩展面板
- 搜索 "AI Code OS Devbox"
- 点击安装
手动安装
- 从发布页面下载
.vsix 文件
- 打开你的编辑器
- 按 Ctrl+Shift+P
- 输入 "Extensions: Install from VSIX"
- 选择下载的文件
系统要求
- VSCode 1.91.0+ / Cursor / Windsurf / Trae
- Remote - SSH 扩展 (如需要会自动安装)
- 访问 AI Code OS 实例
使用方法
从 AI Code OS Web 界面
- 登录 AI Code OS 平台
- 进入你的项目详情页
- 在测试环境区域点击"打开 IDE"按钮
- 在弹出的选择器中选择你的编辑器
- 扩展会自动处理连接过程
手动连接 (高级用法)
- 使用命令面板 (Ctrl+Shift+P)
- 运行 "Connect to AI Code OS Devbox"
- 提供连接详细信息
配置说明
无需手动配置！扩展会在连接时自动处理所有SSH配置：
- 自动创建
~/.ssh/aicodeos/devbox_config 配置文件
- 自动保存SSH私钥到
~/.ssh/aicodeos/ 目录
- 自动更新主SSH配置文件
- 自动检测和安装Required扩展
故障排除
常见问题
点击按钮后IDE没有打开
- 确保已安装并启用扩展
- 检查是否安装了 Remote - SSH 扩展
- 尝试刷新浏览器页面
- 检查是否安装了选择的编辑器
SSH连接失败
- 检查网络连接
- 确认开发环境正在运行
- 联系 AI Code OS 管理员
扩展无响应
- 重启编辑器
- 禁用并重新启用扩展
- 查看输出面板的错误信息
协议链接不工作
- 确保浏览器允许打开自定义协议
- 检查操作系统是否正确关联了协议
- 尝试从命令行启动编辑器
调试信息
扩展会在以下位置记录调试信息：
- VSCode: 输出面板 > AI Code OS
- SSH配置:
~/.ssh/aicodeos/devbox_config
- SSH密钥:
~/.ssh/aicodeos/[项目标识]
支持
遇到问题或有疑问：
- 查看 故障排除指南
- 在 GitHub Issues 报告bug
- 通过 AI Code OS 实例联系支持
开发
参与扩展开发：
# 克隆仓库
git clone https://github.com/aicodeos/ai-code-os.git
cd ai-code-os/vscode-extension/aicodeos-devbox
# 安装依赖
npm install
# 编译扩展
npm run compile
# 打包发布
npm run package
更新日志
v1.0.0
- ✨ 初始发布
- ✅ 支持多种IDE (VSCode, Cursor, Windsurf, Trae)
- ✅ 自动SSH配置管理
- ✅ 安全密钥处理
- ✅ 用户友好的IDE选择器
许可证
MIT License - 详见 LICENSE 文件
| |
