data-ops-cli 0.4.1__tar.gz → 0.4.3__tar.gz

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.1
+Version: 0.4.3
 Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/data_ops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.1
+Version: 0.4.3
 Summary: Command-line wrapper around dataops_sdk for the DataOps platform.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/data_ops_cli.egg-info/SOURCES.txt

@@ -24,11 +24,13 @@ src/dataops_cli/cli/datasource.py
 src/dataops_cli/cli/dict_.py
 src/dataops_cli/cli/factory.py
 src/dataops_cli/cli/hazard.py
+src/dataops_cli/cli/kb.py
 src/dataops_cli/cli/metrics.py
 src/dataops_cli/cli/ref.py
 src/dataops_cli/cli/report.py
 src/dataops_cli/cli/skill.py
 src/dataops_cli/cli/table.py
+src/dataops_cli/cli/tag.py
 src/dataops_cli/cli/utils.py
 src/dataops_cli/cli/widget.py
 src/dataops_cli/cli/workflow.py

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/dataops_cli/__init__.py

@@ -14,4 +14,4 @@ groups command modules under :mod:`dataops_cli.cli` and re-exports the package
     removed in ``dataops_cli`` 1.0.
 """
 
-__version__ = "0.4.1"
+__version__ = "0.4.3"

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/dataops_cli/cli/auth.py

@@ -9,6 +9,7 @@
 from typing import Annotated
 
 import typer
+from dataops_cli.cli.utils import print_list
 from dataops_sdk.constants import APPLICATION_FILE, USER_INFO_FILE
 from dataops_sdk.exceptions import AuthenticationError
 from dataops_sdk.schemas import UserInfo
@@ -25,8 +26,6 @@ from dataops_sdk.utils import get_work_dir
 from rich.console import Console
 from rich.table import Table
 
-from dataops_cli.cli.utils import print_list
-
 auth_typer = typer.Typer(name="auth", help="认证相关命令", no_args_is_help=True)
 application_typer = typer.Typer(name="application", help="应用相关命令", no_args_is_help=True)
 auth_typer.add_typer(application_typer)
@@ -60,9 +59,13 @@ def auth_status() -> None:
         print(f"{user_info.true_name}({user_info.user_name})登录过期，请重新登录")
     else:
         if application is None:
-            print(f"{user_info.true_name}({user_info.user_name})已登录, 应用未设置")
+            typer.echo(
+                f"{user_info.true_name}({user_info.user_name})已登录, 应用未设置\n请执行 data-ops-cli auth application set <应用code> 设置应用",
+                err=True,
+            )
+            raise typer.Exit(code=1)
         else:
-            print(
+            typer.echo(
                 f"{user_info.true_name}({user_info.user_name})已登录, 应用设置为{application.LABEL_CN}({application.CODE})"
             )
 

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/dataops_cli/cli/dataset.py

@@ -1,29 +1,40 @@
 """数据集管理命令组.
 
