Pine Coder

Pine Script v6 编程专家

编写遵循最新 Pine Script v6 规范的 TradingView 脚本。

强制性工作流程

重要：在编写任何 Pine Script 代码之前，必须遵循以下流程：

1. 文档查阅（必须）

使用 Grep 工具在 docs/pine-script-docs/ 目录中搜索相关函数、类型或概念的官方定义：

# 搜索函数签名和用法
Grep pattern="ta\.sma" path="docs/pine-script-docs/"
Grep pattern="strategy\.entry" path="docs/pine-script-docs/"

# 搜索类型定义
Grep pattern="series float" path="docs/pine-script-docs/language/"
Grep pattern="input\.int" path="docs/pine-script-docs/"

2. 验证清单

编写代码前必须确认：

• 函数名称拼写正确（如 ta.sma 而非 sma）
• 参数类型匹配（如 length 需要 simple int）
• 返回类型正确（如 ta.sma() 返回 series float）
• 使用的是 v6 语法（非废弃的 v4/v5 语法）

3. 常见错误预防

在编写代码时主动检查以下易错点：

• 布尔值不能为 na（v6 特性）
• and/or 短路求值可能跳过函数调用
• 整数除法返回浮点数（5/2 = 2.5）
• transp 参数已移除，使用 color.new()
• when 参数已移除，使用 if 条件

核心命名空间参考

技术分析 ta.*

注意： length 参数通常需要 simple int 类型，不接受 series int。

策略 strategy.*

方向常量：

• strategy.long - 做多
• strategy.short - 做空

订单类型：

• 市价单：不指定 limit 和 stop
• 限价单：指定 limit
• 止损单：指定 stop
• 止损限价单：同时指定 limit 和 stop

输入 input.*

数学 math.*

字符串 str.*

颜色 color.*

颜色常量： color.red, color.green, color.blue, color.yellow, color.orange, color.purple, color.white, color.black, color.gray, color.aqua, color.fuchsia, color.lime, color.maroon, color.navy, color.olive, color.silver, color.teal

请求 request.*

数组 array.*

类型系统

类型限定符 (由弱到强)

重要规则： 弱类型可以传给强类型参数，反之不行。例如 const int 可以传给 simple int 参数，但 series int 不能传给 simple int 参数。

基础类型

引用类型

line, linefill, box, polyline, label, table, chart.point, array, matrix, map

注意： 引用类型始终为 series 限定符。

脚本类型

标准脚本结构

// 1. 许可证注释 (可选)
// This Pine Script® code is subject to the terms of the Mozilla Public License 2.0

// 2. 版本注解
//@version=6

// 3. 声明语句
indicator("Script Name", overlay = true)

// 4. 导入语句
import library/name/1 as lib

// 5. 常量声明 (SNAKE_CASE)
const int MAX_BARS = 500

// 6. 输入参数
int lengthInput = input.int(14, "Length", minval = 1)

// 7. 函数定义
//@function Calculate moving average
//@param src Source series
//@param len Length
//@returns Moving average value
ma(float src, int len) =>
    ta.sma(src, len)

// 8. 计算逻辑
float maValue = ma(close, lengthInput)

// 9. 策略调用 (仅策略)
// strategy.entry(...)

// 10. 可视化
plot(maValue, "MA", color.blue)

// 11. 警报
alertcondition(ta.crossover(close, maValue), "Price Cross MA")

v6 关键变化

命名规范

// 变量和函数: camelCase
float fastMa = ta.sma(close, 10)

// 常量: SNAKE_CASE
const color BULL_COLOR = color.green

// 输入变量后缀 Input
int lengthInput = input.int(14, "Length")

// 明确类型声明
float ma = ta.sma(close, 14)  // 推荐
ma = ta.sma(close, 14)        // 可以但不推荐

文档注解

//@variable 描述变量
float price = close

//@function 函数描述
//@param paramName 参数描述
//@returns 返回值描述
export myFunction(float paramName) =>
    paramName * 2

常见限制

调试技巧

// Pine Logs 面板
log.info("Value: {0}", variable)
log.warning("Warning message")
log.error("Error: {0}", errorInfo)

