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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.5
+Version: 0.5.0
 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.5 → data_ops_cli-0.5.0}/src/data_ops_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: data-ops-cli
-Version: 0.4.5
+Version: 0.5.0
 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.5 → data_ops_cli-0.5.0}/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.5"
+__version__ = "0.5.0"

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

@@ -125,16 +125,18 @@ def detail_cmd(
 
 @skill_typer.command("upload", no_args_is_help=True)
 def upload_cmd(
-    space_code: Annotated[
-        str, typer.Argument(help="空间编码 (通过 ``report sapce list`` 查看空间编码)")
-    ],
+    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 sapce tree` 查看)")
+        str | None,
+        typer.Option(
+            "--ref-node-id",
+            help="文档中心分组节点 ID（可选；通过 ``report tree`` 查看，需挂到树上时填写）",
+        ),
     ] = None,
     ref_type: Annotated[
         GroupNodeRefType,
@@ -142,11 +144,14 @@ def upload_cmd(
     ] = GroupNodeRefType.AFTER,
     title: Annotated[str | None, typer.Option("--title", help="技能简体中文名称")] = None,
 ) -> None:
-    """从 ZIP 包上传技能到文档中心指定位置。
+    """从 ZIP 包导入技能到指定文档空间（可选挂到文档中心树节点）。
 
     Examples:
-        把技能上传到指定空间的执行Node里面
-        >>> data-ops-cli skill import {space-code} my-skill.zip --type api --ref-node-id {node-id} --ref-type inner
+        仅导入到空间（不挂文档树节点）
+        >>> 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
     """
     if not file.exists():
         typer.echo(f"错误: 文件不存在 {file}")
@@ -218,9 +223,7 @@ def download_cmd(
     output_path: str | None = None
     if output is not None:
         # Typer Path 会吞掉末尾分隔符；无 .zip 后缀时视为目录
-        output_path = (
-            str(output) if output.suffix.lower() == ".zip" else f"{output}/"
-        )
+        output_path = str(output) if output.suffix.lower() == ".zip" else f"{output}/"
 
     try:
         zip_path = service_skill_download(name=name, output_path=output_path)

{data_ops_cli-0.4.5 → data_ops_cli-0.5.0}/src/dataops_cli/cli/workflow.py

@@ -160,6 +160,7 @@ def get_workflow_template(
 @workflow_typer.command("run", no_args_is_help=True)
 def run_workflow(
     code: Annotated[str, typer.Argument(help="工作流编码")],
+    start_node_id: Annotated[str, typer.Argument(help="启动节点 ID")],
     params: Annotated[
         str | None,
         typer.Option(help='启动参数 JSON 字符串，例如 \'{"key":"value"}\''),
@@ -172,14 +173,15 @@ def run_workflow(
 
     Args:
         code: 工作流编码。
+        start_node_id: 启动节点 ID（手动触发一般为 manually-trigger）。
         params: 可选启动参数 JSON 字符串。
 
     Examples:
         无参启动
-        >>> data-ops-cli workflow run wf_code_001
+        >>> data-ops-cli workflow run wf_code_001 manually-trigger
 
         带参数启动
-        >>> data-ops-cli workflow run wf_code_001 --params '{"date":"2026-07-16"}'
+        >>> data-ops-cli workflow run wf_code_001 manually-trigger --params '{"date":"2026-07-16"}'
     """
     try:
         params_dict = json.loads(params) if params else None
@@ -188,7 +190,7 @@ def run_workflow(
         raise typer.Exit(code=1) from None
 
     try:
-        result = service_start_workflow(code, params_dict)
+        result = service_start_workflow(code, start_node_id, params_dict)
     except DataOpsError as e:
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None
@@ -199,6 +201,7 @@ def run_workflow(
 @workflow_typer.command("run-async", no_args_is_help=True)
 def run_workflow_async(
     code: Annotated[str, typer.Argument(help="工作流编码")],
+    start_node_id: Annotated[str, typer.Argument(help="启动节点 ID")],
     params: Annotated[
         str | None,
         typer.Option(help='启动参数 JSON 字符串，例如 \'{"key":"value"}\''),
@@ -211,14 +214,15 @@ def run_workflow_async(
 
     Args:
         code: 工作流编码。
+        start_node_id: 启动节点 ID（手动触发一般为 manually-trigger）。
         params: 可选启动参数 JSON 字符串。
 
     Examples:
         无参异步启动
-        >>> data-ops-cli workflow run-async wf_code_001
+        >>> data-ops-cli workflow run-async wf_code_001 manually-trigger
 
         带参数异步启动
-        >>> data-ops-cli workflow run-async wf_code_001 --params '{"date":"2026-07-16"}'
+        >>> data-ops-cli workflow run-async wf_code_001 manually-trigger --params '{"date":"2026-07-16"}'
     """
     try:
         params_dict = json.loads(params) if params else None
@@ -227,7 +231,7 @@ def run_workflow_async(
         raise typer.Exit(code=1) from None
 
     try:
-        result = service_start_workflow_async(code, params_dict)
+        result = service_start_workflow_async(code, start_node_id, params_dict)
     except DataOpsError as e:
         typer.echo(f"错误: {e.message}")
         raise typer.Exit(code=1) from None