Files
tradecatlabsandGitHub f1f0b9fe75 refactor: move research domain to repository root (#58)
Move the complete research domain from docs/research to root-level research, update indexes and path-aware tooling, and align raw snapshot governance and CODEOWNERS.\n\nVerified with make test and GitHub CI.
2026-07-11 22:18:37 +08:00

78 lines
4.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 用户做路径分流草案。
- 为大众化解释建立复核规则:解释可以浅,但验证步骤必须具体。