# 实现代码

## 规则（Rules）

# 代码实现 - 规则文档

## 任务目标
用JavaScript或Python编写工具代码，并编写测试用例进行验证，确保工具稳定可靠。

## 输入条件
- 工具的功能需求和接口规范
- 已确认使用的编程语言（JavaScript或Python）
- 已确认测试框架（Jest/Mocha或pytest）

## 必须遵守的规则

### 规则1：代码规范
- JavaScript使用Node.js环境
- 入口函数统一为 `async function main(params)`
- 返回格式统一：`{ code: 0, msg: '成功', data: {...} }` 或 `{ code: 错误码, msg: '错误描述' }`
- 添加完整的JSDoc或Python docstring注释
- 禁止硬编码敏感信息

### 规则2：测试规范
- 必须编写测试用例
- 测试覆盖三种场景：正常、边界、异常
- JavaScript使用Jest，Python使用pytest

### 规则3：文件命名规范
- 主文件：`index.js` 或 `tool.py`
- 测试文件：`index.test.js` 或 `test_tool.py`
- 存放路径：`./tool/{工具名称}/`

### 规则4：验证标准
- 所有测试用例必须通过
- 禁止提交有语法错误的代码
- 禁止提交测试失败的代码

## 输出要求
- 工具代码文件（index.js或tool.py）
- 测试用例文件（index.test.js或test_tool.py）
- 测试执行结果报告

## 方法（Methods）

# 代码实现 - 方法文档

## 操作流程

### 步骤1：确定技术方案
- 根据需求确定编程语言（JS或Python）
- 设计核心逻辑和算法
- 确定依赖库

### 步骤2：编写工具代码
- 创建工具目录 `./tool/{工具名称}/`
- 编写主文件（index.js或tool.py）
- 实现参数校验、核心逻辑、异常处理
- 确保返回格式统一

### 步骤3：编写测试用例
- 编写测试文件
- 覆盖正常场景、边界场景、异常场景
- 每个场景至少一个测试用例

### 步骤4：执行测试验证
- 运行测试命令
- 检查测试结果
- 确认所有测试通过

### 步骤5：调试修复
- 分析失败测试的日志
- 定位并修复问题代码
- 重新执行测试验证

### 步骤6：代码审查
- 检查逻辑完整性和正确性
- 检查错误处理和注释
- 确认命名规范和代码质量

## 技巧（Tips）

# 代码实现 - 技巧文档

## 最佳实践

### 编码技巧
- 先写核心逻辑，再补充边界处理
- 使用try-catch包裹所有可能出错的代码
- 参数校验放在函数最前面

### 测试技巧
- 先写测试用例再写代码（TDD）
- 测试数据使用真实场景的样本
- 测试名称清晰描述测试场景

### 调试经验
- 使用console.log或print分段输出
- 检查参数类型和值是否符合预期
- 关注异步操作的错误处理

### 常见问题
- **异步错误未被捕获**：确保所有异步操作有catch
- **参数校验遗漏**：列出所有必填参数逐一校验
- **测试不充分**：至少覆盖正常、边界、异常三种场景