DeepTutor macOS 安装指南

安装 DeepTutor

1. 1

   先确认 Mac 芯片

   点击屏幕左上角苹果菜单 →“关于本机”。看到 Apple M1/M2/M3/M4 即可安装；Intel 芯片不能使用当前安装包。

2. 2

   打开 DMG 安装包

   在“下载”文件夹中双击 DeepTutor_1.0.0_macos-arm64.dmg。系统询问是否打开互联网下载的文件时，选择“打开”。

3. 3

   拖入“应用程序”

   把 DeepTutor 图标拖到 Applications（应用程序）文件夹。复制完成后，关闭安装窗口并推出磁盘映像。

4. 4

   允许第一次启动

   在“访达 → 应用程序”中双击 DeepTutor。出现“无法验证开发者”时先关闭提示，再进入“系统设置 → 隐私与安全性”，找到被阻止说明并点击“仍要打开”。

   注意：首次安全确认通常只需要一次。请先确认安装包来自官方或社群管理员，再输入 Mac 密码或使用触控 ID。

首次启动与会员配置

先确认模型服务可用，再用一份小资料完成第一次知识库问答。

1. 1

   打开设置并进入会员 Token

   启动 DeepTutor 后，点击左侧“设置”，再点击页面右上方“会员 Token”。

2. 2

   登录会员账号

   输入会员账号和密码，等待系统提示配置成功。成功后会自动同步语言模型、语音识别、文生图、语音合成、嵌入模型和搜索配置。

   注意：会员账号、密码、API Key、Client ID 等只能填入配置框，不要粘贴到聊天框或公开截图里。

3. 3

   回到模型页检查状态

   进入“设置 → 模型”，确认 LLM、语音识别、文生图、语音合成、嵌入模型等服务已经显示为可用。

   如果回答里显示其他 AI 名称，不一定代表配置失败。优先看模型名称、接口调用和实际能力是否正常。

4. 4

   完成第一次资料测试

   • 准备一份可信的小 PDF 或 Word 文档，例如培训手册、课程标准片段或校本规范。
   • 进入“知识中心”新建知识库，等待文档解析和索引完成。
   • 回到主页挂载知识库，并提一个能在资料中找到答案的问题。
   • 打开活动面板检查是否发生知识库检索，再回到原文核验一条关键结论。

建立或连接第一份知识库

1. 1

   准备小而可靠的资料包

   优先选择课程标准、官方指导意见、培训手册、实施指南、优秀课例或学校规范，不要一开始上传大量重复或来源不明的资料。

2. 2

   进入知识中心

   点击左侧“知识中心”，选择新建本地知识库，或连接已经维护好的 Tencent IMA 知识库。

3. 3

   挂载知识库后再提问

   回到主页，点击输入框右下方的“知识库”，选择刚刚建立或连接的知识库。按钮变成具体知识库名称后，再开始连续追问。

4. 4

   用教师五要素提问

   说明身份、目标、资料范围、输出形式和质量要求。例如要求 AI 标明依据、说明不确定性，并在资料不足时直接说资料不足。

macOS 专项排查

1. 1

   提示“App 已损坏，无法打开”

   先确认安装包来源可靠，再请熟悉电脑操作的人打开“终端”，依次执行：

   xattr -dr com.apple.quarantine /Applications/DeepTutor.app
   open /Applications/DeepTutor.app

   注意：只对可信安装包执行，不要全局关闭 macOS 安全保护。

2. 2

   登录会员 Token 后仍无法提问

   • 检查设置页是否显示后端在线。
   • 检查“设置 → 模型 → LLM”是否显示已配置。
   • 刷新页面后重新发送一个简短问题。
   • 仍失败时记录报错文字和发生时间交给管理员，不要发送账号密码。
3. 3

   语音识别或朗读没有反应

   进入“系统设置 → 隐私与安全性”，按任务需要允许麦克风权限；同时检查系统音量和浏览器/应用播放权限。