diff --git a/docs/deploy/prerequisites.md b/docs/deploy/prerequisites.md
index 2528c5c..890e4ae 100644
--- a/docs/deploy/prerequisites.md
+++ b/docs/deploy/prerequisites.md
@@ -114,22 +114,21 @@ firewall-cmd --reload
 
 ## 外部依赖（可选）
 
+以下能力需要外部账号或服务，**不影响平台主流程**：
+
 | 服务 | 用途 | 不配置的影响 |
 | --- | --- | --- |
-| TDengine 3.x | 存流量历史数据 | 历史流量查询不可用，主流程正常 |
 | 短信服务商 | 发送验证码 | 无法发送短信 |
 | 微信支付 | 在线支付 | 支付功能不可用 |
 | 飞书 | 运维通知 | 不启动 bot 即可 |
 
-TDengine 需开启 WebSocket 接口（默认 6041），在 `docker-compose.yml` 中配置：
+::: tip 时序库已内置
+流量历史使用的 TDengine **已包含在编排里**，由 `tdengine-init` 服务在首次启动时自动建库建表，无需额外申请或配置：
 
-```bash
-TDENGINE_HOST=tdengine.example.com
-TDENGINE_PORT=6041
-TDENGINE_USER=root
-TDENGINE_PASSWORD=
-TDENGINE_DAILY_DB=iotlcm_daily
-TDENGINE_MONTHLY_DB=iotlcm_monthly
-```
+| 库 | 分片 | 保留 | 超级表 |
+| --- | --- | --- | --- |
+| `iotlcm_daily` | 7 天 | 3 年 | `t_sim_card_usage_daily` |
+| `iotlcm_monthly` | 30 天 | 3 年 | `t_sim_card_usage_monthly` |
 
-不使用时全部留空。
+编排使用的版本是 `3.3.6.13`（公开镜像可得），生产为 `3.4.0.9`。如需与生产完全一致，可自行构建镜像并替换 `docker-compose.yml` 中的 tag。
+:::
diff --git a/docs/deploy/troubleshooting.md b/docs/deploy/troubleshooting.md
index afb57ef..a6232d9 100644
--- a/docs/deploy/troubleshooting.md
+++ b/docs/deploy/troubleshooting.md
@@ -143,13 +143,23 @@ docker compose logs upstream-chan --tail=50
 
 ### 历史流量查询无数据
 
-**原因**：TDengine 未配置或不可达。
+**原因**：TDengine 未启动、未完成建表，或配置里的地址不对。
 
 ```bash
 docker compose logs worker-svr | grep -i 'tdengine\|taos' | tail -20
+docker compose logs tdengine-init | tail -20     # 建库建表是否成功
+docker compose exec tdengine taos -s "show databases;"
 ```
 
-确认 `docker-compose.yml` 的 `TDENGINE_*` 已填，且 WebSocket 端口（默认 6041）可达。不用该功能留空即可。
+常见原因与处理：
+
+| 现象 | 原因 | 处理 |
+| --- | --- | --- |
+| `tdengine-init` 报 MISS | 建表失败 | 看该容器日志里的 `DB error`；改 `tdengine-init/init.sql` 后重跑 `docker compose up -d tdengine-init` |
+| worker 日志报库表不存在 | 未执行建表 | 同上，确保 init 容器退出码为 0 |
+| 连接超时 | 地址/端口不对 | 配置里应为 `ws(tdengine:6041)`，容器内用服务名而非 IP |
+
+建表脚本全部带 `IF NOT EXISTS`，可重复执行。
 
 ### 短信发不出去