使用文档

一、配置 API Key

1.前往AI服务商设置界面,选择一个AI服务商
2.如果没有 API Key,点击「获取 Key」按钮
3.在 API-KEY 管理页面创建新的 API Key
4.复制 API Key,在小蓝AI盒子中填入即可使用

二、手机端配对电脑

1.确保手机和电脑连接同一局域网(WiFi)
2.电脑端打开小蓝AI盒子,点击「配对」获取配对码
3.手机端进入设置 → 配对电脑,输入配对码完成连接

三、笔记功能

手机端支持笔记功能,帮助你随时记录重要信息。所有笔记以 TXT 文件形式存储在本地,不会上传到任何服务器。

1.在主界面标题栏空白处点击,唤出笔记功能
2.新增笔记 — 点击「新增笔记」按钮,输入内容即可创建
3.编辑笔记 — 点击任意笔记即可进入编辑,内容会自动保存
4.编辑标题 — 点击笔记右侧菜单按钮,选择「编辑标题」可修改笔记名称
5.置顶笔记 — 点击笔记右侧菜单按钮,选择「置顶」可将笔记固定在列表顶部。置顶的笔记会显示高亮边框,再次点击「取消置顶」即可恢复
6.删除笔记 — 点击笔记右侧菜单按钮,选择「删除」即可移除笔记
7.获取电脑端笔记 — 点击「获取电脑端笔记」,将电脑上的笔记同步到手机
8.同步到电脑 — 编辑笔记后点击「同步到电脑」,将内容同步回电脑端

提示:笔记列表按置顶优先、时间倒序排列。笔记文件保存在下载目录的 BlueBox/Notes 文件夹下。

四、知识库功能

知识库功能可以让你上传文档,AI对话时会自动检索相关内容作为参考。

1.进入设置 → 知识库,开启「启用知识库检索」开关
2.在开关下方点击「管理知识库文档」,上传文档文件
3.支持格式:txt、md、pdf、docx、doc、json、csv
4.上传后发送消息时,AI会自动检索相关文档内容作为参考资料
5.可调整「向量检索片段」和「关键词检索片段」数量,控制检索返回的文档片段数(1-10)

提示:旧版 .doc 文件解析效果较差,建议转换为 .txt、.docx 等格式以获得更好的效果。

五、MCP 服务器

MCP(Model Context Protocol)是 AI 工具标准协议。添加 MCP Server 后,AI 可以使用服务器提供的工具(如查询门店、下单等),仅支持 Streamable HTTP 传输。

