bge-python-sdk 1.0.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

bge_python_sdk-2.0.0.data/data/share/bash-completion/completions/bge.bash

@@ -0,0 +1,14 @@
+# Bash completion for the `bge` command (BGE 开放平台 Python SDK).
+#
+# This file is installed into the bash-completion completions directory
+# (share/bash-completion/completions) so it is sourced automatically by
+# bash-completion. After `pip install bge-python-sdk`, tab completion for `bge`
+# works out of the box — no manual `eval "$(register-python-argcomplete bge)"`
+# is required.
+#
+# Zsh users: enable bash completion bridge once in ~/.zshrc:
+#   autoload -Uz bashcompinit && bashcompinit
+
+if command -v register-python-argcomplete >/dev/null 2>&1; then
+    eval "$(register-python-argcomplete bge)"
+fi

bge_python_sdk-2.0.0.data/data/share/zsh/site-functions/_bge

@@ -0,0 +1,14 @@
+# Zsh completion for the `bge` command (BGE 开放平台 Python SDK).
+#
+# Installed into the zsh site-functions directory (share/zsh/site-functions) so
+# zsh's completion system autoloads it automatically. The actual completion
+# logic is delegated to argcomplete via `register-python-argcomplete`, which
+# emits a shell-agnostic script (bash `complete` for bash, `compdef` for zsh).
+#
+# Bash users: this same logic is provided by completions/bge.bash, which is
+# installed into share/bash-completion/completions and sourced automatically by
+# bash-completion.
+
+if command -v register-python-argcomplete >/dev/null 2>&1; then
+    eval "$(register-python-argcomplete bge)"
+fi

{bge_python_sdk-1.0.0.dist-info → bge_python_sdk-2.0.0.dist-info}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 teambge
+Copyright (c) 2026 teambge
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{bge_python_sdk-1.0.0.dist-info → bge_python_sdk-2.0.0.dist-info}/METADATA

@@ -1,14 +1,12 @@
 Metadata-Version: 2.1
 Name: bge-python-sdk
-Version: 1.0.0
+Version: 2.0.0
 Summary: 可用于调用 BGE 开放平台的相关接口。
-Home-page: https://github.com/teambge/bge-python-sdk
-Author: leafcoder,xiangji1204
-Author-email: leafcoder@gmail.com,xiangji1204@genomics.cn
-Maintainer: leafcoder
-Maintainer-email: leafcoder@gmail.com
+Author-email: leafcoder <leafcoder@gmail.com>, xiangji1204 <xiangji1204@genomics.cn>
+Maintainer-email: leafcoder <leafcoder@gmail.com>
 License: MIT
-Keywords: bge-python-sdk bge bgesdk sdk
+Project-URL: Homepage, https://github.com/teambge/bge-python-sdk
+Keywords: bge-python-sdk,bge,bgesdk,sdk
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -18,8 +16,6 @@ Classifier: Operating System :: Microsoft :: Windows :: Windows 10
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -29,24 +25,23 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: >=3.6.3
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aliyun-python-sdk-core
-Requires-Dist: six
-Requires-Dist: certifi
-Requires-Dist: chardet
-Requires-Dist: idna
-Requires-Dist: requests
-Requires-Dist: urllib3
-Requires-Dist: oss2
-Requires-Dist: docker
-Requires-Dist: pimento
-Requires-Dist: qprompt
-Requires-Dist: requests-toolbelt
-Requires-Dist: validator.py
-Requires-Dist: python-minifier
-Requires-Dist: rich
+Requires-Dist: requests>=2.25.0
+Requires-Dist: oss2>=2.15.0
+Requires-Dist: requests-toolbelt>=1.0.0
+Requires-Dist: aliyun-python-sdk-core>=2.13.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: rich-argparse>=1.4.0
+Requires-Dist: argcomplete>=2.0.0
+Requires-Dist: python-minifier>=2.4.0
+Requires-Dist: qprompt>=0.16.0
+Requires-Dist: cython>=0.29.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: requests-mock>=1.9.0; extra == "test"
 
 
 <div align="center">
