插件原理与编写

原理

交易插件是一段在托管者上执行的短代码：在交易终端页面点击「执行」时，平台把插件代码和模块选定的交易所账户发送到选定的托管者执行，执行结束后把返回值显示在模块中。下面几个入口使用同一种执行机制：

入口	执行的代码	说明
交易终端插件	策略库中类型为「交易插件」的策略	在交易终端页面添加、执行
调试工具（开发工具）	页面中临时编写的JavaScript代码	用于测试API调用
扩展API接口PluginRun	请求中的source，或账号中已有的策略	供程序调用
MCP的plugin_*工具	平台内置的查询行情、下单等函数	供AI助手调用，按trade权限授权，见AI接入

这种执行方式不创建实盘、不计费，单次执行最长5分钟，超时中断。适合辅助手动交易的简单任务，例如冰山委托、批量挂单撤单、计算；需要长期运行的逻辑应创建实盘。

编写

在新建策略页面把策略类型设置为「交易插件」即可创建交易插件。交易插件、调试工具和PluginRun都只支持JavaScript。

插件的入口是main()，返回值就是执行结果：返回表格对象、图表对象时，在模块中显示为表格、图表（示例见插件示例）。插件中Log()输出的日志不会在模块中显示。

使用

• 添加：在交易终端页面打开模块添加菜单，账号策略库中的交易插件会出现在列表中，选择需要的插件添加。
• 执行：点击插件模块中的「执行」运行插件。

数据目录

插件和调试工具在托管者上执行时，以托管者运行目录下的logs/storage/p<数字>/为工作目录（每个平台账号一个以p开头的目录，第一次执行后创建）。如果交易终端使用的交易所账户以密钥文件路径（file:///xxx.txt）的方式配置密钥，需要把密钥文件放在这个目录中。