GitHub 原生交易策略部署
连接 GitHub，选择您自己的仓库或使用 TradingHost 模板创建，并将交易策略部署到全天候运行的云端运行环境中。
TradingHost 将 GitHub 作为交易代码的唯一可信数据源。使用 GitHub 账号注册，连接现有仓库或基于开源/TradingHost 模板创建新仓库，即可启动部署，在 TradingHost 运行环境中运行您选择的策略。
GitHub 原生生命周期
- GitHub 账号注册
- 支持现有仓库
- 一键创建仓库
- 策略级部署
- 启动与停止控制
- 基于 main 分支自动重新部署
- 无状态锁定限制
章节 01 · 概念
什么是 TradingHost 部署？
部署是交易策略在 TradingHost 上运行的实例。
您的 GitHub 仓库包含策略代码。TradingHost 读取该代码，准备运行环境，注入您配置的密钥，并在容器化环境中启动所选策略。
单个仓库可以包含一个或多个策略。创建部署时，您可以选择 TradingHost 应该运行哪个策略、在何处运行，以及使用何种运行环境配置。
- 仓库 (Repo)
- 即源代码。
- 策略 (Strategy)
- 即您选择运行的交易逻辑。
- 部署 (Deployment)
- 即运行该策略的实时运行环境实例。
章节 02 · 接入
使用 GitHub 注册并部署
TradingHost 选择从 GitHub 开始，因为专业的交易代码需要版本控制、可审查的变更以及清晰的唯一可信数据源。
在 TradingHost 注册时，您需要通过 GitHub 进行身份验证。随后，您可以连接自己的仓库，或基于支持的模板创建新仓库。
- 步骤 01
使用 GitHub 注册
使用您的 GitHub 账号创建 TradingHost 账号，并授权所需的仓库权限。
- 步骤 02
选择您的仓库路径
连接现有仓库，基于开源框架模板创建仓库，或创建一个空白的 TradingHost 项目。
- 步骤 03
配置部署
选择策略、运行区域、密钥、资源配置和部署设置。
- 步骤 04
启动
TradingHost 会在托管运行环境中启动该策略，并将日志实时推送至您的控制面板。
第 03 部分 · 仓库路径
使用您自己的仓库或从模板创建
TradingHost 支持通过三种方式启动部署。
使用您自己的仓库
已经在 GitHub 上有交易项目？只需将仓库连接到 TradingHost，选择策略入口点，添加密钥（Secrets），选择运行区域，即可开始部署。
从开源框架模板创建
使用适用于 CCXT 或 Freqtrade 等受支持开源框架的开箱即用项目结构。TradingHost 会在您的 GitHub 账户中创建该仓库，随后您可以自定义代码并进行部署。
创建空白 TradingHost 模板
从干净、兼容 TradingHost 的项目结构开始。如果您想从零开始构建自己的 Python 策略，同时保持清晰的运行环境配置、文件夹结构和部署入口，这将非常有用。
模板仅为项目脚手架，并非盈利策略。它们提供结构、配置示例和运行环境兼容性。您需要自行提供交易逻辑、风险控制以及经纪商或交易所配置。
第 04 部分 · 模板所有权
选择模板后，仓库完全归您所有
无论您选择开源框架模板还是 TradingHost 空白模板，TradingHost 都会在您的 GitHub 账户中创建一个新仓库。
该仓库完全归您所有。您可以像管理其他任何 GitHub 项目一样，对其进行编辑、创建分支、提交代码、审查和管理。TradingHost 仅将该仓库作为部署源，您的代码始终保留在您的 GitHub 账户中。
模板包含
- 项目结构
- 运行环境配置
- 环境变量名称示例
- 策略入口点
- 日志记录示例
- 依赖文件
- TradingHost 部署配置
- 基础 README 说明
模板仅为项目脚手架，并非盈利策略。它们提供结构、配置示例 and 运行环境兼容性。您需要自行提供交易逻辑、风险控制以及经纪商或交易所配置。
第 05 部分 · 策略控制
部署您想要运行的策略
一个代码库可以包含多个策略、脚本或运行入口点。TradingHost 将部署视为实际运行的实例，而不仅仅是代码库本身。
启动部署时，您可以选择希望 TradingHost 运行的策略或入口点。随后，您可以在 TradingHost 控制面板中启动、停止、重启或更新该部署。
启动策略
停止策略
重启运行环境
查看日志
更新密钥
更改运行环境配置
重新部署最新代码
查看部署状态
- 代码库
- 是您的代码库。
- 部署
- 是正在运行的策略。
- 控制面板
- 是您的控制界面。
第 06 部分 · 自动重新部署
推送至 main 分支，数秒内完成重新部署
TradingHost 专为快速迭代而设计。当您更新已连接代码库的 main 分支时，TradingHost 会自动拉取最新更改并重新部署关联的实例。
这让您可以保持以 GitHub 为核心的开发工作流。修改代码、推送至 main 分支，正在运行的部署即可直接应用最新版本，无需手动重建环境。
- 在本地或 AI 开发环境中编辑策略
- 提交并将更改推送至 main 分支
- TradingHost 检测到更新
- 部署实例拉取最新代码
- 运行时以新版本重新启动
- 日志显示更新后的运行时行为
第 07 部分 · 状态归属
TradingHost 负责重新部署代码，您负责策略状态。
TradingHost 不会为您保存策略状态。
当部署重新部署、重启或迁移到新的运行时，您的代码应设计为能够安全恢复。除非您的应用程序或外部服务显式提供，否则任何策略状态、持仓跟踪、未平仓订单感知、数据库持久化、检查点或对账逻辑均由您自行负责。
状态示例
- 未平仓头寸假设
- 最新处理的 K 线/交易
- 订单 ID
- 网格层级
- 移动止损值
- 风控计数器
指南
对于实盘交易，您的策略应该能够通过经纪商或交易所的 API、存储的外部数据或您自己的持久化层来重建其全局视图。请勿依赖内存中的状态在重新部署、重启或崩溃后继续存活。
明确界限
TradingHost 提供部署、运行时和可观测性控制，但不保证用户创建的内存中策略状态的连续性。
第 08 部分 · AI 辅助
专为 AI 辅助开发而设计
TradingHost 部署旨在与 AI 辅助编码工作流协同工作。您可以在 Cursor 或 Claude Code 等工具中构建和编辑策略，将更改推送到 GitHub，然后让 TradingHost 重新部署最新版本。
借助 MCP 支持，兼容的工具还可以与 TradingHost 功能进行交互，例如列出部署、检查日志和触发重新部署。
第 09 部分 · 生命周期
部署生命周期
每个部署都遵循从代码仓库到运行策略的简单生命周期。
已创建
部署已配置，但尚未运行。
正在启动
TradingHost 正在准备运行时并启动策略进程。
运行中
策略在所选运行时中处于活跃状态。
已停止
部署已被主动停止，且没有运行任何策略进程。
正在重启
TradingHost 正在重启运行时或策略进程。
正在重新部署
TradingHost 正在拉取最新代码并重新启动部署。
失败
运行时或策略进程未能启动或无法继续运行。应检查日志。
部署状态有助于您了解 TradingHost 正在执行的操作以及下一步该怎么做。如果部署失败，首先应当检查日志。
第 10 部分 · 责任划分
TradingHost 与您的职责边界
TradingHost 负责管理交易代码外围的部署层。您仍需对交易系统本身负责。
TradingHost 负责管理
部署层
- GitHub 连接
- 仓库选择或仓库创建
- 部署配置
- 运行时启动
- 密钥注入
- 区域选择
- 基础健康状态
- 原始日志流
- 启动与停止控制
- 重新部署工作流
您需要负责
交易系统
- 策略逻辑
- 经纪商与交易所权限
- API 密钥创建
- 风险控制
- 持仓对账
- 订单处理
- 错误处理
- 外部持久化
- 实盘交易前的测试
- 实盘运行行为监控
- 遵守经纪商或交易所条款
郑重声明
TradingHost 旨在简化交易代码的部署与运行。它本身并不能确保交易代码的安全、盈利或正确无误。
第 11 部分 · 仓库模式
支持的仓库模式
只要部署入口点和运行时配置明确，TradingHost 即可支持各种不同结构的仓库。
单策略仓库
单个仓库仅包含一个策略和一个部署入口点。
多策略仓库
单个仓库包含多个策略。每次在 TradingHost 进行部署时，需选择要运行的具体策略。
框架项目
单个仓库包含受支持的框架项目，例如 CCXT 或 Freqtrade。
空白项目
从适配 TradingHost 的空白结构仓库开始，逐步构建您专属的策略代码库。
为确保部署结果符合预期，请保持入口点、环境变量和运行时配置的清晰与明确。
常见问题
常见问题解答
是的。TradingHost v1 版本将 GitHub 作为策略代码和部署更新的唯一可信源。
可以。您可以连接现有的 GitHub 仓库并直接从中部署策略。
可以。如果您选择开源框架模板或 TradingHost 空白模板，TradingHost 可以在您的 GitHub 账户中直接创建一个新仓库。
不是。模板只是开箱即用的项目结构。它们可能包含示例代码、配置和入口点，但并非可盈利的策略，也不构成交易信号或投资建议。
启用自动重新部署后，TradingHost 会自动从 main 分支拉取最新更改，并在数秒内重新部署关联的运行时。
不会。TradingHost 不保存用户的策略状态。如果您的策略依赖跨重启或重新部署的状态，您的代码应自行管理数据持久化、经纪商对账和恢复逻辑。
可以。您可以通过 TradingHost 控制面板随时启动、停止、重启和重新部署。
可以，前提是您的仓库结构和部署配置明确了每个策略的入口点。每次部署都应指定其具体要运行的内容。
不会。您的策略代码会自行连接到经纪商或交易所，并根据您的逻辑发送订单。TradingHost 仅提供运行时和部署层。
可以。TradingHost 专为兼容 MCP 的工作流而设计，受支持的 AI 开发工具在获得授权后，可以直接检查部署、查看日志并触发重新部署。