@@ -115,7 +110,7 @@ $ make install
 再或者
 
 ```shell
-$ python setup.py install
+$ pip install .
 ```
 
 # SDK 文档

bge_python_sdk-2.0.0.dist-info/RECORD

@@ -0,0 +1,96 @@
+bge_python_sdk-2.0.0.data/data/share/bash-completion/completions/bge.bash,sha256=PlZTqWg2H3p-VzNqdrVn5Mb2jtMiMmcDuRTIvsHip7U,616
+bge_python_sdk-2.0.0.data/data/share/zsh/site-functions/_bge,sha256=ZdIPbAfbfE8d2I7p4nCPOmGt5JHrn1oPakrDJn1QLAw,675
+bgesdk/__init__.py,sha256=OdbWizZDIomghmTF4TNlS_Ol723_hNLWI0OWcFcYLfk,170
+bgesdk/__main__.py,sha256=rD1iwLErz1a9b-GJVEwpFoqm6r6lOtekxvV0MuHXt9Q,1920
+bgesdk/client.py,sha256=b-RGx2mxBDLoMuvjJ5tEr7jMbei0Rn9xf8ZF_qFpCZ4,8732
+bgesdk/constants.py,sha256=rfXKIgAIzwMiZ2leAGpgaJutr8m822o0SCor2xeeH1o,1400
+bgesdk/error.py,sha256=SHUub26MxMYe4xkEvX0IwmOuDV4aQE8yJR7f8YOgrUs,4194
+bgesdk/fs.py,sha256=h8Sf1XamY9ZzckqQyxSRtRE9BA3QVXoAGfFU18r3Km0,327
+bgesdk/http.py,sha256=XPiueVGdE4boGGxmkkkHEAPohF3-1V1VftW6VXthE3U,5949
+bgesdk/models.py,sha256=6bf8YltYmeb8MUgjTHyv9zKfRWPFrdK3nlBU9TCZSXs,9022
+bgesdk/py.typed,sha256=vo7IAzCszo-iTLqwrT4KlzuNcY-SuuRvwcacC7tXWx0,124
+bgesdk/utils.py,sha256=TosA0dbviNINanPoHsG9HgG_v7WDIxSLLN04LD2y6sY,1461
+bgesdk/version.py,sha256=hwOJuFUEKtsgiOt4l6op9s-hviovM6TK1uCdtRNWY4E,22
+bgesdk/api/__init__.py,sha256=0F7v-9fcwx1VSaeSzxpyNvbjLdytheW4XgMf29v-EeU,83
+bgesdk/api/api.py,sha256=pLFj-3NYXWU2ufDtFBIG2wMiIBgeCdMMqwcJy76FOLQ,847
+bgesdk/api/base.py,sha256=lFLyG_RikpXHnEjYcIzREoCTyfldg22AsWccjw5n7sk,7358
+bgesdk/api/file.py,sha256=DSKaI1779FNqMiRORW26w1T6xC2smr-BBzbWJpl84Dg,15602
+bgesdk/api/microbiome.py,sha256=KkMv7FsHKRC_eTCzw5Od029sihb4M-HEEB564VZsi2c,4655
+bgesdk/api/misc.py,sha256=EBFc0ytrmVJi9oPmeIf1scRPJccikQZnarWvlsHOl9A,7294
+bgesdk/api/model.py,sha256=WHnQLszAmiPrirPwfElCLUMDgk02G64tNAEveGG5_3I,9439
+bgesdk/api/samples.py,sha256=5FQvEkwGQB9rVeIy8cT-ZlrIkKZ9uaXn5n5R5ng9L60,6050
+bgesdk/api/stream.py,sha256=06Wx1W_WqWdHmDo_cxTIRpwVDxmOm1NUSZS-KeOqTW4,9118
+bgesdk/api/variants.py,sha256=FTQUU_yHgsyAqDGyN3Cs5o-e5rCIk1n8CQhLXNRMrsc,3226
+bgesdk/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bgesdk/management/command.py,sha256=7NrZF7imCGtvwaoj95BZ6P1VNtjpMJig7ijQHmX6ep8,3690
+bgesdk/management/constants.py,sha256=JdF2ZmiJgpnGk9CFVG0kvNxNHuTj4r2cBxwcB2baD0s,1489
+bgesdk/management/utils.py,sha256=2aHX89iRD3cNw0FfkrNq_zZyp4eOS2FcpzmqgYo9HXI,7909
+bgesdk/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bgesdk/management/commands/config.py,sha256=-oKlTMafIdFVFj_IlaW47IWIWDrjunqyhJG0WUlUK14,6344
+bgesdk/management/commands/login.py,sha256=HwE5-0y-n-ic1uOYVvKkXVpxgYxJ9p7snBDg3zvPxQM,3975
+bgesdk/management/commands/model.py,sha256=F449veJmCyeoGIyWPkzEA_uB2EXV1Wt0hg8DA3zxMjA,68897
+bgesdk/management/commands/token.py,sha256=TtQjyFp-el9ktyzUyVRSIDALe8Eo_2aUORQPQjAMtFU,2560
+bgesdk/management/commands/workon.py,sha256=yz7ByEmfVAuZfD2CsCzOqT0Av0UPtEV22uOe3LjzLhY,1184
+bgesdk/management/commands/api/__init__.py,sha256=Bx9NBZZDOG404y2ySH7JllOyTG5pZOYveuf_uw4oe1A,868
+bgesdk/management/commands/api/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bgesdk/management/commands/api/commands/aggregate_omics_data.py,sha256=8CoPMW6ymqHvCJ36hr5PqN8gqR4GVKQ9ZZRB9R3fJGA,3061
+bgesdk/management/commands/api/commands/applet_url.py,sha256=kflNBInZ_O9nm3n1PA0GipMAx28wVcmV2K0mURR_Tjw,2464
+bgesdk/management/commands/api/commands/download.py,sha256=q7Us1-47P2dYjn6zM5QiHvZEFL8NcrNZv5zK6ns2dgQ,3350
+bgesdk/management/commands/api/commands/ferry_to_oss.py,sha256=YblVUIHXPEugk00lPvds9mXUQ05j61xeDDOuMzpB_-4,3945
+bgesdk/management/commands/api/commands/get_data_items.py,sha256=IVqdJnydp2LA4ThGmBrQDOkoaIc0FZh0WSwJE7foZE0,2373
+bgesdk/management/commands/api/commands/get_externals.py,sha256=YJmn5ThUKgwYL2UKCexzPyeL6HwOoZ4ybqsFBpLSmxA,1731
+bgesdk/management/commands/api/commands/get_func_abundance.py,sha256=SFGvbSswvr2phQyyEuVyuOt8aFn1UoKeJzW3Y-N6OT0,2597
+bgesdk/management/commands/api/commands/get_gene_abundance.py,sha256=nkUFCzmhlPnEyGvgDC__slFZfyaW8_oJHxDCV8Md-eQ,2730
+bgesdk/management/commands/api/commands/get_overview.py,sha256=P6Wb36btM86DJzsffyDmFZ45xDNEXEfYX293vPyHPJE,2924
+bgesdk/management/commands/api/commands/get_range_stream.py,sha256=3wlmLfftHyNFJakDwEXL82D7OsWMWOfKvvbV5yCTcCE,2625
+bgesdk/management/commands/api/commands/get_samples.py,sha256=x3ylkfoAWsF8DzYvoSFQZ_gIfmBNaQQ14w0wVyehq6k,3261
+bgesdk/management/commands/api/commands/get_taxon_abundance.py,sha256=D2vo0iZeM2ZXjWR49ewaPpfPn9WrjCk_OzjSTADxpG0,2155
+bgesdk/management/commands/api/commands/get_user.py,sha256=kM5YuFVO8PiTTjBXhxx7l6kx0E7niB1MXPOSFij9E7s,1486
+bgesdk/management/commands/api/commands/get_variants.py,sha256=Xx_uRMnvJ5a5U5IICslQk_q_Kw3a88D5vSFqasA0-vY,1787
+bgesdk/management/commands/api/commands/id_meta.py,sha256=qIN9JUufkElaWx5H9z6BDBjqsAZKOMYCKNrMcFSwIaY,1817
+bgesdk/management/commands/api/commands/task.py,sha256=2aPWwahTIBCAgxzXuq1bKS5Ie6tr_95RXIjef5RNX8g,1575
+bgesdk/management/commands/api/commands/upload.py,sha256=VF9nD_dWkPdJm7LrfVKvwTzO_nNhLEGI7KDKb0sQp24,3741
+bgesdk/management/commands/api/commands/upload_dir.py,sha256=mtaYhVbZ_FzFrH_yEzV9fTqOzL5BdSdJ7EzwF7QFylM,4145
+bgesdk/management/model_runtime/__init__.py,sha256=e8fi6ANGq_HB1O7RdTQIE9FBTV_bhjV8dyYjOTfncgc,782
+bgesdk/management/model_runtime/model_runtime.py,sha256=3fMWuIXacadVuJS69AOhzW5DP5u4edwvdNmzob4lyk8,24064
+bgesdk/management/model_runtime/server/model_license.py,sha256=B0v34mbAOK6KYh-zhNpPNu3CVyYclpJ1YgGonOjS7Kw,663
+bgesdk/management/model_runtime/server/secure.py,sha256=Yb7w3sJXqnKSzJ-OjLgGrtoi8z7Zbf0KF1guCgopHtA,3034
+bgesdk/management/model_runtime/server/setup.py,sha256=-z_IdaIp6y7gKyUJLupj-ZhAXbZG9D8dCoXzNtz1_-I,1050
+bgesdk/management/model_runtime/server/bge_model_server/__init__.py,sha256=5vTjaeWdfgLskCVllmGJ90H7Pj-ahmlwv20DDsZiPKA,456
+bgesdk/management/model_runtime/server/bge_model_server/app/__init__.py,sha256=XWKY22HpwNVvQS9Y3K01CdIB2CFz1_PKzxyK1hiWK5U,360
+bgesdk/management/model_runtime/server/bge_model_server/app/__main__.py,sha256=6INveqPg-MOZfLOca1tsl4rf9HOqbGh_HUMUaXOy4vE,1858
+bgesdk/management/model_runtime/server/bge_model_server/app/app_fastapi.py,sha256=2yk7JERY9q5nikY5FjD_EOJdztSYYskmsvk3Gsq9Gyg,5257
+bgesdk/management/model_runtime/server/bge_model_server/app/app_tornado.py,sha256=zCUVIrew3bTKlJZ-wtwNL5BB-P9gE6eENfmVhEcYjHY,6146
+bgesdk/management/model_runtime/server/bge_model_server/app/logging_conf.py,sha256=7tbT93F-4nI-nV4elIMO2qH6wjSjxv0wJqMq29LguHg,2136
+bgesdk/management/model_runtime/server/build/lib/model_license.py,sha256=B0v34mbAOK6KYh-zhNpPNu3CVyYclpJ1YgGonOjS7Kw,663
+bgesdk/management/model_runtime/server/build/lib/secure.py,sha256=Yb7w3sJXqnKSzJ-OjLgGrtoi8z7Zbf0KF1guCgopHtA,3034
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/__init__.py,sha256=5vTjaeWdfgLskCVllmGJ90H7Pj-ahmlwv20DDsZiPKA,456
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/__init__.py,sha256=XWKY22HpwNVvQS9Y3K01CdIB2CFz1_PKzxyK1hiWK5U,360
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/__main__.py,sha256=0tbM6GJ29yEad89HJRz21rfIV5ucIfW4BWAa8AUcIws,1858
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/app_fastapi.py,sha256=2yk7JERY9q5nikY5FjD_EOJdztSYYskmsvk3Gsq9Gyg,5257
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/app_tornado.py,sha256=zCUVIrew3bTKlJZ-wtwNL5BB-P9gE6eENfmVhEcYjHY,6146
+bgesdk/management/model_runtime/server/build/lib/bge_model_server/app/logging_conf.py,sha256=7tbT93F-4nI-nV4elIMO2qH6wjSjxv0wJqMq29LguHg,2136
+bgesdk/management/model_runtime/server/wheels/bge_model_server-0.1.0-py3-none-any.whl,sha256=19tYhZDirz4TFIkdlqCSYFTYa8BLTHtwgTgiW_nLWak,10833
+tests/__init__.py,sha256=j8Fx8bTZqzgLNvUqMha2M2uIijQ8RVB_JyL6I0t_Kjk,37
+tests/conftest.py,sha256=Qs2XagiteN7lIzLnvVb__NOzhc3ANswZNZ0SAm58RPA,4891
+tests/test_abundance.py,sha256=iW5KKo6o1Ipjcab6FlVi7y1_64i7uReKlekNC65srm0,3981
+tests/test_api_offline.py,sha256=z0PzieLS8AoFD4Ce-DjUSw3lIUtAf_Qi1I-MuWIWEPw,5455
+tests/test_api_structure.py,sha256=fH_DjncnIMFlXKGKLzrvdWYkYkaIue-oipu8uFErJxM,3218
+tests/test_error.py,sha256=x7Z7sFr0U80Dy4WcJe5ZrG8QYRdhZRlSMnMSml52Q_Y,6392
+tests/test_fs.py,sha256=0UaMp0fxMpHOZ7--AsPY4AkOAU7yEsf0J42wYIDWz70,212
+tests/test_model.py,sha256=bh6fB2wBc1QI3C_znPzl39dPsFPmHSkxkQBui-Lz3NQ,468
+tests/test_models.py,sha256=5a01_XnPG5OjeM0AXM1_CCr_KKTUA9uymIjYjAMmy40,740
+tests/test_models_offline.py,sha256=wLZTHcfAKQKBZ9srUUJVoCtY1suXqNxTGoNjK4IEoAs,1431
+tests/test_oauth2.py,sha256=xBAPkcKFqSHWDESjgGK7iwyNPTa7N4k4rr4edE_GjAo,1081
+tests/test_phenotype.py,sha256=dUUi-RFTlYoEccAIhZvNyU4YVWcyLHSTc9SRKC0KYZU,2358
+tests/test_samples.py,sha256=lEZVmHcLMob2G3m_M98rLv_l97wsrnsGEYpLkM6XOBw,3263
+tests/test_token.py,sha256=ITovDYGl4wF_0OhdmxPmGaeDJHfcvF7weYEgBwf0fbc,4452
+tests/test_user.py,sha256=niSpc6VAKgZvYJwdLoh1A6qCnx-LHJ4pwnxnF82RVQk,456
+tests/test_variants.py,sha256=xeX3mG0pvAG3ISwijy25X_0W4rnSTzSR-HP6UNgN6L8,3003
+tests/test_wgs.py,sha256=qTTsKsKW_9tjJeq9X6LEoY8rH1EvtEve-sbI5qHjUZA,2385
+bge_python_sdk-2.0.0.dist-info/LICENSE,sha256=zi-c1gi0KJQqPnxQdodJIL4vCjr3B3-bHHsh4YP-MYk,1063
+bge_python_sdk-2.0.0.dist-info/METADATA,sha256=3NsJn14s-GLoVgbexfC6iLNKjkAN8-cR98_JRLvqqUw,7689
+bge_python_sdk-2.0.0.dist-info/WHEEL,sha256=BNRMDyzLkkcmlv0J8ppDQkk2VED33SesJDynr9ED1gc,91
+bge_python_sdk-2.0.0.dist-info/entry_points.txt,sha256=M09ziNXA78fUAvagzThOuXmri8mVRpQLMyG9uLm34P4,45
+bge_python_sdk-2.0.0.dist-info/top_level.txt,sha256=NnKIxOYEPdm7xMZn2Ls2ceRmJhFzDMqyH5EEJlhyeGQ,25
+bge_python_sdk-2.0.0.dist-info/RECORD,,

