refactor: 重组文档目录结构

按学习路径聚合：
- 01-入门指南：从零开始vibecoding + 教程与指南
- 02-方法论：方法论与原则 + 胶水编程
- 03-实战：实战案例 + 项目实战经验
- 04-资源：模板与资源 + 外部资源聚合 + 常见坑汇总

更新各目录 README 和根 README 链接

README.md

@@ -66,10 +66,10 @@
   <a href="./libs/external/prompts-library/prompt_docs/"><img src="https://img.shields.io/badge/提示词-大全-orange?style=for-the-badge" alt="提示词大全"></a>
   <a href="https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=2093180351#gid=2093180351&range=A1"><img src="https://img.shields.io/badge/提示词-在线表格(推荐)-blue?style=for-the-badge" alt="提示词在线表格（推荐）"></a>
   <a href="https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools"><img src="https://img.shields.io/badge/系统提示词-仓库-slateblue?style=for-the-badge" alt="系统提示词仓库"></a>
-  <a href="./i18n/zh/documents/从零开始vibecoding/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
-  <a href="./i18n/zh/documents/实战案例/README.md"><img src="https://img.shields.io/badge/🎬_实战案例-项目实操-orange?style=for-the-badge" alt="实战案例"></a>
-  <a href="./i18n/zh/documents/常见坑汇总/README.md"><img src="https://img.shields.io/badge/🕳️_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
-  <a href="./i18n/zh/documents/外部资源聚合/README.md"><img src="https://img.shields.io/badge/📡_信息源-聚合-teal?style=for-the-badge" alt="信息源聚合"></a>
+  <a href="./i18n/zh/documents/01-入门指南/README.md"><img src="https://img.shields.io/badge/🚀_从零开始-新手入门-red?style=for-the-badge" alt="从零开始"></a>
+  <a href="./i18n/zh/documents/03-实战/README.md"><img src="https://img.shields.io/badge/🎬_实战案例-项目实操-orange?style=for-the-badge" alt="实战案例"></a>
+  <a href="./i18n/zh/documents/04-资源/常见坑汇总.md"><img src="https://img.shields.io/badge/🕳️_常见坑-避坑指南-yellow?style=for-the-badge" alt="常见坑汇总"></a>
+  <a href="./i18n/zh/documents/04-资源/外部资源聚合.md"><img src="https://img.shields.io/badge/📡_信息源-聚合-teal?style=for-the-badge" alt="信息源聚合"></a>
   <a href="./libs/external/chat-vault/README_CN.md"><img src="https://img.shields.io/badge/🔐_Chat_Vault-全部AI会话数据库-gold?style=for-the-badge" alt="Chat Vault"></a>
 </p>
 

i18n/zh/documents/01-入门指南/README.md

