开发者指南

在 A 股图表上验证第一段 Pine 策略

先把一个简单规则写清楚，再检查数据、成交时序和成本。脚本与回测属于观潮 Plus，历史结果只用于研究。

选择标的与数据口径

在工作台选择标的、日线或分钟周期，并确认复权方式与可用历史区间。记录这些设置，同一脚本在不同数据上可能产生不同信号。

打开策略编辑器

从顶部「策略」入口进入编辑器。下面是用于学习流程的双均线示例，不是经过收益验证的交易策略。先编译，再运行；报错时按提示逐项处理。

//@version=5
strategy("SMA 20/50 Example", overlay=true)
fast = ta.sma(close, 20)
slow = ta.sma(close, 50)
plot(fast, "Fast")
plot(slow, "Slow")
if ta.crossover(fast, slow)
    strategy.entry("Long", strategy.long)
if ta.crossunder(fast, slow)
    strategy.close("Long")

先核对一笔历史交易

找到一次交叉，检查信号出现在哪根 K 线、订单何时生成、何时按模型成交。默认下一根开盘成交与收盘成交假设不同；修改成交设置后应重新核查交易明细。

加入成本并保留样本外数据

手续费、滑点与不可成交情形都可能改变结果。先用零成本作为理想基线，再按自己的研究假设增加成本；不要把一条更漂亮的权益曲线当成验证完成。

从 TradingView 迁移：逐脚本核对兼容性

观潮支持 Pine Script 常用语法与指标、策略使用习惯。具体脚本能否运行取决于调用函数、外部依赖和数据上下文，迁移需要编译与信号对照。

建议迁移顺序

1. 保留原脚本与授权说明，列出外部库、数据请求和可视化对象。
2. 在同一标的、周期、复权和历史区间下，先迁移最简单的一段计算。
3. 编译后核对指标数值、信号所在 K 线和缺失数据，不只比较截图。
4. 策略另核对成本、成交时序、限价成交及样本外结果；保存差异清单。

具体函数签名与限制见函数文档。迁移评估见TradingView 与 A 股工具迁移清单；原平台行为可核查TradingView 策略文档。

回测语义与 A 股执行约束

观潮以 Pine 策略研究工作流为入口。理解订单生成与历史成交模型，比直接比较总收益更重要。

哪些 A 股限制需要单独处理

通用撮合模型不会自动完整还原 T+1、涨跌停不可成交、停牌、整手数量和交易费用细则。把规则写进脚本之前，先列出模型确实包含什么、仍未模拟什么；一段简化代码不能代替完整市场制度。

profit/loss 与价格止损的区别

strategy.exit 的 profit、loss 按 tick 距离表达，不能直接把 close * 0.03 写成「3% 止损」。若以持仓均价的比例定义条件，应核对 stop、limit 的价格参数及实际执行顺序。

//@version=5
strategy("Price Exit Example", overlay=true)
if ta.crossover(ta.sma(close, 20), ta.sma(close, 50))
    strategy.entry("Long", strategy.long)
if strategy.position_size > 0
    strategy.exit("Exit", "Long",
         stop=strategy.position_avg_price * 0.97,
         limit=strategy.position_avg_price * 1.08)

继续阅读前复权、后复权与回测数据及回测偏差检查清单。

从脚本草稿到可复查的研究记录

把规则写成可检验条件

明确入场、离场、仓位、数据周期与失效条件，避免「走势不错」「量能健康」这类无法直接测试的描述。每次修改只改变一个假设，并保留旧版本。

使用观潮 Agent 辅助编写

可以向观潮 Agent 描述指标或策略规则，让它解释代码或生成 Pine 草稿。编写功能需要观潮 Plus，AI 消耗按当前额度规则计算。生成草稿会经过编译试跑，是否导入、运行或保存由用户决定；编译试跑只说明脚本能否执行，不证明策略有收益。

验证工具如何分工

正确阅读报告

胜率需与盈亏比、交易数和最大回撤一起看；年化指标受样本长度与收益分布影响。没有适用于所有策略的合格数值，样本很少时尤其不能据此下结论。

模板与旧脚本

内置模板覆盖均线交叉、RSI、MACD 等常见规则，可作为学习起点，具体列表以当前「策略」入口为准。旧版 ai.* 信号接口已停止提供实时 AI 信号，新策略应使用当前观潮 Agent 工作流。

下一步：滚动前向分析、用自然语言生成可验证的脚本。