@lovrabet/cli 1.2.4 → 1.2.5-beta.1

package/templates/rules/lovrabet_rules.mdc.tpl

@@ -153,57 +153,141 @@ const result = await client.models.projectMembers.filter({...});
 
 **编写代码前，请先检查用户的 `createClient` 和 `registerModels` 代码，确认使用的是用户定义的 alias。**
 
-### 4. 数据模型操作
+### 4. SDK Filter 查询构建规范（强制）
 
-#### 列表查询：使用 `filter()` 方法
+**重要**：这是 AI 最容易出错的地方，必须严格遵守以下规范。
 
-`filter()` 方法支持 **OpenAPI 和 WebAPI 两种模式**：
-- 强大的查询能力（支持复杂条件、范围查询、模糊匹配）
-- 高性能（通过 `select` 参数只返回需要的字段）
-- 简洁的返回结构（直接返回 `{ tableData, total }`）
-- 支持 11 种条件操作符和 `$and`/`$or` 逻辑组合
-  - 支持的操作符（11 种）：
-  - $eq, $ne, $gte ($gteq), $lte ($lteq), $in, $contain, $startWith, $endWith
-  - 逻辑操作符：$and, $or（支持嵌套）
+#### Filter 基本结构
 
 ```typescript
+// 完整的 filter 调用结构
 const result = await client.models.<modelName>.filter({
-  where: {
-    $and: [
-      { age: { $gte: 18, $lte: 45 } }, // 年龄区间
-      { country: { $in: ['中国', '美国', '日本'] } }, // 国家在集合内
-      { vip: { $ne: null } }, // VIP 字段非空
-      { name: { $contain: 'hello' } }, // 名称模糊匹配
-    ],
-  },
-  select: ['id', 'name', 'age', 'country'], // 注意：是 select，不是 fields
-  orderBy: [
-    { lastLoginAt: SortOrder.DESC }, // 先按登录时间倒序
-    { name: SortOrder.ASC }, // 再按名称升序
-  ], // 注意：是 orderBy，不是 sortList
+  where: { /* 查询条件 */ },
+  select: ['<field1>', '<field2>'],  // 注意：是 select，不是 fields
+  orderBy: [{ <field>: 'desc' }],    // 注意：是 orderBy，不是 sortList
   currentPage: 1,
   pageSize: 20,
 });
 
+// 返回结构
 console.log(result.tableData); // 数据列表
-console.log(result.total); // 总数
+console.log(result.total);     // 总数
+```
 