{bge_python_sdk-1.0.0.dist-info → bge_python_sdk-2.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.2)
+Generator: setuptools (75.3.4)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{bge_python_sdk-1.0.0.dist-info → bge_python_sdk-2.0.0.dist-info}/top_level.txt

@@ -1,2 +1,3 @@
 bgesdk
+completions
 tests

bgesdk/__init__.py

@@ -1,5 +1,5 @@
-#-*- coding: utf-8 -*-
-
-from .client import OAuth2, API, endpoints
+from .client import API, OAuth2, endpoints
 from .fs import FileItem
-from .version import __version__
+from .version import __version__
+
+__all__ = ['API', 'OAuth2', 'endpoints', 'FileItem', '__version__']

bgesdk/__main__.py

@@ -1,64 +1,51 @@
+from . import version
+from .management import commands as commands_package
+from .management.command import CommandError, GroupedRichHelpFormatter
+from .management.utils import discover_commands, output
+
+from typing import Any
 
 import argparse
 import sys
 
-from importlib import import_module
-
+argcomplete: Any = None  # 提供 shell 自动补全（可选依赖），未安装时为 None
 try:
-    import readline
+    import argcomplete  # type: ignore[no-redef]
 except ImportError:
     pass
 
-from . import version
-from .management.command import BaseCommand
-from .management.utils import get_commands
+try:
+    import readline  # noqa: F401  # 启用交互式历史/补全等副作用
+except ImportError:
+    pass
 
 
 def init_parser():
     parser = argparse.ArgumentParser(
-        description=('BGE 开放平台 SDK 命令行工具提供了初始化模型脚手架、部署模型、'
-                     '初始化模型文档配置文件、上传图片、部署模型文档等命令。'),
-        formatter_class=argparse.ArgumentDefaultsHelpFormatter
+        description=(
+            'BGE 开放平台 SDK 命令行工具提供了初始化模型脚手架、部署模型、'
+            '初始化模型文档配置文件、上传图片、部署模型文档等命令。'
+        ),
+        formatter_class=GroupedRichHelpFormatter,
     )
     parser.add_argument(
         '-V',
         '--version',
         action='version',
         help='显示当前 BGE 开放平台 Python SDK 版本号。',
-        version='version {}'.format(version.__version__)
+        version=f'version {version.__version__}',
     )
