安装指南
========

系统要求
--------

在安装 SpinQLab Link 之前，请确保您的系统满足以下要求：

操作系统支持
~~~~~~~~~~~~

* Windows 10/11
* macOS 10.14+
* Ubuntu 18.04+
* CentOS 7+
* 其他主流Linux发行版

Python 版本
~~~~~~~~~~~

* Python 3.8 或更高版本
* 推荐使用 Python 3.9 或 3.10

依赖库
~~~~~~

SpinQLab Link 依赖以下Python库：

* numpy >= 1.20.0
* matplotlib >= 3.4.0
* pydantic >= 2.0.0
* protobuf >= 3.19.0
* pyqtgraph (用于数据可视化)
* scipy (用于数据分析)

安装方法
--------

从PyPI安装 (推荐)
~~~~~~~~~~~~~~~~~~~~~~~~~

这是最简单的安装方法，适用于大多数用户：

.. code-block:: bash

    # Install using pip
    pip install spinqlablink

验证安装
--------

安装完成后，您可以通过以下方式验证安装是否成功：

.. code-block:: python

    # Import library
    import spinqlablink
    
    # Check version
    print(f"SpinQLab Link version: {spinqlablink.__version__}")
    
    # Test basic functionality
    from spinqlablink import SpinQLabLink, ExperimentType, Pulse
    print("All modules imported successfully!")

常见问题
--------

安装失败
~~~~~~~~

如果遇到安装失败，请尝试以下解决方案：

1. **更新pip**：

   .. code-block:: bash

       pip install --upgrade pip

2. **清理缓存**：

   .. code-block:: bash

       pip cache purge

3. **使用国内镜像（中国用户）**：

   .. code-block:: bash

       pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ spinqlablink

权限问题
~~~~~~~~

在某些系统上可能遇到权限问题：

.. code-block:: bash

    # Linux/macOS: Use the --user option
    pip install --user spinqlablink

    # Or use sudo (not recommended)
    sudo pip install spinqlablink

网络问题
~~~~~~~~

如果遇到网络连接问题：

1. **使用代理**：

   .. code-block:: bash

       pip install --proxy http://proxy.company.com:port spinqlablink

2. **离线安装**：

   .. code-block:: bash

       # Download wheel file
       pip download spinqlablink
       
       # Offline installation
       pip install spinqlablink-*.whl

卸载
----

如需卸载 SpinQLab Link：

.. code-block:: bash

    pip uninstall spinqlablink

下一步
------

安装完成后，您可以：

1. 阅读 :doc:`quickstart` 了解基本使用方法
2. 浏览 :doc:`api/spinqlablink` 了解完整API参考

如果遇到任何问题，请查看 :doc:`etc/contact` 获取帮助。