JavaScript 代码检查工具

概述

此技能提供 JavaScript 代码的检查、修复和验证功能，确保代码可以在本地 Node.js 环境中成功执行。

核心功能

1. Node.js 版本检查

• 检查本地 Node.js 版本
• 验证代码语法是否与 Node.js 版本兼容
• 检查是否使用了不支持的语法特性

2. 代码修复

• 自动修复全角符号（中文标点符号）
• 修复常见的编码问题
• 修复常见的语法错误

3. 代码验证

• 使用

  node --check

  验证语法
• 尝试执行代码验证可执行性
• 检查依赖项是否可用

4. 执行准备

• 返回检查结果和建议
• 提供执行命令（供

  execute_shell_command

  使用）
• 标记需要修复的问题

工作流程

标准流程

1. 检查 Node.js 版本

   使用 scripts/check_node_version.py 检查本地 Node.js 版本
   

2. 检查代码语法

   使用 scripts/check_js_syntax.py 检查 JavaScript 代码语法
   

3. 修复代码问题

   使用 scripts/fix_js_code.py 自动修复全角符号等问题
   

4. 验证代码可执行性

   使用 scripts/validate_js.py 验证代码是否可以执行
   

5. 返回结果

   返回检查结果、修复后的代码和执行命令
   

使用方法

方式 1: 完整检查流程

# 1. 检查 Node.js 版本
node_version = check_node_version()

# 2. 检查代码语法
syntax_result = check_js_syntax(js_code, node_version)

# 3. 修复代码
fixed_code = fix_js_code(js_code)

# 4. 验证代码
validation_result = validate_js(fixed_code)

# 5. 返回结果
return {
    "node_version": node_version,
    "syntax_ok": syntax_result["valid"],
    "fixed_code": fixed_code,
    "validation_ok": validation_result["valid"],
    "execute_command": f"node -e \"{fixed_code}\""
}

方式 2: 快速检查

# 一次性完成所有检查
result = check_and_fix_js(js_code)

脚本说明

scripts/check_node_version.py

检查本地 Node.js 版本和兼容性。

功能:

• 检查 Node.js 是否安装
• 获取 Node.js 版本号
• 检查版本是否满足要求（>= 14.0.0）

返回:

{
    "installed": true,
    "version": "18.17.0",
    "major": 18,
    "minor": 17,
    "patch": 0,
    "meets_requirement": true
}

scripts/check_js_syntax.py

检查 JavaScript 代码语法。

功能:

• 使用

  node --check

  检查语法
• 检查是否使用了不支持的语法特性
• 检查代码糖（ES6+ 特性）兼容性

参数:

• js_code

  : JavaScript 代码字符串

• node_version

  : Node.js 版本（可选）

返回:

{
    "valid": true,
    "errors": [],
    "warnings": [],
    "syntax_features": ["arrow-functions", "async-await"]
}

scripts/fix_js_code.py

自动修复 JavaScript 代码中的常见问题。

功能:

• 修复全角符号（中文标点符号）
• 修复编码问题
• 修复常见的语法错误

参数:

• js_code

  : JavaScript 代码字符串

返回:

{
    "fixed_code": "...",
    "fixes_applied": [
        {"type": "fullwidth_char", "line": 5, "original": "，", "fixed": ","},
        {"type": "encoding", "line": 10, "description": "Fixed UTF-8 encoding"}
    ]
}

scripts/validate_js.py

验证 JavaScript 代码是否可以执行。

功能:

• 尝试执行代码（使用

  node -e

  ）
• 检查运行时错误
• 验证依赖项

参数:

• js_code

  : JavaScript 代码字符串

返回:

{
    "valid": true,
    "executable": true,
    "errors": [],
    "output": "..."
}

集成到主 Agent

检查完成后，主 Agent 可以使用 AgentScope 的

execute_shell_command

工具执行代码：

from agentscope.tool import execute_shell_command

# 1. 使用 js-checker 检查代码
check_result = check_and_fix_js(js_code)

# 2. 如果检查通过，执行代码
if check_result["validation_ok"]:
    execute_command = check_result["execute_command"]
    result = await execute_shell_command(execute_command)

示例

示例 1: 检查并修复全角符号

输入代码:

console.log("Hello，World！");

修复后:

console.log("Hello,World!");

示例 2: 检查语法兼容性

输入代码:

const x = 1;
let y = 2;

检查结果:

• Node.js 版本: 18.17.0 ✅
• 语法检查: 通过 ✅
• 代码糖: ES6+ 特性，Node.js 18 支持 ✅

示例 3: 验证可执行性

输入代码:

console.log("Test");

验证结果:

• 语法: 通过 ✅
• 执行: 成功 ✅
• 输出: "Test"

注意事项

1. Node.js 版本要求: 建议使用 Node.js >= 14.0.0
2. 代码执行: 代码会在临时环境中执行，不会影响系统
3. 依赖项: 如果代码使用了外部依赖，需要先安装
4. 安全性: 代码执行前会进行基本的安全检查

相关工具

• AgentScope

  execute_shell_command

  : 执行修复后的代码
• Node.js: JavaScript 运行时环境