@thinkingai/ae-cli 1.0.1 → 1.0.3

package/skills/te-dataops/references/dataops-integration.md

@@ -1,39 +1,39 @@
 ---
 name: dataops-integration
 version: 1.0.0
-description: "数据源与数据集成：创建数据源、创建同步方案、配置字段映射、执行同步、监控同步。触发关键词：数据源、同步、integration、sync、字段映射、数据接入、datasource、MySQL、ClickHouse。"
+description: "Datasource and data integration: create datasources, create sync solutions, configure field mapping, execute sync, monitor sync. Trigger keywords: datasource, sync, integration, sync, field mapping, data ingestion, datasource, MySQL, ClickHouse."
 metadata:
   requires:
-    bins: ["te-cli"]
+    bins: ["ae-cli"]
 ---
 
-# DataOps 数据源与数据集成
+# DataOps Datasource and Data Integration
 
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
+> **Prerequisites:** Read [`te-dataops/SKILL.md`](../SKILL.md) for general rules.
 
-使用 `dataops_integration` 子命令管理数据源和同步方案。
+Use the `dataops_integration` subcommand to manage datasources and sync solutions.
 
-**核心规则：**
-- 预置仓（te_etl）与非预置仓的配置参数差异很大，必须严格按照模板生成
-- sourceConfig/sinkConfig/channelConfig/fieldsMapping 都是 JSON 字符串
-- 创建同步方案前先测试数据源连接
+**Core Rules:**
+- Configuration parameters differ significantly between preset repositories (te_etl) and non-preset repositories, must strictly follow templates
+- sourceConfig/sinkConfig/channelConfig/fieldsMapping are all JSON strings
+- Test datasource connection before creating sync solution
 
 ---
 
-## 工作流 A：创建数据源
+## Workflow A: Create Datasource
 
 ```bash
-# Step 1: 查看支持的数据源组件类型
-te-cli dataops_integration +list_datasource_components
+# Step 1: View supported datasource component types
+ae-cli dataops_integration +list_datasource_components
 
-# Step 2: 测试连接（临时配置，不保存）
-te-cli dataops_integration +test_datasource_connect --spaceCode "${spaceCode}" \
+# Step 2: Test connection (temporary configuration, not saved)
+ae-cli dataops_integration +test_datasource_connect --spaceCode "${spaceCode}" \
   --componentName "MySQL" \
   --configValue '{"host":"localhost","port":3306,"username":"root","password":"xxx","database":"test"}'
 
-# Step 3: 创建数据源
-te-cli dataops_integration +add_datasource --spaceCode "${spaceCode}" \
-  --componentName "MySQL" --dataSourceName "生产MySQL" \
+# Step 3: Create datasource
+ae-cli dataops_integration +add_datasource --spaceCode "${spaceCode}" \
+  --componentName "MySQL" --dataSourceName "Production MySQL" \
   --sharedConfig true \
   --envJsonList '[{"host":"localhost","port":3306,"username":"root","password":"xxx"}]' \
   --confirmed true
@@ -41,41 +41,41 @@ te-cli dataops_integration +add_datasource --spaceCode "${spaceCode}" \
 
 ---
 
-## 工作流 B：创建同步方案（完整流程）
+## Workflow B: Create Sync Solution (Complete Process)
 
-### Step 1: 查看可用数据源
+### Step 1: View Available Datasources
 
 ```bash
-# 查看空间所有数据源
-te-cli dataops_integration +list_space_datasources --spaceCode "${spaceCode}"
+# View all datasources in workspace
+ae-cli dataops_integration +list_space_datasources --spaceCode "${spaceCode}"
 
-# 查看可用于同步的数据源（按 source/sink 分类）
-te-cli dataops_integration +list_sync_datasources --spaceCode "${spaceCode}"
+# View datasources available for sync (categorized by source/sink)
+ae-cli dataops_integration +list_sync_datasources --spaceCode "${spaceCode}"
 ```
 
-### Step 2: 浏览源表结构
+### Step 2: Browse Source Table Structure
 
 ```bash
-# 列出数据源下的数据库
-te-cli dataops_integration +list_datasource_databases --spaceCode "${spaceCode}" \
+# List databases under datasource
+ae-cli dataops_integration +list_datasource_databases --spaceCode "${spaceCode}" \
   --datasourceId "${datasourceId}"
 
