docs: simplify beginner path and add codex troubleshooting prompt

This commit is contained in:
tukuaiai
2026-05-01 23:11:07 +08:00
parent d21aee8497
commit 688fefaa3e
3 changed files with 25 additions and 6 deletions
+1 -2
View File
@@ -100,8 +100,7 @@
1. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
2. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问
3. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境
4. [IDE配置](./assets/documents/guides/getting-started/IDE配置.md) - 配置 VS Code 编辑器
5. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线,使用 gpt-5.5 与仓库配置基线
4. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线,使用 gpt-5.5 与仓库配置基线
</details>
@@ -8,6 +8,29 @@ Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、
OpenCode CLI 保留为备选方案:当你暂时无法使用 OpenAI / Codex CLI,或只想接入免费模型时,再使用 [OpenCode-CLI配置](./OpenCode-CLI配置.md)。
## 遇到问题先这样问 AI
如果安装过程中报错,不要只复制最后一行错误。请把以下三部分一起发给 AI(可以用 ChatGPT / Claude / Gemini 网页版):
1. 你的系统:Windows 11 / WSL2 Ubuntu / Ubuntu / Debian / macOS。
2. 完整报错:从你执行的命令开始,到错误结束,全部复制。
3. 本文档全文:把本页从标题到末尾完整复制给 AI,让它基于本文档判断你卡在哪一步。
推荐提问模板:
```text
我正在按下面这份 Codex CLI 安装文档配置一台新电脑,但遇到了报错。
我的系统是:____
我执行的命令是:____
完整报错如下:
____
下面是我正在遵循的完整安装文档。请你判断我卡在哪一步,给出最小修复命令,并说明修复后如何验证。
[把本文档全文粘贴到这里]
```
## 总流程
```text
@@ -301,6 +324,4 @@ codex login
→ [开发环境搭建](./开发环境搭建.md) - 回看基础环境
→ [IDE 配置](./IDE配置.md) - 配置编辑器
→ [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案
@@ -8,8 +8,7 @@
1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环
2. [网络环境配置](./网络环境配置.md) - 配置网络访问
3. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境
4. [IDE 配置](./IDE配置.md) - 配置编辑器
5. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
4. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线
## 🔗 相关资源
- [基础指南](../../principles/fundamentals/) - 核心理念与方法论