Files
tradecatlabs 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

4.1 KiB
Raw Permalink Blame History

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.mdVibe 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 用户做路径分流草案。
  • 为大众化解释建立复核规则:解释可以浅,但验证步骤必须具体。