-提供数据集的列表查询、详情、数据量统计与实际数据获取能力。
+提供数据集的列表查询、详情、数据量统计与实际数据获取。
 """
 
+from pathlib import Path
 from typing import Annotated
 
 import typer
+from pydantic_core import to_json
+
 from dataops_sdk.exceptions import DataOpsError
-from dataops_sdk.schemas import PageParam, SqlFilter, SqlQueryParam
+from dataops_sdk.schemas import MetaType, PageParam, SqlFilter, SqlQueryParam
 from dataops_sdk.services import (
+    release_list_get_by_code,
     release_list_update,
     service_count_dataset_by_code,
     service_get_dataset_data_by_code,
     service_get_dataset_detail_by_code,
     service_list_datasets,
 )
-from dataops_sdk.utils import filter_nodes_by_pattern
+from dataops_sdk.session import get_session
+from dataops_sdk.utils import encrypt_body, filter_nodes_by_pattern
 
 from dataops_cli.cli.utils import print_list, print_table_column_detail
 
+# 数据集 rawData 中承载 SQL 定义的字段名（subType=sql 的数据集均有此字段）。
+SQL_FIELD = "text"
+
+
 dataset_typer = typer.Typer(name="dataset", help="Manage dataset.", no_args_is_help=True)
 update_typer = typer.Typer(name="update", help="变更", no_args_is_help=True)
 dataset_typer.add_typer(update_typer)
 column_typer = typer.Typer(name="column", help="列变更", no_args_is_help=True)
 update_typer.add_typer(column_typer)
+sql_typer = typer.Typer(name="sql", help="SQL 编辑", no_args_is_help=True)
+update_typer.add_typer(sql_typer)
 
 
 @dataset_typer.command("list")
@@ -241,3 +252,84 @@ def update_dataset_column(
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None
     typer.echo(f"修改数据集 {code} 字段 {column_item.name} 完成")
+
+
+def _load_sql(code: str):
+    """校验数据集存在 SQL 字段并返回 Meta；失败统一报错退出."""
+    try:
+        meta = release_list_get_by_code(MetaType.DATASET, code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    data = meta.data
+    if not isinstance(data, dict) or not isinstance(data.get(SQL_FIELD), str):
+        typer.echo(f"数据集 {code} 未找到 SQL 字段({SQL_FIELD})", err=True)
+        raise typer.Exit(code=1)
+    return meta
+
+
+def _save_sql(meta, sql: str) -> None:
+    """整段替换 SQL 并保存：先解析字段回填 columns（失败仅警告），保存失败统一报错."""
+    meta.data[SQL_FIELD] = sql
+    try:
+        meta_payload = meta.model_dump(mode="json", exclude={"data"})
+        meta_payload["rawData"] = to_json(meta.data).decode()
+        with get_session() as session:
+            resp = session.post(
+                "/data/dataset/analysis",
+                content=to_json(encrypt_body({"meta": meta_payload, "params": []})),
+            )
+            resp.raise_for_status()
+            meta.data["columns"] = resp.json()["data"]["columns"]
+            typer.echo(f"字段解析完成（{len(meta.data['columns'])} 列）")
+    except Exception as e:
+        typer.echo(f"⚠️ 字段解析失败，仅保存 SQL: {e}", err=True)
+    try:
+        release_list_update(meta)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+
+
+@sql_typer.command("edit", no_args_is_help=True)
+def edit_dataset_sql(
+    code: Annotated[str, typer.Argument(help="数据集编码")],
+    old_texts: Annotated[
+        list[str],
+        typer.Option("--old-text", help="待替换文本（可多次传入，与 --new-text 一一对应）"),
+    ],
+    new_texts: Annotated[
+        list[str],
+        typer.Option("--new-text", help="替换后的文本（与 --old-text 一一对应）"),
+    ],
+) -> None:
+    """按 --old-text/--new-text 成对精准替换 SQL 文本."""
+    if len(old_texts) != len(new_texts):
+        typer.echo("参数 --old-text 与 --new-text 数量不一致", err=True)
+        raise typer.Exit(code=1)
+    meta = _load_sql(code)
+    content = meta.data[SQL_FIELD]
+    for idx, (old, new) in enumerate(zip(old_texts, new_texts), start=1):
+        if old not in content:
+            typer.echo(f"[{idx}] 未找到匹配文本 {old}", err=True)
+            raise typer.Exit(code=1)
+        content = content.replace(old, new, count=1)
+    _save_sql(meta, content)
+    typer.echo(f"数据集 {code} SQL 更新成功")
+
+
+@sql_typer.command("write", no_args_is_help=True)
+def write_dataset_sql(
+    code: Annotated[str, typer.Argument(help="数据集编码")],
+    file: Annotated[Path | None, typer.Argument(help="输入文件路径")] = None,
+    content: Annotated[str | None, typer.Option("--content", help="SQL 内容")] = None,
+) -> None:
+    """整段写入 SQL，file 与 --content 至少指定一个."""
+    if file:
+        content = file.read_text(encoding="utf-8")
+    elif not content:
+        typer.echo("参数 file 或 --content 必须指定一个", err=True)
+        raise typer.Exit(code=1)
+    meta = _load_sql(code)
+    _save_sql(meta, content)
+    typer.echo(f"数据集 {code} SQL 写入成功")

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

@@ -0,0 +1,219 @@
+"""字典（dict）管理命令组.
+
+提供数据源字典的列表查询、详情查看、字典树以及字段增删改能力。
+"""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas import MetaType
+from dataops_sdk.services.dict_ import (
+    service_get_dict_detail_by_code,
+    service_get_dict_detail_by_name,
+    service_list_dicts,
+    servive_tree_dict,
+)
+from dataops_sdk.services.meta import release_list_get_by_code, release_list_update
+from dataops_sdk.utils import filter_nodes_by_pattern
+
+from dataops_cli.cli.utils import print_group_tree, print_list
+
+dict_typer = typer.Typer(name="dict", help="Manage dict.", no_args_is_help=True)
+field_typer = typer.Typer(name="field", help="字典字段变更", no_args_is_help=True)
+dict_typer.add_typer(field_typer)
+
+
+def _find_option_index(options: list, value: str) -> int | None:
+    """在 options 列表中按 value 查找下标，未找到返回 None."""
+    return next((i for i, o in enumerate(options) if str(o.get("value")) == value), None)
+
+
+@dict_typer.command("list")
+def list_dict(
+    datasource: Annotated[str, typer.Argument(help="数据源")],
+    query: Annotated[str | None, typer.Option("-q", "--query", help="字典名称关键字")] = None,
+) -> None:
+    """列出数据源中的字典列表。
+
+    支持通过关键字过滤字典名称，并支持正则表达式匹配。
+
+    Args:
+        datasource: 数据源名称。
+        query: 可选字典名称关键字（支持正则）。
+
+    Examples:
+        # 列出指定数据源的所有字典
+        >>> data-ops-cli dict list <datasource>
+
+        # 列出数据源中名称包含 "user" 的字典
+        >>> data-ops-cli dict list <datasource> -q user
+
+        # 使用正则过滤字典名
+        >>> data-ops-cli dict list <datasource> -q "^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)
+
+    print_list(
+        ["code", "name", "alias"],
+        [[column.code, column.name, column.title] for column in group_nodes],
+    )
+
+
+@dict_typer.command("detail", no_args_is_help=True)
+def get_dict_detail(
+    arg1: Annotated[str, typer.Argument(help="编码或数据源")],
+    name: Annotated[str | None, typer.Argument(help="字典名称")] = None,
+) -> None:
+    """获取字典详情信息。
+
+    支持两种查询方式:
+
+    1. 通过字典编码(CODE)直接查询
+    2. 通过数据源名称和字典名称组合查询
+
+    默认只显示字典选项的基本信息(label/value)
+
+    Args:
+        arg1: 字典编码；当同时提供 ``name`` 时为数据源名称。
+        name: 可选字典名称。
+
+    Examples:
+        # 通过字典编码查询字典结构
+        >>> data-ops-cli dict detail dict_code_123
+
+        # 通过数据源和字典名查询
+        >>> data-ops-cli dict detail <datasource> my_dict
+    """
+    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
+    print(f"{meta.name}({meta.title})")
+    print_list(["value", "label"], [[option.value, option.label] for option in meta.data.options])
+
+
+@dict_typer.command("tree")
+def tree_dict(
+    query: Annotated[str | None, typer.Option("-q", "--query", help="字典名称关键字")] = None,
+) -> None:
+    """展示字典树结构。
+
+    Args:
+        query: 字典名称关键字（支持正则）。
+    """
+    try:
+        tree = servive_tree_dict()
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print_group_tree(tree, query)
+
+
+@field_typer.command("add", no_args_is_help=True)
+def add_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+    label: Annotated[str, typer.Argument(help="选项标签")],
+) -> None:
+    """新增字典字段。
+
+    Args:
+        code: 字典编码。
+        value: 选项值。
+        label: 选项标签。
+
+    Examples:
+        # 单条新增
+        >>> data-ops-cli dict field add dict_code_001 3 第三选项
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.setdefault("options", []) if meta.data else []
+        if any(str(o.get("value")) == value for o in options):
+            typer.echo(f"字典 {code} 中已存在 value={value}", err=True)
+            raise typer.Exit(code=1)
+        options.append({"value": value, "label": label, "id": ""})
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"新增 {code} {value} 完成")
+
+
+@field_typer.command("edit", no_args_is_help=True)
+def edit_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+    label: Annotated[str, typer.Argument(help="新标签")],
+) -> None:
+    """编辑字典字段标签。
+
+    Args:
+        code: 字典编码。
+        value: 要修改的选项值。
+        label: 新的标签名。
+
+    Examples:
+        >>> data-ops-cli dict field edit dict_code_001 0 禁用
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.get("options", []) if meta.data else []
+        idx = _find_option_index(options, value)
+        if idx is None:
+            typer.echo(f"字典中不存在选项: {value}", err=True)
+            raise typer.Exit(code=1)
+        options[idx]["label"] = label
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"修改 {code} {value} 完成")
+
+
+@field_typer.command("delete", no_args_is_help=True)
+def delete_field(
+    code: Annotated[str, typer.Argument(help="字典编码")],
+    value: Annotated[str, typer.Argument(help="选项值")],
+) -> None:
+    """删除字典字段。
+
+    Args:
+        code: 字典编码。
+        value: 要删除的选项值。
+
+    Examples:
+        >>> data-ops-cli dict field delete dict_code_001 0
+    """
+    try:
+        meta = release_list_get_by_code(MetaType.DICT, code)
+        options = meta.data.get("options", []) if meta.data else []
+        idx = _find_option_index(options, value)
+        if idx is None:
+            typer.echo(f"字典中不存在选项: {value}", err=True)
+            raise typer.Exit(code=1)
+        options.pop(idx)
+        release_list_update(meta, datasource=meta.subSystem)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(f"删除 {code} {value} 完成")