-# 列出数据库下的表
-te-cli dataops_integration +list_datasource_tables --spaceCode "${spaceCode}" \
+# List tables under database
+ae-cli dataops_integration +list_datasource_tables --spaceCode "${spaceCode}" \
   --datasourceId "${datasourceId}" --database "test"
 
-# 获取表结构（列定义、分区）
-te-cli dataops_integration +get_table_structure --spaceCode "${spaceCode}" \
+# Get table structure (column definitions, partitions)
+ae-cli dataops_integration +get_table_structure --spaceCode "${spaceCode}" \
   --datasourceId "${datasourceId}" --database "test" --tablePath "users"
 ```
 
-### Step 3: 创建同步方案
+### Step 3: Create Sync Solution
 
-**关键：必须严格按照下方 JSON 模板生成参数**
+**Key: Must strictly follow JSON templates below to generate parameters**
 
 ```bash
-te-cli dataops_integration +add_sync_solution --spaceCode "${spaceCode}" \
-  --syncName "MySQL到预置仓同步" \
+ae-cli dataops_integration +add_sync_solution --spaceCode "${spaceCode}" \
+  --syncName "MySQL to Preset Repository Sync" \
   --srcComponent "MySQL" --srcDatasourceId "${mysqlDatasourceId}" \
   --sinkComponent "hive" --sinkDatasourceId "te_etl@TASK_ENGINE_TRINO" \
   --sourceConfig '{"component":"MySQL","datasourceId":"xxx","database":"test","tablePath":"users"}' \
@@ -85,31 +85,31 @@ te-cli dataops_integration +add_sync_solution --spaceCode "${spaceCode}" \
   --confirmed true
 ```
 
-### Step 4: 执行同步
+### Step 4: Execute Sync
 
 ```bash
-# 手动执行同步方案
-te-cli dataops_integration +exec_sync_solution --spaceCode "${spaceCode}" \
+# Manually execute sync solution
+ae-cli dataops_integration +exec_sync_solution --spaceCode "${spaceCode}" \
   --syncId "${syncId}" --confirmed true
 
-# 查看执行历史
-te-cli dataops_integration +list_sync_exec_histories --spaceCode "${spaceCode}" \
+# View execution history
+ae-cli dataops_integration +list_sync_exec_histories --spaceCode "${spaceCode}" \
   --syncId "${syncId}" --limit 20
 
-# 查看执行详情
-te-cli dataops_integration +get_sync_exec_info --spaceCode "${spaceCode}" \
+# View execution details
+ae-cli dataops_integration +get_sync_exec_info --spaceCode "${spaceCode}" \
   --syncId "${syncId}" --taskId "${taskId}"
 
