makelore/docs/product-introduction.md

# 麦洛产品介绍

> 整理日期：2026 年 9 月 26 日。本文介绍 Makelore、Works Square、Yuxi 与小智硬件及固件平台组成的产品体系，依据当前项目源码、功能说明与已确认的产品定位整理。具体可用功能取决于账号权限、客户端和固件版本、硬件配置及配套服务。

## 一、产品概述

麦洛是一套面向学生和创作者的 AI 创作与学习产品。用户可以通过对话编写程序、制作图片和视频、配置机器人、创建个人智能体，也可以在做项目的过程中向平台提供的领域智能体请教。

产品围绕具体的项目、作品和问题展开：用户提出想法，借助 AI 完成制作和修改，在需要专业判断时引入老师 Agent，并通过作品平台展示符合发布条件的成果。

整个产品体系由四个主要部分组成，其中小智部分包含设备固件与设备服务两个层次：

| 项目 | 产品职责 | 主要使用者 |
| --- | --- | --- |
| **Makelore 桌面客户端** | 提供 AI 编程、视觉创作、机器人管理、个人云智能体和项目内咨询的操作界面 | 学生、创作者、个人智能体使用者 |
| **Works Square 平台** | 提供网页作品展示、账号与点数服务、作品审核发布、资源管理及智能体下发 | 学生、作品浏览者、家长、平台运营人员 |
| **Yuxi 智能体平台** | 管理智能体及其模型、提示词、知识库和扩展能力，承担云端智能体的对话与执行 | 智能体配置人员、能力建设者、平台管理员 |
| **小智硬件与固件平台** | 提供设备端固件、语音交互服务、机器人配置、设备管理及固件构建与升级能力 | 机器人使用者、硬件开发者、设备运营与维护人员 |

对学生而言，Makelore 是主要的创作入口。Works Square 承担平台服务与运营管理，Yuxi 提供可配置、可运行的云端智能体能力，小智体系承担实体机器人上的交互和设备运行。

## 二、Makelore 桌面客户端

客户端提供四个模块入口。各模块共用账号，是否开放由平台配置。

### 2.1 Makelore Code：AI 编程

AI 编程模块以本地项目为单位，支持用户通过自然语言与编程智能体协作，将想法制作成可运行的应用、游戏或工具。

主要功能包括：

- **项目管理**：选择本地目录创建或打开项目；新项目自动建立默认编程智能体，无需单独完成智能体创建流程。
- **项目会话**：会话直接列在项目下，支持新建、重命名、归档、恢复和查看历史。
- **编程协作**：围绕项目文件开展代码生成、修改、运行与问题排查，查看执行过程和代码变化。
- **作品预览**：在工作区查看项目运行结果，结合实际页面继续调整作品。
- **模型与上下文**：选择可用模型及其思考选项，通过文本、图片、文件上下文等提供需求。
- **项目资源配置**：为项目配置模型、知识与插件；通过插件和 Skill 扩展编程能力。
- **智能体咨询**：在当前项目旁打开平台下发的智能体，讨论设计、方法和具体问题。
- **提交审核**：符合条件的交互式项目可从项目配置发起“一键提交审核”，由客户端完成相应准备与提交，再进入平台审核发布流程。

编程操作对话与智能体咨询分别保存。前者承担项目制作和修改；后者结合项目资料提供分析、判断和讨论。用户可以在同一个工作区使用两种能力。

### 2.2 Makelore Canvas：AI 绘画与视频制作

Canvas 用于通过对话整理视觉创作需求，并生成图片或视频。每个设计项目保存持续更新的制作方案、对话和历史作品。

主要功能包括：

- **设计项目管理**：创建、切换和管理不同创作项目。
- **对话整理需求**：与 AI 讨论内容、风格和制作方向，形成可继续修改的方案。
- **方案编辑**：修改创作提示词及当前支持的媒介、画幅、数量、时长等参数。
- **参考图管理**：上传本地参考图，或使用历史作品作为后续创作素材；视频制作支持选择开始画面。
- **确认后生成**：查看方案及费用信息，确认后启动制作任务。
- **任务与结果管理**：查看生成状态与历史结果，对图片放大预览，对视频播放、预览和下载。

