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

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

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

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.10}/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.10}/opscli/skills/templates/ops-dataset-query/SKILL.md

@@ -76,7 +76,7 @@ opscli auth token status
 |------|------|------|
 | `data/VERSION.json` | 版本号 | `{"name": "ops-dataset-query", "version": "v1.x.x"}` |
 | `data/dataset_fields.csv` | 字段明细 | dataset_alias、field_name、verbose_name、global_alias、field_type、formula_config、detail_expression、summary_expression 等 |
-| `data/datasets.csv` | 数据集列表 | table_id、dataset_alias、dataset_name、dataset_type、dataset_category、description、keywords 等 |
+| `data/datasets.csv` | 数据集列表 | table_id、dataset_alias、dataset_name、dataset_type、dataset_category、data_source、main_dttm_col、inner_where_enabled、cache_timeout、description |
 | `data/query_metadata.json` | 查询元数据 | 字段类型映射、可用聚合方式等 |
 
 CSV 各列详细说明见 `references/数据查询服务开发说明文档.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" }`
@@ -326,7 +329,7 @@ opscli skills upgrade ops-dataset-query --force
 
 ## 字段搜索（本地索引）
 
-本 Skill 内置本地字段索引，可用于辅助确认 `dataset_alias`、`field_name`、`verbose_name`、`keywords`。
+本 Skill 内置本地字段索引，可用于辅助确认 `dataset_alias`、`field_name`、`verbose_name`。
 
 **推荐流程**：本地索引确认字段名 → `opscli query metadata` 查看完整 metadata → `opscli query build` 或手写 payload + `opscli query run`
 
@@ -339,7 +342,6 @@ opscli skills upgrade ops-dataset-query --force
 | `field_name` 子串匹配 | 60 |
 | `verbose_name` 子串匹配 | 45 |
 | `dataset_alias` 精确匹配 | 40 |
-| `keywords` 子串匹配 | 35 |
 | `description` 子串匹配 | 10 |
 
 ---

aukeys_opscli-0.0.10/opscli/skills/templates/ops-dataset-query/data/datasets.csv

@@ -0,0 +1 @@
+table_id,dataset_alias,dataset_name,dataset_type,dataset_category,data_source,main_dttm_col,inner_where_enabled,cache_timeout,description

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.10}/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.10}/opscli/skills/templates/ops-dataset-query/scripts/core.py

@@ -57,7 +57,6 @@ def search_rows(rows: list[dict], keyword: str, limit: int = 10) -> list[dict]:
     排序策略使用简单加权打分，优先匹配：
     - `field_name`
     - `verbose_name`
-    - `keywords`
     - `description`
     - 其他整行内容
     """
@@ -97,7 +96,6 @@ def _score_row(row: dict, keyword: str, tokens: list[str]) -> int:
     field_name = str(row.get("field_name", "")).lower()
     verbose_name = str(row.get("verbose_name", "")).lower()
     global_alias = str(row.get("global_alias", "")).lower()
-    keywords = str(row.get("keywords", "")).lower()
     description = str(row.get("description", "")).lower()
     dataset_alias = str(row.get("dataset_alias", "")).lower()
     dataset_name = str(row.get("dataset_name", "")).lower()
@@ -122,8 +120,6 @@ def _score_row(row: dict, keyword: str, tokens: list[str]) -> int:
         score += 55
     if keyword in verbose_name:
         score += 45
-    if keyword in keywords:
-        score += 35
     if keyword in dataset_name:
         score += 20
     if keyword in description:
@@ -133,7 +129,6 @@ def _score_row(row: dict, keyword: str, tokens: list[str]) -> int:
     score += _token_match_score(field_name, tokens, 16)
     score += _token_match_score(global_alias, tokens, 14)
     score += _token_match_score(verbose_name, tokens, 12)
-    score += _token_match_score(keywords, tokens, 9)
     score += _token_match_score(dataset_name, tokens, 6)
     score += _token_match_score(description, tokens, 4)
     score += _token_match_score(fulltext, tokens, 2)

{aukeys_opscli-0.0.8 → aukeys_opscli-0.0.10}/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.10}/pyproject.toml

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

aukeys_opscli-0.0.8/opscli/skills/templates/ops-dataset-query/data/datasets.csv

@@ -1 +0,0 @@
-table_id,dataset_alias,dataset_name,dataset_type,dataset_category,from_table,database,data_source,main_dttm_col,inner_where_enabled,permission,cache_timeout,description,keywords