如何安装 AlgoRover Research：云端与本地完整教程

先选择云端运行或本地运行

云端 Research 在服务器执行历史回测，无需准备本地回测环境，当前云端插件支持 Codex。云端支持从已发布策略中选择可用预设和市场，运行 90 天或 365 天历史回测。下面先介绍云端的完整流程。

本地版在你的电脑执行研究任务，支持 Codex 或 Claude Code，安装方法见本文的本地运行部分。安装无需注册；使用回测需要登录 AlgoRover 产品账户。两种方式的回测都无需交易所账户或交易所 API 密钥。

第一步：安装并连接云端 Research

打开支持插件命令的 Codex CLI，在电脑终端中依次运行下面三条命令。最后一条会发起 AlgoRover 登录与授权。

如果 Codex 无法识别 plugin 命令，先确认使用的是支持插件的 Codex CLI 版本。官方安装说明可核对当前的安装要求。

codex plugin marketplace add algorover/algorover-research
codex plugin add algorover-research-cloud@algorover-research-github
codex mcp login algorover-research --oauth-client-registration dcr --scopes research:read,research:run

第二步：登录产品并允许授权

浏览器打开后，按页面指引注册或登录 AlgoRover 产品账户。使用 Google 登录时，看到登录成功后，还需要返回 Research 的授权页，点击“允许授权”。完成后回到 Codex，新建一个对话。

读取权限 research:read 用于查看你的任务和报告；运行权限 research:run 用于启动或取消回测。登录成功与插件授权是两个步骤，完成授权后再继续。

第三步：查找策略，选择可用版本与市场

在新的 Codex 对话里，先让 AI 查询已发布的策略，了解可用版本、预设与市场。选择目录实际提供的选项，再继续预览配置。也可以先打开网页策略目录，再把选中的策略名称或标识告诉 AI。

请通过 AlgoRover Research 查找已发布的 BTC 策略，列出可用的策略标识、版本、预设和市场。先让我选择策略，不要启动回测。

第四步：预览回测配置，再确认启动

选好策略后，让 AI 预览一次 90 天回测；如果选择 365 天，请在请求中说明。核对策略标识与版本、预设、市场、日期范围及页面展示的其他设置。需要调整时重新预览，确认配置后再要求启动。

下面的请求用于预览。AI 展示配置后，你可以继续说：“我确认使用刚才展示的配置，请启动这次云端回测。”不要在还没核对配置时直接确认。

请为我刚选中的策略预览一次 90 天云端回测，展示策略标识、版本、预设、市场、日期范围和可用的配置说明。先不要运行，等我确认。

第五步：查看进度，或取消运行中的任务

启动后保留任务编号。你可以让 AI 查看当前进度；有多个任务时，带上对应任务编号，避免选错。也可以登录同一个 AlgoRover 账号，在网页查看研究记录。

需要取消时，可以明确告诉 AI：“请取消任务编号为……的运行中回测，并检查取消后的状态。”取消后以任务页的最终状态为准。

请查看刚才启动的 AlgoRover Research 回测任务，给出任务编号和当前状态。如果尚未完成，请告诉我如何继续查看进度。

第六步：查看表现与成交明细，下载报告

任务成功后，可查看回测表现和成交明细，并在 Codex 或网页“我的回测”下载中文报告及配置清单。报告当前为中文，即使你在英文或韩文界面操作也是如此。

报告保留至任务页面显示的日期，最长 30 天。下载链接失效后，可在报告保留期内从任务页重新获取链接。请在报告到期前下载需要的文件。历史结果用于研究，不代表未来表现。

请调出刚才已成功完成的回测任务，展示表现和成交明细，并提供中文报告及配置清单的下载入口。如果下载链接已失效，请检查报告是否仍在保留期内并重新获取链接。

本地运行：安装 Research

在 Research 产品页切到“本地运行”，复制安装提示词，发送给 Codex 或 Claude Code。也可以展开“使用终端命令安装”，复制对应平台的命令。这里使用本地版安装入口，与云端插件的安装命令不同。

按 AI 和官方说明完成本地环境准备，确认安装完成后再开始研究。

请添加插件市场 https://github.com/AlgoRover/algorover-hub，并帮我安装 AlgoRover Research 本地版。安装前请核对官方说明及当前环境要求，按步骤引导我完成。

本地运行：登录并连接产品账户

安装完成后，告诉 AI 开始使用 AlgoRover。按指引打开 Dashboard 工作台，在工作台完成注册或登录，再回到原对话检查连接状态。产品登录不等于连接交易所，回测无需提供交易所密钥。

我要开始使用 AlgoRover Research 本地版。请检查安装和账户连接状态。如果需要登录，请帮我打开对应的 Dashboard，指导我在工作台完成注册或登录，再检查连接是否成功。

本地运行：选择策略并确认第一次回测

连接成功后，先查询策略及本地版本实际支持的预设、市场和数据设置。让 AI 展示策略版本、测试区间、参数及成本假设，核对后再明确要求运行。云端的 90／365 天选项不能直接当作本地版的固定限制。

请通过 AlgoRover Research 本地版帮我查找一个可用的 BTC 策略，列出支持的预设与市场。选好后先展示策略版本、测试区间、参数和成本假设，等我确认后再在本地运行回测。

本地运行：查看结果与文件位置

回测完成后，要求 AI 展示结果，并说明报告、图表和相关输入在本机的实际保存位置。本地产生的数据由你在设备上管理，云端报告的保留期限不适用于这些本地文件。

若运行失败，保留实际错误信息，按当前本地版本的说明排查。不要把云端任务取消命令直接用于本地进程。

请查看刚才的本地回测结果，解释主要表现和成本假设，并告诉我报告、图表及相关输入文件保存在本机的哪个位置。

管理云端数据，以及遇到问题如何求助

你可以退出登录、撤销插件访问权限、删除单次报告，或在 Research 的“回测状态”中选择“删除我的研究数据”。确认删除后，系统提供受理回执。卸载插件后，仍可在网页管理云端研究数据。

遇到安装、授权或回测问题，请向 agent_strategy@algorover.ai 提供发生时间、Codex 版本、任务编号和错误信息。请勿发送密码、验证码、令牌或交易所密钥。隐私请求可发送至 lily_wang@algorover.ai。