Architecture

StockSharp 架构:五大组件与数据流解析

StockSharp 由五个核心组件构成:Designer(策略设计)、Hydra(数据存储)、Terminal(交易终端)、Shell(图形框架)与 API(C# 开发库)。它们共享同一套连接器与数据模型,覆盖「数据接入 → 策略设计 → 回测 → 交易」的完整链路。

核验日期:2026-09-24来源:官方仓库 / 文档链路状态:本站未实机验证
Designer
Hydra
Terminal
Shell
API
StockSharp 五大组件示意,基于StockSharp 官方文档;非官方架构图。
Components

五大组件职责对照

五个组件各司其职,通过共享连接器与数据模型协作。

组件定位关键能力适合谁
Designer可视化策略设计器鼠标搭建策略图、内嵌 C# 编辑器、自定义指标、内置调试器、团队共享策略图不想从零写交易系统、想快速验证策略的人
Hydra行情数据存储自动下载历史/实时行情、高压缩、K线/tick/orderbook/options/news 多类型、CSV/Excel/数据库导入导出、定时任务需要本地行情数据库的人
Terminal交易图表终端多连接、图表直接交易、任意时间框架、成交量/区间/Renko/蜡烛图等 K 线类型需要图表看盘与手动交易的人
Shell图形框架开箱即用 C# 源码、支持全部连接器与 Designer 策略图、策略测试与绩效分析想快速定制交易终端 UI 的开发者
APIC# 开发库在 Visual Studio 中用 C# 编写交易机器人,支持高频交易(HFT)专业程序员
Data flow

StockSharp 的数据流:从行情到策略

StockSharp 的组件可以组成数据到执行的工作流,但不是所有安装组合都自动闭环。以下是规划和验证顺序,不代表本站已在券商账户或实盘环境跑通。

  1. 获取数据

    用 Hydra 或已配置连接器准备历史/实时数据;覆盖范围取决于数据源权限和连接器能力。

  2. 实现策略

    在 Designer 走可视化路径,或在 C# API / Shell 中实现策略;先固定输入、指标与订单规则。

  3. 回测与优化

    检查时间区间、手续费、滑点和成交假设;Cloud Backtester 的可用性与额度以官方页面当前说明为准。

  4. 模拟与上线评估

    使用模拟环境验证订单状态、断线恢复和重复下单保护;模拟结果不保证实盘表现。

  5. 监控与复盘

    保存数据版本、策略版本、日志与告警记录,并准备停止交易和回滚流程。

Scenarios

按使用场景选组件

只想回测策略

装 Designer 或 Shell,接数据源回测即可,不必碰实盘连接器。

要本地行情库

用 Hydra 下载并存储行情,再导出到 CSV/Excel/数据库做研究。

要图表看盘

用 Terminal 连接多个券商,图表直接交易、任意时间框架。

要写交易机器人

用 API 在 Visual Studio 用 C# 开发,或基于 Shell 定制终端。

Related

相关栏目

Minimal install

按任务选最小安装集合:五个组件到底要装哪几个

官方把五个组件分别发布,但没告诉你「只做某件事时需要哪几个」。下表按常见任务给出最小集合,避免多装后用不上。

你的任务需要装可以不装适用场景 / 注意点
只看图表、手动下单TerminalDesigner / Hydra / API仍需先配好连接器与行情权限
可视化搭策略并回测Designer(+ Hydra 存历史数据)API回测依赖本地已有历史数据,先下载再回测
把策略图跑在自制终端里Shell + Designer 策略图Hydra(可选)Shell 是 C# 源码级框架,需要开发能力
写自定义机器人 / 高频API(+ Visual Studio)Designer / TerminalAPI 面向 VS 开发者;HFT 对延迟与部署环境另有要求
只要一个行情数据仓库Hydra其余四个导出支持 csv / excel / xml / 数据库

最小集合依据各组件在官方 README 与产品页里的职责划分推导(2026-09 核验);实际所需组件以官方安装包说明为准。

Misconceptions

关于架构的 5 个常见误解

这几条在中英文讨论里反复出现,逐条对照官方说明。

常见说法官方实际依据 / 边界
「Shell 只是个示例项目」Shell 是开箱即用的图形框架(C# 源码),支持全部 StockSharp 连接并带策略测试能力仓库 README 对各产品的描述
「Designer 完全不用写代码」Designer 内嵌 C# 编辑器与调试器,复杂逻辑仍需编程README 产品描述;以官方文档为准
「API 是收费组件」README 与产品页把 API 描述为 free 的 C# 库许可条款以官方许可文件为准
「五个组件必须一起装」各组件可按任务单独使用,它们共享同一套连接器与数据模型README 各产品页独立提供
「Hydra 只负责下载、不负责存储」Hydra 自动下载并存储行情,支持高压缩存储与多种格式导出README 产品描述;容量与压缩率以官方说明为准

上表只做「官方怎么写」与「社区怎么传」的对照,不代替官方文档;官方描述有变更时以官方为准。

Version evidence

StockSharp 组件版本与验证记录:装完先填这张表

StockSharp 的组件分别发布,版本不统一时问题很难复现。装完第一件事是把下表填完并留档,之后换环境、换机器都靠它对照。

记录项要填什么为什么必须记注意点
操作系统与版本Windows 版本/构建号,是否为服务器版图形组件依赖桌面环境StockSharp 官方 README 未列操作系统支持范围
.NET SDK 版本SDK 与运行时版本号API 与源码编译都受它影响官方未固定版本号,别照抄别人的版本
IDE 版本Visual Studio 版本与工作负载影响 NuGet 还原与调试体验走 Designer 路线不需要 IDE
StockSharp 版本安装包版本或仓库 commit策略块与 API 在不同版本可能不同仓库使用自定义 notice,同时记录许可文件快照
安装方式官方安装器 / NuGet / 源码编译决定后续升级与回滚方式三条路径的前置条件不同
组件清单实际装了哪几个(Designer/Hydra/Terminal/Shell/API)判断最小安装集合是否够用StockSharp 组件可按任务单独安装
验证结论能启动什么、报什么错、哪些没验证避免把「装完」当成「可用」本站尚未在干净环境完成该验证,此表为记录模板

表格项依据 StockSharp 官方仓库与文档的公开信息设计;具体版本要求请以官方下载页与构建说明为准。

FAQ

常见问题

Designer 和 Shell 有什么区别?

Designer 专注可视化策略设计,用鼠标搭建策略图;Shell 是开箱即用的图形框架(C# 源码),可快速定制交易终端 UI,并支持加载 Designer 策略图。

API 和 Designer 用哪个?

不会写代码可先用 Designer 可视化搭建;需要复杂逻辑、高频交易或深度定制时用 API 在 Visual Studio 里写 C#。

五个组件必须全装吗?

不必。按场景选装:只回测装 Designer/Shell,只要行情库装 Hydra,只要图表装 Terminal,写机器人装 API。

组件之间如何协作?

它们共享同一套连接器与数据模型,Designer 策略图可被 Shell 加载,Hydra 存储的行情可被回测与图表消费。

StockSharp 架构适合新手吗?

五大组件职责清晰但整体偏 C#/.NET 生态,上手需一定开发基础;若只想做量化研究不碰代码,可参考 EasyClaw 的 quant-analyst、akshare-finance 等免部署技能。

只想跑回测,最少要装哪些组件?

典型最小集合是 Designer(或 Shell)+ Hydra:Designer/Shell 负责策略与回测,Hydra 负责把历史行情下到本地。若只做研究不连实盘,可以不装 API、也不必先接交易账户;但要先把数据源连接器与历史数据准备好。以官方安装包与文档为准。

Designer 做出来的策略能直接实盘吗?

可以连接券商执行,但前提是该券商有可用连接器、账号已开通相应 API 权限,且你自行做好风控与合规准备。实盘涉及资金与市场风险,本站不提供收益保证或交易建议,具体执行方式以官方文档与券商规则为准。

下一步:安装部署

了解组件后,按你的场景选择官方安装器、NuGet 或源码编译安装对应组件。