何时使用

当用户提出以下类型的请求时，主动调用此技能：

• 询问 BTC、比特币、黄金、XAUUSD 等标的的行情、走势、涨跌
• 需要技术指标分析（RSI、MACD、布林带、EMA、ATR、成交量、顾比均线、斐波那契、VWAP、成交量分布）
• 需要判断趋势方向、主力资金态度（顾比均线长期组位置）
• 需要识别斐波那契关键支撑/阻力位
• 需要判断价格相对 VWAP 的强弱（机构持仓成本参考）
• 需要了解主力成交密集区（POC/VAH/VAL）
• 需要生成行情分析推文、日报、周报
• 需要判断当前趋势方向、支撑阻力位、操作建议（BUY/SELL/HOLD）
• 需要同时查看多个时间周期（1h/4h/日/周/月）综合研判
• 用户要求"分析一下今天行情"、"BTC 现在多空如何"、"黄金值得买吗"等

调用前置检查（每次调用前必须执行）

在运行 signalbot 前，先检查二进制是否存在：

which signalbot

• 若有输出路径 → 直接继续调用
• 若无输出（command not found）→ 立即自动执行以下命令编译安装，无需询问用户：

go install github.com/shanhuhai5739/signalbot@latest

安装完成后继续执行原始分析请求。如果 go 也不存在，提示用户先安装 Go（https://go.dev/dl）。

调用方式

单周期分析

使用 exec 工具（或 bash）运行以下命令，将 stdout 捕获为 JSON：

signalbot analyze --asset <标的> --timeframe <周期>

注意：命令会在 stderr 输出进度提示（可忽略），JSON 报告输出到 stdout。

多周期综合分析（推荐用于趋势研判）

signalbot multi --asset <标的>

并发分析 1h / 4h / 1d / 1w / 1M 五个时间维度，返回含 summary.alignment（趋势共振方向）的综合报告。

--asset 合法值

值	含义
BTC	比特币 (BTCUSDT)
XAUUSD	黄金 (XAUUSDT)
ETH	以太坊 (ETHUSDT)
SOL	Solana (SOLUSDT)
BNB	币安币 (BNBUSDT)

也可直接填写 Binance 符号，如 BTCUSDT。

--timeframe 合法值

值	适用场景
1h	短线日内分析
4h	中线波段分析（推荐默认）
1d	长线趋势分析
1w	周线趋势
1M	月线（年线方向参考）
15m	超短线

可选参数

• --limit <数量>：拉取 K 线数量，默认 200，最多 1500
• --output <文件路径>：将 JSON 写入文件而非 stdout

---

JSON 输出字段解读

拿到 JSON 后，按以下规则解读各字段，再生成自然语言分析：

price（最新价格快照）

• current：当前收盘价
• change_pct：较上一根 K 线的涨跌幅（%）

indicators.rsi

• value：RSI 值（0–100）
• signal：

- overbought（≥70）→ 超买，注意回调 - bullish（55–69）→ 强势区间 - neutral（46–54）→ 中性观望 - bearish（31–45）→ 弱势区间 - oversold（≤30）→ 超卖，关注反弹

indicators.macd

• histogram > 0 → 多头动能增强
• histogram < 0 → 空头动能增强
• cross: "golden_cross" → 金叉（强看涨信号）
• cross: "death_cross" → 死叉（强看跌信号）

indicators.bollinger

• percent_b：价格在布林带中的位置（0=下轨，0.5=中轨，1=上轨）
• position: "upper_zone" → 强势突破区，"lower_zone" → 弱势区
• width：带宽越窄代表价格越压缩，往往是行情突破前兆

indicators.ema

• alignment: "strongly_bullish" → EMA9>21>50>200，四线多头完全排列
• alignment: "bullish" → EMA9>21>50，短中期多头
• alignment: "bearish" / "strongly_bearish" → 空头排列

indicators.atr

• pct：ATR 占当前价格的百分比
• regime: "low_volatility" → 市场压缩，突破在即；"high_volatility" → 波动剧烈，注意止损

indicators.volume

• ratio：当前成交量 / 20日均量
• signal: "high_volume" 或 "above_average" → 成交量放大确认行情
• signal: "low_volume" → 量能不足，信号可信度下降

indicators.guppy（顾比均线 GMMA）

• 短期组（ema3~ema21）代表投机/交易者资金；长期组（ema34~ema377）代表机构/长线资金
• alignment:

- "above_long" → 短期组整体高于长期组，趋势强劲（多头） - "below_long" → 短期组整体低于长期组，趋势向下（空头） - "crossing" → 两组交叉重叠，处于压缩期（趋势转换中，谨慎）

• gap_pct > 0 → 短期组高于长期组的幅度；< 0 → 短期组低于长期组
• signal: bullish / compression / bearish
• 注意：ema233 和 ema377 需 233+/377+ 根 K 线，不足时为 0（信号仍基于已有数据）

indicators.fibonacci（斐波那契回撤）

