先明确：不配置 AI 能用多少
- 快积子C++教具：积木搭建、实时代码生成、积木搜索、本机 g++ 编译运行、项目库与练习自动判定等都可正常使用，AI 只负责「讲解与报错分析」这部分增强。
- 快积子3D英语教具：内置离线静态引擎，五大句型、时态、被动语态、疑问句、存在句、比较级都能离线分析；积木拼句、单词卡、词库、项目学习同样不受影响。AI 用于长难句与多层从句的深度结构树。
也就是说：AI 是「进阶老师」，不是「开关」。先把离线功能用起来，遇到瓶颈再配 Key，完全来得及。
第一步：获取一个 API Key
AI 分析需要你自己的大模型服务密钥（Key），由服务商按用量计费，与快积子无关。推荐：
- 国内：DeepSeek 开放平台（可直接访问，按量计费）
- 国际：OpenRouter（一个 Key 可调用多家模型）
注册、充值、创建 Key 的完整图解步骤见：API Key 获取指南。注意：Key 只在创建时显示一次，务必立刻复制保存。
第二步：在软件里填写
快积子C++教具
- 打开软件，进入 设置（齿轮图标）。
- 找到 AI 知识点 一栏，填入你的 API Key。
- 按需选择服务商与模型（如 DeepSeek 的
deepseek-chat系列）。 - 保存后回到知识点/代码讲解界面即可使用；若未配置，软件会提示「未配置 AI API Key，请到 ⚙ 设置 → AI 知识点 中配置」。
快积子3D英语教具
- 打开软件，进入 设置。
- 在 AI 分析相关设置中填入 API Key，并选择服务商（支持 DeepSeek 与 OpenAI 兼容接口）。
- 在句子界面点击 AI 分析，即可输出句子类型标签与多层结构树。
- 日常句子仍建议优先用离线静态引擎，速度快、不消耗额度。
关于隐私与数据
- Key 只保存在你的本机，软件不会把它上传到快积子的服务器。
- 只有当你主动点击 AI 分析时，待分析的代码或句子才会发送给你自己配置的服务商。
- 项目、单词卡、分析结果保存在本机主文件夹（可自定义位置），随时可见、可备份。
- 不使用 AI 时，两款教具都可完全离线运行。
常见问题排查
提示 401 或「密钥无效」
多为复制不完整或前后带了空格。重新复制 Key（注意不要漏掉开头字符）粘贴一次；确认该 Key 没有被删除。
提示余额不足 / 额度用尽
到服务商平台按需充值即可，价格与规则以平台页面为准。也可以先继续用离线功能，不急于充值。
换了电脑要重新配置吗？
需要。Key 保存在本机，换机器或重装后请重新填写；原来的 Key 仍可继续使用。
Key 泄露了怎么办？
立即到服务商平台删除该 Key 并新建一个，再到软件设置里替换。旧的 Key 删除后即失效。
分析结果能二次打开吗？
可以。英语教具的 AI 分析结果按项目存档，下次打开免等待重新分析。
还没有 Key？
「API Key 获取指南」提供 DeepSeek 与 OpenRouter 的注册、创建、复制分步图解。