refactor: 调整文档目录结构和链接
This commit is contained in:
tukuaiai
parent
36690d502d
commit
792e27e83a
40
README.md
40
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 # 本地/远端快照脚本
|
||||
```
|
||||
|
|
|
|||
|
|
@ -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-实战/) - 动手实践
|
||||
|
|
@ -1,5 +1,7 @@
|
|||
# 🧭 编程之道
|
||||
|
||||
> 绝利一源，用师十倍。三返昼夜，用师万倍。
|
||||
|
||||
一份关于编程本质、抽象、原则、哲学的高度浓缩稿
|
||||
它不是教程，而是“道”：思想的结构
|
||||
|
||||
|
|
@ -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 能力不断增强，未来的开发者不再需要自己写大量代码，而是：
|
||||
|
||||
* 找轮子
|
||||
* 组合轮子
|
||||
* 智能连接组件
|
||||
* 以极低成本构建复杂系统
|
||||
|
||||
胶水编程将会成为新的软件生产力标准
|
||||
|
|
@ -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-实战/) - 动手实践项目
|
||||
|
|
|
|||
|
|
@ -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) - 编程哲学
|
||||
|
||||
## 🛠️ 实践原则
|
||||
|
||||
### 开发经验
|
||||
- [开发经验](./开发经验.md) - 变量命名、文件结构、编码规范
|
||||
- [学习经验](./学习经验.md) - 学习方法与技巧
|
||||
- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
|
||||
|
||||
### 提示词工程
|
||||
- [系统提示词构建原则](./系统提示词构建原则.md) - 构建高效 AI 系统提示词
|
||||
|
||||
### 工具配置
|
||||
- [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) - 变量命名、文件结构、编码规范
|
||||
- [Vibe Coding 经验收集](./vibe-coding-经验收集.md) - 社区经验汇总
|
||||
|
||||
## 🔗 相关资源
|
||||
- [基础指南](../00-基础指南/) - 核心理念与方法论
|
||||
- [入门指南](../01-入门指南/) - 从零开始
|
||||
- [实战](../03-实战/) - 动手实践
|
||||
|
|
|
|||
|
|
@ -1,5 +0,0 @@
|
|||
让我印象最深刻的几段文本
|
||||
|
||||
黄帝阴符经： 绝利一源，用师十倍。三返昼夜，用师万倍
|
||||
|
||||
抖音曰：人者，利之所驱也；大利大为，小利小为，无利不为
|
||||
|
|
@ -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 能力不断增强，未来的开发者不再需要自己写大量代码，而是：
|
||||
|
||||
* 找轮子
|
||||
* 组合轮子
|
||||
* 智能连接组件
|
||||
* 以极低成本构建复杂系统
|
||||
|
||||
胶水编程将会成为新的软件生产力标准
|
||||
|
|
@ -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) →
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# 实战案例：从零到一构建博客系统
|
||||
|
||||
> 本案例将指导您如何使用 Vibe Coding 方法论，与 AI 协作从零开始构建一个功能完善的博客系统。
|
||||
|
||||
* **技术栈**: [待定，例如：Next.js, Tailwind CSS, Markdown, Vercel]
|
||||
* **难度**: 中级
|
||||
* **预计用时**: 8-12 小时
|
||||
|
||||
---
|
||||
|
||||
*(内容待填充...)*
|
||||
|
|
@ -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) →
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# 实战案例：开发一个高效的命令行工具 (CLI)
|
||||
|
||||
> 本案例将指导您如何与 AI 协作，构思、设计并实现一个实用的命令行工具，例如一个文件处理器或信息查询工具。
|
||||
|
||||
* **技术栈**: [待定，例如：Python (Typer/Click), Go (Cobra)]
|
||||
* **难度**: 初级到中级
|
||||
* **预计用时**: 4-6 小时
|
||||
|
||||
---
|
||||
|
||||
*(内容待填充...)*
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
# 实战案例：制作一个浏览器扩展程序
|
||||
|
||||
> 本案例将指导您如何与 AI 协作，开发一个简单的 Chrome 浏览器扩展，例如页面截图、内容聚合或自定义脚本注入工具。
|
||||
|
||||
* **技术栈**: [JavaScript, HTML, CSS, Manifest V3]
|
||||
* **难度**: 中级
|
||||
* **预计用时**: 6-10 小时
|
||||
|
||||
---
|
||||
|
||||
*(内容待填充...)*
|
||||
|
|
@ -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-资源/) - 模板与工具
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
@ -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. **强制规范**：禁止再引入任何“自写替代算法”用于核心判定（身强弱、用神、神煞、格局等）；必须直接调用外部原生库的计算结果，违者视为生产红线。
|
||||
|
|
@ -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 行
|
||||
|
|
@ -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`。
|
||||
|
|
@ -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-实战/) - 动手实践
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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-实战/)
|
||||
|
||||
## 🔗 相关资源
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue