寻求帮助

如果你在安装过程中有疑问，可以提交 Issue，或者加入 Alas 的 Discord 或 QQ 群询问，链接在 README.md 中。

注意（加群潜规则，雾）：

自动安装包仅适用于 Windows 系统，Mac 和 Linux 系统下的安装需要按照手动安装教程进行。

在 Github Releases (opens new window) 下载最新的自动安装包，但不要下载源码的 zip 压缩包。

下载完成后解压安装包。完整安装将需要约 1.5 GB 的空间。

阅读安装配置文件 config/deploy.yaml 中的注释，并根据自己的情况修改。这被认作是 Alas 的使用门槛。

对于国内用户，主要需要修改两处，其他保持默认即可。

双击打开 Alas.exe，自动安装程序将完成从拉取项目，安装环境到准备 ADB 的步骤。自动安装通常需要花费 2 - 3 分钟，期间请耐心等待。安装完成后，Alas 桌面端将自动打开。

添加至白名单即可。Alas.exe 是一个由 bat 打包而成的 exe，可能会有杀毒软件误报。如果你不放心，可以使用 deploy/install/Alas.bat 替换 Alas.exe，它们的功能是一样的。

正如安装器所提示的，你需要检查安装配置文件 config/deploy.yaml 是否设置正确，然后重新打开 Alas.exe。对于国内用户而言，通常是由于没有按照 “编辑安装设置” 一节，修改为国内源，而导致的。

这是因为国内的 pypi 镜像不稳定，你可以尝试重新打开 Alas.exe。如果问题未能解决，可以尝试其他国内镜像。

你可以尝试使用 CTRL+R 刷新页面，以及尝试 Issue #876 (opens new window) 中的解决方案。

Alas 安装包里的内容都是便携的，直接删除即完成卸载。你也可以利用这个特性，将已完成安装的 Alas 复制到别的电脑上。

如果你在删除的过程中，遇到文件被占用无法删除的情况，可以尝试打开 console.bat，并在里面运行：

安装一款模拟器，并在上面安装碧蓝航线。但不要使用 Mumu 手游助手（俗称黄 Mumu），因为它没有 ADB。

进入你的模拟器的设置，将分辨率设置为 1280x720 和 平板模式 。

如果你使用的是蓝叠模拟器或雷电模拟器，你还需要在模拟器设置中打开 ADB。

双击打开 Alas.exe，即开始运行 Alas。

Alas 启动时，将自动检查更新，你不需要进行其他操作。绝大多数时候，版本更新都可以通过这个方式自动完成，但遇到与桌面端相关的大版本更新的时，你需要重新下载并安装客户端。