创作方案、任务和生成结果归属于对应的云端设计项目，便于在同一方向上连续修改和制作。

### 2.3 Makelore Robot：AI 机器

Robot 用于管理接入平台的机器人设备及其对话配置。

主要功能包括：

- **机器人智能体管理**：创建和选择机器人智能体，编辑名称与角色提示。
- **设备激活与绑定**：通过设备激活码绑定设备，并将设备分配给对应智能体。
- **引导配网**：在支持的桌面环境中引导连接设备热点，继续完成设备配网。
- **模型配置**：从设备服务提供的可用目录中选择相关模型。
- **语言与声音配置**：设置对话语言、声音音色及聊天记录方式。
- **设备与配置查看**：围绕所选智能体查看绑定设备和当前配置。

Robot 是小智硬件体系在 Makelore 中的管理入口。设备上的固件、实时语音对话及固件升级由小智体系承担，完整职责见第六节。设备行为与可选能力受对应硬件和设备服务支持范围约束。

### 2.4 Makelore Agents：个人云智能体

Agents 模块用于创建、配置和使用个人云智能体。用户可以定义智能体的任务、知识和工具，在试用后发布一个正式使用版本。

主要功能包括：

- **创建与配置**：编辑智能体需求、名称、提示词、模型、能力和使用限制。
- **草稿试聊**：在配置过程中测试智能体的表现，并继续调整。
- **发布版本**：将配置发布为正式使用版本，查看版本差异，或将历史版本恢复为草稿。
- **正式对话**：与已发布智能体聊天，查看历史、运行状态、附件和生成文件。
- **知识库**：创建知识库，上传、替换和管理资料，查看处理状态，并将可用知识配置给智能体。
- **扩展能力**：根据可用资源配置 Skill、工具、MCP 服务和子智能体等能力。
- **自动任务**：配置定时或重复任务，管理启停、运行记录、结果与相关费用限制。
- **微信渠道**：连接个人微信账号，为账号选择已发布的智能体，并管理连接状态和渠道对话。
- **应用接入**：为应用配置 API 接入，使已发布智能体能在其他应用中被调用。
- **费用与用量**：查看相关用量和费用，设置智能体的费用限制。

个人云智能体由创建者配置和管理，其应计费模型调用由创建者承担。它与平台选定并下发给学生的老师 Agent 分别管理。

### 2.5 客户端公共功能

四个模块之外，客户端提供账号登录、个人资料、模块权限、永久词元点数余额、充值订单、收支记录和应用更新等公共功能。模型选项和能力按照平台下发的实际可用配置展示。

## 三、老师 Agent：将领域杰出人物的能力转化为智能体

### 3.1 定义与定位

**老师 Agent，是某一领域杰出人物的能力转化而成的智能体，供平台学生用户使用。**

这一产品定义围绕三个问题展开：它承载谁的能力、这些能力属于什么领域、学生能够从中得到什么帮助。

“能力”包括对领域问题的理解、专业经验、观察方式、判断标准、取舍方法和解决问题的能力。老师 Agent 的价值体现在学生遇到具体问题时，能够获得这些能力所带来的专业判断与行动参考。

例如，游戏设计领域的老师可以帮助判断玩法是否成立、反馈是否清晰、当前最值得改进的环节是什么；创作领域的老师可以帮助判断表达是否准确、作品特点是否形成、不同修改方向会带来什么影响。这些是能力方向的示例，实际下发内容以平台配置和能力验证为准。

### 3.2 为学生提供什么

学生可以带着正在进行的项目、作品或困惑，与老师 Agent 讨论。预期获得的帮助包括：

