Skip to content

从源码运行 SRA CLI

This content is not available in your language yet.

本节将介绍如何从源码运行 SRA CLI。

  • Python 3.12(项目要求 >=3.12, <3.13,暂不支持 3.13)
  • Git
  1. 克隆存储库:

    终端窗口
    git clone https://github.com/Shasnow/StarRailAssistant.git

    如果克隆较慢,考虑使用浅层克隆

    终端窗口
    git clone https://github.com/Shasnow/StarRailAssistant.git --depth=1
  2. 进入项目目录:

    终端窗口
    cd StarRailAssistant
  3. 创建并激活虚拟环境:

    终端窗口
    python -m venv .venv
    .venv\Scripts\activate
  4. 以可编辑模式安装项目及桌面端依赖:

    终端窗口
    pip install -e ".[standard]"

    standard 包含桌面端运行所需的键鼠模拟、剪贴板与通知等依赖;如需运行服务端(WebUI / HTTP API / MCP),改用 .[server]。 如果安装较慢,考虑使用国内镜像源,例如清华大学的 PyPI 镜像:

    终端窗口
    pip install -e ".[standard]" -i https://pypi.tuna.tsinghua.edu.cn/simple
  5. 运行 SRA:

    终端窗口
    python main.py

    安装完成后也可以直接使用命令行入口:

    终端窗口
    sra

    这会让你进入 SRA 的交互式命令行界面,你应该看到下面的输出:

    # ... 这些是一些调试信息
    欢迎使用 SRA-cli(版本 2.26.0,内核 2.26.0 on win32)。
    输入 'help' 查看命令列表。
    sra>
  6. 运行任务,或进行其他操作: 参考 SRA-cli 章节了解如何使用 SRA-cli。

  7. 尝试一下:

    • 运行 help 命令查看可用命令。
    • 运行 version 命令查看当前 SRA 版本。
    • 运行 exit 命令退出 SRA-cli。
  • SRA 提示 WARNING | 您没有以管理员权限运行 SRA-cli。某些命令可能无法正常工作。:
    • 考虑以管理员权限运行终端,然后重新执行步骤 5。
    • 如果您使用 Pycharm 等 IDE,请确保以管理员权限运行 IDE。
    • 或使用 --no-admin 禁用此检查。