1.进入设置 → MCP 服务器,点击「添加 MCP 服务器」
2.点击名称、服务器 URL、请求头等输入框,会从底部弹出编辑面板进行输入。填写服务器 URL(如:https://example.com/mcp),如有认证需求可在「请求头」中填入 JSON 格式的自定义请求头(如:{"Authorization": "Bearer xxx"}
3.点击「保存并连接」,系统会自动连接并获取服务器提供的工具列表
4.连接成功后,标签会显示绿色「已连接」徽章和高亮边框,并显示可用工具数量
5.点击任意 MCP 服务器标签,弹出操作菜单:启用/禁用重新连接编辑删除
6.若连接失败,标签右侧会显示红色 图标,点击可查看完整错误信息

提示:连接成功后,AI 对话时会自动加载已启用服务器的工具,无需额外操作。

六、智能体管理

智能体是为你提供不同服务的 AI 角色,你可以创建、编辑、排序和切换智能体。

1.选择智能体 — 点击标题栏的智能体名称,打开智能体选择界面,点击任意智能体即可切换
2.创建智能体 — 在智能体选择界面点击「创建自定义智能体」,填写名称、图标和提示词
3.编辑智能体 — 长按智能体标签,选择「编辑」,可修改名称、图标、提示词和聊天背景
4.预设智能体 — 编辑智能体时,可从预设列表中选择模板(翻译专家、前端代码专家、小说家等)。选择预设会覆盖当前名称和提示词,系统会弹出确认框提醒你确认
5.拖拽排序 — 在智能体选择界面,长按智能体标签拖动即可调整顺序,拖动时列表不会滚动
6.删除智能体 — 长按智能体标签,选择「删除」即可移除

七、聊天记录导入与导出

你可以将聊天记录导出为文件备份,或从文件导入恢复。

1.导出 — 在聊天界面点击菜单按钮,选择「导出当前话题」,文件将保存到下载目录(格式为 JSON)
2.导入 — 在聊天界面点击菜单按钮,选择「导入聊天记录」,选择之前导出的 JSON 文件即可恢复

提示:导出文件不加密,请妥善保管。导入时兼容不同版本的导出格式。

八、主题与外观

小蓝AI盒子支持浅色和深色两种主题模式,以及多种主题配色。

1.进入设置 → 外观,可切换浅色/深色主题
2.在「主题颜色」中选择喜欢的配色方案(翠竹清风、碧海蓝天等),选择器中会显示颜色预览圆点
3.深色模式下,AI 消息气泡和用户消息气泡使用不同深度的背景色,便于区分
4.支持极简风格主题,提供更简洁的视觉体验

九、话题名称

话题名称功能可以在发送首条消息后自动为对话生成名称,你也可以自定义生成规则。

1.进入设置 → 话题名称,开启「自动生成话题名称」开关
2.开启后,发送首条消息时会自动调用 AI 生成话题名称;关闭后话题保持「新话题」
3.自定义提示词 — 在「生成话题提示词」中可编辑生成话题名称时使用的提示词,支持以下占位符:

{agentDesc} — 智能体描述(系统提示词)
{firstMessage} — 用户第一条消息内容

4.点击「恢复默认」可将提示词重置为默认内容

提示:留空提示词将使用默认的七字古诗格式生成。修改提示词后内容会自动保存。

十、连接电脑与文件传输

手机端可以连接电脑端的小蓝AI盒子,连接后支持双向文件传输。

1.确保手机和电脑连接同一局域网(WiFi)
2.电脑端打开小蓝AI盒子,点击「配对」获取配对码
3.手机端进入设置 → 连接电脑,输入电脑 IP 地址并点击「连接」
4.输入电脑端显示的配对码,完成配对
5.连接成功后,在「已连接」状态下方会显示「发送文件到电脑」按钮
6.点击「发送文件到电脑」选择文件,传输过程中会显示文件名和进度条
7.接收电脑端发送的文件时,同样会显示接收进度

提示:如需断开连接,点击「已连接」右侧的「断开」按钮即可。

十一、专家模式

专家模式提供高级文件操作、数学计算和数据可视化能力,开启后 AI 可以读写指定工作目录中的文件,进行精确数学计算,并生成数据可视化图表。

1.进入设置 → 专家模式,开启「专家模式」开关
2.开启后设置「工作目录」,AI 助手将在此目录范围内进行文件操作
3.连接电脑后,还可设置「电脑端工作目录」,让 AI 操作电脑上的文件
4.文件操作 — AI 可以读取、写入、编辑、搜索文件,支持 txt、js、py、json 等文本文件,以及 PDF、Word、Excel、PPT 等文档
5.数学计算 — AI 遇到数学问题时会自动调用数学引擎进行精确计算,支持:

基础运算 — 四则运算、三角函数、指数对数、阶乘等
求导 — derivative('x^3', 'x') → 3x²
方程求解 — solve('x^2 - 5*x + 6 = 0', 'x') → x = 2, 3(牛顿法数值求解)
定积分 — integrate('x^2', 'x', 0, 1) → 0.3333(辛普森法则数值积分,支持 pi、e、sqrt(2) 等表达式作为上下限,支持无穷积分)
不定积分 — integrate('x^2', 'x') → x³/3 + C(常见函数符号积分)
矩阵运算 — 行列式、矩阵乘法、转置等
单位换算 — 2 inch to cm、100 km/h to m/s 等

6.数据可视化 — AI 可以根据数据生成可视化图表,支持折线图、柱状图、饼图、散点图、雷达图、热力图等所有 ECharts 图表类型。图表支持交互(tooltip、缩放),并持久化存储到本地,刷新话题后图表不会丢失

提示:专家模式涉及文件读写操作,请确保工作目录设置正确。数学计算和数据可视化功能仅在专家模式开启时可用。

十二、上下文选择与截图

上下文选择功能可以让你选取一段连续的对话消息,将其作为上下文发送给 AI,或截图保存。

1.进入选择模式 — 在聊天界面点击菜单按钮,选择「上下文选择」,进入消息选择模式
2.选择消息范围 — 点击任意消息作为起点,再点击另一条消息作为终点,系统会自动选中两条消息之间的所有消息(含首尾)。选中的消息会显示实线边框,可选消息显示虚线边框
3.确定 — 点击底部「确定」按钮,将选中的消息作为上下文发送给 AI
4.截图 — 点击底部「截图」按钮,将选中的消息生成为高清图片(2倍分辨率)。截图会自动去除头像、操作按钮等无关元素,保留纯净的对话内容
5.保存位置 — 手机端截图会保存到相册,电脑端(Web)会自动下载为 PNG 文件
6.取消 — 点击底部「取消」按钮可退出选择模式,不做任何操作

提示:截图功能首次使用时会自动加载截图组件,请稍候片刻。截图会完整保留当前主题样式(包括深色模式)。

十三、自定义服务商

除了内置的 AI 服务商外,你还可以添加自定义服务商,接入任何兼容 OpenAI API 格式的 AI 服务。

1.添加自定义服务商 — 进入设置 → AI 服务商,点击「添加自定义服务商」,填写名称、Base URL 和 API Key
2.模型管理 — 自定义服务商支持手动添加/删除模型,也可通过「获取模型」按钮自动拉取模型列表
3.获取 KEY — 点击「获取 KEY」按钮可跳转到各服务商的 API Key 管理页面,该功能对所有服务商可用
4.服务商配置参考 — 编辑自定义服务商时,可选择一个内置服务商作为「配置参考」(如 DeepSeek、GLM 等)。设置后,该自定义服务商将自动继承参考服务商的以下能力:

深度思考 — 支持开启/关闭深度思考模式
联网搜索 — 支持 Tool Calling 联网搜索功能
获取模型 — 可通过参考服务商的 API 自动拉取模型列表
话题名称生成 — 生成话题名称时自动禁用深度思考,避免浪费 Token

5.自定义请求体 — 支持为每个服务商配置自定义 JSON 请求体参数,满足特殊 API 需求

提示:未设置配置参考的自定义服务商仅支持基础的对话功能,不支持深度思考和联网搜索。

十四、网络搜索

AI 助手支持联网搜索功能,可以实时获取互联网上的最新信息、新闻、天气等内容。

1.支持的服务商 — DeepSeek、千问、豆包、GLM、Kimi、MiniMax,以及配置了对应参考服务商的自定义服务商
2.开启方式 — 在设置中开启「网络搜索」开关,或在聊天界面点击更多操作按钮(四角星图标)快速切换
3.搜索引擎 — 默认使用搜索引擎获取结果,当无结果时自动回退到备用搜索引擎
4.时间范围过滤 — 支持按时间范围筛选搜索结果:过去 24 小时(day)、一周(week)、一个月(month)、一年(year),不传则不限时间
5.网页内容抓取 — 除搜索外,AI 还可直接抓取指定网页的文本内容,用于获取更详细的信息
6.状态记忆 — 网络搜索开关状态会自动保存,切换服务商后也会保持记忆

提示:网络搜索功能需要设备联网。深度思考和联网搜索同时开启时,更多操作按钮会变为四角星图标。

十五、沉浸模式

沉浸模式提供更专注的阅读体验,自动隐藏历史消息,只保留最新一条消息,滚动时恢复显示。

1.开启/关闭 — 在聊天界面点击菜单按钮,选择「沉浸模式」即可切换。开启后菜单项显示 ✓ 标记
2.默认开启 — 进入设置 → 聊天设置,开启「沉浸模式默认开启」开关后,所有新话题自动进入沉浸模式,无需逐个手动开启
3.单独关闭 — 即使开启了默认沉浸模式,仍可在菜单中单独关闭某个话题的沉浸模式,该话题将不再自动进入沉浸模式
4.自动隐藏 — 滚动到底部后约 2 秒,除最新消息外的所有消息(含工具调用卡片)会以淡出动画隐藏,保留占位不跳动
5.滚动恢复 — 手动上下滚动时,所有隐藏的消息会以淡入动画重新显示;停止滚动回到底部后重新开始计时
6.发送消息 — 发送新消息后自动滚动到底部并重新计时隐藏,不会触发历史消息显示

提示:沉浸模式为每个话题独立记忆,切换话题时自动应用对应设置。

十六、全局搜索

全局搜索功能可以帮你快速查找历史对话内容,支持按消息内容和话题名称搜索。

1.打开搜索 — 在聊天界面点击菜单按钮,选择「搜索」,打开全局搜索面板
2.搜索范围 — 默认搜索所有智能体的所有话题;在话题抽屉中打开的搜索仅搜索当前话题
3.话题名称搜索 — 输入关键词后,匹配的话题名称会显示在搜索结果顶部,与消息内容结果之间用分割线隔开
4.消息内容搜索 — 搜索所有对话消息内容,结果会截取关键词上下文并高亮显示
5.时间戳 — 每条搜索结果会显示消息的发送时间,方便定位
6.跳转定位 — 点击任意搜索结果,自动切换到对应智能体和话题,并定位到该消息

提示:搜索结果最多显示前 50 条。话题名称匹配结果排在消息内容匹配结果之前。

十七、消息版本切换

当对 AI 回答进行「刷新」操作后,会生成多个版本的回答,你可以方便地切换查看不同版本。

1.版本切换器 — 当一条 AI 消息存在多个版本时,消息时间戳右侧会显示版本切换器(如 1/3
2.切换版本 — 点击 <> 按钮可切换到上一版本或下一版本
3.深度思考提示 — 如果该版本包含深度思考内容,时间戳行最右侧会显示「深度思考」标签,点击可展开查看

提示:版本切换器紧贴时间戳显示,与深度思考标签分开排列,互不干扰。

十八、其他功能

其他功能文档正在完善中,敬请期待。

← 返回官网