魔兽世界插件管理器
项目描述
instawow 是一个魔兽世界的插件管理器。它可以用于从 GitHub、CurseForge、WoWInterface 和 Tukui 安装、更新和删除插件。 instawow 拥有互操作的 CLI 和 GUI、模糊搜索和下载评分等功能。
|
|
安装
您可以从 GitHub 下载 预构建的二进制文件。 bin 用户可以通过运行以下命令来安装 CLI 二进制文件
bin install github.com/layday/instawow
如果您想从源安装 instawow，您可以选择以下方式
pipx: pipx install instawow
Vanilla pip: python -m pip install -U instawow
Nix 或 NixOS: instawow 的 CLI-only 版本作为 instawow 包提供
CLI 操作
tl;dr
首先运行 instawow reconcile 以将之前安装的插件与 instawow 注册（或使用 instawow reconcile --auto 无需用户输入完成相同操作）。要安装插件，可以使用 search 命令搜索它们
instawow search molinari
此外，instawow 能够解析插件 URL 和 instawow-特定的 slug 和主机 ID URI。以下所有操作都将安装 Molinari
instawow install https://www.curseforge.com/wow/addons/molinari instawow install curse:molinari instawow install curse:20338 instawow install https://github.com/p3lim-wow/Molinari instawow install github:p3lim-wow/molinari
您可以像安装它们一样更新和删除插件。如果在不带参数的情况下调用 update，它将更新您安装的所有插件。您可以使用 list --format detailed 列出插件并查看它们的详细信息。对于 list 和类似的非破坏性命令，可以省略源并缩短别名，例如 instawow reveal moli 将在文件管理器中打开 Molinari 插件文件夹。
插件对账
插件对账不是自动的 – instawow 明确指出不会自动假定您对插件的拥有权。然而，您可以使用 reconcile --auto 自动化对账，并且 instawow 将优先考虑 CurseForge 的插件。对账后的插件将重新安装，因为安装的版本无法可靠地提取。
插件搜索
instawow 内置了一个基本的 search 命令，结果根据编辑距离和流行度进行排序。搜索使用汇总的插件目录，每天更新一次。[链接](https://github.com/layday/instawow-data/tree/data)。您可以直接从搜索结果中安装多个插件。
安装策略
插件采用了一些选项，这些选项决定了它们如何被解决
any_flavour 用于忽略游戏版本兼容性，优先选择“affine”游戏版本
any_release_type 用于忽略插件的稳定性
version_eq=[VERSION] 用于安装特定版本的插件
在 CLI 中，您可以在插件 URI 的片段部分传递策略，用逗号分隔，例如 instawow install curse:molinari#any_release_type,any_flavour。策略将被 install 和 update 所尊重。要更新时重置插件的策略，您可以通过传递 = 片段，例如 instawow update curse:molinari#=。
撤销插件更新
instawow 会记录之前安装的插件的所有版本。可以使用 instawow rollback 命令撤销插件更新。已回滚的插件将被固定，并且不会接收更新。可以使用 instawow rollback --undo 撤销回滚，这将使用默认策略安装指定插件的最新版本。
配置文件
instawow 通过配置文件支持多个游戏版本。假设您的默认配置文件已配置为零售版本，您可以使用以下命令创建一个经典版本的纯净配置文件：
instawow -p classic configure
“classic” 只是配置文件名称；您将被要求选择它对应的游戏版本。您可以有相同版本的多达几个配置文件（例如 alpha、beta 和 PTR）。
-p 是一个全局选项。您可以在任何 instawow 命令前加上 -p。例如，要更新您的经典插件，您将运行：
instawow -p classic update
如果存在默认配置文件，则可以省略 -p。
迁移经典配置文件
除了“经典时代”配置文件（在 instawow 中称为 vanilla_classic）外，经典配置文件将在 instawow 支持最新经典版本后开始接收更新。不需要用户干预，只需更新 instawow 即可。
WeakAura 更新器
instawow 包含一个根据 WeakAuras Companion 模仿的弱光环更新器模型。要使用更新器和前提是你已经安装了 WeakAuras
instawow plugins weakauras-companion build instawow install instawow:weakauras-companion
，你需要在更新之前重新构建伴侣插件以接收光环更新。如果你想在每次调用 instawow update 时检查更新，请安装 instawow:weakauras-companion-autoupdate 变体
instawow install instawow:weakauras-companion-autoupdate instawow update
插件
instawow 可以通过插件进行扩展。插件可以用来支持任意主机并为 CLI 添加新命令。你可以在 tests/plugin 中找到一个示例插件。
元数据来源
CurseForge
CurseForge 已计划于 2022 年第一季度末停止使用未经身份验证的插件 API。CurseForge 将有条件地颁发新 API 的密钥，并且插件管理器有义务隐藏。因此，除了通过代理服务，新 API 对于插件管理器来说不可行，而作者无力承担。同时，CurseForge 将为作者提供从新 API 中删除插件选项，并且通过新 API 启动的下载不会计入广告收入共享计划的作者积分。
GitHub
instawow 支持 GitHub 上 发布 的 WoW 插件——也就是说，存储库必须有一个发布（标签不起作用），并且发布必须附加一个作为资产的插件 ZIP 文件。 instawow 不会直接从源、tarballs 或“zipballs”安装或构建插件，也不会验证 ZIP 文件的内容。
透明度
instawow 发起的网络请求可以通过其用户代理字符串识别。
每天启动时，instawow 将查询 PyPI —— 标准的 Python 软件包索引——以检查 instawow 的更新。
贡献
欢迎提交错误报告和修复。在进行任何重大更改之前，请先打开一个问题。
下载文件
下载适合您平台的应用程序文件。如果您不确定该选择哪一个，请了解有关 安装包 的更多信息。