data-ops-cli 0.2.1__tar.gz → 0.2.3__tar.gz

{data_ops_cli-0.2.1 → data_ops_cli-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.2.1
+Version: 0.2.3
 Requires-Python: <3.14,>=3.11
 Requires-Dist: requests
 Requires-Dist: pydantic-core

{data_ops_cli-0.2.1 → data_ops_cli-0.2.3}/src/data_ops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.2.1
+Version: 0.2.3
 Requires-Python: <3.14,>=3.11
 Requires-Dist: requests
 Requires-Dist: pydantic-core

{data_ops_cli-0.2.1 → data_ops_cli-0.2.3}/src/data_ops_cli.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ src/dataops_cli/cli/auth.py
 src/dataops_cli/cli/data_table.py
 src/dataops_cli/cli/dataset.py
 src/dataops_cli/cli/datasource.py
+src/dataops_cli/cli/dict_.py
 src/dataops_cli/cli/factory.py
 src/dataops_cli/cli/metrics.py
 src/dataops_cli/cli/ref.py
@@ -44,19 +45,24 @@ src/dataops_cli/runner/utils/log.py
 src/dataops_cli/runner/utils/nacos.py
 src/dataops_cli/runner/utils/neo4j_sync.py
 src/dataops_cli/schems/__init__.py
+src/dataops_cli/schems/data_table.py
 src/dataops_cli/schems/datasource.py
+src/dataops_cli/schems/dict_.py
 src/dataops_cli/schems/enums.py
 src/dataops_cli/schems/group.py
 src/dataops_cli/schems/meta.py
 src/dataops_cli/schems/query.py
 src/dataops_cli/schems/report.py
+src/dataops_cli/schems/table.py
 src/dataops_cli/schems/user.py
 src/dataops_cli/schems/widget.py
 src/dataops_cli/schems/workflow.py
 src/dataops_cli/sdk/__init__.py
 src/dataops_cli/sdk/auth.py
 src/dataops_cli/sdk/data_table.py
+src/dataops_cli/sdk/dataset.py
 src/dataops_cli/sdk/datasource.py
+src/dataops_cli/sdk/dict_.py
 src/dataops_cli/sdk/meta.py
 src/dataops_cli/sdk/ref.py
 src/dataops_cli/sdk/report.py

data_ops_cli-0.2.3/src/dataops_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.3"

{data_ops_cli-0.2.1 → data_ops_cli-0.2.3}/src/dataops_cli/cli/auth.py

@@ -12,7 +12,6 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from dataops_cli.cli.datasource import get_datasource_config
 from dataops_cli.constants import USER_INFO_FILE
 from dataops_cli.exceptions import AuthenticationError
 from dataops_cli.schems import UserInfo
@@ -23,6 +22,7 @@ from dataops_cli.sdk.auth import (
     service_logout,
     service_set_application,
 )
+from dataops_cli.sdk.datasource import get_application_datasource_config
 from dataops_cli.utils import get_work_dir
 
 auth_typer = typer.Typer(name="auth", help="认证相关命令", no_args_is_help=True)
@@ -43,14 +43,30 @@ def auth_status() -> None:
         print("未登录")
     else:
         user_info = UserInfo.model_validate_json(target_path.read_bytes())
-
-    # application
-    application = service_get_current_application()
-    if application is None:
-        print(f"用户 `{user_info.user_name}` 已登录, 应用未设置")
+    try:
+        # application
+        application = service_get_current_application()
+        datasource_config = get_application_datasource_config()
+    except AuthenticationError:
+        print(f"{user_info.true_name}({user_info.user_name})登录过期，请重新登录")
     else:
-        print(f"用户 `{user_info.user_name}` 已登录, 应用设置为 `{application.CODE}`")
-        get_datasource_config()
+        if application is None:
+            print(f"{user_info.true_name}({user_info.user_name})已登录, 应用未设置")
+        else:
+            print(
+                f"{user_info.true_name}({user_info.user_name})已登录, 应用设置为{application.LABEL_CN}({application.CODE})"
+            )
+
+        table = Table(
+            "datasource",
+            "功能",
+            title=f"应用数据源配置\n{application.LABEL_CN}({application.CODE})",
+        )
+        table.add_row(datasource_config.main.name, "主数据源")
+        table.add_row(datasource_config.hazard_read.name, "隐患读数据源")
+        table.add_row(datasource_config.hazard_write.name, "隐患写数据源")
+        console = Console(no_color=True)
+        console.print(table)
 
 
 @auth_typer.command("login", no_args_is_help=True)

data_ops_cli-0.2.3/src/dataops_cli/cli/data_table.py

@@ -0,0 +1,260 @@
+"""多维表格 (DataTable) CLI 命令模块.
+
+提供多维表格的列表查询和详情功能。
+"""
+
+from __future__ import annotations
+
+from typing import Annotated, Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from dataops_cli.cli.utils import render_table
+from dataops_cli.exceptions import DataOpsError
+from dataops_cli.schems import MetaType, PageParam, SqlQueryParam
+from dataops_cli.sdk import (
+    service_get_data_table_by_code,
+    service_get_data_table_by_name,
+    service_get_data_table_data_by_code,
+    service_get_data_table_data_by_name,
+)
+from dataops_cli.sdk.meta import release_list_list
+from dataops_cli.utils import filter_nodes_by_pattern
+
+# ---------------------------------------------------------------------------
+# CLI 命令
+# ---------------------------------------------------------------------------
+
+data_table_typer = typer.Typer(
+    name="data_table",
+    help="多维表格相关",
+    no_args_is_help=True,
+)
+
+
+@data_table_typer.command("list")
+def list_datatable(
+    datasource: Annotated[str | None, typer.Argument(help="数据源")] = None,
+    query: Annotated[str | None, typer.Option("-q", "--query", help="正则表达式")] = None,
+) -> None:
+    """列出所有多维表格.
+
+    从元数据服务获取多维表格列表，支持通过正则表达式按名称、标题或备注进行过滤。
+
+    示例:
+        列出所有多维表格
+        >>> data-ops-cli data_table list
+
+        按数据源过滤
+        >>> data-ops-cli data_table list my_datasource
+
+        按名称/标题/备注过滤
+        >>> data-ops-cli data_table list --query ".*报表.*"
+        >>> data-ops-cli data_table list -q "日报"
+    """
+    try:
+        group_nodes = release_list_list(MetaType.DATA_TABLE, datasource=datasource)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if query:
+        group_nodes = filter_nodes_by_pattern(group_nodes, query, include_digest=True)
+
+    table = Table("code", "title", "remark")
+    console = Console(no_color=True)
+    for column in group_nodes:
+        table.add_row(column.CODE, column.TITLE, column.REMARK or "")
+    console.print(table)
+
+
+@data_table_typer.command("detail", no_args_is_help=True)
+def get_datatable_detail(
+    arg1: Annotated[str, typer.Argument(help="编码或数据源")],
+    name: Annotated[Optional[str], typer.Argument(help="表名")] = None,
+) -> None:
+    """获取多维表格的完整详情.
+
+    根据多维表格编码获取详细信息，包括字段定义、模型配置、查询配置等。
+    支持通过 --field 选项输出指定字段。
+
+    示例:
+        获取多维表格完整信息
+        >>> data-ops-cli data_table detail dt_code_001
+
+        只输出字段列表 (fields)
+        >>> data-ops-cli data_table detail dt_code_001 --field data.fields
+
+        输出指定字段的 JSON
+        >>> data-ops-cli data_table detail dt_code_001 -f data
+    """
+    try:
+        meta = (
+            service_get_data_table_by_name(arg1, name)
+            if name
+            else service_get_data_table_by_code(arg1)
+        )
+    except DataOpsError as e:
+        typer.echo(e.message)
+        raise typer.Exit(code=1) from None
+
+    table = Table("field", "value", show_header=False)
+    table.add_row("datasource", meta.data.model.datasource)
+    table.add_row("引用类型", meta.data.model.ref_type)
+    table.add_row("引用编码", meta.data.model.ref_code)
+    table.add_row("引用表名", meta.data.model.table_name)
+
+    console = Console(no_color=True)
+    console.print(table)
+
+    table = Table("column(visable)", "type", "title", "visible", title="字段")
+    for field in meta.data.fields:
+        table.add_row(field.name + f"({'√' if field.visible else 'x'})", field.type, field.title)
+    console.print(table)
+
+    # TODO 完善输出
+
+
+# @data_table_typer.command("create", no_args_is_help=True)
+# def create_datatable(
+#     code: Annotated[str, typer.Argument(help="多维表格编码")],
+#     title: Annotated[str, typer.Argument(help="中文标题")],
+#     data_file: Annotated[
+#         str,
+#         typer.Argument(
+#             help="meta.data JSON 文件路径或 JSON 字符串 (以 { 开头视为 JSON, 否则视为文件路径)"
+#         ),
+#     ],
+#     remark: Annotated[str | None, typer.Option("-r", "--remark", help="备注")] = None,
+# ) -> None:
+#     """创建多维表格.
+
+#     从本地 JSON 文件读取 meta.data 配置并创建多维表格。
+
+#     示例:
+#         从文件创建
+#         >>> data-ops-cli data_table create dt_code_001 "测试表格" ./data_table.json
+
+#         直接传入 JSON 字符串
+#         >>> data-ops-cli data_table create dt_code_001 "测试表格" '{"model": {...}, "fields": [...]}'
+#     """
+#     # 解析 data: 可能是文件路径或 JSON 字符串
+#     data: dict
+#     if data_file.strip().startswith("{"):
+#         try:
+#             data = json.loads(data_file)
+#         except json.JSONDecodeError as e:
+#             typer.echo(f"错误: JSON 解析失败: {e}")
+#             raise typer.Exit(code=1) from None
+#     else:
+#         path = Path(data_file)
+#         if not path.exists():
+#             typer.echo(f"错误: 文件不存在: {data_file}")
+#             raise typer.Exit(code=1) from None
+#         try:
+#             data = json.loads(path.read_text(encoding="utf-8"))
+#         except json.JSONDecodeError as e:
+#             typer.echo(f"错误: JSON 文件解析失败: {e}")
+#             raise typer.Exit(code=1) from None
+
+#     try:
+#         result = service_create_data_table(code=code, title=title, data=data)
+#         cuid = result.get("cuid", "") if isinstance(result, dict) else ""
+#         typer.echo(f"成功创建多维表格: code={code}, cuid={cuid}")
+#     except DataOpsError as e:
+#         typer.echo(f"错误: {e.message}")
+#         raise typer.Exit(code=1) from None
+
+
+# @data_table_typer.command("update", no_args_is_help=True)
+# def update_datatable(
+#     code: Annotated[str, typer.Argument(help="多维表格编码")],
+#     title: Annotated[str, typer.Argument(help="中文标题")],
+#     data_file: Annotated[
+#         str,
+#         typer.Argument(help="meta.data JSON 文件路径或 JSON 字符串"),
+#     ],
+#     cuid: Annotated[
+#         str | None, typer.Option("-c", "--cuid", help="元数据 CUID (更新时必传)")
+#     ] = None,
+# ) -> None:
+#     """更新多维表格.
+
+#     从本地 JSON 文件读取 meta.data 配置并更新多维表格。
+#     需要通过 --cuid 指定要更新的元数据 CUID。
+
+#     示例:
+#         从文件更新
+#         >>> data-ops-cli data_table update dt_code_001 "测试表格" ./data_table.json --cuid abc123
+
+#         直接传入 JSON 字符串
+#         >>> data-ops-cli data_table update dt_code_001 "测试表格" '{"model": {...}, "fields": [...]}' -c abc123
+#     """
+#     if not cuid:
+#         typer.echo("错误: 更新操作需要 --cuid 参数，请先通过 detail 命令获取 CUID")
+#         raise typer.Exit(code=1) from None
+
+#     # 解析 data: 可能是文件路径或 JSON 字符串
+#     data: dict
+#     if data_file.strip().startswith("{"):
+#         try:
+#             data = json.loads(data_file)
+#         except json.JSONDecodeError as e:
+#             typer.echo(f"错误: JSON 解析失败: {e}")
+#             raise typer.Exit(code=1) from None
+#     else:
+#         path = Path(data_file)
+#         if not path.exists():
+#             typer.echo(f"错误: 文件不存在: {data_file}")
+#             raise typer.Exit(code=1) from None
+#         try:
+#             data = json.loads(path.read_text(encoding="utf-8"))
+#         except json.JSONDecodeError as e:
+#             typer.echo(f"错误: JSON 文件解析失败: {e}")
+#             raise typer.Exit(code=1) from None
+
+#     try:
+#         service_update_data_table(code=code, title=title, data=data, cuid=cuid)
+#         typer.echo(f"成功更新多维表格: code={code}, cuid={cuid}")
+#     except DataOpsError as e:
+#         typer.echo(f"错误: {e.message}")
+#         raise typer.Exit(code=1) from None
+
+
+@data_table_typer.command("data", no_args_is_help=True)
+def get_datatable_data(
+    arg1: Annotated[str, typer.Argument(help="编码或数据源")],
+    name: Annotated[Optional[str], typer.Argument(help="表名")] = None,
+    page: Annotated[int, typer.Option("--page", "-p", min=0, help="耶稣")] = 0,
+    size: Annotated[int, typer.Option("--size", "-l", min=0, help="单页数")] = 20,
+    query_param: Annotated[
+        str | None, typer.Option("--query", "-q", help="查询参数(SqlQueryParam)")
+    ] = None,
+) -> None:
+    """获取多维表格数据.
+
+    示例:
+        >>> data-ops-cli data_table data dt_code_001
+    """
+    pp = PageParam(start=page, limit=size)
+    qp = SqlQueryParam.model_validate_json(query_param) if query_param else SqlQueryParam()
+
+    try:
+        data = (
+            service_get_data_table_data_by_name(arg1, name, pp, qp)
+            if name
+            else service_get_data_table_data_by_code(arg1, pp, qp)
+        )
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    if not data:
+        print("未查询到数据")
+        return
+    print(render_table(data))
+
+
+if __name__ == "__main__":
+    list_datatable()

{data_ops_cli-0.2.1 → data_ops_cli-0.2.3}/src/dataops_cli/cli/dataset.py

@@ -5,9 +5,7 @@ from rich.console import Console
 from rich.table import Table
 
 from dataops_cli.exceptions import DataOpsError
-from dataops_cli.schems.datasource import MetaDataSourceDDL
-from dataops_cli.schems.enums import MetaType
-from dataops_cli.sdk.meta import release_list_get_by_code, release_list_list
+from dataops_cli.sdk import service_get_dataset_detail_by_code, service_list_datasets
 from dataops_cli.utils import filter_nodes_by_pattern
 
 dataset_typer = typer.Typer(name="dataset", help="Manage dataset.", no_args_is_help=True)
@@ -29,7 +27,7 @@ def list_dataset(
         >>> data-ops-cli dataset list "HHI.*"
     """
     try:
-        group_nodes = release_list_list(MetaType.DATASET.value)
+        group_nodes = service_list_datasets()
     except DataOpsError as e:
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None
@@ -62,7 +60,7 @@ def get_dataset_detail_by_code(
         >>> data-ops-cli dataset detail my_dataset_code --full
     """
     try:
-        meta = release_list_get_by_code(MetaType.DATASET.value, code, _class=MetaDataSourceDDL)
+        meta = service_get_dataset_detail_by_code(code)
     except DataOpsError as e:
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None

data_ops_cli-0.2.3/src/dataops_cli/cli/datasource.py

@@ -0,0 +1,196 @@
+"""数据源管理模块.
+
+提供数据源、表、数据集的查询和管理功能。
+
+- 服务层函数 (service_*)：纯 Python 接口，返回原始数据，可供 agent 自由组合
+- CLI 命令：基于服务层的薄包装，负责格式化输出
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from dataops_cli.exceptions import DataOpsError
+from dataops_cli.schems import (
+    DataDataSource,
+    InnerMetaType,
+    MetaCreate,
+    MetaUpdate,
+)
+from dataops_cli.schems.enums import DataSourceType
+from dataops_cli.sdk.datasource import get_application_datasource_config, get_datasource
+from dataops_cli.sdk.meta import (
+    release_list_create,
+    release_list_get_by_name,
+    release_list_list,
+    release_list_update,
+)
+from dataops_cli.sdk.table import (
+    service_get_table_data_by_name,
+)
+from dataops_cli.session import get_application
+from dataops_cli.utils import filter_nodes_by_pattern
+
+# ---------------------------------------------------------------------------
+# CLI 命令（薄包装，负责输出渲染）
+# ---------------------------------------------------------------------------
+
+datasource_typer = typer.Typer(name="datasource", help="Manage data sources.", no_args_is_help=True)
+
+
+@datasource_typer.command("config")
+def get_datasource_config() -> None:
+    """显示当前应用的数据库源配置信息.
+
+    展示应用关联的三个核心数据源:
+    - 主数据源: 默认读写数据源
+    - 隐患读数据源: 隐患业务只读数据源
+    - 隐患写数据源: 隐患业务只写数据源
+
+    示例:
+        # 显示当前应用的数据源配置
+        >>> data-ops-cli datasource config
+    """
+    application = get_application()
+    datasource_config = get_application_datasource_config(application.CUID)
+    table = Table(
+        "name", "功能", title=f"应用数据源配置\n{application.LABEL_CN}({application.CODE})"
+    )
+    table.add_row(datasource_config.main.name, "主数据源")
+    table.add_row(datasource_config.hazard_read.name, "隐患读数据源")
+    table.add_row(datasource_config.hazard_write.name, "隐患写数据源")
+    console = Console(no_color=True)
+    console.print(table)
+
+
+@datasource_typer.command("list")
+def list_datasource(
+    query: Annotated[str | None, typer.Option("-q", "--query", help="正则表达式查询")] = None,
+) -> None:
+    """列出所有已注册的数据源.
+
+    从元数据服务获取所有数据源节点，支持通过正则表达式过滤数据源名称。
+
+    参数:
+        query: 可选的正则表达式，用于过滤返回的数据源列表
+
+    示例:
+        # 列出所有数据源
+        >>> data-ops-cli datasource list
+
+        # 通过正则过滤数据源
+        >>> data-ops-cli datasource list -q "doris.*"
+
+        # 完整参数名形式
+        >>> data-ops-cli datasource list --query zhwg
+    """
+    try:
+        group_nodes = release_list_list(InnerMetaType.DATASOURCE.value)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if query:
+        group_nodes = filter_nodes_by_pattern(group_nodes, query, include_digest=True)
+
+    table = Table("name", "alias", "remark")
+    console = Console(no_color=True)
+    for column in group_nodes:
+        table.add_row(column.NAME, column.TITLE, column.REMARK or "")
+    console.print(table)
+
+
+@datasource_typer.command("detail")
+def get_datasource_detail(
+    name: Annotated[str, typer.Argument(help="数据源名称")],
+) -> None:
+    """获取指定数据源的详细信息.
+
+    Args:
+        name: 数据源名称
+    """
+    meta = release_list_get_by_name(InnerMetaType.DATASOURCE.value, name, _class=DataDataSource)
+    table = Table("field", "value", show_header=False)
+    table.add_row("name", meta.name)
+    table.add_row("title", meta.title)
+    table.add_row("分组", meta.groupCode)
+    table.add_row("数据库类型", meta.data.type.value)
+    table.add_row("地址", meta.data.ip)
+    table.add_row("端口", str(meta.data.port))
+    table.add_row("数据库账户", meta.data.username)
+    table.add_row("说明", meta.remark or "")
+    console = Console(no_color=True)
+    console.print(table)
+
+
+@datasource_typer.command("create", no_args_is_help=True)
+def create_datasource(
+    name: Annotated[str, typer.Option(help="数据源名称")],
+    title: Annotated[str, typer.Option(help="数据源中文名称")],
+    type: Annotated[DataSourceType, typer.Option("-t", "--type", help="数据源类型")],
+    ip: Annotated[str, typer.Option(help="数据源 IP 地址")],
+    port: Annotated[int, typer.Option("-p", "--port", help="数据源端口号")],
+    username: Annotated[str, typer.Option("-u", "--username", help="数据源用户名")],
+    password: Annotated[str, typer.Option(help="数据源密码", hide_input=True)],
+    database: Annotated[str, typer.Option("-db", "--database", help="数据库名称")],
+    remark: Annotated[str | None, typer.Option(help="数据源备注")] = None,
+) -> None:
+    """创建新的数据源."""
+    meta_create = MetaCreate[DataDataSource](
+        type="datasource",
+        subType=f"database__{type.value}",
+        name=name,
+        title=title,
+        remark=remark,
+        groupCode="inner",
+        data=DataDataSource(
+            type=type, ip=ip, port=port, username=username, password=password, database=database
+        ),
+    )
+    result = release_list_create(meta_create, _class=DataDataSource)
+    typer.echo(f"数据源 {result.name} 创建成功")
+
+
+@datasource_typer.command("update", no_args_is_help=True)
+def update_datasource(
+    name: Annotated[str, typer.Argument(help="数据源名称")],
+    title: Annotated[str | None, typer.Option(help="数据源中文名称")] = None,
+    type: Annotated[DataSourceType | None, typer.Option("-t", "--type", help="数据源类型")] = None,
+    ip: Annotated[str | None, typer.Option(help="数据源 IP 地址")] = None,
+    port: Annotated[int | None, typer.Option("-p", "--port", help="数据源端口号")] = None,
+    username: Annotated[str | None, typer.Option("-u", "--username", help="数据源用户名")] = None,
+    password: Annotated[str | None, typer.Option(help="数据源密码", hide_input=True)] = None,
+    database: Annotated[str | None, typer.Option("-db", "--database", help="数据库名称")] = None,
+    remark: Annotated[str | None, typer.Option(help="数据源备注")] = None,
+) -> None:
+    """更新已有的数据源."""
+    meta = release_list_get_by_name(InnerMetaType.DATASOURCE.value, name, _class=DataDataSource)
+    if type:
+        meta.data.type = type
+        meta.subType = f"database__{type.value}"
+    if title:
+        meta.title = title
+    if ip:
+        meta.data.ip = ip
+    if port:
+        meta.data.port = port
+    if username:
+        meta.data.username = username
+    if password:
+        meta.data.password = password
+    if database:
+        meta.data.database = database
+    if remark:
+        meta.remark = remark
+
+    result = release_list_update(meta, _class=DataDataSource)
+    typer.echo(f"数据源 {result.name} 更新成功")
+
+
+if __name__ == "__main__":
+    print(DataDataSource.model_json_schema())
+    # list_datasource("doris")

data_ops_cli-0.2.3/src/dataops_cli/cli/dict_.py

@@ -0,0 +1,96 @@
+from typing import Annotated, Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from dataops_cli.exceptions import DataOpsError
+from dataops_cli.sdk.dict_ import (
+    service_get_dict_detail_by_code,
+    service_get_dict_detail_by_name,
+    service_list_dicts,
+)
+from dataops_cli.utils import filter_nodes_by_pattern
+
+dict_typer = typer.Typer(name="dict", help="Manage dict.", no_args_is_help=True)
+
+
+@dict_typer.command("list")
+def list_dict(
+    datasource: Annotated[str, typer.Argument(help="数据源")],
+    query: Annotated[str | None, typer.Argument(help="字典名称关键字")] = None,
+) -> None:
+    """列出数据源中的字典列表.
+
+    支持通过关键字过滤字典名称，并支持正则表达式匹配。
+
+    示例:
+        # 列出指定数据源的所有字典
+        >>> data-ops-cli dict list <datasource>
+
+        # 列出数据源中名称包含 "user" 的字典
+        >>> data-ops-cli dict list <datasource> user
+
+        # 使用正则过滤字典名
+        >>> data-ops-cli dict list <datasource> "^user_.*"
+    """
+    try:
+        group_nodes = service_list_dicts(datasource)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not group_nodes:
+        print("未查询到匹配字典")
+        return
+
+    if query:
+        group_nodes = filter_nodes_by_pattern(group_nodes, query)
+
+    table = Table("code", "name", "alias", "remark", title="dict list")
+    console = Console(no_color=True)
+    for column in group_nodes:
+        table.add_row(column.CODE, column.NAME, column.TITLE)
+    console.print(table)
+
+
+@dict_typer.command("detail", no_args_is_help=True)
+def get_dict_detail(
+    arg1: Annotated[str, typer.Argument(help="编码或数据源")],
+    name: Annotated[Optional[str], typer.Argument(help="字典名称")] = None,
+    full: Annotated[bool, typer.Option("--full", help="是否显示完整信息")] = False,
+) -> None:
+    """获取字典详情信息.
+
+    支持两种查询方式:
+    1. 通过字典编码(CODE)直接查询
+    2. 通过数据源名称和字典名称组合查询
+
+    默认只显示字典选项的基本信息(label/value)。
+    使用 --full 选项可显示完整信息。
+
+    示例:
+        # 通过字典编码查询字典结构
+        >>> data-ops-cli dict detail dict_code_123
+
+        # 通过数据源和字典名查询
+        >>> data-ops-cli dict detail <datasource> my_dict
+
+        # 显示完整的字典信息
+        >>> data-ops-cli dict detail <datasource> my_dict --full
+    """
+    try:
+        meta = (
+            service_get_dict_detail_by_name(arg1, name)
+            if name
+            else service_get_dict_detail_by_code(arg1)
+        )
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    console = Console(no_color=True)
+    table = Table("value", "label", title=f"{arg1} {meta.name} dict")
+    for option in meta.data.options:
+        table.add_row(str(option.value), option.label)
+    console.print(table)