# liyupi/ai-guide 深度研究

## 研究级别

- 当前级别：L2 结构深度研究。
- 研究对象：`liyupi/ai-guide`。
- 证据来源：本目录 `raw/` 下的 GitHub 元数据、VuePress 站点结构、教程目录和本地仓库工作树。
- 观察日期：2026-07-03。

## L2 结论

`liyupi/ai-guide` 的核心价值是大众化 AI/Vibe Coding 知识门户。它不是一个单点工具仓库，而是用
VuePress 站点把 AI 资源、Vibe Coding 零基础教程、模型解释、项目实战、产品变现和 OpenClaw
教程组织成面向普通用户的学习入口。

对本仓最重要的启发是：零基础内容必须先降低进入门槛，再把用户带到工程闭环。它适合反哺
`getting-started/` 的表达方式和路径分流，但不能替代本仓的工程规范。

## 本地证据

- `raw/repository/.vuepress/config.ts`：站点配置入口，说明它是 VuePress 内容站点。
- `raw/repository/.vuepress/sidebar.ts`：侧边栏配置，承载知识路径组织。
- `raw/repository/Vibe Coding 零基础教程/README.md`：Vibe Coding 教程入口。
- `raw/repository/Vibe Coding 零基础教程/00 Vibe Coding 简介.md`：概念解释入口。
- `raw/repository/Vibe Coding 零基础教程/01 快速上手 Vibe Coding.md`：快速上手入口。
- `raw/repository/Vibe Coding 零基础教程/02 AI 编程学习路线.md`：学习路线入口。
- `raw/repository/Vibe Coding 零基础教程/60 Vibe Coding 资源大全.md`：资源导航入口。
- `raw/repository/OpenClaw 保姆级教程/`：工具教程系列。
- `domain.yml`：当前优先级为 P3，研究方向为 `cn-onboarding`。

## 关键机制

### 内容站点而非单篇教程

该仓库通过 VuePress 把分散内容变成可导航站点。对零基础用户而言，导航、侧边栏和路径结构本身
就是产品体验的一部分。

### 从概念到上手再到资源

Vibe Coding 零基础教程按简介、快速上手、学习路线、资源、概念、模型原理、常见问题等入口组织，
体现了低门槛内容的基本路径：先让用户知道是什么，再让用户动手，再补概念和资源。

### 工具教程承担实践桥梁

OpenClaw 系列从安装、部署、模型、工具管理、Skills、多 Agent、记忆、成本和安全展开，说明大众
教程需要从“会用工具”逐步过渡到“理解系统能力”。

## 可迁移模式

- `getting-started/` 应按用户身份和目标分流，而不是只按概念分类。
- 零基础路径应包含第一个可完成产出、快速上手、学习路线、常见问题和资源入口。
- 大众化解释要保留，但工程标准必须下沉到 `workflow/`、`references/` 和 `skills/`。
- 工具资源进入本仓前必须走资源治理和研究域流程。
- 对模型、工具、项目实战和产品变现类内容建立边界，避免本仓变成泛 AI 百科。

## 对本仓的影响

该对象能补强本仓的用户入口：

- 面向零基础用户，增加“先做出一个东西”的路径表达。
- 面向非专业用户，把 Vibe Coding 从抽象概念改写成目标、输入、过程、输出和验证。
- 面向资源治理，把教程中提到的工具作为候选资源，而不是直接推荐。
- 面向学习地图，把概念解释、实战任务和常见问题分开组织。

## 风险和待验证项

- 该仓是大众化内容门户，不是企业级工程架构样板。
- 内容覆盖范围很广，本仓不能无限扩展成泛 AI 资源大全。
- 站点结构可以借鉴，具体内容和外部资源必须重新核验许可证与时效。
- VuePress 技术实现不应成为本仓当前重点，本仓仍是 Markdown 知识库加质量门禁。

## 下一步 L3 验证任务

- 选择一个零基础路径，写成“目标 -> 操作 -> 产出 -> 验证 -> 常见失败”的最小教程模板。
- 抽取教程中的工具候选，进入资源候选表并补齐 license、状态和最后检查时间。
- 将 `getting-started/` 按零基础、开发者、维护者、高阶 Agent 用户做路径分流草案。
- 为大众化解释建立复核规则：解释可以浅，但验证步骤必须具体。
