@lovrabet/cli 1.2.1-beta.4 → 1.2.4

package/templates/projects/sub-app-react-demo/src/api/api.ts

@@ -1,5 +1,6 @@
 /**
  * Generated by Lovrabet CLI
+ * Created: 2025-12-30T11:26:52.194Z
  *
  * 这个文件包含了项目的模型配置，并自动注册到 SDK 中
  * CLI 工具会自动维护这个文件，通常不需要手动修改
@@ -11,41 +12,57 @@ export const LOVRABET_APP_CODE = "app-c4c89304";
 
 /**
  * 项目的模型配置
- * 包含所有数据表的映射关系
+ * 使用数组格式，每个模型包含 datasetCode、tableName、name 和可选的 alias
+ *
+ * 访问方式：
+ * - 标准访问：client.models.dataset_[datasetCode]
+ * - 别名访问：client.models.[alias]（如果配置了 alias）
  */
 export const LOVRABET_MODELS_CONFIG: ModelsConfig = {
   appCode: LOVRABET_APP_CODE,
-  models: {
-    // ProjectMembers: {
-    //   tableName: "project_members",
-    //   datasetCode: "71494bcba13f4ec7858abe90794183ad",
-    // },
-    Requirements: {
-      tableName: "requirements",
-      datasetCode: "d26ed512e878461ca97d287a47606fd3",
-    },
-    Projects: {
-      tableName: "projects",
-      datasetCode: "c6e55d6720b84ffcb21698b0a04ccd23",
+  models: [
+    {
+      datasetCode: "3ff202af07164d0a9c5df7ddd8f83c23",
+      tableName: "dataset_f83c23",
+      name: "客户访谈记录",
+      alias: "datasetF83c23",
     },
-    Iterations: {
-      tableName: "iterations",
+    {
       datasetCode: "a60f11c17c5344e7a26d5144212cf366",
+      tableName: "iterations",
+      name: "迭代信息",
+      alias: "iterations",
     },
-    RequirementTypes: {
-      tableName: "requirement_types",
+    {
+      datasetCode: "d26ed512e878461ca97d287a47606fd3",
+      tableName: "requirements",
+      name: "需求",
+      alias: "requirements",
+    },
+    {
       datasetCode: "f17f1ee941c1468e87e6a0ca655ce00e",
+      tableName: "requirement_types",
+      name: "需求类型",
+      alias: "requirementTypes",
     },
-    CustomerInterviews: {
-      tableName: "dataset_3c23",
-      datasetCode: "3ff202af07164d0a9c5df7ddd8f83c23",
+    {
+      datasetCode: "c6e55d6720b84ffcb21698b0a04ccd23",
+      tableName: "projects",
+      name: "项目",
+      alias: "projects",
+    },
+    {
+      datasetCode: "71494bcba13f4ec7858abe90794183ad",
+      tableName: "project_members",
+      name: "项目成员",
+      alias: "projectMembers",
     },
-  }
+  ],
 } as const;
 
 /**
- * 自动注册默认配置
- * 这样 createClient() 就可以无参数调用
+ * 自动注册配置
+ * 配置名称: CONFIG_NAMES.DEFAULT
  */
 registerModels(LOVRABET_MODELS_CONFIG, CONFIG_NAMES.DEFAULT);
 
@@ -55,12 +72,12 @@ registerModels(LOVRABET_MODELS_CONFIG, CONFIG_NAMES.DEFAULT);
  * // 开发环境配置
  * registerModels({
  *   appCode: 'app-dev-123',
- *   models: { ... }
+ *   models: [...]
  * }, 'dev');
  *
  * // 其他项目配置
  * registerModels({
  *   appCode: 'other-project',
- *   models: { ... }
+ *   models: [...]
  * }, 'project-b');
  */

package/templates/projects/sub-app-react-demo/src/api/client.ts

@@ -1,16 +1,18 @@
 /**
  * Lovrabet SDK 客户端实例
+ * Generated by Lovrabet CLI
+ * Created: 2025-12-30T11:26:52.241Z
  *
  * 这个文件负责创建和导出统一的客户端实例，供整个应用使用
  * 通过导入 './api' 文件来自动执行配置注册
  */
 
-import { createClient } from "@lovrabet/sdk";
+import { createClient, CONFIG_NAMES } from "@lovrabet/sdk";
 import "./api"; // 导入配置文件，执行 registerModels() 注册
 
 /**
  * 主要的客户端实例
- * 使用最简洁的方式创建：无参数调用，自动使用已注册的 'default' 配置
+ * 使用配置名称 'CONFIG_NAMES.DEFAULT' 创建客户端
  */
 export const lovrabetClient = createClient();
 
@@ -21,26 +23,25 @@ export const lovrabetClient = createClient();
  * import { lovrabetClient } from '@/api/client';
  *
  * // 获取数据列表
- * const requirements = await lovrabetClient.models.Requirements.getList({
+ * const data = await lovrabetClient.models.datasetF83c23.getList({
  *   currentPage: 1,
  *   pageSize: 20
  * });
  *
  * // 获取单条记录
- * const requirement = await lovrabetClient.models.Requirements.getOne('123');
+ * const record = await lovrabetClient.models.datasetF83c23.getOne('123');
  *
  * // 创建新记录
- * const newRequirement = await lovrabetClient.models.Requirements.create({
- *   title: '新需求',
- *   description: '需求描述'
+ * const newRecord = await lovrabetClient.models.datasetF83c23.create({
+ *   // 记录数据
  * });
  */
 
 /**
  * 其他创建客户端的方式（根据需要选择）：
  *
- * 1. 明确指定配置名称：
- * export const lovrabetClient = createClient('default');
+ * 1. 使用默认配置（无参数调用）：
+ * export const lovrabetClient = createClient();
  *
  * 2. 使用其他已注册的配置：
  * export const devClient = createClient('dev');
@@ -52,7 +53,7 @@ export const lovrabetClient = createClient();
  *
  * 4. 通过 ClientConfig 指定配置名和其他选项：
  * export const lovrabetClient = createClient({
- *   modelConfigName: 'default',
+ *   apiConfigName: 'default',
  *   token: 'custom-token',
  *   env: 'daily'
  * });

package/templates/projects/sub-app-react-demo/src/pages/sdk-demo/index.tsx

@@ -19,22 +19,34 @@ export default function SdkDemo() {
   const [loading, setLoading] = useState(false);
   const [data, setData] = useState<any[]>([]);
   const [columns, setColumns] = useState<any[]>([]);
-  const [modelList, setModelList] = useState<string[]>([]);
+  const [modelList, setModelList] = useState<
+    Array<{
+      value: string;
+      label: string;
+      alias?: string;
+      name?: string;
+      datasetCode: string;
+    }>
+  >([]);
   const [selectedModel, setSelectedModel] = useState<string>("");
   const [selectOptions, setSelectOptions] = useState<any[]>([]);
   const [codeField, setCodeField] = useState<string>("id");
   const [labelField, setLabelField] = useState<string>("");
 
+  // 获取选中模型的信息（用于代码示例展示 alias）
+  const selectedModelInfo = modelList.find((m) => m.value === selectedModel);
+
   /**
    * 加载可用的数据模型列表
    */
   useEffect(() => {
     try {
-      const models = lovrabetClient.getModelList();
+      // 使用 getModelListDetails 获取人类友好的模型列表
+      const models = lovrabetClient.getModelListDetails();
       setModelList(models);
       // 默认选择第一个模型
       if (models.length > 0) {
-        setSelectedModel(models[0]);
+        setSelectedModel(models[0].value);
       }
     } catch (error) {
       console.error("获取模型列表失败:", error);
@@ -93,6 +105,16 @@ export default function SdkDemo() {
             column.title || column.dataIndex || column.key || String(column),
           dataIndex: column.dataIndex || column.key || String(column),
           key: column.dataIndex || column.key || String(column),
+          // 处理对象/数组类型的值，避免 React Error #31
+          render: (value: any) => {
+            if (value === null || value === undefined) {
+              return "-";
+            }
+            if (typeof value === "object") {
+              return JSON.stringify(value);
+            }
+            return String(value);
+          },
         }));
         setColumns(tableColumns);
       } else if (tableData.length > 0) {
@@ -103,6 +125,16 @@ export default function SdkDemo() {
             title: key,
             dataIndex: key,
             key: key,
+            // 处理对象/数组类型的值，避免 React Error #31
+            render: (value: any) => {
+              if (value === null || value === undefined) {
+                return "-";
+              }
+              if (typeof value === "object") {
+                return JSON.stringify(value);
+              }
+              return String(value);
+            },
           }));
           setColumns(tableColumns);
         }
@@ -182,13 +214,12 @@ export default function SdkDemo() {
         <Space>
           <Select
             placeholder="选择要查询的数据模型"
-            style={{ width: 250 }}
+            style={{ width: 350 }}
             value={selectedModel}
             onChange={setSelectedModel}
-            options={modelList.map((model) => ({
-              label: model,
-              value: model,
-            }))}
+            showSearch
+            optionFilterProp="label"
+            options={modelList}
           />
           <Button
             type="primary"
@@ -215,28 +246,39 @@ export default function SdkDemo() {
             overflow: "auto",
           }}
         >
-          {`// 基础查询（仅分页）
+          {`// ========== 方式一：标准 dataset_code 模式（推荐 AI/LLM 使用）==========
 const response = await lovrabetClient
-  .models.${selectedModel || "Requirements"}.filter({
+  .models['${selectedModel || "dataset_xxx"}'].filter({
     currentPage: 1,
     pageSize: 10
   });
-
-// 完整查询示例（所有参数均为可选，根据实际字段使用）
+${
+  selectedModelInfo?.alias
+    ? `
+// ========== 方式二：人类友好的 alias 模式 ==========
+const response = await lovrabetClient
+  .models.${selectedModelInfo.alias}.filter({
+    currentPage: 1,
+    pageSize: 10
+  });
+`
+    : ""
+}
+// ========== 完整查询示例（所有参数均为可选）==========
 const response = await lovrabetClient
-  .models.${selectedModel || "Requirements"}.filter({
+  .models['${selectedModel || "dataset_xxx"}'].filter({
     // where: 条件查询（可选）
     // where: {
     //   age: { $gte: 18 },
     //   status: { $eq: 'active' }
     // },
-    
+
     // select: 字段选择（可选）
     // select: ['id', 'name', 'age'],
-    
+
     // orderBy: 排序（可选）
     // orderBy: [{ createTime: 'desc' }],
-    
+
     // 分页参数（必需）
     currentPage: 1,
     pageSize: 10
@@ -345,13 +387,24 @@ const response = await lovrabetClient
               border: "1px solid #d9d9d9",
             }}
           >
-            {`// 调用示例
+            {`// ========== 方式一：标准 dataset_code 模式（推荐 AI/LLM 使用）==========
 const options = await lovrabetClient
-  .models.${selectedModel || "Requirements"}.getSelectOptions({
+  .models['${selectedModel || "dataset_xxx"}'].getSelectOptions({
     code: "${codeField || "id"}",
     label: "${labelField || "name"}"
   });
-
+${
+  selectedModelInfo?.alias
+    ? `
+// ========== 方式二：人类友好的 alias 模式 ==========
+const options = await lovrabetClient
+  .models.${selectedModelInfo.alias}.getSelectOptions({
+    code: "${codeField || "id"}",
+    label: "${labelField || "name"}"
+  });
+`
+    : ""
+}
 // 返回格式：[{ label: "显示文本", value: "选项值" }]`}
           </pre>
         </Space>