data-ops-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/PKG-INFO

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

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/src/data_ops_cli.egg-info/PKG-INFO

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

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/src/data_ops_cli.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ 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/ontology.py
 src/dataops_cli/cli/ref.py

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/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.5.0"
+__version__ = "0.5.1"

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/src/dataops_cli/cli/factory.py

@@ -53,6 +53,7 @@ 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.ontology import ontology_typer
     from dataops_cli.cli.ref import ref_typer
@@ -84,7 +85,7 @@ def create_app():
     app.add_typer(widget_typer)
     app.add_typer(dict_typer)
     app.add_typer(hazard_typer)
-    # app.add_typer(kb_typer)  # TODO: kb CLI 尚未实现
+    app.add_typer(kb_typer)
     app.add_typer(tag_typer)
 
     app.registered_callback = TyperInfo(callback=main)

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

@@ -0,0 +1,248 @@
+"""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="知识目录 CUID")],
+    file: Annotated[Path, typer.Argument(help="本地文件路径", exists=True, readable=True)],
+    name: Annotated[
+        str | None,
+        typer.Option("--name", help="覆盖上传文件名"),
+    ] = None,
+    security_level: Annotated[
+        str,
+        typer.Option(
+            "--security-level",
+            help="文档密级：PUBLIC / INTERNAL / CONFIDENTIAL / SECRET",
+        ),
+    ] = "INTERNAL",
+) -> None:
+    """上传文件到知识库。
+
+    Examples:
+        >>> data-ops-cli kb doc upload <kb_id> ./manual.pdf
+    """
+    try:
+        doc = service_upload_knowledge_file(
+            kb_id, file, file_name=name, security_level=security_level
+        )
+    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="Wiki 资源 CUID（非目录 CUID）")],
+    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
+        ],
+    )

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/src/dataops_cli/cli/ontology.py

@@ -11,22 +11,30 @@ from typing import Annotated, Any
 
 import typer
 from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas.ontology import BUILTIN_SKILL_KINDS, OntologyBuiltinSkillKind
 from dataops_sdk.services.ontology import (
+    get_scenario_skill_code,
     service_get_ontology_by_code,
     service_get_ontology_by_name,
     service_list_ontologies,
+    service_list_ontology_apis,
+    service_list_ontology_metrics,
+    service_reset_ontology_builtin_skill,
     service_tree_ontology,
     service_update_ontology_basic,
     service_update_ontology_constraints,
     service_update_ontology_notes,
     service_update_ontology_relations,
+    service_update_ontology_scenarios,
 )
 
 from dataops_cli.cli.utils import print_group_tree, print_list
 
 ontology_typer = typer.Typer(name="ontology", help="本体管理", no_args_is_help=True)
 update_typer = typer.Typer(name="update", help="更新本体配置", no_args_is_help=True)
+builtin_skill_typer = typer.Typer(name="builtin-skill", help="本体内置技能", no_args_is_help=True)
 ontology_typer.add_typer(update_typer)
+ontology_typer.add_typer(builtin_skill_typer)
 
 
 def _read_json_payload(
@@ -133,9 +141,18 @@ def detail_ontology(
 
     data = meta.data
     print(f"本体: {meta.name} ({meta.title})")
+    print(f"编码: {meta.code}")
     print(f"备注: {meta.remark or '-'}")
     print(f"多维表格: {data.data_table or '-'}")
+    if data.skills:
+        print("内置技能 name 映射:")
+        for kind in BUILTIN_SKILL_KINDS:
+            if kind in data.skills:
+                print(f"  {kind}: {data.skills[kind]}")
     print(f"场景数: {len(data.scenarios)}")
+    for scenario in data.scenarios:
+        skill_code = get_scenario_skill_code(scenario)
+        print(f"  - {scenario.id}: {scenario.name or '-'} → skill {skill_code or '-'}")
     print(f"约束数: {len(data.constraints)}")
     print(f"关系数: {len(data.relations)}")
     if data.notes:
@@ -289,3 +306,80 @@ def update_relations(
         raise typer.Exit(code=1) from None
     assert result.data is not None
     typer.echo(f"本体 {result.name} 关联关系已更新（共 {len(result.data.relations)} 条）")
+
+
+@update_typer.command("scenarios", no_args_is_help=True)
+def update_scenarios(
+    name: Annotated[str, typer.Argument(help="本体编码或业务名")],
+    file: Annotated[
+        Path | None,
+        typer.Option("--file", "-f", help="场景 JSON 文件路径（数组）"),
+    ] = None,
+    content: Annotated[
+        str | None,
+        typer.Option("--content", "-c", help="场景 JSON 内容（数组）"),
+    ] = None,
+) -> None:
+    """全量替换本体场景列表（内置场景 id 不可删除）。"""
+    payload = _read_json_payload(file, content)
+    if not isinstance(payload, list):
+        typer.echo("错误: 场景内容必须是 JSON 数组", err=True)
+        raise typer.Exit(code=1)
+    try:
+        result = service_update_ontology_scenarios(name, payload)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    assert result.data is not None
+    typer.echo(f"本体 {result.name} 场景已更新（共 {len(result.data.scenarios)} 条）")
+
+
+@ontology_typer.command("metrics", no_args_is_help=True)
+def list_metrics(
+    code: Annotated[str, typer.Argument(help="本体编码")],
+) -> None:
+    """查询本体关联的指标列表。"""
+    try:
+        items = service_list_ontology_metrics(code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    print(json.dumps(items, ensure_ascii=False, indent=2))
+
+
+@ontology_typer.command("apis", no_args_is_help=True)
+def list_apis(
+    code: Annotated[str, typer.Argument(help="本体编码")],
+) -> None:
+    """查询本体关联的接口列表。"""
+    try:
+        items = service_list_ontology_apis(code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    print(json.dumps(items, ensure_ascii=False, indent=2))
+
+
+@builtin_skill_typer.command("reset", no_args_is_help=True)
+def reset_builtin_skill(
+    name_or_code: Annotated[str, typer.Argument(help="本体编码或业务名")],
+    kind: Annotated[
+        OntologyBuiltinSkillKind,
+        typer.Argument(help="内置技能类型: query/create/delete/update"),
+    ],
+) -> None:
+    """重置本体内置技能并回填场景绑定。"""
+    try:
+        meta = service_get_ontology_by_name(name_or_code)
+    except DataOpsError:
+        try:
+            meta = service_get_ontology_by_code(name_or_code)
+        except DataOpsError as e:
+            typer.echo(f"错误: {e.message}", err=True)
+            raise typer.Exit(code=1) from None
+    try:
+        result = service_reset_ontology_builtin_skill(meta.code, kind)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}", err=True)
+        raise typer.Exit(code=1) from None
+    print(json.dumps(result, ensure_ascii=False, indent=2))

{data_ops_cli-0.5.0 → data_ops_cli-0.5.1}/src/dataops_cli/cli/skill.py

@@ -11,10 +11,8 @@ from pathlib import Path
 from typing import Annotated
 
 import typer
-from dataops_cli.cli.utils import paginate_with_line_numbers, print_list
 from dataops_sdk.exceptions import DataOpsError
 from dataops_sdk.schemas import MetaSkillFileSubType, MetaSkillSubType, MetaType
-from dataops_sdk.schemas.enums import GroupNodeRefType
 from dataops_sdk.services import (
     SkillPackValidationError,
     service_delete_skill,
@@ -25,6 +23,9 @@ from dataops_sdk.services import (
     service_skill_call_by_name,
     service_skill_delete_sub_file,
     service_skill_download,
+    service_skill_list_ontologies_by_codes,
+    service_skill_list_ontology_options,
+    service_skill_list_skill_codes_by_ontology,
     service_skill_update,
     service_skill_upload,
     service_skill_upload_sub_file,
@@ -33,6 +34,8 @@ from dataops_sdk.tiptap import TableStyle, TipTapTool
 from pydantic_core import from_json
 from rich.console import Console
 
+from dataops_cli.cli.utils import paginate_with_line_numbers, print_list
+
 # ---------------------------------------------------------------------------
 # CLI 命令
 # ---------------------------------------------------------------------------
@@ -47,10 +50,70 @@ skill_file_typer = typer.Typer(
     help="技能文件管理",
     no_args_is_help=True,
 )
+skill_ontology_typer = typer.Typer(
+    name="ontology",
+    help="技能与本体归属",
+    no_args_is_help=True,
+)
 skill_typer.add_typer(skill_file_typer)
+skill_typer.add_typer(skill_ontology_typer)
 MAKRDOWN_TABLE_STYLE = TableStyle.MARKDOWN
 
 
+@skill_ontology_typer.command("options")
+def ontology_options_cmd() -> None:
+    """列出已绑定技能的本体（用于技能中心筛选）。"""
+    try:
+        items = service_skill_list_ontology_options()
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    if not items:
+        print("未查询到本体选项")
+        return
+    print_list(
+        ("code", "title"),
+        [[it.code, it.title] for it in items],
+    )
+
+
+@skill_ontology_typer.command("by-codes", no_args_is_help=True)
+def ontology_by_codes_cmd(
+    codes: Annotated[
+        str,
+        typer.Option("--codes", "-c", help="技能 code 列表，逗号分隔"),
+    ],
+) -> None:
+    """批量查询技能归属的本体。"""
+    code_list = [c.strip() for c in codes.split(",") if c.strip()]
+    if not code_list:
+        typer.echo("错误: --codes 不能为空")
+        raise typer.Exit(code=1)
+    try:
+        mapping = service_skill_list_ontologies_by_codes(code_list)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    payload = {key: [vo.model_dump() for vo in val] for key, val in mapping.items()}
+    print(json.dumps(payload, ensure_ascii=False, indent=2))
+
+
+@skill_ontology_typer.command("skill-codes", no_args_is_help=True)
+def ontology_skill_codes_cmd(
+    ontology_code: Annotated[
+        str,
+        typer.Option("--ontology-code", help="本体编码"),
+    ],
+) -> None:
+    """按本体查询绑定的技能 code 列表。"""
+    try:
+        codes = service_skill_list_skill_codes_by_ontology(ontology_code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print(json.dumps(codes, ensure_ascii=False, indent=2))
+
+
 @skill_typer.command("list")
 def list_cmd(
     sub_types: Annotated[
@@ -125,46 +188,27 @@ def detail_cmd(
 
 @skill_typer.command("upload", no_args_is_help=True)
 def upload_cmd(
-    space_code: Annotated[str, typer.Argument(help="空间编码 (通过 ``report space list`` 查看)")],
     file: Annotated[Path, typer.Argument(help="技能 ZIP 文件路径")],
     dtype: Annotated[
         MetaSkillSubType,
         typer.Option("--type", help="技能子类型"),
     ],
-    ref_node_id: Annotated[
-        str | None,
-        typer.Option(
-            "--ref-node-id",
-            help="文档中心分组节点 ID（可选；通过 ``report tree`` 查看，需挂到树上时填写）",
-        ),
-    ] = None,
-    ref_type: Annotated[
-        GroupNodeRefType,
-        typer.Option("--ref-type", help="引用节点类型 (放置在引用节点前、后还是内)"),
-    ] = GroupNodeRefType.AFTER,
     title: Annotated[str | None, typer.Option("--title", help="技能简体中文名称")] = None,
 ) -> None:
-    """从 ZIP 包导入技能到指定文档空间（可选挂到文档中心树节点）。
+    """从 ZIP 包导入技能到技能中心。
 
     Examples:
-        仅导入到空间（不挂文档树节点）
-        >>> data-ops-cli skill upload default my-skill.zip --type llm
-
-        挂到文档中心某分组节点内
-        >>> data-ops-cli skill upload default my-skill.zip --type api --ref-node-id {node-id} --ref-type inner
+        >>> data-ops-cli skill upload my-skill.zip --type llm
     """
     if not file.exists():
         typer.echo(f"错误: 文件不存在 {file}")
         raise typer.Exit(code=2)
 
     try:
-        result = service_skill_upload(
+        service_skill_upload(
             file_path=str(file),
             sub_type=dtype,
             title=title,
-            group_name=space_code,
-            ref_node_id=ref_node_id,
-            ref_type=ref_type,
         )
     except DataOpsError as e:
         typer.echo(f"错误: {e.message}")