# mm API脚本编码规范

编写mm_os框架API接口的index.js脚本。触发关键词：api接口脚本、index.js。

## 执行步骤

### 步骤1：读取相关常识知识
使用 `read_knowledge knowledge_name='mm_os_framework'`、`read_knowledge knowledge_name='naming_conventions'`

### 步骤2：读取工作提示词
使用 `read_work work_name='script_mm_api'`

### 步骤3：理解接口需求
使用 `read_text` 读取api.json。

### 步骤4：编写主函数
使用 `write_text` 编写index.js的main函数。

### 步骤5：添加参数处理
处理入参校验、默认值和类型转换。

### 步骤6：添加错误处理
使用$.ret返回标准错误格式。

## 输出成果
1. index.js接口脚本

## 失败处理
- 若参数校验不通过，返回明确错误信息
- 若数据库操作失败，记录日志并返回友好错误

## 禁止行为
- ❌ 禁止不进行参数校验直接使用入参
- ❌ 禁止忽略SQL注入防范