diff --git a/.gitignore b/.gitignore
index 1378ba6..54a1eec 100644
--- a/.gitignore
+++ b/.gitignore
@@ -30,6 +30,10 @@ fish_api/.venv/
 fish_api/.data/
 .env
 
+# 本地联调样本（MP4/SVO 等大文件不放仓库，见 mockdata/README.md）
+mockdata/*
+!mockdata/README.md
+
 # OS / IDE
 .DS_Store
 .cursor/
diff --git a/mockdata/README.md b/mockdata/README.md
index b516a75..154074a 100644
--- a/mockdata/README.md
+++ b/mockdata/README.md
@@ -1,19 +1,30 @@
 # mockdata
 
-用于本地联调 **FishAction 目录监控**（`ACTION_WATCH_DIR`）的示例文件。
+用于本地联调 **FishAction 目录监控**（`ACTION_WATCH_DIR`）的示例视频。  
+目录内 **除本 README 外** 的大文件已加入 `.gitignore`，不会随仓库克隆；请在本机从训练集拷贝或自行放入 MP4。
 
-| 文件 | 来源 |
+## 本机已拷贝的样本（来源：`~/data/fish/fish_action_videos/`）
+
+| 文件 | 说明 |
 |------|------|
-| `fish_action_feeding_sample.mp4` | 本机训练集 `~/data/fish/fish_action_videos/feeding/` 中片段（约 1.5MB） |
+| `fish_action_feeding_sample.mp4` | feeding，约 1.5MB |
+| `fish_action_feeding_02.mp4` | feeding，约 1.7MB |
+| `fish_action_feeding_03.mp4` | feeding，约 2.3MB |
+| `fish_action_scared_sample.mp4` | scared，约 14MB |
+| `fish_action_normal_sample.mp4` | normal，约 59MB |
 
-**FishMeasure（SVO2）**：仓库内未放入大体积 `.svo2`。本机示例路径示例：
+## FishMeasure（SVO2）
 
-`/home/ubuntu/data/fish/2016-1-22-last/fish17/HD1080_SN43186771_13-23-08.svo2`（约数百 MB）
+大体积 `.svo2` 未放入本目录。本机示例：
 
-可通过 ingest 接口分块上传该文件做称重联调。
+`/home/ubuntu/data/fish/2016-1-22-last/fish17/HD1080_SN43186771_13-23-08.svo2`
 
-`.env` 中请将 `ACTION_WATCH_DIR` 设为**本仓库绝对路径**，例如：
+可通过 ingest 分块上传做称重联调。
+
+## `.env`
+
+`ACTION_WATCH_DIR` 指向本目录绝对路径，例如：
 
 `ACTION_WATCH_DIR=/home/ubuntu/projects/FishServer/mockdata`
 
-（若你克隆到其它目录，请改成对应的 `.../FishServer/mockdata`。）
+监控已处理列表会生成 `mockdata/.fishaction_watch_processed.json`（同样被 gitignore 忽略）。
diff --git a/mockdata/fish_action_feeding_sample.mp4 b/mockdata/fish_action_feeding_sample.mp4
deleted file mode 100644
index fe97ab4..0000000
Binary files a/mockdata/fish_action_feeding_sample.mp4 and /dev/null differ