数据源订阅配置
数据源订阅是连接 TradingView 指标 和 交易所行情 的桥梁。创建一条订阅，就是告诉系统：用哪个 TV 用户的指标、采集哪个交易所的哪个交易对、用什么时间周期。
前置条件
- 已在 TV 用户配置 中添加了 TradingView 用户（拿到 Session ID、Session Sign、Script ID）
- 已知要采集的交易所和交易对
进入配置页面
- 登录 聚合 SaaS 系统
- 在左侧导航中点击 「业务管理」 → 「数据源订阅」
- 点击蓝色按钮 「新增数据源」
字段说明
必填字段
| 序号 | 字段 | 说明 | 示例 |
|---|---|---|---|
| 1 | 名称 | 给此数据源订阅起个标识名 | 多周期共振 |
| 2 | 公开性 | 选择「公共」或「私有」 | 公共 |
| 3 | 目标类型 | 选择数据来源类型 | TV用户 |
| 4 | 目标 | 选择已添加的 TV 用户 | 多指标共振 (ID:1) |
| 5 | 交易所 | 填写交易所标识 | OKEX |
| 6 | 交易对 | 填写交易对符号 | ETHUSDT.P |
| 7 | 时间周期 | 选择 K 线周期 | 5分钟 |
选填字段
| 字段 | 说明 | 示例 |
|---|---|---|
| K 线类型 | 普通 K 线或平均 K 线（Heikin Ashi） | 普通K线 |
| 指标名称 | 指标的描述性名称 | 多周期共振指标 |
| 数据描述 | 会出现在 AI 分析的提示词中，帮助大模型理解指标含义 | 见下方说明 |
各字段详细说明
1. 名称
自定义标识名，方便你在列表中识别这条订阅。建议用指标名称 + 交易对来命名，如 多周期共振-ETH。
2. 公开性
| 选项 | 说明 |
|---|---|
| 公共 | 所有用户可见，适合通用指标 |
| 私有 | 仅创建者可见，适合自定义私有指标 |
3. 目标类型
| 选项 | 说明 | 凭证来源 |
|---|---|---|
| TV用户 | 直接关联 TradingView 用户 | TV 用户的 Session 凭证 |
| 交易所账号 | 关联已配置的交易所账号 | 交易所账号绑定的 TV 凭证 |
两种类型的区别
两种类型最终都提供 TV 凭证给采集客户端使用。区别在于凭证的管理入口不同——TV用户 直接在 TV 用户管理中维护，交易所账号 绑定在交易所账号上。
4. 目标
下拉选择已添加的 TV 用户（或交易所账号）。列表格式为 名称 (ID:序号)，如 多指标共振 (ID:1)。
目标为空？
如果下拉列表为空，说明还没有添加 TV 用户。请先前往 TV 用户配置 添加。
5. 交易所
填写交易所的英文标识。系统已集成以下交易所：
| 交易所 | 标识 | 说明 |
|---|---|---|
| 币安 | BINANCE | 全球最大 |
| 欧易 | OKEX | OKX |
| DeepCoin | DEEPCOIN | — |
| Gate | GATE | — |
| BitGet | BITGET | — |
标识必须大写
交易所标识使用大写英文字母，如 OKEX、BINANCE，不要写小写。
6. 交易对
填写交易所标准的交易对符号。
| 类型 | 格式 | 示例 | 说明 |
|---|---|---|---|
| 永续合约 | 币种USDT.P | ETHUSDT.P | .P 后缀表示永续合约 |
| 现货 | 币种USDT | ETHUSDT | 无后缀 |
现货与合约的区别
ETHUSDT.P= 以太坊永续合约（带.P后缀）ETHUSDT= 以太坊现货（不带后缀）- 两者价格不同，请根据实际交易需求填写
7. 时间周期
选择 K 线的周期。系统会在每根 K 线收盘的瞬间采集指标数据。
| 选项 | 说明 |
|---|---|
| 1 分钟 | 高频采集，适合短线 |
| 5 分钟 | 短线常用 |
| 15 分钟 | 中短线 |
| 30 分钟 | 中线 |
| 1 小时 | 中线常用 |
| 4 小时 | 中长线 |
| 1 天 | 长线 |
周期与采集时机
时间周期决定了采集频率。5 分钟周期 = 每 5 分钟采集一次（K 线收盘瞬间）。系统通过 WebSocket 实时检测 K 线收盘，不是定时轮询，延迟在毫秒级。
8. K 线类型
| 选项 | 说明 |
|---|---|
| 普通K线 | 标准 OHLC K 线（默认） |
| 平均K线 | Heikin Ashi，平滑价格波动，适合趋势分析 |
9. 指标名称
选填。填写指标的描述性名称，方便管理。
10. 数据描述
选填但强烈建议填写。这段描述会出现在 AI 分析的提示词中，帮助大模型理解指标数据的含义，直接影响 AI 决策质量。
好的数据描述示例：
多周期共振指标，输出 13 个时间级别（cur/m10/m15/m30/h1/h2/h4/h8/h12/d1/d2/d3/d5）的趋势线数值。
值低于当前价格为多头格局（后缀_duo），高于当前价格为空头格局（后缀_kong）。
多个时间级别同时出现共振信号时，趋势可靠性更高。
数据描述写作要点
- 说明指标输出什么：趋势线？信号？数值？
- 说明多空标记规则：如
_duo= 做多，_kong= 做空 - 说明关键判断逻辑：如多周期共振 = 多个级别同时出现同向信号
- 语言简洁明确：AI 靠这段文字理解数据，写清楚就行
完整填写示例
以「多周期共振指标采集 ETH 永续合约 5 分钟 K 线」为例：
| 字段 | 填入值 |
|---|---|
| 名称 | 多周期共振 |
| 公开性 | 公共 |
| 目标类型 | TV用户 |
| 目标 | 多指标共振 (ID:1) |
| 交易所 | OKEX |
| 交易对 | ETHUSDT.P |
| 时间周期 | 5分钟 |
| K 线类型 | 普通K线 |
| 指标名称 | 多周期共振指标 |
| 数据描述 | （见上方示例） |
点击 「保存」 即可创建数据源订阅。
创建后如何使用
保存后，这条订阅就有了唯一的数据源 ID（TV_DATA_ID）。在 data-feeder 采集客户端 的 .env 配置中填入这个 ID，启动客户端后系统就会自动：
- 读取订阅配置（交易所、交易对、周期、TV 凭证）
- 连接 TradingView WebSocket 加载指标
- 在每根 K 线收盘瞬间采集 13 个时间级别的趋势线数据
- 零延迟回写到服务端数据库
# .env 中填入数据源 ID
TV_DATA_ID=1
# 启动采集
node clients/tv-indicator.js
常见问题
Q：交易所和交易对怎么填？
交易所填大写英文标识（如 OKEX、BINANCE），交易对按交易所格式填写。永续合约加 .P 后缀，现货不加。详见上方交易所和交易对说明。
Q：目标下拉列表为空？
说明还没有添加 TV 用户。请先前往 TV 用户配置 添加，添加后回到数据源订阅页面刷新即可看到。
Q：可以创建多条订阅吗？
可以。每个交易对、每个周期、每个指标都可以创建独立的订阅。系统支持多订阅并行采集。
Q：数据描述不填会怎样？
不填也能运行，但 AI 分析时缺少指标背景信息，决策质量会降低。强烈建议填写。
Q：修改了配置需要重启采集客户端吗？
是的。修改订阅配置后，需要重启 data-feeder 采集客户端才能生效（Ctrl+C 停止后重新启动）。