扩展市场使用文档

风险提示：扩展市场提供的是策略和工具的分发能力，不承诺任何收益。任何扩展蓝图在实盘前都必须先回测，再模拟运行，最后才考虑小资金实盘。交易所 API 不要开启提币权限。

打开程序后，在顶部导航进入 扩展 页面。

页面分为左右两部分：

左侧和右侧之间的分隔条可以拖动，用来调整 我的扩展 面板宽度。

我的扩展 面板用于管理和查看与你当前环境相关的扩展。

这里可能出现两类内容：

• 已经下载安装到本机的扩展。
• 当前登录账号在云端拥有或添加过的扩展。

需要注意：程序判断一个扩展是否“已安装”，主要看本机是否存在对应的市场蓝图文件，而不是只看云端账号列表。因此，某个扩展即使在云端属于你，如果当前电脑还没有下载到本地，仍可能显示为未安装状态。

常见标记：

常见操作：

扩展市场首页会展示可安装扩展列表。默认排序会优先显示下载量更高、评分更高的扩展。

你可以用以下方式缩小范围：

• 关键词搜索：在搜索框输入扩展名称、作者、简介、分类、市场类型等关键词后，点击 搜索 或按回车。
• 分类筛选：按扩展分类查看，例如策略、风控、信号、工具等。具体分类由市场后台返回。
• 市场类型筛选：按扩展支持的市场过滤，例如 Spot 或 Futures。

如果搜索后没有结果，可以清空关键词，并把分类和市场类型切回 全部。

市场列表里的每张扩展卡片会展示关键信息：

蓝图扩展通常更适合直接用于策略流程；脚本类或工具类扩展的使用方式需要阅读详情说明。

点击扩展卡片后会进入详情页。详情页由头部信息、说明区、评论区和右侧信息栏组成。

详情页重点看这些内容：

如果详情页显示“暂无扩展说明”或“暂无更改日志”，表示发布者没有提供对应内容。此时更应谨慎使用，先做充分回测。

安装步骤：

1. 进入 扩展 页面。
2. 在市场列表中搜索或筛选目标扩展。
3. 点击扩展卡片进入详情页。
4. 阅读 细节、更改日志、评论和回测信息。
5. 点击 安装。
6. 如果扩展需要提取码，按弹窗输入提取码并确认。
7. 等待安装成功提示。
8. 进入 蓝图 页面或资源管理，查看新安装的市场蓝图。

安装蓝图扩展时，程序会把扩展包下载到本机市场蓝图目录，并刷新蓝图工作区。安装成功后，扩展会带有市场来源信息、版本信息、包校验信息和下载时间，用于后续识别安装状态和版本升级。

安装可能需要对应权限。如果当前账号没有下载权限，程序会弹出权限提示。

扩展市场支持多种下载方式：

提取码扩展在安装时会弹出输入框。提取码为空或不正确时，安装不会继续。请检查大小写、空格和有效期。

蓝图扩展支持 回测预览。它适合在安装前快速判断扩展是否值得进一步使用。

回测预览的特点：

• 仅蓝图扩展支持回测预览。
• 回测预览会从市场获取远程蓝图预览，不会直接写入本机蓝图文件。
• 程序会先检查蓝图能否编译，再打开回测窗口。
• 回测窗口会自动开始运行。
• 默认交易对优先使用蓝图已有配置；没有配置时使用 BTCUSDT。

默认回测时间范围会根据蓝图执行周期自动决定：

预览回测结果只代表历史数据下的一次测试表现。正式使用前，建议安装后在 蓝图 页面重新设置交易对、周期、手续费、滑点、资金、杠杆和更长时间范围，再做多组回测。

蓝图扩展安装成功后，会进入本地蓝图工作区。推荐使用流程：

1. 打开 蓝图 页面。
2. 在蓝图列表或资源管理中找到已安装的市场蓝图。
3. 打开蓝图，先检查节点结构、参数、执行周期、市场类型和风控节点。
4. 运行历史回测，确认盈亏、回撤、胜率、交易次数和订单日志。
5. 在 交易 页面把蓝图挂载到目标图表或账户下。
6. 先使用模拟交易模式运行，观察信号触发、下单意图和风控拦截。
7. 确认行为稳定后，再考虑使用小资金实盘。

实盘前重点检查：

