VSCode节点工具(免费版)

VSCode 节点工具(免费版)

概述

vscode-node-tool-free 为个人开发者提供通过节点协议远程操作 VSCode 或 Cursor IDE 的能力。它覆盖文件读写、语言特性查询、编辑器状态与 Git 基础操作,帮助你通过 Agent 自动化日常 IDE 任务. 本工具通过 nodes invoke 命令调用已连接的 IDE 节点,需要预先安装对应 IDE 扩展并完成连接.

核心能力

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：面向个人开发者的、VSCode、Cursor、远程操作工具、覆盖文件读写、基础操作、节点工具免费版为、个人开发者提供通、过节点协议远程操、IDE、的能力、涵盖文件读写、语言特性查询、编辑器状态与、文件读写与目录列、诊断信息获取等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景 1:读取项目文件

nodes invoke --node "my-vscode" \
  --invokeCommand "vscode.file.read" \
  --invokeParamsJson '{"path":"src/main.ts"}'

返回:{ content, totalLines, language }

场景 2:查找所有引用

nodes invoke --node "my-vscode" \
ts","line":10,"character":5}'

返回:{ locations: [{ path, line, character }] }

场景 3:Git 状态查询

nodes invoke --node "my-vscode" \

返回:{ branch, staged, modified, untracked, ahead, behind }

不适用场景

以下场景VSCode节点工具(免费版)不适合处理：

• 无明确技术栈的模糊需求
• 纯架构设计决策
• 运维部署管理

触发条件

需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求.

快速开始

依赖详情

在 VSCode 或 Cursor 的扩展市场搜索并安装"节点协议"扩展,启动后状态栏显示连接状态.

第二步:验证节点连接

nodes status

确认节点已连接且可见.

第三步:执行命令

使用 nodes invoke 模式调用具体命令:

nodes invoke --node "<节点名>" \
  --invokeCommand "<命令>" \
  --invokeParamsJson '<参数JSON>'

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

超时配置参考

命令分类速查

最佳实践

1. 使用相对路径:所有路径相对于工作区根目录,绝对路径与 ../ 会被阻止,保证安全.
2. 设置合理超时:文件操作 15s,Git 操作 30s,避免长时间阻塞.
3. 先验证再操作:对未知文件先 read 确认存在,再决定是否 edit 或 delete.
4. 利用语言特性:用 references 与 definition 替代手动 grep,结果更精确.
5. Git 操作前先 status:提交前先查看 git.status,避免误提交.
6. 只读优先:对生产代码优先使用只读命令(read、references、log),写操作需明确意图.

常见问题

Q1: 节点连接不上怎么办?

检查:1) 扩展是否已安装并启用;2) 状态栏是否显示已连接;3) 节点是否出现在 nodes status 列表中;4) 网络与防火墙是否阻止节点通信.

Q2: 命令报"not allowed"是什么原因?

该命令未加入网关白名单。需要在网关配置的 allowCommands 中添加该命令,或联系管理员授权.

Q3: 超时怎么处理?

增加 invokeTimeoutMs 与 timeoutMs 两个参数(后者必须大于前者)。文件操作建议 15s/20s,Git 建议 30s/35s.

Q4: 路径被阻止怎么办?

工具仅允许工作区相对路径,绝对路径与 ../ 会被阻止。请改用相对路径,如 src/main.ts.

Q5: 免费版与 Pro 版的区别?

免费版提供文件、语言、编辑器、Git 基础操作;Pro 版扩展调试、测试、终端、Agent 委托与团队协作能力.

Q6: 多个节点如何区分?

每个节点在网关注册时有唯一名称,通过 nodes status 查看所有已连接节点。调用时用 --node "<节点名>" 指定目标节点.

Q7: 离线环境能用吗?

节点协议需要 IDE 与网关之间持续通信,完全离线时无法使用。但 IDE 本地功能(编辑、保存)不受影响,仅远程命令调用不可用.

Q8: 如何排查命令执行失败?

按以下顺序排查:1) 检查 nodes status 确认节点在线;2) 确认命令在白名单内;3) 检查参数 JSON 是否合法;4) 查看网关日志获取详细错误;5) 增加超时参数重试.

依赖说明

运行环境

• Agent 平台:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统:Windows / macOS / Linux
• IDE:VSCode 或 Cursor(需安装节点协议扩展)

第三方依赖

API Key 配置

• 本 Skill 基于节点协议,无需额外 API Key
• 节点连接通过设备唯一身份(Ed25519)认证,由网关批准
• 如网关启用 OAuth,需配置对应平台的访问令牌

可用性分类

• 分类: MD+EXEC(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于自然语言指令驱动 Agent 调用 nodes invoke 命令;需要预先安装 IDE 扩展并连接网关

错误处理

已知限制

• 需LLM支持,无LLM环境不可用
• 复杂业务场景建议结合人工经验判断
• 执行效率受模型能力与网络环境影响
• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

{
  "success": true,
  "data": {
    "result": "VSCode节点工具(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "vscode node"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}