coze-plugin-utils/ESLINT.md

Comprehensive utility library for Coze plugins with multimedia processing, browser automation, cloud storage integration, and AI-powered video/audio generation capabilities

# ESLint 配置说明

## 配置概述

本项目使用 ESLint 进行代码质量检查和风格统一。配置了适合 TypeScript 项目的规则集，包括：

- 基本语法检查规则
- TypeScript 特定规则
- 代码风格规则
- 函数使用规则
- 错误处理规则
- 注释规则

## 主要规则说明

### 基本规则

- 禁止使用 `console` 和 `debugger`（警告级别）
- 禁止重复导入
- 未使用的变量会报错（忽略以 `_` 开头的参数）
- 强制使用 `const` 和 `let`，禁止使用 `var`

### TypeScript 规则

- 函数必须显式声明返回类型
- 谨慎使用 `any` 类型（警告级别）
- 禁止使用非空断言 `!`（警告级别）
- 类型断言和定义必须保持一致性

### 代码风格规则

- 使用单引号，允许模板字符串
- 语句末尾必须使用分号
- 缩进使用2个空格
- 对象和数组多行时使用尾随逗号
- 对象字面量中花括号内部有空格

## 使用方法

### 检查代码

```bash
npm run lint
```

### 自动修复问题

```bash
npm run lint:fix
```

## 配置文件

- `eslint.config.mjs` - ESLint 主配置文件（使用新的ESM格式）
- 忽略文件配置已集成到配置文件中

## 注意事项

1. 测试文件（`*.test.ts`）有特殊规则，允许使用 `any` 类型
2. 如需调整规则，请修改 `eslint.config.mjs` 文件
3. 提交代码前建议运行 `npm run lint:fix` 自动修复格式问题