- **识别问题**：从领域视角找到关键问题和容易遗漏的因素。
- **形成判断**：分析当前方案的合理性、局限和需要补充的证据。
- **解释依据**：说明为什么这样判断，以及判断依赖的条件。
- **比较选择**：梳理不同方向的收益、代价和取舍。
- **提出下一步**：给出与当前项目阶段相匹配的尝试和改进建议。
- **理解方法**：让学生在具体讨论中逐步理解优秀实践者如何观察、思考和处理问题。

不同老师 Agent 可以承载不同领域、不同人物的能力与方法。学生根据问题选择合适的智能体，并保留自己的选择和决定权。

### 3.3 能力如何进入产品

提示词、Skill、案例、知识库与工具是承载能力的具体方式。能力总结、提炼和蒸馏属于实现方法；老师 Agent 的产品定义以人的领域能力及其对学生的价值为中心。

能力建设需要明确来源、擅长领域、具体能力和适用边界，并通过真实问题检验其判断是否有依据、是否有帮助、是否能随新事实调整。名称、头像和表达风格用于呈现智能体的身份。

这一理念是产品建设与能力评价的依据。现有的智能体配置和下发功能，并不代表所有已配置智能体都已经完成领域能力验证。

### 3.4 当前提供的使用方式

当前老师 Agent 主要通过 Code 项目的智能体咨询栏提供服务：

- 平台可下发多个智能体，客户端在顶栏并排展示入口，学生点击相应智能体开始或继续讨论。
- 智能体名称、人设、职责和能力由云端配置决定；客户端统一呈现，不设置固定的“老师”“朋友”等角色分类。
- 每个智能体保留相应话题与历史；讨论可围绕当前编程会话、明确引用和项目资料展开。
- 回答支持 Markdown、列表、表格、代码、图片和公式；适用时可用想法板、结构图、流程或对照等形式辅助整理。
- 工具活动与回答分别展示，学生可以看到智能体使用了哪些工具及其状态。
- 新话题使用当时下发的发布版本；更新配置后，已有话题仍保留其原版本。停止下发后，相关历史仍可查看。

### 3.5 如何理解项目与会话

客户端为云端老师智能体提供三项与当前上下文绑定的只读能力：

| 能力 | 可以提供的信息 | 使用目的 |
| --- | --- | --- |
| 列出项目文件 | 当前项目的文件目录与文件信息 | 了解项目结构，判断需要查看哪些资料 |
| 读取项目文件 | 当前项目范围内允许读取的文本文件内容 | 结合实际代码、配置或说明进行分析 |
| 读取会话原文 | 当前绑定操作会话及相关咨询上下文中可读取的公开内容 | 理解此前需求、尝试过程和讨论依据 |

资料由客户端按请求提供给云端。完整工程和编程运行日志保留在本地，云端保存对话及实际收到的资料片段。读取范围受当前项目、会话和访问规则约束，不等于自动遍历用户所有项目与全部历史。

这三项能力对本地项目是只读的。老师 Agent 的建议由学生决定如何采用；当前系统也不会自动把所有咨询结论写入编程操作会话或自动执行修改。

### 3.6 配置、下发与计费

老师 Agent 在 Yuxi 中配置能力，由 Works Square 运营端选择、发布和下发，Makelore 负责学生侧使用与本地上下文读取。

运营人员可以查看已下发列表、添加智能体、同步 Yuxi 配置、设置默认项、启用或停止下发。老师问答沿用学生账号付费规则，与个人云智能体的创建者付费规则分别处理。

## 四、Works Square：作品平台与运营服务

### 4.1 网页作品平台

Works Square 提供学生作品的展示与访问入口，支持浏览已发布作品、查看详情、打开交互式作品和观看视频。网页还提供账号中心、本人项目及相关提交状态的管理入口。

交互式作品经过提交、校验和审核后，按明确的发布版本提供访问。平台管理发布、下架和版本回退，便于控制对外展示的作品内容。

