docs: clarify collapsible section summaries

docs/README.md

@@ -46,7 +46,7 @@
 6. [AI 引用语料](../assets/ai-citation/README.md)
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 全部文档索引
 

docs/concepts/README.md

@@ -20,7 +20,7 @@
 6. [递归自优化系统](#concept-recursive-self-optimizing-system) - 递归自优化生成系统的形式化模型。
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -172,7 +172,7 @@
 ---
 
 <details>
-<summary><strong>1. 问题求解</strong> - 目标、现状、差距、标准、约束、对象与路径。</summary>
+<summary><strong>1. 问题求解</strong> - 目标、现状、差距、标准、约束、对象与路径。（点击展开/收起）</summary>
 
 <a id="concept-problem-solving"></a>
 
@@ -758,7 +758,7 @@ A 和 B 之间的距离、障碍、路线不清楚的地方，就是问题。
 </details>
 
 <details>
-<summary><strong>2. 拼好码</strong> - 复用成熟能力，用胶水代码连接、编排、适配业务流程。</summary>
+<summary><strong>2. 拼好码</strong> - 复用成熟能力，用胶水代码连接、编排、适配业务流程。（点击展开/收起）</summary>
 
 <a id="concept-glue-coding"></a>
 
@@ -1273,7 +1273,7 @@ AI 特别适合生成：
 </details>
 
 <details>
-<summary><strong>3. 系统构建方法</strong> - 自顶向下、自底向上与分而治之的组合使用。</summary>
+<summary><strong>3. 系统构建方法</strong> - 自顶向下、自底向上与分而治之的组合使用。（点击展开/收起）</summary>
 
 <a id="concept-system-building"></a>
 
@@ -1431,7 +1431,7 @@ AI 特别适合生成：
 </details>
 
 <details>
-<summary><strong>4. 开发范式演进</strong> - 软件工程组织方式的演进。</summary>
+<summary><strong>4. 开发范式演进</strong> - 软件工程组织方式的演进。（点击展开/收起）</summary>
 
 <a id="concept-development-paradigms"></a>
 
@@ -1464,7 +1464,7 @@ AI 特别适合生成：
 </details>
 
 <details>
-<summary><strong>5. 语言层要素</strong> - 看懂代码所需的语言层要素。</summary>
+<summary><strong>5. 语言层要素</strong> - 看懂代码所需的语言层要素。（点击展开/收起）</summary>
 
 <a id="concept-language-layers"></a>
 
@@ -2029,7 +2029,7 @@ async def get_user(user_id: int, db: Session = Depends(get_db)):
 </details>
 
 <details>
-<summary><strong>6. 递归自优化系统</strong> - 递归自优化生成系统的形式化模型。</summary>
+<summary><strong>6. 递归自优化系统</strong> - 递归自优化生成系统的形式化模型。（点击展开/收起）</summary>
 
 <a id="concept-recursive-self-optimizing-system"></a>
 

docs/getting-started/README.md

@@ -36,7 +36,7 @@
 - 只有遇到网页登录、订阅购买、验证码、系统密码、管理员授权、敏感凭证或不可逆操作时，才需要用户介入。
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -49,7 +49,7 @@
 </details>
 
 <details>
-<summary><strong>1. Vibe Coding 经验</strong> - 通用语言能力、人机分工、机器门禁和入门铁律。</summary>
+<summary><strong>1. Vibe Coding 经验</strong> - 通用语言能力、人机分工、机器门禁和入门铁律。（点击展开/收起）</summary>
 
 <a id="2-vibe-coding-经验"></a>
 
@@ -153,7 +153,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
 </details>
 
 <details>
-<summary><strong>2. 学习地图</strong> - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。</summary>
+<summary><strong>2. 学习地图</strong> - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。（点击展开/收起）</summary>
 
 <a id="1-学习地图"></a>
 
@@ -309,7 +309,7 @@ AI 能安装依赖、执行命令、修复报错、提交 Git；你负责确认
 </details>
 
 <details>
-<summary><strong>3. 网络环境配置</strong> - OpenAI、GitHub、文档和依赖源访问。</summary>
+<summary><strong>3. 网络环境配置</strong> - OpenAI、GitHub、文档和依赖源访问。（点击展开/收起）</summary>
 
 ## 3. 网络环境配置
 
@@ -451,7 +451,7 @@ export http_proxy=http://127.0.0.1:7890
 </details>
 
 <details>
-<summary><strong>4. CLI 配置</strong> - Codex CLI 默认路线与 OpenCode 备选路线。</summary>
+<summary><strong>4. CLI 配置</strong> - Codex CLI 默认路线与 OpenCode 备选路线。（点击展开/收起）</summary>
 
 ## 4. CLI 配置
 
@@ -940,7 +940,7 @@ opencode
 </details>
 
 <details>
-<summary><strong>5. 开发环境搭建</strong> - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。</summary>
+<summary><strong>5. 开发环境搭建</strong> - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。（点击展开/收起）</summary>
 
 ## 5. 开发环境搭建
 

docs/philosophy/README.md

@@ -19,7 +19,7 @@
 4. [方法论工具箱](#philosophy-methodology-toolbox) - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -173,7 +173,7 @@
 ---
 
 <details>
-<summary><strong>1. 思维模型</strong> - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。</summary>
+<summary><strong>1. 思维模型</strong> - 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具。（点击展开/收起）</summary>
 
 <a id="philosophy-thinking-models"></a>
 
@@ -408,7 +408,7 @@
 </details>
 
 <details>
-<summary><strong>2. 组合描述模型</strong> - 对象、状态、快照、序列、过程、变换、同一/差异与关系。</summary>
+<summary><strong>2. 组合描述模型</strong> - 对象、状态、快照、序列、过程、变换、同一/差异与关系。（点击展开/收起）</summary>
 
 <a id="philosophy-compositional-description-model"></a>
 
@@ -953,7 +953,7 @@ UserInput(组合描述模型)
 </details>
 
 <details>
-<summary><strong>3. 编程之道</strong> - 编程哲学、结构、状态、复杂度与工程判断。</summary>
+<summary><strong>3. 编程之道</strong> - 编程哲学、结构、状态、复杂度与工程判断。（点击展开/收起）</summary>
 
 <a id="philosophy-programming-dao"></a>
 
@@ -1279,7 +1279,7 @@ UserInput(组合描述模型)
 </details>
 
 <details>
-<summary><strong>4. 方法论工具箱</strong> - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。</summary>
+<summary><strong>4. 方法论工具箱</strong> - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。（点击展开/收起）</summary>
 
 <a id="philosophy-methodology-toolbox"></a>
 

docs/references/README.md

@@ -35,7 +35,7 @@
 
 ```md
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -46,7 +46,7 @@
 ```
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -265,7 +265,7 @@
 ---
 
 <details>
-<summary><strong>1. 工程实践</strong> - 项目架构、代码组织、开发经验、质量门禁与常见坑。</summary>
+<summary><strong>1. 工程实践</strong> - 项目架构、代码组织、开发经验、质量门禁与常见坑。（点击展开/收起）</summary>
 
 <a id="reference-engineering-practice"></a>
 
@@ -2681,7 +2681,7 @@ Redis 的作用：
 ---
 
 <details open>
-<summary><strong>🤖 AI 对话相关</strong></summary>
+<summary><strong>🤖 AI 对话相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2698,7 +2698,7 @@ Redis 的作用：
 </details>
 
 <details open>
-<summary><strong>🧭 工程决策相关</strong></summary>
+<summary><strong>🧭 工程决策相关</strong>（点击展开/收起）</summary>
 
 <a id="reference-engineering-practice-先查资料再写代码"></a>
 ###### 先查资料，再写代码
@@ -2724,7 +2724,7 @@ Redis 的作用：
 ---
 
 <details open>
-<summary><strong>🐍 Python 虚拟环境相关</strong></summary>
+<summary><strong>🐍 Python 虚拟环境相关</strong>（点击展开/收起）</summary>
 
 <a id="reference-engineering-practice-为什么要用虚拟环境"></a>
 ###### 为什么要用虚拟环境？
@@ -2786,7 +2786,7 @@ pip install -r requirements.txt
 ---
 
 <details open>
-<summary><strong>📦 Node.js 环境相关</strong></summary>
+<summary><strong>📦 Node.js 环境相关</strong>（点击展开/收起）</summary>
 
 <a id="reference-engineering-practice-常见问题-2"></a>
 ###### 常见问题
@@ -2822,7 +2822,7 @@ nvm use 18
 ---
 
 <details open>
-<summary><strong>🔧 环境配置相关</strong></summary>
+<summary><strong>🔧 环境配置相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2838,7 +2838,7 @@ nvm use 18
 ---
 
 <details open>
-<summary><strong>🌐 网络相关</strong></summary>
+<summary><strong>🌐 网络相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2872,7 +2872,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>📝 代码相关</strong></summary>
+<summary><strong>📝 代码相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2888,7 +2888,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🎯 Claude Code / Cursor 相关</strong></summary>
+<summary><strong>🎯 Claude Code / Cursor 相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2904,7 +2904,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🚀 部署相关</strong></summary>
+<summary><strong>🚀 部署相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2920,7 +2920,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🗄️ 数据库相关</strong></summary>
+<summary><strong>🗄️ 数据库相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2935,7 +2935,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🐳 Docker 相关</strong></summary>
+<summary><strong>🐳 Docker 相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2949,7 +2949,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🧠 大模型使用相关</strong></summary>
+<summary><strong>🧠 大模型使用相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2968,7 +2968,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🏗️ 软件架构相关</strong></summary>
+<summary><strong>🏗️ 软件架构相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -2985,7 +2985,7 @@ git config --global https.proxy http://127.0.0.1:7890
 ---
 
 <details open>
-<summary><strong>🔄 Git 版本控制相关</strong></summary>
+<summary><strong>🔄 Git 版本控制相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3023,7 +3023,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>🧪 测试相关</strong></summary>
+<summary><strong>🧪 测试相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3039,7 +3039,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>⚡ 性能相关</strong></summary>
+<summary><strong>⚡ 性能相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3055,7 +3055,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>🔐 安全相关</strong></summary>
+<summary><strong>🔐 安全相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3071,7 +3071,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>📱 前端开发相关</strong></summary>
+<summary><strong>📱 前端开发相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3088,7 +3088,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>🖥️ 后端开发相关</strong></summary>
+<summary><strong>🖥️ 后端开发相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3104,7 +3104,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>🔌 API 设计相关</strong></summary>
+<summary><strong>🔌 API 设计相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3120,7 +3120,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>📊 数据处理相关</strong></summary>
+<summary><strong>📊 数据处理相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3136,7 +3136,7 @@ git stash pop
 ---
 
 <details open>
-<summary><strong>🤝 协作相关</strong></summary>
+<summary><strong>🤝 协作相关</strong>（点击展开/收起）</summary>
 
 | 问题 | 原因 | 解决方案 |
 |:---|:---|:---|
@@ -3771,7 +3771,7 @@ CPU 成本
 </details>
 
 <details>
-<summary><strong>2. 技术栈</strong> - 技术栈选型、组合案例与学习路径。</summary>
+<summary><strong>2. 技术栈</strong> - 技术栈选型、组合案例与学习路径。（点击展开/收起）</summary>
 
 <a id="reference-technology-stack"></a>
 

docs/research/README.md

@@ -15,7 +15,7 @@
 1. [Harness 工程解析](#research-harness-engineering) - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。
 
 <details>
-<summary><strong>完整细粒度目录（默认收起）</strong></summary>
+<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
 
 ### 细粒度目录
 
@@ -39,7 +39,7 @@
 ---
 
 <details>
-<summary><strong>1. Harness 工程解析</strong> - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。</summary>
+<summary><strong>1. Harness 工程解析</strong> - 工程控制、评估器、反馈闭环与 AI 生成系统可靠性。（点击展开/收起）</summary>
 
 <a id="research-harness-engineering"></a>