Skip to content

Plugins zh CN

ArchiBot edited this page Apr 2, 2024 · 46 revisions

插件

ASF 支持在运行时加载自定义插件。 插件允许您自定义 ASF 行为,例如添加自定义命令、自定义交易逻辑或者与其他第三方服务与 API 进行整体集成。

This page describes ASF plugins from users perspective - explanation, usage and likewise. If you want to view developer's perspective, move here instead.


用法

ASF 会从 ASF 目录内的 plugins 文件夹加载插件。 建议(如果启用插件自动更新,则是强制要求)您根据插件名称,将每个您需要使用的插件放在专门的文件夹内,例如 MyPlugin。 这样最终的文件夹结构为 plugins/MyPlugin。 最后,这个插件的所有二进制文件都应该被放在这个专门的文件夹内,而 ASF 会在重启之后自动发现并启用您的插件。

通常,插件开发者会以 zip 文件形式发布插件,其中包含二进制文件,这意味着您需要将 zip 文件解压到 plugins 文件夹下的某个单独的子文件夹。

如果插件成功加载,您将会在日志内看到它的名称和版本。 在遇到与您使用的插件有关的问题、漏洞或者对其用法有疑问时,您应该咨询相应插件的开发人员。

我们在​第三方项目​章节列出了一些精选插件。

请注意,ASF 插件可能是有害的。 您应该始终确保您使用插件来自于您可以信任的开发人员。 如果您决定使用任何自定义插件,ASF 开发者将不再保证您的正常 ASF 权益(例如不保证没有恶意软件或者 VAC 安全)。 您应当理解,一旦被加载,插件就可以完全控制 ASF 进程,因此我们亦无法对使用自定义插件的 ASF 提供支持,因为您运行的不再是标准 ASF 代码。


兼容性

Depending on plugin's complexity, scope and a lot of other factors, it's entirely possible that it'll require from you to use generic ASF variant, instead of usually recommended OS-specific. This is because OS-specific variant comes only with core functionality required for ASF itself, and your plugin may require parts that fall outside of main ASF scope, in result being incompatible with trimmed OS-specific builds.

In general, when using third-party plugins, we recommend using ASF generic variant for maximum compatibility. However, not all plugins may require it - please refer to your plugin's information in order to find out whether you need to use generic ASF variant or not.

Clone this wiki locally