快速上手

这篇文档不涉及安装，只讲第一次打开程序之后的最短上手路径。目标很简单：先建工作区，再补模型，最后回到 AI 页开始第一轮对话。

第一步：新建工作区

工作区是 MaomiAgent 的基础单位。你可以把它理解成“AI 和工具要围绕哪个本地目录工作”。

2. 进入 工作区 页面。
3. 点击右上角 新建工作区。
4. 选择本地目录，填写名称、备注、标签，必要时打开 置顶。
5. 保存后确认新工作区已经出现在列表里。

第二步：补齐模型渠道

如果你还没有配置模型，先到模型页完成第一个渠道。没有模型渠道时，AI 页面可以建会话，但无法稳定完成对话任务。

1. 进入 模型 页面。
2. 点击 新建渠道。
3. 选择提供商，填写渠道标识、端点地址和密钥等配置。
4. 保存后回到列表，确认渠道已启用。

第三步：回到 AI 页面开始对话

工作区和模型都准备好之后，就可以进入 AI 页面。

1. 在左侧打开目标工作区。
2. 点击页面中央或左侧会话区的 新建会话。
3. 在输入框里直接描述任务，例如“帮我整理今天的待办”或“检查当前工作区的文档结构”。
4. 如果你需要切换模型或智能体，直接在消息输入区附近切换即可。

第四步：需要排查时看日志和设置

• 在 日志 页面按模块、级别和时间范围筛选运行日志。
• 在 设置 页面查看桌面偏好、运行时信息和常用菜单入口。

推荐阅读

• 想继续熟悉界面结构，请看 产品简介。
• 想系统了解对话页，请看 AI 对话。
• 想接入飞书或微信，请看 飞书 和 微信。