Filament Tripline Console
- 实用工具
- 版本: 1.0
- 激活: 5
Filament Tripline Console 把您自己画的水平线和趋势线变成已布防的"绊线"（tripline）。当价格触及线条，或K线收盘越过线条时，绊线执行其动作：提醒、带自动手数、止损和止盈的市价 BUY 或 SELL，或者平仓的 EXIT。它从不根据自身分析交易，只对您布防的线条采取行动。
快速开始
- 将工具加载到任意图表。要使用 BUY、SELL 和 EXIT 动作，请在工具栏启用 Algo Trading，并在 Common 选项卡勾选 Allow live trading。ALERT 无需这些设置。
- 用 MetaTrader 常规工具画一条 Horizontal Line 或 Trendline，或在面板上按 + H-LINE / + T-LINE。
- 单击该线。TARGET 显示其名称。
- 选择 ACTION、TRIGGER、DIRECTION 以及 ONCE 或 REPEAT，然后按 ARM。线条变为动作颜色，右端出现标签。
- 按 TEST ALERT 检查提醒通道。若要实时检查，可在模拟图表上于距价格几个点处布防一条 ALERT 绊线。
在 MT4 策略测试器中按钮不响应（MetaTrader 不向测试器发送图表事件），请在模拟图表上测试。
绊线如何触发
- 参考价格：TOUCH 使用 Bid；BAR CLOSE 使用图表周期最后一根已完成K线的收盘价。
- 线条价格：水平线即其价格；趋势线取当前K线（TOUCH）或最后一根已收盘K线（BAR CLOSE）处的数值，布防期间向右延伸。
- UP：价格从线下方移动到线价加 Trigger Buffer 或更高时触发；DOWN 与之相反。AUTO 表示从布防或拖动时价格所在的一侧朝向线条。
- 只有价格先位于起始一侧后绊线才会触发，因此布防或把线拖过价格绝不会立即触发。
- 状态：ARMED（就绪）、PRIMING（价格在错误一侧，等待返回）、HOLD（已穿越但被阻止：AutoTrading 关闭、市场休市或点差超过上限；只要价格仍在线外，每个报价都会重试）、FIRED（完成）、COOLDOWN（REPEAT：价格回到起始一侧且经过 Repeat Cooldown 根K线后重新布防；REPEAT 的 BUY 或 SELL 还会等待上一次触发的订单平仓，因此订单绝不叠加）、CANCELLED（被 OCO 取消）、FAILED（订单被拒）、PAUSED（PAUSE ALL）。
- 重启或 RESUME ALL 之后，期间已被价格穿越的绊线进入 PRIMING，而不会延迟触发。
动作
- ALERT：仅提醒。
- BUY / SELL：市价单，注释为 Filament T<n>，使用 Magic Number。订单先不带止损开仓，随后立即附加 SL/TP（适用于市场执行账户）；被拒的修改在 30 个报价内重试。比经纪商止损水平更近的止损会向外移动。开仓前先用 AccountFreeMarginCheck 检查保证金。重新报价和繁忙错误会重试；5 次失败后状态变为 FAILED。
- 手数：Fixed lots，或 风险 = 余额或净值 x Risk per Trade / 100，手数 = 风险 / (SL 距离 / 最小变动价位 x 每变动价值)，向下取整到手数步长，并受 Maximum Lots per Order 限制。按风险计算的手数低于经纪商最小手数时为 FAILED（风险低于最小手数）。无止损的风险模式使用 Fixed Lots。
- 止损：Fixed distance in points；ATR multiple = Stop Loss ATR Multiple x 最后一根已收盘K线的 ATR(ATR Period)（ATR 不可用时用 Stop Loss Points）；Behind the tripline = 线价减（BUY）或加（SELL）Stop Loss Points，若价格已越过该水平则为距入场价 Stop Loss Points。最小值 = 止损水平 + 点差。
- 止盈 = Take Profit x 止损距离（无止损时不设）。
- EXIT：平掉 Exit Scope 范围内的市价单；开启 Exit Also Deletes Pending Orders 时也删除挂单。平仓失败的订单在 30 个报价内重试，然后报告。
- OCO：开启 One-Cancels-Other for Entry Triplines 后，已触发的 BUY 或 SELL 会取消所有其他未完成的 BUY 或 SELL 绊线。ALERT 和 EXIT 绊线不受影响。
面板控件
- 标题栏：<> 把面板移到下一个角落；[-] 折叠为 180 x 26 px 的胶囊，显示指示灯、FILAMENT 和简短状态；[+] 展开。角落和胶囊状态在切换周期和品种时保留，重新加载、修改参数或重启终端时恢复为输入参数。
- 单击线条或其图表标签即可选为 TARGET（为空时显示 click a line on the chart；未布防的线显示 [H-LINE] 或 [TREND]，已布防的显示 [T2]；用 + H-LINE 或 + T-LINE 创建的线显示为 Draft H1、Draft T2）。
- ACTION：ALERT、BUY、SELL、EXIT。TRIGGER：TOUCH、BAR CLOSE。DIRECTION：AUTO、UP、DN。ONCE / REPEAT 切换重复模式。
- ARM 布防目标。目标已布防时按钮显示 UPDATE T<n>：应用所选设置并重新检查状态。
- DISARM 撤除绊线。您自己的线恢复原样式；用 + H-LINE 或 + T-LINE 创建的线会被删除，即使尚未布防。
- + H-LINE：在价格上方 0.5 ATR 处创建虚线草稿线并选中以便拖动。+ T-LINE：草稿趋势线，经过第 21-60 根K线和第 2-20 根K线中的最低低点。
- TEST ALERT：通过所有已启用通道发送测试消息（全部关闭时显示 ALL ALERT CHANNELS ARE OFF）。
- TRIPLINES：每页 5 行，用 « 和 » 按钮翻页；单击某行即选中。
- PAUSE ALL / RESUME ALL：停止和恢复所有触发。CLEAR FIRED 删除 FIRED、CANCELLED 和 FAILED 绊线。CLEAR ALL 先显示 CONFIRM?，3 秒内再按一次即全部删除。
- 面板下方的消息行确认每个操作，例如 CLICK A LINE ON THE CHART FIRST 或 LIMIT REACHED: 40 TRIPLINES。
读数
- 指示灯与徽章：WATCHING n（绿色，n 条未完成绊线）、IDLE（没有）、PAUSED（琥珀色）、MARKET CLOSED（琥珀色，有交易绊线时交易时段关闭）、TRADING OFF（红色，有交易绊线时 Algo Trading 或 Allow live trading 关闭）。右侧：品种、周期和 FIRED 计数。
- TELEMETRY（角落显示 LIVE、TESTER 或 PAUSED）：SPREAD 以点数对比上限，进度条低于 60% 绿色，低于 100% 琥珀色，超过为珊瑚色。NEAREST：最近的未完成绊线及其动作、UP 或 DN 和当前线价，或 none armed。DISTANCE：线价减 Bid，单位为点数和 ATR；价格接近时进度条填满（青色，0.5 ATR 内琥珀色，0.2 ATR 内珊瑚色）。RISK：手数模式（% BAL、% EQ 或 LOT）、SL（pt、ATR、LINE+ 或 SL OFF）、TP（R 或 TP OFF）及 OCO。LAST：最近一次触发或失败，含时间和订单号。
- 列表行：编号、动作、TOUCH 或 BAR、UP 或 DN、A = AUTO、R = REPEAT、线价、点数距离、状态。白色 ARMED，灰色 PRIMING 或 COOLDOWN，琥珀色 HOLD 或 PAUSED，暗色 FIRED 或 CANCELLED，珊瑚色 FAILED。
- 图表：已布防的线使用 Alert、Buy、Sell 或 Exit 颜色；ARMED 为实线，PRIMING 或暂停时为虚线，COOLDOWN 为点划线，FIRED 或 CANCELLED 为变暗的点线，FAILED 为珊瑚色点线。标签形如 T2 BUY UP · TOUCH · ARMED，并附 REPEAT x<次数> 和订单号。触发标记位于线价处：向上箭头 BUY，向下箭头 SELL，菱形 ALERT，叉号 EXIT。
提醒
每次触发、失败和接近事件都会通过所有已启用通道发送：Popup Alert on Fire、Sound Alert on Fire（alert.wav）、Push Notification on Fire、Email on Fire。示例：Filament Tripline EURUSD M15: T2 BUY filled at 1.15412 (BAR CLOSE UP), 0.24 lots, ticket #81234567。Proximity Alert 在价格进入已布防（ARMED）绊线 Proximity Distance 范围时发送一条消息，价格远离两倍距离后重新布防。在测试器中消息只写入日志。
副作用
- 文件 MQL4\Files\FilamentTripline\<symbol>_<magic>.csv 保存绊线、坐标、状态和面板状态。启动时会据此重绘缺失的线条。
- 前缀为 FTC_ 的图表对象（面板、标签、标记、+ H-LINE / + T-LINE 线）随工具一同删除；您自己的线恢复原样式。
- 250 毫秒定时器。无 DLL、无全局变量、无网络请求。同一品种的两个图表请使用不同的 Magic Number。
输入参数
- Default Action（Alert only；另有 Buy at market、Sell at market、Exit positions）和 Default Trigger（Touch (price crosses the line) 或 Bar close beyond the line）：面板选择器预设。
- Trigger Buffer（0）：触发所需越过线条的点数。
- Repeat Cooldown（1）：触发后 REPEAT 绊线可重新布防前需经过的K线数。
- One-Cancels-Other for Entry Triplines（false）。
- Lot Mode（Risk % of balance；另有 Fixed lots、Risk % of equity），Fixed Lots（0.10），Risk per Trade（1.0 %），Maximum Lots per Order（5.0）。
- Stop Loss Mode（ATR multiple；另有 No stop loss、Fixed distance in points、Behind the tripline），Stop Loss Points（300），Stop Loss ATR Multiple（1.5），ATR Period（14）。
- Take Profit（2.0 R，0 = 不设）。
- Maximum Spread for Entries（30 点，0 = 不限），Maximum Slippage（10 点），Magic Number（26101700）。
- Exit Scope（All trades on this symbol 或 This magic number only），Exit Also Deletes Pending Orders（false）。
- Popup Alert on Fire（true），Sound Alert on Fire（true），Push Notification on Fire（false），Email on Fire（false），Proximity Alert（false），Proximity Distance（50 点）。
- Alert Tripline Color、Buy Tripline Color、Sell Tripline Color、Exit Tripline Color。
- Show Tripline Labels（true），Show Fire Markers（true）。
- Panel Corner（Top left、Top right、Bottom right、Bottom left），Panel X Offset（16）和 Panel Y Offset（24），单位像素，Start Minimized（false）。
典型设置
- 趋势线突破：BUY、BAR CLOSE、AUTO、ONCE；Stop Loss Mode = Behind the tripline，Stop Loss Points 100，Take Profit 2。
- 区间跨式：区间上方 BUY 线，下方 SELL 线，TOUCH；One-Cancels-Other for Entry Triplines = true，Trigger Buffer 20。
- 保护性离场：在支撑线上设 EXIT、BAR CLOSE；Exit Scope = All trades on this symbol。
- 价位监视：ALERT、TOUCH、REPEAT；Repeat Cooldown 3，Push Notification on Fire = true。
注意事项与风险
绊线仅在终端运行时有效（无人值守请使用 VPS）。每个品种和 Magic Number 最多 40 条绊线；只能布防 Horizontal Line 和 Trendline 对象。在快速行情或跳空中，市价单可能偏离线价成交。交易存在亏损风险；本工具执行您的计划，并不预测价格。
