aukeys-opscli 0.0.8__tar.gz → 0.0.9__tar.gz

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aukeys-opscli
-Version: 0.0.8
+Version: 0.0.9
 Summary: Aukeys 运营 CLI 工具集
 Requires-Python: >=3.10
 Requires-Dist: cryptography>=38

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/opscli/query/commands/cli.py

@@ -87,8 +87,16 @@ def run(
 def build(
     dataset: str | None = typer.Option(None, "--dataset", help="dataset_alias"),
     table_id: int | None = typer.Option(None, "--table-id", help="table_id"),
-    dimension: list[str] | None = typer.Option(None, "--dimension", help="维度定义：field_name|global_alias|verbose_name[:alias]"),
-    metric: list[str] | None = typer.Option(None, "--metric", help="指标定义：field_name|global_alias|verbose_name:aggregation[:alias]"),
+    dimension: list[str] | None = typer.Option(
+        None,
+        "--dimension",
+        help="维度定义：field_name|global_alias|verbose_name[:alias]；alias 仅支持英文/数字/下划线，省略时默认优先使用 global_alias",
+    ),
+    metric: list[str] | None = typer.Option(
+        None,
+        "--metric",
+        help="指标定义：field_name|global_alias|verbose_name:aggregation[:alias]；alias 仅支持英文/数字/下划线，省略时默认优先使用 global_alias",
+    ),
     where: list[str] | None = typer.Option(None, "--where", help="筛选条件：field|operator|value_json，可重复"),
     where_json: str | None = typer.Option(None, "--where-json", help="where JSON 字符串"),
     where_file: str | None = typer.Option(None, "--where-file", help="where JSON 文件路径"),

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/opscli/skills/templates/ops-dataset-query/SKILL.md

@@ -132,14 +132,16 @@ opscli query metadata --table-id 123 --pretty
 #### 参数格式
 
 **dimension**：`field_name|global_alias|verbose_name[:alias]`
-- `date_id` → 按 date_id 分组
-- `date_id:日期` → 按 date_id 分组，列名改为"日期"
+- `date_id` → 按 date_id 分组，默认优先使用字段的 `global_alias` 作为输出列名
+- `date_id:f_date_id` → 按 date_id 分组，列名改为 `f_date_id`
 
 **metric**：`field_name|global_alias|verbose_name:aggregation[:alias]`
 - `order_cost:sum` → 求和
 - `order_cost:sum:total_cost` → 求和，列名改为 total_cost
 - `order_id:count_distinct:uv` → 去重计数
 
+> `select.alias` 不支持中文；如果不显式传 alias，`opscli query build` 会优先使用字段 metadata 中的 `global_alias`，没有时再回退到 `field_name`。
+
 > 完整聚合函数列表见 `references/数据查询服务开发说明文档.md` 第八章。
 
 **公式指标特殊规则**
@@ -157,6 +159,7 @@ opscli query metadata --table-id 123 --pretty
 - 明细查询：使用 `detail_expression`
 - 聚合 / 分组查询：使用 `summary_expression`
 - 如果公式字段继续写成 `field_name + aggregation`，容易出现二次聚合或语义错误
+- 显式传 alias 时，只允许英文、数字和下划线，且不能以数字开头；中文 alias 会被拒绝
 
 **常见易错对照**
 - 普通求和指标：`price:sum` 或手写 `{ "expr": "ds_xxx.price", "alias": "f_price", "aggregation": "SUM" }`

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/opscli/skills/templates/ops-dataset-query/references//346/225/260/346/215/256/346/237/245/350/257/242/346/234/215/345/212/241/345/274/200/345/217/221/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -95,7 +95,7 @@ Python API 支持两种认证方式（二选一）：
     "select": [
       {
         "expr": "string",         // 字段表达式或完整计算表达式（必填）
-        "alias": "string",        // 字段别名，格式为 f_[随机哈希]（必填）
+        "alias": "string",        // 字段别名（必填）。仅支持英文/数字/下划线且不能以数字开头，推荐直接使用字段 metadata 中的 global_alias，不支持中文别名
         "aggregation": "string"   // 聚合函数（可选），如 SUM/COUNT/AVG/MAX/MIN/DISTINCT_COUNT
       }
     ],

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/opscli/skills/templates/ops-dataset-query/scripts/query.py

@@ -116,8 +116,16 @@ def main() -> None:
     build = subparsers.add_parser("build")
     build.add_argument("--dataset", help="dataset_alias")
     build.add_argument("--table-id", type=int, help="table_id")
-    build.add_argument("--dimension", action="append", help="维度定义：field_name|global_alias|verbose_name[:alias]")
-    build.add_argument("--metric", action="append", help="指标定义：field_name|global_alias|verbose_name:aggregation[:alias]")
+    build.add_argument(
+        "--dimension",
+        action="append",
+        help="维度定义：field_name|global_alias|verbose_name[:alias]；alias 仅支持英文/数字/下划线，省略时默认优先使用 global_alias",
+    )
+    build.add_argument(
+        "--metric",
+        action="append",
+        help="指标定义：field_name|global_alias|verbose_name:aggregation[:alias]；alias 仅支持英文/数字/下划线，省略时默认优先使用 global_alias",
+    )
     build.add_argument("--where", action="append", help="筛选条件：field|operator|value_json，可重复")
     build.add_argument("--where-json", help="where JSON 字符串")
     build.add_argument("--where-file", help="where JSON 文件路径")

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aukeys-opscli"
-version = "0.0.8"
+version = "0.0.9"
 description = "Aukeys 运营 CLI 工具集"
 readme = "README.md"
 requires-python = ">=3.10"