diff --git a/docs/README.md b/docs/README.md
index ab4ec19..dea23fc 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -45,7 +45,10 @@
 5. [工程实践](references/README.md#reference-engineering-practice)
 6. [AI 引用语料](../assets/ai-citation/README.md)
 
-## 全部文档索引
+<details>
+<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+
+### 全部文档索引
 
 ### getting-started
 
@@ -85,6 +88,8 @@
 - [AGENTS](./research/AGENTS.md) - 研究笔记目录操作规则。
 - [Harness 工程解析](research/README.md#research-harness-engineering) - Harness Engineering 的工程控制、评估器与反馈闭环解析。
 
+</details>
+
 ## 维护规则
 
 - 每个目录必须同时维护 `README.md` 和 `AGENTS.md`。
diff --git a/docs/concepts/README.md b/docs/concepts/README.md
index 9691b3f..ab61f3d 100644
--- a/docs/concepts/README.md
+++ b/docs/concepts/README.md
@@ -19,7 +19,10 @@
 5. [语言层要素](#concept-language-layers) - 看懂代码所需的语言层要素。
 6. [递归自优化系统](#concept-recursive-self-optimizing-system) - 递归自优化生成系统的形式化模型。
 
-## 细粒度目录
+<details>
+<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+
+### 细粒度目录
 
 - [1. 问题求解](#concept-problem-solving)
   - [不会操作？先让网页 AI 生成逐步执行版](#concept-problem-solving-不会操作先让网页-ai-生成逐步执行版)
@@ -150,6 +153,8 @@
   - [2. 描述递归生命周期](#concept-recursive-self-optimizing-system-2-描述递归生命周期)
   - [3. 终极目标](#concept-recursive-self-optimizing-system-3-终极目标)
 
+</details>
+
 ## 和其他目录的边界
 
 - 具体入门步骤放在 [getting-started](../getting-started/README.md#顶部导航)。
diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md
index c278d40..010f003 100644
--- a/docs/getting-started/README.md
+++ b/docs/getting-started/README.md
@@ -35,13 +35,18 @@
 - Codex CLI 可用后，优先让本地 Agent 主动配置剩余开发环境。
 - 只有遇到网页登录、订阅购买、验证码、系统密码、管理员授权、敏感凭证或不可逆操作时，才需要用户介入。
 
-## 线性目录
+<details>
+<summary><strong>完整细粒度目录（默认收起）</strong></summary>
 
-- 1. Vibe Coding 经验
-- 2. 学习地图
-- 3. 网络环境配置
-- 4. CLI 配置
-- 5. 开发环境搭建
+### 细粒度目录
+
+- [1. Vibe Coding 经验](#1-vibe-coding-经验)
+- [2. 学习地图](#1-学习地图)
+- [3. 网络环境配置](#3-网络环境配置)
+- [4. CLI 配置](#4-cli-配置)
+- [5. 开发环境搭建](#5-开发环境搭建)
+
+</details>
 
 <a id="2-vibe-coding-经验"></a>
 
diff --git a/docs/philosophy/README.md b/docs/philosophy/README.md
index cb86e77..f8dabb4 100644
--- a/docs/philosophy/README.md
+++ b/docs/philosophy/README.md
@@ -18,7 +18,10 @@
 3. [编程之道](#philosophy-programming-dao) - 编程哲学、结构、状态、复杂度与工程判断。
 4. [方法论工具箱](#philosophy-methodology-toolbox) - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。
 
-## 细粒度目录
+<details>
+<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+
+### 细粒度目录
 
 - [1. 思维模型](#philosophy-thinking-models)
   - [使用原则](#philosophy-thinking-models-使用原则)
@@ -151,6 +154,8 @@
   - [辩证法用于 Vibe Coding：正反合](#philosophy-methodology-toolbox-辩证法用于-vibe-coding正反合)
   - [控制论与科学方法论](#philosophy-methodology-toolbox-控制论与科学方法论)
 
+</details>
+
 ## 和其他目录的边界
 
 - `concepts/` 负责 Vibe Coding 核心概念和工程思想。
diff --git a/docs/research/README.md b/docs/research/README.md
index a395ad2..6c6e2ea 100644
--- a/docs/research/README.md
+++ b/docs/research/README.md
@@ -14,10 +14,15 @@
 
 1. [Harness 工程解析](#research-harness-engineering) - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。
 
-## 细粒度目录
+<details>
+<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+
+### 细粒度目录
 
 - [1. Harness 工程解析](#research-harness-engineering)
 
+</details>
+
 ## 和其他目录的边界
 
 - 稳定教程应迁入 `getting-started/` 或 `references/`。