From 1020f6d26ca7fdcf0f31b28b7c23eb2c52d52dea Mon Sep 17 00:00:00 2001
From: Wanderingss <1624155937@qq.com>
Date: Fri, 2 Oct 2026 01:49:35 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=9A=E4=BF=AE=E6=AD=A3?=
 =?UTF-8?q?=E4=B8=B2=E5=8F=A3=E5=8A=A9=E6=89=8B=20state=20=E8=BF=90?=
 =?UTF-8?q?=E8=A1=8C=E6=97=B6=E6=96=87=E4=BB=B6=E5=BC=95=E7=94=A8=E8=A2=AB?=
 =?UTF-8?q?=20CI=20doc-links=20=E8=AF=AF=E6=8A=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/测试说明/串口助手使用指南.md | 4 +++-
 docs/测试说明/串口助手设计说明.md | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/测试说明/串口助手使用指南.md b/docs/测试说明/串口助手使用指南.md
index 9db65911..82ebdc99 100644
--- a/docs/测试说明/串口助手使用指南.md
+++ b/docs/测试说明/串口助手使用指南.md
@@ -218,10 +218,12 @@ Select-String -Path 'tools\serial_tool\state\serial.log' -Pattern 'App init OK'
 
 ### 4.1 三个文件
 
+以下文件均在 `state/` 下，属**运行时产物，未创建于仓库**（首次运行工具后才生成）：
+
 | 文件 | 内容 | 谁读 |
 |---|---|---|
 | `tools/serial_tool/state/serial.log` | RX/TX/SYS 全量日志 | 你（Read/Grep/`log` 命令） |
-| `tools/serial_tool/state/meta.json` | daemon pid / 版本 / 当前 gen / 口配置快照 | 工具内部 |
+| `tools/serial_tool/state/meta.json`（运行时未创建） | daemon pid / 版本 / 当前 gen / 口配置快照 | 工具内部 |
 | `tools/serial_tool/state/daemon.log` | daemon 自身 stderr（启动行、异常） | 排障时看 |
 
 整个 `state/` 目录已 gitignore——纯本机运行时产物。
diff --git a/docs/测试说明/串口助手设计说明.md b/docs/测试说明/串口助手设计说明.md
index aa5c5ba9..7008e1c0 100644
--- a/docs/测试说明/串口助手设计说明.md
+++ b/docs/测试说明/串口助手设计说明.md
@@ -123,10 +123,12 @@ flowchart LR
 
 ### 5.1 位置与配套文件（目录整体 gitignore）
 
+以下均为**运行时产物，未创建于仓库**（首次运行工具后自动生成）：
+
 | 文件 | 用途 |
 |---|---|
 | `tools/serial_tool/state/serial.log` | RX/TX/SYS 全量日志（Agent 直接读） |
-| `tools/serial_tool/state/meta.json` | daemon 元数据（pid / 版本 / 当前 gen） |
+| `tools/serial_tool/state/meta.json`（运行时未创建） | daemon 元数据（pid / 版本 / 当前 gen） |
 | `tools/serial_tool/state/daemon.log` | daemon 自身 stderr（排障用） |
 
 ### 5.2 行格式