-    try:
-        subparsers = parser.add_subparsers(
-            dest='command',
-            help='SDK 命令行工具可选子命令。'
-        )
-    except TypeError:
-        # required: Whether or not a subcommand must be provided, 
-        # by default False (added in 3.7)
-        subparsers = parser.add_subparsers(
-            dest='command',
-            help='SDK 命令行工具可选子命令。',
-            required=False
-        )
-    command_names = get_commands()
-    sort_items = []
-    for sub_command_name in command_names:
-        module = import_module(
-            'bgesdk.management.commands.{}'.format(sub_command_name)
-        )
-        command_klass = getattr(module, 'Command', None)
-        if command_klass and not issubclass(command_klass, BaseCommand):
-            continue
-        order = int(getattr(command_klass, 'order', 1))
-        sort_items.append((order, sub_command_name, command_klass))
-    sort_items.sort()
-    for _, sub_command_name, command_klass in sort_items:
-        command_klass(subparsers, sub_command_name)
+    subparsers = parser.add_subparsers(
+        dest='command', help='SDK 命令行工具可选子命令。', required=False
+    )
+    discover_commands(commands_package, subparsers)
     return parser
 
 
 def main():
     parser = init_parser()
+    if argcomplete is not None:
+        argcomplete.autocomplete(parser)
     if len(sys.argv) < 2:
         parser.print_help(sys.stderr)
         sys.exit(1)
