# Labplus 知识库

本章节收录两类工程知识内容：

- **工程 Wiki**（25 篇）：围绕 Labplus 掌控系列产品的工程技术百科，按 **ESP32 产品线** 与 **ESP32-S3 产品线** 两级中文目录组织，覆盖产品概述、硬件规格、编程软件、类库 API、固件架构、项目案例与研发文档。
- **知识卡片**（11 类 30 篇）：面向快速检索与复用的主题卡片，每张卡片聚焦一个工程主题（构建体系、配置体系、错误处理、依赖管理、术语表等）。

```{toctree}
:maxdepth: 2

wiki/index
cards/index
```

## 工程 Wiki 分类速览

**{doc}`ESP32 产品线 <wiki/ESP32 产品线/index>`**（掌控板 / mPython，18 篇）

- 总览与硬件：{doc}`ESP32 产品线总览 <wiki/ESP32 产品线/ESP32 产品线>`、{doc}`产品概述 <wiki/ESP32 产品线/产品概述>`、{doc}`硬件规格与快速上手 <wiki/ESP32 产品线/硬件规格与快速上手>`、{doc}`扩展板与配件 <wiki/ESP32 产品线/扩展板与配件>`
- 软件与编程：{doc}`编程软件工具 <wiki/ESP32 产品线/编程软件工具>`、{doc}`MicroPython 语言参考 <wiki/ESP32 产品线/MicroPython语言参考>`、{doc}`经典项目案例 <wiki/ESP32 产品线/经典项目案例>`
- 子目录：{doc}`API 类库参考 <wiki/ESP32 产品线/API类库参考/index>`（板载功能库、GUI 与扩展驱动库、网络与通信库、音乐与音频库）、{doc}`固件架构与源码 <wiki/ESP32 产品线/固件架构与源码/index>`（含板型与硬件配置）、{doc}`编程教程 <wiki/ESP32 产品线/编程教程/index>`（入门 / 进阶教程）
- {doc}`内部研发文档 <wiki/ESP32 产品线/内部研发文档>`

**{doc}`ESP32-S3 产品线 <wiki/ESP32-S3 产品线/index>`**（掌控板 3.0 / 乐动掌控 2.0，7 篇）

- {doc}`ESP32-S3 产品线总览 <wiki/ESP32-S3 产品线/ESP32-S3 产品线>`、{doc}`掌控板3.0 <wiki/ESP32-S3 产品线/掌控板3.0>`、{doc}`乐动掌控2.0 文档 <wiki/ESP32-S3 产品线/乐动掌控2.0 文档>`
- {doc}`ESP32-S3 硬件规格与快速上手 <wiki/ESP32-S3 产品线/ESP32-S3 硬件规格与快速上手>`、{doc}`ESP32-S3 API 参考 <wiki/ESP32-S3 产品线/ESP32-S3 API 参考>`、{doc}`ESP32-S3 固件架构 <wiki/ESP32-S3 产品线/ESP32-S3 固件架构>`
- {doc}`小智AI助手 <wiki/ESP32-S3 产品线/小智AI助手>`

## 知识卡片分类速览

{doc}`知识卡片总目录 <cards/index>`，共 11 类 30 篇：

- {doc}`ESP-IDF + MicroPython 多板型配置体系（sdkconfig、mpconfigboard、NVS、分区表） <cards/ESP-IDF + MicroPython 多板型配置体系（sdkconfig、mpconfigboard、NVS、分区表）/index>`
- {doc}`ESP-IDF v5.x 构建框架（ESP32-S3 固件构建系统） <cards/ESP-IDF v5.x 构建框架（ESP32-S3 固件构建系统）/index>`
- {doc}`多板型 MicroPython 固件构建系统（ESP32 Makefile + ESP32-S3 CMake_ESP-IDF） <cards/多板型 MicroPython 固件构建系统（ESP32 Makefile + ESP32-S3 CMake_ESP-IDF）/index>`
- {doc}`多构建体系下的依赖管理：ESP-IDF Component Manager、MicroPython Manifest与Sphinx requirements <cards/多构建体系下的依赖管理：ESP-IDF Component Manager、MicroPython Manifest与Sphinx requirements/index>`
- {doc}`MicroPython C扩展与Python层错误处理：OSError_ValueError、异常捕获与启动容错 <cards/MicroPython C扩展与Python层错误处理：OSError_ValueError、异常捕获与启动容错/index>`
- {doc}`MicroPython logging 模块与 C 层输出机制 <cards/MicroPython logging 模块与 C 层输出机制/index>`
- {doc}`mPython 掌控板固件与文档总仓库 <cards/mPython 掌控板固件与文档总仓库/index>`
- {doc}`mPython 官方 Sphinx 在线文档站点 <cards/mPython 官方 Sphinx 在线文档站点/index>`
- {doc}`讯飞开放平台 IAT 语音听写服务集成 <cards/讯飞开放平台 IAT 语音听写服务集成/index>`
- {doc}`Qoder 云端 Repo Wiki 构建与知识卡片生成服务 <cards/Qoder 云端 Repo Wiki 构建与知识卡片生成服务/index>`
- {doc}`业务术语表 <cards/业务术语表/index>`

## AI 访问说明

本站点为 AI 助手（大语言模型、Agent 等）额外提供两份机器可读文件，位于**站点根目录**，每次构建时自动生成：

- **`llms.txt`** —— 内容索引：列出站内全部文档的标题、访问路径与摘要说明，便于 AI 助手快速了解知识库结构并按需选取页面。访问路径：`<站点根地址>/llms.txt`。
- **`llms-full.txt`** —— 全文合集：将站内全部文档正文合并为单个 Markdown 文本，供 AI 助手在**一次请求**中读取整个知识库，无需逐页抓取即可完成问答、检索与推荐。访问路径：`<站点根地址>/llms-full.txt`。

使用建议：上下文窗口有限时先读取 `llms.txt` 定位目标页面，再按需读取对应文档或 `llms-full.txt`；需要完整、一次性注入知识库时直接使用 `llms-full.txt`。