refactor: 重组文档目录结构

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

更新各目录 README 和根 README 链接
This commit is contained in:
tukuaiai 2025-12-19 00:23:34 +08:00
parent 5a54f7460a
commit 36690d502d
59 changed files with 146 additions and 274 deletions

View File

@ -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>

View File

@ -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-实战/) - 动手实践项目

View File

@ -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-实战/) - 动手实践

View File

@ -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-资源/) - 模板与工具

View File

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

View File

@ -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/) - 模块化技能集

View File

@ -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 工作流。

View File

@ -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/)

View File

@ -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`
- 内容包含:背景、问题、解决方案、可复用的提示词