byteplan-cli 1.3.7 → 1.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byteplan-cli",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "BytePlan CLI - Command line tool for BytePlan API",
   "keywords": [
     "byteplan",

package/skills/byteplan-api/scripts/api.js

@@ -627,6 +627,7 @@ export async function queryModels(token, options = {}) {
  * @param {Object} params.customQuery - 自定义查询条件
  * @param {string[]} params.groupFields - 分组字段
  * @param {Array} params.functions - 聚合函数
+ * @param {Array} params.orderBy - 排序字段 [{field, direction}]
  * @param {number} params.page - 页码（从 0 开始）
  * @param {number} params.pageSize - 每页条数
  * @param {object} options - 可选配置
@@ -634,11 +635,11 @@ export async function queryModels(token, options = {}) {
  * @returns {Promise<{data: Array}>} 返回数据数组，无 total 字段
  */
 export async function getModelData(token, modelCode, params = {}, options = {}) {
-  const { customQuery, groupFields, functions, page = 0, pageSize = 100 } = params;
+  const { customQuery, groupFields, functions, orderBy, page = 0, pageSize = 100 } = params;
   const { menuHeaders = {} } = options;
 
   // CLI 模式（仅支持简单查询）
-  if (useCliMode && !token && !customQuery && !groupFields && !functions) {
+  if (useCliMode && !token && !customQuery && !groupFields && !functions && !orderBy) {
     await ensureCliInstalled();
     try {
       const result = await execCli(['data', 'query', modelCode, '-p', String(page), '-s', String(pageSize)]);
@@ -671,6 +672,7 @@ export async function getModelData(token, modelCode, params = {}, options = {})
     groupFields: groupFields || [],
     functions: functions || [],
     customQuery: customQuery || {},
+    orderBy: orderBy || [],
     page,
     pageSize,
   };

package/src/api.js

@@ -339,6 +339,7 @@ export async function getModelData(token, modelCode, params = {}) {
       groupFields: params.groupFields || [],
       functions: params.functions || [],
       customQuery: params.customQuery || {},
+      orderBy: params.orderBy || [],
       page: params.page || params.pageNum || 0,
       pageSize: params.pageSize || 100,
     }),

package/src/cli.js

@@ -375,6 +375,7 @@ dataCmd
   .option('-q, --query <json>', 'Query condition (JSON format)')
   .option('-g, --group <fields>', 'Group fields (comma separated)')
   .option('-f, --functions <json>', 'Aggregation functions (JSON array)')
+  .option('-o, --order <json>', 'Order by fields (JSON array)')
   .addHelpText('after', `
 Examples:
   # Simple query
@@ -395,6 +396,12 @@ Examples:
   # Complete aggregation example
   byteplan data query CBEC_ORDER -g product_id -q '{"type":"condition","field":"order_date","operator":"BETWEEN","value":["2024-01-01","2024-12-31"]}' -f '[{"func":"sum","field":"amount","alias":"total_amount"},{"func":"count","field":"id","alias":"order_count"}]'
 
+  # With sorting
+  byteplan data query CBEC_PRODUCT -o '[{"field":"selling_price","direction":"desc"},{"field":"product_name","direction":"asc"}]'
+
+  # Combined example with filter and sort
+  byteplan data query CBEC_PRODUCT -q '{"type":"condition","field":"category","operator":"=","value":"饮料"}' -o '[{"field":"selling_price","direction":"desc"}]' -s 5
+
 Query Syntax:
 
   1. Single Condition:
@@ -439,6 +446,16 @@ Query Syntax:
 
     Note: When using aggregation functions, -g (group) is usually needed.
     Without grouping, aggregation returns a single summary row.
+
+  Order By (-o):
+    JSON array of sort objects:
+    [
+      { "field": "字段名", "direction": "desc" },
+      { "field": "字段名", "direction": "asc" }
+    ]
+
+    direction: "asc" (升序) or "desc" (降序)
+    Example: -o '[{"field":"created_date","direction":"desc"}]'
 `)
   .action(async (modelCode, options) => {
     try {
@@ -474,6 +491,16 @@ Query Syntax:
         }
       }
 
+      // 解析排序字段
+      if (options.order) {
+        try {
+          params.orderBy = JSON.parse(options.order);
+        } catch (e) {
+          printJSON({ error: true, message: 'Invalid JSON order: ' + e.message });
+          process.exit(1);
+        }
+      }
+
       const result = await getModelData(null, modelCode, params);
 
       // result.data 是数据数组