• 当前账户是否正确。
• 交易对和市场类型是否匹配，例如现货或合约。
• 杠杆、保证金模式、仓位比例是否在可承受范围内。
• 策略是否包含限频、最大仓位、止损、冷却、熔断等风控。
• API 是否只开启必要权限，不要开启提币权限。

当已安装扩展出现 可升级 标记时，可以在详情页或 我的扩展 面板点击 升级。

升级前建议先做三件事：

1. 查看 更改日志，确认新版本改了什么。
2. 停止正在运行的蓝图挂载。
3. 记录当前版本的核心参数和回测结果，方便对比。

升级规则：

• 只有蓝图扩展支持当前安装态下的版本升级判断。
• 如果当前已是最新版本，会提示无需升级。
• 如果该蓝图扩展存在正在运行的挂载，程序会拒绝升级，需要先停止挂载。
• 如果存在未运行的挂载，升级确认弹窗会提示数量；确认升级后，程序会同步这些挂载里的蓝图版本快照。
• 升级会保留本地蓝图 ID，并清理同一市场扩展的旧版本文件。

升级完成后，不要直接恢复实盘运行。建议先回测新版本，再模拟运行，确认行为符合预期。

卸载会删除本机对应的市场蓝图文件，并从当前用户扩展关系中移除。

卸载步骤：

1. 在 我的扩展 或详情页找到目标扩展。
2. 点击 卸载。
3. 阅读确认弹窗。
4. 确认后等待卸载完成。

卸载规则：

• 如果扩展存在正在运行的挂载，程序会拒绝卸载，需要先停止挂载。
• 如果扩展存在未运行的挂载，确认卸载后会一并清理这些挂载。
• 卸载完成后，蓝图工作区会刷新，扩展不再作为本机已安装扩展展示。

如果只是暂时不想让策略交易，优先停止挂载或关闭自动交易；只有确认不再使用时再卸载。

已安装扩展可以在详情页点击 评分。

评分规则：

• 需要选择 1 到 5 星。
• 需要填写评论内容。
• 提交成功后，评论区会刷新。
• 如果评论接口有短暂延迟，程序会先把本次评论临时显示在本地列表中，后续刷新时再以服务端数据为准。

评论区可能显示普通用户、作者和管理员回复。作者或管理员身份只代表评论来源，不代表策略收益保证。

先检查网络和登录状态，然后点击 我的扩展 旁边的刷新按钮或重新进入 扩展 页面。如果市场接口暂时不可用，列表可能为空。

清空关键词，把分类和市场类型切回 全部。搜索只会在当前市场列表内匹配名称、作者、简介、分类、下载方式和市场类型等字段。

这通常表示当前电脑还没有本地安装文件。点击 下载并安装，安装完成后才会变成 已安装。

可能原因包括下载地址不可用、网络异常、提取码错误、账号没有下载权限、扩展包格式异常或蓝图编译校验失败。可以先刷新市场并重试；提取码扩展需要确认提取码正确。

先切换到 蓝图 页面并刷新资源管理。如果仍然看不到，回到 扩展 页面刷新。安装态以本机市场蓝图文件为准，本地文件被删除或目录不可写都会影响显示。

可能是远程预览蓝图获取失败、蓝图编译失败、回测窗口未准备好，或当前行情数据不可用。可以进入详情页重新点击 回测预览，或安装后在蓝图页面手动回测。

如果没有 可升级 标记，说明当前版本已经是最新版本，或版本号无法可靠比较。如果有正在运行的挂载，需要先停止挂载再升级。

如果该扩展有正在运行的挂载，程序会阻止卸载。先到交易或资源管理中停止对应挂载，再回到扩展市场卸载。

确认当前账号有评分权限，并检查网络状态。评分必须选择星级且填写评论内容。

第一次使用扩展市场，建议按这个顺序操作：

1. 在 扩展市场 搜索或筛选目标扩展。
2. 打开详情，阅读说明、更改日志、评论和回测信息。
3. 对蓝图扩展先运行 回测预览。
4. 安装扩展。
5. 到 蓝图 页面重新回测，并检查参数和风控。
6. 在模拟交易模式挂载运行。
7. 观察日志、订单、风控拦截和账户变化。
8. 通过多组验证后，再考虑小资金实盘。
9. 升级前先停止运行挂载，升级后重新回测。
10. 不再使用时先停止挂载，再卸载扩展。