data-ops-cli 0.4.2__tar.gz → 0.4.4__tar.gz

{data_ops_cli-0.4.2 → data_ops_cli-0.4.4}/PKG-INFO

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

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

{data_ops_cli-0.4.2 → data_ops_cli-0.4.4}/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.4/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
+        ],
+    )

{data_ops_cli-0.4.2 → data_ops_cli-0.4.4}/src/dataops_cli/cli/skill.py

@@ -23,6 +23,8 @@ from dataops_sdk.services import (
     service_pack_skill_zip,
     service_skill_call_by_name,
     service_skill_delete_sub_file,
+    service_skill_download,
+    service_skill_update,
     service_skill_upload,
     service_skill_upload_sub_file,
 )
@@ -151,6 +153,72 @@ def upload_cmd(
     print("上传成功")
 
 
+@skill_typer.command("update", no_args_is_help=True)
+def update_cmd(
+    name: Annotated[str, typer.Argument(help="技能业务名")],
+    file: Annotated[Path, typer.Argument(help="技能 ZIP 文件路径")],
+    dtype: Annotated[
+        MetaSkillSubType | None,
+        typer.Option("--type", help="技能子类型（可选）"),
+    ] = None,
+    title: Annotated[str | None, typer.Option("--title", help="技能简体中文名称")] = None,
+) -> None:
+    """全量覆盖更新已有技能。
+
+    Examples:
+        >>> data-ops-cli skill update my-skill ./my-skill.zip
+        >>> data-ops-cli skill update my-skill ./pkg.zip --type api --title "Foo Skill"
+    """
+    if not file.exists():
+        typer.echo(f"错误: 文件不存在 {file}")
+        raise typer.Exit(code=2)
+
+    try:
+        service_skill_update(
+            name=name,
+            file_path=str(file),
+            sub_type=dtype,
+            title=title,
+        )
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    print("更新成功")
+
+
+@skill_typer.command("download", no_args_is_help=True)
+def download_cmd(
+    name: Annotated[str, typer.Argument(help="技能业务名")],
+    output: Annotated[
+        Path | None,
+        typer.Option("--output", "-o", help="输出 ZIP 路径"),
+    ] = None,
+) -> None:
+    """从平台下载技能 ZIP 包。
+
+    Examples:
+        >>> data-ops-cli skill download my-skill
+        >>> data-ops-cli skill download my-skill -o /tmp/my-skill.zip
+        >>> data-ops-cli skill download my-skill --output ./out/
+    """
+    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}/"
+        )
+
+    try:
+        zip_path = service_skill_download(name=name, output_path=output_path)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    except OSError as e:
+        typer.echo(f"错误: 写入失败 {e}")
+        raise typer.Exit(code=1) from None
+    print(f"已下载技能包: {zip_path}")
+
+
 @skill_typer.command("zip", no_args_is_help=True)
 def zip_cmd(
     folder: Annotated[Path, typer.Argument(help="技能源文件夹路径")],

data_ops_cli-0.4.4/src/dataops_cli/cli/tag.py

@@ -0,0 +1,297 @@
+"""元标签管理命令组.
+
+提供标签树 list/detail，以及实体标签关联的 list/add/remove/set。
+标签作用域由 ``type`` 指定（如 skill / agent），非 meta-release 实体。
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Annotated
+
+import typer
+from dataops_sdk.exceptions import DataOpsError
+from dataops_sdk.schemas.tag import TagTreeNode
+from dataops_sdk.services.meta import release_list_list
+from dataops_sdk.services.tag import (
+    flatten_tag_tree,
+    service_add_entity_tags,
+    service_get_tag_detail,
+    service_list_entity_tags,
+    service_list_entity_tags_by_codes,
+    service_list_tags,
+    service_remove_entity_tags,
+    service_set_entity_tags,
+)
+
+from dataops_cli.cli.utils import print_list
+
+tag_typer = typer.Typer(name="tag", help="Manage meta tags.", no_args_is_help=True)
+rel_typer = typer.Typer(name="rel", help="实体与标签关联", no_args_is_help=True)
+tag_typer.add_typer(rel_typer)
+
+
+def _print_tag_tree(
+    nodes: list[TagTreeNode], query: str | None = None, *, indent: int = 0
+) -> list[str]:
+    """缩进打印标签树；有 query 时仅保留匹配子树."""
+    pattern = re.compile(query) if query else None
+    lines: list[str] = []
+    for node in nodes:
+        child_lines = _print_tag_tree(node.children or [], query, indent=indent + 1)
+        title = node.title or ""
+        code = node.code or ""
+        self_match = pattern is None or bool(pattern.search(title) or pattern.search(code))
+        if not self_match and not child_lines:
+            continue
+        prefix = "  " * indent
+        lines.append(f"{prefix}- {title}[{code}]({node.cuid})")
+        lines.extend(child_lines)
+    return lines
+
+
+def _echo_final_tags(tag_type: str, entity_code: str, cuids: list[str]) -> None:
+    typer.echo(f"已更新 {tag_type}/{entity_code} 标签: {', '.join(cuids) if cuids else '(空)'}")
+
+
+@tag_typer.command("list", no_args_is_help=True)
+def list_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill / agent")],
+    query: Annotated[
+        str | None, typer.Option("-q", "--query", help="标题/编码关键字（支持正则）")
+    ] = None,
+    as_tree: Annotated[bool, typer.Option("--tree", help="以树形缩进输出")] = False,
+) -> None:
+    """列出指定类型下的标签定义.
+
+    Examples:
+        >>> data-ops-cli tag list skill
+        >>> data-ops-cli tag list skill --tree
+        >>> data-ops-cli tag list skill -q "运维"
+    """
+    try:
+        tree = service_list_tags(tag_type)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if as_tree:
+        lines = _print_tag_tree(tree, query)
+        if not lines:
+            typer.echo("未查询到匹配标签")
+            return
+        typer.echo("\n".join(lines))
+        return
+
+    flat = flatten_tag_tree(tree)
+    if query:
+        pattern = re.compile(query)
+        flat = [n for n in flat if pattern.search(n.title or "") or pattern.search(n.code or "")]
+
+    if not flat:
+        typer.echo("未查询到匹配标签")
+        return
+
+    print_list(
+        ["code", "title", "cuid", "parentId"],
+        [[n.code, n.title, n.cuid, n.parentId] for n in flat],
+    )
+
+
+@tag_typer.command("detail", no_args_is_help=True)
+def get_tag_detail(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    key: Annotated[str, typer.Argument(help="标签 cuid 或 code")],
+    full: Annotated[bool, typer.Option("--full", help="显示完整字段")] = False,
+) -> None:
+    """获取标签详情（从标签树中按 cuid/code 查找）.
+
+    Examples:
+        >>> data-ops-cli tag detail skill my-tag-code
+        >>> data-ops-cli tag detail skill <cuid> --full
+    """
+    try:
+        node = service_get_tag_detail(tag_type, key)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not full:
+        print_list(
+            ["code", "title", "cuid", "parentId", "color"],
+            [[node.code, node.title, node.cuid, node.parentId, node.color]],
+        )
+        return
+
+    print_list(
+        [
+            "code",
+            "title",
+            "cuid",
+            "parentId",
+            "type",
+            "icon",
+            "color",
+            "sort",
+            "remark",
+            "createUser",
+            "createTime",
+            "lastModifyUser",
+            "lastModifyTime",
+        ],
+        [
+            [
+                node.code,
+                node.title,
+                node.cuid,
+                node.parentId,
+                node.type,
+                node.icon,
+                node.color,
+                node.sort,
+                node.remark,
+                node.createUser,
+                node.createTime,
+                node.lastModifyUser,
+                node.lastModifyTime,
+            ]
+        ],
+    )
+
+
+@rel_typer.command("list", no_args_is_help=True)
+def list_entity_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    entity_code: Annotated[str, typer.Argument(help="实体编码")],
+) -> None:
+    """列出实体已绑定的标签.
+
+    Examples:
+        >>> data-ops-cli tag rel list skill my-skill-code
+    """
+    try:
+        tags = service_list_entity_tags(tag_type, entity_code)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not tags:
+        typer.echo("未绑定标签")
+        return
+
+    print_list(
+        ["cuid", "title", "color", "icon"],
+        [[t.cuid, t.title, t.color, t.icon] for t in tags],
+    )
+
+
+@rel_typer.command("map", no_args_is_help=True)
+def map_entity_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    codes: Annotated[
+        list[str] | None,
+        typer.Option("--code", help="实体编码（可多次；省略则拉取该类型全部实体）"),
+    ] = None,
+) -> None:
+    """批量展示「实体 → 已绑定标签」映射.
+
+    未传 ``--code`` 时，通过 meta-release list 拉取 ``tag_type`` 对应的全部实体，
+    再调用 ``listByCodes`` 批量查标签。未绑定的实体 ``tags`` 列为空，便于盘点补标。
+
+    Examples:
+        >>> data-ops-cli tag rel map skill
+        >>> data-ops-cli tag rel map skill --code sk-a --code sk-b
+    """
+    try:
+        if codes:
+            entity_codes = list(dict.fromkeys(codes))
+            titles: dict[str, str] = {}
+        else:
+            metas = release_list_list(tag_type)
+            entity_codes = [m.code for m in metas if m.code]
+            titles = {m.code: m.title or m.name or "" for m in metas if m.code}
+        mapping = service_list_entity_tags_by_codes(tag_type, entity_codes)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+
+    if not entity_codes:
+        typer.echo("未查询到实体")
+        return
+
+    rows = []
+    for code in entity_codes:
+        tags = mapping.get(code) or []
+        tag_titles = ",".join(t.title or t.cuid for t in tags)
+        tag_cuids = ",".join(t.cuid for t in tags)
+        rows.append([code, titles.get(code, ""), tag_titles, tag_cuids])
+
+    print_list(["code", "title", "tags", "tag_cuids"], rows)
+
+
+@rel_typer.command("add", no_args_is_help=True)
+def add_entity_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    entity_code: Annotated[str, typer.Argument(help="实体编码")],
+    tags: Annotated[
+        list[str],
+        typer.Option("--tag", help="标签 cuid 或 code（可多次传入）"),
+    ],
+) -> None:
+    """给实体追加标签（读-改-写；自动补齐根标签）.
+
+    Examples:
+        >>> data-ops-cli tag rel add skill my-skill-code --tag my-tag-code
+        >>> data-ops-cli tag rel add skill my-skill-code --tag root --tag child
+    """
+    try:
+        final = service_add_entity_tags(tag_type, entity_code, tags)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    _echo_final_tags(tag_type, entity_code, final)
+
+
+@rel_typer.command("remove", no_args_is_help=True)
+def remove_entity_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    entity_code: Annotated[str, typer.Argument(help="实体编码")],
+    tags: Annotated[
+        list[str],
+        typer.Option("--tag", help="标签 cuid 或 code（可多次传入）"),
+    ],
+) -> None:
+    """从实体移除指定标签.
+
+    Examples:
+        >>> data-ops-cli tag rel remove skill my-skill-code --tag my-tag-code
+    """
+    try:
+        final = service_remove_entity_tags(tag_type, entity_code, tags)
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    _echo_final_tags(tag_type, entity_code, final)
+
+
+@rel_typer.command("set", no_args_is_help=True)
+def set_entity_tags(
+    tag_type: Annotated[str, typer.Argument(help="实体类型作用域，如 skill")],
+    entity_code: Annotated[str, typer.Argument(help="实体编码")],
+    tags: Annotated[
+        list[str] | None,
+        typer.Option("--tag", help="标签 cuid 或 code（可多次；省略则清空）"),
+    ] = None,
+) -> None:
+    """全量设置实体标签；不传 ``--tag`` 则清空.
+
+    Examples:
+        >>> data-ops-cli tag rel set skill my-skill-code --tag root --tag child
+        >>> data-ops-cli tag rel set skill my-skill-code
+    """
+    try:
+        final = service_set_entity_tags(tag_type, entity_code, tags or [])
+    except DataOpsError as e:
+        typer.echo(f"错误: {e.message}")
+        raise typer.Exit(code=1) from None
+    _echo_final_tags(tag_type, entity_code, final)

{data_ops_cli-0.4.2 → data_ops_cli-0.4.4}/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。
         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。
         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