-# 必要时停止执行
-te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
+# Stop execution if necessary
+ae-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
   --syncId "${syncId}" --taskId "${taskId}" --confirmed true
 ```
 
 ---
 
-## JSON 配置模板
+## JSON Configuration Templates
 
-### 预置仓作为目标端（Sink）
+### Preset Repository as Target (Sink)
 
 ```json
 {
@@ -127,7 +127,7 @@ te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
 }
 ```
 
-### 非预置仓（如 MySQL）
+### Non-Preset Repository (e.g., MySQL)
 
 ```json
 {
@@ -138,7 +138,7 @@ te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
 }
 ```
 
-### channelConfig（源端或目标端涉及预置仓时必须包含 gatewayConfig）
+### channelConfig (must include gatewayConfig when source or target involves preset repository)
 
 ```json
 {
@@ -154,7 +154,7 @@ te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
 }
 ```
 
-### fieldsMapping（双列映射）
+### fieldsMapping (bidirectional column mapping)
 
 ```json
 {
@@ -187,60 +187,65 @@ te-cli dataops_integration +stop_sync_solution --spaceCode "${spaceCode}" \
 
 ---
 
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+list_datasource_components` | 支持的组件 | 无 |
-| `+list_space_datasources` | 空间数据源 | `--spaceCode` `--componentName` `--dataSourceName` |
-| `+add_datasource` | 创建数据源 | `--spaceCode` `--componentName` `--dataSourceName` `--sharedConfig` `--envJsonList` `--confirmed` |
-| `+test_datasource_connect` | 测试连接 | `--spaceCode` `--componentName` `--configValue` |
-| `+list_datasource_databases` | 列出数据库 | `--spaceCode` `--datasourceId` |
-| `+list_datasource_tables` | 列出表 | `--spaceCode` `--datasourceId` `--database` |
-| `+get_table_structure` | 表结构 | `--spaceCode` `--datasourceId` `--database` `--tablePath` |
-| `+list_sync_solutions` | 同步方案列表 | `--spaceCode` |
-| `+add_sync_solution` | 创建同步方案 | `--spaceCode` `--syncName` `--srcComponent` `--srcDatasourceId` `--sinkComponent` `--sinkDatasourceId` `--sourceConfig` `--sinkConfig` `--channelConfig` `--fieldsMapping` `--confirmed` |
-| `+exec_sync_solution` | 执行同步 | `--spaceCode` `--syncId` `--confirmed` |
-| `+list_sync_exec_histories` | 执行历史 | `--spaceCode` `--syncId` `--execType` `--limit` |
-| `+get_sync_exec_info` | 执行详情 | `--spaceCode` `--syncId` `--taskId` |
-| `+stop_sync_solution` | 停止同步 | `--spaceCode` `--syncId` `--taskId` `--confirmed` |
-
-## 组件条件必填参数
-
-部分组件存在根据部署模式不同而变化的条件必填参数，`+list_datasource_components` 的 requiredFields 可能不包含这些参数（它们在 optionalFields 或 importantNotes 中说明）。创建数据源时务必根据用户选择的 mode 补齐对应参数。
+## Command Quick Reference
+
+| Command | Purpose | Key Flags |
+|---------|---------|-----------|
+| `+list_datasource_components` | List component types | None |
+| `+test_datasource_connect` | Test connection | `--spaceCode` `--componentName` `--configValue` |
+| `+add_datasource` | Create datasource | `--spaceCode` `--componentName` `--dataSourceName` `--sharedConfig` `--envJsonList` `--confirmed` |
+| `+modify_datasource` | Modify datasource | `--spaceCode` `--dataSourceName` `--dataSourceRemark` `--sharedConfig` `--envJsonList` `--confirmed` |
+| `+online_datasource` | Online datasource | `--spaceCode` `--dataSourceNames` `--confirmed` |
+| `+list_space_datasources` | List datasources | `--spaceCode` `--componentName` `--dataSourceName` |
+| `+list_sync_datasources` | Sync datasources | `--spaceCode` `--env` |
+| `+list_datasource_databases` | List databases | `--spaceCode` `--datasourceId` `--env` |
+| `+list_datasource_tables` | List tables | `--spaceCode` `--datasourceId` `--database` `--env` |
+| `+get_table_structure` | Table structure | `--spaceCode` `--datasourceId` `--database` `--tablePath` `--env` |
+| `+add_sync_solution` | Create sync solution | `--spaceCode` `--syncName` `--srcComponent` `--srcDatasourceId` `--sinkComponent` `--sinkDatasourceId` `--sourceConfig` `--sinkConfig` `--channelConfig` `--fieldsMapping` `--confirmed` |
+| `+save_sync_solution` | Update sync solution | `--spaceCode` `--syncId` `--syncName` `--sourceConfig` `--sinkConfig` `--channelConfig` `--fieldsMapping` `--confirmed` |
+| `+list_sync_solutions` | List sync solutions | `--spaceCode` |
+| `+get_sync_detail` | Sync solution details | `--spaceCode` `--syncId` `--withParams` |
+| `+exec_sync_solution` | Execute sync | `--spaceCode` `--syncId` `--execParams` `--confirmed` |
+| `+list_sync_exec_histories` | Execution history | `--spaceCode` `--syncId` `--execType` `--limit` |
+| `+get_sync_exec_info` | Execution details | `--spaceCode` `--syncId` `--taskId` |
+| `+stop_sync_solution` | Stop sync | `--spaceCode` `--syncId` `--taskId` `--confirmed` |
+
+## Component Conditional Required Parameters
+
+Some components have conditional required parameters that vary based on deployment mode. The requiredFields from `+list_datasource_components` may not include these parameters (they are explained in optionalFields or importantNotes). When creating datasources, be sure to supplement corresponding parameters based on the user's selected mode.
 
 ### MongoDB
 
-| mode 值 | 额外必填参数 | 说明 |
-|----------|-------------|------|
-| `single` | 无 | 单节点模式 |
-| `replicaSet` | `replicaSet` | 副本集名称（如 `rs0`），字段名为 `replicaSet` 而非 `replicaSetName` |
-| `sharded` | 无 | 分片集群模式 |
+| mode value | Additional required parameters | Description |
+|------------|-------------------------------|-------------|
+| `single` | None | Single node mode |
+| `replicaSet` | `replicaSet` | Replica set name (e.g., `rs0`), field name is `replicaSet` not `replicaSetName` |
+| `sharded` | None | Sharded cluster mode |
 
-**MongoDB 各模式 envJsonList 示例：**
+**MongoDB envJsonList examples for each mode:**
 
-单节点：
+Single node:
 ```json
 [{"mode":"single","nodes":[{"host":"10.0.0.1","port":"27017"}],"database":"mydb","username":"admin","password":"xxx"}]
 ```
 
-副本集群（注意 `replicaSet` 必填）：
+Replica set (note `replicaSet` is required):
 ```json
 [{"mode":"replicaSet","nodes":[{"host":"10.0.0.1","port":"27017"},{"host":"10.0.0.2","port":"27017"}],"database":"mydb","username":"admin","password":"xxx","replicaSet":"rs0"}]
 ```
 
-分片集群：
+Sharded cluster:
 ```json
 [{"mode":"sharded","nodes":[{"host":"10.0.0.1","port":"27017"},{"host":"10.0.0.2","port":"27017"}],"database":"mydb","username":"admin","password":"xxx"}]
 ```
 
 ---
 
-## 关键规则
+## Key Rules
 
-1. **表名规则**: 写入预置仓时，未指定表名则用 `ods_${来源表名}_${组件名小写}`
-2. **tablePath**: PostgreSQL 用 `模式.表名`，其他组件直接用表名
-3. **预置仓 database 为空**，非预置仓 database 必填
-4. **channelConfig**: 涉及预置仓时必须包含 gatewayConfig
-5. **字段映射**: 每个字段对象必须包含 manual/partitionKey/primaryKey/shardingKey/sortingKey/upsertKey 属性
-6. **条件必填参数**: 部分组件（如 MongoDB）根据 mode 不同有额外必填字段，详见上方「组件条件必填参数」
+1. **Table name rule**: When writing to preset repository, if table name not specified, use `ods_${source_table_name}_${component_name_lowercase}`
+2. **tablePath**: PostgreSQL uses `schema.table_name`, other components use table name directly
+3. **Preset repository database is empty**, non-preset repository database is required
+4. **channelConfig**: Must include gatewayConfig when involving preset repository
+5. **Field mapping**: Each field object must include manual/partitionKey/primaryKey/shardingKey/sortingKey/upsertKey properties
+6. **Conditional required parameters**: Some components (e.g., MongoDB) have additional required fields based on mode, see "Component Conditional Required Parameters" above

package/skills/te-dataops/references/dataops-query.md

@@ -1,111 +1,111 @@
 ---
 name: dataops-query
 version: 1.0.0
-description: "数据探索与 SQL 查询：浏览数仓元数据、搜索表、执行 SQL 查询、获取结果。触发关键词：查询、SQL、数据探索、搜索表、查看表结构、浏览数据、IDE、catalog、select。"
+description: "Data exploration and SQL query: browse data warehouse metadata, search tables, execute SQL queries, get results. Trigger keywords: query, SQL, data exploration, search tables, view table structure, browse data, IDE, catalog, select."
 metadata:
   requires:
-    bins: ["te-cli"]
+    bins: ["ae-cli"]
 ---
 
-# DataOps 数据探索与 SQL 查询
+# DataOps Data Exploration and SQL Query
 
-> **前置条件:** 阅读 [`te-dataops/SKILL.md`](../SKILL.md) 了解通用规则。
+> **Prerequisites:** Read [`te-dataops/SKILL.md`](../SKILL.md) for general rules.
 
-使用 `dataops_ide` 子命令进行数据探索和 SQL 查询。
+Use the `dataops_ide` subcommand for data exploration and SQL queries.
 
-**核心规则：IDE 只允许查询操作，禁止创建/修改/删除数据表（任务表 DDL 请用 dataops_datatable）。**
+**Core Rule: IDE only allows query operations, prohibits creating/modifying/deleting data tables (use dataops_datatable for task table DDL).**
 
 ---
 
-## 工作流 A：浏览数仓元数据
+## Workflow A: Browse Data Warehouse Metadata
 
-逐步探索数据仓库结构：仓库 → catalog → schema → 表 → 列。
+Explore data warehouse structure step by step: repository → catalog → schema → table → column.
 
 ```bash
-# Step 1: 列出可用仓库
-te-cli dataops_ide +list_repos --spaceCode "${spaceCode}"
+# Step 1: List available repositories
+ae-cli dataops_ide +list_repos --spaceCode "${spaceCode}"
 
-# Step 2: 列出仓库下所有 catalog 及其 schema
-te-cli dataops_ide +list_catalogs --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}"
+# Step 2: List all catalogs and their schemas in repository
+ae-cli dataops_ide +list_catalogs --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}"
 
