From b8ee90a99631862757229a163b3625e6ca3e83bb Mon Sep 17 00:00:00 2001
From: lingniu <lingniu@lingnius-Mac-mini.local>
Date: Wed, 1 Jul 2026 04:24:48 +0800
Subject: [PATCH] docs: align history troubleshooting comments

---
 .../protocol/gb32960/inbound/Gb32960ChannelHandler.java       | 3 ++-
 .../lingniu/ingest/sink/mq/KafkaEnvelopeConsumerFactory.java  | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/modules/protocols/protocol-gb32960/src/main/java/com/lingniu/ingest/protocol/gb32960/inbound/Gb32960ChannelHandler.java b/modules/protocols/protocol-gb32960/src/main/java/com/lingniu/ingest/protocol/gb32960/inbound/Gb32960ChannelHandler.java
index 8df345c4..3f28adb9 100644
--- a/modules/protocols/protocol-gb32960/src/main/java/com/lingniu/ingest/protocol/gb32960/inbound/Gb32960ChannelHandler.java
+++ b/modules/protocols/protocol-gb32960/src/main/java/com/lingniu/ingest/protocol/gb32960/inbound/Gb32960ChannelHandler.java
@@ -383,7 +383,8 @@ public class Gb32960ChannelHandler extends SimpleChannelInboundHandler<byte[]> {
      * 部分车端实现严格按规范，没收到应答会停止后续上报或重连。ack-tag 按 cmd.code 区分便于日志筛选。
      *
      * <p>注意：应答成功表示当前配置的 Kafka sink 已完成该帧映射事件的 dispatch 边界。
-     * 生产排查其他存储问题时，应继续检查 raw archive sink、EventFileStoreSink 等可选 sink 的日志。
+     * 生产排查历史数据问题时，应继续检查 raw archive sink、Kafka topic 和 history app 的
+     * TDengine raw_frames 写入日志。
      *
      * <p>日志策略（按 (channel, vin, rawTypeSignature) 去重，避免高频帧刷屏）：
      * <ul>
diff --git a/modules/sinks/sink-mq/src/main/java/com/lingniu/ingest/sink/mq/KafkaEnvelopeConsumerFactory.java b/modules/sinks/sink-mq/src/main/java/com/lingniu/ingest/sink/mq/KafkaEnvelopeConsumerFactory.java
index 7d8a82cd..7fda1bc0 100644
--- a/modules/sinks/sink-mq/src/main/java/com/lingniu/ingest/sink/mq/KafkaEnvelopeConsumerFactory.java
+++ b/modules/sinks/sink-mq/src/main/java/com/lingniu/ingest/sink/mq/KafkaEnvelopeConsumerFactory.java
@@ -62,8 +62,8 @@ public final class KafkaEnvelopeConsumerFactory {
         if (configured != null && !configured.isEmpty()) {
             return configured;
         }
-        // 默认绑定保留老派生模块的消费能力；32960 主链路不依赖这些派生表，
-        // 历史查询以 event-file-store 的 RAW 索引和 archive .bin 为准。
+        // 默认绑定仅给未显式配置 bindings 的轻量运行时兜底。
+        // 生产 history app 会显式绑定各协议 event/raw topic，并写入 TDengine raw_frames/locations。
         SinkMqProperties.Topics topics = props.getTopics();
         Map<String, SinkMqProperties.Binding> defaults = new LinkedHashMap<>();
         defaults.put("eventHistoryEnvelopeConsumerProcessor", binding(