### 4.2 账号、家庭与费用服务

平台统一处理账号与个人资料、组织成员、模块开放权限、永久词元点数钱包、充值订单、消费记录及计费规则。

家庭关系支持邀请与共享付款来源管理。账号的内容归属与付款来源分别管理，共享付款不会直接开放他人的项目或会话内容。

平台还接收经过筛选的编程会话自然语言快照，提供观察分析与报告相关服务。观察智能体在运营端单独配置，与学生主动咨询的老师 Agent 分别承担功能。

### 4.3 内容与资源服务

- **学习项目目录**：管理经过整理的学习项目，包含标题、简介、说明文档、封面和项目文件包，支持发布、排序与历史版本管理。
- **设计服务**：为 Canvas 提供云端方案、制作报价、生成任务和结果资产管理。
- **模型服务**：管理平台可用模型、使用资格与能力信息，供客户端及相关智能体选择。
- **插件服务**：管理官方插件目录、发布资源和账号获取记录，配合客户端完成项目使用。
- **客户端分发**：管理安装包和更新信息。
- **老师 Agent 下发**：将运营选定的 Yuxi 智能体提供给有资格的学生账号使用。
- **机器人服务对接**：连接麦洛账号与小智设备服务，提供机器人智能体创建、配置、设备绑定和设备分配所需的接口。

### 4.4 运营后台模块

| 模块 | 主要功能 |
| --- | --- |
| 发布审核 | 查看待审、历史和失败记录，预览作品，批准或驳回发布 |
| 视频审核与视频作品 | 管理视频提交、预览、审核和发布相关状态 |
| 平台发布项目 | 查看和管理对外发布的项目及其版本 |
| 学习项目管理 | 编辑项目资料与文件，发布、排序、归档和查看历史 |
| 组织用户 | 管理组织成员及账号关联、权限和模块开放状态 |
| 充值档位与词元点数计费规则 | 维护充值配置、计费单位和消费规则 |
| Design Agent 配置 | 管理视觉创作智能体的配置及发布版本 |
| 观察 Agent | 配置会话观察和报告相关智能体能力 |
| 编程老师 | 查看下发列表，从 Yuxi 添加智能体，同步版本、设为默认及启停 |
| 插件管理 | 管理插件内容、资源、开放状态和相关配置 |
| 模型管理 | 管理平台模型的可用状态与相关业务配置 |
| 安装包管理 | 管理客户端安装包与更新分发信息 |
| 手动上传 | 由运营人员提交项目资料与文件 |

## 五、Yuxi：智能体能力配置与云端执行

Yuxi 为产品体系提供智能体的配置、知识资源与运行能力，同时提供独立的网页智能体使用界面。

### 5.1 智能体管理与问答

- 创建和编辑原生主智能体，配置名称、描述、系统提示词及模型。
- 配置工具、Skill、MCP、知识库和子智能体等资源。
- 在问答页面使用智能体，查看流式回答、工具活动、附件和历史会话。
- 管理云端执行过程，处理排队、停止、恢复和运行结果。
- 为个人云智能体提供草稿、发布版本、定时任务及应用接入所需的执行服务。

### 5.2 知识与扩展资源

- **知识库**：上传和管理资料，进行解析、索引与检索，并查看处理和可用状态。
- **知识评估**：通过评估相关功能检查知识检索效果。
- **Skill**：以可配置的任务方法和说明扩展智能体能力。
- **工具与 MCP**：连接智能体可调用的操作和外部服务。
- **子智能体**：将具体职责交给独立配置的子智能体协作处理。
- **工作区与文件**：管理云端会话相关的文件和产物，提供查看与使用入口。

不同资源的管理和使用受账号权限约束。

### 5.3 模型与平台管理

管理员可以配置模型供应商、聊天模型及知识处理所需的模型。Yuxi 普通聊天模型与下发给学生的老师模型分别配置，老师模型需要匹配学生模型网关的可用目录。