-# Step 3: 列出 schema 下的表/视图
-te-cli dataops_ide +list_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+# Step 3: List tables/views under schema
+ae-cli dataops_ide +list_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
   --catalog "${catalog}" --schema "${schema}" --isView false --pageNum 1 --pageSize 100
 
-# Step 4: 获取表的详细元数据（列定义、DDL、分区、行数）
-te-cli dataops_ide +get_table_detail --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+# Step 4: Get detailed table metadata (column definitions, DDL, partitions, row count)
+ae-cli dataops_ide +get_table_detail --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
   --catalog "${catalog}" --schema "${schema}" --tableName "${tableName}" \
   --engineType "TASK_ENGINE_TRINO" --isView false
 ```
 
 ---
 
-## 工作流 B：搜索并查看表
+## Workflow B: Search and View Tables
 
-当不知道表的确切位置时，通过关键词搜索。
+When you don't know the exact table location, search by keyword.
 
 ```bash
-# 跨 catalog/schema 模糊搜索表
-te-cli dataops_ide +search_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
+# Fuzzy search tables across catalog/schema
+ae-cli dataops_ide +search_tables --spaceCode "${spaceCode}" --connType "SPACE" --repoCode "${repoCode}" \
   --searchKey "user" --size 20
 
-# 跨表模糊搜索列名
-te-cli dataops_ide +search_columns --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
+# Fuzzy search column names across tables
+ae-cli dataops_ide +search_columns --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
   --searchKey "user_id" --tables '[{"catalog":"hive","isView":false,"schema":"ws_default_dev","tableName":"dwd_user"}]' \
   --engineType "TASK_ENGINE_TRINO" --pageNum 1 --pageSize 100
 
