核心功能
vscode-node 是一款基于 OpenClaw Node 协议的远程 IDE 操控技能，允许用户通过命令行或自动化流程直接操作本地或远程的 VS Code/Cursor 编辑器。其核心能力覆盖完整的开发工作流：
1. 文件与代码操作（File/Language/Editor）
支持文件的增删改查、代码格式化、符号跳转（definition/references）、悬停提示、重命名重构等 15+ 条语言级命令。所有路径强制相对 workspace 根目录，自动拦截 ../ 等目录遍历攻击。
2. 版本控制（Git）
集成完整的 Git 工作流：status/diff/log/blame 查询，以及 stage/commit/stash 等写操作，适合自动化提交、CI 流水线集成。
3. 测试与调试（Test/Debug）
可列出、运行测试用例并获取结果，支持启动调试会话、断点管理、变量查看与表达式求值，打通远程调试场景。
4. Cursor Agent 代理（Agent）
独家功能：将复杂编码任务委托给 Cursor 内置 AI Agent，支持 plan（规划模式）与 run（执行模式），最长超时 5 分钟，实现真正的"AI 编程助手"远程调度。
---
显著优点
- 协议级安全：Ed25519 设备身份认证 + Gateway 白名单双重管控，命令级细粒度权限
- 零配置入侵：仅需安装官方扩展，无需修改 SSH 或暴露端口
- Cursor 原生深度集成：Agent 能力是其他远程开发方案无法替代的核心差异点
- 生产级可靠：超时策略分层设计（Gateway/HTTP 双层），防止长时间任务断连
潜在局限
| 限制点 | 说明 |
|--------|------|
| 终端默认禁用 | `vscode.terminal.*` 需显式白名单开启，防止命令注入 |
| 单工作区隔离 | 无法跨 workspace 操作，适合微服务而非单体大仓 |
| Cursor Agent 独占 | 部分高级功能（如 agent.run）仅限 Cursor IDE |
| 网络依赖 | 需保持 Gateway ↔ Node 长连接，离线场景不可用 |
适合人群
- 远程开发团队：本地低配置设备连接云端高性能开发机
- 自动化工程师：CI/CD 流水线中自动修复代码、生成提交
- AI 工作流构建者：将 Cursor Agent 编排进更大的自动化链路
- 多项目管理：通过标准化命令统一管理分散的多个代码库
常规风险提示
- 写操作确认机制：建议开启
confirmWrites扩展设置，防止 AI 误删代码 - Agent 任务不可撤销：
agent.run模式直接修改文件，建议先使用plan模式审阅方案 - 超时配置陷阱：Agent 类命令需显式设置
invokeTimeoutMs与timeoutMs，否则默认 15s 必失败 - 扩展版本锁定：Node 协议与 Gateway 版本需匹配，升级前查阅兼容性矩阵