diff --git a/开发文档/README.md b/开发文档/README.md
index c0168889d8..246e20c828 100644
--- a/开发文档/README.md
+++ b/开发文档/README.md
@@ -8,6 +8,9 @@ related:
   - "[[开发文档/README|开发文档总入口]]"
   - "[[开发进度总表]]"
 ---
+
+![文档说明](images/doc-headers/工作手机__开发文档__README.png)
+
 # 工作手机SDK v3.0 - 开发文档
 
 > **🗂️ 项目目录总览（Obsidian 入口）**：[2、架构/01-总览/项目目录总览.md](2、架构/01-总览/项目目录总览.md)
@@ -20,7 +23,12 @@ related:
 > **管理Skill**：**本项目目录下** `机擎/SKILL.md`（火炬总控，五人分配：阿表/阿机/阿桥/阿端/阿服）  
 > **更新**：2026-05-24 | **当前项目状态**：总进度 **99.5%**  
 > **约定**：顶层**仅 `1、需求` … `10、项目管理` 十个编号目录**；Soul 等平台调研在 [1、需求/03-调研/平台分析/](1、需求/03-调研/平台分析/)。  
-> **标签与关联**：每篇 MD 含 YAML `tags` / `related` / `parent` + 文末 **🔗 关联导航**；规范见 [机擎/阿表/开发文档结构规范/SKILL.md](../机擎/阿表/开发文档结构规范/SKILL.md) §四B。
+> **标签与关联**：每篇 MD 含 YAML `tags` / `related` / `parent` + 文末 **🔗 关联导航** + 顶部 **![文档说明] 头图**；规范见 [机擎/阿表/开发文档结构规范/SKILL.md](../机擎/阿表/开发文档结构规范/SKILL.md) §四B、§四C。
+
+> ## ⚠️ 真机开发铁律（强制 · 每次必守）
+>
+> **[2、架构/01-总览/真机开发铁律.md](2、架构/01-总览/真机开发铁律.md)** — 机器真机 + 卡若AI；**禁止占位/模拟**；标完成须真机 E2E 留痕。  
+> 门禁：`8、部署/05-测试验收/scripts/real_device_gate.sh` · 清单：`8、部署/05-测试验收/真机开发每轮检查清单.md`
 
 ---