file

文件相关 CLI 命令。

cmd_file_close(fmt, file_id)

在 Dimine 中关闭文件（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_close(fmt: str, file_id: str) -> None:
    """在 Dimine 中关闭文件（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    async def _run():
        client = await get_client()
        await client.close_file(file_id)
        return {
            "success": True,
            "file_id": file_id,
            "message": f"已关闭文件: {file_id}",
        }

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except Exception as e:
        handle_sdk_error(e, fmt, "关闭文件失败")

cmd_file_create(fmt, path)

在 Dimine 中创建新的空文件（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_create(fmt: str, path: str) -> None:
    """在 Dimine 中创建新的空文件（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    file_path = resolve_path(path)

    async def _run():
        client = await get_client()
        await client.create_file(file_path)
        return {
            "success": True,
            "path": file_path,
            "message": f"已创建文件: {file_path}",
        }

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except Exception as e:
        handle_sdk_error(e, fmt, "创建文件失败")

cmd_file_open(fmt, path)

在 Dimine 中打开文件（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_open(fmt: str, path: str) -> None:
    """在 Dimine 中打开文件（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    file_path = resolve_path(path)

    async def _run():
        client = await get_client()
        await client.open_file(file_path)
        return {
            "success": True,
            "path": file_path,
            "message": f"已打开文件: {file_path}",
        }

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except Exception as e:
        handle_sdk_error(e, fmt, "打开文件失败")

cmd_file_save(fmt, output_path, file_id)

将已打开的文件导出保存到本地指定路径（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_save(fmt: str, output_path: str, file_id: str | None) -> None:
    """将已打开的文件导出保存到本地指定路径（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    save_path = resolve_path(output_path)

    async def _run():
        nonlocal file_id
        if not file_id:
            async with open_client() as client:
                files = await client.get_files()
                if not files:
                    raise_or_exit("没有打开的文件。请先在 Dimine 中打开文件，或提供 --file-id 参数。", fmt)
                if len(files) == 1:
                    file_id = files[0].id
                else:
                    file_list = "\n".join([f"  - id: {f.id}, name: {f.name}" for f in files])
                    raise_or_exit(
                        f"当前打开了 {len(files)} 个文件，请指定 --file-id：\n{file_list}",
                        fmt,
                    )
        async with open_client() as client:
            await client.export_file(file_id=file_id, file_path=save_path)
        return {
            "success": True,
            "file_id": file_id,
            "saved_to": save_path,
            "message": f"文件已保存: {save_path}",
        }

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except SystemExit:
        raise
    except Exception as e:
        handle_sdk_error(e, fmt, "保存文件失败")

cmd_file_tree(fmt)

获取当前场景中已打开的所有文件及每个文件的图层信息（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_tree(fmt: str) -> None:
    """获取当前场景中已打开的所有文件及每个文件的图层信息（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    async def _run():
        client = await get_client()
        files = await client.get_files()
        result = []
        for f in files:
            file_info = {"id": f.id, "name": f.name, "layers": []}
            try:
                layers = await client.get_layers(f.id)
                for layer in layers:
                    file_info["layers"].append({"id": layer.id, "name": layer.name})
            except Exception:
                pass
            result.append(file_info)
        return {"file_count": len(result), "files": result}

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except Exception as e:
        handle_sdk_error(e, fmt, "获取文件树失败")

cmd_file_visibility(fmt, file_id, action)

设置文件显示/隐藏状态（需 Dimine 运行）。

Source code in dimine_python_sdk\cli\commands\file.py

def cmd_file_visibility(fmt: str, file_id: str, action: str) -> None:
    """设置文件显示/隐藏状态（需 Dimine 运行）。"""
    err = require_remote_sdk()
    if err:
        output_error(err, fmt)

    from dimine_python_sdk.models.conn import VisibilityAction

    valid_actions = {
        "show": VisibilityAction.SHOW,
        "hide": VisibilityAction.HIDE,
        "exclusive_show": VisibilityAction.EXCLUSIVE_SHOW,
    }

    async def _run():
        client = await get_client()
        await client.set_file_visibility(
            file_id=file_id,
            action=valid_actions[action],
        )
        action_cn = {"show": "显示", "hide": "隐藏", "exclusive_show": "排他显示"}
        return {
            "success": True,
            "message": f"已成功{action_cn.get(action, action)}文件 {file_id}",
        }

    try:
        result = asyncio.run(_run())
        output_result(result, fmt)
    except Exception as e:
        handle_sdk_error(e, fmt, "设置文件可见性失败")

register_commands(subparsers, format_parent)

向 subparsers 注册文件相关子命令。

Source code in dimine_python_sdk\cli\commands\file.py

def register_commands(subparsers, format_parent) -> None:
    """向 subparsers 注册文件相关子命令。"""
    subparsers.add_parser("file-tree", parents=[format_parent], help="获取打开文件及图层树")

    p = subparsers.add_parser("file-save", parents=[format_parent], help="导出文件到本地")
    p.add_argument("--output", required=True, dest="output_path", help="保存/导出目标路径，需包含文件扩展名")
    p.add_argument("--file-id", default=None, help="文件ID，多个文件打开时必填")

    p = subparsers.add_parser("file-open", parents=[format_parent], help="打开文件到 Dimine 场景")
    p.add_argument("--path", required=True, help="要打开的 .dmf/.dwg/.dxf 等文件路径")

    p = subparsers.add_parser("file-close", parents=[format_parent], help="关闭 Dimine 中的文件")
    p.add_argument("--file-id", required=True, help="要关闭的文件ID")

    p = subparsers.add_parser("file-create", parents=[format_parent], help="在 Dimine 中创建新的空文件")
    p.add_argument("--path", required=True, help="新文件的路径")

    p = subparsers.add_parser("file-visibility", parents=[format_parent], help="设置文件显示/隐藏状态")
    p.add_argument("--file-id", required=True, help="文件ID")
    p.add_argument("--action", choices=["show", "hide", "exclusive_show"], default="show", help="操作类型（默认: show）")