Node NPM Script Runner

一个 VSCode 插件，在 Activity Bar 侧边栏展示工作区所有 package.json 的 scripts 列表，支持一键运行/停止，并通过 环境预设（Profile） 统一管理 Node 版本、Whistle 代理规则、自定义环境变量和访问地址，运行脚本时自动切换。

功能特性

• 📋 Scripts 列表展示 — 自动解析工作区所有 package.json 的 scripts，在侧边栏 TreeView 中展示
• ▶️ 一键运行/停止 — 点击即可在终端中运行脚本，支持运行状态实时显示（加载动画）
• 📦 环境预设（Profile） — 将 Node 版本、Whistle 代理规则、自定义环境变量、访问地址打包为可复用的环境预设，一键绑定到脚本
• 🌐 Whistle 代理集成 — Profile 中配置 Whistle 规则，运行脚本时自动激活对应规则，停止时自动禁用
• 🔢 自定义环境变量 — Profile 支持配置任意环境变量，运行时自动注入终端
• 🔗 访问地址 — Profile 支持配置服务访问 URL，方便记录和查看
• 📁 多 package.json 支持 — 工作区包含多个 package.json 时自动分组展示
• 🔄 自动刷新 — 监听 package.json 文件变化，自动更新列表
• 🛠️ 多包管理器 — 支持 npm、yarn、pnpm
• 🤖 MCP Server — 内置 MCP (Model Context Protocol) 服务，让 AI 编程工具可以直接运行/停止工作区脚本

使用方式

基本操作

1. 打开包含 package.json 的项目
2. 点击左侧 Activity Bar 中的 NPM Scripts 图标打开侧边栏面板
3. 点击脚本名称或右侧的 ▶️ 按钮运行脚本，运行中点击 ⏹ 停止
4. 点击脚本右侧的 📦 按钮为该脚本绑定环境预设
5. 点击面板标题栏的 ⚙️ 按钮打开全局设置

环境预设（Profile）

环境预设是本插件的核心概念，将多项运行环境配置打包为一个可复用的组合：

创建 Profile

• 方式一：全局设置（⚙️） → 创建环境预设
• 方式二：脚本 📦 按钮 → 创建新的 Profile
• 方式三：命令面板 → Create Environment Profile

绑定 Profile 到脚本

点击脚本右侧的 📦 按钮，从列表中选择已有的 Profile 即可绑定。绑定后脚本描述中会显示 📦 Profile名称。

编辑/删除 Profile

全局设置（⚙️） → 编辑环境预设，可修改 Profile 的各项配置或删除整个 Profile（删除时会自动解除所有脚本的绑定关系）。

全局设置

点击面板标题栏的 ⚙️ 按钮可配置：

• Whistle 代理端口 — 设置 Whistle 服务端口号
• MCP Server 开关 — 启动或关闭 MCP Server
• 创建/编辑环境预设 — 管理 Profile

MCP Server（AI 编程工具集成）

插件内置 MCP (Model Context Protocol) 服务端，启动后 AI 编程工具（如 Cursor、Cline、CodeBuddy 等）可通过 MCP 协议直接操作工作区的 npm scripts。

启动方式

• 方式一：全局设置（⚙️） → 启动 MCP Server
• 方式二：面板标题栏的 📡 按钮
• 方式三：命令面板 → Toggle MCP Server
• 方式四：状态栏底部点击 MCP: Off 按钮

启动后状态栏会显示 MCP: 3580（端口号），.vscode/mcp.json 会自动写入 MCP 配置供 AI 工具发现。

提供的 MCP Tools

在 AI 工具中使用

MCP Server 启动后，会自动在 .vscode/mcp.json 中写入配置：

{
  "servers": {
    "node-npm-script": {
      "type": "http",
      "url": "http://127.0.0.1:3580/mcp"
    }
  }
}

支持 MCP 协议的 AI 工具会自动发现此配置，之后你就可以用自然语言让 AI 执行类似操作：

• "启动 dev 服务" → AI 调用 run_script(scriptName: "dev")
• "看看现在哪些脚本在跑" → AI 调用 list_running_scripts()
• "把 build 停掉" → AI 调用 stop_script(scriptName: "build")

运行环境解析

脚本运行时，插件按以下顺序解析环境配置：

绑定的 Profile → 系统默认

• 如果脚本绑定了 Profile，则使用该 Profile 中的 Node 版本、Whistle 规则、环境变量等配置
• 如果未绑定 Profile，则使用系统默认环境（不做任何版本切换或代理配置）

Whistle 代理集成

插件同时兼容 Whistle 命令行版 和 Whistle 桌面客户端，采用三层降级策略：

规则激活：

1. HTTP API — 标准 /cgi-bin/rules/select 接口（命令行版 Whistle）
2. 桌面客户端 API — /cgi-bin/rules/project + x-whistle-special-auth
3. w2 命令行 — 最终降级方案

规则禁用：

1. HTTP API — 标准 /cgi-bin/rules/unselect 接口
2. 文件系统 — 直接修改 properties 文件中的 selectedList（桌面客户端）
3. w2 命令行 — 最终降级方案

规则列表获取同样支持 HTTP API 和文件系统两种方式，确保在各种 Whistle 安装方式下都能正常工作。

配置项

Profile 配置示例

在 .vscode/settings.json 中：

{
  "nodeNpmScript.profiles": {
    "测试服开发": {
      "nodeVersion": "v18.19.0",
      "whistleRule": "test-server-rule",
      "env": {
        "API_BASE": "https://test-api.example.com",
        "DEBUG": "true"
      },
      "url": "https://test.example.com",
      "description": "连接测试服后端，开启调试模式"
    },
    "本地联调": {
      "nodeVersion": "v20.10.0",
      "whistleRule": "local-proxy",
      "url": "http://localhost:3000",
      "description": "联调本地后端服务"
    }
  },
  "nodeNpmScript.scriptProfiles": {
    "dev": "测试服开发",
    "start": "本地联调"
  },
  "nodeNpmScript.packageManager": "npm"
}

命令列表

License

MIT