refactor: 调整文档目录结构和链接

README.md

@@ -68,7 +68,7 @@
   <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/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-资源/README.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>
@@ -128,10 +128,10 @@
 
 完全新手？按顺序完成以下步骤：
 
-0. [00-Vibe Coding 哲学原理](./i18n/zh/documents/从零开始vibecoding/00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
-1. [01-网络环境配置](./i18n/zh/documents/从零开始vibecoding/01-网络环境配置.md) - 配置网络访问
-2. [02-开发环境搭建](./i18n/zh/documents/从零开始vibecoding/02-开发环境搭建.md) - 复制提示词给 AI，让 AI 指导你搭建环境
-3. [03-IDE配置](./i18n/zh/documents/从零开始vibecoding/03-IDE配置.md) - 配置 VS Code 编辑器
+0. [00-Vibe Coding 哲学原理](./i18n/zh/documents/01-入门指南/00-Vibe%20Coding%20哲学原理.md) - 理解核心理念
+1. [01-网络环境配置](./i18n/zh/documents/01-入门指南/01-网络环境配置.md) - 配置网络访问
+2. [02-开发环境搭建](./i18n/zh/documents/01-入门指南/02-开发环境搭建.md) - 复制提示词给 AI，让 AI 指导你搭建环境
+3. [03-IDE配置](./i18n/zh/documents/01-入门指南/03-IDE配置.md) - 配置 VS Code 编辑器
 
 ---
 
@@ -150,7 +150,7 @@
 
 **核心理念**：能抄不写，能连不造，能复用不原创。
 
-👉 [深入了解胶水编程](./i18n/zh/documents/胶水编程/README.md)
+👉 [深入了解胶水编程](./i18n/zh/documents/00-基础指南/胶水编程.md)
 
 </details>
 
@@ -170,7 +170,7 @@
 
 该思想的核心是构建一个能够**自我优化**的 AI 系统。其递归本质可分解为以下步骤：
 
-> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./i18n/zh/documents/方法论与原则/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
+> 延伸阅读：[A Formalization of Recursive Self-Optimizing Generative Systems](./i18n/zh/documents/00-基础指南/A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md)
 
 #### 1. 定义核心角色：
 
@@ -285,11 +285,11 @@
 *   [**第三方系统提示词学习库**](https://github.com/x1xhlol/system-prompts-and-models-of-ai-tools): 用于学习和参考其他 AI 工具的系统提示词。
 *   [**Skills 制作器**](https://github.com/yusufkaraaslan/Skill_Seekers): 可根据需求生成定制化 Skills 的工具。
 *   [**元提示词**](https://docs.google.com/spreadsheets/d/1ngoQOhJqdguwNAilCl1joNwTje7FWWN9WiI2bo5VhpU/edit?gid=1770874220#gid=1770874220): 用于生成提示词的高级提示词。
-*   [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
+*   [**通用项目架构模板**](./i18n/zh/documents/04-资源/通用项目架构模板.md): 可用于快速搭建标准化的项目目录结构。
 *   [**元技能：Skills 的 Skills**](./i18n/zh/skills/claude-skills/SKILL.md): 用于生成 Skills 的元技能。
-*   [**tmux快捷键大全**](./i18n/zh/documents/教程与指南/tmux快捷键大全.md): tmux 的快捷键参考文档。
-*   [**LazyVim快捷键大全**](./i18n/zh/documents/教程与指南/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
-*   [**手机远程 Vibe Coding**](./i18n/zh/documents/教程与指南/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
+*   [**tmux快捷键大全**](./i18n/zh/documents/02-方法论/tmux快捷键大全.md): tmux 的快捷键参考文档。
+*   [**LazyVim快捷键大全**](./i18n/zh/documents/02-方法论/LazyVim快捷键大全.md): LazyVim 的快捷键参考文档。
+*   [**手机远程 Vibe Coding**](./i18n/zh/documents/02-方法论/关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md): 基于 frp 实现手机 SSH 远程控制本地电脑进行 Vibe Coding。
 
 ### 外部教程与资源
 
@@ -303,14 +303,14 @@
 
 ### 项目内部文档
 
-*   [**胶水编程 (Glue Coding)**](./i18n/zh/documents/胶水编程/): 软件工程的圣杯与银弹，Vibe Coding 的终极进化形态。
+*   [**胶水编程 (Glue Coding)**](./i18n/zh/documents/00-基础指南/): 软件工程的圣杯与银弹，Vibe Coding 的终极进化形态。
 *   [**Chat Vault**](./libs/external/chat-vault/): AI 聊天记录保存工具，支持 Codex/Kiro/Gemini/Claude CLI。
 *   [**prompts-library 工具说明**](./libs/external/prompts-library/): 支持 Excel 与 Markdown 格式互转，包含数百个精选提示词。
 *   [**coding_prompts 集合**](./i18n/zh/prompts/coding_prompts/): 适用于 Vibe Coding 流程的专用提示词。
-*   [**系统提示词构建原则**](./i18n/zh/documents/方法论与原则/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
-*   [**开发经验总结**](./i18n/zh/documents/方法论与原则/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
-*   [**通用项目架构模板**](./i18n/zh/documents/模板与资源/通用项目架构模板.md): 多种项目类型的标准目录结构。
-*   [**Augment MCP 配置文档**](./i18n/zh/documents/教程与指南/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
+*   [**系统提示词构建原则**](./i18n/zh/documents/00-基础指南/系统提示词构建原则.md): 构建高效 AI 系统提示词的综合指南。
+*   [**开发经验总结**](./i18n/zh/documents/00-基础指南/开发经验.md): 变量命名、文件结构、编码规范、架构原则等。
+*   [**通用项目架构模板**](./i18n/zh/documents/04-资源/通用项目架构模板.md): 多种项目类型的标准目录结构。
+*   [**Augment MCP 配置文档**](./i18n/zh/documents/02-方法论/auggie-mcp配置文档.md): Augment 上下文引擎配置说明。
 *   [**system_prompts 集合**](./i18n/zh/prompts/system_prompts/): AI 开发的系统提示词，含多版本开发规范。
 *   [**外部资源聚合**](./i18n/zh/documents/外部资源聚合/): GitHub 精选仓库、AI 工具平台、提示词资源、优质博主汇总。
 
@@ -353,9 +353,9 @@
 ├── CLAUDE.md                    # AI 助手的核心行为准则或配置。
 │
 ├── i18n/zh/documents/           # 存放各类说明文档、经验总结和配置详细说明。
-│   ├── 方法论与原则/                # 方法论与原则
-│   ├── 模板与资源/                  # 模板与资源
-│   └── 教程与指南/                  # 教程与指南
+│   ├── 00-基础指南/                # 方法论与原则
+│   ├── 04-资源/                  # 模板与资源
+│   └── 02-方法论/                  # 教程与指南
 │
 ├── libs/                        # 通用库代码，用于项目内部模块化。
 │   ├── common/                  # 通用功能模块。
@@ -420,7 +420,7 @@ i18n/zh/prompts/
   assistant_prompts/     # 辅助/配合型提示
   user_prompts/          # 可复用的用户侧提示词
 i18n/zh/documents/
-  模板与资源/代码组织.md, 模板与资源/通用项目架构模板.md, 方法论与原则/开发经验.md, 方法论与原则/系统提示词构建原则.md 等知识库
+  04-资源/代码组织.md, 04-资源/通用项目架构模板.md, 00-基础指南/开发经验.md, 00-基础指南/系统提示词构建原则.md 等知识库
 backups/
   一键备份.sh, 快速备份.py  # 本地/远端快照脚本
 ```

i18n/zh/documents/00-基础指南/README.md

@@ -0,0 +1,22 @@
+# 🧭 基础指南
+
+> Vibe Coding 的核心理念、原则与方法论
+
+## 📖 核心方法论
+
+### 胶水编程 (Glue Coding)
+- [胶水编程](./胶水编程.md) - 软件工程的圣杯与银弹
+- [语言层要素](./语言层要素.md) - 看懂 100% 代码的 8 个层级
+- [Glue Coding (EN)](./gluecoding.md) - English version
+
+### 理论基础
+- [递归自优化系统形式化](./A%20Formalization%20of%20Recursive%20Self-Optimizing%20Generative%20Systems.md) - 元方法论
+- [编程之道](./编程之道.md) - 编程哲学
+
+### 提示词工程
+- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词
+
+## 🔗 相关资源
+- [入门指南](../01-入门指南/) - 从零开始
+- [方法论](../02-方法论/) - 工具与经验
+- [实战](../03-实战/) - 动手实践

i18n/zh/documents/02-方法论/编程之道.md → i18n/zh/documents/00-基础指南/编程之道.md

@@ -1,5 +1,7 @@
 # 🧭 编程之道
 
+> 绝利一源，用师十倍。三返昼夜，用师万倍。
+
 一份关于编程本质、抽象、原则、哲学的高度浓缩稿
 它不是教程，而是“道”：思想的结构
 

i18n/zh/documents/02-方法论/胶水编程-概述.md → i18n/zh/documents/00-基础指南/胶水编程.md

@@ -171,3 +171,165 @@ AI 不再需要"发明"任何东西。它只需要：
 ---
 
 *"The best code is no code at all. The second best is glue code."*
+
+# 胶水编程（glue coding）方法论
+
+## **1. 胶水编程的定义**
+
+**胶水编程（glue coding）**是一种新型的软件构建方式，其核心理念是：
+
+> **几乎完全复用成熟开源组件，通过最小量的“胶水代码”将它们组合成完整系统**
+
+它强调的是“连接”而不是“创造”，在 AI 时代尤其高效
+
+## **2. 产生背景**
+
+传统软件工程往往需要开发者：
+
+* 设计架构
+* 自己编写逻辑
+* 手动处理各种细节
+* 重复造轮子
+
+这导致开发成本高、周期长、成功率低
+
+而当下的生态已经发生根本变化：
+
+* GitHub 上成熟的开源库成千上万
+* 框架覆盖各种场景（Web、AI、分布式、模型推理…）
+* GPT / Grok 能帮助搜索、分析、组合这些项目
+
+在这种环境中，再从零写代码已经不是最高效的方式
+
+于是，“胶水编程”成为一种新范式
+
+## **3. 胶水编程的核心原则**
+
+### **3.1 凡是能不写的就不写，凡是能少写的就少写**
+
+任何已有成熟实现的功能，都不应该重新造轮子
+
+### **3.2 凡是能 CV 就 CV**
+
+直接复制使用经过社区检验的代码，属于正常工程流程，而非偷懒
+
+### **3.3 站在巨人的肩膀上，而不是试图成为巨人**
+
+利用现成框架，而不是试图自己再写一个“更好的轮子”
+
+### **3.4 不修改原仓库代码**
+
+所有开源库应尽量保持不可变，作为黑盒使用
+
+### **3.5 自定义代码越少越好**
+
+你写的代码只承担：
+
+* 组合
+* 调用
+* 封装
+* 适配
+
+也就是所谓的**胶水层**
+
+## **4. 胶水编程的标准流程**
+
+### **4.1 明确需求**
+
+把系统要实现的功能拆成一个个需求点
+
+### **4.2 使用 GPT/Grok 拆解需求**
+
+让 AI 将需求细化为可复用模块、能力点和对应的子任务
+
+### **4.3 搜索现成的开源实现**
+
+利用 GPT 的联网能力（如 Grok）：
+
+* 根据每个子需求搜索对应的 GitHub 仓库
+* 检查是否存在可复用组件
+* 对比质量、实现方式、许可证等
+
+### **4.4 下载并整理仓库**
+
+将选定的仓库拉取到本地，分类整理
+
+### **4.5 按架构体系进行组织**
+
+把这些仓库放置到项目结构中，例如：
+
+```
+/services  
+/libs  
+/third_party  
+/glue  
+```
+
+并强调：**开源仓库作为第三方依赖，绝对不可修改。**
+
+### **4.6 编写胶水层代码**
+
+胶水代码的作用包括：
+
+* 封装接口
+* 统一输入输出
+* 连接不同组件
+* 实现最小业务逻辑
+
+最终系统通过多个成熟模块组合而成
+
+## **5. 胶水编程的价值**
+
+### **5.1 极高的成功率**
+
+因为使用的是社区验证过的成熟代码
+
+### **5.2 开发速度极快**
+
+大量功能可以直接复用
+
+### **5.3 降低成本**
+
+时间成本、维护成本、学习成本都大幅减少
+
+### **5.4 系统更稳定**
+
+依赖成熟框架而非个人实现
+
+### **5.5 易于扩展**
+
+通过替换组件就能轻松升级能力
+
+### **5.6 与 AI 强配**
+
+GPT 能辅助搜索、拆解、整合，是胶水工程的天然增强器
+## **6. 胶水编程 vs 传统开发**
+
+| 项目     | 传统开发  | 胶水编程   |
+| ------ | ----- | ------ |
+| 功能实现方式 | 自己写   | 复用开源   |
+| 工作量    | 大     | 小得多    |
+| 成功率    | 不确定   | 高      |
+| 速度     | 慢     | 极快     |
+| 错误率    | 容易踩坑  | 使用成熟方案 |
+| 重点     | “造轮子” | “组合轮子” |
+
+## **7. 胶水编程的典型应用场景**
+
+* 快速原型开发
+* 小团队构建大系统
+* AI 应用/模型推理平台
+* 数据处理流水线
+* 内部工具开发
+* 系统集成（System Integration）
+
+## **8. 未来：胶水工程将成为新的主流编程方式**
+
+随着 AI 能力不断增强，未来的开发者不再需要自己写大量代码，而是：
+
+* 找轮子
+* 组合轮子
+* 智能连接组件
+* 以极低成本构建复杂系统
+
+胶水编程将会成为新的软件生产力标准

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

@@ -1,21 +1,15 @@
 # 🚀 入门指南
 
-> 从零开始学习 Vibe Coding，配置环境，掌握工具
+> 从零开始学习 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 方法论
+- [基础指南](../00-基础指南/) - 核心理念与方法论
+- [方法论](../02-方法论/) - 工具与经验
 - [实战](../03-实战/) - 动手实践项目

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

@@ -1,32 +1,21 @@
-# 🧭 方法论
+# 🛠️ 方法论
 
-> 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) - 编程哲学
+- [tmux 快捷键大全](./tmux快捷键大全.md) - 终端复用工具
+- [LazyVim 快捷键大全](./LazyVim快捷键大全.md) - Neovim 配置框架
+- [Augment MCP 配置](./auggie-mcp配置文档.md) - 上下文引擎配置
+- [手机远程 Vibe Coding](./关于手机ssh任意位置链接本地计算机，基于frp实现的方法.md) - 基于 frp 的远程开发
+- [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置
 
-## 🛠️ 实践原则
+## 🛠️ 开发经验
 
-### 开发经验
 - [开发经验](./开发经验.md) - 变量命名、文件结构、编码规范
-- [学习经验](./学习经验.md) - 学习方法与技巧
 - [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
 
-### 提示词工程
-- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词
-
-### 工具配置
-- [GEMINI-HEADLESS](./GEMINI-HEADLESS.md) - Gemini 无头模式配置
-
 ## 🔗 相关资源
+- [基础指南](../00-基础指南/) - 核心理念与方法论
 - [入门指南](../01-入门指南/) - 从零开始
 - [实战](../03-实战/) - 动手实践

i18n/zh/documents/02-方法论/学习经验.md

@@ -1,5 +0,0 @@
-让我印象最深刻的几段文本
-
-黄帝阴符经： 绝利一源，用师十倍。三返昼夜，用师万倍
-
-抖音曰：人者，利之所驱也；大利大为，小利小为，无利不为

i18n/zh/documents/02-方法论/胶水编程.md

@@ -1,161 +0,0 @@
-# 胶水编程（glue coding）方法论
-
-## **1. 胶水编程的定义**
-
-**胶水编程（glue coding）**是一种新型的软件构建方式，其核心理念是：
-
-> **几乎完全复用成熟开源组件，通过最小量的“胶水代码”将它们组合成完整系统**
-
-它强调的是“连接”而不是“创造”，在 AI 时代尤其高效
-
-## **2. 产生背景**
-
-传统软件工程往往需要开发者：
-
-* 设计架构
-* 自己编写逻辑
-* 手动处理各种细节
-* 重复造轮子
-
-这导致开发成本高、周期长、成功率低
-
-而当下的生态已经发生根本变化：
-
-* GitHub 上成熟的开源库成千上万
-* 框架覆盖各种场景（Web、AI、分布式、模型推理…）
-* GPT / Grok 能帮助搜索、分析、组合这些项目
-
-在这种环境中，再从零写代码已经不是最高效的方式
-
-于是，“胶水编程”成为一种新范式
-
-## **3. 胶水编程的核心原则**
-
-### **3.1 凡是能不写的就不写，凡是能少写的就少写**
-
-任何已有成熟实现的功能，都不应该重新造轮子
-
-### **3.2 凡是能 CV 就 CV**
-
-直接复制使用经过社区检验的代码，属于正常工程流程，而非偷懒
-
-### **3.3 站在巨人的肩膀上，而不是试图成为巨人**
-
-利用现成框架，而不是试图自己再写一个“更好的轮子”
-
-### **3.4 不修改原仓库代码**
-
-所有开源库应尽量保持不可变，作为黑盒使用
-
-### **3.5 自定义代码越少越好**
-
-你写的代码只承担：
-
-* 组合
-* 调用
-* 封装
-* 适配
-
-也就是所谓的**胶水层**
-
-## **4. 胶水编程的标准流程**
-
-### **4.1 明确需求**
-
-把系统要实现的功能拆成一个个需求点
-
-### **4.2 使用 GPT/Grok 拆解需求**
-
-让 AI 将需求细化为可复用模块、能力点和对应的子任务
-
-### **4.3 搜索现成的开源实现**
-
-利用 GPT 的联网能力（如 Grok）：
-
-* 根据每个子需求搜索对应的 GitHub 仓库
-* 检查是否存在可复用组件
-* 对比质量、实现方式、许可证等
-
-### **4.4 下载并整理仓库**
-
-将选定的仓库拉取到本地，分类整理
-
-### **4.5 按架构体系进行组织**
-
-把这些仓库放置到项目结构中，例如：
-
-```
-/services  
-/libs  
-/third_party  
-/glue  
-```
-
-并强调：**开源仓库作为第三方依赖，绝对不可修改。**
-
-### **4.6 编写胶水层代码**
-
-胶水代码的作用包括：
-
-* 封装接口
-* 统一输入输出
-* 连接不同组件
-* 实现最小业务逻辑
-
-最终系统通过多个成熟模块组合而成
-
-## **5. 胶水编程的价值**
-
-### **5.1 极高的成功率**
-
-因为使用的是社区验证过的成熟代码
-
-### **5.2 开发速度极快**
-
-大量功能可以直接复用
-
-### **5.3 降低成本**
-
-时间成本、维护成本、学习成本都大幅减少
-
-### **5.4 系统更稳定**
-
-依赖成熟框架而非个人实现
-
-### **5.5 易于扩展**
-
-通过替换组件就能轻松升级能力
-
-### **5.6 与 AI 强配**
-
-GPT 能辅助搜索、拆解、整合，是胶水工程的天然增强器
-## **6. 胶水编程 vs 传统开发**
-
-| 项目     | 传统开发  | 胶水编程   |
-| ------ | ----- | ------ |
-| 功能实现方式 | 自己写   | 复用开源   |
-| 工作量    | 大     | 小得多    |
-| 成功率    | 不确定   | 高      |
-| 速度     | 慢     | 极快     |
-| 错误率    | 容易踩坑  | 使用成熟方案 |
-| 重点     | “造轮子” | “组合轮子” |
-
-## **7. 胶水编程的典型应用场景**
-
-* 快速原型开发
-* 小团队构建大系统
-* AI 应用/模型推理平台
-* 数据处理流水线
-* 内部工具开发
-* 系统集成（System Integration）
-
-## **8. 未来：胶水工程将成为新的主流编程方式**
-
-随着 AI 能力不断增强，未来的开发者不再需要自己写大量代码，而是：
-
-* 找轮子
-* 组合轮子
-* 智能连接组件
-* 以极低成本构建复杂系统
-
-胶水编程将会成为新的软件生产力标准

i18n/zh/documents/03-实战/01-todo-app.md

@@ -1,117 +0,0 @@
-# 🎯 实战案例：30 分钟做一个 Todo App
-
-> 难度：⭐ 入门 | 技术栈：HTML/CSS/JS | 耗时：30 分钟
-
----
-
-## 最终效果
-
-<!-- TODO: 添加 GIF 演示 -->
-一个简洁的待办事项应用，支持：
-- ✅ 添加任务
-- ✅ 完成/取消完成
-- ✅ 删除任务
-- ✅ 本地存储（刷新不丢失）
-
----
-
-## 第 1 步：启动对话
-
-复制以下提示词，粘贴到 [Claude](https://claude.ai/) 或 [ChatGPT](https://chatgpt.com/)：
-
-```
-你是一个专业的前端开发助手。我想用 Vibe Coding 的方式做一个 Todo App。
-
-项目要求：
-- 纯 HTML/CSS/JS，不用任何框架
-- 单文件实现（一个 index.html）
-- 功能：添加任务、完成任务、删除任务
-- 数据存到 localStorage，刷新不丢失
-- 界面简洁美观，有动画效果
-
-请直接给我完整代码，我复制到 index.html 就能运行。
-```
-
----
-
-## 第 2 步：获取代码
-
-AI 会给你一个完整的 `index.html` 文件，大约 150-200 行代码。
-
-**示例代码结构**：
-```html
-<!DOCTYPE html>
-<html>
-<head>
-    <title>Todo App</title>
-    <style>
-        /* 样式代码 */
-    </style>
-</head>
-<body>
-    <div class="container">
-        <h1>📝 我的待办</h1>
-        <input type="text" id="input" placeholder="添加新任务...">
-        <ul id="list"></ul>
-    </div>
-    <script>
-        // JS 代码
-    </script>
-</body>
-</html>
-```
-
----
-
-## 第 3 步：运行测试
-
-1. 新建文件 `index.html`
-2. 粘贴 AI 给的代码
-3. 双击打开，或用 VS Code Live Server
-
----
-
-## 第 4 步：迭代优化
-
-不满意？继续对话：
-
-```
-请帮我优化：
-1. 添加深色模式切换
-2. 任务支持拖拽排序
-3. 添加任务分类功能
-```
-
----
-
-## 踩坑记录
-
-| 问题 | 解决方案 |
-|:---|:---|
-| localStorage 报错 | 用浏览器打开，不要直接双击 file:// |
-| 样式不生效 | 检查 CSS 是否在 `<style>` 标签内 |
-| 刷新数据丢失 | 检查 localStorage.setItem 是否正确调用 |
-
----
-
-## 进阶挑战
-
-完成基础版后，尝试：
-
-1. **添加截止日期** - 支持设置 deadline
-2. **添加优先级** - 高/中/低三档
-3. **添加搜索** - 快速查找任务
-4. **PWA 化** - 可安装到桌面
-
----
-
-## 学到了什么
-
-- ✅ Vibe Coding 基本流程：描述需求 → 获取代码 → 运行测试 → 迭代优化
-- ✅ 单文件 Web 应用结构
-- ✅ localStorage 本地存储
-- ✅ 如何与 AI 迭代优化代码
-
----
-
-**下一个案例**：[个人博客](./02-blog.md) →

i18n/zh/documents/03-实战/02-blog-system.md

@@ -1,11 +0,0 @@
-# 实战案例：从零到一构建博客系统
-
-> 本案例将指导您如何使用 Vibe Coding 方法论，与 AI 协作从零开始构建一个功能完善的博客系统。
-
-*   **技术栈**: [待定，例如：Next.js, Tailwind CSS, Markdown, Vercel]
-*   **难度**: 中级
-*   **预计用时**: 8-12 小时
-
----
-
-*(内容待填充...)*

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

@@ -1,130 +0,0 @@
-# 🤖 实战案例：1 小时做一个 AI 聊天机器人
-
-> 难度：⭐⭐ 初级 | 技术栈：Python/FastAPI | 耗时：1 小时
-
----
-
-## 最终效果
-
-<!-- TODO: 添加 GIF 演示 -->
-一个简单的 AI 聊天机器人，支持：
-- ✅ Web 界面对话
-- ✅ 接入 OpenAI/Claude API
-- ✅ 流式输出（打字机效果）
-- ✅ 对话历史记录
-
----
-
-## 前置条件
-
-- Python 3.8+
-- OpenAI API Key（或其他 LLM API）
-
----
-
-## 第 1 步：启动对话
-
-复制以下提示词：
-
-```
-你是一个 Python 后端开发助手。我想用 Vibe Coding 的方式做一个 AI 聊天机器人。
-
-项目要求：
-- 后端：FastAPI
-- 前端：简单 HTML 页面（内嵌在 FastAPI 中）
-- 功能：用户输入问题，调用 OpenAI API 返回回答
-- 支持流式输出（SSE）
-- 界面简洁，类似 ChatGPT
-
-请给我：
-1. 项目结构
-2. requirements.txt
-3. 完整代码
-4. 运行命令
-
-我的 OpenAI API Key 会通过环境变量 OPENAI_API_KEY 传入。
-```
-
----
-
-## 第 2 步：创建项目
-
-AI 会给你类似这样的结构：
-
-```
-chatbot/
-├── main.py          # FastAPI 主程序
-├── requirements.txt # 依赖
-└── .env            # API Key（自己创建）
-```
-
-**requirements.txt**：
-```
-fastapi
-uvicorn
-openai
-python-dotenv
-sse-starlette
-```
-
----
-
-## 第 3 步：运行
-
-```bash
-# 安装依赖
-pip install -r requirements.txt
-
-# 设置 API Key
-export OPENAI_API_KEY="sk-xxx"
-
-# 启动服务
-uvicorn main:app --reload
-```
-
-打开 http://localhost:8000 即可使用。
-
----
-
-## 第 4 步：迭代优化
-
-```
-请帮我添加：
-1. 对话历史保存到文件
-2. 支持切换不同模型（GPT-4/GPT-3.5）
-3. 添加系统提示词设置
-4. 支持 Markdown 渲染
-```
-
----
-
-## 踩坑记录
-
-| 问题 | 解决方案 |
-|:---|:---|
-| API Key 无效 | 检查环境变量是否正确设置 |
-| 跨域错误 | FastAPI 添加 CORS 中间件 |
-| 流式输出不工作 | 检查 SSE 配置，前端用 EventSource |
-| 中文乱码 | 确保 response 设置 `charset=utf-8` |
-
----
-
-## 进阶挑战
-
-1. **添加 RAG** - 让机器人能读取本地文档
-2. **多轮对话** - 保持上下文记忆
-3. **部署上线** - 部署到 Vercel/Railway
-4. **接入微信** - 做成微信机器人
-
----
-
-## 学到了什么
-
-- ✅ FastAPI 基础用法
-- ✅ OpenAI API 调用
-- ✅ SSE 流式输出
-- ✅ 前后端一体化开发
-
----
-
-← [Todo App](./01-todo-app.md) | **下一个案例**：[全栈 SaaS](./04-saas.md) →

i18n/zh/documents/03-实战/04-cli-tool.md

@@ -1,11 +0,0 @@
-# 实战案例：开发一个高效的命令行工具 (CLI)
-
-> 本案例将指导您如何与 AI 协作，构思、设计并实现一个实用的命令行工具，例如一个文件处理器或信息查询工具。
-
-*   **技术栈**: [待定，例如：Python (Typer/Click), Go (Cobra)]
-*   **难度**: 初级到中级
-*   **预计用时**: 4-6 小时
-
----
-
-*(内容待填充...)*

i18n/zh/documents/03-实战/05-chrome-extension.md

@@ -1,11 +0,0 @@
-# 实战案例：制作一个浏览器扩展程序
-
-> 本案例将指导您如何与 AI 协作，开发一个简单的 Chrome 浏览器扩展，例如页面截图、内容聚合或自定义脚本注入工具。
-
-*   **技术栈**: [JavaScript, HTML, CSS, Manifest V3]
-*   **难度**: 中级
-*   **预计用时**: 6-10 小时
-
----
-
-*(内容待填充...)*

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

@@ -1,35 +1,17 @@
 # 🎯 实战
 
-> 从教学案例到真实项目，动手实践 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 应用开发 |
 
 ## 🔗 相关资源
+- [基础指南](../00-基础指南/) - 核心理念与方法论
 - [入门指南](../01-入门指南/) - 环境配置
-- [方法论](../02-方法论/) - 理论基础
+- [方法论](../02-方法论/) - 工具与经验
 - [资源](../04-资源/) - 模板与工具

i18n/zh/documents/03-实战/fate-engine-dev/README.md

@@ -1,21 +0,0 @@
-# 🔮 fate-engine-dev
-
-> 命理引擎开发实战经验
-
-## 项目背景
-
-基于八字命理的计算引擎，涉及天干地支、真太阳时、五行强弱等复杂逻辑。
-
-## 文档列表
-
-| 文件 | 说明 |
-|:---|:---|
-| [真太阳时修正经验.md](./真太阳时修正经验.md) | 真太阳时计算的坑和修正方案 |
-| [production_incident_2025-12-17_strong_weak.md](./production_incident_2025-12-17_strong_weak.md) | 生产事故记录：五行强弱计算问题 |
-| [telegram Markdown 代码块格式修复记录 2025-12-15.md](./telegram%20Markdown%20代码块格式修复记录%202025-12-15.md) | Telegram 输出格式问题修复 |
-
-## 技术栈
-
-- Python
-- 天文算法库
-- Telegram Bot API

i18n/zh/documents/03-实战/fate-engine-dev/production_incident_2025-12-17_strong_weak.md

@@ -1,16 +0,0 @@
-# 生产故障记录：身强/身弱判定口径冲突
-
-- **时间**：2025-12-17  
-- **影响**：用户报告同一份排盘出现“强弱判断：偏弱”与“身强判定：身强”矛盾，导致用神建议被误导，信任度下降。  
-- **根因**：代码同时输出两套强弱算法结果——
-  - 外部库 bazi-1 weak 判定（`_calc_wuxing_scores.weakStrong`，含长生/帝旺权重）。  
-  - 本地自写简化算法 `_calc_strength`（仅按三柱生克计数）。  
-  报告同时展示两者，口径不一致。  
-- **处置**：移除本地 `_calc_strength` 使用，统一以外部库 weak 判定为唯一来源；报告口径随之统一。  
-- **代码变更**：`services/telegram-service/src/bazi_calculator.py`  
-  - `strength` 仅取 `wx_scores['weakStrong']`；删除 `_calc_strength` 调用与实现。  
-- **后续动作**：  
-  1. 回归测试：随机 10 份排盘确认强弱口径唯一且与 bazi-1 原输出一致。  
-  2. 补充单测：验证无 `weakStrong` 时的异常提示（当前无回退）。  
-  3. 评审其他指标是否仍存在双口径输出（如用神、格局）。  
-  4. **强制规范**：禁止再引入任何“自写替代算法”用于核心判定（身强弱、用神、神煞、格局等）；必须直接调用外部原生库的计算结果，违者视为生产红线。  

i18n/zh/documents/03-实战/fate-engine-dev/telegram Markdown 代码块格式修复记录 2025-12-15.md

@@ -1,41 +0,0 @@
-#  telegram Markdown 代码块格式修复记录 2025-12-15
-
-## 问题
-
-排盘完成后发送消息报错：
-```
-❌ 排盘失败: Can't parse entities: can't find end of the entity starting at byte offset 168
-```
-
-## 原因
-
-`bot.py` 中 `header` 消息的 Markdown 代码块格式错误。
-
-原代码使用字符串拼接，在 ``` 后面加了 `\n`，导致 Telegram Markdown 解析器无法正确识别代码块边界：
-
-```python
-# 错误写法
-header = (
-    "```\n"
-    f"{filename}\n"
-    "```\n"
-)
-```
-
-## 修复
-
-改用三引号字符串，确保 ``` 单独成行：
-
-```python
-# 正确写法
-header = f"""报告见附件
-```
-{filename}
-{ai_filename}
-```
-"""
-```
-
-## 修改文件
-
-- `services/telegram-service/src/bot.py` 第 293-308 行

i18n/zh/documents/03-实战/fate-engine-dev/真太阳时修正经验.md

@@ -1,32 +0,0 @@
-# 真太阳时修正经验（2025-12-16）
-
-## 背景
-- 新疆用户反馈：报告中“阳历先减2小时，真太阳时再减2小时”，四柱/神煞与对照工具不一致。
-- 根因：出生时间先在调用方计算了一次真太阳时，然后 `BaziCalculator` 内部再次计算，形成“双重扣减”。
-
-## 现行策略（已上线）
-- **唯一修正点**：所有真太阳时只在 `BaziCalculator` 内部执行一次。
-- **时间基线**：入口出生时间一律视为北京时间（Asia/Shanghai），用 `ensure_cn` 赋予时区后再做真太阳时修正。
-- **计算时间**：核心与扩展模块全部基于 `calc_dt`（真太阳时或用户禁用时的原始北京时），保持一致性。
-- **展示时间**：UI/进度/日志/队列/Help 统一用北京时间；报告字段 `trueSolarTime` 展示经度修正后的时间。
-
-## 涉及改动（要点）
-- `utils/timezone.py`: `now_cn/ensure_cn/fmt_cn` 固定 Asia/Shanghai。
-- `bot.py`: 去掉外层 `calc_true_solar_time`；时间显示用 `fmt_cn(now_cn())`；队列时间戳用北京时间。
-- `main.py`: API 不再预先修正；`trueSolarTime` 取自 `BaziCalculator` 内部结果。
-- `bazi_calculator.py`: 新增 `use_true_solar_time`，统一 `calc_dt`；扩展模块/命卦/小运等改用 `calc_dt`；元数据时间用北京时间。
-- `liuyao.py`, `qimen.py`, `system_optimization.py`: 时间戳统一北京时间。
-- 文档：`AGENTS.md` 记录“时区统一 Asia/Shanghai”。
-
-## 抽象问题与防范
-1. **时区假设不一致**：Naive datetime 若按本地解析会漂移；统一假设“输入即北京时”，先补时区再计算。
-2. **重复校正**：真太阳时公式只允许出现一次；调用链上严禁二次修正。
-3. **基准混用**：展示用北京时，计算用真太阳时（单次修正）。若新增模块，必须复用 `calc_dt`，不得自算。
-
-## 验证建议
-- 用新疆样例（乌鲁木齐 87E，08:00）跑一次：阳历应保持 08:00，北京时显示 08:00，真太阳时约 05:4x，仅扣一次。
-- 比对“测测”等对照工具的四柱/神煞，应一致。
-
-## 后续准则
-- 如需对外提供 UTC/其他时区，先转为北京时，再按经度做真太阳时，仍然只修正一次。
-- 新增集成模块时，禁止各自重复计算真太阳时；统一接受 `calc_dt`。

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

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

i18n/zh/documents/04-资源/工具集.md

@@ -1,4 +1,4 @@
-ide与插件；vscode ，Windsurf（白嫖用），闪电说（输出用），Continue - open-source AI code agent，Local History，Partial Diff
+ide与插件；vscode ，Windsurf（白嫖用），Continue - open-source AI code agent，Local History，Partial Diff
 
 模型；codex，gemini，kimik2，grok
 

i18n/zh/documents/README.md

@@ -6,28 +6,30 @@
 
 ```
 documents/
-├── 01-入门指南/    # 从零开始，环境配置，工具教程
-├── 02-方法论/      # 核心理念，胶水编程，开发经验
-├── 03-实战/        # 教学案例，项目实战经验
-└── 04-资源/        # 模板，工具，外部资源，避坑指南
+├── 00-基础指南/    # 核心理念，胶水编程，方法论
+├── 01-入门指南/    # 从零开始，环境配置
+├── 02-方法论/      # 工具教程，开发经验
+├── 03-实战/        # 项目实战经验
+└── 04-资源/        # 模板，工具，外部资源
 ```
 
 ## 🚀 快速导航
 
 | 目录 | 说明 | 适合人群 |
 |:---|:---|:---|
-| [01-入门指南](./01-入门指南/) | 环境配置、工具使用 | 新手入门 |
-| [02-方法论](./02-方法论/) | 胶水编程、开发原则 | 理解理念 |
-| [03-实战](./03-实战/) | 案例教程、项目经验 | 动手实践 |
+| [00-基础指南](./00-基础指南/) | 胶水编程、核心理念 | 理解本质 |
+| [01-入门指南](./01-入门指南/) | 环境配置、从零开始 | 新手入门 |
+| [02-方法论](./02-方法论/) | 工具教程、开发经验 | 提升效率 |
+| [03-实战](./03-实战/) | 项目经验、案例复盘 | 动手实践 |
 | [04-资源](./04-资源/) | 模板、工具、外部链接 | 查阅参考 |
 
 ## 📖 推荐学习路径
 
-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-实战/)
+1. **理念** → [胶水编程](./00-基础指南/胶水编程.md)
+2. **入门** → [Vibe Coding 哲学原理](./01-入门指南/00-Vibe%20Coding%20哲学原理.md)
+3. **配置** → [开发环境搭建](./01-入门指南/02-开发环境搭建.md)
+4. **工具** → [tmux 快捷键](./02-方法论/tmux快捷键大全.md)
+5. **实践** → [项目实战经验](./03-实战/)
 
 ## 🔗 相关资源