从源代码安装

💡 需要 Python 3.9 或以上版本。

第一步：克隆仓库到本地

git clone https://github.com/ninthDevilHAUNSTER/ArknightsAutoHelper
cd ArknightsAutoHelper

第二步：（建议）配置 venv 避免依赖包冲突

💡 如果您正在使用 Windows，可以通过项目根目录下的 一键配置环境.bat 一键配置。

创建 venv 环境

python3 -m venv venv

激活 venv

💡 请根据您使用的命令行环境选择对应的命令。

如果您正在使用 Windows 命令提示符：

venv\Scripts\activate.bat

如果您正在使用 PowerShell：

& ./venv/[bS]*/Activate.ps1

💡 venv 在 Windows 上生成 venv/Scripts，在其他系统上生成 venv/bin

⚠️ 注意：venv 会生成 UTF-8 编码的 Activate.ps1 并在其中写入当前路径，Windows PowerShell（系统自带版本）可能无法正常解析其中的非 ASCII 字符。

如果您正在使用 bash/zsh：

source venv/bin/activate

第三步：安装依赖

Python 依赖

pip install -r requirements.txt

原生 OCR 依赖

本项目目前使用 Tesseract OCR，repo 内包含识别模型及 Windows amd64 执行文件。

Linux/macOS 用户可通过包管理器或 homebrew 安装，如：

apt install tesseract-ocr  # Debian / Ubuntu
pacman -S tesseract        # Arch Linux
brew install tesseract     # Homebrew on macOS or Linux

开始使用

请继续阅读 README 文档后续部分的使用说明。

如果您打开了一个新的命令行环境，请重新执行激活 venv 步骤。