在老师 Agent 的协作链路中，Yuxi 负责能力定义和云端运行，Works Square 负责选择与下发。运营端可选择平台原生主智能体目录中的智能体，目录覆盖符合条件的内置及其他用户创建项，不局限于当前运营账号名下。

## 六、小智硬件与固件平台

小智体系让 AI 通过实体设备与用户交互。它包括运行在设备上的 ESP32 固件，以及处理语音对话、管理设备和配置的服务端。固件工程提供板型适配和构建能力，服务平台提供智控台及 OTA 升级管理。

### 6.1 设备端固件

设备固件负责连接具体硬件，把麦克风、扬声器、屏幕和可用执行部件组织成可交互的终端。

主要能力包括：

- **硬件适配**：按芯片和板型配置音频、显示、按键及其他外设，构建对应的设备固件。
- **网络与配网**：连接设备网络，通过支持的配网方式设置连接信息，并与小智服务通信。
- **语音输入与播放**：处理麦克风采集、语音唤醒、音频传输和扬声器播放。
- **交互反馈**：在配有屏幕、灯光等部件的设备上显示状态、文字或表情。
- **设备控制**：通过设备实际提供的工具控制音量、显示、灯光、GPIO 或电机等能力。
- **激活与升级**：获取激活信息，检查适用固件版本并执行 OTA 更新。

带摄像头的设备可提供视觉输入，具备相应音频条件的设备可支持更完整的回声消除和语音交互。具体能力取决于板型、外设、固件构建选项和服务配置，不能把所有板型视为具有相同功能。

### 6.2 语音与智能交互服务

小智服务端接收设备的音频和消息，组织语音识别、模型回答、工具调用与语音合成，再把结果返回设备。

主要能力包括：

- **语音对话**：提供语音活动检测、语音识别、语言模型对话和语音合成，支持流式交互。
- **角色配置**：为机器人配置角色提示、语言、模型和声音。
- **模型接入**：对接不同的语音、语言和视觉模型服务，按配置使用对应能力。
- **记忆与知识**：提供可选的记忆、知识检索等能力，辅助连续对话和领域问答。
- **声纹与视觉**：在相应服务与设备启用后，支持说话人识别及视觉理解相关功能。
- **工具和设备指令**：通过工具、插件或 MCP 等方式扩展行为，并向支持的设备下发控制指令。

这些属于小智体系的可配置能力，是否对某台机器人开放取决于其配置与实际接入的服务。

### 6.3 智控台与设备运营

小智提供网页智控台，并包含移动管理端，用于管理机器人服务本身。主要模块包括：

| 模块 | 主要功能 |
| --- | --- |
| 智能体与角色配置 | 管理机器人角色、模型、声音及相关对话配置 |
| 设备管理 | 管理设备绑定、归属及与机器人智能体的关联 |
| 用户与接入管理 | 管理用户，以及外部平台使用设备服务的接入凭据 |
| 模型与供应商管理 | 配置语音识别、语言模型、语音合成等服务 |
| 声音与声纹 | 管理音色资源、声纹及已接入的声音扩展能力 |
| 知识库 | 管理机器人使用的知识资源及检索配置 |
| 固件与 OTA | 管理固件类型、版本、文件及升级分发 |
| 系统配置 | 管理服务参数、功能配置和相关运行设置 |

Makelore Robot 面向日常设备使用，小智智控台承担更完整的设备服务配置与维护；两者的界面和功能范围有所不同。

### 6.4 固件构建与交付

固件工程支持按板型及发布变体构建，可选择界面语言和支持的唤醒词模型。构建产物包含用于设备升级的固件、用于完整烧录的镜像，以及构建日志和版本来源信息。

设备维护人员可以将适用固件交付给设备烧录，或通过固件与 OTA 管理流程提供升级。板型与固件必须匹配；构建成功并不等于对应实物设备已经完成音频、屏幕、网络和升级验证。

### 6.5 与麦洛其他部分的关系