-// 复杂嵌套条件
-const result = await client.models.<modelName>.filter({
+#### 支持的条件操作符
+
+| 操作符 | 说明 | 示例 |
+|--------|------|------|
+| `$eq` | 等于 | `{ status: { $eq: 'active' } }` |
+| `$ne` | 不等于 | `{ status: { $ne: 'deleted' } }` |
+| `$gte` | 大于等于 | `{ age: { $gte: 18 } }` |
+| `$lte` | 小于等于 | `{ age: { $lte: 65 } }` |
+| `$gt` | 大于 | `{ price: { $gt: 100 } }` |
+| `$lt` | 小于 | `{ price: { $lt: 1000 } }` |
+| `$in` | 包含于 | `{ type: { $in: ['A', 'B', 'C'] } }` |
+| `$contain` | 包含（字符串） | `{ name: { $contain: 'keyword' } }` |
+| `$startWith` | 开头匹配 | `{ email: { $startWith: 'admin' } }` |
+| `$endWith` | 结尾匹配 | `{ domain: { $endWith: '.com' } }` |
+
+#### 逻辑操作符
+
+```typescript
+// $and - 所有条件都满足
+where: {
+  $and: [
+    { age: { $gte: 18 } },
+    { status: { $eq: 'active' } }
+  ]
+}
+
+// $or - 任一条件满足
+where: {
+  $or: [
+    { status: { $eq: 'pending' } },
+    { status: { $eq: 'processing' } }
+  ]
+}
+
+// 嵌套组合
+where: {
+  $and: [
+    { age: { $gte: 18 } },
+    {
+      $or: [
+        { country: { $eq: '中国' } },
+        { country: { $eq: '美国' } }
+      ]
+    }
+  ]
+}
+```
+
+#### 常见错误 vs 正确写法
+
+| 错误写法 | 正确写法 | 错误原因 |
+|---------|---------|---------|
+| `where: { status: 'active' }` | `where: { status: { $eq: 'active' } }` | 缺少操作符 |
+| `fields: ['id', 'name']` | `select: ['id', 'name']` | 参数名错误 |
+| `sort: [{ createdAt: 'desc' }]` | `orderBy: [{ createdAt: 'desc' }]` | 参数名错误 |
+| `where: { name: 'like %keyword%' }` | `where: { name: { $contain: 'keyword' } }` | 不支持 SQL LIKE 语法 |
+| `where: { age: '>= 18' }` | `where: { age: { $gte: 18 } }` | 不支持字符串比较 |
+| `where: { age: { $gt: 18, $lt: 65 } }` | `where: { age: { $gte: 18, $lte: 65 } }` | 区间查询用 gte/lte |
+| `orderBy: 'createdAt desc'` | `orderBy: [{ createdAt: 'desc' }]` | 必须是数组格式 |
+| `select: 'id,name,status'` | `select: ['id', 'name', 'status']` | 必须是数组格式 |
+| `where: { $or: { status: 'A', type: 'X' } }` | `where: { $or: [{ status: { $eq: 'A' } }, { type: { $eq: 'X' } }] }` | $or 值必须是数组 |
+| `page: 1, limit: 20` | `currentPage: 1, pageSize: 20` | 参数名错误 |
+
+#### 正确示例
+
+```typescript
+// 数据集: 用户信息 | 数据表: users
+const result = await client.models.users.filter({
   where: {
     $and: [
-      { age: { $gte: 18 } },
+      { status: { $eq: 'active' } },
+      { age: { $gte: 18, $lte: 65 } },
       {
         $or: [
-          { country: { $eq: '中国' } },
-          { country: { $eq: '美国' } }
+          { name: { $contain: keyword } },
+          { email: { $contain: keyword } }
         ]
       }
     ]
-  }
+  },
+  select: ['id', 'name', 'email', 'status', 'createdAt'],
+  orderBy: [{ createdAt: 'desc' }, { name: 'asc' }],
+  currentPage: 1,
+  pageSize: 20,
 });
+
+// 使用返回数据
+result.tableData.forEach(user => {
+  console.log(user.name);
+});
+console.log('总计:', result.total);
 ```
 
+#### 返回值结构
+
+```typescript
+// filter 返回结构
+interface FilterResult<T> {
+  tableData: T[];  // 数据列表
+  total: number;   // 总数（用于分页）
+}
+```
+
+### 5. 数据模型操作
+
+#### 列表查询：必须使用 `filter()` 方法
+
+**禁止使用 `getList()` 进行列表查询**，必须使用 `filter()`。
+
+`filter()` 方法支持 **OpenAPI 和 WebAPI 两种模式**：
+- 强大的查询能力（支持复杂条件、范围查询、模糊匹配）
+- 高性能（通过 `select` 参数只返回需要的字段）
+- 简洁的返回结构（直接返回 `{ tableData, total }`）
+
 #### SQL API（v1.1.19+）
 
 **注意事项**：
@@ -217,24 +301,191 @@ const result = await client.models.<modelName>.filter({
 
 ```typescript
 // 基础查询（无参数）
-const data = await client.api.executeSql('fc8e7777-06e3847d');
+const data = await client.api.executeSql("fc8e7777-06e3847d");
 
 if (data.execSuccess && data.execResult) {
-  data.execResult.forEach(row => console.log(row));
+  data.execResult.forEach((row) => console.log(row));
 }
 
 // 参数化查询（推荐）
-const data = await client.api.executeSql('fc8e7777-06e3847d', {
-  userId: '123',           // SQL 中使用 #{userId}
-  startDate: '2025-01-01', // SQL 中使用 #{startDate}
-  endDate: '2025-12-31'    // SQL 中使用 #{endDate}
+const data = await client.api.executeSql("fc8e7777-06e3847d", {
+  userId: "123", // SQL 中使用 #{userId}
+  startDate: "2025-01-01", // SQL 中使用 #{startDate}
+  endDate: "2025-12-31", // SQL 中使用 #{endDate}
 });
 
 if (data.execSuccess && data.execResult) {
-  console.log('查询成功', data.execResult);
+  console.log("查询成功", data.execResult);
 }
 ```
 
+### 6. MCP SQL 创建工作流（强制顺序）
+
+**⚠️ 关键原则**：创建自定义 SQL 时，**必须严格按照以下顺序执行**，禁止跳过任何步骤！
+
+#### 完整工作流程
+
+```
+第1步 → 第2步 → 第3步 → 第4步 → 第5步
+  ↓        ↓        ↓        ↓        ↓
+查询    生成      验证      保存      测试
+```
+
+#### 第1步：查询现有 SQL
+
+**目标**：确认 SQL 是否已存在，避免重复创建。
+
+```typescript
+// 使用 MCP 工具：list_sql_queries
+const sqlList = await list_sql_queries({
+  keyword: '<keyword>',  // 可选：按关键词搜索
+  sqlCode: '<sql-code>', // 可选：按 code 精确查询
+});
+
+// 检查是否已存在
+const existingSql = sqlList.sqls.find(s => s.sqlCode === '<sql-code>');
+if (existingSql) {
+  console.log('SQL 已存在:', existingSql.sqlName);
+  // 进入第3步验证现有 SQL
+}
+```
+
+#### 第2步：生成 SQL 代码
+
+**目标**：基于数据集结构生成正确的 SQL。
+
+```typescript
+// 使用 MCP 工具：get_dataset_detail
+// 先获取表结构，确保字段名正确
+const detail = await get_dataset_detail({
+  datasetCode: '<dataset-code>',
+});
+
+// 确认字段存在
+const fieldCodes = detail.fields.map(f => f.code);
+if (!fieldCodes.includes('<field-name>')) {
+  throw new Error(`字段 ${<field-name>} 不存在`);
+}
+
+// 编写 SQL（必须先确认表名和字段名）
+const sqlContent = `
+SELECT id, <field1>, <field2>
+FROM ${detail.basic.tableName}
+WHERE <condition>
+`;
+```
+
+#### 第3步：验证 SQL 内容
+
+**目标**：在保存前验证 SQL 语法和结构正确性。
+
+```typescript
+// 使用 MCP 工具：validate_sql_content
+const validation = await validate_sql_content({
+  sqlContent: sqlContent,
+  dbId: detail.basic.database.dbId,
+});
+
+if (!validation.validation.valid) {
+  console.error('SQL 验证失败:', validation.validation.errors);
+  // 修复后重新验证
+  return;
+}
+```
+
+#### 第4步：保存 SQL
+
+**目标**：将验证通过的 SQL 保存到平台。
+
+```typescript
+// 使用 MCP 工具：save_or_update_custom_sql
+const result = await save_or_update_custom_sql({
+  sqlName: '<sql-name>',
+  sqlCode: '<sql-code>',
+  sqlContent: sqlContent,
+  dbId: detail.basic.database.dbId,
+  verifyAfterSave: true,  // 保存后自动验证
+});
+```
+
+#### 第5步：测试执行
+
+**目标**：验证 SQL 能正确执行并返回预期数据。
+
+```typescript
+// 使用 MCP 工具：execute_custom_sql
+const execResult = await execute_custom_sql({
+  sqlCode: '<sql-code>',
+  params: { /* 参数 */ },
+});
+
+if (!execResult.execSuccess) {
+  console.error('SQL 执行失败:', execResult.execError);
+} else {
+  console.log('SQL 执行成功，返回', execResult.rowCount, '行');
+}
+```
+
+#### 禁止行为
+
+| 禁止行为 | 正确做法 |
+|---------|---------|
+| 跳过第1步，直接创建 SQL | 先查询，避免重复 |
+| 跳过第2步，直接写 SQL | 先获取表结构，确认字段 |
+| 跳过第3步，直接保存 SQL | 先验证，确保语法正确 |
+| 保存后不测试执行 | 必须测试，确保运行正确 |
+| 假设 SQL code 存在 = SQL 正确 | 必须验证 SQL 内容 |
+
+#### SQL 内容验证检查清单
+
+创建或修改 SQL 时，必须确认：
+
+- [ ] FROM 子句的表名正确（与 `datasetDetail.basic.tableName` 一致）
+- [ ] SELECT 的字段名正确（与 `datasetDetail.fields[].code` 一致）
+- [ ] WHERE 条件的字段名正确
+- [ ] JOIN 条件的字段名在两个表中都存在
+- [ ] 主键字段名正确（特别是 COUNT(DISTINCT xxx) 中的字段）
+- [ ] 只包含 SELECT 查询（禁止 INSERT/UPDATE/DELETE）
+- [ ] 参数占位符格式正确（使用 #{paramName}）
+
+#### 错误示例
+
+```typescript
+// ❌ 错误：跳过验证步骤
+await save_or_update_custom_sql({
+  sqlCode: 'my-query',
+  sqlContent: 'SELECT wrong_field FROM wrong_table',  // 未验证
+});
+
+// ❌ 错误：只检查 SQL code 是否存在
+const sqlList = await list_sql_queries();
+if (sqlList.sqls.find(s => s.sqlCode === 'my-query')) {
+  // 假设 SQL 正确，但内容可能有问题
+  await client.api.executeSql('my-query');
+}
+
+// ✅ 正确：完整的工作流程
+// 1. 查询现有 SQL
+const sqlList = await list_sql_queries({ sqlCode: 'my-query' });
+
+// 2. 获取表结构
+const detail = await get_dataset_detail({ datasetCode: 'xxx' });
+
+// 3. 验证 SQL 内容
+const validation = await validate_sql_content({
+  sqlContent: detail.sqlContent,
+  dbId: detail.basic.database.dbId,
+});
+
+// 4. 保存 SQL
+if (validation.validation.valid) {
+  await save_or_update_custom_sql({ /* ... */ });
+}
+
+// 5. 测试执行
+const result = await execute_custom_sql({ sqlCode: 'my-query' });
+```
+
 #### 用户列表 API（v1.1.19+）
 
 **说明**：获取平台用户列表，内置 30 秒缓存。
@@ -469,8 +720,289 @@ result.tableData.forEach(item => {
 
 
 
+## AntD UI 开发规范（禁止 AI 风格）
+
+**重要**：ToB 企业应用需要专业、简洁的界面风格，严禁使用 AI 典型的花哨风格。
+
+### 禁止事项（强制）
+
+| 禁止项 | 说明 |
+|-------|------|
+| ❌ **禁止使用 emoji** | 包括但不限于：✨ 🚀 💡 ⚡ 🎯 📊 🔥 🎉 等 |
+| ❌ **禁止使用 AI 味道的文案** | 如："让我们开始吧！"、"太棒了！"、"哇！"、"试试看！" |
+| ❌ **禁止使用花哨的颜色** | 只使用 AntD token 颜色，禁止自定义霓虹色、渐变色 |
+| ❌ **禁止过度动画** | 只使用 AntD 内置动画，禁止自定义花哨动画效果 |
+| ❌ **禁止使用非专业称呼** | 如："小伙伴"、"亲"、"宝宝" 等 |
+| ❌ **禁止使用可爱的图标** | 如：🎈 🎁 🍭 🌈 等非业务相关图标 |
+| ❌ **禁止使用感叹号** | 标题和按钮文案中禁止使用 "!" |
+
+### 文案规范
+
+#### 正确的文案风格
+
+| 场景 | 正确 ✅ | 错误 ❌ |
+|------|--------|--------|
+| 按钮 | 保存 / 取消 / 确认 | 保存吧！ / 再想想 / 好的！ |
+| 提示 | 操作成功 / 加载中 / 操作失败 | 太棒了！/ 马上就好~ / 哎呀出错了 |
+| 标题 | 用户管理 / 数据列表 | 🎯 用户管理 / 📊 数据列表 |
+| 空状态 | 暂无数据 | 还没有数据哦~ / 空空如也 |
+| 确认弹窗 | 确定要删除吗？ | 你真的要删除吗？😱 |
+
+#### 文案示例
+
+```typescript
+// ✅ 正确：简洁专业
+const messages = {
+  success: '操作成功',
+  error: '操作失败',
+  confirm: '确定要删除这条记录吗？',
+  cancel: '取消',
+  submit: '提交',
+  save: '保存',
+  loading: '加载中...',
+  noData: '暂无数据',
+};
+
+// ❌ 错误：AI 味道
+const messages = {
+  success: '🎉 太棒了！操作成功！',
+  error: '哎呀，出错了 😢',
+  confirm: '你真的要删除吗？确定吗？',
+  cancel: '再想想吧~',
+  submit: '提交表单 ✨',
+  save: '保存更改 💾',
+  loading: '马上就好~请稍等 ⏳',
+  noData: '空空如也~还没有数据哦',
+};
+```
+
+### 颜色规范
+
+#### 使用 AntD Token
+
+```typescript
+// ✅ 正确：使用 AntD token
+import { theme } from 'antd';
+
+const { token } = theme.useToken();
+
+const styles = {
+  primary: token.colorPrimary,
+  success: token.colorSuccess,
+  error: token.colorError,
+  warning: token.colorWarning,
+  text: token.colorText,
+  border: token.colorBorder,
+};
+
+// ❌ 错误：自定义花哨颜色
+const styles = {
+  primary: '#FF00FF',      // 霓虹粉
+  success: '#00FF00',      // 亮绿色
+  accent: '#FFD700',       // 金色
+  gradient: 'linear-gradient(45deg, #ff6b6b, #feca57)',  // 渐变
+};
+```
+
+### 组件使用规范
+
+#### 按钮
+
+```typescript
+// ✅ 正确：简洁明了
+<Button type="primary" onClick={handleSave}>
+  保存
+</Button>
+<Button danger onClick={handleDelete}>
+  删除
+</Button>
+
+// ❌ 错误：花哨风格
+<Button type="primary" onClick={handleSave}>
+  💾 保存更改
+</Button>
+<Button danger onClick={handleDelete}>
+  🗑️ 哎呀，要删除吗？
+</Button>
+```
+
+#### 表格
+
+```typescript
+// ✅ 正确：使用 ProTable 或 Table + Pagination
+import { Table } from 'antd';
+
+<Table
+  columns={columns}
+  dataSource={data}
+  pagination={{
+    current: currentPage,
+    pageSize: pageSize,
+    total: total,
+    showSizeChanger: true,
+    showQuickJumper: true,
+    showTotal: (total) => `共 ${total} 条`,
+  }}
+/>
+
+// ❌ 错误：花哨的空状态
+<Table
+  columns={columns}
+  dataSource={data}
+  locale={{
+    emptyText: (
+      <div>
+        <span>🎭 </span>
+        <span>还没有数据哦~</span>
+      </div>
+    ),
+  }}
+/>
+```
+
+#### 消息提示
+
+```typescript
+// ✅ 正确：简洁专业
+import { message } from 'antd';
+
+message.success('保存成功');
+message.error('操作失败，请重试');
+message.warning('请填写必填项');
+message.info('正在处理...');
+
+// ❌ 错误：AI 味道
+message.success('🎉 太棒了！保存成功！');
+message.error('😱 哎呀出错了！请再试一次');
+message.warning('⚠️ 嘿！别忘了填写必填项哦');
+message.info('🔔 正在为你处理中，请稍等~');
+```
+
+#### Modal 确认
+
+```typescript
+// ✅ 正确：专业简洁
+import { Modal } from 'antd';
+
+Modal.confirm({
+  title: '确认删除',
+  content: '确定要删除这条记录吗？',
+  okText: '确定',
+  cancelText: '取消',
+  onOk: handleDelete,
+});
+
+// ❌ 错误：AI 味道
+Modal.confirm({
+  title: '🤔 确认要删除吗？',
+  content: '删除后可就找不回来了哦！你确定要删除这条记录吗？',
+  okText: '是的，删除！',
+  cancelText: '再想想~',
+  icon: <ExclamationCircleOutlined style={{ color: '#FFD700' }} />,
+});
+```
+
+### 表单规范
+
+```typescript
+// ✅ 正确：简洁清晰的错误提示
+<Form>
+  <Form.Item
+    name="username"
+    label="用户名"
+    rules={[
+      { required: true, message: '请输入用户名' },
+      { min: 3, message: '用户名至少3个字符' },
+    ]}
+  >
+    <Input placeholder="请输入用户名" />
+  </Form.Item>
+</Form>
+
+// ❌ 错误：花哨的错误提示
+<Form>
+  <Form.Item
+    name="username"
+    label="👤 用户名"
+    rules={[
+      { required: true, message: '哎呀！别忘了填写用户名哦~' },
+      { min: 3, message: '用户名太短啦，至少要3个字符呢！' },
+    ]}
+  >
+    <Input placeholder="输入用户名试试看~ ✨" />
+  </Form.Item>
+</Form>
+```
+
+### 空状态规范
+
+```typescript
+// ✅ 正确：简洁专业
+import { Empty } from 'antd';
+
+<Empty
+  description="暂无数据"
+  image={Empty.PRESENTED_IMAGE_SIMPLE}
+/>
+
+// 带操作按钮
+<Empty
+  description="暂无数据"
+  image={Empty.PRESENTED_IMAGE_SIMPLE}>
+  <Button type="primary">创建数据</Button>
+</Empty>
+
+// ❌ 错误：AI 味道
+<Empty
+  description={
+    <div>
+      <div>🎭 还没有数据哦~</div>
+      <div style={{ fontSize: 12, color: '#999' }}>
+        快来创建第一条数据吧！✨
+      </div>
+    </div>
+  }
+/>
+```
+
+### 图标使用规范
+
+```typescript
+// ✅ 正确：使用 @ant-design/icons
+import {
+  UserOutlined,
+  DeleteOutlined,
+  EditOutlined,
+  SearchOutlined,
+} from '@ant-design/icons';
+
+// 按钮图标（可选，保持简洁）
+<Button icon={<PlusOutlined />}>新建</Button>
+
+// ❌ 错误：使用 emoji 作为图标
+<Button>🆕 新建</Button>
+<Button>✏️ 编辑</Button>
+<Button>🗑️ 删除</Button>
+```
+
+### 检查清单
+
+在编写 UI 代码时，确保：
+
+- [ ] 没有 emoji
+- [ ] 没有感叹号
+- [ ] 文案简洁专业
+- [ ] 使用 AntD token 颜色
+- [ ] 使用 @ant-design/icons 而非 emoji
+- [ ] 按钮文案为动词（保存/删除/编辑）
+- [ ] 提示文案中性（操作成功/操作失败）
+- [ ] 没有过度动画效果
+
+
+
 ## 禁止事项
 
+### SDK 相关
 1. **不要臆测 API** - 使用不存在的方法或参数
 2. **不要臆测字段** - 未通过 MCP 确认字段是否存在
 3. **不要混淆认证模式** - 在错误的模式使用功能（如 OpenAPI 模式使用 delete）
@@ -478,8 +1010,29 @@ result.tableData.forEach(item => {
 5. **不要假设返回值结构** - 注意不同方法返回值的差异
 6. **不要在循环中调用 API** - 使用 Promise.all 批量处理
 7. **不要在每次渲染时调用 API** - 使用 useEffect 控制
-8. **不要忘记检查 execSuccess** - executeSql 返回的数据必须检查 `execSuccess` 状态
-9. **不要假设 executeSql 返回数组** - 返回的是 `{ execSuccess, execResult }` 对象
+8. **不要使用 getList()** - 列表查询必须使用 filter()
+
+### Filter 查询相关
+9. **不要忘记使用操作符** - where 条件必须使用 `$eq`、`$gte` 等操作符
+10. **不要使用错误的参数名** - 是 `select` 不是 `fields`，是 `orderBy` 不是 `sortList`
+11. **不要使用 SQL 语法** - 不支持 `LIKE`、`>=` 等，必须用 `$contain`、`$gte` 等
+12. **不要忽略参数格式** - `orderBy` 和 `select` 必须是数组，不能是字符串
+
+### SQL 相关
+13. **不要跳过 MCP SQL 工作流步骤** - 必须按顺序：查询→生成→验证→保存→测试
+14. **不要忘记检查 execSuccess** - executeSql 返回的数据必须检查 `execSuccess` 状态
+15. **不要假设 executeSql 返回数组** - 返回的是 `{ execSuccess, execResult }` 对象
+16. **不要假设SQL code存在 = SQL正确** - 必须验证SQL内容中的表名和字段名与实际数据库结构匹配
+17. **不要仅检查SQL code是否存在** - 必须获取SQL内容，对比表名和字段名，修复SQL内容本身
+18. **不要在自定义 SQL 中使用 INSERT/UPDATE/DELETE** - 只允许 SELECT 查询
+
+### UI 相关
+19. **不要使用 emoji** - 包括按钮、标题、提示文案等所有地方
+20. **不要使用 AI 味道的文案** - 如"太棒了！"、"让我们开始吧！"、"试试看！"
+21. **不要使用花哨的颜色** - 只使用 AntD token 颜色
+22. **不要使用感叹号** - 标题和按钮文案中禁止使用 "!"
+23. **不要使用自定义动画** - 只使用 AntD 内置动画
+24. **不要使用非专业称呼** - 如"小伙伴"、"亲"、"宝宝" 等
 
 
 
@@ -499,14 +1052,28 @@ result.tableData.forEach(item => {
 
 ### 记住
 
+#### SDK 核心
 - **成功**：SDK 返回 API 响应的 `data` 字段内容
 - **失败**：抛出 `LovrabetError` 异常（不是返回错误）
 - **所有调用**：必须用 `try-catch` 包裹
 - **先获取元数据**：使用 MCP 确认字段存在
-- **注意参数名**：`select`（不是 `fields`），`orderBy`（不是 `sortList`）
-- **列表查询用 filter**：使用 `filter()` 方法进行列表查询
+
+#### Filter 查询
+- **列表查询用 filter**：必须使用 `filter()` 方法，禁止使用 `getList()`
+- **注意参数名**：`select`（不是 `fields`），`orderBy`（不是 `sortList`），`currentPage`/`pageSize`（不是 `page`/`limit`）
+- **必须使用操作符**：`where: { status: { $eq: 'active' } }`，不是 `where: { status: 'active' }`
+- **参数必须是数组**：`select: ['id', 'name']`，不是 `select: 'id,name'`
+
+#### MCP SQL 流程
+- **严格执行 5 步流程**：查询→生成→验证→保存→测试
 - **executeSql 检查状态**：应用层必须检查 `execSuccess` 状态
-- **用户列表**：使用 `client.api.user.getList()` 获取平台用户
+- **SQL验证必须系统化**：创建或使用SQL时，必须对比SQL内容与实际表结构，验证表名和字段名
+- **SQL code存在 ≠ SQL正确**：必须获取SQL内容，验证表名、字段名、JOIN条件是否正确
+
+#### UI 规范
+- **禁止 emoji**：所有地方都不使用 emoji
+- **文案简洁专业**："保存"而不是"保存吧！"，"操作成功"而不是"太棒了！"
+- **使用 AntD token**：颜色使用 `token.colorPrimary` 等，不自定义花哨颜色
 
 
 
@@ -520,12 +1087,17 @@ result.tableData.forEach(item => {
 - `<modelName>` - 模型名称，如 `users`、`orders` 等
 - `<dataset-code>` - 数据集代码
 - `<table-name>` - 表名
+- `<table-alias>` - 表别名（SQL 中使用）
 - `<id>` - 记录 ID
 - `<field>`, `<field1>`, `<field2>` - 字段名称
 - `<fieldName>` - 字段名称（用于排序等）
+- `<field-name>` - 具体字段名
+- `<wrong-field>`, `<correct-field>` - 错误/正确的字段名（SQL 验证示例）
+- `<wrong-pk>`, `<correct-pk>` - 错误/正确的主键字段名
+- `<wrong-table>`, `<correct-table>` - 错误/正确的表名
 - `<value>`, `<value1>`, `<value2>` - 字段值
 - `<sql-code>` - SQL 代码
-- `<field-name>` - 具体字段名
+- `<sql-name>` - SQL 名称
 - `<value-field>` - 用作选项值的字段
 - `<label-field>` - 用作显示文本的字段
 
@@ -545,3 +1117,24 @@ result.tableData.forEach(item => {
 - [官方文档](https://open.lovrabet.com/docs/lovrabet-sdk/intro)
 - [API 参考](https://open.lovrabet.com/docs/lovrabet-sdk/api-reference)
 - [Filter API](https://open.lovrabet.com/docs/lovrabet-sdk/filter-api)
+
+---
+
+## 更新日志
+
+### v2.0.0 (2025-01-17)
+- ✨ **新增 SDK Filter 查询构建规范（强制）** - 详细说明 filter 的正确用法，列举 10 种常见错误
+- ✨ **新增 MCP SQL 创建工作流（强制顺序）** - 明确 5 步流程顺序：查询→生成→验证→保存→测试
+- ✨ **新增 AntD UI 开发规范（禁止 AI 风格）** - 禁止 emoji、AI 味道文案、花哨颜色等
+- 📝 重组禁止事项为 4 大类（SDK / Filter / SQL / UI），共 24 条
+- 📝 更新"记住"部分，分 4 大类总结关键要点
+
+### v1.0.0 (2025-11-15)
+- 📋 完整的 SDK 使用规范
+- 🔧 MCP Tools 使用指南
+- ⚡ 性能优化建议
+- 🛡️ 错误处理最佳实践
+
+---
+
+> update：2025-01-17