@@ -68,7 +55,12 @@ def main():
         args.method(args)
     except KeyboardInterrupt:
         sys.exit(1)
+    except CommandError as exc:
+        sys.exit(exc.code)
+    except Exception as exc:  # noqa: BLE001  统一兜底，避免原始堆栈泄露
+        output(f'[red]命令执行出错：{exc}[/red]')
+        sys.exit(2)
 
 
-if '__main__' == __name__:
+if __name__ == '__main__':
     main()

bgesdk/api/__init__.py

@@ -0,0 +1,5 @@
+"""按域拆分的 API 子模块包。"""
+
+from .api import API
+
+__all__ = ['API']

bgesdk/api/api.py

@@ -0,0 +1,29 @@
+"""API 客户端聚合层。
+
+按域将能力拆分为多个 Mixin（Samples / Variants / Microbiome / File / Model /
+Stream / Misc），由本模块聚合为 ``API`` 类。对外公开接口与历史 ``client.API``
+保持一致，调用方无需变更（``api.get_samples(...)`` 等照常可用）。
+"""
+
+from .file import FileMixin
+from .microbiome import MicrobiomeMixin
+from .misc import MiscMixin
+from .model import ModelMixin
+from .samples import SamplesMixin
+from .stream import StreamMixin
+from .variants import VariantsMixin
+
+
+class API(
+    SamplesMixin,
+    VariantsMixin,
+    MicrobiomeMixin,
+    FileMixin,
+    ModelMixin,
+    StreamMixin,
+    MiscMixin,
+):
+    """BGE 开放平台接口调用客户端。
+
+    基础设施与账户域由 ``APIBase`` 经各 Mixin 间接继承提供，其余按业务域分散于各 Mixin。
+    """