@@ -0,0 +1,21 @@
+# 🚀 入门指南
+
+> 从零开始学习 Vibe Coding，配置环境，掌握工具
+
+## 📚 学习路径
+
+### 从零开始
+1. [Vibe Coding 哲学原理](./00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
+2. [网络环境配置](./01-网络环境配置.md) - 配置网络访问
+3. [开发环境搭建](./02-开发环境搭建.md) - 搭建开发环境
+4. [IDE 配置](./03-IDE配置.md) - 配置编辑器
+
+### 工具教程
+- [tmux 快捷键大全](./tmux快捷键大全.md) - 终端复用工具
+- [LazyVim 快捷键大全](./LazyVim快捷键大全.md) - Neovim 配置框架
+- [Augment MCP 配置](./auggie-mcp配置文档.md) - 上下文引擎配置
+- [手机远程 Vibe Coding](./关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
+
+## 🔗 相关资源
+- [方法论](../02-方法论/) - 深入理解 Vibe Coding 方法论
+- [实战](../03-实战/) - 动手实践项目

i18n/zh/documents/02-方法论/README.md

@@ -0,0 +1,32 @@
+# 🧭 方法论
+
+> Vibe Coding 的核心理念、原则与经验
+
+## 📖 核心方法论
+
+### 胶水编程 (Glue Coding)
+- [胶水编程概述](./胶水编程-概述.md) - 软件工程的圣杯与银弹
+- [胶水编程详解](./胶水编程.md) - 深入理解胶水编程
+- [语言层要素](./语言层要素.md) - 看懂 100% 代码的 8 个层级
+- [Glue Coding (EN)](./gluecoding.md) - English version
+
+### 理论基础
+- [递归自优化系统形式化](./A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) - 元方法论
+- [编程之道](./编程之道.md) - 编程哲学
+
+## 🛠️ 实践原则
+
+### 开发经验
+- [开发经验](./开发经验.md) - 变量命名、文件结构、编码规范
+- [学习经验](./学习经验.md) - 学习方法与技巧
+- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
+
+### 提示词工程
+- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词
+
+### 工具配置
+- [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置
+
+## 🔗 相关资源
+- [入门指南](../01-入门指南/) - 从零开始
+- [实战](../03-实战/) - 动手实践

i18n/zh/documents/03-实战/README.md

@@ -0,0 +1,35 @@
+# 🎯 实战
+
+> 从教学案例到真实项目，动手实践 Vibe Coding
+
+## 📚 教学案例
+
+从零构建的入门级项目：
+
+| 案例 | 技术栈 | 难度 |
+|:---|:---|:---|
+| [Todo App](./01-todo-app.md) | React + LocalStorage | ⭐ |
+| [博客系统](./02-blog-system.md) | Next.js + MDX | ⭐⭐ |
+| [聊天机器人](./03-chatbot.md) | Python + OpenAI | ⭐⭐ |
+| [CLI 工具](./04-cli-tool.md) | Python + Click | ⭐⭐ |
+| [Chrome 扩展](./05-chrome-extension.md) | JavaScript + Chrome API | ⭐⭐ |
+
+## 🏗️ 项目实战经验
+
+真实项目的开发经验与复盘：
+
+| 项目 | 说明 |
+|:---|:---|
+| [bot-automation](./bot-automation/) | 自动化机器人 |
+| [cli-tool](./cli-tool/) | 命令行工具 |
+| [data-pipeline](./data-pipeline/) | 数据管道 |
+| [fate-engine-dev](./fate-engine-dev/) | 命运引擎开发 |
+| [game-dev](./game-dev/) | 游戏开发 |
+| [polymarket-dev](./polymarket-dev/) | Polymarket 数据分析 |
+| [telegram-dev](./telegram-dev/) | Telegram Bot 开发 |
+| [web-app](./web-app/) | Web 应用开发 |
+
+## 🔗 相关资源
+- [入门指南](../01-入门指南/) - 环境配置
+- [方法论](../02-方法论/) - 理论基础
+- [资源](../04-资源/) - 模板与工具

i18n/zh/documents/04-资源/README.md

@@ -0,0 +1,30 @@
+# 📦 资源
+
+> 模板、工具、外部资源与避坑指南
+
+## 🗂️ 模板与工具
+
+| 资源 | 说明 |
+|:---|:---|
+| [通用项目架构模板](./通用项目架构模板.md) | 多种项目类型的标准目录结构 |
+| [代码组织](./代码组织.md) | 代码组织最佳实践 |
+| [工具集](./工具集.md) | 常用开发工具 |
+| [memory-bank-template](./memory-bank-template/) | 记忆库模板 |
+
+## 📚 学习资源
+
+| 资源 | 说明 |
+|:---|:---|
+| [编程书籍推荐](./编程书籍推荐.md) | 精选编程书籍 |
+| [外部资源聚合](./外部资源聚合.md) | AI 工具、社区、GitHub 仓库汇总 |
+
+## 🕳️ 避坑指南
+
+| 资源 | 说明 |
+|:---|:---|
+| [常见坑汇总](./常见坑汇总.md) | Vibe Coding 常见问题与解决方案 |
+
+## 🔗 相关资源
+- [入门指南](../01-入门指南/) - 环境配置
+- [方法论](../02-方法论/) - 理论基础
+- [实战](../03-实战/) - 动手实践

i18n/zh/documents/README.md

@@ -1,123 +1,35 @@
-# 📖 文档库 (Documents)
+# 📚 文档库
 
-`i18n/zh/documents/` 目录汇总项目的流程文档、架构说明、开发经验与最佳实践，是理解方法论与协作规则的首选入口。
+> Vibe Coding 知识体系，按学习路径组织
 
-## 目录结构
+## 🗺️ 目录结构
 
 ```
-i18n/zh/documents/
-├── README.md
-│
-├── 从零开始vibecoding/          # 🚀 新手入门必读
-│   ├── 00-Vibe Coding 哲学原理.md
-│   ├── 01-网络环境配置.md
-│   ├── 02-开发环境搭建.md
-│   └── 03-IDE配置.md
-│
-├── 胶水编程/                    # 🧬 Glue Coding 革命性范式
-│   └── README.md
-│
-├── 方法论与原则/
-│   ├── A Formalization of Recursive Self-Optimizing Generative Systems.md
-│   ├── gluecoding.md
-│   ├── vibe-coding-经验收集.md
-│   ├── 学习经验.md
-│   ├── 开发经验.md
-│   ├── 编程之道.md
-│   └── 系统提示词构建原则.md
-│
-├── 教程与指南/
-│   ├── auggie-mcp配置文档.md
-│   ├── LazyVim快捷键大全.md
-│   ├── tmux快捷键大全.md
-│   └── 关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md
-│
-├── 模板与资源/
-│   ├── 代码组织.md
-│   ├── 工具集.md
-│   ├── 编程书籍推荐.md
-│   ├── 通用项目架构模板.md
-│   └── memory-bank-template/
-│
-├── 外部资源聚合/                # 🔗 外部链接汇总
-│   ├── AI工具与平台/
-│   ├── GitHub精选仓库/
-│   ├── 提示词资源/
-│   ├── 开发工具/
-│   ├── 教程与课程/
-│   └── 社区与论坛/
-│
-└── 项目实战经验/                # 📁 实战案例
-    ├── fate-engine-dev/
-    ├── polymarket-dev/
-    ├── telegram-dev/
-    └── ...
+documents/
+├── 01-入门指南/    # 从零开始，环境配置，工具教程
+├── 02-方法论/      # 核心理念，胶水编程，开发经验
+├── 03-实战/        # 教学案例，项目实战经验
+└── 04-资源/        # 模板，工具，外部资源，避坑指南
 ```
 
-## 文档分类
+## 🚀 快速导航
 
-### 🚀 从零开始vibecoding（新手入门）
+| 目录 | 说明 | 适合人群 |
+|:---|:---|:---|
+| [01-入门指南](./01-入门指南/) | 环境配置、工具使用 | 新手入门 |
+| [02-方法论](./02-方法论/) | 胶水编程、开发原则 | 理解理念 |
+| [03-实战](./03-实战/) | 案例教程、项目经验 | 动手实践 |
+| [04-资源](./04-资源/) | 模板、工具、外部链接 | 查阅参考 |
 
-完全零基础？从这里开始！
+## 📖 推荐学习路径
 
-*   [00-Vibe Coding 哲学原理](./从零开始vibecoding/00-Vibe%20Coding%20哲学原理.md) - 核心理念
-*   [01-网络环境配置](./从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
-*   [02-开发环境搭建](./从零开始vibecoding/02-开发环境搭建.md) - 搭建开发环境（提示词版）
-*   [03-IDE配置](./从零开始vibecoding/03-IDE配置.md) - 配置 VS Code / Cursor / Windsurf
+1. **入门** → [Vibe Coding 哲学原理](./01-入门指南/00-Vibe%20Coding%20哲学原理.md)
+2. **配置** → [开发环境搭建](./01-入门指南/02-开发环境搭建.md)
+3. **理解** → [胶水编程概述](./02-方法论/胶水编程-概述.md)
+4. **实践** → [Todo App 案例](./03-实战/01-todo-app.md)
+5. **进阶** → [项目实战经验](./03-实战/)
 
-### 🧬 胶水编程 (Glue Coding)
+## 🔗 相关资源
 
-**软件工程的圣杯与银弹。** 彻底解决 Vibe Coding 的幻觉、复杂性和门槛问题。
-
-*   [胶水编程介绍](./胶水编程/README.md) - 革命性编程范式
-
-### 方法论与原则
-
-关于编程思想、开发哲学和项目核心原则的文档。
-
-*   `A Formalization of Recursive Self-Optimizing Generative Systems.md` - 递归自优化系统形式化
-*   `gluecoding.md` - 胶水编程理论
-*   `vibe-coding-经验收集.md` - 经验汇总
-*   `学习经验.md` - 学习心得
-*   `开发经验.md` - 开发实践
-*   `编程之道.md` - 编程哲学
-*   `系统提示词构建原则.md` - 提示词工程
-
-### 教程与指南
-
-具体工具的配置、使用指南和操作教程。
-
-*   `auggie-mcp配置文档.md` - Augment MCP 配置
-*   `LazyVim快捷键大全.md` - LazyVim 快捷键
-*   `tmux快捷键大全.md` - tmux 快捷键
-*   `关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md` - 远程开发
-
-### 模板与资源
-
-可复用的项目模板、代码结构规范和资源列表。
-
-*   `代码组织.md` - 代码组织规范
-*   `工具集.md` - 工具推荐
-*   `编程书籍推荐.md` - 书籍推荐
-*   `通用项目架构模板.md` - 项目模板
-*   `memory-bank-template/` - Memory Bank 模板
-
-### 🔗 外部资源聚合
-
-外部优质资源汇总，持续更新。
-
-*   [外部资源聚合](./外部资源聚合/README.md) - 总索引
-
-### 📁 项目实战经验
-
-实际项目开发中的经验总结和案例。
-
-*   [项目实战经验](./项目实战经验/README.md) - 总索引
-*   `fate-engine-dev/` - 命理引擎开发
-*   `polymarket-dev/` - Polymarket 数据分析
-*   `telegram-dev/` - Telegram Bot 开发
-
-## 相关资源
-
-- [提示词库](../prompts/) - AI 提示词集合
-- [技能库](../skills/) - AI Skills 技能
+- [提示词库](../prompts/) - AI 提示词资产
+- [技能库](../skills/) - 模块化技能集

i18n/zh/documents/从零开始vibecoding/README.md

@@ -1,29 +0,0 @@
-# 🚀 从零开始 Vibe Coding
-
-> 完全零基础？按顺序完成以下步骤，即可开始 AI 编程之旅。
-
----
-
-## 学习路径
-
-| 序号 | 文档 | 说明 |
-|:---:|:---|:---|
-| 00 | [哲学原理](./00-Vibe%20Coding%20哲学原理.md) | 理解 Vibe Coding 的核心理念 |
-| 01 | [网络环境配置](./01-网络环境配置.md) | 配置网络，确保能访问 GitHub、Google 等服务 |
-| 02 | [开发环境搭建](./02-开发环境搭建.md) | 复制提示词给 AI，让 AI 指导你安装开发工具 |
-| 03 | [IDE配置](./03-IDE配置.md) | 配置 VS Code 编辑器 |
-
----
-
-## 使用方法
-
-1. 按顺序阅读每个文档
-2. 文档中的提示词可以直接复制到 AI 对话框（ChatGPT、Claude、Gemini 网页版）
-3. AI 会一步步指导你完成配置
-4. 遇到问题直接问 AI
-
----
-
-## 完成后
-
-全部配置完成后，阅读 [主文档](../../../../README.md) 了解 Vibe Coding 工作流。

i18n/zh/documents/实战案例/README.md

@@ -1,103 +0,0 @@
-# 🎬 实战案例
-
-> 从 0 到 1 的完整 Vibe Coding 项目案例
-
----
-
-## 案例列表
-
-| 案例 | 难度 | 技术栈 | 耗时 | 状态 |
-|:---|:---|:---|:---|:---|
-| [Todo App](./01-todo-app.md) | ⭐ 入门 | HTML/CSS/JS | 30 分钟 | ✅ 完成 |
-| [个人博客](./02-blog-system.md) | ⭐⭐ 中等 | Next.js/MDX | 2-4 小时 | ✅ 完成 |
-| [AI 聊天机器人](./03-chatbot.md) | ⭐⭐ 中等 | Python/FastAPI | 1-2 小时 | ✅ 完成 |
-| [命令行工具](./04-cli-tool.md) | ⭐⭐ 中等 | Python/Click | 1-2 小时 | ✅ 完成 |
-| [Chrome 扩展](./05-chrome-extension.md) | ⭐⭐ 中等 | JS/Chrome API | 2-3 小时 | ✅ 完成 |
-
----
-
-## 快速开始
-
-每个案例都包含：
-1. **开始前的提示词** - 直接复制给 AI
-2. **项目结构** - 清晰的目录规划
-3. **核心代码** - 关键实现片段
-4. **验收清单** - 确保功能完整
-5. **进阶挑战** - 继续提升
-
-### 使用方式
-
-1. 选择一个感兴趣的案例
-2. 复制「第一步」的提示词给 AI
-3. 跟着 AI 的指导一步步完成
-4. 对照验收清单检查功能
-
----
-
-## 案例详情
-
-### ⭐ 入门级
-
-#### [Todo App](./01-todo-app.md)
-最简单的入门项目，30 分钟完成一个待办事项应用。
-- 技术栈：纯 HTML/CSS/JavaScript
-- 学习重点：DOM 操作、本地存储
-
-### ⭐⭐ 中等级
-
-#### [个人博客](./02-blog-system.md)
-构建一个支持 Markdown 的个人博客系统。
-- 技术栈：Next.js + MDX + Tailwind CSS
-- 学习重点：静态生成、文件系统路由
-
-#### [AI 聊天机器人](./03-chatbot.md)
-接入 AI API 的聊天机器人。
-- 技术栈：Python + FastAPI + OpenAI API
-- 学习重点：API 调用、流式响应
-
-#### [命令行工具](./04-cli-tool.md)
-实用的文件批量重命名工具。
-- 技术栈：Python + Click + Rich
-- 学习重点：CLI 开发、文件操作
-
-#### [Chrome 扩展](./05-chrome-extension.md)
-网页笔记助手浏览器扩展。
-- 技术栈：JavaScript + Chrome API
-- 学习重点：扩展开发、本地存储
-
----
-
-## 贡献案例
-
-欢迎提交你的 Vibe Coding 实战案例！
-
-### 格式要求
-
-```markdown
-# 实战案例：项目名称
-
-> 难度：⭐⭐ | 预计时间：X 小时 | 技术栈：XXX
-
-## 🎯 项目目标
-## 📋 开始前的准备
-## 🏗️ 项目结构
-## 🔧 核心代码
-## 🚀 部署/使用
-## ✅ 验收清单
-## 💡 进阶挑战
-```
-
-### 提交方式
-
-1. Fork 本仓库
-2. 在 `i18n/zh/documents/实战案例/` 添加案例文件
-3. 更新本 README 的案例列表
-4. 提交 Pull Request
-
----
-
-## 相关资源
-
-- [从零开始 Vibe Coding](../从零开始vibecoding/)
-- [常见坑汇总](../常见坑汇总/)
-- [提示词库](../../prompts/)

i18n/zh/documents/项目实战经验/README.md

@@ -1,26 +0,0 @@
-# 📁 项目实战经验
-
-> Vibe Coding 实战中积累的经验、踩坑记录和可复用的提示词
-
----
-
-## 📂 目录索引
-
-| 目录 | 说明 | 状态 |
-|:---|:---|:---:|
-| [fate-engine-dev](./fate-engine-dev/) | 命理引擎开发 - 八字计算、真太阳时修正 | ✅ |
-| [polymarket-dev](./polymarket-dev/) | Polymarket 数据分析 - K线可视化、胶水开发 | ✅ |
-| [telegram-dev](./telegram-dev/) | Telegram Bot 开发 - Markdown 格式处理 | ✅ |
-| [web-app](./web-app/) | 全栈 Web 应用案例 | 🚧 |
-| [cli-tool](./cli-tool/) | CLI 工具开发案例 | 🚧 |
-| [bot-automation](./bot-automation/) | 自动化机器人案例 | 🚧 |
-| [data-pipeline](./data-pipeline/) | 数据处理管道案例 | 🚧 |
-| [game-dev](./game-dev/) | 游戏开发案例 | 🚧 |
-
----
-
-## 📝 如何贡献
-
-欢迎提交你的实战经验！格式建议：
-- 文件名：`项目名_问题描述_日期.md` 或 `功能名-prompt.md`
-- 内容包含：背景、问题、解决方案、可复用的提示词