-# 根据表名和列名生成 SELECT SQL
-te-cli dataops_ide +generate_sql --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
+# Generate SELECT SQL based on table and column names
+ae-cli dataops_ide +generate_sql --spaceCode "${spaceCode}" --repoCode "${repoCode}" \
   --catalog "hive" --schema "ws_default_dev" --tableName "dwd_user" \
   --engineType "TASK_ENGINE_TRINO" --selectColumns '["user_id","user_name","age"]'
 ```
 
 ---
 
-## 工作流 C：执行 SQL 查询（完整异步流程）
+## Workflow C: Execute SQL Query (Complete Async Flow)
 
-这是最重要的工作流，包含 3 步：执行 → 轮询进度 → 获取结果。
+This is the most important workflow, containing 3 steps: execute → poll progress → get results.
 
 ```bash
-# Step 1: 异步执行 SQL（返回 requestId）
-te-cli dataops_ide +execute_sql --spaceCode "${spaceCode}" --repoCode "te_etl" \
+# Step 1: Execute SQL asynchronously (returns requestId)
+ae-cli dataops_ide +execute_sql --spaceCode "${spaceCode}" --repoCode "te_etl" \
   --sql "SELECT * FROM hive.ws_default_dev.dwd_user LIMIT 10" \
   --engineType "TASK_ENGINE_TRINO" --confirmed true
 
-# Step 2: 查询执行进度（用 Step 1 返回的 requestId，建议 2-5 秒轮询）
-# state 可能值: QUEUED / RUNNING / FINISHED / FAILED / CANCELLED
-te-cli dataops_ide +get_query_progress --requestId "${requestId}"
+# Step 2: Query execution progress (use requestId from Step 1, recommend 2-5 second polling)
+# state values: QUEUED / RUNNING / FINISHED / FAILED / CANCELLED
+ae-cli dataops_ide +get_query_progress --requestId "${requestId}"
 