{data_ops_cli-0.4.1 → data_ops_cli-0.4.3}/src/dataops_cli/cli/factory.py

@@ -53,11 +53,13 @@ def create_app():
     from dataops_cli.cli.datasource import datasource_typer
     from dataops_cli.cli.dict_ import dict_typer
     from dataops_cli.cli.hazard import hazard_typer
+    from dataops_cli.cli.kb import kb_typer
     from dataops_cli.cli.metrics import metrics_typer
     from dataops_cli.cli.ref import ref_typer
     from dataops_cli.cli.report import report_typer
     from dataops_cli.cli.skill import skill_typer
     from dataops_cli.cli.table import table_typer
+    from dataops_cli.cli.tag import tag_typer
     from dataops_cli.cli.widget import widget_typer
     from dataops_cli.cli.workflow import workflow_typer
 
@@ -81,6 +83,8 @@ def create_app():
     app.add_typer(widget_typer)
     app.add_typer(dict_typer)
     app.add_typer(hazard_typer)
+    app.add_typer(kb_typer)
+    app.add_typer(tag_typer)
 
     app.registered_callback = TyperInfo(callback=main)
 

data_ops_cli-0.4.3/src/dataops_cli/cli/kb.py

@@ -0,0 +1,234 @@
+"""Knowledge Base（知识库）管理命令组.
+
+- 服务层函数 (service_*)：纯 Python 接口，返回原始数据
+- CLI 命令：基于服务层的薄包装，负责格式化输出
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from dataops_cli.cli.utils import print_list
+from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas.wiki import KbType
+from dataops_sdk.services.wiki import (
+    service_get_knowledge_base,
+    service_list_knowledge_bases,
+    service_list_knowledge_documents,
+    service_search_knowledge,
+    service_search_wiki_pages,
+    service_upload_knowledge_file,
+)
+
+kb_typer = typer.Typer(
+    name="kb",
+    help="知识库管理",
+    no_args_is_help=True,
+)
+doc_typer = typer.Typer(name="doc", help="知识库文档", no_args_is_help=True)
+page_typer = typer.Typer(name="page", help="Wiki 页面", no_args_is_help=True)
+kb_typer.add_typer(doc_typer)
+kb_typer.add_typer(page_typer)
+
+
+@kb_typer.command("list")
+def kb_list_cmd(
+    kb_type: Annotated[
+        KbType | None,
+        typer.Option("--type", "-t", help="知识库类型：document / faq / wiki"),
+    ] = None,
+    page: Annotated[int, typer.Option("--page", help="页码", min=1)] = 1,
+    page_size: Annotated[int, typer.Option("--page-size", help="每页条数", min=1)] = 20,
+) -> None:
+    """列出知识库。
+
+    Examples:
+        >>> data-ops-cli kb list
+        >>> data-ops-cli kb list --type wiki
+    """
+    try:
+        result = service_list_knowledge_bases(page=page, page_size=page_size, kb_type=kb_type)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not result.items:
+        print("未查询到知识库")
+        return
+
+    print_list(
+        ("id", "name", "type", "knowledge_count"),
+        [
+            [it.id, it.name, it.type or "", it.knowledge_count if it.knowledge_count is not None else ""]
+            for it in result.items
+        ],
+    )
+    print(f"total={result.total} page={result.page} page_size={result.page_size}")
+
+
+@kb_typer.command("detail", no_args_is_help=True)
+def kb_detail_cmd(
+    kb_id: Annotated[str, typer.Argument(help="知识库 ID")],
+) -> None:
+    """查看知识库详情。
+
+    Examples:
+        >>> data-ops-cli kb detail <kb_id>
+    """
+    try:
+        kb = service_get_knowledge_base(kb_id)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    print_list(
+        ("field", "value"),
+        [
+            ["id", kb.id],
+            ["name", kb.name],
+            ["type", kb.type or ""],
+            ["description", kb.description or ""],
+            ["knowledge_count", kb.knowledge_count if kb.knowledge_count is not None else ""],
+            ["chunk_count", kb.chunk_count if kb.chunk_count is not None else ""],
+        ],
+    )
+
+
+@doc_typer.command("list", no_args_is_help=True)
+def doc_list_cmd(
+    kb_id: Annotated[str, typer.Argument(help="知识库 ID")],
+    keyword: Annotated[
+        str | None,
+        typer.Option("--keyword", "-k", help="关键词"),
+    ] = None,
+    page: Annotated[int, typer.Option("--page", help="页码", min=1)] = 1,
+    page_size: Annotated[int, typer.Option("--page-size", help="每页条数", min=1)] = 20,
+) -> None:
+    """列出知识库文档。
+
+    Examples:
+        >>> data-ops-cli kb doc list <kb_id>
+        >>> data-ops-cli kb doc list <kb_id> --keyword "故障处理"
+    """
+    try:
+        result = service_list_knowledge_documents(
+            kb_id, page=page, page_size=page_size, keyword=keyword
+        )
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not result.items:
+        print("未查询到文档")
+        return
+
+    print_list(
+        ("id", "title", "file_name", "parse_status"),
+        [
+            [
+                it.id,
+                it.title or "",
+                it.file_name or "",
+                it.parse_status or "",
+            ]
+            for it in result.items
+        ],
+    )
+    print(f"total={result.total} page={result.page} page_size={result.page_size}")
+
+
+@doc_typer.command("upload", no_args_is_help=True)
+def doc_upload_cmd(
+    kb_id: Annotated[str, typer.Argument(help="知识库 ID")],
+    file: Annotated[Path, typer.Argument(help="本地文件路径", exists=True, readable=True)],
+    name: Annotated[
+        str | None,
+        typer.Option("--name", help="覆盖上传文件名"),
+    ] = None,
+) -> None:
+    """上传文件到知识库。
+
+    Examples:
+        >>> data-ops-cli kb doc upload <kb_id> ./manual.pdf
+    """
+    try:
+        doc = service_upload_knowledge_file(kb_id, file, file_name=name)
+    except (DataOpsError, FileNotFoundError) as e:
+        msg = getattr(e, "message", None) or str(e)
+        typer.echo(f"错误: {msg}")
+        raise typer.Exit(code=1) from None
+
+    print(f"上传成功: id={doc.id} title={doc.title or ''} file_name={doc.file_name or ''}")
+
+
+@kb_typer.command("search", no_args_is_help=True)
+def search_cmd(
+    keyword: Annotated[str, typer.Argument(help="检索关键词")],
+    limit: Annotated[int, typer.Option("--limit", help="返回条数", min=1)] = 20,
+    offset: Annotated[int, typer.Option("--offset", help="偏移量", min=0)] = 0,
+) -> None:
+    """全局关键词检索知识内容。
+
+    Examples:
+        >>> data-ops-cli kb search "网络割接"
+    """
+    try:
+        result = service_search_knowledge(keyword, limit=limit, offset=offset)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not result.items:
+        print("未检索到内容")
+        return
+
+    print_list(
+        ("title", "kb_name", "score", "content"),
+        [
+            [
+                it.title or it.knowledge_title or "",
+                it.kb_name or "",
+                f"{it.score:.4f}" if it.score is not None else "",
+                (it.content or "")[:80],
+            ]
+            for it in result.items
+        ],
+    )
+    print(f"total={result.total}")
+
+
+@page_typer.command("search", no_args_is_help=True)
+def page_search_cmd(
+    kb_id: Annotated[str, typer.Argument(help="知识库 ID")],
+    query: Annotated[str, typer.Argument(help="检索词")],
+    limit: Annotated[int, typer.Option("--limit", help="返回条数", min=1)] = 20,
+) -> None:
+    """检索知识库 Wiki 页面。
+
+    Examples:
+        >>> data-ops-cli kb page search <kb_id> "运维手册"
+    """
+    try:
+        pages = service_search_wiki_pages(kb_id, query, limit=limit)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not pages:
+        print("未检索到 Wiki 页面")
+        return
+
+    print_list(
+        ("slug", "title", "page_type", "summary"),
+        [
+            [
+                it.slug,
+                it.title or "",
+                it.page_type or "",
+                (it.summary or "")[:60],
+            ]
+            for it in pages
+        ],
+    )