• 基于最近 100 根 K 线的摆动高低点，自动标定 0%→100% 七个水平
• levels[]：每个水平含 label（如 "61.8%"）、price、is_above（当前价是否高于该水平）
• nearest_level：当前价最近的斐波那契水平
• distance_pct：距最近水平的百分比距离；< 1.5% 时触发 signal
• signal:

- "at_support" → 价格贴近斐波那契支撑位，关注多头反弹 - "at_resistance" → 价格贴近斐波那契阻力位，关注回调压力 - "between_levels" → 价格在两水平之间，方向中性

• direction: "upper_half" → 处于摆动区间上半段（多头占优）；"lower_half" → 下半段（空头占优）

indicators.vwap（锚定 VWAP）

• 锚定最近 50 根 K 线起点，计算量价加权均价及 ±1σ / ±2σ 标准差通道
• value：VWAP 值（机构持仓均价参考）
• deviation_pct：当前价格偏离 VWAP 的百分比
• position:

- "above_band2" → 严重超买（偏离 > 2σ） - "above_band1" → 偏强势（偏离 > 1σ） - "above_vwap" → 价格高于 VWAP，多头主导 - "below_vwap" → 价格低于 VWAP，空头主导 - "below_band1" → 偏弱势 - "below_band2" → 严重超卖（偏离 > 2σ），均值回归机会

• signal: overbought / bullish / bearish / oversold

indicators.vpvr（固定范围成交量分布）

• 取最近 100 根 K 线，划分为 24 档，按比例分配成交量
• poc（Point of Control）：成交量最密集的价格档，最强支撑/阻力参考
• vah（Value Area High）：70% 价值区间上边界
• val（Value Area Low）：70% 价值区间下边界
• bins[]：每档含 price_low/high/mid、volume、is_poc、is_value_area
• signal:

- "above_vah" → 价格突破价值区高点，强势看涨（若有量配合） - "above_poc" → 在 POC 上方，多头占优 - "at_poc" → 价格在 POC 附近（±0.5%），强支撑/阻力博弈 - "below_poc" → 在 POC 下方，空头占优 - "below_val" → 价格跌破价值区低点，弱势信号

analysis（综合研判）

• trend：bullish / neutral / bearish
• strength：strong / moderate / weak
• signal：BUY / SELL / HOLD
• confidence：0–100 置信度，基于多指标共振程度
• score：原始评分（-8 到 +8），负数越大越空头
• key_levels.support：近期支撑价位列表（从近到远）
• key_levels.resistance：近期阻力价位列表（从近到远）

multi 命令专属字段（summary）

• alignment：all_bullish / mostly_bullish / mixed / mostly_bearish / all_bearish
• dominant_signal：多周期共振后的综合信号（BUY/SELL/HOLD）
• signals：各周期单独信号（如 {"1h":"BUY","4h":"HOLD","1d":"SELL",...}）
• confidence：多周期共振置信度

---

推文生成指南

拿到 JSON 数据后，按以下结构生成中文行情分析推文（约 220–300 字）：

📊 $<标的> | <时间周期>行情分析
📈/📉 趋势：<多头/空头/震荡>（）
关键指标：
• RSI()：<信号描述>
• MACD：
• EMA排列：<描述>
• 布林带：<价格位置描述>
• 顾比均线：<短长期组关系 + alignment 信号>
• VWAP：<价格偏离描述，position 信号>
🎯 关键价位：
支撑：$ / $（含 Fib  水平）
阻力：$ / $
成交密集区(POC)：$（价值区 $–$）
⚡️ ATR波动：（%）
📊 成交量：
🔖 操作建议：（置信度 %）
<简要理由，1–2句>
#BTC #Bitcoin #行情分析 #量化交易

---

多标的分析示例

如需同时分析 BTC 和黄金，依次运行两条命令，再合并分析：

signalbot analyze --asset BTC --timeframe 4h
signalbot analyze --asset XAUUSD --timeframe 1d

多周期分析示例

# BTC 五周期综合研判（推荐用于趋势确认）
signalbot multi --asset BTC
# 黄金多周期分析
signalbot multi --asset XAUUSD

解读 multi 报告时重点关注：

• summary.alignment — 多周期趋势是否共振（all_bullish/all_bearish 信号最强）
• 各周期 indicators.guppy.alignment — 不同时间维度下的资金分布
• 各周期 indicators.vpvr.poc — 不同周期的主力成交密集区

更新二进制

当用户要求更新 signalbot 或检测到有新版本时，自动运行：

go install github.com/shanhuhai5739/signalbot@latest

更新完成后告知用户已更新至最新版本。

常见问题处理

• go 命令不存在：提示用户安装 Go https://go.dev/dl，安装后重新触发 go install
• EMA233/EMA377 为 0：数据不足，属正常现象；顾比信号仍基于可用的 EMA 值计算
• 数据不足：XAUUSD 建议使用 1d 周期；BTC 各周期均可
• 网络超时：建议设置 BINANCE_BASE_URL 环境变量切换为代理地址