"""AIBridge - JNPF 低代码平台 Python 接口包 通过 AI 对话快速完成产品设计、应用开发和验证。 使用方法: # 方式一:在项目根目录运行 cd /path/to/project python3 -m aibridge.examples.example_name # 方式二:在 examples 目录运行 cd /path/to/project/aibridge/examples python3 example_name.py # 方式三:使用统一入口(自动设置路径) import sys from aibridge import setup_path setup_path() # 自动添加项目根目录到 sys.path from aibridge import JNPFClient, JNPFConfig # ... """ __version__ = "1.0.0" __author__ = "AIBridge" import os import sys def setup_path() -> None: """统一设置 sys.path,确保能正确导入 aibridge 模块。 调用此函数会自动将项目根目录添加到 sys.path。 项目根目录 = aibridge 包所在目录的父目录。 推荐在所有示例脚本开头调用此函数: from aibridge import setup_path setup_path() from aibridge import JNPFClient, JNPFConfig # ... """ # 获取 aibridge 包所在目录 aibridge_dir = os.path.dirname(os.path.abspath(__file__)) # 项目根目录 = aibridge 的父目录 project_root = os.path.dirname(aibridge_dir) # 如果项目根目录还不在 sys.path 中,则添加 if project_root not in sys.path: sys.path.insert(0, project_root) def check_python_version() -> bool: """检查 Python 版本,确保是 python3。 Returns: True 如果是 python3,False 否则 """ version = sys.version_info if version.major < 3: print(f"错误:需要 Python 3.x,当前版本是 {version.major}.{version.minor}") print("请使用 python3 命令运行此脚本") return False return True # 导出公共接口 from aibridge.client import JNPFClient from aibridge.config import JNPFConfig from aibridge.exceptions import JNPFError, AuthError, APIError from aibridge.models import APIResponse __all__ = [ # 核心 "JNPFClient", "JNPFConfig", "APIResponse", # 异常 "JNPFError", "AuthError", "APIError", # 工具函数 "setup_path", "check_python_version", ]