| 部分 | 在机器人链路中的职责 |
| --- | --- |
| Makelore Robot | 向用户提供创建角色、引导配网、激活绑定、设置声音和分配设备的操作入口 |
| Works Square | 处理麦洛账号侧的授权、关联记录与小智设备服务对接 |
| 小智服务平台 | 保存和使用机器人配置，处理设备通信、语音对话与设备管理 |
| 小智设备固件 | 在实物设备上采集输入、播放声音、显示反馈及执行支持的设备操作 |

当前机器人智能体沿用小智体系，平台下发的老师 Agent 由 Yuxi 运行。现有产品介绍不将“在 Yuxi 配置一位老师”表述为“该老师已自动进入所有机器人”；把同一领域能力用于实体设备，需要另外确认能力接入、语音交互和设备支持情况。

## 七、典型使用流程

### 7.1 学生制作一个交互式作品

1. 在 Code 中创建或打开项目，描述想做的作品。
2. 与编程智能体协作完成代码和运行预览。
3. 遇到设计或方法问题时，从顶栏选择合适的老师 Agent。
4. 老师结合当前问题、项目文件和会话资料给出判断与建议。
5. 学生选择采用的建议，继续制作和验证。
6. 对符合发布条件的作品提交审核，通过平台流程对外展示。

### 7.2 用户制作图片或视频

1. 在 Canvas 创建设计项目，描述内容并提供参考素材。
2. 通过对话和参数编辑确认制作方案。
3. 查看费用并确认生成。
4. 在历史作品中预览、下载结果，或继续用于后续制作。

### 7.3 平台提供一位领域老师

1. 明确某位领域杰出人物的能力来源、擅长范围和要提供给学生的帮助。
2. 在 Yuxi 中通过提示词、Skill、案例、知识及工具配置承载这些能力，并检查实际表现。
3. 运营人员在 Works Square 选择该智能体，发布并下发。
4. 学生在 Makelore 中看到入口，并在自己的项目情境中使用。
5. 能力配置调整后，由运营显式同步新版本，供后续新话题使用。

### 7.4 用户配置一台机器人

1. 为支持的设备准备匹配的固件，并完成必要的烧录或升级。
2. 在 Makelore Robot 创建机器人智能体，设置角色、模型和声音。
3. 按引导为设备配网，使用设备提供的激活码完成绑定。
4. 将设备分配给对应智能体，通过设备实际测试语音与交互表现。
5. 日常在客户端调整公开配置，由设备维护人员通过小智平台管理适用的固件和服务配置。

## 八、当前产品范围说明

- Makelore 当前提供四个模块入口。学习项目目录属于平台服务和运营能力，当前不作为客户端的第五个独立模块。
- 客户端支持项目内提交审核；独立作品广场主要由网页平台承担。
- 学习项目以运营整理的内容和项目文件为主。自动课程生成、完整教学进度系统和课堂管理不属于本文所述现有功能。
- 老师 Agent 的专业能力定位适用于后续能力建设；当前主要使用入口位于 Code 项目咨询，并不表示所有模块都已接入同样的项目读取能力。
- 个人云智能体、编程操作智能体、平台下发的咨询智能体和机器人配置各有当前职责与使用入口，本文不将它们视为已经完全互通的配置对象。
- 小智固件及服务能力按硬件和配置启用；设备绑定成功不等于在线、语音链路或全部外设已通过验证。Yuxi 老师 Agent 与机器人角色目前也不自动同步。
- 手机端混合信息流等仍有独立启用和验收条件的能力，未列为本介绍中的常规可用功能。本文也不将尚未合入主分支的改动列为现状。

---

本文依据 Makelore、Works Square、Yuxi、小智服务端和小智固件工程的模块入口、源码、已接受产品决策及功能说明整理。老师 Agent 定义采用 2026 年 9 月 26 日确认的定位。本文用于产品介绍，不作为特定部署环境或实物设备的功能验收报告。