bgesdk/api/base.py

@@ -0,0 +1,210 @@
+"""API 基础设施与账户域方法（基类）。
+
+本模块承载：
+* 服务可用性检查 ``alive`` 与上传进度回调 ``progress_callback``（模块级函数）；
+* ``APIBase``：鉴权、请求创建与账户域（introspect / get_user / get_overview）方法。
+其余按域方法拆分到同级 Mixin 模块，最终由 ``bgesdk.api.api.API`` 聚合。
+"""
+
+from __future__ import annotations
+
+from .. import constants, models
+from ..error import BGEError
+from ..http import HTTPRequest
+from ..utils import human_byte, new_logger
+
+from typing import Any
+
+import sys
+import threading
+
+
+def progress_callback(bytes_consumed: int, total_bytes: int) -> None:
+    sys.stdout.write(
+        '\r文件大小: {}, 上传进度: {}%, 已上传 {}'.format(
+            human_byte(total_bytes, 2),
+            '%.2f' % ((bytes_consumed / total_bytes) * 100),
+            human_byte(bytes_consumed, 2),
+        )
+    )
+    sys.stdout.flush()
+
+
+def alive(self) -> bool:
+    """检查服务可用性
+
+    Returns:
+        布尔型: True 代表可用, False 代表不可用
+    """
+    timeout = self.timeout
+    verbose = self.verbose
+    max_retries = self.max_retries
+    request = HTTPRequest(
+        self.endpoint, max_retries=max_retries, verbose=verbose
+    )
+    try:
+        request.get('/ping', timeout=timeout)
+    except Exception:
+        return False
+    return True
+
+
+class APIBase:
+    """BGE 开放平台接口调用客户端基类（基础设施 + 账户域）。"""
+
+    token_type = 'Bearer'
+    alive = alive
+
+    _token: Any | None
+    _token_leeway: int
+    _token_lock: Any
+
+    def _ensure_access_token(self) -> None:
+        """调用前确保 access_token 有效：自定义 provider 或内置刷新。"""
+        with self._token_lock:
+            if self.token_provider is not None:
+                token = self.token_provider()
+                if token:
+                    self.access_token = token
+                return
+            if self._token is not None and self._token.is_expired(
+                self._token_leeway
+            ):
+                self._token = self._token.refresh()
+                self.access_token = self._token['access_token']
+
+    def __init__(
+        self,
+        access_token: str | models.Model,
+        endpoint: str | None = None,
+        max_retries: int | None = None,
+        timeout: int | None = 18,
+        verbose: bool = False,
+        token_provider: Any | None = None,
+    ) -> None:
+        self.token_provider = token_provider
+        self._token = None
+        self._token_leeway = 60
+        self._token_lock = threading.RLock()
+        if token_provider is None and hasattr(access_token, 'is_expired'):
+            # 传入的是带刷新能力的 token 对象，启用内置自动续期
+            self._token = access_token
+            assert isinstance(access_token, models.Model)
+            access_token = access_token['access_token']
+        self.access_token = access_token
+        if endpoint is None:
+            endpoint = constants.DEFAULT_ENDPOINT
+        self.endpoint = endpoint
+        if max_retries is not None:
+            max_retries = int(max_retries)
+        self.max_retries = max_retries
+        if timeout is not None:
+            timeout = int(timeout)
+        self.timeout = timeout
+        self.verbose = verbose
+        self.logger = new_logger(self.__class__.__name__, verbose=verbose)
+
+    def _create_request(self) -> HTTPRequest:
+        """创建预配置的HTTP请求对象
+
+        Returns:
+            HTTPRequest: 请求对象；
+        """
+        self._ensure_access_token()
+        verbose = self.verbose
+        max_retries = self.max_retries
+        request = HTTPRequest(
+            self.endpoint, max_retries=max_retries, verbose=verbose
+        )
+        request.set_authorization(self.token_type, self.access_token)
+        return request
+
+    def introspect(self) -> models.Model:
+        """验证当前使用的 access_token 有效性
+
+        Returns:
+            Model: Token 元数据；
+        """
+        timeout = self.timeout
+        request = self._create_request()
+        result = request.get(
+            '/oauth2/introspect',
+            params={'token': self.access_token},
+            timeout=timeout,
+        )
+        return models.Model(result)
+
+    def get_user(self, **params: Any) -> models.Model:
+        """获取用户信息
+
+        Returns:
+            Model: 用户数据；
+        """
+        timeout = self.timeout
+        request = self._create_request()
+        result = request.get('/profile', params=params, timeout=timeout)
+        return models.Model(result)
+
+    def get_overview(
+        self,
+        idcard: str | None = None,
+        phone: str | None = None,
+        biosample_id: str | None = None,
+        project_id: str | None = None,
+        external_sample_id: str | None = None,
+        **kwargs: Any,
+    ) -> models.Model:
+        """获取用户数据概览
+
+        Args:
+            idcard (str, 非必填): 身份证；
+            phone (str, 非必填): 手机号；提供了参数 phone，禁止再提供 biosample_id、
+                project_id、external_sample_id；
+            biosample_id (str, 非必填): BGE 样本编号；提供了参数 biosample_id，禁
+                止再提供 phone、project_id、external_sample_id；
+            project_id (str, 非必填): BGE 项目编号；提供了参数 project_id 必须提
+                供 external_sample_id，且 phone 和 biosample_id 必须为空；
+            external_sample_id (str, 非必填): 外部样本编号；提供了参数
+                external_sample_id 必须提供 project_id，且 phone 和
+                biosample_id 必须为空；
+
+        Returns:
+            Model: 用户数据概览；
+        """
+        data: dict = {}
+        data.update(kwargs)
+        if phone and (biosample_id or project_id or external_sample_id):
+            raise BGEError(
+                '若提供了 phone 参数，则禁止同时提供 biosample_id、'
+                'project_id 和 external_sample_id。'
+            )
+        elif biosample_id and (phone or project_id or external_sample_id):
+            raise BGEError(
+                '若提供了 biosample_id 参数，则禁止同时提供 phone、'
+                'project_id 和 external_sample_id。'
+            )
+        else:
+            if (not project_id and external_sample_id) or (
+                project_id and not external_sample_id
+            ):
+                raise BGEError(
+                    'project_id 与 external_sample_id 必须同时提供。'
+                )
+            if project_id and external_sample_id and (phone or biosample_id):
+                raise BGEError(
+                    '提供 external_sample_id 时必须同时提供 project_id，'
+                    '且 phone 与 biosample_id 必须为空。'
+                )
+        data.update(
+            {
+                'idcard': idcard,
+                'phone': phone,
+                'biosample_id': biosample_id,
+                'project_id': project_id,
+                'external_sample_id': external_sample_id,
+            }
+        )
+        timeout = self.timeout
+        request = self._create_request()
+        result = request.post('/user/overview', data=data, timeout=timeout)
+        return models.Model(result)