-# Step 3: state=FINISHED 后，获取查询结果
-# recordId 从查询历史或进度信息中获取
-te-cli dataops_ide +get_query_result --spaceCode "${spaceCode}" --connType "SPACE" \
+# Step 3: After state=FINISHED, get query results
+# recordId obtained from query history or progress info
+ae-cli dataops_ide +get_query_result --spaceCode "${spaceCode}" --connType "SPACE" \
   --repoCode "te_etl" --recordId "${recordId}"
 
-# （可选）取消正在执行的查询
-te-cli dataops_ide +cancel_query --requestId "${requestId}" --confirmed true
+# (Optional) Cancel running query
+ae-cli dataops_ide +cancel_query --requestId "${requestId}" --confirmed true
 ```
 
 ---
 
-## 命令速查
-
-| 命令 | 用途 | 关键 Flags |
-|------|------|-----------|
-| `+list_repos` | 列出仓库 | `--spaceCode` |
-| `+list_catalogs` | 列出 catalog/schema | `--spaceCode` `--connType` `--repoCode` |
-| `+list_tables` | 列出表 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--isView` `--pageNum` `--pageSize` |
-| `+get_table_detail` | 表元数据 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--isView` |
-| `+get_schema_info` | schema 统计 | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` |
-| `+search_tables` | 模糊搜索表 | `--spaceCode` `--connType` `--repoCode` `--searchKey` `--size` |
-| `+search_columns` | 模糊搜索列 | `--spaceCode` `--repoCode` `--searchKey` `--tables` (JSON) `--engineType` `--pageNum` `--pageSize` |
-| `+generate_sql` | 生成 SELECT | `--spaceCode` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--selectColumns` (JSON) |
-| `+execute_sql` | 执行 SQL | `--spaceCode` `--repoCode` `--sql` `--engineType` `--confirmed` |
-| `+get_query_progress` | 查询进度 | `--requestId` |
-| `+get_query_result` | 获取结果 | `--spaceCode` `--connType` `--repoCode` `--recordId` |
-| `+cancel_query` | 取消查询 | `--requestId` `--confirmed` |
-
-## 参数说明
-
-- **connType**: `SPACE`（数据仓库日常查询，默认）| `ETL`（ETL 引擎）| `APP`（应用仓对外服务）
-- **engineType**: `TASK_ENGINE_TRINO`（默认，交互式查询）| `TASK_ENGINE_STARROCKS`（实时分析、高并发）
-- **isView**: `false` 查物理表 | `true` 查视图
+## Command Quick Reference
+
+| Command | Purpose | Key Flags |
+|---------|---------|-----------|
+| `+list_repos` | List repositories | `--spaceCode` |
+| `+list_catalogs` | List catalog/schema | `--spaceCode` `--connType` `--repoCode` |
+| `+list_tables` | List tables | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--isView` `--pageNum` `--pageSize` |
+| `+get_table_detail` | Table metadata | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--isView` |
+| `+get_schema_info` | Schema statistics | `--spaceCode` `--connType` `--repoCode` `--catalog` `--schema` |
+| `+search_tables` | Fuzzy search tables | `--spaceCode` `--connType` `--repoCode` `--searchKey` `--size` |
+| `+search_columns` | Fuzzy search columns | `--spaceCode` `--repoCode` `--searchKey` `--tables` (JSON) `--engineType` `--pageNum` `--pageSize` |
+| `+generate_sql` | Generate SELECT | `--spaceCode` `--repoCode` `--catalog` `--schema` `--tableName` `--engineType` `--selectColumns` (JSON) |
+| `+execute_sql` | Execute SQL | `--spaceCode` `--repoCode` `--sql` `--engineType` `--confirmed` |
+| `+get_query_progress` | Query progress | `--requestId` |
+| `+get_query_result` | Get results | `--spaceCode` `--connType` `--repoCode` `--recordId` |
+| `+cancel_query` | Cancel query | `--requestId` `--confirmed` |
+
+## Parameter Notes
+
+- **connType**: `SPACE` (data warehouse for daily queries, default) | `ETL` (ETL engine) | `APP` (app warehouse for external services)
+- **engineType**: `TASK_ENGINE_TRINO` (default, interactive queries) | `TASK_ENGINE_STARROCKS` (real-time analytics, high concurrency)
+- **isView**: `false` for physical tables | `true` for views