先回测策略
启动 Designer，用示例策略跑通「数据→回测→结果」。
Quick start
三个程序的首次运行
每个程序有独立的快速开始流程。
| 程序 | 启动后做什么 | 首次关键动作 |
|---|---|---|
| Designer | 可视化搭建与回测策略 | 新建策略图，连接数据源，拉取历史行情 |
| Terminal | 图表看盘与交易 | 添加连接器，订阅行情，配置交易账户 |
| Hydra | 下载与存储行情数据 | 选择数据源，创建任务，定时下载 |
Steps
首次运行通用步骤
- 启动程序
从开始菜单或安装目录启动 Designer / Terminal / Hydra。
- 添加连接器
在连接设置里选择券商/交易所/数据源，填入账号或 API 凭证。
- 连接并验证
确认连接状态正常，能收到行情或订单回报。
- 跑第一个任务
Designer 回测一个示例策略，Terminal 打开一张图表，Hydra 下载一段历史行情。
Scenarios
按目标选程序
先看行情
启动 Terminal，连接数据源打开 K 线图。
先建本地数据
启动 Hydra，下载历史行情到本地存储。
Alternative route
不想配连接器与账号？
StockSharp 首次运行需要配置券商连接与账号凭证。若只想做行情查询、选股或技术分析研究，免部署技能无需配置，一句话即可发起。
First task
三个程序的第一个任务：怎么做、该看到什么
官方快速开始都给了「跑第一个任务」这一步，但没写清楚「看不到结果时先查什么」。下表补齐这一栏。
| 程序 | 第一个任务怎么做 | 应该看到什么 | 看不到时的排查方向 |
|---|---|---|---|
| Designer | 新建策略图，选一个示例策略，指定数据与周期后运行 | 成交清单与结果指标（收益、回撤等） | 先确认本地已有该标的与周期的历史数据，再怀疑策略设置 |
| Terminal | 添加连接器后，打开图表并订阅某标的行情 | 图表出现 K 线并随行情刷新 | 连接未建立或未订阅行情；实时图依赖数据源推送权限 |
| Hydra | 选择数据源与标的，创建下载任务并执行 | 任务完成后本地出现该标的数据 | 检查订阅权限与时间区间是否超出可下载范围 |
| 连接器验证 | 在任一程序里查看连接状态与行情回报 | 状态为已连接、能收到数据 | 券商侧未开通 API、凭证错误、或需要本地网关配合 |
| 数据校验 | 抽看下载到的数据区间与粒度 | 区间与粒度符合预期 | 数据缺失或区间不符，多为下载范围限制，不是程序故障 |
验收边界：这是按官方功能描述编写的复现模板，不是本站运行日志。正式发布实测结论前，应记录具体版本、系统、.NET/Visual Studio 版本、数据源、策略文件、输出截图和限制。
After first run
首次运行跑通后，接下来三条路
跑通第一个任务只说明环境通了，往哪走取决于你的目标。
| 你要走的路 | 下一步做什么 | 需要的准备 | 注意点 |
|---|---|---|---|
| 系统学策略开发 | 在 Designer 里从示例策略扩展到自己的逻辑，逐步加条件与风控 | 历史数据 + 对策略逻辑的清晰定义 | 先在回测里验证，再考虑模拟盘 |
| 先做行情与图表 | 用 Terminal 搭看盘界面，配多个连接器对比数据 | 行情订阅权限 | 不同数据源的口径与时区要统一 |
| 先建本地数据仓库 | 用 Hydra 规划标的清单与更新频率，做定时任务 | 足够的本地存储与可下载范围 | 注意重复区间写入与数据口径一致性 |
三条路可以并行，但建议先把「数据」这条打通——回测与图表都依赖它。以StockSharp 官方文档为准，本站不提供收益保证或交易建议。
C# API path
API 首次运行的对象链与版本验证模板
Connector、订阅、Candle、Indicator、Strategy、Order 和 Storage 是理解 API 路径的关键对象。本页不粘贴未经版本核实的构造代码；先确定 NuGet 版本和官方示例，再按此链路记录编译与运行证据。
| 步骤 / 对象 | 应确认的输入 | 验收证据 | 边界 |
|---|---|---|---|
| 建立项目与 NuGet | 目标框架、StockSharp 包名与固定版本 | restore 成功，记录 lock / project 文件 | 具体目标框架随官方版本要求变化 |
| Connector | 选官方连接器或模拟数据源，按需配置凭证 | 初始化成功，连接状态与日志可读 | 未核实真实账户接入前，不使用生产密钥 |
| Subscription / Candle | 订阅标的、周期、时间范围和时区 | 收到符合预期的 K 线数据，记录条数与时间范围 | API 签名和订阅方式需按所固定版本官方示例核对 |
| Indicator / Strategy | 定义指标参数、信号触发时点和状态管理 | 日志中能解释信号产生的输入与时间 | 避免未收盘 bar、未来函数和重复信号 |
| Order / 模拟运行 | 使用模拟连接，定义数量、订单类型和幂等键 | 保存订单请求、回报状态变化与异常日志 | 未完成断线/重复提交测试不得切实盘 |
| Storage / 复现 | 固定数据版本、配置、策略 commit 和输出路径 | 另一环境可按相同输入重跑并对账 | 本站尚未发布可下载的示例工程与成功输出 |
本表是复现实验的记录框架，不是已验证的 API 调用代码或成功结果。需补充实际 .NET、Visual Studio、NuGet 版本、源码、日志与运行截图后，才可标记为实测。
Live readiness
模拟盘转实盘前：必须逐项通过的运维检查
任何一项未验证都应视为未就绪。先在模拟环境压测异常流程，再评估是否具备实盘条件；清单不构成投资建议。
| 检查项 | 通过标准 | 证据留存 | 未通过时的处理 |
|---|---|---|---|
| 样本外与成本 | 已分离样本外区间，计入手续费、滑点与合理成交假设 | 数据版本、参数、报告与假设说明 | 回到回测实验，不凭单一收益指标推进 |
| 仓位与亏损上限 | 最大仓位、单日亏损阈值和品种限额已设定并演练 | 配置文件与触发日志 | 未触发保护前保持模拟状态 |
| 重复订单保护 | 请求超时/重连后先查订单状态，有幂等或对账机制 | 重复请求模拟记录 | 禁止盲目重发可能已受理的订单 |
| 断线与进程恢复 | 断线、进程崩溃、服务器重启后状态可核对 | 故障演练日志、恢复步骤 | 无法恢复时停止自动交易并人工接管 |
| 日志与告警 | 行情、信号、订单请求/回报、异常均有时间戳，告警可到达 | 日志样例、告警回执 | 无可审计记录时不应上线 |
| 密钥与权限 | 使用最小权限密钥，禁用提现/不必要权限并妥善保管 | 权限截图（脱敏）与轮换流程 | 疑似泄漏立即撤销并轮换凭证 |
| Kill switch 与回滚 | 可停止新订单并按预案处理未完成订单，有可回滚版本 | 演练记录、责任人和操作步骤 | 无法快速停机/回滚则不进入实盘 |
StockSharp 官方资料未替用户提供账户风控策略；以上是系统运维核对项，需结合券商规则、当地法规和自身风险制度验证。
Evidence log
StockSharp 首次运行日志：要留下哪 6 类证据
「跑通了」如果留不下证据，换台机器就说不清。下表把首次运行需要保留的证据按类型列出来，便于排查时回溯。
| 证据类型 | 内容 | 用途 | 注意点 |
|---|---|---|---|
| 环境快照 | 系统、.NET/IDE 版本、StockSharp 版本或 commit | 复现前提条件 | 官方未固定版本要求，必须自己记录 |
| 连接记录 | 连接器类型、连接状态、脱敏后的配置项 | 区分「代码问题」与「权限问题」 | 凭证一律脱敏后再保存 |
| 行情样本 | 订阅的标的、周期、首末时间、记录条数 | 判断数据是否完整 | 能取到的历史深度取决于数据源权限 |
| 策略与参数 | 策略文件、指标参数、下单规则 | 让回测可复现 | StockSharp 版本不同时策略块可能不兼容 |
| 运行输出 | 成交列表、权益变化、报错原文与时间点 | 判断结果是否符合策略定义 | 本站尚未产出该类实测输出 |
| 未验证项 | 这次没做的事（如未接实盘、未测断线） | 避免把局部结论当整体结论 | StockSharp 的实盘运维需单独演练 |
证据清单依据排查需要整理；StockSharp 官方未规定留档格式，具体字段以所用版本产出为准。
FAQ
常见问题
首次运行卡在连接器怎么办？
检查券商/数据源是否支持、账号与 API 凭证是否正确、网络与权限是否就绪；部分连接器需先在券商侧开通 API 权限。
没有实盘账号能先体验吗？
可以用模拟连接或回测体验 Designer/Terminal 的策略与图表，不必先接实盘。
Hydra 下载数据失败？
确认数据源连接器已配置，检查订阅权限与网络；部分数据源对历史数据范围有限制。
装完启动后一点数据都没有，是装错了吗？
多数情况不是安装失败，而是数据通道没打通：连接器未配置、券商侧未开通 API 权限、订阅的市场或时间区间超出可下载范围。按「连接状态 → 数据权限 → 策略设置」的顺序排查。具体限制以对应连接器与数据源说明为准。
不接实盘账号，能先把流程跑通吗？
可以。回测与图表本身不需要实盘交易权限，只需数据源可用；很多连接器也提供模拟环境。等到需要真实下单时，再处理券商 API 权限与风控准备。以官方文档与券商规则为准。