下载并安装
在下载页选择与设备、芯片相符的安装包。macOS 打开 DMG 后，把“天枢智学.app”拖到 Applications 再启动。
网站 → 下载家长只配置一次，孩子直接开始学习
用最短路径完成第一次有效学习。
流程按 10 分钟目标设计；首次模型验证和教材索引时间会受网络与文件大小影响。页面名称可能随 Alpha 版本微调，但角色分工和主流程保持一致。
第一次使用
最短闭环：安装到孩子开始学习
输入授权 Key
App 会显示设备申请码。把申请码发给内测管理员，收到授权 Key 后粘贴激活。一个家庭只需建立一个家长主账号。
启动 App → 授权注册家长账号
填写自己的用户名、密码和邮箱并完成同意告知。注册成功后会自动登录；此账号同时是家庭管理员。
欢迎页 → 注册家长账号创建孩子账号
进入“家长工作台 / 孩子与档案”，填写孩子信息，确认自动生成的简短账号并设置密码。创建后账号会出现在孩子列表。
家长工作台 → 孩子与档案连接家庭模型
选择模型供应商，输入家庭自己的 API Key，发现或选择模型并运行连接测试。连接成功后，家长助理和孩子 AI 老师共用这份配置。
设置 → 模型 → LLM / 家庭模型导入第一本教材
选择本机合法持有的 PDF、图片或文档，确认年级、学科等信息并选择孩子。系统会在后台解析并建立索引；扫描件会提示是否需要 OCR。
家长工作台 → 教材与知识 → 开始导入教材切换孩子并开始
切换到孩子账号，在孩子首页点击“开始今天的学习”，选择已准备好的教材或直接向 AI 老师提问。
切换账号 → 孩子首页先完成一条最短链。 第一次只创建一个孩子、配置一个对话模型、导入一本教材即可。确认能对话和学习后，再添加其他教材、孩子或高级能力。
家长日常
把需要家长处理的事情集中在家长工作台
家长助理
可以直接询问“今天孩子学得怎么样”“下一步应该调整什么”，也可以通过统一动作把建议写回学习计划。
孩子与档案
添加、查看和维护孩子账号。每个孩子拥有自己的教材、学习记录、记忆和报告。
教材与知识
导入、检查和分配教材。索引完成前不必停留在页面，稍后回来查看状态即可。
查看学习报告
在家长报告中查看本次与每周摘要、掌握变化和困难点；选择继续或调整后，意见会进入下一轮课程安排。
待办与提醒
模型、教材、资源或学习摘要需要处理时，会进入家庭待办。阅读、忽略或处理不会阻断孩子已经开始的学习。
切换账号
共享设备上可从家长切换到孩子。返回家长空间时需要家长凭据，避免孩子误改设置。
- 只在孩子确实完成一次学习后查看报告，空报告不会编造数据。
- 不需要逐次审批孩子学习；只有模型、教材、档案和关键反馈需要家长处理。
- 孩子无需接触模型 Key，家长配置后即可使用。
孩子日常
登录后直接学习，不要求孩子配置系统
进入孩子首页
使用家长创建时确认的简短账号和密码登录，或由家长在共享设备上切换账号。
开始今天的学习
选择系统安排的下一步，或从已分配教材、知识星图和 AI 老师进入学习。
先想再问
AI 老师会先确认理解和尝试，再按需要给提示、讲解与练习。遇到不懂的地方可以直接说“换一种讲法”。
完成练习
提交答案后查看判断、依据和改进提示。错误会用于复习安排，不会把一次失误当作长期标签。
普通对话始终可用：即使暂时没有可用教材上下文，孩子仍可与 AI 老师进行一般问答；教材准备好后再选择“本次对话参考教材”。
一次配置，全家使用
云端对话模型与本地资源如何选择
对话模型（LLM）
AI 老师、家长助理、深度解题和写作需要对话模型。安装包不携带运营方 Provider Key；家长使用自己的账号和额度。
- 优先选择内置供应商并填写 API Key。
- 点击“发现模型”后选择模型 ID。
- 保存后运行连接测试。
- 兼容 OpenAI 接口的服务可使用自定义配置。
嵌入模型
用于教材索引和检索。桌面端可一键安装本地中文嵌入资源；也可以显式选择云端嵌入服务。
语音合成（TTS）
只有终端探测确认系统语音是可靠的端侧能力时才复用；否则使用已安装或可下载的本地资源。如需其他音色，可由家长另配云端服务。
语音识别（STT）
终端探测确认存在可靠端侧识别时才复用系统能力；否则下载安装本地中文识别资源。云端 STT 保持为家长显式选择。
配置成功但聊天无回复：先确认家庭模型页面显示连接测试成功，再检查当前登录角色和授权状态。不要重复创建模型配置；使用诊断页生成诊断 ID 后再反馈。
一页完成
导入教材并交给孩子使用
选择教材文件
支持 PDF、图片和常见文档。请只导入自己合法持有或有权使用的材料；安装包不附带教材内容。
确认教材信息
检查书名、年级、学科、版本和出版社。标题中的特殊字符会由系统规范化，不需要手工改文件名。
选择使用的孩子
教材属于家庭资源，但学习进度按孩子分别记录。可为多个孩子使用同一本教材，无需重复保存教材正文。
等待后台准备
系统会执行解析、判断是否需要 OCR、增量索引和来源页码整理。已完成的阶段不会每次全量重做；需要 OCR 时请按页面提示在支持的终端先识别或转换。
确认可学习
教材状态变为可用后，切换孩子账号并从今天的学习或 AI 老师中选择该教材。
入口：家长登录后进入“家长工作台 → 教材与知识”，点击“开始导入教材”。如果看不到入口，请先确认当前是家长账号，而不是孩子账号。
遇到问题
先保留现场，再提供诊断 ID
账号或密码突然不正确
先确认 App 连接的是当前服务地址，并检查是否误用孩子账号登录家长入口。不要立即重复注册或重置家庭；先在设置状态页复制诊断 ID。
模型已保存，但状态仍显示未配置
进入家庭模型页运行连接测试；如失败，检查 API Key、接口地址和模型 ID。连接成功后返回模型总览刷新状态。
点击安装本地资源后看不到变化
资源卡片会显示下载、校验、安装和启用进度。保持 App 打开；失败时查看卡片错误，不要重复点击多个安装任务。
教材导入后一直在准备
先查看教材卡片中的解析或索引阶段。扫描版 PDF 需要 OCR，时间会更长；如失败，使用同一教材的重试入口，系统会继续未完成阶段。
如何反馈闪退或链路不通
重启 App 后进入“设置 → 状态 / 诊断”，复制诊断 ID，并说明发生时间、操作步骤、设备、系统版本和 App 版本。无需发送密码、授权 Key、模型 Key、聊天原文或教材正文。
- 记录左下角 App 版本号。
- 记录家长或孩子角色，以及问题发生前最后一步。
- 提供诊断 ID；日志上传前会按家长选择和脱敏规则处理。
- 不要在聊天群发送任何 API Key、账号密码或完整授权 Key。
下载 Alpha
准备好后，从当前公开版本开始
先确认设备与芯片，再下载对应安装包。第一次只完成一个孩子、一个模型和一本教材。