在安装之前，从旧的客户端找到安装配置 config/deploy.yaml，和用户设置 config/alas.json。如果你使用了多开，需要找到他们的设置 config/*.json，例如 config/alas2.json。

将它们复制到新安装包的 config 目录下，像往常一样安装。

如果你正在或者有意开发 Alas，已经 Clone 了 Alas 的仓库，创建了虚拟环境，安装了相关依赖，配置了 ADB，那么就不需要再安装一份了。

注意：使用快捷方式会绕开 Alas 启动器，导致你需要手动更新 Alas。因此，这种方法仅推荐给开发人员使用。

Alas 客户端的本质，或者说 Electron 的本质，是 Node.js 服务器 + Chromium 浏览器。因此，你只需要以一下方式中的一种，启动 Alas 的 web server：

然后你就可以在 http://127.0.0.1:{port} 访问 Alas，port 默认是 22267。

如果你有幸拥有固定的公网 IP，可以直接通过 http://{ip}:{port} 在其他设备上访问 Alas。如果你没有固定的公网 IP（大部分国内用户都是如此），可以使用内网穿透服务，比如 frp (opens new window) ，以在外部访问 Alas。

注意：将 Alas 暴露到公网上是危险的，任何人都可以停止你的 Alas 或修改你的设置，更糟的是，Alas 自身是不能抵御注入和攻击的。

手动安装教程是为开发者编写的，使用手动安装教程需要有基本的编程知识。如果你不是正在或者有意开发 Alas，那么建议使用自动安装器，不需要阅读这一章节。Mac 和 Linux 系统下也需要手动安装。

请使用 Git，不要直接下载源码的 zip 压缩包。

假设你希望安装在 D:/AzurLaneAutoScript，那么就在 D:/ 执行：

如果你遇到了网络连接问题，重试即可

由于 Alas 使用 python 版本和依赖都比较旧，这里建议创建一个新的 python 虚拟环境，而不是使用你本机安装的 python。下面以 Anaconda 为例创建虚拟环境，当然，你也可以使用 venv 等。

如果你遇到了网络连接问题，重试即可

如果你遇到了 pip 需要更新的问题

可以执行以下命令解决，也可以无视

如果你在安装 Python-Levenshtein 的时候遇到 Microsoft Visual C++ 14.0 is required，可以在 这里 (opens new window) 下载它的 wheel 文件，然后用 pip 安装

python 版本必须为 3.7.6，假设你刚才clone的目录为/Users/你的用户名/Desktop，（本文默认python3为python3.7, 因为你的mac可能不只有一个python3, 如果执行python3发现版本不为3.7.6时，将命令中python3换为python3.7, pip3换成pip3.7）

选择一款模拟器，并在上面安装碧蓝航线，模拟器分辨率设置为 1280x720 。

不要使用 Mumu 手游助手（俗称黄 Mumu），因为它没有 ADB。

经测试，主流模拟器在高配电脑上无显著性能差异，如果你已经在使用一款模拟器了，也不需要更换。

如果你使用的是雷电模拟器（LDPlayer）或者蓝叠模拟器（BlueStacks）等，需要在模拟器的设置中启用 ADB。

Mac版Mumu的分辨率若设置为1280x720仍不成功需要按照它提示的内容进行等比例缩放

​ 如：提示为1664x936，则1664/1280 = 1.3，1280/1.3 向上取整为985；720/1.3 向上取整为554，故须设置为985x554

配置 ADB。

在 这里 (opens new window) 获取最新的 ADB，并把它配置于环境变量中。

由于新版macOS不支持直接将文件放入/usr/bin中，提供两种结局方案：

​ 1、关闭SIP文件保护系统后再放进去（不推荐，故不进行教学）；

​ 2、放入任意文件夹然后将该文件夹加入环境变量；

​ 如：我在/Users/你的用户名下创建文件夹bin存放adb，则在环境变量文件中添加

​ PATH=$HOME/bin/:$PATH 即可，篇幅有限故不做赘述，不明白上网搜索即可

替换模拟器的 ADB。

由于国产模拟器都带有私改的 ADB，而不同版本的 ADB 会互相结束对方。为了避免这个问题，需要统一使用最新的 ADB。前往你的模拟器的安装根目录，寻找 adb.exe，用刚才配置于环境变量中的 ADB 替换它。如果你装有多款模拟器，建议全部都替换掉，以防止你在打开其他模拟器的时候 ADB 的连接被断开。

以夜神模拟器为例，夜神模拟器安装目录下有两个 ADB，adb.exe 和 nox_adb.exe ，备份它们并删除。复制两份 adb.exe 到夜神模拟器安装目录，重命名为 adb.exe 和 nox_adb.exe。

替换完成后，关闭你所有的模拟器，再重新打开，执行

Mac替换模拟器的 ADB

以Mumu模拟器为例，它在Mac中的adb存储路径为

将这个adb用上一步中的/Users/你的用户名/bin中的adb替换即可

替换完成后，关闭你所有的模拟器，再重新打开，执行

安装 uiautomator2 (opens new window)，这是一个自动化测试的库。在安装前，需要先打开你要使用的模拟器。

打开AzurLaneAutoScript目录下的module/device/connection.py，先进行备份

然后

保存文件即可

桌面客户端是跨平台的，Windows，Mac 和 Linux 系统下均可以构建。

← AzurLaneAutoScripts 设备支持文档 →