适用版本 v1.0.6

Smart PPT macOS 安装指南

Apple 芯片 Mac 的安装、升级与 Claude Code 配置

安装包：SmartPPT_1.0.6_aarch64.dmg

安装前准备

先检查这台电脑是否符合要求

  • ✓Apple Silicon：M1、M2、M3 或 M4
  • ✓安装前完全退出 Smart PPT / SmartPPT
  • ✓从公司发布目录获取安装包
  • ✓安装期间保持联网

第一次安装可能出现系统安全提示，这是未签名或测试版本的常见现象。请先确认文件来自官方或社群管理员，再按照本页步骤放行。

安装或升级 Smart PPT

  1. 1

    退出旧版本

    在 Dock 中确认 Smart PPT / SmartPPT 已完全退出。

  2. 2

    打开 DMG

    双击 SmartPPT_1.0.6_aarch64.dmg。

  3. 3

    拖入“应用程序”

    将 SmartPPT 拖到 Applications（应用程序）文件夹；升级时选择“替换”。

  4. 4

    推出安装盘

    在 Finder 侧栏中点击 SmartPPT 旁边的推出按钮。

  5. 5

    允许首次启动

    打开“应用程序”，按住 Control 点按 SmartPPT，选择“打开”，再确认一次“打开”。

注意：系统提示无法验证开发者时，进入“系统设置 → 隐私与安全性”，在安全区域选择“仍要打开”。只对来源可靠且校验值一致的安装包执行。

首次配置 Claude Code

  1. 1

    打开设置

    进入 Claude Code 配置区域。

  2. 2

    填写服务信息

    输入 Base URL、API Key 和模型名称。不要在聊天或截图中公开 API Key。

  3. 3

    测试连接

    保存后点击“测试连接”，确认界面返回连接成功。

  4. 4

    生成第一份测试课件

    新建任务并发送“帮我做一份非谓语的课件”，确认软件能够持续生成。

macOS 故障排查

  1. 1

    系统阻止首次打开

    Control 点按应用后选择“打开”，或进入“系统设置 → 隐私与安全性”选择“仍要打开”。

  2. 2

    发送消息后没有反应

    先在设置中执行“测试连接”，再查看应用底部错误信息和“日志”页。

  3. 3

    升级后看不到旧任务

    确认当前登录的是原来的 macOS 系统账户，不要删除用户数据目录。

macOS 用户数据：~/Library/Application Support/chat.smartschool.smartppt

Smart PPT 安装完成后的主界面
安装完成后，先在设置中测试 Claude Code 连接，再创建第一份测试课件。

遇到问题先看这里

常见问题

普通升级会删除任务和附件吗？+

不会。任务、附件和 Claude Code 配置保存在独立用户数据目录中。

Intel 芯片 Mac 可以安装吗？+

当前 v1.0.6 DMG 为 Apple Silicon 架构，只适用于 M 系列芯片。

安装包来源不确定怎么办？+

发布目录同时提供 SHA256SUMS.txt。传输后文件损坏或来源不确定时，请先核对 SHA-256。