ets-lsp-check

name	ets-lsp-check
description	使用 ETS Language Server 对 .ets 文件进行 IDE 级别的实时诊断。通过 LSP 协议获取编译器真实诊断结果（等同于 DevEco Studio 的错误提示）。与静态分析互补，专注于语法和类型错误检测。触发词：LSP 检查、language server 诊断、IDE 诊断、编译器级别检查、ets 实时诊断。支持多文件和目录输入，自动递归查找 .ets 文件，输出错误/警告/信息及汇总统计。PostToolUse Hook 模式下会自动输出错误详情（行号、错误消息）并指示 Claude 自动修复。

ETS LSP 诊断工具

使用 ETS Language Server 对 .ets 文件进行 IDE 级别的实时语法和类型检查。

功能特性

• 获取编译器真实诊断结果（等同于 DevEco Studio）
• 检测语法错误和类型错误
• 输出错误、警告、信息级别的诊断结果
• 支持自定义 HarmonyOS SDK 路径
• 支持多文件输入：一次检查多个文件
• 支持目录输入：自动递归查找 .ets 文件
• 容错处理：文件不存在时跳过并警告，继续检查其他文件
• 汇总统计：输出整体检查结果统计
• 智能分组：按文件大小动态调整批处理策略，小文件优先处理
• 渐进式检查：当 LSP 完成处理后提前结束等待，无需等待超时
• 超大文件警告：自动检测 >1MB 文件并提示

智能分组策略

文件大小	批处理大小	超时/文件	说明
< 10KB	100 个	300ms	极小文件，大批量
10-50KB	50 个	500ms	小文件
50-200KB	20 个	1000ms	中等文件
200-500KB	1 个	5000ms	大文件，单独处理
> 1MB	1 个	15000ms	超大文件，警告提示

前置要求

安装 ETS Language Server

工具会在首次运行时自动检测并安装 ETS Language Server，无需手动安装。

如需手动安装：

npm install -g @arkts/language-server
npm install -g @arkts/language-service

验证安装：

which ets-language-server

配置 HarmonyOS SDK（可选）

export HARMONYOS_SDK_PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony"

使用方式

本 skill 支持多种输入方式：

• 单个 .ets 文件路径
• 多个文件路径（空格分隔）
• 目录路径（自动递归查找 .ets 文件）
• 混合输入（文件和目录同时使用）

执行步骤

1. 解析所有输入路径，收集 .ets 文件
2. 跳过不存在的路径并输出警告
3. 检查 ETS Language Server 是否已安装
4. 执行 scripts/ets-lsp-diagnose.js 进行诊断
5. 输出每个文件的诊断结果
6. 输出整体汇总统计

执行命令

# 检查单个文件
node scripts/ets-lsp-diagnose.js /path/to/file.ets

# 检查多个文件
node scripts/ets-lsp-diagnose.js file1.ets file2.ets file3.ets

# 检查目录（递归查找 .ets 文件）
node scripts/ets-lsp-diagnose.js /path/to/project/entry/src

# 混合输入
node scripts/ets-lsp-diagnose.js file1.ets /path/to/dir file2.ets

环境变量

变量名	说明	默认值
HARMONYOS_SDK_PATH	HarmonyOS SDK 路径	/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony
ETS_LSP_COMMAND	LSP 服务器命令	ets-language-server
ETS_LSP_BATCH_TIMEOUT	批量超时时间(ms)	60000
ETS_LSP_INCREMENTAL	增量检查 true/false	true
ETS_LSP_SKIP_HUGE	跳过超大文件 (>1MB)	false

输出示例

智能分组检查

════════════════════════════════════════════════════════════
ETS Language Server 诊断工具 (智能分组优化版)
════════════════════════════════════════════════════════════
项目根目录: /path/to/project
待检查文件: 82 个
SDK 路径: /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony
增量检查: 启用
智能分组: 启用 (按文件大小动态调整批次)
🚀 初始化 ETS Language Server...
✓ LSP 初始化成功
  支持能力: 22 个

📦 [极小文件] 81 个，分 1 批
   批次 1/1 (81 文件)...
📦 [小文件] 1 个，分 1 批
   批次 1/1 (1 文件)...
   ✓ 已处理 82 个文件

────────────────────────────────────────────────────────────
📄 JsonUtil.ets
────────────────────────────────────────────────────────────

❌ 错误 (1):
   16:27 - No overload matches this call.

⚠️  警告 (1):
   23:5 - Unused variable 'temp'

✓ 81 个文件无错误

════════════════════════════════════════════════════════════
📊 检查结果汇总
════════════════════════════════════════════════════════════
   文件总数: 82
   有错误: 1
   无错误: 81
   ❌ 错误: 1
   ⚠️  警告: 1
   ℹ️  信息: 0
   ⏱️  耗时: 10.4s
════════════════════════════════════════════════════════════

路径不存在时

⚠️  以下路径不存在，已跳过:
   /path/to/nonexistent.ets

📋 共发现 2 个 .ets 文件待检查
...

PostToolUse Hook 自动修复

本 skill 配置了 PostToolUse Hook，在 Claude 每次通过 Edit/Write 修改 .ets 文件后自动触发 LSP 检查。

工作流程

1. Claude 使用 Edit/Write 工具修改 .ets 文件
2. Hook 自动运行 LSP 诊断，输出所有错误详情（行号、错误消息）
3. Claude 根据上下文判断哪些是本次改动引入的错误并自动修复
4. 原有代码的问题保持现状，告知用户即可

additionalContext 输出格式

ETS LSP 检查发现 2 个错误:
文件: /path/to/file.ets
  16:27 - No overload matches this call.
  23:5 - Type 'string' is not assignable to type 'number'.
请只修复你本次改动引入的错误，原有代码的问题保持现状并告诉用户。

注意事项

• Hook 仅在检测到错误时触发（无错误时静默通过）
• 每次 Edit/Write 操作只检查被修改的单个文件
• 错误详情直接来自 LSP 编译器诊断，与 DevEco Studio 一致

常见问题

Q: 提示 "找不到 LSP 服务器"

# 安装 language server
npm install -g @arkts/language-server
npm install -g @arkts/language-service

# 或指定路径
ETS_LSP_COMMAND=/path/to/ets-language-server node scripts/ets-lsp-diagnose.js file.ets

Q: 提示 "SDK 路径不存在"

# 设置正确的 SDK 路径
export HARMONYOS_SDK_PATH="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony"

Q: 诊断超时

# 增加批量超时时间（默认 60000ms）
ETS_LSP_BATCH_TIMEOUT=120000 node scripts/ets-lsp-diagnose.js /path/to/project