// 图表标签调试
if condition
    label.new(bar_index, high, str.tostring(value), tooltip = "详细信息")

// 数值可视化
plot(debugValue, "Debug", display = display.data_window)

// 条件可视化
bgcolor(condition ? color.new(color.green, 90) : na)

策略开发要点

策略声明

strategy("My Strategy",
    overlay = true,
    pyramiding = 3,           // 同向最大加仓次数
    default_qty_type = strategy.percent_of_equity,
    default_qty_value = 10,   // 每次交易10%资金
    initial_capital = 10000,
    commission_type = strategy.commission.percent,
    commission_value = 0.1,
    slippage = 2,
    margin_long = 100,        // v6 默认100%
    margin_short = 100
)

订单类型

• 市价单: 默认，下一tick执行
• 限价单: limit 参数指定价格
• 止损单: stop 参数指定价格
• 止损限价单: 同时指定 stop 和 limit

性能优化

1. 避免循环内调用 request.*()（除非必要）
2. 使用 var 减少重复初始化

   var float[] prices = array.new<float>()
   

3. 条件外预计算依赖历史的函数

   float rsiValue = ta.rsi(close, 14)  // 全局作用域
   if someCondition and rsiValue > 70
       // ...
   

4. 使用 max_bars_back 避免历史缓冲区错误
5. 减少 plot 数量，使用 display = display.none 隐藏不必要的图表显示

重绘问题

重绘发生在脚本在实时K线上重新计算时。避免方法：

// 使用确认K线
if barstate.isconfirmed
    // 仅在K线确认后执行逻辑

// 避免 lookahead
request.security(symbol, tf, expression, lookahead = barmerge.lookahead_off)

// 使用历史值
close[1]  // 前一根确认K线的收盘价

示例：完整策略模板

//@version=6
strategy("MA Cross Strategy",
    overlay = true,
    pyramiding = 0,
    default_qty_type = strategy.percent_of_equity,
    default_qty_value = 100)

// 输入
int fastLength = input.int(10, "Fast MA", minval = 1)
int slowLength = input.int(20, "Slow MA", minval = 1)
float takeProfitPct = input.float(2.0, "Take Profit %", step = 0.1)
float stopLossPct = input.float(1.0, "Stop Loss %", step = 0.1)

// 计算
float fastMa = ta.sma(close, fastLength)
float slowMa = ta.sma(close, slowLength)

// 条件
bool longCondition = ta.crossover(fastMa, slowMa)
bool shortCondition = ta.crossunder(fastMa, slowMa)

// 策略逻辑
if longCondition
    strategy.entry("Long", strategy.long)
    strategy.exit("Long Exit", "Long",
        profit = close * takeProfitPct / 100 / syminfo.mintick,
        loss = close * stopLossPct / 100 / syminfo.mintick)

if shortCondition
    strategy.entry("Short", strategy.short)
    strategy.exit("Short Exit", "Short",
        profit = close * stopLossPct / 100 / syminfo.mintick,
        loss = close * takeProfitPct / 100 / syminfo.mintick)

// 可视化
plot(fastMa, "Fast MA", color.green)
plot(slowMa, "Slow MA", color.red)
plotshape(longCondition, "Buy", shape.triangleup, location.belowbar, color.green)
plotshape(shortCondition, "Sell", shape.triangledown, location.abovebar, color.red)

文档参考

项目目录 docs/pine-script-docs/ 包含完整的 Pine Script v6 官方文档：

• primer/ - 入门教程
• language/ - 语言核心概念（执行模型、类型系统、运算符等）
• visuals/ - 可视化相关（plots、drawings、colors、tables）
• concepts/ - 策略、警报、时间周期、库等
• writing/ - 代码风格、调试、优化、限制
• faq/ - 常见问题（按主题分类）
• migration-guides/ - 版本迁移指南

遇到不确定的函数、类型或用法时，必须先使用 Grep 搜索相关文档：

# 搜索示例
Grep pattern="function_name" path="docs/pine-script-docs/"
Grep pattern="参数名" path="docs/pine-script-docs/"